Marketo

您可以使用 Marketo 連接器，針對 Marketo 資料執行插入、刪除、更新和讀取作業。

事前準備

使用 Marketo 連接器前，請先完成下列工作：

• 在 Google Cloud 專案中：
  • 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
  • 將 roles/connectors.admin IAM 角色授予設定連接器的使用者。
  • 將下列 IAM 角色授予要用於連接器的服務帳戶：
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    服務帳戶是特殊的 Google 帳戶類型，主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。如果您沒有服務帳戶，請務必建立服務帳戶。詳情請參閱「建立服務帳戶」。

  • 啟用下列服務：
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (連接器 API)

    如要瞭解如何啟用服務，請參閱「啟用服務」。

  如果先前未為專案啟用這些服務或權限，系統會在設定連接器時提示您啟用。

設定連接器

連線是特定資料來源的連線，也就是說，如果您有多個資料來源，則必須為每個資料來源建立個別的連線。如要建立連線，請按照下列步驟操作：

1. 在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。

   前往「連線」頁面

2. 按一下「+ 建立新連線」，開啟「建立連線」頁面。
3. 在「位置」部分，選擇連線的位置。
   1. 區域：從下拉式清單中選取位置。

      支援的連接器地區包括：

      如需所有支援地區的清單，請參閱「位置」一節。

   2. 點按「Next」。
4. 在「連線詳細資料」部分中，完成下列操作：
   1. 連接器：從可用連接器的下拉式清單中選取「Marketo」。
   2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
   3. 在「Connection Name」欄位中，輸入連線例項的名稱。

      連線名稱必須符合下列條件：

      • 連線名稱可以包含英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱的開頭必須是英文字母，結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個半形字元。
   4. 視需要輸入連線例項的「Description」(說明)。
   5. 服務帳戶：選取具備必要角色的服務帳戶。
   6. 視需要設定連線節點設定：
      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。處理的交易量越多，就需要越多節點；反之，處理的交易量越少，就需要越少節點。如要瞭解節點對連接器定價的影響，請參閱「 連線節點的定價」。如果您未輸入任何值，系統預設會將最小節點設為 2 (以提高可用性)，並將最大節點設為 50。

   7. 您可以按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
   8. 點按「Next」。
5. 在「目的地」部分，輸入要連線的遠端主機 (後端系統) 詳細資料。
   1. 目的地類型：您可以使用主機位址或服務附件來指定目的地詳細資料。選取下列任一目標類型：
      • 主機位址：如果您想指定目的地的主機名稱或 IP 位址。
      • 服務附件：如果您想為內部 IP 位址指定私人端點，服務附件可讓您隱藏內部 IP 位址，不讓外部網路看到。您可以使用 Private Service Connect 功能，在 Google Cloud 中建立服務連結。如要瞭解如何設定 Private Service Connect，請參閱「發布代管服務」。

      根據所選的目的地類型，輸入主機位址或服務連結名稱。

      如要輸入其他目的地，請按一下「+ 新增目的地」。

   2. 點按「Next」。
6. 在「Authentication」部分中，輸入驗證詳細資料。
   1. 選取「驗證類型」並輸入相關詳細資料。

      Marketo 連結支援下列驗證類型：

      • OAuth 2.0 用戶端憑證
      • 使用者名稱和密碼

   如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

   2. 點按「Next」。
7. 查看：查看連線和驗證詳細資料。
8. 按一下 [建立]。

設定驗證機制

根據要使用的驗證方法輸入詳細資料。

• OAuth 2.0 用戶端憑證
  • 用戶端 ID：連接器為您建立的應用程式提供的用戶端 ID。
  • 用戶端密鑰：Secret Manager 密鑰，內含您建立的已連結應用程式的用戶端密鑰。

• 使用者名稱和密碼
  • UserId：Marketo SOAP API 使用者 ID。
  • EncryptionKey：包含 Marketo SOAP API 加密金鑰的 Secret Manager 密鑰。

系統限制

Marketo 連接器可處理每個節點每秒 1 筆交易，並節流超出此限制的所有交易。根據預設，Integration Connectors 會為連線分配 2 個節點 (可提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一節。

在整合中使用 Marketo 連線

建立連線後，Apigee 整合和應用程式整合都會顯示這項連線。您可以透過連接器工作，在整合中使用連線。

• 如要瞭解如何在 Apigee Integration 中建立及使用連接器工作，請參閱「連接器工作」。
• 如要瞭解如何在 Application Integration 中建立及使用連接器工作，請參閱「連接器工作」。

動作

本節列出連接器支援的動作。如要瞭解如何設定動作，請參閱「動作範例」。

AddLandingPageContentSection 動作

在指定到達網頁中加入內容部分。

AddLandingPageContentSection 動作的輸入參數

參數名稱	資料類型	必填	說明
LandingPageId	字串	是	到達網頁 ID
ContentId	字串	是	內容區段的 ID。也是區段的 HTML ID。
類型	字串	是	內容類型區段。有效值為 Image、Form、Rectangle、Snippet、RichText、HTML。

如需 AddLandingPageContentSection 動作的設定範例，請參閱「動作範例」。

DeleteLandingPageContentSection 動作

刪除 Marketo 中的到達網頁內容部分。

DeleteLandingPageContentSection 動作的輸入參數

參數名稱	資料類型	必填	說明
LandingPageId	字串	是	到達網頁的 ID。
ContentId	字串	是	內容區段的 ID。也是區段的 HTML ID。

如需 DeleteLandingPageContentSection 動作的設定範例，請參閱「動作範例」。

UpdateEmailContent 動作

更新電子郵件內容。

UpdateEmailContent 動作的輸入參數

參數名稱	資料類型	必填	說明
EmailId	字串	是	電子郵件的 ID。
FromEmail	字串	是	電子郵件的寄件者地址
FromName	字串	是	電子郵件的寄件者姓名
ReplyTo	字串	是	電子郵件的回覆地址
主旨	字串	是	電子郵件主旨

如需 UpdateEmailContent 動作的設定範例，請參閱「動作範例」。

UpdateLandingPageContentSection 動作

在 Marketo 中新增或更新到達網頁內容的部分。

UpdateLandingPageContentSection 動作的輸入參數

參數名稱	資料類型	必填	說明
類型	字串	是	內容區段的類型。允許的值為 Image、Form、Rectangle、Snippet、RichText、HTML。
值	字串	是	內容類型區段。
LandingPageId	字串	是	到達網頁的 ID。
ContentId	字串	是	內容區段的 ID。也是區段的 HTML ID。

如需 UpdateLandingPageContentSection 動作的設定範例，請參閱「動作範例」。

GetImportProgramMembersStatus 動作

取得 Marketo 匯入作業的匯入會員狀態。

GetImportProgramMembersStatus 動作的輸入參數

參數名稱	資料類型	必填	說明
BatchId	字串	是	匯入待開發客戶批次的 ID。

如需 GetImportProgramMembersStatus 動作的設定範例，請參閱「動作範例」。

排定廣告活動動作

遠端排定在特定時間執行批次廣告活動。

ScheduleCampaign 動作的輸入參數

參數名稱	資料類型	必填	說明
CampaignId	字串	是	要排程的批次廣告活動 ID。
RunAt	字串	是	廣告活動的放送日期和時間。如果未設定，廣告活動會在通話後五分鐘執行。

如需 ScheduleCampaign 動作的設定範例，請參閱「動作範例」。

ListMembersOfList 動作

判斷待開發客戶是否包含在 Marketo 的清單中。

ListMembersOfList 動作的輸入參數

參數名稱	資料類型	必填	說明
ListId	字串	是	要檢查待開發客戶的清單 ID。
LeadId	字串	是	以半形逗號分隔的待確認待開發客戶 ID 清單，用於確認待開發客戶是否位於 ListId 指定的清單中。

如需 ListMembersOfList 動作的設定範例，請參閱「動作範例」。

AssociateLead 動作

將已知的 Marketo 待開發客戶記錄與 munchkin Cookie 及其相關的網站活動記錄建立關聯

AssociateLead 動作的輸入參數

參數名稱	資料類型	必填	說明
LeadId	字串	是	要關聯的待開發客戶 ID。
Cookie	字串	是	要關聯的 Cookie 值

如需 AssociateLead 動作的設定範例，請參閱「動作範例」。

MergeLeads 動作

將兩個以上的已知待開發客戶記錄合併為單一待開發客戶記錄。

MergeLeads 動作的輸入參數

參數名稱	資料類型	必填	說明
WinningLeadId	字串	是	獲勝待開發客戶記錄的 ID
LoosingLeadId	字串	是	以半形逗號分隔的失去待開發客戶 ID 清單

如需 MergeLeads 動作的設定範例，請參閱「動作範例」。

GetImportLeadsStatus 動作

取得 Marketo 的匯入待開發客戶檔案作業狀態。

GetImportLeadsStatus 動作的輸入參數

參數名稱	資料類型	必填	說明
BatchId	字串	是	匯入待開發客戶批次的 ID。

如需 GetImportLeadsStatus 動作的設定範例，請參閱「動作範例」。

CancelExportJob 動作

取消匯出工作。

CancelExportJob 動作的輸入參數

參數名稱	資料類型	必填	說明
JobId	字串	是	匯出工作的 ID。
類型	字串	是	BulkExtract 的物件類型。可用的值：活動、待開發客戶、計畫成員。允許的值：活動、待開發客戶、計畫成員。

如需 CancelExportJob 動作的設定範例，請參閱「動作範例」。

排入 ExportJob 動作

將匯出工作排入佇列，並在運算資源可用時啟動工作。

EnqueueExportJob 動作的輸入參數

參數名稱	資料類型	必填	說明
JobId	字串	是	匯出工作的 ID。
類型	字串	是	BulkExtract 的物件類型。可用的值：活動、待開發客戶、計畫成員。有效值為 Activities、Leads、ProgramMembers。

如需 EnqueueExportJob 動作的設定範例，請參閱「動作範例」。

GetExportJobStatus 動作

傳回匯出工作的狀態。工作狀態會在達到「已完成」或「失敗」狀態後，保留 30 天。

GetExportJobStatus 動作的輸入參數

參數名稱	資料類型	必填	說明
JobId	字串	是	匯出工作的 ID。
類型	字串	是	BulkExtract 的物件類型。可用的值：活動、待開發客戶、計畫成員。有效值為 Activities、Leads、ProgramMembers。

如需 GetExportJobStatus 動作的設定範例，請參閱「動作範例」。

CreateEmailTemplate 動作

建立新的電子郵件範本。

CreateEmailTemplate 動作的輸入參數

參數名稱	資料類型	必填	說明
FolderId	字串	是	資料夾 ID
FolderType	字串	是	資料夾類型。
名稱	字串	是	電子郵件範本的名稱。上層資料夾中不得重複。
檔案	字串	是	多部分檔案。範本的 HTML 內容。

如需 CreateEmailTemplate 動作的設定範例，請參閱「動作範例」。

UpdateLeadProgramStatus 動作

變更指定計畫中待開發客戶清單的計畫狀態。只有現有計畫成員可以使用這個 API 變更狀態。

UpdateLeadProgramStatus 動作的輸入參數

參數名稱	資料類型	必填	說明
ProgramId	字串	是	要排程的批次廣告活動 ID。
LeadIds	字串	是	以半形逗號分隔的待開發客戶 ID 輸入清單。
狀態	字串	是	記錄的節目狀態。

如需 UpdateLeadProgramStatus 動作的設定範例，請參閱「動作範例」。

RemoveLeadsFromList 動作

從 Marketo 清單中移除待開發客戶。

RemoveLeadsFromList 動作的輸入參數

參數名稱	資料類型	必填	說明
ListId	字串	是	要移除待開發客戶的清單 ID。
LeadId	字串	是	以半形逗號分隔的清單，列出要從 ListId 指定的清單中移除的待開發客戶 ID。

如需 RemoveLeadsFromList 動作的設定範例，請參閱「動作範例」。

ImportCustomObjectsFromFile 動作

將自訂物件從檔案匯入 Marketo。

ImportCustomObjectsFromFile 動作的輸入參數

參數名稱	資料類型	必填	說明
檔案	字串	是	包含要匯入 Marketo 的自訂物件檔案路徑，例如「C:\temp\custom_object_import.csv」。
資料表名稱	字串	是	自訂物件資料表的名稱。例如：CustomObject_test
格式	字串	是	用於將自訂物件匯入 Marketo 的檔案格式。有效值為 csv、tsv、ssv。
內容	字串	是	未指定檔案時，要上傳的內容會以 InputStream 的形式提供。

如需 ImportCustomObjectsFromFile 動作的設定範例，請參閱「動作範例」。

行動號召範例

本節說明如何在這個連接器中執行部分動作。

範例 - AddLandingPageContentSection

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 AddLandingPageContentSection 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "LandingPageId": "1005",
     "ContentId": "1120",
     "Type": "HTML"
   }

以下範例顯示特定物件記錄。如果動作成功，CampaignTest 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

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

範例 - DeleteLandingPageContentSection

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 DeleteLandingPageContentSection 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "LandingPageId": "1005",
     "ContentId": "1009"
   } 

以下範例顯示特定物件記錄。如果動作成功，DeleteLandingPageContentSection 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

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

範例 - UpdateEmailContent

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 UpdateEmailContent 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

    {
     "EmailId": "1001",
     "FromName": "test",
     "FromEmail": "222larabrown@gmail.com",
     "Subject": "TestSubject Line",
     "ReplyTo": "222larabrown@gmail.com"
   }

以下範例顯示特定物件記錄。如果動作成功，UpdateEmailContent 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

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

範例 - UpdateLandingPageContentSection

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 UpdateLandingPageContentSection 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "Type": "HTML",
     "Value": "
   Test Update
   ",
     "LandingPageId": "1005",
     "ContentId": "1120"
   }

以下範例顯示特定物件記錄。如果動作成功，UpdateLandingPageContentSection 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

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

範例 - GetImportProgramMembersStatus

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 GetImportProgramMembersStatus 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "BatchId": "1029"
   } 

以下範例顯示特定物件記錄。如果動作成功，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"
}]

範例 - 排定廣告活動

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 ScheduleCampaign 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "CampaignId": "1065",
     "RunAt": "2024-05-23T18:05:00+0000"
   } 

以下範例顯示特定物件記錄。如果動作成功，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"
   } 

以下範例顯示特定物件記錄。如果動作成功，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"
   }

以下範例顯示特定物件記錄。如果動作成功，AssociateLead 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
 [{
  "Status": "Success"
}] 

範例：MergeLeads

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 MergeLeads 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

    {
     "LoosingLeadId": "10",
     "WinningLeadId": "45"
   } 

以下範例顯示特定物件記錄。如果動作成功，MergeLeads 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
  [{
  "Status": "Success"
}] 

範例 - GetImportLeadsStatus

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 GetImportLeadsStatus 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "BatchId": "1022"
   }

以下範例顯示特定物件記錄。如果動作成功，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"
   }

以下範例顯示特定物件記錄。如果動作成功，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
}]

範例 - 將 ExportJob 加入佇列

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 EnqueueExportJob 動作，然後按一下「完成」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
     "Type": "Leads"
   }

以下範例顯示特定物件記錄。如果動作成功，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 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
     "Type": "Leads"
   }

以下範例顯示特定物件記錄。如果動作成功，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 動作，然後按一下「Done」。
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"
   }

以下範例顯示特定物件記錄。如果動作成功，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 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "ProgramId": "1002",
     "Status": "Member",
     "LeadIds": "3"
   }

以下範例顯示特定物件記錄。如果動作成功，UpdateLeadProgramStatus 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

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

範例 - RemoveLeadsFromList

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 RemoveLeadsFromList 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

    {
     "ListId": "1026",
     "LeadId": "57"
   }

以下範例顯示特定物件記錄。如果動作成功，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 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
     "Type": "Leads"
   }

以下範例顯示特定物件記錄。如果動作成功，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 作業，然後按一下「Done」。

範例：取得單一智慧廣告活動

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「SmartCampaigns」。
3. 選取 Get 作業，然後按一下「Done」。
4. 將實體 ID 設為「Get single SmartCampaigns」。如要設定實體 ID，請在「資料對應」的「資料對應」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 1002，並選擇「EntityId」做為「Local」變數。

範例：刪除電子郵件

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「電子郵件」。
3. 選取 Delete 作業，然後按一下「Done」。
4. 將實體 ID 設為「Delete Emails」。如要設定實體 ID，請在「資料對應」的「資料對應」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 1048.0，並選擇「EntityId」做為「Local」變數。

範例：建立電子郵件

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「電子郵件」。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「Task」的「Data Mapper」專區中，按一下 OpenDataMapping 編輯器，然後在 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. 從 Entity 清單中選取「EmailTemplates」。
3. 選取 Update 運算，然後按一下「Done」。
4. 將 EntityID 設為更新 EmailTemplates。如要設定 EntityID，請在「Tasks」的「Data Mapper」部分，點選「EntityID」，然後在指定欄位中輸入 1034.0。
5. 在「Task」的「Data Mapper」專區中，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似以下的值

    
   {
   "Name": "temp email updated",
   "Description": "updation"
   }

執行這個範例時，會傳回類似以下的回應，並顯示在連接器工作項的 connectorOutputPayload 輸出變數中：

{
"Id": 1034.0
} 

向 Google Cloud 社群尋求協助

如有任何問題，歡迎在 雲端論壇中發問，並與 Google Cloud 社群成員討論這個連接器。

後續步驟

• 瞭解如何暫停及恢復連線。
• 瞭解如何監控連接器使用情形。
• 瞭解如何查看連接器記錄。