Menggunakan akun layanan OAuth 2.0 dengan Manufacturer Center API

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

Langkah-langkah untuk menggunakan akun layanan guna mengakses Manufacturer Center API

  1. Buat kredensial akun layanan atau akses kredensial publik yang telah Anda buat. Anda harus membuat Client ID OAuth 2.0 dan mendapatkan file kunci pribadi *.json:

    1. Buka Konsol Google API.

    2. Pilih project di menu drop-down di bagian atas halaman. Jika Anda belum memilikinya, buat dengan mengklik Create Project.

    3. Jika Anda belum mengaktifkan Manufacturer Center API untuk project ini, cari dan aktifkan Manufacturer Center API dalam daftar Google API.

    4. Di sidebar sebelah kiri, pilih Credentials.

    5. Untuk menyiapkan akun layanan, pilih Create credentials, lalu Service account key.

    Screenshot Membuat kredensial akun layanan.

    1. Di halaman berikutnya, pilih New service account dari menu drop-down.

    2. Beri nama akun layanan baru. Nama ini juga berfungsi sebagai nama pengguna default untuk ID akun layanan. Ingat ID akun layanan untuk digunakan nanti.

    Screenshot nama akun layanan baru.

    1. Pilih JSON untuk jenis kunci, lalu klik Create.

    2. Tombol Create akan berubah menjadi Creating..., dan setelah pembuatan kunci selesai, tombol tersebut akan otomatis mendownload kunci pribadi sebagai file *.json.

    1. Anda akan kembali ke halaman Credentials, dan Anda akan melihat akun layanan baru dalam daftar kunci akun layanan untuk akun Anda.
  2. 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.

    1. Buka akun Manufacturer Center Anda.

    2. Buka daftar 'Pengguna' di setelan akun Manufacturer Center Anda.

    3. Klik tombol +Pengguna, dan gunakan ID akun layanan sebagai alamat email untuk pengguna baru.

      Screenshot tombol Tambahkan pengguna akun layanan.

    4. Isi formulir dengan ID akun layanan, lalu pilih peran pengguna yang diinginkan. Setidaknya salah satunya harus dipilih, dan penggunaan layanan Accounts memerlukan peran Admin.

    Jika Anda tidak mencatat ID akun layanan sebelumnya, buka halaman administrasi Service Accounts lalu pilih project yang Anda buat.

    Screenshot tambahkan halaman pengguna akun layanan.

    1. Klik tombol Simpan. Anda akan kembali ke daftar pengguna, dan ID akun layanan harus tercantum dengan peran pengguna yang dipilih.

    2. Ulangi prosesnya untuk semua akun layanan lain yang ingin Anda tambahkan.

    3. Lihat pengguna akun layanan yang ada dengan membuka tab Pengguna. Mereka akan menjadi pengguna dengan alamat email yang diakhiri dengan 'gserviceaccount.com'.

  3. 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 tersebut untuk kredensial akun layanan di setiap bahasa pemrograman yang didukung. Lihat contoh kode untuk mencoba akun layanan baru Anda dan mempelajari perubahan yang diperlukan untuk 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 akan berakhir satu jam setelah dikeluarkan oleh Server Otorisasi Google OAuth 2.0. Ketika token akses berakhir, aplikasi harus menggunakan library klien untuk mengambil token akses yang lain.