Menyiapkan library klien

Kami ingin memperkenalkan Merchant API versi beta. Versi ini adalah Content API versi baru dan masa depan.

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

Catatan: Anda perlu menginstal beberapa library yang diperlukan untuk menggunakan kode contoh di Python. Karena alasan ini, sebaiknya buat lingkungan virtual Python sebelum melanjutkan. Untuk mengetahui informasi selengkapnya, lihat Menginstal paket menggunakan lingkungan pip dan 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 utama, buat direktori berikut:

   ~/shopping-samples/content/

   Catatan: Jalur ini, serta nama file untuk file merchant-info.json yang dibuat di 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 Anda, selesaikan langkah-langkah berikut:

   1. Di Merchant Center, pada menu Setelan, pilih Content API.
   2. Klik Autentikasi.
   3. Klik [+] BUAT KUNCI API.
   4. Jika diminta, baca dan setujui perjanjian persyaratan layanan.

   Kunci baru akan otomatis didownload.

3. 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.

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

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

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

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

7. Clone (atau download dan ekstrak) repositori GitHub googleads/googleads-shopping-samples ke lokasi mana pun di komputer Anda. Repositori ini tidak harus berada di direktori beranda atau di ~/shopping-samples/content/.

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

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

   pip install -r requirements.txt
   

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