Merchant API v1beta dihentikan dan ditutup pada 28 Februari 2026. Untuk mengetahui langkah-langkah transisi ke versi stabil terbaru, lihat Bermigrasi dari v1beta ke v1.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Mengelola hubungan akun

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, menautkan akun Merchant Center Anda ke akun Google Ads memungkinkan akun Google Ads menggunakan data produk Anda untuk menjalankan kampanye iklan.

Hubungan terdiri dari atribut berikut:

Akun Merchant Center yang menerima layanan
Penyedia layanan
Layanan atau kumpulan layanan yang diberikan ke akun Merchant Center

Alias

Penyedia layanan dapat mengaitkan alias dengan akun yang mereka layani (ini setara dengan kolom seller_id yang ada di resource akun di Content API for Shopping). Alias dapat ditetapkan menggunakan kolom account_id_alias opsional dalam resource AccountRelationship dan berfungsi sebagai ID kustom. Alias harus terdiri dari 1 hingga 50 karakter yang dipilih dari huruf ASCII, digit desimal, tanda hubung, garis bawah, titik, atau tilde ([A-Za-z0-9_~.-]{1,50}).

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. Anda dapat menambahkan banyak layanan ini selama pembuatan akun.

Agregasi akun: Layanan ini menautkan akun lanjutan ke akun lain, sehingga memberikan akses penuh dan tidak dibatasi ke akun lanjutan. Layanan ini biasanya digunakan oleh marketplace, retailer multi-brand, atau retailer internasional yang memerlukan kontrol terpusat atas akun bertingkat. Jika Anda adalah platform e-commerce atau partner saluran, sebaiknya gunakan accountManagement. Saat Anda membuat akun menggunakan agregasi akun, externalAccountId harus dihilangkan.
Pengelolaan kampanye: Layanan ini memodelkan link 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 dan externalAccountId adalah ID akun Google Ads. Layanan ini juga dapat diusulkan ke akun yang ada.

Perbandingan belanja: Layanan ini mewakili hubungan dengan Layanan Perbandingan Belanja (CSS) yang mengoperasikan akun Merchant Center.
Pengelolaan listingan lokal: Layanan ini mewakili 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. Jika digunakan selama pembuatan akun, layanan ini akan membuat akun yang ditautkan ke penyedia, yang merupakan pendekatan yang direkomendasikan untuk platform e-commerce dan partner saluran. Layanan ini juga dapat diusulkan ke akun yang ada.
Pengelolaan produk: Layanan ini memungkinkan penyedia mengelola produk dan fitur terkait seperti sumber data dan aturan. Jika ditambahkan selama pembuatan akun, biasanya dikombinasikan dengan accountManagement atau accountAggregation. Layanan ini juga dapat diusulkan ke akun yang ada.

Bersalaman

Untuk membuat layanan, akun yang menyediakan layanan dan akun yang menerima layanan harus mengotorisasi koneksi. Proses otorisasi ini disebut bersalaman.

Bersalaman adalah proses dua langkah:

Satu pihak mengusulkan link layanan.
Pihak lain menyetujui atau menolak proposal.

Setelah proposal diterima, layanan akan disetujui dan dianggap sepenuhnya dibuat. 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 proposal, menolak, atau menyetujuinya harus memiliki ADMIN hak akses di akun yang memulai proses. Jadi, jika penyedia layanan mengusulkan layanan, pengguna yang membuat proposal harus menjadi ADMIN di akun penyedia layanan dan pengguna yang menerima atau menolak proposal harus menjadi ADMIN di akun penerima.

Perilaku bersalaman khusus layanan

Berikut adalah deskripsi persyaratan bersalaman khusus untuk setiap layanan:

Agregasi akun: Layanan ini hanya dapat dibuat sebagai bagian dari pembuatan akun. Penyedia layanan diharapkan menjadi akun lanjutan, dan layanan akan otomatis disetujui karena pengguna akun lanjutan memiliki akses ADMIN penuh ke akun yang dibuat.
Perbandingan belanja: Layanan ini otomatis disetujui saat ditambahkan selama pembuatan akun menggunakan createAndConfigure.
Pengelolaan kampanye: Meskipun mengikuti proses bersalaman normal, proposal dibuat dalam 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, bersalaman diusulkan dalam metode khusus dan persetujuan dilakukan di sistem lain (misalnya Google Profil Bisnis). Lihat langkah mendetailnya di Panduan untuk menautkan Google Profil Bisnis.
Pengelolaan akun: Untuk layanan ini, proses bersalaman reguler berlaku saat menggunakan propose. Jika layanan ditambahkan selama pembuatan akun menggunakan createAndConfigure, layanan akan otomatis disetujui.
Pengelolaan produk: Untuk layanan ini, proses bersalaman 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 memungkinkan akun Google Ads terkait mengakses produk dan informasi akun dasar.
Perbandingan belanja: Layanan ini memberikan hak ADMIN penuh secara default. Namun, bisnis dapat membatasi akses yang diberikan di Merchant Center.
Pengelolaan listingan lokal: Layanan ini tidak memberikan hak akses langsung. Sebagai gantinya, layanan ini memungkinkan listingan menyinkronkan produknya dengan akun Merchant Center.

Penting: Hak akses yang dijelaskan untuk jenis layanan berikut berlaku hanya 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 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 memberikan hak ADMIN penuh secara default.
Pengelolaan produk: Layanan ini memberikan hak ADMIN penuh. Perhatikan bahwa di masa mendatang, layanan ini hanya akan dibatasi untuk 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 cara konsep yang berbeda dipetakan ke struktur akun Anda:

Penyedia layanan: Akun lanjutan Anda.
Akun yang menerima layanan: Akun Merchant Center yang mewakili bisnis yang Anda kelola.
Layanan:
- accountManagement: Layanan ini direkomendasikan untuk platform e-commerce dan partner saluran yang membuat akun baru atas nama penjual. Layanan ini membuat akun yang dimiliki penjual, yang ditautkan kepada Anda untuk pengelolaan. Hal ini selaras dengan struktur Merchant Center yang disukai untuk kasus penggunaan ini.
- accountAggregation: Layanan ini menautkan akun lanjutan Anda ke akun lain. Meskipun didukung, layanan ini tidak direkomendasikan untuk platform e-commerce dan partner saluran.

Untuk mengetahui detail tentang cara menyiapkan akun lanjutan dan menautkan ke akun Merchant Center baru, lihat Membuat akun.

Sebelumnya

Create accounts

Berikutnya

Control access to your account