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, aplikasi 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 Anda, lihat panduan Permintaan Otorisasi.

Prasyarat

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

  1. Buat kredensial akun layanan atau akses kredensial publik yang sudah 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 NEW PROJECT.
    3. Jika Anda belum mengaktifkan Content API for Shopping untuk project ini, telusuri API tersebut dalam daftar Google API dan aktifkan.
    4. Pada sidebar di sebelah kiri, pilih Credentials. Anda mungkin perlu mengklik panah menunjuk ke kiri di kiri atas untuk melihatnya.
    5. Untuk menyiapkan akun layanan, pilih BUAT KREDENSIAL, lalu Akun layanan.
    6. 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 di lain waktu. Klik CREATE, lalu ikuti langkah-langkah opsional untuk memberikan akses ke project dan pengguna, lalu klik DONE.

      Pilihan peran untuk akun layanan tidak akan berpengaruh pada 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 apa yang harus dipilih, pilih Project > Viewer.

    7. Anda akan diarahkan ke halaman Akun Layanan tempat akun layanan baru dapat diakses.
    8. Untuk mendapatkan kunci pribadi JSON, klik akun layanan, lalu tab KUNCI. 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 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 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.

    4. Tentukan preferensi Akses pengguna dan Notifikasi email untuk akun layanan. Perlu diperhatikan bahwa penggunaan layanan Accounts memerlukan akses Admin.
    5. Klik Tambahkan pengguna untuk menyimpan preferensi dan dikembalikan ke daftar pengguna. ID akun layanan harus dicantumkan dengan peran pengguna yang dipilih.
    6. Ulangi proses tersebut untuk semua akun layanan lain yang ingin Anda tambahkan.
  3. Sekarang Anda dapat mengakses akun Merchant Center menggunakan akun layanan dengan menggunakan alur Kredensial Default Aplikasi Google atau menggunakan alur akun layanan secara langsung. 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 dilakukan 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 reguler 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 Google OAuth 2.0. Saat masa berlaku token akses berakhir, aplikasi harus menggunakan library klien untuk mengambil token akses lain.