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 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 tersebut 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.

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 ditetapkan; server Google Ads API akan menetapkannya 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 Mengambil undangan Gunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk membuat kueri ke resource product_link_invitation. Filter untuk status = PENDING_APPROVAL guna menerima atau menolak undangan yang tertunda.
Menerima atau menolak undangan Gunakan metode ProductLinkInvitationService.UpdateProductLinkInvitation untuk memperbarui status ProductLinkInvitation menjadi ACCEPTED atau REJECTED.
Mencabut undangan Gunakan metode ProductLinkInvitationService.RemoveProductLinkInvitation untuk mencabut ProductLinkInvitation yang ada.

Error umum berikut dapat ditampilkan 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 jika Anda memiliki akses administrator ke akun Google Ads dan akun produk. Dalam hal ini, Anda langsung menautkan akun Google Ads ke akun produk, bukan mengirim undangan.

Metode berikut digunakan dalam skenario ini:

Tindakan Keterangan
Buat link aktif Gunakan ProductLinkService.createProductLink untuk membuat ProductLink.
Menonaktifkan link aktif Gunakan ProductLinkService.removeProductLink untuk menghapus ProductLink yang aktif.
Mengambil link aktif Gunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk membuat kueri resource product_link.

Error umum berikut dapat ditampilkan dalam alur kerja ini:

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

Perubahan pada AccountLinkService

Jika 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, migrasikan dari AccountLinkService dan gunakan ProductLinkService:

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

Untuk ThirdPartyAppAnalyticsLinkIdentifier, terus gunakan AccountLinkService.