Menautkan akun produk

Google Ads API mendukung penautan akun Google Ads ke akun produk lainnya. Panduan ini menjelaskan cara menggunakan API untuk menautkan akun Anda.

Saat menautkan akun Google Ads ke akun produk lain, ada dua cara berbeda untuk melakukan penautan.

Alur undangan

Gunakan alur undangan jika Anda memiliki akses administrator ke akun Google Ads, tetapi tidak memiliki akses administrator ke akun produk. Alur ini berfungsi dalam dua skenario:

  1. Anda ingin menautkan kedua akun dan membuat undangan untuk administrator akun produk. Administrator akun produk menerima undangan untuk menyelesaikan proses penautan akun.
  2. Administrator akun produk ingin menautkan kedua akun tersebut, tetapi tidak memiliki akses ke akun Google Ads. Administrator akun produk membuat undangan, dan Anda menerima undangan tersebut serta menyelesaikan proses penautan.

Gunakan metode berikut dalam skenario ini:

Skenario Tindakan Keterangan
Skenario 1 Membuat undangan Gunakan metode ProductLinkInvitationService.CreateProductLinkInvitation untuk membuat undangan. status ProductLinkInvitation tidak boleh disetel; server Google Ads API akan menyetelnya ke REQUESTED setelah panggilan API berhasil diselesaikan. Saat membuat undangan untuk Partner Iklan (AdvertisingPartnerLinkInvitationIdentifier), advertising_partner_properties.allowed_domain diperlukan mulai di v25 (dan bersifat opsional di v24 dan yang lebih lama).
Memeriksa status undangan Gunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk membuat kueri resource product_link_invitation dan memeriksa statusnya.
Skenario 2 Mendapatkan undangan Gunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk membuat kueri resource product_link_invitation. Filter untuk status = PENDING_APPROVAL untuk menerima atau menolak undangan yang menunggu keputusan.
Menerima atau menolak undangan Gunakan metode ProductLinkInvitationService.UpdateProductLinkInvitation untuk memperbarui status ProductLinkInvitation menjadi ACCEPTED atau REJECTED.
Membatalkan undangan Gunakan metode ProductLinkInvitationService.RemoveProductLinkInvitation untuk mencabut ProductLinkInvitation yang ada.

Error umum berikut dapat terjadi dalam alur kerja ini:

Kode error Penjelasan
ProductLinkInvitationError.PERMISSION_DENIED Pelanggan tidak memiliki izin untuk melakukan tindakan ini.
ProductLinkInvitationError.NO_INVITATION_REQUIRED Undangan tidak dapat dibuat karena pengguna sudah memiliki akses administrator ke akun yang diundang. Pengguna harus menggunakan ProductLinkService untuk membuat link aktif secara langsung.

Alur penautan langsung

Gunakan alur penautan langsung jika Anda memiliki akses administrator ke akun Google Ads dan akun produk. Dalam hal ini, tautkan akun Google Ads langsung ke akun produk, bukan mengirim undangan.

Gunakan metode berikut dalam skenario ini:

Tindakan Keterangan
Membuat link aktif Gunakan ProductLinkService.CreateProductLink untuk membuat ProductLink.
Menonaktifkan link aktif Gunakan ProductLinkService.RemoveProductLink untuk menghapus ProductLink aktif.
Mengambil link aktif Gunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk membuat kueri resource product_link.

Error umum berikut mungkin terjadi dalam alur kerja ini:

Kode error Penjelasan
ProductLinkError.CREATION_NOT_PERMITTED Penautan akun dicoba menggunakan alur link langsung, tetapi tidak didukung karena kurangnya izin. Pengguna harus menggunakan ProductLinkInvitationService untuk melakukan alur undangan.
ProductLinkError.INVITATION_EXISTS Link tidak dapat dibuat karena undangan yang tertunda sudah ada.

Anda dapat mengambil semua link produk yang terkait dengan akun Google Ads menggunakan kueri GAQL terhadap resource product_link.

SELECT
  product_link.product_link_id,
  product_link.type
FROM product_link

Kolom product_link.type menunjukkan jenis produk atau layanan tertaut. Bergantung pada type, kolom lain dalam resource product_link akan diisi, sehingga memberikan detail selengkapnya tentang link tersebut. Misalnya, jika jenisnya adalah DATA_PARTNER, kolom data_partner akan berisi informasi tentang akun partner data tertaut.

Dengan begitu, Anda dapat memperoleh daftar layanan eksternal dan akun produk yang ditautkan langsung ke akun Google Ads Anda, seperti Merchant Center, Google Ads, Partner Iklan, atau partner data.

Perubahan pada AccountLinkService

Jika Anda menggunakan AccountLinkService untuk menautkan akun Google Ads ke akun produk lain, Anda harus memigrasikan aplikasi yang ada ke salah satu alur kerja yang tercantum sebelumnya. Untuk jenis link berikut, lakukan migrasi dari AccountLinkService dan gunakan ProductLinkService:

Untuk ThirdPartyAppAnalyticsLinkIdentifier, terus gunakan AccountLinkService.

Sebelumnya
Mengelola undangan akses pengguna
Berikutnya
Menautkan YouTube