googleads shopping samples

Sampel untuk API Konten untuk API Pusat Belanja dan Produsen

Sampel kode ini disusun oleh platform atau bahasa. Setiap direktori bahasa berisi README dengan informasi lebih lanjut tentang cara menjalankan sampel untuk bahasa tertentu. Di sini, kami mencakup otentikasi pengaturan dan file konfigurasi umum yang digunakan oleh semua sampel.

Untuk informasi lebih lanjut tentang API, silakan merujuk ke dokumentasi untuk API konten untuk berbelanja dan API Pusat Produsen.

Pilih metode otentikasi Anda

Sebelum memulai, periksa bagian Memulai API konten untuk dokumentasi belanja. Anda mungkin ingin menggunakan akun layanan sebagai gantinya untuk menyederhanakan aliran otentikasi. Sampel -sampel ini juga mendukung menggunakan kredensial default aplikasi Google.

Menyiapkan otentikasi untuk API Pusat Produsen mirip dengan API konten. Pastikan untuk memilih API Pusat Produsen di konsol API. Kedua API dapat dipilih jika Anda ingin mencoba sampel untuk kedua API.

Menyiapkan otentikasi dan konfigurasi sampel

1. Buat direktori $(HOME)/shopping-samples untuk menyimpan konfigurasi.

   Jika Anda tidak yakin di mana ini akan berada di pengaturan khusus Anda, maka jalankan sampel (mengikuti README khusus bahasa). Kesalahan dari sampel yang terkait dengan direktori ini atau file yang diperlukan yang tidak ada akan memberikan jalur lengkap ke direktori/file yang diharapkan.

   Di dalam direktori ini, juga buat subdirektori berikut, tergantung pada API mana yang ingin Anda coba:

   • content untuk API Konten untuk Belanja
   • manufacturers untuk API Pusat Produsen

   Tempatkan file yang dijelaskan di bawah ini di subdirektori yang sesuai untuk API yang ingin Anda coba.

2. Siapkan metode otentikasi yang Anda inginkan.

   Jika Anda menggunakan kredensial default aplikasi Google:

   • Ikuti arahan pada halaman kredensial default aplikasi Google.

   Jika Anda menggunakan akun layanan:

   • Letakkan file JSON yang Anda unduh saat membuat akun layanan ke file service-account.json di subdirektori konfigurasi API yang sesuai.

   Jika Anda menggunakan ID klien OAuth2:

   • Unduh kredensial klien OAuth2 Anda ke file client-secrets.json di subdirektori konfigurasi API yang sesuai.

     Catatan: Sampel menganggap bahwa Anda menggunakan ID klien OAuth2 yang dapat menggunakan alamat IP loopback untuk mengambil token. Jika Anda tidak atau tidak yakin, silakan kunjungi [oauth2.0 untuk aplikasi seluler & desktop] (https://developers.google.com/identity/protocols/oauth2installedApp) dan ikuti instruksi di sana untuk membuat a ID klien OAuth2 baru untuk digunakan dengan sampel.

   Anda dapat mengatur beberapa metode otentikasi untuk mencoba aliran yang berbeda, tetapi perhatikan bahwa sampel akan selalu menggunakan kredensial pertama yang dapat dimuat, dalam urutan:

   1. Aplikasi Google Kredensial Default
   2. Kredensial Akun Layanan
   3. Kredensial klien OAuth2

3. Setiap set sampel menggunakan file konfigurasi yang berbeda. Untuk API konten untuk berbelanja, ambil contoh merchant-info.json dari root repositori dan salin ke $(HOME)/shopping-samples/content . Selanjutnya, ubah isinya dengan tepat. Ini berisi objek JSON dengan bidang -bidang berikut:

   Bidang	Jenis	Keterangan
   merchantId	nomor	ID Pusat Pedagang untuk menjalankan sampel melawan.
   accountSampleUser	rangkaian	Jika tidak kosong, alamat email untuk pengguna untuk menambah/menghapus sampel untuk layanan Accounts .
   accountSampleAdWordsCID	nomor	Jika bukan nol, ID Pelanggan AdWords untuk menautkan/membuka tautan dalam sampel untuk layanan Accounts .

   Untuk API Pusat Produsen, ambil contoh manufacturer-info.json dari root repositori dan salin ke $(HOME)/shopping-samples/manufacturers . Selanjutnya, ubah isinya dengan tepat. Ini berisi objek JSON dengan bidang -bidang berikut:

   Bidang	Jenis	Keterangan
   manufacturerId	nomor	ID Pusat Produsen untuk menjalankan sampel melawan.
   websiteUrl	rangkaian	URL (tanpa slash trailing) yang terkait dengan akun Pusat Pabrikan.

   Jika menggunakan kredensial klien OAuth2, setelah Anda memiliki akses resmi, detail token Anda akan disimpan dalam file stored-token.json di direktori konfigurasi sampel. Jika Anda memiliki masalah yang mengotentikasi, hapus file ini dan Anda akan diminta untuk menghitung ulang akses.

Coba sampelnya

Sekarang setelah Anda mengkonfigurasi file konfigurasi sampel umum dan mengatur kredensial otentikasi Anda, saatnya untuk membangun dan menjalankan salah satu sampel yang disertakan. Seperti yang disebutkan sebelumnya, ada instruksi khusus bahasa di README yang terletak di setiap subdirektori bahasa. Selamat bersenang-senang!

Kemungkinan masalah

• Saat menggunakan API konten untuk berbelanja, jika Anda belum mengatur pengaturan pajak di akun Anda, Anda mungkin mendapatkan kesalahan saat menjalankan sampel tertentu. Jika Anda menerima kesalahan "Pengaturan Pajak Hilang", atur pengaturan pajak Anda di Pusat Pedagang sebelum mencoba sampel ini. Memilih pengaturan "Jangan mengenakan pajak di Amerika Serikat" sudah cukup.