Membuat atau menghapus link partner

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

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

Membuat penautan

Buat PartnerLink dengan mengirim CreatePartnerLinkRequest.

Membuat isi permintaan

Buat resource PartnerLink. Berikut kolom yang akan ditetapkan.

owning_account

Mengidentifikasi akun pengiklan yang memiliki tautan. 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 tautan 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 tautan 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 untuk Akun Google dengan 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 contoh permintaan dalam JSON untuk membuat tautan 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"
    }
}

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 dengan yang id dan name diisi.

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

Menghapus tautan

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