API çağrısı yapma

GitHub'daki googleads/googleads-shopping-samples deposu, her istemci kitaplığı için ortak işlemlere yönelik örnek kod içerir. Örneğin, googleads-shopping-samples/python/shopping/content/products/ adresindeki örneklerde, Python ile products kaynağını kullanan yaygın işlemler için kod sağlanır. Bu kılavuzda, boş bir dosyayla başlar ve Content API ile entegre olan uygulamaların temel yapısını ve gerekli bileşenlerini görebilmeniz için yeni bir ürün ekleyen bir örnek oluşturursunuz. Nihai sonuç, products/insert.py örnek dosyasında yer alan örneğe benzer olacaktır. Ardından, ürünün başarıyla eklendiğini doğrulamak için products.list yöntemi için API Explorer'ı kullanabilirsiniz.

İlk aramanızı yapmak için aşağıdaki adımları uygulayın:

  1. googleads-shopping-samples/python/shopping/content/products/ dizininde boş bir my-insert.py dosyası oluşturun. Aşağıdaki adımlardaki tüm kodu bu dosyaya ekleyin.

  2. Gerekli modüller için içe aktarma beyanlarını ekleyin.

    my-insert.py dosyasının başına aşağıdaki kodu ekleyin:

    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. Benzersiz bir ürün kimliği tanımlayın ve ürün tanımını içeren bir sözlük oluşturun.

    my-insert.py dosyasının sonuna aşağıdaki kodu ekleyin:

    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. Komut dosyası komut satırından çalıştırıldığında çalışan bir işlev oluşturun. İşlev, Content API ile etkileşim kurmak için bir hizmet nesnesi oluşturur, satıcı kimliğini yapılandırma dosyasından alır, isteği oluşturur ve API çağrısı yapmak için isteği yürütür.

    my-insert.py dosyasının sonuna aşağıdaki kodu ekleyin:

    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. Komut dosyasını çalıştırmak ve API çağrısını yürütmek için terminal penceresinden googleads-shopping-samples/python/ dizine gidin ve şu komutu çalıştırın:

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

    Çağrı başarılı olursa hizmet, terminale aşağıdaki mesajı yazdırır: "offerId" teklif kimliğine sahip ürün oluşturuldu.

  6. Ürünün başarıyla eklendiğini doğrulamak için Merchant Center hesabınızdaki tüm ürünleri döndürmek üzere products.list yöntemi için API Gezgini'ni kullanın.

    products.list yöntemi için API Gezgini'nde aşağıdaki değerleri girin:

    1. merchantId adresinizi girin.
    1. Kimlik bilgileri bölümünde Google OAuth 2.0 ve API anahtarı'nı seçin.
    2. Çalıştır düğmesini tıklayın.
    3. İstenirse Merchant Center hesabınızla ilişkili Google Hesabı ile oturum açın.

    Ürün başarıyla eklendiyse ürün verileri API gezgini yanıtında görünür.

Satıcılar, Alışveriş reklamları ve ücretsiz listelemeler politikalarına uymaktan sorumludur. Google Alışveriş, bu politikaları uygulama ve bu politikaları ihlal eden içerik veya davranış tespit edersek uygun şekilde yanıt verme hakkını saklı tutar.

Önceki
İstemci kitaplığı oluşturma
Sonraki
Content API'yi keşfetme