Pertanyaan Umum (FAQ)

Bagian ini membahas 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 update 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 bekerja dengan beberapa akun penjual atau tidak, Anda hanya perlu 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 yang dimiliki Google seperti API Explorer atau OAuth Playground.

Alamat email apa yang harus saya berikan sebagai kontak developer?

Sebaiknya gunakan alamat email perusahaan milik 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 dikirimkan 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 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

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 memberi 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 di bawah konteks keamanan identitas 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 resource DeveloperRegistration sebagai respons.

Apa perbedaan antara email autentikasi dan email kontak developer?

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

• Email autentikasi: Anda biasanya menggunakan email yang terkait dengan Akun Google Anda atau dengan akun layanan sebagai identitas untuk mengotorisasi permintaan ke Merchant API dengan ketentuan:
  • Email 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 mengotorisasi 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. Email ini dapat dimiliki oleh pengguna atau grup pengguna. Secara default, email ini akan 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 akan selesai setelah penerima menerima undangan. Namun, Anda dapat melakukan panggilan API selama waktu ini.

Jika undangan tidak diterima dalam waktu yang ditentukan, link undangan akan berakhir masa berlakunya. Anda tidak dapat melakukan panggilan Merchant API lagi 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 Anda 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 lanjutan yang sudah ada: Jika bisnis Anda beroperasi sebagai marketplace dan sudah memiliki akun lanjutan 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.
• 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 didaftarkan ke akun Merchant Center utama Anda, 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 setiap project?

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 satu akun Merchant Center dalam satu waktu. Namun, satu akun Merchant Center dapat memiliki beberapa project Google Cloud yang terdaftar di dalamnya. 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 OAuth 2.0 kredensial klien yang dibuat dalam Project Google Cloud Anda. Panggilan API diotorisasi 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 autentikasi (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 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 Anda 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 untuk mendapatkan dan memperbarui Token Akses untuk Anda sebagai bagian dari konfigurasinya.

Pengguna autentikasi 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 akan berakhir masa berlakunya setelah 1 jam. Namun, mekanisme untuk mendapatkan token baru bergantung pada metode autentikasi yang Anda gunakan:

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

Sebaiknya gunakan Google Auth Libraries resmi yang menangani rotasi ini secara otomatis sehingga aplikasi Anda tidak pernah mengalami waktu 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 tersebut 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 akan mendapatkan peran API_DEVELOPER secara default yang diperlukan untuk menerima notifikasi penting. Namun, pengguna ini memiliki izin minimal dalam Merchant Center. Untuk mengizinkan pengguna ini melakukan panggilan API lainnya atau mengelola setelan di UI Merchant Center, Anda harus 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 "Developer API"?

Peran API Developer adalah peran dengan hak minimal di Merchant Center. Jika Anda berencana menggunakan email kontak developer untuk mengotorisasi 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 terikat dengan project Google Cloud yang digunakan untuk melakukan panggilan API, bukan dengan pengguna atau akun layanan individual. 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 ditautkan menggunakan kredensial OAuth atau akun layanan untuk mengotorisasi 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 diaktifkan 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 akan muncul error AUTH_GCP_NOT_REGISTERED hingga kontak developer yang valid dipulihkan.

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

Jangan hapus akun Merchant Center yang digunakan untuk pendaftaran developer saat integrasi Anda aktif. Menghapus akun ini akan langsung menghentikan 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 terlebih dahulu memanggil metode unregisterGcp untuk menghapus link 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 Merchant Center saat ini. Lalu, lanjutkan dengan menghapus ID Merchant Center.

Kasus Penggunaan Khusus

Pertanyaan umum tentang kasus penggunaan khusus:

Saya adalah agensi atau developer pihak ketiga yang mengelola beberapa akun penjual. Apa cara terbaik untuk menyiapkan hal ini?

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 daftarkan project Google Cloud Anda dengan akun setiap penjual.

Bagaimana cara kerja pendaftaran untuk Google App Script?

App Script 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. getAccountForGcpRegistration Untuk menghapus link project Google Cloud ke akun Merchant Center Anda, gunakan metode unregisterGcp.