创建或删除合作伙伴链接

下面介绍了如何创建或删除 PartnerLink 资源。Data Manager API 支持为以下账号类型创建合作伙伴关联:

  • Google Ads 账号
  • Display &Video 360 合作伙伴或 Display &Video 360 广告客户账号

发送 CreatePartnerLinkRequest 以创建 PartnerLink

构建请求正文

创建 PartnerLink 资源。以下是要设置的字段。

owning_account

用于标识拥有关联的广告客户账号。设置为 ProductAccount 对象。

account_type 设置为广告客户账号的 AccountType

account_id 设置为广告客户账号的 ID。

如需了解每种广告客户应使用的 ID,请参阅目标和标头指南,其中提供了 相关说明。

partner_account

用于标识合作伙伴账号。设置为 ProductAccount 对象。

account_type 设置为合作伙伴账号的 AccountType。例如,如果关联是从广告客户账号到数据合作伙伴账号,请将此字段设置为 DATA_PARTNER

account_id 设置为合作伙伴账号的 ID。

构建请求

如需创建合作伙伴关联,请构建 CreatePartnerLinkRequest

  1. parent 设置为广告客户账号的资源名称。使用以下格式:

    accountTypes/{account_type}/accounts/{account}
    
  2. partner_link 设置为您构建的 PartnerLink 资源。

  3. 如果您的凭据适用于有权访问广告客户账号的父级账号(例如 Google Ads 经理账号或 Display & Video 360 合作伙伴账号)的 Google 账号,请按照 配置目标和标头中的说明设置 login-account 标头。

以下是 JSON 格式的示例请求,用于在不同类型的广告客户账号中创建与数据合作伙伴账号的关联。

{
    "parent": "accountTypes/GOOGLE_ADS/accounts/INSERT_GOOGLE_ADS_CUSTOMER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "GOOGLE_ADS",
            "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

DV360 广告客户

{
    "parent": "accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/INSERT_DISPLAY_VIDEO_ADVERTISER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_ADVERTISER",
            "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

DV360 合作伙伴

{
    "parent": "accountTypes/DISPLAY_VIDEO_PARTNER/accounts/INSERT_DISPLAY_VIDEO_PARTNER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_PARTNER",
            "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

发送请求

发送请求,并根据需要添加 请求标头。使用有权访问 owning_account 的 Google 账号的凭据。

如果请求成功,响应将包含已创建的 PartnerLink,其中填充了 idname

如果请求失败,请检查错误以确定失败原因,更新请求和标头以解决任何问题,然后发送更新后的请求和标头。

如需删除 PartnerLink,请发送 DeletePartnerLinkRequest,并将 name 设置为资源名称。根据需要设置标头