Membuat atau menghapus link partner

Berikut cara membuat atau menghapus resource PartnerLink. Data Manager API mendukung pembuatan penautan partner untuk jenis akun berikut:

• Akun Google Ads
• Akun partner Display & Video 360 atau pengiklan Display & Video 360
• Akun Google Ad Manager

Membuat penautan

Buat PartnerLink dengan mengirimkan CreatePartnerLinkRequest.

Membuat isi permintaan

Buat resource PartnerLink. Berikut kolom yang harus ditetapkan.

owning_account

Mengidentifikasi akun pengiklan yang memiliki link. Tetapkan ke objek ProductAccount.

Tetapkan account_type ke AccountType akun pengiklan.

Tetapkan account_id ke ID akun pengiklan.

Lihat panduan tujuan dan header untuk mengetahui petunjuk tentang ID yang akan digunakan untuk setiap jenis pengiklan.

partner_account

Mengidentifikasi akun partner. Tetapkan ke objek ProductAccount.

Tetapkan account_type ke AccountType akun partner. Misalnya, jika penautan berasal dari akun pengiklan ke akun partner data, tetapkan kolom ini ke DATA_PARTNER.

Tetapkan account_id ke ID akun partner.

Membuat permintaan

Untuk membuat link partner, buat CreatePartnerLinkRequest.

1. Tetapkan parent ke nama resource akun pengiklan. Gunakan format:

   accountTypes/{account_type}/accounts/{account}
   

2. Tetapkan partner_link ke resource PartnerLink yang Anda buat.

3. Jika kredensial Anda ditujukan untuk Akun Google yang memiliki akses ke akun induk akun pengiklan, seperti akun pengelola Google Ads atau akun Partner Display & Video 360, tetapkan header login-account seperti yang dijelaskan dalam Mengonfigurasi tujuan dan header.

Berikut adalah contoh permintaan dalam JSON untuk membuat penautan ke akun partner data di berbagai jenis akun pengiklan.

Google Ads

Buka di API Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Pengiklan DV360

Buka di API Explorer

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Partner DV360

Buka di API Explorer

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Google Ad Manager

Buka di API Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Kirim permintaan

Kirim permintaan dan, jika diperlukan, sertakan header permintaan. Gunakan kredensial untuk Akun Google yang memiliki akses ke owning_account.

Jika permintaan berhasil, respons akan berisi PartnerLink yang dibuat dengan id dan name yang terisi.

Jika permintaan gagal, periksa error untuk menentukan penyebab kegagalan, perbarui permintaan dan header untuk memperbaiki masalah, lalu kirim permintaan dan header yang telah diperbarui.

Menghapus tautan

Untuk menghapus PartnerLink, kirim DeletePartnerLinkRequest dengan name yang ditetapkan ke nama resource. Tetapkan header jika diperlukan.