字段映射

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

身份验证

Data Manager API 需要具有与 Google Ads API 不同的范围的凭据。您必须生成包含用于管理合作伙伴关联的 Data Manager API 范围的新凭证。

对象字段映射

使用表格中的映射关系，将 Google Ads API 中的 ProductLink 映射到 Data Manager API 中的等效 PartnerLink。

ProductLink (Google Ads API) PartnerLink (Data Manager 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

资源名称

Data Manager 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 转换为 Data Manager API 中等效 CreatePartnerLinkRequest 的字段映射。

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

删除请求

以下是将 Google Ads API 中的 RemoveProductLinkRequest 转换为 Data Manager API 中等效 DeletePartnerLinkRequest 的字段映射。

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest (Data Manager 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

发送 SearchPartnerLinksRequest。 可选的 filter 请求字段定义要返回的资源。响应包含完整资源，其中所有字段均已填充。

以下是将 Google Ads API 中的 SearchGoogleAdsRequest 转换为 Data Manager API 中等效 SearchPartnerLinksRequest 的字段映射。

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest (Data Manager 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 以及如何针对不同场景设置请求标头，请参阅检索合作伙伴链接。

上一页
升级步骤