Akun layanan

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, akun layanan 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 Anda, lihat panduan Mengizinkan Permintaan.

Prasyarat

Langkah-langkah menggunakan akun layanan untuk mengakses Content API for Shopping

  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 project dengan mengklik PROJECT BARU.
    3. Jika Anda belum mengaktifkan Content API for Shopping untuk project ini, cari di daftar Google API dan aktifkan.
    4. Klik menu navigasi (☰) di kiri atas, pilih APIs & Services, lalu pilih Credentials.
    5. Untuk menyiapkan akun layanan, pilih BUAT KREDENSIAL, lalu Akun layanan.
    6. Beri nama akun layanan baru. ID ini juga berfungsi sebagai nama pengguna default untuk ID akun layanan. Catat ID akun layanan, termasuk bagian setelah karakter '@', untuk digunakan nanti. Klik BUAT, lalu ikuti langkah-langkah opsional untuk memberikan akses ke project dan pengguna, lalu klik SELESAI.

      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 Anda tidak yakin apa yang harus dipilih, cukup pilih Project > Viewer.

    7. Anda akan diarahkan ke halaman Akun Layanan tempat akun layanan baru Anda dapat diakses.
    8. 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.
  2. Tambahkan akun layanan baru sebagai pengguna ke akun Merchant Center Anda. Jika Anda adalah developer pihak ketiga, Anda harus meminta klien Anda melakukan langkah ini untuk Anda.
    1. Buka akun Merchant Center Anda.
    2. Buka Akses Akun di setelan akun Merchant Center Anda.
    3. Klik + Tambahkan pengguna, lalu 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.

    4. Tentukan preferensi Akses pengguna dan Notifikasi email untuk akun layanan. Perhatikan bahwa penggunaan layanan Accounts memerlukan akses Admin.
    5. Klik Tambahkan pengguna untuk menyimpan preferensi dan kembali ke daftar pengguna. ID akun layanan harus dicantumkan dengan peran pengguna yang dipilih.
    6. Ulangi proses ini untuk semua akun layanan lainnya yang ingin Anda tambahkan.
  3. Sekarang Anda dapat mengakses akun Merchant Center menggunakan akun layanan baik dengan menggunakan alur Kredensial Default Aplikasi Google atau langsung menggunakan alur akun layanan. Contoh Content API for Shopping 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 Anda lakukan 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 bukanlah 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. Saat masa berlaku token akses berakhir, aplikasi harus menggunakan library klien untuk mengambil token akses lain.