Akun layanan adalah jenis akun khusus, yang biasanya digunakan oleh aplikasi, bukan orang. Akun layanan diidentifikasi oleh alamat emailnya,
yang bersifat unik untuk akun tersebut.
Anda harus memiliki
akun Merchant Center sebelum
dapat menyelesaikan langkah-langkah ini.
Membuat akun layanan
Buat kredensial akun layanan, atau akses kredensial publik yang telah Anda
buat, lalu buat Client ID OAuth 2.0:
Pilih project di menu drop-down di bagian atas halaman, atau klik PROJECT BARU untuk membuatnya.
Telusuri Merchant API dalam daftar Google API, dan pastikan API tersebut
diaktifkan untuk project ini.
Klik Manage.
Di sidebar sebelah kiri, pilih Kredensial. Anda mungkin perlu mengklik
panah yang mengarah ke kiri di kiri atas halaman untuk melihat Kredensial.
Pilih BUAT KREDENSIAL, lalu Akun layanan.
Beri nama akun layanan. Ini adalah nama pengguna default untuk ID akun
layanan. Simpan ID akun layanan, termasuk bagian setelah karakter '@', untuk digunakan nanti.
Klik BUAT, ikuti langkah-langkah opsional untuk memberikan akses ke project dan pengguna, lalu klik SELESAI.
Mendapatkan kunci pribadi JSON
Buat kunci pribadi JSON untuk akun layanan Anda di
Konsol API Google:
Klik akun layanan, lalu pilih tab KEYS.
Klik ADD KEY > Create new key.
Pilih JSON sebagai jenis kunci.
Klik CREATE untuk mendownload kunci pribadi. Catatan: Anda hanya dapat mendownload
kunci pribadi saat kunci tersebut dibuat. Anda tidak dapat kembali ke langkah ini nanti.
Memberi akun layanan akses ke akun Merchant Center Anda
Tambahkan akun layanan baru sebagai pengguna ke akun Merchant Center Anda:
Klik Tambahkan orang, lalu masukkan ID akun layanan Anda sebagai alamat email untuk orang baru.
Jika Anda tidak menyimpan project ID akun layanan, buka halaman administrasi Service Accounts, lalu pilih project Anda.
Tentukan preferensi Akses pengguna
dan Notifikasi email untuk akun layanan.
Klik Tambahkan pengguna untuk menyimpan dan kembali ke daftar pengguna.
ID akun layanan kini akan tercantum dengan peran pengguna yang dipilih.
Anda dapat mengulangi langkah-langkah ini untuk semua akun layanan yang perlu mengakses data akun Merchant Center Anda.
Pertanyaan umum (FAQ)
Dapatkah saya login ke UI Merchant Center dengan akun layanan saya?
Tidak, akun layanan bukan Akun Google biasa dan tidak dapat mengakses
UI Merchant Center.
Seberapa sering saya perlu memperbarui token akses akun layanan?
Masa berlaku token akses akan berakhir satu jam setelah dikeluarkan oleh Server Otorisasi
OAuth 2.0 Google. Saat masa berlaku token akses berakhir, aplikasi harus
menggunakan library klien untuk mengambil token akses lain. Untuk memuat ulang token secara manual, hapus file stored-token.json dan lakukan autentikasi ulang.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\u003cp\u003eUse a service account to grant an application access to your own Merchant Center account.\u003c/p\u003e\n"],["\u003cp\u003eService accounts are identified by unique email addresses and require a JSON private key for authentication.\u003c/p\u003e\n"],["\u003cp\u003eTo use a service account, you need to create it in the Google API Console, grant it access to your Merchant Center account, and download its private key.\u003c/p\u003e\n"],["\u003cp\u003eThird-party applications should use OAuth for client account access instead of service accounts.\u003c/p\u003e\n"],["\u003cp\u003eService accounts cannot be used to sign in to the Merchant Center UI.\u003c/p\u003e\n"]]],[],null,["# Authorize access to your Merchant Center account\n\nYou can use a\n[service account](//cloud.google.com/iam/docs/service-account-overview) to\nauthorize Merchant API access to your own Merchant Center account. See\n[authorize third-party app access to Merchant Center accounts](/merchant/api/guides/authorization/access-client-accounts)\nif your app needs to access your clients' Merchant Center accounts.\n\nA service account is a special kind of account, typically used by an application\nrather than a person. A service account is identified by its email address,\nwhich is unique to the account.\n\nYou must have a\n[Merchant Center account](//support.google.com/merchants/answer/188924) before\nyou can complete these steps.\n\nCreate a service account\n------------------------\n\nGenerate service account credentials, or access the public credentials you've\nalready generated, then create an OAuth 2.0 Client ID:\n\n1. Go to the [Google API Console](//console.cloud.google.com/apis/library).\n2. Select a project in the drop-down menu at the top of the page, or click **NEW PROJECT** to create one.\n3. Search for Merchant API in the list of Google APIs, and make sure it's enabled for this project.\n4. Click **Manage**.\n5. In the sidebar on the left, select **Credentials** . You might need to click the left-pointing arrow at the top left of the page to see **Credentials**.\n6. Select **CREATE CREDENTIALS** , then **Service account**.\n7. Name the service account. This is the default username for the service account ID. Save the service account ID, including the part after the '@' character, for later use.\n8. Click **CREATE** , go through the optional steps to grant access to the\n project and users, then click **DONE**.\n\n | **Note:** The role you choose the service account doesn't affect Merchant API access. Access to Merchant API methods is determined by the role associated with the service account ID in Merchant Center. If you don't know what to pick, choose **Project \\\u003e Viewer**.\n\nGet a JSON private key\n----------------------\n\nGenerate a JSON private key for your service account in the in the\n[Google API Console](//console.cloud.google.com/apis/library):\n\n1. Click the service account, then select the **KEYS** tab.\n2. Click **ADD KEY \\\u003e Create new key**.\n3. Select **JSON** as the key type.\n4. Click **CREATE** to download the private key. Note: You can only download the private key when it's created. You can't come back to this step later.\n\nGive the service account access to your Merchant Center account\n---------------------------------------------------------------\n\nAdd the new service account as a user to your Merchant Center account:\n\n1. Sign in to [Merchant Center](//merchants.google.com).\n2. Click the **Settings \\& tools** icon settings.\n3. In the drop-down, click **People and access**.\n4. Click **Add person**, and enter your service account ID as the email address\n for the new person.\n\n If you didn't save your service account ID, go to the\n [Service Accounts](//console.developers.google.com/iam-admin/serviceaccounts/)\n administration page, and select your project.\n5. Specify the [**User access**](//support.google.com/merchants/answer/1637190)\n and **Email notifications** preferences for the service account.\n\n | **Note:** Services accounts need **Admin** access to manage Merchant Center account information and settings.\n6. Click **Add user** to save and return to the list of users.\n The service account ID should now be listed with the chosen user role.\n\nYou can repeat these steps for all service accounts that need to access your\nMerchant Center account data.\n| **Note:** If you're a third-party provider and don't have direct access to the Merchant Center account, ask your client to add the service account as a user in Merchant Center and tell them the service account ID. We recommend [oAuth](/merchant/api/guides/authorization/access-client-accounts) instead of service accounts for third-party access.\n\nFrequently asked questions\n--------------------------\n\nCan I sign in to the Merchant Center UI with my service account?\n: No, service accounts aren't regular Google Accounts and can't access the\n Merchant Center UI.\n\nHow often do I need to refresh service account access tokens?\n: Access tokens expire one hour after they're issued by the Google OAuth 2.0\n Authorization Server. When an access token expires, the application should\n use the client library to fetch another access token. To manually refresh\n your token, delete the `stored-token.json` file and re-authenticate."]]
