Pertanyaan Umum (FAQ)

Bagian ini menjawab pertanyaan umum terkait Pendaftaran Developer untuk Merchant API.

Pendaftaran Umum

Pertanyaan umum tentang proses pendaftaran:

Apakah pendaftaran developer wajib dilakukan untuk menggunakan Merchant API?

Ya. Anda harus mendaftarkan informasi kontak developer agar Google dapat mengirimkan pembaruan penting khusus API, seperti pengumuman layanan dan informasi fitur baru.

Jika hanya ingin menjelajahi dan menguji Merchant API, Anda dapat menggunakan alat seperti Google OAuth Playground dan API Explorer yang tidak memerlukan pendaftaran.

Seberapa sering saya harus mendaftar?

Pendaftaran adalah penyiapan satu kali untuk setiap project Google Cloud. Baik Anda menggunakan beberapa akun penjual atau tidak, Anda hanya melakukan operasi pendaftaran satu kali, dan operasi ini berlaku untuk semua pengguna dan akun layanan dalam project Google Cloud yang ditautkan.

Setelah project Google Cloud berhasil didaftarkan, link akan tetap aktif kecuali jika dihapus secara eksplisit dengan memanggil metode unregisterGcp. Anda tidak dapat mendaftarkan project bersama milik Google seperti APIs Explorer atau OAuth Playground.

Alamat email apa yang harus saya berikan sebagai kontak developer?

Sebaiknya gunakan alamat email perusahaan individu. Atau, Anda dapat menggunakan alias grup umum. Anda tidak dapat menggunakan email akun layanan, karena komunikasi ditujukan untuk penerima manusia. Google mengirimkan update penting khusus API, seperti pengumuman layanan dan informasi fitur baru.

Jika alamat email tersebut milik pengguna yang sudah ada di akun Merchant Center, pengguna tersebut akan otomatis diberi peran API_DEVELOPER. Jika tidak, undangan akan dikirim ke alamat tersebut.

Kolom alamat email kontak developer bersifat opsional dalam metode registerGcp. Jika saat mendaftar Anda tidak memberikan nilai untuk kolom ini, Anda harus membuat pengguna yang memiliki peran API_DEVELOPER di UI Merchant Center, atau dengan memanggil metode accounts.users.create.

Apakah email kontak developer harus berupa Akun Google?

Ya. Untuk menggunakan email non-Google yang sudah ada, Anda dapat mengaitkannya dengan Akun Google dengan memilih opsi Gunakan email Anda yang sudah ada dalam proses pendaftaran Buat Akun Google. Anda tidak dapat menggunakan email akun layanan karena akun layanan tidak dapat menerima email.

Bagaimana cara melakukan autentikasi dan otorisasi untuk panggilan pendaftaran?

Dua skenario autentikasi yang berbeda tersedia untuk autentikasi dan otorisasi panggilan pendaftaran, bergantung pada kasus penggunaan Anda:

  • OAuth 2.0: untuk penyedia atau agensi pihak ketiga yang mengelola beberapa akun penjual
  • Akun Layanan: untuk akses ke akun Merchant Center Anda sendiri

Teks alternatif untuk aksesibilitas

Diagram sebelumnya menunjukkan dua alur autentikasi dan otorisasi untuk panggilan pendaftaran. Anda dapat memilih antara:

  • Menggunakan OAuth dengan alamat email seperti account@email.com yang terkait dengan Akun Google
  • Menggunakan akun layanan seperti sa@project.iam.gserviceaccount.com

Jika Anda memutuskan untuk menggunakan OAuth:

  • Buat kredensial OAuth di project Google Cloud Anda untuk email Anda
  • Pastikan alamat email yang diberi otorisasi ada di Merchant Center Anda dan memiliki jenis akses ADMIN

Jika Anda memutuskan untuk menggunakan akun layanan:

  • Pastikan akun layanan ada di project Google Cloud Anda
  • Pastikan alamat email yang terkait dengan akun layanan ada di Merchant Center Anda dan memiliki jenis akses ADMIN

Lakukan panggilan pendaftaran dalam konteks keamanan identitas yang melakukan autentikasi, menggunakan panggilan API langsung atau library klien. Berikan alamat email untuk kontak developer, misalnya developer@email.com.

Jika panggilan pendaftaran berhasil, pengguna akan ada di Merchant Center Anda dengan alamat email developer yang diberikan dan peran API_DEVELOPER. Anda akan mendapatkan respons berupa resource DeveloperRegistration.

Apa perbedaan antara email autentikasi dan email kontak developer?

Kedua alamat email tersebut memiliki tujuan yang berbeda dalam ekosistem Merchant API:

  • Mengautentikasi email: Anda biasanya menggunakan email yang terkait dengan Akun Google Anda atau dengan akun layanan sebagai identitas untuk mengizinkan permintaan ke Merchant API asalkan:
    • Pengguna tersebut ada di Merchant Center Anda, dan memiliki peran ADMIN.
    • Project Google Cloud yang mengaktifkan Merchant API menghosting klien OAuth atau akun layanan yang terkait dengan email yang mengizinkan panggilan API.
  • Email kontak developer: Email kontak developer juga harus dikaitkan dengan Akun Google, tetapi berfungsi sebagai kontak utama untuk pengumuman layanan penting dan update API dari Google. Objek ini dapat dimiliki oleh pengguna atau grup pengguna. Secara default, akun tersebut mendapatkan peran API developer di Merchant Center.

Apakah saya harus menerima undangan yang diterima oleh email kontak developer?

Ya. Penerima email kontak developer yang Anda berikan memiliki waktu 14 hari untuk menerima undangan. Pendaftaran hanya selesai setelah mereka menerima undangan. Namun, Anda dapat melakukan panggilan API selama waktu ini.

Jika undangan tidak diterima dalam waktu yang ditentukan, link undangan akan berakhir. Anda tidak dapat lagi melakukan panggilan Merchant API dan harus memulai ulang proses pendaftaran.

Pengelolaan Akun dan Project

Pertanyaan umum tentang pengelolaan akun dan project:

Saya bekerja dengan beberapa akun Merchant Center. Apakah saya perlu mendaftarkan setiap Akun Merchant Center yang ingin saya gunakan dengan Merchant API?

Tidak. Jika Anda adalah developer pihak ketiga atau agensi yang mengelola beberapa akun penjual, Anda mendaftarkan project Google Cloud dengan akun Merchant Center utama Anda sendiri, bukan dengan setiap akun penjual Anda. Dengan cara ini, Anda mewakili developer untuk semua pekerjaan API yang Anda lakukan untuk penjual Anda.

Saya bekerja dengan beberapa akun Merchant Center. Bagaimana cara memilih Akun Merchant Center utama saya?

Memilih akun utama yang akan digunakan bergantung pada jenis bisnis Anda:

  • Marketplace dengan akun tingkat lanjut yang sudah ada: Jika bisnis Anda beroperasi sebagai marketplace dan sudah memiliki akun tingkat lanjut yang mewakili seluruh platform, gunakan ID akun yang sudah ada ini sebagai Akun Merchant Center utama.
  • Layanan Perbandingan Belanja (CSS): Jika Anda adalah CSS, gunakan ID akun CSS unik atau ID akun grup CSS Anda.
  • Agensi, Developer, dan Pihak Ketiga lainnya: Jika Anda adalah bisnis pihak ketiga seperti agensi atau developer pihak ketiga yang mengelola beberapa akun penjual dan tidak memiliki satu ID Merchant Center yang mewakili bisnis Anda, Anda harus membuat Akun Merchant Center utama yang baru dan meminta untuk mengonversinya menjadi akun lanjutan.

Setelah project Google Cloud Anda terdaftar ke akun Merchant Center utama, Anda dapat menggunakan project yang sama untuk mengelola akun Merchant Center lain yang dapat Anda akses, tanpa perlu mendaftarkan akun tersebut satu per satu.

Saya menggunakan beberapa project Google Cloud. Apakah saya perlu mendaftarkan masing-masing?

Ya. Karena proses pendaftaran menautkan project Google Cloud yang memanggil, Anda harus melakukan panggilan registerGcp dari setiap project Google Cloud yang Anda gunakan untuk melakukan panggilan API.

Satu project Google Cloud hanya dapat didaftarkan ke tepat satu akun Merchant Center dalam satu waktu. Namun, satu akun Merchant Center dapat mendaftarkan beberapa project Google Cloud. Demikian pula, Anda dapat menggunakan alamat email developer yang sama untuk melakukan beberapa pendaftaran, di beberapa project Google Cloud atau beberapa Merchant Center.

Apa yang terjadi jika saya mendaftarkan project Google Cloud dengan beberapa akun Merchant Center?

Mencoba mendaftarkan project Google Cloud yang sudah terdaftar dengan akun Merchant Center lain akan menghasilkan error ALREADY_REGISTERED.

Bagaimana cara mengautentikasi panggilan API pendaftaran developer?

Untuk mengautentikasi panggilan API pendaftaran developer untuk Merchant API, Anda menggunakan kredensial yang dikelola melalui Project Google Cloud. Anda memiliki dua opsi utama untuk identitas yang melakukan autentikasi:

  • Akun Google seperti Gmail menggunakan OAuth 2.0: Metode ini menggunakan kredensial klien OAuth 2.0 yang dibuat dalam Project Google Cloud Anda. Panggilan API diizinkan atas nama Akun Google tertentu yang digunakan pengguna untuk login.
  • Akun Layanan: Metode ini menggunakan Akun Layanan Google Cloud, yang merupakan jenis Akun Google khusus yang ditujukan untuk aplikasi. Kredensial untuk Akun Layanan juga dikelola dalam project Google Cloud Anda.

Agar pendaftaran developer berhasil, identitas yang mengautentikasi (Akun Google atau Akun Layanan) harus memenuhi kriteria berikut dalam Merchant Center:

  • Ada sebagai Pengguna di Merchant Center: Alamat email yang terkait dengan Akun Google yang melakukan autentikasi atau Akun Layanan harus ditambahkan sebagai pengguna di akun Merchant Center yang Anda daftarkan.
  • Peran Admin Diperlukan: Pengguna ini harus memiliki peran ADMIN yang ditetapkan kepadanya dalam akun Merchant Center tertentu tersebut.

Saat melakukan panggilan API:

  • Jika menggunakan Panggilan API langsung, Anda harus mendapatkan dan memberikan Token Akses yang valid di header Authorization. Token ini dibuat oleh alur OAuth 2.0 untuk Akun Google atau alur autentikasi server ke server untuk Akun Layanan.
  • Library klien yang disediakan oleh Google biasanya menangani kompleksitas mendapatkan dan memperbarui Token Akses untuk Anda sebagai bagian dari konfigurasinya.

Pengguna yang mengautentikasi mungkin tidak sama dengan pengguna kontak developer. Untuk mengetahui informasi selengkapnya, lihat Apa perbedaan antara email autentikasi dan email kontak developer?

Seberapa sering saya perlu memperbarui token akses?

Token akses untuk Akun Layanan dan OAuth 2.0 biasanya berakhir setelah 1 jam. Namun, mekanisme untuk mendapatkan yang baru bergantung pada metode autentikasi yang Anda gunakan:

  • Akun layanan menggunakan kunci pribadi atau kredensial lingkungan untuk membuat token akses baru jika diperlukan.
  • Alur OAuth 2.0 menggunakan refresh_token untuk memanggil endpoint token Google OAuth2 guna menerima token akses 1 jam yang baru.

Sebaiknya gunakan Library Auth Google resmi yang menangani rotasi ini secara otomatis sehingga aplikasi Anda tidak pernah mengalami periode nonaktif.

Pengguna dan Peran

Pertanyaan umum tentang pengguna dan peran:

Apakah akun email developer harus sudah ada di Merchant Center?

Tidak. Jika akun email pendaftaran belum ada di Merchant Center, Merchant API akan membuat akun di Merchant Center dengan email yang ditentukan dalam status Tertunda. Jika alamat email developer adalah milik pengguna yang sudah ada di akun Merchant Center, pengguna tersebut akan otomatis diberi peran API_DEVELOPER.

Apakah email kontak developer harus memiliki hak Admin di Merchant Center?

Tidak. Pengguna Merchant Center yang terkait dengan email kontak developer secara default mendapatkan peran API_DEVELOPER yang diperlukan untuk menerima notifikasi penting. Namun, ia memiliki izin minimal dalam Merchant Center. Untuk mengizinkan pengguna ini melakukan panggilan API lainnya atau mengelola setelan di UI Merchant Center, Anda perlu memberikan peran tambahan kepada pengguna tersebut, seperti STANDARD atau ADMIN. Untuk mengetahui informasi selengkapnya tentang peran Merchant Center, lihat Jenis akses.

Izin apa yang dimiliki peran "API Developer"?

Peran API Developer adalah peran dengan hak minimal di Merchant Center. Jika Anda berencana menggunakan email kontak developer untuk mengizinkan panggilan ke Merchant API, sebaiknya tambahkan izin ADMIN atau STANDARD agar pengguna dapat melakukan panggilan API.

Apakah saya perlu mendaftarkan setiap pengguna developer atau akun layanan yang memanggil API?

Tidak. Pendaftaran developer terkait dengan project Google Cloud yang digunakan untuk melakukan panggilan API, bukan untuk masing-masing pengguna atau akun layanan. Setelah project Google Cloud berhasil didaftarkan dengan akun Merchant Center utama Anda, Anda dapat menggunakan identitas apa pun yang dikelola melalui project Google Cloud yang tertaut menggunakan kredensial OAuth atau akun layanan untuk memberikan otorisasi panggilan Merchant API, asalkan identitas tersebut ada di Merchant Center Anda dan memiliki peran ADMIN yang ditetapkan.

Bagaimana cara mengubah email kontak developer setelah pendaftaran awal?

Untuk mengelola atau mengubah kontak, gunakan layanan accounts.users standar atau halaman "Akses dan layanan" di UI Merchant Center untuk menambahkan atau menghapus pengguna dengan peran API Developer.

Apa yang terjadi jika pengguna "Developer API" terakhir dihapus dari akun Merchant Center?

Masa tenggang 30 hari akan dimulai untuk menghindari gangguan layanan langsung. Selama waktu ini:

  • Admin akan menerima tiga pengumuman layanan wajib melalui email (biasanya sekitar 30, 17, dan 4 hari sebelum pemblokiran).
  • Panggilan API akan terus berfungsi secara normal.
  • Jika API Developer baru tidak ditambahkan sebelum masa tenggang berakhir, panggilan API dari project Google Cloud terkait akan diblokir dengan error AUTH_GCP_NOT_REGISTERED.

Saat masa tenggang 30 hari berakhir, panggilan API dari project Google Cloud terkait akan diblokir, dan project tersebut akan mendapatkan error AUTH_GCP_NOT_REGISTERED hingga kontak developer yang valid dipulihkan.

Apa yang terjadi jika ID Merchant Center tempat pendaftaran developer dilakukan dihapus?

Jangan menghapus akun Merchant Center yang digunakan untuk pendaftaran developer saat integrasi Anda aktif. Menghapus akun ini akan langsung merusak integrasi Anda, dan Anda tidak akan dapat lagi melakukan panggilan API dari project Google Cloud terkait.

Jika Anda harus menghapus akun Merchant Center tersebut, Anda harus memanggil metode unregisterGcp terlebih dahulu untuk menghapus tautan dengan aman, lalu baru melanjutkan dengan menghapus ID Merchant Center. Jika ingin terus menggunakan Merchant API, Anda harus mendaftar dengan ID Merchant Center lain segera setelah Anda membatalkan pendaftaran ID saat ini. Setelah itu, lanjutkan penghapusan ID Merchant Center.

Kasus Penggunaan Khusus

Pertanyaan umum tentang kasus penggunaan khusus:

Saya adalah agensi atau developer pihak ketiga yang mengelola beberapa akun penjual. Bagaimana cara terbaik untuk menyiapkannya?

Developer dan agensi pihak ketiga harus mempertahankan akun Merchant Center utama mereka sendiri dan mendaftarkan semua project Google Cloud mereka ke satu akun terpusat tersebut. Jangan mendaftarkan project Google Cloud Anda dengan akun masing-masing penjual.

Bagaimana cara kerja pendaftaran untuk Google App Script?

Skrip Aplikasi biasanya berjalan di project Google Cloud default. Anda harus mendaftarkan ID Google Cloud default ini dengan akun Merchant Center Anda. ID Google Cloud diperoleh secara otomatis oleh API, sehingga Anda tidak perlu memberikannya sebagai parameter.

Dapatkah saya memeriksa apakah ID Merchant Center terdaftar ke ID project Google Cloud tertentu?

Ya. Anda dapat memeriksa ID Merchant Center yang terdaftar ke project Google Cloud tertentu menggunakan metode getAccountForGcpRegistration. Untuk menghapus link project Google Cloud ke akun Merchant Center Anda, gunakan metode unregisterGcp.