Menyiapkan library klien

Temukan Merchant API, yang merupakan penerus resmi Content API for Shopping. Merchant API masih dalam versi beta.

Lihat pengumuman terbaru untuk mempelajari fitur baru, pembaruan dokumentasi utama, perbaikan bug, dan pembaruan rilis Merchant API.

Untuk mempelajari cara mengelola tampilan bisnis dan produk Anda di Google serta mendapatkan akses terprogram ke data, insight, dan kemampuan unik dalam skala besar, lihat Memulai Merchant API.

Sebaiknya gunakan library klien Google API untuk menyiapkan Content API for Shopping. Panduan ini menggunakan library klien Content API Python sebagai contoh, tetapi library ini tersedia untuk banyak bahasa pemrograman populer dan menyederhanakan tugas API umum seperti autentikasi, mengirim permintaan, dan mengurai respons. Untuk mendapatkan bantuan dalam menyiapkan library klien untuk bahasa lain, lihat README.md untuk bahasa dalam repo googleads/googleads-shopping-samples di GitHub.

Catatan: Anda perlu menginstal beberapa library yang diperlukan untuk menggunakan kode contoh di Python. Oleh karena itu, sebaiknya buat lingkungan virtual Python sebelum melanjutkan. Untuk mengetahui informasi selengkapnya, lihat Menginstal paket menggunakan pip dan lingkungan virtual.

Untuk menyiapkan library klien Google API untuk Python, selesaikan langkah-langkah berikut:

1. Buat direktori untuk file konfigurasi dan autentikasi library klien. Dalam direktori beranda, buat direktori berikut:

   ~/shopping-samples/content/

   Catatan: Jalur ini, serta nama file untuk file merchant-info.json yang dibuat pada langkah 5, ditentukan dalam file python/shopping/content/common.py dalam direktori contoh Content API yang didownload pada langkah 7.

2. Untuk mendownload kredensial akun layanan, selesaikan langkah-langkah berikut:

   1. Buka library Google API.
   2. Pilih project di menu di bagian atas halaman. Jika belum memilikinya, buat project dengan mengklik New project.
   3. Jika Anda belum mengaktifkan Content API for Shopping untuk project ini, cari API tersebut dalam daftar Google API, lalu aktifkan.
   4. Di sidebar sebelah kiri, pilih Kredensial. Anda mungkin perlu mengklik panah yang mengarah 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 nanti. Klik Create, lalu lakukan langkah-langkah opsional untuk memberikan akses ke project dan pengguna, lalu klik Done.
   7. Anda akan diarahkan ke halaman Akun Layanan tempat akun layanan baru Anda dapat diakses.

3. Untuk mendapatkan kunci pribadi JSON, klik akun layanan, lalu tab Kunci. Klik Tambahkan kunci > Buat kunci baru, lalu pilih JSON sebagai jenis kunci. Klik Buat untuk mendownload kunci pribadi ke komputer Anda. Kunci baru akan otomatis didownload.

4. Ganti nama file kredensial yang didownload menjadi service-account.json.

   Catatan: Nama file ini ditentukan dalam file _constants.py, yang terletak di python/shopping/content/ dalam direktori contoh Content API yang didownload pada langkah 7.

5. Pindahkan file service-account.json ke home directory/shopping-samples/content/.

6. Di home directory/shopping-samples/content/, buat file merchant-info.json kosong.

7. Di merchant-info.json, tambahkan teks berikut:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. Tambahkan akun layanan baru sebagai pengguna ke akun Merchant Center Anda. Jika Anda adalah developer pihak ketiga, Anda harus meminta klien untuk melakukan langkah ini untuk Anda.

   1. Buka akun Merchant Center Anda.
   2. Di setelan akun Merchant Center, pilih Orang dan akses.

   3. Klik + Tambahkan orang dan gunakan ID akun layanan sebagai alamat email untuk pengguna baru.

      Catatan: Jika Anda tidak mencatat ID akun layanan sebelumnya, buka halaman administrasi Akun Layanan dan pilih project yang Anda buat.

   4. Penggunaan layanan Accounts memerlukan akses Admin, jadi pilih Admin.

   5. Klik Tambahkan pengguna untuk menyimpan preferensi dan kembali ke daftar pengguna. ID akun layanan tercantum dengan peran pengguna yang dipilih.

   6. Ulangi proses ini untuk semua akun layanan lain yang ingin ditambahkan.

9. Clone (atau download dan ekstrak) repo GitHub googleads/googleads-shopping-samples ke lokasi mana pun di komputer Anda; tidak harus di direktori utama atau di ~/shopping-samples/content/.

10. Jika Anda mendownload dan mengekstrak repo, ganti nama direktori yang diekstrak menjadi googleads-shopping-samples, bukan meng-clone-nya.

11. Untuk menginstal dependensi contoh yang diperlukan, di jendela terminal, buka googleads-shopping-samples/python/ dan jalankan:

    pip install -r requirements.txt
    

Sekarang Anda memiliki library klien Google API untuk Python yang dikonfigurasi dan siap digunakan dengan Content API. Di bagian berikutnya, Anda akan membuat dan mengirim permintaan untuk menyisipkan produk baru.