Melakukan panggilan API

Halaman googleads/googleads-shopping-samples repo di GitHub berisi kode contoh untuk operasi umum bagi setiap klien library. Misalnya, sampel di googleads-shopping-samples/python/shopping/content/products/ berikan kode untuk operasi umum menggunakan products resource dengan Python. Dalam panduan ini, Anda akan memulai dengan file kosong dan membangun contoh yang memasukkan produk baru, sehingga Anda dapat melihat struktur aplikasi dan komponen yang diperlukan yang terintegrasi dengan API Konten. Hasil akhirnya akan mirip dengan contoh pada File contoh products/insert.py. Anda kemudian dapat menggunakan Penjelajah API untuk metode products.list guna memverifikasi bahwa produk berhasil ditambahkan.

Untuk melakukan panggilan pertama Anda, selesaikan langkah-langkah berikut:

1. Di halaman googleads-shopping-samples/python/shopping/content/products/ buka file my-insert.py. Tambahkan semua kode di langkah-langkah berikut untuk file ini.

2. Tambahkan pernyataan impor untuk modul yang diperlukan.

   Di awal my-insert.py, tambahkan kode berikut:

   from __future__ import print_function
   import sys
   
   # The common module provides setup functionality used by the samples,
   # such as authentication and unique id generation.
   from shopping.content import common
   

3. Tentukan ID produk unik dan buat kamus yang berisi produk tersebut definisi.

   Di akhir my-insert.py, tambahkan kode berikut:

   offer_id = 'book#%s' % common.get_unique_id()
   product = {
        'offerId':
            offer_id,
        'title':
            'A Tale of Two Cities',
        'description':
            'A classic novel about the French Revolution',
        'link':
            'http://my-book-shop.com/tale-of-two-cities.html',
        'imageLink':
            'http://my-book-shop.com/tale-of-two-cities.jpg',
        'contentLanguage':
            'en',
        'targetCountry':
            'US',
        'channel':
            'online',
        'availability':
            'in stock',
        'condition':
            'new',
        'googleProductCategory':
            'Media > Books',
        'gtin':
            '9780007350896',
        'price': {
            'value': '2.50',
            'currency': 'USD'
        },
        'shipping': [{
            'country': 'US',
            'service': 'Standard shipping',
            'price': {
                'value': '0.99',
                'currency': 'USD'
            }
        }],
        'shippingWeight': {
            'value': '200',
            'unit': 'grams'
        }
   }
   

4. Buat fungsi yang berjalan saat skrip dijalankan dari command line. Tujuan membuat objek layanan untuk berinteraksi dengan Content API, mendapatkan ID penjual dari file konfigurasi, membuat permintaan, dan mengeksekusi permintaan untuk melakukan panggilan API.

   Di akhir my-insert.py, tambahkan kode berikut:

   def main(argv):
     # Construct the service object to interact with the Content API.
     service, config, _ = common.init(argv, __doc__)
   
     # Get the merchant ID from merchant-info.json.
     merchant_id = config['merchantId']
   
     # Create the request with the merchant ID and product object.
     request = service.products().insert(merchantId=merchant_id, body=product)
   
     # Execute the request and print the result.
     result = request.execute()
     print('Product with offerId "%s" was created.' % (result['offerId']))
   
   # Allow the function to be called with arguments passed from the command line.
   if __name__ == '__main__':
     main(sys.argv)
   
   

5. Untuk menjalankan skrip dan menjalankan panggilan API, dari jendela terminal, buka ke googleads-shopping-samples/python/ dan menjalankan:

   python -m shopping.content.products.my-insert
   

   Jika panggilan berhasil, layanan akan mencetak pesan berikut ke terminal: Produk dengan offerId "offerId" dibuat.

6. Untuk memverifikasi bahwa produk berhasil ditambahkan, gunakan API Explorer untuk metode products.list untuk menampilkan semua produk di Merchant Center Anda menggunakan akun layanan.

   Di kolom API Explorer untuk metode products.list, masukkan nilai berikut:

   1. Masukkan merchantId Anda.
   1. Di bagian Credentials, pilih Google OAuth 2.0 dan API key.
   2. Klik tombol Execute.
   3. Jika diminta, login dengan Akun Google yang terkait dengan akun Merchant Center Anda Pusatkan akun.

   Jika produk berhasil ditambahkan, data produk akan muncul di API respons penjelajah.

Penjual bertanggung jawab untuk mematuhi Persyaratan iklan dan gratis listingan kami. Kebijakan Privasi Shopping berhak menegakkan kebijakan ini dan merespons dengan sesuai jika kami menemukan konten atau perilaku yang melanggar kebijakan ini.