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 tambahan. Sebagai gantinya, aplikasi ini menggunakan file kunci yang hanya dapat diakses oleh aplikasi Anda. Panduan ini membahas cara mengakses Manufacturer Center API dengan akun layanan.
Prasyarat
- Akun Manufacturer Center.
Langkah-langkah untuk menggunakan akun layanan untuk mengakses Manufacturer Center API
Buat kredensial akun layanan atau akses kredensial publik yang sudah Anda buat. Anda harus membuat Client ID OAuth 2.0 dan memperoleh file kunci pribadi *.json:
Buka Konsol Google API.
Pilih project di menu drop-down di bagian atas halaman. Jika Anda belum memilikinya, buat project dengan mengklik Create Project.
Jika Anda belum mengaktifkan Manufacturer Center API untuk project ini, telusuri API tersebut dalam daftar Google API dan aktifkan.
Pada sidebar di sebelah kiri, pilih Credentials.
Untuk menyiapkan akun layanan, pilih Create credentials, lalu Service account key. "+Membuat kredensial akun layanan
screenshot.](../images/create_service_account_credentials.png)
6. On the next page, select **New service account** from the drop-down
list.
7. <a name="service-account-name"></a> Name the new service account. This
also serves as the default username for the service account ID. Remember
the service account ID for use later.
Note: The choice of role for the service account will not have any effect on
what calls can be made to the Manufacturer Center API, as access to
Manufacturer Center API methods is determined instead by the role
associated with the service account ID in Manufacturer Center. If you
are unsure what to pick, just pick Project►Viewer.
![New service account name
screenshot.](../images/new_service_account_name.png)
8. Select **JSON** for the key type, then click **Create**.
9. The **Create** button will change to **Creating...**, and once the key
generation finishes, it will automatically download the private key as a
*.json file.
Important: Protect the *.json key file that allows a service account to
access the Google services for which it has been authorized. It is good
practice to allow service accounts to only access one Google API each. This
is a preventative measure to mitigate the amount of data an attacker can
access in the situation that the service account's *.json key file is
compromised.
10. You will be returned to the Credentials page, and you should see the
new service account in the list of service account keys for your
account.
Tambahkan akun layanan baru sebagai pengguna ke akun Manufacturer Center Anda. Jika Anda adalah developer pihak ketiga, Anda harus meminta klien melakukan langkah ini untuk Anda.
Buka akun Manufacturer Center.
Buka daftar 'Pengguna' di setelan akun Manufacturer Center Anda.
Klik tombol +Pengguna, dan gunakan ID akun layanan sebagai alamat email untuk pengguna baru. "+Tombol pengguna akun layanan ditambahkan
screenshot.](../images/add_service_account_network_settings.png)
4. Fill in the form with the [service account ID](#service-account-name),
and select the desired user role(s). At least one must be chosen, and
use of the `Accounts` service requires the Admin role.
If you did not take note of the service account ID earlier, go to the
[Service
Accounts](https://console.developers.google.com/iam-admin/serviceaccounts/)
administration page and select the project you created.
![Add service account user page
screenshot.](../images/add_service_account_page.png)
5. Click on the **Save** button. You will be returned to the list of users,
and the service account ID should be listed with the chosen user role(s).
6. Repeat the process for all other service accounts you want to add.
7. View existing service account users by going to the Users tab. These
will be users with an email address ending in 'gserviceaccount.com'.
- Sekarang, Anda dapat mengakses akun Manufacturer Center menggunakan akun layanan menggunakan alur Kredensial Default Aplikasi Google atau menggunakan alur akun layanan secara langsung. Contoh Manufacturer Center API menunjukkan cara menggunakan kedua alur untuk kredensial akun layanan dalam setiap bahasa pemrograman yang didukung. Lihat contoh kode untuk mencoba akun layanan baru dan mempelajari perubahan yang perlu dilakukan menggunakan akun layanan dalam kode Anda sendiri.
Pertanyaan umum (FAQ)
Dapatkah saya login ke antarmuka pengguna web Manufacturer Center dengan akun layanan saya?
Tidak, akun layanan bukan Akun Google reguler dan tidak dapat mengakses antarmuka pengguna web Manufacturer Center.
Seberapa sering saya perlu memperbarui token akses akun layanan?
Masa berlaku token akses berakhir satu jam setelah dikeluarkan oleh Server Otorisasi Google OAuth 2.0. Saat masa berlaku token akses berakhir, aplikasi harus menggunakan library klien untuk mengambil token akses lain.