API çağrısı yapma

GitHub'daki googleads/googleads-shopping-samples deposu, her istemci kitaplığı için genel işlemlere ait örnek kod içerir. Örneğin, googleads-shopping-samples/python/shopping/content/products/ adresindeki örnekler, Python ile products kaynağını kullanan yaygın işlemler için kod sağlar. Bu kılavuzda, boş bir dosyayla başlayıp Content API ile entegre olan uygulamaların temel yapısını ve gerekli bileşenlerini görebileceğiniz yeni bir ürün ekleyen örnek oluşturacaksınız. Sonuç, products/insert.py örnek dosyasındaki örneğe benzer. Ardından, ürünün başarıyla eklendiğini doğrulamak amacıyla products.list yöntemi için API Gezgini'ni kullanabilirsiniz.

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

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

2. Gerekli modüller için içe aktarma ifadelerini 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, yapılandırma dosyasından satıcı kimliğini alır, isteği oluşturur ve API çağrısı yapma isteğini 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 bir terminal penceresinden googleads-shopping-samples/python/ adresine gidip şu komutu çalıştırın:

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

   Çağrı başarılı olursa hizmet, terminale şu mesajı yazdırır: "offerId" kimlikli teklif oluşturuldu.

6. Ürünün başarıyla eklendiğini doğrulamak üzere Merchant Center hesabınızdaki tüm ürünleri döndürmek amacıyla 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 girin.
   1. Credentials (Kimlik bilgileri) bölümünde Google OAuth 2.0'ı ve API key'i (API anahtarı) seçin.
   2. Yürüt 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.

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