LinkedIn 营销解决方案

借助 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 > 连接页面，然后选择或创建一个 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 Marketing Solutions 连接支持以下身份验证类型：

        • OAuth 2.0 - 客户端凭据

        2. 如需了解如何配置这些身份验证类型，请参阅配置身份验证。

      2. 点击下一步。
    11. 查看：查看您的连接和身份验证详细信息。
    12. 点击创建。

    配置身份验证

    根据您要使用的身份验证输入详细信息。

    • OAuth 2.0 - 客户端凭据
      • 客户端 ID：输入要用于连接的客户端 ID。
      • 范围：输入要用于连接的范围。
      • 客户端密钥：输入包含客户端密钥的 Secret Manager 密钥。
      • 密钥版本：选择客户端密钥的密钥版本。
      • 授权网址：输入授权网址。
      • 启用身份验证替换：选择此选项可启用替换身份验证。

    连接配置示例

    本部分列出了创建连接时配置的各个字段的示例值。

    OAuth 2.0 - 客户端凭据连接类型

    字段名称 详细信息
    位置 us-central1
    连接器 LinkedIn 营销解决方案
    连接器版本 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
    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。

      5. 您必须使用英文单引号 (') 将 filterClause 的值括起来。您可以使用 filterClause 根据列过滤记录。

    示例 - 获取账号详细信息

    1. 在 Configure connector task 对话框中，点击 Entities。
    2. 从 Entity 列表中选择 Accounts。
    3. 选择 Get 操作，然后点击完成。
    4. 将 entityId 设置为要传递的键 Id="514824232"。
    5. 如需在数据映射的数据映射器部分中设置 entityId，请点击打开数据映射编辑器，然后在输入值字段中输入 Id="514824232"，并将 entityId 设置为局部变量。

      6. 如果传递 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 设置为局部变量。

      您也可以将 filterClause 设置为 Id='514824232'，而不是指定 entityId

      如果集成成功，连接器任务的 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 设置为局部变量。

      您也可以将 filterClause 设置为 Id='776885434' AND AdAccountId='514824232'，而不是指定 entityId

      如果集成成功，连接器任务的 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 设置为局部变量。

      您也可以将 filterClause 设置为 Id='urn:li:adInMailContent:144110044'，而不是指定 entityId

      如果集成成功，连接器任务的 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 设置为局部变量。

      您也可以将 filterClause 设置为 Id='urn:li:share:7331580382389149698'，而不是指定 entityId

      如果集成成功，连接器任务的 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 设置为局部变量。

      您也可以将 filterClause 设置为 AccountURN = 'urn:li:sponsoredAccount:514824232' AND URN= 'urn:li:video:D4E10AQHpuPTHnb1wXw'，而不是指定 entityId

      如果集成成功，连接器任务的 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 设置为局部变量。

      您也可以将 filterClause 设置为 Id='7399372283628306432'，而不是指定 entityId

      如果集成成功，连接器任务的 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 作为局部变量。

      7. 您也可以将 filterClause 设置为 Id='42831292'，而不是指定 entityId

      如果集成成功，连接器任务的 connectorOutputPayload 响应参数将具有类似以下的值：

        {"Id": "null"}

    示例 - 删除账号

    1. 在 Configure connector task 对话框中，点击 Entities。
    2. 从 Entity 列表中选择 Accounts。
    3. 选择 Delete 操作，然后点击完成。
    4. 将 entityId 设置为要传递的键 Id="514824232"。
    5. 如需设置 entityId，请在数据映射的数据映射器部分中，点击打开数据映射编辑器，然后在输入值字段中输入 Id="514824232"，并将 entityId 设置为局部变量。

    向 Google Cloud 社区寻求帮助

    您可以在 Google Cloud 社区的 Cloud 论坛中发布您的问题以及讨论此连接器。

    后续步骤