rocket
Perkenalkan
Merchant API
- pengganti resmi Content API for Shopping.
add_alert
Catatan: Content API for Shopping akan dihentikan pada 18 Agustus 2026.
Akun layanan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Akun layanan adalah Akun Google khusus yang dapat digunakan oleh
aplikasi untuk mengakses Google API secara terprogram melalui OAuth 2.0. Akun layanan
menggunakan alur OAuth 2.0 yang tidak memerlukan otorisasi manusia.
Sebagai gantinya, kode ini menggunakan file kunci yang hanya dapat diakses oleh aplikasi Anda. Panduan ini membahas cara mengakses Content API for Shopping dengan akun layanan.
Catatan: Aplikasi yang menggunakan akun layanan
untuk autentikasi hanya dapat mengakses akun Merchant Center Anda sendiri. Jika Anda
menulis aplikasi pihak ketiga yang memerlukan akses ke akun Merchant
Center klien, lihat panduan Meminta Otorisasi.
Prasyarat
Langkah-langkah menggunakan akun layanan untuk mengakses Content API for Shopping
- Buat kredensial akun layanan atau akses kredensial publik
yang telah Anda buat. Anda perlu membuat Client ID OAuth 2.0 dan mendapatkan file kunci pribadi *.json:
- Buka Konsol Google API.
- Pilih project di menu drop-down di bagian atas halaman. Jika Anda belum memilikinya, buat dengan mengklik NEW PROJECT.
- Jika Anda belum mengaktifkan Content API for Shopping untuk
project ini, telusuri di daftar Google API dan aktifkan.
- Di sidebar sebelah kiri, pilih Kredensial.
Anda mungkin perlu mengklik panah yang mengarah ke kiri di kiri atas untuk melihatnya.
- Untuk menyiapkan akun layanan, pilih CREATE CREDENTIALS, lalu
Service account.
- Beri nama akun layanan baru. Nama ini juga berfungsi sebagai nama pengguna default untuk ID akun layanan. Catat ID akun layanan, termasuk bagian setelah
karakter '@', untuk digunakan nanti. Klik CREATE, lalu ikuti
langkah-langkah opsional untuk memberikan akses ke project dan pengguna, lalu klik DONE.
Pilihan peran untuk akun layanan tidak akan
memengaruhi panggilan yang dapat dilakukan ke Content API, karena akses ke
metode Content API ditentukan oleh peran yang terkait dengan
ID akun layanan di Merchant Center. Jika tidak yakin harus memilih yang mana, pilih Project > Viewer.
- Anda akan diarahkan ke halaman Akun Layanan tempat akun layanan baru
Anda dapat diakses.
- Untuk mendapatkan kunci pribadi JSON, klik akun layanan, lalu tab KEYS. Klik ADD KEY > Create new key, lalu pilih JSON sebagai jenis kunci. Klik CREATE untuk mendownload kunci pribadi ke
komputer Anda.
- Tambahkan akun layanan baru sebagai pengguna ke akun Merchant Center Anda. Jika Anda adalah developer
pihak ketiga, Anda harus meminta klien untuk melakukan langkah ini.
- Buka akun Merchant
Center Anda.
- Buka Akses Akun di setelan akun Merchant Center Anda.
- Klik + Tambahkan pengguna dan gunakan ID akun layanan sebagai alamat email untuk pengguna baru.
Jika Anda tidak mencatat
ID akun layanan sebelumnya, buka halaman administrasi Akun
Layanan dan pilih project yang Anda buat.
- Tentukan preferensi Akses pengguna dan Notifikasi email
untuk akun layanan. Perhatikan bahwa penggunaan
layanan
Accounts memerlukan akses Admin.
- Klik Tambahkan pengguna untuk menyimpan preferensi dan kembali ke daftar pengguna. ID akun layanan harus dicantumkan dengan peran pengguna yang dipilih.
- Ulangi prosesnya untuk semua akun layanan lain yang ingin Anda tambahkan.
- Sekarang Anda dapat mengakses akun Merchant Center menggunakan akun layanan
baik dengan menggunakan alur Kredensial Default
Aplikasi Google atau dengan menggunakan alur akun layanan
secara langsung. Contoh Content API for Shopping menunjukkan cara menggunakan kedua
alur untuk kredensial akun layanan di setiap bahasa pemrograman yang didukung.
Lihat contoh kode untuk mencoba akun layanan baru dan untuk mempelajari perubahan yang diperlukan untuk menggunakan akun layanan dalam kode Anda sendiri.
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 berakhir satu jam setelah dikeluarkan oleh Server Otorisasi
OAuth 2.0 Google. Ketika token akses berakhir, aplikasi harus menggunakan
library klien untuk mengambil token akses yang lain.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[[["\u003cp\u003eService accounts enable applications to programmatically access Google APIs, including the Content API for Shopping, using OAuth 2.0 without human intervention.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize service accounts, you need to generate service account credentials, add the service account as a user in your Merchant Center account, and then access your Merchant Center account using either the Google Application Default Credentials flow or the service account flow.\u003c/p\u003e\n"],["\u003cp\u003eApplications authenticated with service accounts can only access your own Merchant Center account; for third-party applications needing access to client accounts, refer to the Authorizing Requests guide.\u003c/p\u003e\n"],["\u003cp\u003eService accounts cannot be used to sign in to the Merchant Center UI and access tokens expire after one hour, requiring the application to fetch a new one using the client library.\u003c/p\u003e\n"]]],["Service accounts allow applications to access the Content API for Shopping programmatically. Key actions include: generating service account credentials by creating an OAuth 2.0 Client ID and a JSON private key file via the Google API Console, and adding the service account as a user within the Merchant Center account, specifying access and notification preferences. To access the Merchant center, you can use Google Application Default Credentials or a service account flow, with example code available. Access tokens expire hourly, requiring renewal.\n"],null,["# Service accounts are special Google accounts that can be used by\napplications to access Google APIs programmatically via OAuth 2.0. A service\naccount uses an OAuth 2.0 flow that does not require human authorization.\nInstead, it uses a key file that only your application can access. This guide\ndiscusses how to access the Content API for Shopping with service accounts.\n\n**Note:** Applications using service accounts\nfor authentication can only access your own Merchant Center account. If you are\nwriting a third-party application that needs access to your clients' Merchant\nCenter accounts, please see the [Authorizing Requests](/shopping-content/guides/how-tos/authorizing)\nguide instead.\n\nPrerequisites\n-------------\n\n- A [Merchant Center](//merchants.google.com/) account.\n\nSteps to using a service account to access the Content API for Shopping\n-----------------------------------------------------------------------\n\n1. Generate service account credentials or access the public credentials you've already generated. You will need to create an OAuth 2.0 Client ID and obtain a \\*.json private key file:\n 1. Go to the [Google API Console](https://console.cloud.google.com/apis/library).\n 2. Select a project in the drop-down menu at the top of the page. If you do not have one yet, create one by clicking **NEW PROJECT**.\n 3. If you have not already enabled the Content API for Shopping for this project, then search for it in the list of Google APIs and enable it.\n 4. In the sidebar on the left, select **Credentials**. You may need to click the left-pointing arrow at the top left to see this.\n 5. To set up a service account, select **CREATE CREDENTIALS** , and then **Service account** . \n 6. Name the new service account. This also serves as the default username for the service account ID. Record the service account ID, including the part after the '@' character, for later use. Click **CREATE** , then go through the optional steps of granting access to project and users, and click **DONE** .\n\n The choice of role for the service account will not\n have any effect on what calls can be made to the Content API, as access to\n Content API methods is determined instead by the role associated with the\n service account ID in Merchant Center. If you are unsure what to pick, just\n pick **Project \\\u003e Viewer**.\n 7. You will be directed to the Service Accounts page where your new service account can be accessed.\n 8. To obtain a JSON private key, click on the service account, then the **KEYS** tab. Click **ADD KEY \\\u003e Create new key** and then select JSON as the key type. Click **CREATE** to download the private key to your computer.\n2. Add the new service account as a user to your Merchant Center account. If you are a third-party developer, you will need to have your client do this step for you.\n 1. Go to your [Merchant\n Center account](//merchants.google.com/).\n 2. Go to **Account Access** in the settings of your Merchant Center account.\n 3. Click **+ Add user** and use the service account ID as the email address for the new user.\n\n If you did not take note of the\n service account ID earlier, go to the [Service\n Accounts](//console.developers.google.com/iam-admin/serviceaccounts/) administration page and select the project you created.\n 4. Specify the **User access** and **Email notifications** preferences for the service account. Note that the use of the `Accounts` service requires **Admin** access.\n 5. Click **Add user** to save preferences and be returned to the list of users. The service account ID should be listed with the chosen user role.\n 6. Repeat the process for all other service accounts you want to add.\n3. Now you can access your Merchant Center account using the service account either by using the [Google Application\n Default Credentials](/identity/protocols/application-default-credentials) flow or by using the [service account flow](/identity/protocols/OAuth2ServiceAccount) directly. The Content API for Shopping [Samples](/shopping-content/guides/libraries) show how to use both flows for service account credentials in each supported programming language. Please check out the code samples to try out your new service account and to learn what changes you will need to use service accounts in your own code.\n\nFrequently asked questions\n--------------------------\n\nCan I sign in to the Merchant Center UI with my service account?\n: No, service accounts are not regular Google accounts and cannot 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 are issued by the Google OAuth 2.0\n Authorization Server. When an access token expires, the application should use\n the client library to fetch another access token."]]
