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 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 untuk membuat undangan.ProductLinkInvitationService.CreateProductLinkInvitation status status ProductLinkInvitation 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 resource product_link_invitation. Filter untuk status = PENDING_APPROVAL untuk 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 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 aktif ProductLink.
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 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.

Anda dapat mengambil semua penautan 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 THIRD_PARTY_APP_ANALYTICS, kolom third_party_app_analytics akan berisi informasi tentang penyedia analisis.

Hal ini memungkinkan Anda mendapatkan daftar layanan dan aplikasi eksternal yang ditautkan langsung ke akun Google Ads, seperti Google Play, partner data, atau platform analisis aplikasi pihak ketiga.

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

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

Untuk ThirdPartyAppAnalyticsLinkIdentifier, terus gunakan AccountLinkService.

Sebelumnya
Mengelola undangan akses pengguna
Berikutnya
Tautkan YouTube