创建或删除合作伙伴链接

以下是创建或删除 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 合作伙伴账号），请按照配置目的地和标头中所述设置 login-account 标头。

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

Google Ads

在 API Explorer 中打开

{
    "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 广告客户

在 API Explorer 中打开

{
    "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 合作伙伴

在 API Explorer 中打开

{
    "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，其中 id 和 name 已填充。

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

删除链接

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