Anda dapat menggunakan Accounts API untuk mengelola hubungan antara akun Merchant Center Anda dan penyedia layanan lainnya. Hubungan adalah koneksi formal yang memungkinkan penyedia menawarkan layanan tertentu kepada bisnis Anda. Layanan menentukan izin dan kemampuan yang diberikan kepada penyedia, seperti pengelolaan produk atau pengelolaan kampanye. Misalnya, dengan menautkan akun Merchant Center ke akun Google Ads, akun Google Ads dapat menggunakan data produk Anda untuk menjalankan kampanye iklan.
Hubungan terdiri dari atribut berikut:
- Akun Merchant Center yang menerima layanan
- Penyedia layanan
- Layanan atau serangkaian layanan yang diberikan ke akun Merchant Center
Penyedia layanan dapat mengaitkan alias dengan akun yang mereka layani (ini setara dengan kolom seller_id
yang ada di resource
account
di Content API for Shopping). Alias dapat ditetapkan menggunakan
kolom account_id_alias
opsional dalam resource AccountRelationship
dan
berfungsi sebagai ID kustom.
Struktur URL untuk mengakses akun menggunakan aliasnya adalah
GET /accounts/v1/accounts/{provider}~{account_id_alias}
.
Layanan
Di Accounts API, akun dapat menerima layanan berikut:
Penggabungan akun: Memodelkan hubungan antara akun lanjutan dan akun yang dilayaninya. Penyedia layanan (akun lanjutan) mendapatkan akses penuh dan tidak terbatas ke sub-akun tertaut.
externalAccountId
dalam hal ini adalah ID akun Merchant Center. Saat Anda membuat sub-akun,externalAccountId
harus dihilangkan, karena akan ditetapkan ke ID akun saat pembuatan.Pengelolaan kampanye: Layanan ini memodelkan penautan antara akun Merchant Center dan akun Google Ads, sehingga memberikan akses akun Google Ads ke data produk dan akun yang diperlukan untuk menjalankan kampanye iklan. Penyedia layanan dalam hal ini adalah
GOOGLE_ADS
danexternalAccountId
adalah ID akun Google Ads.Perbandingan belanja: Ini menunjukkan hubungan dengan Layanan Perbandingan Belanja (CSS) yang mengoperasikan akun Merchant Center.
Pengelolaan listingan lokal: Ini menunjukkan hubungan dengan pengelola toko untuk mengelola inventaris dan listingan lokal menggunakan Google Profil Bisnis.
Pengelolaan akun: Layanan ini memungkinkan penyedia melakukan tindakan administratif pada akun Merchant Center, seperti mengonfigurasi setelan akun, mengelola pengguna, atau memperbarui informasi bisnis. Bisnis juga dapat membatasi akses yang diberikan.
Pengelolaan produk: Layanan ini memungkinkan penyedia mengelola produk dan fitur terkait seperti sumber data dan aturan.
Bersalaman
Untuk membuat layanan, akun yang menyediakan layanan dan akun yang menerima layanan harus mengizinkan koneksi. Proses otorisasi ini disebut sebagai negosiasi.
Proses jabat tangan terdiri dari dua langkah:
- Salah satu pihak mengusulkan link layanan.
- Pihak lain menyetujui atau menolak proposal.
Setelah proposal disetujui, layanan akan disetujui dan dianggap telah sepenuhnya ditetapkan. Setiap hak akses yang diberikan kepada penyedia layanan kini diberikan kepada pengguna yang memenuhi syarat (Lihat hak akses di bawah).
Perhatikan bahwa pengguna yang membuat, menolak, atau menyetujui proposal harus memiliki
hak akses ADMIN
di akun yang memulai proses. Jadi, jika penyedia layanan mengusulkan layanan, pengguna yang membuat usulan harus merupakan ADMIN
di akun penyedia layanan dan pengguna yang menerima atau menolak usulan harus merupakan ADMIN
di akun penerima.
Perilaku pertukaran data khusus layanan
Berikut adalah deskripsi persyaratan handshake khusus untuk setiap layanan individual:
Penggabungan akun: Layanan ini hanya dapat dibuat sebagai bagian dari pembuatan akun. Penyedia layanan diharapkan berupa akun lanjutan, dan layanan disetujui secara otomatis karena pengguna akun lanjutan memiliki akses
ADMIN
penuh ke akun yang sedang dibuat.Pengelolaan kampanye: Meskipun mengikuti proses inisiasi normal, proposal dibuat di satu sistem (misalnya Google Ads) dan persetujuan dilakukan di sistem lain (misalnya di Merchant Center atau melalui Merchant API).
Pengelolaan listingan lokal: Untuk layanan ini, handshake diusulkan dalam metode khusus dan persetujuan dilakukan di sistem lain (misalnya, Google Profil Bisnis). Langkah-langkah mendetailnya ada di Panduan untuk menautkan profil bisnis Google.
Pengelolaan akun: Untuk layanan ini, proses verifikasi reguler berlaku (diusulkan oleh penyedia layanan atau bisnis, diikuti dengan persetujuan dari pihak lain).
Pengelolaan produk: Untuk layanan ini, proses inisiasi reguler berlaku (diusulkan oleh satu pihak, diikuti dengan penerimaan dari pihak lain).
Hak akses
Setiap jenis layanan memberikan tingkat akses tertentu bagi pengguna penyedia layanan atas akun yang dilayani:
Agregasi akun: Layanan ini memberikan hak
ADMIN
penuh.Pengelolaan kampanye: Layanan ini memberikan hak akses terbatas, sehingga akun Google Ads terkait dapat mengakses produk dan informasi akun dasar.
Perbandingan belanja: Layanan ini menyediakan, secara default, hak
ADMIN
penuh. Namun, bisnis dapat membatasi akses yang diberikan di Merchant Center.Pengelolaan listingan lokal: Layanan ini tidak memberikan hak akses langsung. Sebagai gantinya, listingan ini memungkinkan produknya disinkronkan dengan akun Merchant Center.
Penting: Hak akses yang dijelaskan untuk jenis layanan berikut hanya berlaku untuk penyedia layanan yang disetujui. Hubungi tim dukungan kami jika Anda adalah penyedia layanan dan ingin menggunakan kemampuan ini. Jika sebelumnya Anda telah disetujui untuk menggunakan metode accounts.link
untuk pengelolaan produk di Content API for Shopping, Anda dapat menggunakan layanan ini di Merchant API tanpa persetujuan lebih lanjut.
Pengelolaan akun: Layanan ini menyediakan hak
ADMIN
penuh secara default.Pengelolaan produk: Layanan ini memberikan hak
ADMIN
penuh. Perhatikan bahwa pada masa mendatang, akses ini hanya akan terbatas pada hak akses terkait produk.
Cara penerapan hubungan untuk platform pihak ketiga
Jika Anda adalah platform pihak ketiga yang mengelola akun atas nama bisnis lain, berikut ini menunjukkan cara berbagai konsep dipetakan ke struktur akun Anda:
- Penyedia layanan: Akun lanjutan Anda.
- Akun yang menerima layanan: Akun Merchant Center yang mewakili bisnis yang Anda kelola.
- Layanan:
accountAggregation
, jika Anda membuat akun ini sebagai sub-akun dari akun lanjutan Anda. Namun, hal ini tidak disarankan dan layanan yang lebih disarankan adalahaccountManagement
.accountManagement
, jika Anda menyiapkan layanan ini setelah pembuatan akun ke akun yang bukan sub-akun dari akun lanjutan Anda.
Untuk mengetahui detail tentang cara menyiapkan akun tingkat lanjut dan menautkan ke akun Merchant Center baru, lihat Membuat dan mengelola sub-akun.