Menyiapkan library klien

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

Dapatkan informasi tentang cara Merchant API meningkatkan integrasi Anda dan cara Anda dapat membantu membentuk di masa mendatang, lihat Mengumumkan Merchant API Beta.

Sebaiknya gunakan Library klien Google API yang perlu ditetapkan Content API for Shopping. Panduan ini menggunakan klien Python Content API {i>library<i} sebagai contoh, tetapi mereka tersedia untuk banyak aplikasi pemrograman populer bahasa pemrograman dan menyederhanakan tugas API umum seperti autentikasi, pengiriman permintaan, dan mengurai respons. Untuk bantuan dalam menyiapkan pustaka klien bagi bahasa lain, lihat README.md untuk bahasa dalam 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 informasi selengkapnya, lihat Menginstal paket menggunakan pip dan lingkungan virtual.

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

1. Membuat direktori untuk 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 pada langkah 5, didefinisikan di python/shopping/content/common.py file dalam direktori contoh Content API yang didownload di langkah 7.

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

   1. Buka library Google API.
   2. Pilih project di menu di bagian atas halaman. Jika Anda belum memilikinya buat satu project dengan mengklik New project.
   3. Jika Anda belum mengaktifkan Content API for Shopping untuk project Anda, lalu telusuri project tersebut dalam daftar Google API dan aktifkan.
   4. Di sidebar sebelah kiri, pilih Credentials. Anda mungkin perlu mengklik panah yang menunjuk ke kiri di kiri atas untuk melihat ini.
   5. Untuk menyiapkan akun layanan, pilih Create credentials, lalu Akun layanan.
   6. Beri nama akun layanan baru tersebut. Ini juga berfungsi sebagai nama pengguna {i>default<i} untuk ID akun layanan. Catat ID akun layanan, termasuk bagiannya setelah '@' untuk digunakan nanti. Klik Create, lalu buka langkah opsional untuk memberikan akses ke proyek dan pengguna, dan klik Selesai.
   7. Anda akan diarahkan ke halaman Akun Layanan tempat layanan baru dapat diakses.

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

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

   Catatan: Nama file ini didefinisikan dalam file _constants.py, yang terletak di python/shopping/content/ dalam direktori contoh Content API didownload di 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 Anda melakukan langkah ini keamanan untuk Anda.

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

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

      Catatan: Jika ID akun layanan sebelumnya tidak Anda catat, buka administrasi Akun Layanan halaman 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 prosesnya untuk semua akun layanan lain yang ingin Anda tambahkan.

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

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

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