建立或刪除合作夥伴連結

以下說明如何建立或刪除 PartnerLink 資源。資料管理工具 API 支援為下列帳戶類型建立合作夥伴連結：

• Google Ads 帳戶
• 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 帳戶，例如 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 設為資源名稱。視需要設定標頭。