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 berisi penjelasan mengenai cara mengakses Manufacturer Center API dengan akun layanan.

Catatan: Aplikasi yang menggunakan akun layanan untuk autentikasi hanya dapat mengakses akun Manufacturer Center Anda sendiri. Jika Anda menulis aplikasi pihak ketiga yang memerlukan akses ke akun Manufacturer Center Anda, lihat panduan Mengotorisasi Permintaan.

Prasyarat

Langkah-langkah menggunakan akun layanan untuk 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 belum memilikinya, buat dengan mengklik Buat Project.
    3. Jika Anda belum mengaktifkan Manufacturer Center API untuk project ini, telusuri API tersebut dalam daftar Google API dan aktifkan.
    4. Pada sidebar di sebelah kiri, pilih Credentials.
    5. Untuk menyiapkan akun layanan, pilih Buat kredensial, lalu Kunci akun layanan.
      Buat screenshot kredensial akun layanan.
    6. Di halaman berikutnya, pilih Akun layanan baru dari menu drop-down.
    7. Namai akun layanan baru. ID ini juga berfungsi sebagai nama pengguna default untuk ID akun layanan. Ingat ID akun layanan untuk digunakan nanti.

      Pilihan peran untuk akun layanan tidak akan berpengaruh pada panggilan apa yang dapat dilakukan ke Manufacturer Center API, karena akses ke metode Manufacturer Center API ditentukan oleh peran yang terkait dengan ID akun layanan di Manufacturer Center. Jika tidak yakin apa yang harus dipilih, cukup pilih Project{0}Viewer.

      Screenshot nama akun layanan baru.
    8. Pilih JSON untuk jenis kunci, lalu klik Create.
    9. Tombol Create akan berubah menjadi Creating..., dan setelah proses pembuatan kunci selesai, kunci akan otomatis didownload sebagai kunci *.json file.

      Penting: Lindungi file kunci *.json yang memungkinkan akun layanan mengakses layanan Google yang telah diberi otorisasi. Sebaiknya akun layanan hanya dapat mengakses satu Google API per akun. Ini adalah tindakan pencegahan untuk mengurangi jumlah data yang dapat diakses penyerang jika file kunci *.json akun layanan disusupi.

    10. Anda akan dikembalikan 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 'Pengguna' daftar di pengaturan akun Manufacturer Center Anda.
    3. Klik tombol +Pengguna, lalu gunakan ID akun layanan sebagai alamat email untuk pengguna baru. Tambahkan screenshot tombol pengguna akun layanan.
    4. Isi formulir dengan ID akun layanan, lalu pilih peran pengguna yang diinginkan. Minimal satu peran harus dipilih, dan penggunaan layanan Accounts memerlukan peran Admin.

      Jika Anda tidak mencatat ID akun layanan sebelumnya, buka halaman administrasi Akun Layanan lalu pilih project yang telah dibuat.

      Tambahkan screenshot halaman pengguna akun layanan.
    5. Klik tombol Save. Anda akan dikembalikan ke daftar pengguna, dan ID akun layanan harus dicantumkan dengan peran pengguna yang dipilih.
    6. Ulangi proses ini untuk semua akun layanan lain yang ingin Anda tambahkan.
    7. Lihat pengguna akun layanan yang ada dengan membuka tab Pengguna. Ini akan menjadi pengguna dengan alamat email yang diakhiri dengan 'gserviceaccount.com'.
  3. Sekarang Anda dapat mengakses akun Manufacturer Center menggunakan akun layanan baik dengan menggunakan Kredensial Default Aplikasi Google maupun dengan 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 untuk mempelajari perubahan yang Anda perlukan 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 harus memperbarui token akses akun layanan?

Masa berlaku token akses berakhir satu jam setelah dikeluarkan oleh Server Otorisasi Google OAuth 2.0. Ketika masa berlaku token akses berakhir, aplikasi harus menggunakan library klien untuk mengambil token akses lain.