Untuk menggunakan Merchant API secara efektif, Anda harus memahami konsep pendaftaran, autentikasi, dan otorisasi. Ketiga konsep ini memiliki tujuan yang berbeda dalam memastikan akses yang aman dan benar ke data Merchant Center.
Terminologi
Pendaftaran, autentikasi, dan otorisasi saling terkait, tetapi masing-masing memiliki arti dan tujuan yang berbeda.
- Autentikasi: Dalam proses ini, layanan memverifikasi identitas pengguna atau aplikasi yang membuat permintaan API. Merchant API menggunakan mekanisme Google standar seperti OAuth 2.0. Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi permintaan dan Mengautentikasi sebagai akun Anda sendiri.
- Otorisasi: Proses ini menentukan tindakan apa yang diizinkan untuk dilakukan oleh pengguna atau aplikasi yang diautentikasi menggunakan akun Merchant Center. Otorisasi menjawab pertanyaan: "Apa yang dapat Anda lakukan?" berdasarkan peran dan izin yang diberikan kepada pengguna yang diautentikasi dalam akun Merchant Center. Misalnya, pengguna mungkin diizinkan untuk membaca data produk, tetapi tidak diizinkan untuk mengubah setelan akun.
- Pendaftaran: Terkait dengan Merchant API, ini adalah proses penyiapan satu kali yang memungkinkan Google mengirimkan pengumuman layanan penting untuk akun penjual yang Anda kelola. Pendaftaran menambahkan alamat email developer Anda ke akun Merchant Center utama dan menautkannya ke ID Project Google Cloud yang Anda gunakan untuk autentikasi. Penautan ini memungkinkan aplikasi Anda menerima pengumuman layanan untuk semua akun penjual yang Anda kelola. Untuk mengetahui informasi selengkapnya, lihat Membuat Project Google Cloud.
Pendaftaran
Proses pendaftaran sangat penting untuk memungkinkan aplikasi Anda menggunakan Merchant API. Berikut ini hal yang perlu Anda ketahui:
Prasyarat
Untuk mendaftar menggunakan Merchant API, Anda memerlukan hal berikut:
- Akun Merchant Center: Anda memerlukan akun Merchant Center yang ada.
- Akses Admin: Akun pengguna Google yang Anda gunakan untuk memulai panggilan pendaftaran harus memiliki hak istimewa Admin di akun Merchant Center yang Anda daftarkan.
- Project Google Cloud: Aplikasi Anda harus dikaitkan dengan Project Google Cloud. Project ini menyediakan kredensial yang diperlukan (seperti Client ID OAuth 2.0) agar aplikasi Anda dapat diautentikasi.
Alasan Anda tidak dapat mendaftarkan project Google Cloud bersama
Alat seperti Google OAuth Playground dan APIs Explorer menggunakan project Google Cloud bersama yang dimiliki Google. Anda tidak dapat mendaftar dengan project bersama karena:
- Project tersebut dimaksudkan untuk pengujian dan eksplorasi, bukan untuk identitas aplikasi produksi.
- Mendaftarkannya akan menyiratkan link antara alat bersama dan data Merchant Center spesifik Anda serta dapat mengakibatkan komunikasi yang tidak diinginkan.
Aplikasi Anda memerlukan project Google Cloud khusus sehingga komunikasi Merchant API yang dikirimkan Google kepada Anda tetap relevan untuk penggunaan sebenarnya.
Namun, Anda dapat menggunakan aplikasi web OAuth Playground dan API Explorer untuk menggunakan Merchant API bagi kasus penggunaan eksperimen dan non-produksi.
Menemukan ID Project Google Cloud Anda
Anda dapat menemukan Project ID dan Project Number di Konsol Google Cloud. Untuk mengetahui detailnya, lihat Menemukan nama, nomor, dan ID project.
Melakukan panggilan pendaftaran
Daftar menggunakan
registerGcp
metode dalam Accounts sub-API. Panggilan ini mengaitkan Project Number Google Cloud Anda dengan akun Merchant Center.
Selama proses ini, Anda harus memberikan alamat email yang terkait dengan pengguna perorangan yang Anda gunakan untuk memanggil API. Email ini harus milik pengguna yang memiliki akses Admin ke akun Merchant Center.
Tentang kolom email
Komunikasi yang efektif adalah kunci. Google mengirimkan info terbaru penting, Pengumuman Layanan Wajib (MSA), survei developer, dan peluang lainnya terkait Merchant API. Pengelolaan kontak yang tepat memastikan bahwa informasi ini menjangkau orang yang tepat.
- Tujuan: Google menggunakan alamat email ini sebagai kontak utama untuk komunikasi terkait API.
- Email siapa: Ini harus berupa alamat email developer perorangan atau kontak teknis utama yang bertanggung jawab atas integrasi API.
- Praktik Terbaik:
- LAKUKAN: Gunakan alamat email perusahaan perorangan.
- JANGAN: Gunakan alias grup umum atau email akun layanan. Kami mengirimkan komunikasi untuk penerima manusia.
Resource users untuk pengelolaan kontak
Meskipun alamat email dalam panggilan pendaftaran menetapkan kontak awal, cara yang
lebih efektif untuk mengelola kontak dan izin adalah menggunakan resource
accounts.users
Merchant API atau setelan pengelolaan pengguna di UI Merchant Center. Untuk mengetahui informasi selengkapnya tentang penggunaan Merchant Center, lihat
Mengelola orang di akun Anda.
Manfaatkan fitur ini sebagai berikut:
- Tambahkan semua developer: Tambahkan developer yang mengerjakan integrasi API sebagai pengguna akun Merchant Center.
- Tetapkan peran
API_DEVELOPER: Selain peran standar (Admin, Standar), Anda dapat menetapkan peranAPI_DEVELOPERkepada pengguna. Secara khusus, tetapkan peran ini kepada pengguna yang harus menerima komunikasi terkait API. Anda dapat menggabungkannya dengan peran lain. - Manfaat:
- Pemisahan yang jelas: Memisahkan pengelolaan kontak API dari pendaftaran satu kali.
- Fleksibilitas: Perbarui kontak saat anggota tim berubah.
- Komunikasi yang ditargetkan: Memastikan berita khusus API menjangkau orang yang relevan.
Meskipun Anda memberikan alamat email selama pendaftaran, sebaiknya kelola kontak API dengan menambahkan pengguna yang memiliki peran API_DEVELOPER.
Referensi
Untuk mengetahui informasi selengkapnya, lihat referensi berikut: