Melakukan panggilan API

Repo googleads/googleads-shopping-samples di GitHub berisi kode contoh untuk operasi umum untuk setiap library klien. Misalnya, contoh di googleads-shopping-samples/python/shopping/content/products/ memberikan kode untuk operasi umum menggunakan resource products dengan Python. Dalam panduan ini, Anda memulai dengan file kosong dan membuat contoh yang menyisipkan produk baru, sehingga Anda dapat melihat struktur dasar dan komponen aplikasi yang diperlukan yang terintegrasi dengan Content API. Hasil akhirnya akan mirip dengan contoh dalam file contoh products/insert.py. Kemudian, Anda dapat menggunakan API Explorer untuk metode products.list guna memverifikasi bahwa produk berhasil ditambahkan.

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

  1. Di direktori googleads-shopping-samples/python/shopping/content/products/, buat file my-insert.py yang kosong. Tambahkan semua kode dalam langkah-langkah berikut ke 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 dengan definisi produk.

    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. Fungsi ini membuat objek layanan untuk berinteraksi dengan Content API, mendapatkan ID penjual dari file konfigurasi, membuat permintaan, dan menjalankan 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 googleads-shopping-samples/python/ lalu jalankan:

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

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

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

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

    1. Masukkan merchantId Anda.
    1. Pada 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.

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

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