字段映射

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

对象字段映射

使用表格中的映射将 ProductLink在 Google Ads API 中映射到 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 中，customer_id 的 resource_name 的 ProductLink 表示哪个账号拥有现有关联。创建 ProductLink 时，您可以通过设置 customer_id 的 CreateProductLinkRequest 来指明关联的所有者。

在 Data Manager API 中，accountType 和 accountId 的 owning_account 的组合表示哪个 账号拥有现有关联。创建 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

发送 SearchPartnerLinkRequest。 可选的 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 无对等项。

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

上一页
升级步骤