Repositori googleads/googleads-shopping-samples di GitHub berisi kode contoh untuk operasi umum bagi 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 akan 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. Selanjutnya, Anda dapat menggunakan
API Explorer
untuk metode products.list
guna memverifikasi bahwa produk berhasil ditambahkan.
Untuk melakukan panggilan pertama Anda, selesaikan langkah-langkah berikut:
Di direktori googleads-shopping-samples/python/shopping/content/products/, buat file my-insert.py kosong. Tambahkan semua kode dalam langkah-langkah berikut ke file ini.
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
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' } }
Buat fungsi yang berjalan saat skrip dijalankan dari command line. Fungsi tersebut membuat objek layanan untuk berinteraksi dengan Content API, mendapatkan ID penjual dari file konfigurasi, membuat permintaan, dan menjalankan permintaan untuk membuat 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)
Untuk menjalankan skrip dan menjalankan panggilan API, dari jendela terminal, buka googleads-shopping-samples/python/ dan jalankan:
python -m shopping.content.products.my-insert
Jika panggilan berhasil, layanan akan mencetak pesan berikut ke terminal: Produk dengan offerId "offerId" telah dibuat.
Untuk memverifikasi bahwa produk berhasil ditambahkan, gunakan API Explorer untuk metode
products.list
guna menampilkan semua produk di akun Merchant Center Anda.Dalam API Explorer untuk metode
products.list
, masukkan nilai berikut:- Masukkan
merchantId
Anda.
- Di bagian Credentials, pilih Google OAuth 2.0 dan API key.
- Klik tombol Execute.
- Jika diminta, login dengan Akun Google yang terkait dengan akun Merchant Center Anda.
Jika produk berhasil ditambahkan, data produk akan muncul di respons API Explorer.
- Masukkan
Penjual bertanggung jawab untuk mematuhi kebijakan iklan Shopping dan listingan gratis. Google Shopping berhak menegakkan kebijakan ini dan melakukan tindakan yang sesuai jika kami menemukan konten atau perilaku yang melanggar kebijakan ini.