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. 如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

    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"
}

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

範例 - 取得單一 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"
}

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

    {
"Id": 1034.0
}

向 Google Cloud 社群尋求協助

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

後續步驟