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 (Connectors API)

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

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

設定連接器

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

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

   前往「Connections」(連線) 頁面

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

      連接器支援的地區包括：

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

   2. 點選「下一步」。
4. 在「連線詳細資料」部分，完成下列步驟：
   1. 連接器：從可用連接器的下拉式清單中選取「Marketo」。
   2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
   3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。

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

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

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

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

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

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

   2. 點選「下一步」。
6. 在「Authentication」(驗證) 部分，輸入驗證詳細資料。
   1. 選取「驗證類型」並輸入相關詳細資料。

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

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

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

   2. 點選「下一步」。
7. 檢查：檢查連線和驗證詳細資料。
8. 點選「建立」。

設定驗證機制

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

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

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

系統限制

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

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

在整合服務中使用 Marketo 連線

建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連線器」工作使用連線。

• 如要瞭解如何在 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 動作

遠端排定批次廣告活動在特定時間放送。

ScheduleCampaign 動作的輸入參數

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

如要瞭解如何設定 ScheduleCampaign 動作，請參閱「動作範例」。

ListMembersOfList 動作

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

ListMembersOfList 動作的輸入參數

參數名稱	資料類型	必填	說明
ListId	字串	是	要檢查待開發客戶的清單 ID。
LeadId	字串	是	以半形逗號分隔的待檢查待開發客戶 ID 清單，確認這些 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 的物件類型。可用的值包括：Activities、Leads、ProgramMembers 允許的值包括：Activities、Leads、ProgramMembers。

如要瞭解如何設定 CancelExportJob 動作，請參閱「動作範例」。

EnqueueExportJob 動作

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

EnqueueExportJob 動作的輸入參數

參數名稱	資料類型	必填	說明
JobId	字串	是	匯出工作的 ID。
類型	字串	是	BulkExtract 的物件類型。可用的值包括：Activities、Leads、ProgramMembers。 允許的值為 Activities、Leads、ProgramMembers。

如要瞭解如何設定 EnqueueExportJob 動作，請參閱「動作範例」。

GetExportJobStatus 動作

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

GetExportJobStatus 動作的輸入參數

參數名稱	資料類型	必填	說明
JobId	字串	是	匯出工作的 ID。
類型	字串	是	BulkExtract 的物件類型。可用的值包括：Activities、Leads、ProgramMembers。 允許的值為 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	字串	是	以半形逗號分隔的待移除待開發客戶 ID 清單，這些 ID 來自 ListId 指定的清單。

如要瞭解如何設定 RemoveLeadsFromList 動作，請參閱「動作範例」。

ImportCustomObjectsFromFile 動作

將檔案中的自訂物件匯入 Marketo。

ImportCustomObjectsFromFile 動作的輸入參數

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

如要瞭解如何設定 ImportCustomObjectsFromFile 動作，請參閱「動作範例」。

動作範例

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

範例 - AddLandingPageContentSection

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 AddLandingPageContentSection 動作，然後按一下「完成」。
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 動作，然後按一下「完成」。
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 動作，然後按一下「完成」。
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 動作，然後按一下「完成」。
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 動作，然後按一下「完成」。
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"
}]

範例 - ScheduleCampaign

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

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

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

 
  [{
  "Status": "Success"
}] 

範例 - GetImportLeadsStatus

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 GetImportLeadsStatus 動作，然後按一下「完成」。
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
}]

範例 - EnqueueExportJob

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 動作，然後按一下「完成」。
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 動作，然後按一下「完成」。
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 動作，然後按一下「完成」。
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 動作，然後按一下「完成」。
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 動作，然後按一下「完成」。
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」作業，然後按一下「完成」。

範例 - 取得單一 SmartCampaigns

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「智慧廣告活動」。
3. 選取「Get」作業，然後按一下「完成」。
4. 將實體 ID 設為「取得單一智慧廣告活動」。如要設定實體 ID，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 1002，並選擇 EntityId 做為本機變數。

範例 - 刪除電子郵件

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

範例 - 撰寫電子郵件

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「電子郵件」。
3. 選取「Create」作業，然後按一下「完成」。
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」作業，然後按一下「完成」。
4. 將 EntityID 設為 Update a EmailTemplates。如要設定 EntityID，請在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中，按一下「EntityID」，然後在指定欄位中輸入 1034.0。
5. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

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

執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{
"Id": 1034.0
} 

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連接器，請前往 Cloud 論壇的 Google Cloud 社群。

後續步驟

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