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

Alur undangan digunakan saat 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, tetapi tidak memiliki akses ke akun Google Ads. Administrator akun produk membuat undangan, dan Anda menerima undangan tersebut serta menyelesaikan proses penautan.

Metode berikut digunakan dalam skenario ini:

Skenario Tindakan Keterangan
Skenario 1 Membuat undangan Gunakan metode ProductLinkInvitationService.CreateProductLinkInvitation untuk membuat undangan. status dari ProductLinkInvitation tidak boleh disetel; server Google Ads API akan menyetelnya ke REQUESTED setelah panggilan API berhasil diselesaikan.
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.
Mencabut undangan Gunakan metode ProductLinkInvitationService.RemoveProductLinkInvitation untuk membatalkan 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.
ProductLinkError.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

Alur penautan langsung digunakan saat Anda memiliki akses administrator ke akun Google Ads dan akun produk. Dalam hal ini, Anda menautkan akun Google Ads langsung ke akun produk, bukan mengirim undangan.

Metode berikut digunakan 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 dapat terjadi dalam alur kerja ini:

Kode error Penjelasan
ProductLinkError.CREATION_NOT_PERMITTED Penautan akun dicoba menggunakan alur penautan langsung, tetapi hal ini 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.

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:

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

Untuk ThirdPartyAppAnalyticsLinkIdentifier, terus gunakan AccountLinkService.