LinkedIn Marketing Solutions

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

支援的版本

這個連接器支援 LinkedIn REST API。

事前準備

在 Google Cloud 專案中，執行下列工作：

• 確認已設定網路連線。如需網路模式的相關資訊，請參閱「網路連線」。
• 將 roles/connectors.admin IAM 角色授予設定連結器的使用者。
• 將 roles/secretmanager.viewer 和 roles/secretmanager.secretAccessor IAM 角色授予要用於連接器的服務帳戶。
• 啟用下列服務：
  • secretmanager.googleapis.com (Secret Manager API)
  • connectors.googleapis.com (Connectors API)

  如要瞭解如何啟用服務，請參閱「啟用服務」。如果專案先前未啟用這些服務或權限，系統會在您設定連接器時提示啟用。

設定連接器

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

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

   前往「連線」頁面

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

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

   2. 點按「下一步」。
4. 在「連線詳細資料」部分，完成下列步驟：
   1. 連接器：從可用連接器清單中選取「LinkedIn Marketing Solutions」。
   2. 連接器版本：從可用版本清單中選取連接器版本。
   3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。連線名稱可包含小寫英文字母、數字或連字號。名稱開頭須為英文字母，結尾須為英文字母或數字，且名稱不得超過 49 個字元。
   4. 說明：輸入連線執行個體的說明。
   5. 視需要啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為 Error。
   6. 服務帳戶：選取具備必要角色的服務帳戶。
   7. 視需要設定「連線節點設定」：
      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

      節點是處理交易的連線單位 (或副本)。 連線處理的交易越多，就需要越多節點，反之亦然。 如要瞭解節點對連結器價格的影響，請參閱 連線節點的價格。如果未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，上限則設為 50。

   8. + 新增標籤：按一下這個選項，以鍵/值組合的形式為連線新增標籤。
   9. 點按「下一步」。
   10. 在「驗證」部分，輸入驗證詳細資料。
       1. 選取「驗證類型」，然後輸入相關詳細資料。

          LinkedIn 行銷解決方案連結支援下列驗證類型：

          • OAuth 2.0 - 用戶端憑證

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

       2. 點按「下一步」。
   11. 檢查：檢查連結和驗證詳細資料。
   12. 點選「建立」。

   設定驗證機制

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

   • OAuth 2.0 - 用戶端憑證
     • 「Client ID」(用戶端 ID)：輸入要用於連線的用戶端 ID。
     • 範圍：輸入要用於連線的範圍。
     • 用戶端密鑰：輸入內含用戶端密鑰的 Secret Manager 密鑰。
     • 密鑰版本：選取用戶端密鑰的密鑰版本。
     • 授權網址：輸入授權網址。
     • 啟用驗證覆寫：選取這個選項即可啟用覆寫驗證。

   連線設定範例

   本節列出您在建立連線時設定的各個欄位範例值。

   OAuth 2.0 - 用戶端憑證連線類型

   欄位名稱	詳細資料
   位置	us-central1
   連接器	LinkedIn Marketing Solutions
   連接器版本	1
   連線名稱	linkedin-ads-connection
   啟用 Cloud Logging	true
   服務帳戶	123456789012-compute@developer.gserviceaccount.com
   節點數量下限	2
   節點數量上限	50
   驗證	OAuth 2.0 - 用戶端憑證
   用戶端 ID	78xuvoqkfeoj5n
   範圍	openid、profile、rw_organization_admin、w_member_social、rw_events、w_organization_social、rw_ads、r_basicprofile、email、r_1st_connections_size
   用戶端密鑰	projects/secrets/new-client-secret
   密鑰版本	1
   授權網址	https://www.linkedin.com/oauth/v2/authorization

   系統限制

   LinkedIn Marketing Solutions 連接器每秒最多可處理 14 筆交易 (每個節點)，超過此限制的交易都會遭到節流。根據預設，Integration Connectors 會為連線分配 2 個節點 (提高可用性)。

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

   在整合服務中使用 LinkedIn Marketing Solutions 連線

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

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

   實體作業範例

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

   範例 - 列出所有帳戶

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Accounts。
   3. 選取 List 作業，然後按一下「完成」。
   4. 在「連結器」工作的「工作輸入」部分，您可以根據篩選條件設定 filterClause。

   您必須使用單引號 (') 括住 filterClause 的值。您可以使用 filterClause，根據資料欄篩選記錄。

   範例 - 取得帳戶詳細資料

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Accounts。
   3. 選取 Get 作業，然後按一下「完成」。
   4. 將 entityId 設為 Id="514824232"，也就是要傳遞的鍵。
   5. 如要在「資料對應」的「資料對應工具」部分設定 entityId，請按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 Id="514824232"，並將 entityId 設為本機變數。

   如果傳遞 entityId 時因複合主鍵而擲回錯誤，可以使用 filterClause，例如 Id='514824232'。

   範例 - 建立使用者帳戶

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 AccountUsers。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "AccountURN": "urn:li:sponsoredAccount:515414784",
        "UserURN": "urn:li:person:jjWUdOLL5W",
        "Role": "VIEWER"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      { }
      

   範例 - 建立廣告活動群組

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 CampaignGroups。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Account": "urn:li:sponsoredAccount:514824232",
        "ScheduleStartTime": "2025-09-04 17:13:52",
        "ScheduleEndTime": "2025-11-21 14:49:13",
        "Status": "ACTIVE",
        "TotalBudgetAmount": 60000,
        "TotalBudgetCurrencyCode": "USD",
        "AdAccountId": "514824232",
        "Name": "campaigngroups1758517846396"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "Id": "776885434"
      }

   範例 - 建立廣告活動

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Campaigns。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Name": "Updated Campaign",
        "Account": "urn:li:sponsoredAccount:514824232",
        "CampaignGroup": "urn:li:sponsoredCampaignGroup:752369254",
        "DailyBudgetAmount": "5667",
        "Country": "US",
        "Language": "en",
        "OffsiteDeliveryEnabled": false,
        "ScheduleStartTime": "2025-09-04 17:13:52",
        "Status": "ACTIVE",
        "Type": "SPONSORED_UPDATES",
        "UnitCostAmount": "3.50",
        "UnitCostCurrency": "USD",
        "AdAccountId": "514824232",
        "DailyBudgetCurrency": "USD"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "Id": "416012984"
      }

   範例 - 建立廣告素材

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Creatives。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Campaign": "urn:li:sponsoredCampaign:382923024",
        "Content": "{    \"reference\": \"urn:li:share:7331580382389149698\"  }",
        "IntendedStatus": "DRAFT",
        "AdAccountId": "514824232",
        "Name": "Conversation creative"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "Id": "urn:li:sponsoredCreative:776547754"
      }

   範例 - 建立表單

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Forms。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Account": "urn:li:sponsoredAccount:514824232",
        "Description": "This is a sample form used for collecting leads",
        "Headline": "Join our newsletter!",
        "Name": "Sample Form Name",
        "Questions": "[\n\n  {\n\n    \"question\": {\n\n      \"localized\": {\n\n        \"en_US\": \"First Name\"\n\n      }\n\n    },\n\n    \"name\": \"firstName\",\n\n    \"questionDetails\": {\n\n      \"textQuestionDetails\": {}\n\n    },\n\n    \"predefinedField\": \"FIRST_NAME\"\n\n  },\n\n  {\n\n    \"question\": {\n\n      \"localized\": {\n\n        \"en_US\": \"Last Name\"\n\n      }\n\n    },\n\n    \"name\": \"lastName\",\n\n    \"questionDetails\": {\n\n      \"textQuestionDetails\": {}\n\n    },\n\n    \"predefinedField\": \"LAST_NAME\"\n\n  }\n\n]",
        "Message": "This is a sample message.",
        "Country": "us",
        "Language": "EN",
        "Status": "ARCHIVED",
        "LegalDisclaimer": "This is a legal disclaimer which is mandatory",
        "LandingPage": "https://altostrat.com/thank-you"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "Id": "1000154089"
      }
      

   範例 - 建立訊息廣告素材

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 MessageCreatives。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Name": "New Message Creative",
        "Subject": "Message creative",
        "BodyContent": "Message advertisement",
        "SubContent": "{\"regular\":{\"rightRailAdPicture\":\"urn:li:image:C5F22AQFIMShx0jJbQw\",\"callToActionLandingPageUrl\":\"http://www.linkedin.com\",\"callToActionText\":\"sample string\"}}",
        "SenderURN": "urn:li:person:6fmYVhh9wx",
        "AccountURN": "urn:li:sponsoredAccount:514824232"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "URN": "urn:li:adInMailContent:144290084"
      }

   範例 - 建立發布商限制檔案

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 PublisherRestrictionFiles。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Id": "1",
        "Creative": "urn:li:sponsoredCreative:668131684",
        "Account": "urn:li:sponsoredAccount:514824232",
        "Event": "IMPRESSION",
        "Platform": "DOUBLECLICK",
        "TrackingUrl": "https://ad.doubleclick.net/ddm/trackimp/N123456.123LINKEDIN/B12345678.123456789;dc_trk_aid=123456789;dc_trk_cid=987654321;ord=%%CACHEBUSTER%%;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=?"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "Id": "52164006"
      }

   範例 - 製作圖片

   1. 在 Configure connector task 對話方塊中，按一下 Action。
   2. 從 Action 清單中選取 Uploadimage。
   3. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "FileData": "/9j/4AAQSkZJ",
        "AccountURN": "urn:li:sponsoredAccount:514824232",
        "OwnerURN": "urn:li:organization:106639229",
        "AssetName": "New Image"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      [
        {
          "ImageURN": "urn:li:image:D4E10AQHeZAiDW6657A"
        }
      ]
      

   範例 - 製作影片

   1. 在 Configure connector task 對話方塊中，按一下 Action。
   2. 從 Action 清單中選取 UploadVideo。
   3. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "OwnerURN": "urn:li:organization:106639229",
        "AccountURN": "urn:li:sponsoredAccount:514824232",
        "FileData": "AAAAIGZ0eXBpc29tAAA",
        "AssetName": "Pink Bird",
        "HasThumbnail": true
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      [
        {
          "VideoURN": "urn:li:video:D4E10AQHYb2Oez5t1mg",
          "CaptionsUploadURL": null,
          "ThumbnailUploadURL": "https://www.linkedin.com/dms-uploads/sp/v2/D4E10AQHYb2Oez5t1mg/ads-video-userUploadedThumbnail/D4E01AQHTY8R0IkYdHA/0?ca=vector_ads&cn=uploads_secure&ccn=ambry-video&iri=B01-78&sync=0&v=beta&ut=2E4HdFnCb3Cs01"
        }
      ]
      

   範例 - 建立文件

   1. 在 Configure connector task 對話方塊中，按一下 Action。
   2. 從 Action 清單中選取 UploadDocument。
   3. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "OwnerURN": "urn:li:organization:106639229",
        "FileData": "JVBERi0xLjQKJcOkw7zDtsOfCjIgM"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      [
        {
          "DocumentURN": "urn:li:document:D4E10AQEZDx05fFC1hA"
        }
      ]
      

   範例 - 建立多張圖片貼文

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 CompanyStatusUpdates。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Comment": "MultiImage 1",
        "CreatedBy": "urn:li:organization:106639229",
        "Visibility": "PUBLIC",
        "LifecycleState": "PUBLISHED",
        "IsReshareDisabled": false,
        "Content": "{\n        \"multiImage\": {\n            \"images\": [\n                {\n                    \"id\": \"urn:li:image:D4E10AQG8WCH_KRHhMw\",\n                    \"altText\": \"testing for alt tags1\"\n                },\n                {\n                    \"id\": \"urn:li:image:D4E10AQHeZAiDW6657A\",\n                    \"altText\": \"testing for alt tags2\"\n                }\n            ]\n        }\n    }"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "Id": "urn:li:ugcPost:7399721854405484544"
      }

   範例 - 建立意見調查貼文

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 CompanyStatusUpdates。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Comment": "Test Post",
        "CreatedBy": "urn:li:organization:108472058",
        "Visibility": "PUBLIC",
        "LifecycleState": "PUBLISHED",
        "IsReshareDisabled": false,
        "Content": "{\n     \"poll\": {\n       \"question\" :\"What is your favorite color?\",\n       \"options\" : [ { \"text\" : \"Red\" }, { \"text\" : \"Blue\" }, {\"text\": \"Yellow\"}, {\"text\": \"green\"} ],\n       \"settings\" : { \"duration\" : \"THREE_DAYS\" }\n     }\n }"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "Id": "urn:li:ugcPost:7399410172072357888"
      }

   範例 - 建立貼文

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Posts。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Author": "urn:li:organization:106639229",
        "Commentary": "Image Post",
        "Visibility": "PUBLIC",
        "FeedDistribution": "MAIN_FEED",
        "LifecycleState": "PUBLISHED",
        "IsReshareDisabledByAuthor": false,
        "Content": "{\n    \"media\": {\n      \"title\":\"title of the video\",\n      \"id\": \"urn:li:image:D4E10AQHeZAiDW6657A\"\n    }\n  }"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "Id": "urn:li:share:7397570971332669440"
      }
      

   範例 - 建立目標對象範本

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 SavedAudienceTemplates。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "AccountURN": "urn:li:sponsoredAccount:514824232",
        "Name": "Saved Template 1",
        "TargetingCriteria": "{\n  \"include\": {\n    \"and\": [\n      {\n        \"or\": {\n          \"urn:li:adTargetingFacet:locations\": [\n            \"urn:li:geo:90000034\",\n            \"urn:li:geo:104079912\"\n          ]\n        }\n      },\n      {\n        \"or\": {\n          \"urn:li:adTargetingFacet:titles\": [\n            \"urn:li:title:1\",\n            \"urn:li:title:107\"\n          ]\n        }\n      }\n    ]\n  },\n  \"exclude\": {\n    \"or\": {\n      \"urn:li:adTargetingFacet:degrees\": [\n        \"urn:li:degree:1000\",\n        \"urn:li:degree:1100\"\n      ]\n    }\n  }\n}"
      }
      

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {
        "Id": "42831292"
      }
      

   範例 - 建立已儲存的目標對象範本

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 SavedAudienceTemplates。
   3. 選取 Create 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

      {
        "AccountURN": "urn:li:sponsoredAccount:514824232",
        "Name": "Saved Template 1",
        "TargetingCriteria": "{\n  \"include\": {\n    \"and\": [\n      {\n        \"or\": {\n          \"urn:li:adTargetingFacet:locations\": [\n            \"urn:li:geo:90000034\",\n            \"urn:li:geo:104079912\"\n          ]\n        }\n      },\n      {\n        \"or\": {\n          \"urn:li:adTargetingFacet:titles\": [\n            \"urn:li:title:1\",\n            \"urn:li:title:107\"\n          ]\n        }\n      }\n    ]\n  },\n  \"exclude\": {\n    \"or\": {\n      \"urn:li:adTargetingFacet:degrees\": [\n        \"urn:li:degree:1000\",\n        \"urn:li:degree:1100\"\n      ]\n    }\n  }\n}"
      }
      

      這個範例會建立 SavedAudienceTemplates。如果整合成功，Dashboard 工作 connectorOutputPayload 回應參數的值會類似於下列內容：

      {
        "Id": "42831292"
      }

   範例

   範例 - 對「活動」實體執行 CREATE 作業

   1. 在 Configure connector task 對話方塊中，按一下 Actions。
   2. 從 Action 清單中選取 CreateEvent。
   3. 選取 CreateEvent 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

      {
        "OrganizerURN": "urn:li:organization:106639229",
        "Name": "New Event 1",
        "Type": "IN_PERSON",
        "StartsAt": "2026-01-13 12:00:00"
      }

      這個範例會建立事件。如果整合成功，Dashboard 工作 connectorOutputPayload 回應參數的值會類似於下列內容：

      [
        {
          "Id": "7416342722296508416"
        }
      ]

   範例 - 更新帳戶

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Accounts。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "NotifiedOnEndOfCampaign": true
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 Accounts 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 Id="514824232"，並將 entityId 設為本機變數。

      除了指定 entityId，您也可以將 filterClause 設為 Id='514824232'

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新廣告活動群組

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 CampaignGroups。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Name": "jack"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 CampaignGroups 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 Id="776885434"，並將 entityId 設為本機變數。

      除了指定 entityId，您也可以將 filterClause 設為 Id='776885434' AND AdAccountId='514824232'

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新廣告活動

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Campaigns。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Name": "Last Campaign"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 Campaigns 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 Id="411932694"，並將 entityId 設為本機變數。

      您也可以將 filterClause 設為 Id='411932694' AND Name='New Campaign'，而非指定 entityId。

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新廣告素材

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Creatives。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "AdAccountId": "514824232",
        "Campaign": "urn:li:sponsoredCampaign:382923024",
        "Name": "New"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 Creatives 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 Id="urn:li:sponsoredCreative:668131684"，並將 entityId 設為本機變數。

      您也可以將 filterClause 設為 Id='urn:li:sponsoredCreative:668131684' AND AdAccountId='514824232'，而非指定 entityId。

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新表單詳細資料

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Forms。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Description": "new description",
        "Headline": "new headline",
        "Questions": "[\n  {\n    \"question\": {\n      \"localized\": {\n        \"en_US\": \"Last name\"\n      }\n    },\n    \"responseEditable\": true,\n    \"name\": \"Last name\",\n    \"questionDetails\": {\n      \"textQuestionDetails\": {\n        \"maxResponseLength\": 300\n      }\n    },\n    \"predefinedField\": \"LAST_NAME\",\n    \"label\": \"Last name\",\n    \"responseRequired\": true\n  },\n  {\n    \"question\": {\n      \"localized\": {\n        \"en_US\": \"First name\"\n      }\n    },\n    \"responseEditable\": true,\n    \"name\": \"First name\",\n    \"questionDetails\": {\n      \"textQuestionDetails\": {\n        \"maxResponseLength\": 300\n      }\n    },\n    \"predefinedField\": \"FIRST_NAME\",\n    \"label\": \"First name\",\n    \"responseRequired\": true\n  },\n  {\n    \"question\": {\n      \"localized\": {\n        \"en_US\": \"Email address\"\n      }\n    },\n    \"responseEditable\": true,\n    \"name\": \"Email address\",\n    \"questionDetails\": {\n      \"textQuestionDetails\": {\n        \"maxResponseLength\": 300\n      }\n    },\n    \"predefinedField\": \"EMAIL\",\n    \"label\": \"Email address\",\n    \"responseRequired\": true\n  }\n]",
        "LegalDisclaimer": "new legal"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 Forms 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 Id="12882604"，並將 entityId 設為本機變數。

      您也可以將 filterClause 設為 Id='12882604'，而非指定 entityId。

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新訊息廣告素材

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 MessageCreatives。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Name": "updated creative"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 MessageCreatives 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 Id="urn:li:adInMailContent:144110044"，並將 entityId 設為本機變數。

      除了指定 entityId，您也可以將 filterClause 設為 Id='urn:li:adInMailContent:144110044'

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新貼文

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Posts。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Commentary": "updated post"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 Post 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 Id="urn:li:share:7331580382389149698"，並將 entityId 設為本機變數。

      除了指定 entityId，您也可以將 filterClause 設為 Id='urn:li:share:7331580382389149698'

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新圖片

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Images。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "MediaLibraryName": "New Image Name",
        "MediaLibraryStatus": "ACTIVE"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 Images 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 URN="urn:li:image:D4E10AQHeZAiDW6657A"，並將 entityId 設為本機變數。

      您也可以將 filterClause 設為 AccountURN = 'urn:li:sponsoredAccount:514824232' AND URN= 'urn:li:image:D4E10AQHeZAiDW6657A'，而非指定 entityId。

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新影片

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Video。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "MediaLibraryName": "Updated Name"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 Video 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 URN="urn:li:video:D4E10AQHpuPTHnb1wXw"，並將 entityId 設為本機變數。

      除了指定 entityId，您也可以將 filterClause 設為 AccountURN = 'urn:li:sponsoredAccount:514824232' AND URN= 'urn:li:video:D4E10AQHpuPTHnb1wXw'

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新活動

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Event。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "VanityName": "mytestevent7382067115601719297456"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 Event 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入 Id="7399372283628306432"，並將 entityId 設為本機變數。

      除了指定 entityId，您也可以將 filterClause 設為 Id='7399372283628306432'

      如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

        { }
      

   範例 - 更新已儲存的目標對象範本

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 SavedAudienceTemplates。
   3. 選取 Update 作業，然後按一下「完成」。
   4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並將 connectorInputPayload 設為本機變數。

      {
        "Name": "Updated Saved Audience Templates"
      }
      

   5. 在「資料對應工具」中，將 entityId 設為 SavedAudienceTemplates 的實體。
   6. 如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 Id='42831292'

   如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

     {"Id": "null"}
   

   範例 - 刪除帳戶

   1. 在 Configure connector task 對話方塊中，按一下 Entities。
   2. 從 Entity 清單中選取 Accounts。
   3. 選取 Delete 作業，然後按一下「完成」。
   4. 將 entityId 設為 Id="514824232"，也就是要傳遞的鍵。
   5. 如要設定 entityId，請在「資料對應」的「資料對應工具」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 Id="514824232"，並將 entityId 設為本機變數。

   向 Google Cloud 社群尋求協助

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

   後續步驟

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