字段映射

使用字段映射将合作伙伴链接工作流程的每个步骤从 Google Ads API 升级到 Data Manager API：

对象字段映射

使用表格中的映射关系，将 Google Ads API 中的 ProductLink 映射到数据管理器 API 中对应的 PartnerLink。

ProductLink (Google Ads API) PartnerLink（数据管理器 API） 备注
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account Data Manager API 没有针对每种类型的关联账号设置单独的字段。 对于所有账号类型，请将 partner_account 字段设置为 ProductAccount，并设置其 account_type 和 account_id 以标识关联的账号。
product_link_id partner_link_id
resource_name name

在 Google Ads API 中，ProductLink 的 resource_name 的 customer_id 用于指明哪个账号拥有现有链接。创建 ProductLink 时，您可以通过设置 CreateProductLinkRequest 的 customer_id 来指明链接的所有者。

在 Data Manager API 中，owning_account 的 accountType 和 accountId 的组合表示哪个账号拥有现有关联。创建 PartnerLink 时，您可以通过将 name 设置为所有者的资源名称来指明链接的所有者。

如需了解详情，请参阅资源名称和创建请求。

type owning_account.account_type

资源名称

数据管理器 API 使用的资源名称格式与 Google Ads API 不同。

Google Ads API

在 Google Ads API 中，ProductLink 资源名称采用以下格式：

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

在 Data Manager API 中，PartnerLink 资源名称采用以下格式：

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

关联管理请求映射

使用本部分中的请求映射来转换用于创建、删除和检索合作伙伴链接的请求。

创建请求

下表列出了将 Google Ads API 中的 CreateProductLinkRequest 转换为数据管理器 API 中的等效 CreatePartnerLinkRequest 的字段映射。

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest（数据管理器 API） 备注
customer_id parent 设置为所属广告客户账号的资源名称。
product_link partner_link 设置为 PartnerLink 资源。请参阅对象字段映射

删除请求

下表列出了将 Google Ads API 中的 RemoveProductLinkRequest 转换为数据管理器 API 中的等效 DeletePartnerLinkRequest 的字段映射。

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest（数据管理器 API） 备注
customer_id 无对等项。 name 字段封装了所有者账号和合作伙伴账号，因此不需要此额外字段。
resource_name name 设置为要移除的 PartnerLink 的资源名称。
validate_only 无对等项。

链接检索请求映射

Google Ads API 和 Data Manager API 在检索合作伙伴链接方面采用的方法有所不同。

Google Ads API

发送包含 query 的 SearchGoogleAdsRequest。查询的可选 WHERE 子句用于定义要返回哪些资源。查询的 SELECT 子句用于定义要在返回的部分资源中填充哪些字段。

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
Data Manager API

发送 SearchPartnerLinkRequest。 可选的 filter 请求字段用于定义要返回哪些资源。 响应包含完整的资源，其中填充了所有字段。

下表列出了将 Google Ads API 中的 SearchGoogleAdsRequest 转换为数据管理器 API 中的等效 SearchPartnerLinksRequest 的字段映射。

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest（数据管理器 API） 备注
customer_id parent 设置为要搜索的账号的资源名称。
page_size page_size
page_token page_token
query filter 设置 filter 以定义要返回哪些资源。Data Manager API 会返回完整资源，因此没有与 SELECT 子句等效的子句。
search_settings 无对等项。
validate_only 无对等项。

如需了解详情（包括如何构建 SearchPartnerLinksRequest 请求的 filter 以及如何针对不同场景设置请求标头），请参阅检索合作伙伴链接。

上一页
升级步骤