Marketo

מחבר Marketo מאפשר לכם לבצע פעולות של הוספה, מחיקה, עדכון וקריאה של נתוני Marketo.

לפני שמתחילים

לפני שמשתמשים במחבר Marketo, צריך לבצע את המשימות הבאות:

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      חשבון שירות הוא סוג מיוחד של חשבון Google שמייצג משתמש לא אנושי, שצריך לאמת ולאשר כדי לתת לו גישה לנתונים ב-Google APIs. אם אין לכם חשבון שירות, אתם צריכים ליצור חשבון שירות. המחבר וחשבון השירות צריכים להיות שייכים לאותו פרויקט. מידע נוסף זמין במאמר בנושא יצירת חשבון שירות.

    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

    אם השירותים או ההרשאות האלה לא הופעלו בפרויקט שלכם בעבר, תתבקשו להפעיל אותם כשאתם מגדירים את המחבר.

הגדרת המחבר

החיבור הוא ספציפי למקור נתונים. אם יש לכם הרבה מקורות נתונים, תצטרכו ליצור חיבור נפרד לכל אחד מהם. כדי ליצור קישור:

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, בוחרים את המיקום של החיבור.
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      אזורים נתמכים למחברים:

      רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות Marketo מהרשימה הנפתחת של המחברים הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

      השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    6. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

      צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות לחיבור נדרשים יותר צמתים, ולהפך: כדי לעבד פחות עסקאות נדרשים פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.

    7. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    8. לוחצים על הבא.
  5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
    1. סוג היעד: אפשר לציין את פרטי היעד ככתובת מארח או כקובץ מצורף של שירות. בוחרים באחד מסוגי היעדים הבאים:
      • כתובת המארח: אם רוצים לציין את שם המארח או את כתובת ה-IP של היעד.
      • צירוף שירות: אם רוצים לציין את נקודת הקצה הפרטית לכתובות ה-IP הפנימיות. קובץ ה-Service Attachment מאפשר לכם להסתיר את כתובות ה-IP הפנימיות מהרשת החיצונית. אפשר ליצור קובץ מצורף עם השירות ב-Google Cloud באמצעות התכונה Private Service Connect. מידע על הגדרת Private Service Connect זמין במאמר פרסום שירותים מנוהלים.

      בהתאם לסוג היעד שבחרתם, מזינים את כתובת המארח או את שם קובץ השירות.

      כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

    2. לוחצים על הבא.
  6. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Marketo תומך בסוגי האימות הבאים:

      • פרטי כניסה של לקוח ב-OAuth 2.0
      • שם משתמש וסיסמה
    2. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

    3. לוחצים על הבא.
  7. בדיקה: בודקים את פרטי החיבור והאימות.
  8. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

  • פרטי לקוח OAuth 2.0
    • מזהה לקוח: מזהה הלקוח שסופק על ידי כלי החיבור לאפליקציה שיצרתם.
    • סוד לקוח: סוד ב-Secret Manager שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
  • שם משתמש וסיסמה
    • ‫UserId: מזהה המשתמש ב-Marketo SOAP API.
    • ‫EncryptionKey: סוד ב-Secret Manager שמכיל את מפתח ההצפנה של Marketo SOAP API.

מגבלות המערכת

מחבר Marketo יכול לעבד עסקה אחת בשנייה, לכל צומת, ומגביל את מספר העסקאות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

שימוש בחיבור Marketo בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

  • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
  • מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

פעולות

בקטע הזה מפורטות הפעולות שהמחבר תומך בהן. כדי להבין איך להגדיר את הפעולות, אפשר לעיין בדוגמאות לפעולות.

פעולה AddLandingPageContentSection

מוסיף קטע תוכן לדף הנחיתה המטורגט.

פרמטרים של קלט לפעולה AddLandingPageContentSection

שם הפרמטר סוג הנתונים חובה תיאור
LandingPageId String נכון מזהה דף הנחיתה
ContentId String נכון המזהה של קטע התוכן. וגם המזהה של הקטע ב-HTML.
סוג String נכון סוג הקטע בתוכן. הערכים המותרים הם Image, ‏ Form, ‏ Rectangle, ‏ Snippet, ‏ RichText, ‏ HTML.

דוגמאות להגדרת הפעולה AddLandingPageContentSection מופיעות במאמר דוגמאות לפעולות.

פעולת מחיקה של תוכן בקטע בדף נחיתה

מחיקת הקטע של תוכן דף הנחיתה ב-Marketo.

פרמטרי הקלט של הפעולה DeleteLandingPageContentSection

שם הפרמטר סוג הנתונים חובה תיאור
LandingPageId String נכון המזהה של דף הנחיתה.
ContentId String נכון המזהה של קטע התוכן. וגם המזהה של הקטע ב-HTML.

דוגמאות להגדרת הפעולה DeleteLandingPageContentSection מופיעות במאמר דוגמאות לפעולות.

פעולת UpdateEmailContent

מעדכן את התוכן של הודעת אימייל.

פרמטרים של קלט בפעולה UpdateEmailContent

שם הפרמטר סוג הנתונים חובה תיאור
EmailId String נכון המזהה של האימייל.
FromEmail String נכון כתובת השולח של האימייל
FromName String נכון השם של השולח באימייל
ReplyTo String נכון כתובת לתשובה של האימייל
נושא String נכון שורת הנושא של האימייל

דוגמאות להגדרת הפעולה UpdateEmailContent מופיעות במאמר דוגמאות לפעולות.

פעולת UpdateLandingPageContentSection

מוסיפים או מעדכנים את הקטע של תוכן דף הנחיתה ב-Marketo.

פרמטרים של קלט לפעולה UpdateLandingPageContentSection

שם הפרמטר סוג הנתונים חובה תיאור
סוג String נכון סוג קטע התוכן.הערכים המותרים הם Image, Form, Rectangle, Snippet, RichText, HTML.
ערך String נכון סוג הקטע בתוכן.
LandingPageId String נכון המזהה של דף הנחיתה.
ContentId String נכון המזהה של קטע התוכן. וגם המזהה של הקטע ב-HTML.

דוגמאות להגדרת הפעולה UpdateLandingPageContentSection מופיעות במאמר דוגמאות לפעולות.

הפעולה GetImportProgramMembersStatus

מקבל את הסטטוס של חברי תוכנית ייבוא מפעולת קובץ ב-Marketo.

פרמטרים של קלט בפעולה GetImportProgramMembersStatus

שם הפרמטר סוג הנתונים חובה תיאור
BatchId String נכון המזהה של אצווה לייבוא לידים.

דוגמאות להגדרת הפעולה GetImportProgramMembersStatus מופיעות במאמר דוגמאות לפעולות.

תזמון פעולה בקמפיין

מגדיר מרחוק לוח זמנים להפעלת קמפיין אצווה בזמן נתון.

פרמטרים של קלט לפעולה ScheduleCampaign

שם הפרמטר סוג הנתונים חובה תיאור
CampaignId String נכון המזהה של קמפיין האצווה שרוצים לתזמן.
RunAt String נכון התאריך והשעה שבהם הקמפיין יופעל. אם לא מגדירים את השדה הזה, הקמפיין יופעל חמש דקות אחרי ביצוע השיחה.

דוגמאות להגדרת הפעולה ScheduleCampaign מופיעות במאמר דוגמאות לפעולות.

הפעולה ListMembersOfList

הפונקציה קובעת אם הלידים נכללים ברשימה ב-Marketo.

פרמטרים של קלט לפעולה ListMembersOfList

שם הפרמטר סוג הנתונים חובה תיאור
ListId String נכון המזהה של הרשימה שרוצים לבדוק אם יש בה לידים.
LeadId String נכון רשימה מופרדת בפסיקים של מזהי לידים שצריך לבדוק אם הם נמצאים ברשימה שצוינה על ידי ListId.

דוגמאות להגדרת הפעולה ListMembersOfList מופיעות במאמר דוגמאות לפעולות.

פעולה AssociateLead

משייך רשומת ליד מוכרת ב-Marketo לקובץ Cookie מסוג munchkin ולהיסטוריית הפעילות באינטרנט שמשויכת אליו

פרמטרים של קלט לפעולה AssociateLead

שם הפרמטר סוג הנתונים חובה תיאור
LeadId String נכון מזהה הליד לשיוך.
קובץ cookie String נכון ערך קובץ ה-Cookie שרוצים לשייך

דוגמאות להגדרת הפעולה AssociateLead מופיעות במאמר דוגמאות לפעולות.

הפעולה MergeLeads

מיזוג של שתי רשומות או יותר של לידים מוכרים לרשומה אחת של ליד.

פרמטרים של קלט לפעולה MergeLeads

שם הפרמטר סוג הנתונים חובה תיאור
WinningLeadId String נכון המזהה של רשומת הליד המנצחת
LoosingLeadId String נכון רשימה של מזהי לידים שמופרדים בפסיקים

דוגמאות להגדרת הפעולה MergeLeads מופיעות במאמר דוגמאות לפעולות.

הפעולה GetImportLeadsStatus

מקבל את הסטטוס של פעולת ייבוא לידים מקובץ ב-Marketo.

פרמטרים של קלט בפעולה GetImportLeadsStatus

שם הפרמטר סוג הנתונים חובה תיאור
BatchId String נכון המזהה של אצווה לייבוא לידים.

דוגמאות להגדרת הפעולה GetImportLeadsStatus מופיעות במאמר דוגמאות לפעולות.

הפעולה CancelExportJob

ביטול של עבודת ייצוא.

פרמטרים של קלט לפעולה CancelExportJob

שם הפרמטר סוג הנתונים חובה תיאור
JobId String נכון המזהה של משימת הייצוא.
סוג String נכון סוג האובייקט של BulkExtract. הערכים הזמינים הם : Activities, Leads, ProgramMembers הערכים המותרים הם Activities, Leads, ProgramMembers.

דוגמאות להגדרת הפעולה CancelExportJob מופיעות במאמר דוגמאות לפעולות.

הפעולה EnqueueExportJob

מכניס משימת ייצוא לתור ומתחיל את המשימה כשמשאבי מחשוב הופכים לזמינים.

פרמטרים של קלט של הפעולה EnqueueExportJob

שם הפרמטר סוג הנתונים חובה תיאור
JobId String נכון המזהה של משימת הייצוא.
סוג String נכון סוג האובייקט של BulkExtract. הערכים הזמינים הם : Activities, Leads, ProgramMembers. הערכים המותרים הם Activities, Leads, ProgramMembers.

דוגמאות להגדרת הפעולה EnqueueExportJob מופיעות במאמר דוגמאות לפעולות.

פעולה GetExportJobStatus

הפונקציה מחזירה את הסטטוס של משימת ייצוא. סטטוס המשימה זמין למשך 30 ימים אחרי שהסטטוס שלה היה 'הושלמה' או 'נכשלה'.

פרמטרים של קלט של הפעולה GetExportJobStatus

שם הפרמטר סוג הנתונים חובה תיאור
JobId String נכון המזהה של משימת הייצוא.
סוג String נכון סוג האובייקט של BulkExtract. הערכים הזמינים הם : Activities, Leads, ProgramMembers. הערכים המותרים הם Activities, Leads, ProgramMembers.

דוגמאות להגדרת הפעולה GetExportJobStatus מופיעות במאמר דוגמאות לפעולות.

הפעולה CreateEmailTemplate

יצירת תבנית אימייל חדשה.

פרמטרים של קלט לפעולה CreateEmailTemplate

שם הפרמטר סוג הנתונים חובה תיאור
FolderId String נכון מזהה התיקייה
FolderType String נכון סוג התיקייה.
שם String נכון השם של תבנית האימייל. חייב להיות ייחודי בתיקיית האב.
קובץ String נכון קובץ Multipart. תוכן HTML לתבנית.

דוגמאות להגדרת הפעולה CreateEmailTemplate מופיעות במאמר דוגמאות לפעולות.

פעולה UpdateLeadProgramStatus

שינוי סטטוס התוכנית של רשימת לידים בתוכנית יעד. אפשר להשתמש ב-API הזה רק כדי לשנות את הסטטוס של חברים קיימים בתוכנית.

פרמטרים של קלט לפעולה UpdateLeadProgramStatus

שם הפרמטר סוג הנתונים חובה תיאור
ProgramId String נכון המזהה של קמפיין האצווה שרוצים לתזמן.
LeadIds String נכון רשימה של מזהי לידים מופרדים בפסיקים.
סטטוס String נכון סטטוס התוכנית של הרשומה.

דוגמה להגדרת הפעולה UpdateLeadProgramStatus מופיעה במאמר דוגמאות לפעולות.

הפעולה RemoveLeadsFromList

הסרת לידים מרשימה ב-Marketo.

פרמטרים של קלט לפעולה RemoveLeadsFromList

שם הפרמטר סוג הנתונים חובה תיאור
ListId String נכון המזהה של הרשימה שממנה רוצים להסיר לידים.
LeadId String נכון רשימה מופרדת בפסיקים של מזהי לידים שיוסרו מהרשימה שצוינה על ידי ListId.

דוגמאות להגדרת הפעולה RemoveLeadsFromList מופיעות במאמר דוגמאות לפעולות.

פעולת ייבוא של אובייקטים מותאמים אישית מקובץ

מייבא אובייקטים בהתאמה אישית מקובץ אל Marketo.

פרמטרים של קלט של הפעולה ImportCustomObjectsFromFile

שם הפרמטר סוג הנתונים חובה תיאור
קובץ String נכון הנתיב לקובץ שמכיל את האובייקטים המותאמים אישית שרוצים לייבא ל-Marketo, למשל C:\temp\custom_object_import.csv.
TableName String נכון השם של טבלת האובייקטים המותאמים אישית. לדוגמה: CustomObject_test
פורמט String נכון הפורמט של הקובץ שישמש לייבוא אובייקטים מותאמים אישית אל Marketo. הערכים המותרים הם csv, ‏ tsv, ‏ ssv.
תוכן String נכון התוכן כ-InputStream שיועלה אם לא צוין קובץ.

דוגמה להגדרת הפעולה ImportCustomObjectsFromFile מופיעה במאמר דוגמאות לפעולות.

דוגמאות לפעולות

בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.

דוגמה – הוספה של תוכן בדף נחיתה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה AddLandingPageContentSection ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "LandingPageId": "1005",
      "ContentId": "1120",
      "Type": "HTML"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה CampaignTest של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "Id": "1130",
      "json:repeatelementorder": "id",
      "requestsuccess": "true",
      "@affectedrows": "1"
    }]

דוגמה – DeleteLandingPageContentSection

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DeleteLandingPageContentSection ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "LandingPageId": "1005",
      "ContentId": "1009"
    } 
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה DeleteLandingPageContentSection של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "Id": "1005",
      "json:repeatelementorder": "id",
      "requestsuccess": "true",
      "@affectedrows": "1"
    }]

דוגמה – UpdateEmailContent

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה UpdateEmailContent ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
     {
      "EmailId": "1001",
      "FromName": "test",
      "FromEmail": "222larabrown@gmail.com",
      "Subject": "TestSubject Line",
      "ReplyTo": "222larabrown@gmail.com"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה UpdateEmailContent של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "Id": "1001",
      "json:repeatelementorder": "id",
      "requestsuccess": "true"
    }]

דוגמה – UpdateLandingPageContentSection

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה UpdateLandingPageContentSection ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "Type": "HTML",
      "Value": "
    Test Update
    ",
      "LandingPageId": "1005",
      "ContentId": "1120"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה UpdateLandingPageContentSection של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "Id": "1005",
      "json:repeatelementorder": "id",
      "requestsuccess": "true",
      "@affectedrows": "1"
    }]

דוגמה – GetImportProgramMembersStatus

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה GetImportProgramMembersStatus ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "BatchId": "1029"
    } 
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה GetImportProgramMembersStatus של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "BatchId": "1029",
      "Status": "Complete",
      "NumOfLeadsProcessed": "3",
      "NumOfRowsFailed": "0",
      "NumOfRowsWithWarning": "3",
      "Message": "Import succeeded, 3 records imported (3 members), 3 warning.",
      "importid": "1029",
      "requestsuccess": "true"
    }]

דוגמה – ScheduleCampaign

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה ScheduleCampaign ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "CampaignId": "1065",
      "RunAt": "2024-05-23T18:05:00+0000"
    } 
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה ScheduleCampaign של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "Success": "true",
      "id": "1065",
      "json:repeatelementorder": "id",
      "requestsuccess": "true"
    }]

דוגמה – ListMembersOfList

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה ListMembersOfList ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "ListId": "1003",
      "LeadId": "13,25,21"
    } 
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה ListMembersOfList של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "LeadId": "13",
      "Status": "notmemberof",
      "ReasonCode": null,
      "ReasonMessage": null,
      "id": "13",
      "requestsuccess": "true"
    }, {
      "LeadId": "25",
      "Status": "notmemberof",
      "ReasonCode": null,
      "ReasonMessage": null,
      "id": "25",
      "requestsuccess": "true"
    }, {
      "LeadId": "21",
      "Status": "notmemberof",
      "ReasonCode": null,
      "ReasonMessage": null,
      "id": "21",
      "requestsuccess": "true"
    }]

דוגמה – AssociateLead

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה AssociateLead ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "LeadId": 582.0,
      "Cookie": "id:703-VQQ-088%26token:_mch-marketo.com-_mch-mktoweb.com-1717156982039-98850"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה AssociateLead של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
     [{
      "Status": "Success"
    }] 

דוגמה – MergeLeads

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה MergeLeads ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
     {
      "LoosingLeadId": "10",
      "WinningLeadId": "45"
    } 
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה MergeLeads של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
      [{
      "Status": "Success"
    }] 

דוגמה – GetImportLeadsStatus

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה GetImportLeadsStatus ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "BatchId": "1022"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה GetImportLeadsStatus של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
     [{
      "BatchId": "1022",
      "Status": "Complete",
      "NumOfLeadsProcessed": "3",
      "NumOfRowsFailed": "0",
      "NumOfRowsWithWarning": "0",
      "Message": "Import succeeded, 3 records imported (3 members)",
      "importid": "1022",
      "requestsuccess": "true"
    }]

דוגמה – ביטול של משימת ייצוא

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CancelExportJob ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
      "Type": "Leads"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה CancelExportJob של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
      "JobStatus": "Cancelled",
      "Format": "CSV",
      "CreatedAt": "2024-05-28T05:45:13Z",
      "StartedAt": null,
      "QueuedAt": null,
      "exportid": null,
      "json:repeatelementorder": null,
      "status": null,
      "requestsuccess": null
    }]

דוגמה – EnqueueExportJob

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה EnqueueExportJob ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
      "Type": "Leads"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה EnqueueExportJob של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
      "JobStatus": "Queued",
      "Format": "CSV",
      "CreatedAt": "2024-05-27T12:12:53Z",
      "QueuedAt": "2024-05-27T12:13:20Z",
      "exportid": null,
      "json:repeatelementorder": null,
      "status": null,
      "requestsuccess": null
    }]

דוגמה – GetExportJobStatus

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה GetExportJobStatus ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
      "Type": "Leads"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה GetExportJobStatus של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
      "Format": "CSV",
      "CreatedAt": "2024-05-23T10:12:09Z",
      "JobStatus": "Created",
      "QueuedAt": null,
      "StartedAt": null,
      "FinishedAt": null,
      "NumberOfRecords": null,
      "FileSize": null,
      "exportid": null,
      "status": null,
      "requestsuccess": null
    }]

דוגמה – CreateEmailTemplate

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CreateEmailTemplate ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "FolderId": 27.0,
      "FolderType": "Folder",
      "Content": "\n\n\n \n
    My First Heading
    \n
    My first paragraph.
    
    \n \n\n",
      "Name": "Test1718166502676",
      "Filename": "FileName1718166502678"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה CreateEmailTemplate של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "Id": "1048",
      "createdat": "2024-06-12T04:28:23Z+0000",
      "folder_type": "Folder",
      "workspace": "Default",
      "folder_foldername": "Templates",
      "name": "Test1718166502676",
      "version": "2",
      "requestsuccess": "true",
      "url": "https://app-abc.marketo.com/#ET1048B2ZN27",
      "folder_value": "27",
      "updatedat": "2024-06-12T04:28:23Z+0000",
      "status": "draft"
    }]

דוגמה – UpdateLeadProgramStatus

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה UpdateLeadProgramStatus ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "ProgramId": "1002",
      "Status": "Member",
      "LeadIds": "3"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה UpdateLeadProgramStatus של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "Success": "true",
      "id": "3",
      "status": "updated",
      "requestsuccess": "true"
    }]

דוגמה – RemoveLeadsFromList

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה RemoveLeadsFromList ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
     {
      "ListId": "1026",
      "LeadId": "57"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה RemoveLeadsFromList של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "LeadId": "57",
      "Status": "skipped",
      "ReasonCode": "1015",
      "ReasonMessage": "Lead not in list",
      "id": "57",
      "requestsuccess": "true"
    }]

דוגמה – ImportCustomObjectsFromFile

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה ImportCustomObjectsFromFile ולוחצים על סיום.
  3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:
    {
      "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
      "Type": "Leads"
    }
  4. בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה ImportCustomObjectsFromFile של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
      "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
      "Format": "CSV",
      "CreatedAt": "2024-05-23T10:12:09Z",
      "JobStatus": "Created",
      "QueuedAt": null,
      "StartedAt": null,
      "FinishedAt": null,
      "NumberOfRecords": null,
      "FileSize": null,
      "exportid": null,
      "status": null,
      "requestsuccess": null
    }]

דוגמאות לפעולות על ישויות

בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.

כשמשתמשים בפעולת רשימה ומצפים שנפח הנתונים יהיה גדול, מומלץ לציין פסוקית סינון עבור הישויות הבאות: LeadsLists,‏ LeadPrograms,‏ Activities,‏ LandingPageContentSec,‏ LeadChanges,‏ LeadChangesFields,‏ Emails,‏ LandingPages,‏ Forms,‏ Programs,‏ Leads,‏ LandingPageTemplateCon,‏ OpportunityRoles,‏ SalesPersons,‏ Tokens,‏ ListStaticMemberShip,‏ Opportunities,‏ LeadChangesAttributes ו-Segments. בנוסף, כדי למיין את קבוצת התוצאות, צריך קודם להחיל את סעיף המסנן.

דוגמה – הצגת כל האימיילים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות 'אימיילים' מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.

דוגמה – קבלת קמפיינים חכמים יחידים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות 'קמפיינים חכמים' מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את מזהה הישות ל-Get single SmartCampaigns. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים 1002 בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).

דוגמה – מחיקת אימיילים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות 'אימיילים' מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. מגדירים את מזהה הישות לערך Delete Emails (מחיקת אימיילים). כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים 1048.0 בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).

דוגמה – יצירת אימיילים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות 'אימיילים' מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
     {
    "Template": 1.0,
    "FolderId": 1002.0,
    "Name": "Test Email",
    "FolderType": "Program"
    }
    

    Running this example, returns a response similar to the following in the Connector task's connectorOutputPayload output variable:

    {
    "Id": "1048.0"
    }

דוגמה – עדכון של EmailTemplates

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות EmailTemplates מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את EntityID כדי לעדכן את EmailTemplates. כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים 1034.0 בשדה שמופיע.
  5. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על OpenDataMapping editor (עורך) ומזינים ערך דומה לערך הבא ב-field:
     
    {
    "Name": "temp email updated",
    "Description": "updation"
    }
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
    "Id": 1034.0
    } 

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

המאמרים הבאים