Untuk memastikan keamanan data, menerapkan kontrol akses, dan menjaga integritas sistem, Anda harus mengautentikasi semua permintaan Merchant API. API menggunakan identitas yang diautentikasi untuk menentukan tindakan yang diizinkan untuk dilakukan oleh pemanggil. Misalnya, beberapa pemanggil mungkin memiliki akses hanya baca ke data produk, sementara yang lain dapat mengubah setelan akun di Merchant Center.
Dokumen ini adalah bagian dari rangkaian multi-bagian tentang cara mulai menggunakan Merchant API. Jika Anda sudah menyiapkan autentikasi dengan Merchant API, Anda dapat langsung melanjutkan ke bagian berikutnya: Mendaftar sebagai developer
Mengizinkan permintaan ke Merchant API
Setiap permintaan yang dikirim ke Merchant API harus menyertakan token otorisasi untuk mengidentifikasi aplikasi Anda ke Google. Untuk menyiapkan autentikasi dan otorisasi, tentukan kasus penggunaan yang paling sesuai dengan cara Anda berencana menggunakan Merchant API:
Apakah Anda sedang membangun aplikasi untuk digunakan oleh bisnis lain?
Jika ya, Anda menggunakan otorisasi OAuth 2.0. Pilih otorisasi OAuth 2.0 jika:
- Anda adalah penyedia atau agensi pihak ketiga: Anda sedang membangun aplikasi, seperti platform SaaS, yang akan digunakan oleh bisnis lain untuk mengelola data Merchant Center mereka sendiri.
- Anda perlu mengelola banyak akun eksternal: Anda ingin satu aplikasi berfungsi di beberapa akun Merchant Center independen yang dimiliki oleh klien yang berbeda. Klien Anda memberikan izin dengan login ke Akun Google mereka sendiri dan mengklik "Izinkan" di layar izin.
Apakah Anda membuat aplikasi untuk bisnis Anda sendiri?
Jika ya, Anda menggunakan otorisasi akun layanan untuk mendapatkan akses Merchant API. Pilih otorisasi akun layanan jika:
- Anda membangun aplikasi internal sendiri: Anda mengembangkan alat khusus untuk bisnis Anda sendiri guna mengelola data Merchant Center Anda sendiri , atau Anda ingin kredensial menjadi milik aplikasi itu sendiri, bukan pengguna individu tertentu.
- Anda memerlukan otomatisasi tanpa login manusia: Aplikasi Anda menjalankan tugas latar belakang seperti update inventaris otomatis atau tugas "cron".
Otorisasi OAuth 2.0
Jika Anda adalah penyedia atau agensi pihak ketiga yang mengelola beberapa akun klien, aplikasi Anda harus menggunakan OAuth 2.0 untuk mengizinkan permintaan. Ikuti langkah-langkah berikut untuk menyiapkan OAuth 2.0 untuk Merchant API:
- Buat kredensial OAuth 2.0 di APIs and Services di Konsol Google Cloud Anda
- Download kredensial klien OAuth2 ke file seperti
client-secrets.json - Tambahkan akun email sebagai pengguna ke Merchant Center: Pastikan Akun Google yang Anda gunakan untuk mengizinkan permintaan ada sebagai pengguna di Merchant Center. Lihat Cara menambahkan atau menghapus pengguna dari Merchant Center untuk mengetahui detail selengkapnya
- Tetapkan peran
Adminuntuk melakukan pendaftaran. Untuk mengetahui informasi selengkapnya tentang peran, lihat Mengelola pengguna dan tingkat akses di Merchant Center - Menyiapkan autentikasi dengan contoh kode: Ikuti panduan dari contoh kode resmi di bagian dokumentasi Menyiapkan Autentikasi dan Contoh Konfigurasi
Untuk mengetahui informasi selengkapnya tentang otorisasi OAuth 2.0, lihat Mengizinkan akses aplikasi pihak ketiga ke akun Merchant Center dan Menggunakan OAuth 2.0 untuk Mengakses Google API.
Otorisasi akun layanan
Anda menggunakan akun layanan untuk mengizinkan akses Merchant API ke akun Merchant Center Anda sendiri. Ikuti langkah-langkah berikut untuk menyiapkan otorisasi akun layanan untuk Merchant API:
- Buat kredensial akun layanan di APIs and Services di Konsol Google Cloud Anda
- Download kunci pribadi: Buat dan download kunci pribadi dalam format JSON untuk akun layanan. Ganti nama file menjadi
service-account.json - Tambahkan akun layanan ke Merchant Center: Salin alamat email akun layanan unik seperti
sa@project.iam.gserviceaccount.comdan tambahkan sebagai pengguna baru di Merchant Center Anda. Lihat Cara menambahkan atau menghapus pengguna dari Merchant Center untuk mengetahui detail selengkapnya - Tetapkan akses
Adminke akun tersebut. Untuk mengetahui informasi selengkapnya tentang tingkat akses, lihat Mengelola orang dan tingkat akses di Merchant Center - Menyiapkan autentikasi dengan contoh kode: Ikuti panduan dari contoh kode resmi di bagian dokumentasi Menyiapkan Autentikasi dan Contoh Konfigurasi
Untuk mengetahui informasi selengkapnya tentang otorisasi akun layanan, lihat Memberikan otorisasi akses ke akun Merchant Center Anda dan Ringkasan akun layanan.