Membuat atau menghapus link partner

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

Akun Google Ads
Akun partner Display & Video 360 atau akun pengiklan Display & Video 360

Membuat link

Buat PartnerLink dengan mengirimkan CreatePartnerLinkRequest.

Buat isi permintaan

Buat resource PartnerLink. Berikut kolom yang perlu ditetapkan.

owning_account

Mengidentifikasi akun pengiklan yang memiliki penautan. Disetel ke objek ProductAccount.

Tetapkan account_type ke AccountType akun pengiklan.

Setel 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. Disetel ke objek ProductAccount.

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

Setel account_id ke ID akun partner.

Buat permintaan

Untuk membuat link partner, buat CreatePartnerLinkRequest.

Tetapkan parent ke nama resource akun pengiklan. Gunakan format:
```
accountTypes/{account_type}/accounts/{account}
```
Tetapkan partner_link ke resource PartnerLink yang Anda buat.
Jika kredensial Anda adalah untuk Akun Google dengan akses ke akun induk dari 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

{
    "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"
        }
    }
}

Pengiklan DV360

Buka di 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"
        }
    }
}

Partner DV360

Buka di 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"
        }
    }
}

Kirim permintaan

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

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

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