API çağrısı yapma

googleads/googleads-shopping-samples GitHub'daki depo, her istemci için ortak işlemlere yönelik örnek kod içerir kitaplığını açar. Örneğin, googleads-shopping-samples/python/shopping/content/products/ kod sağlama ortak işlemler için products nasıl kullanacağınızı göstereceğim. Bu kılavuzda boş bir dosyayla başlayıp, gösteren temel öğeleri görmeniz için, yeni bir ürünün eklendiği Google Analytics 4 ile entegre olan uygulamaların yapısını ve gerekli bileşenlerini Content API. Nihai sonuç products/insert.py örnek dosyasını kullanın. Daha sonra API Gezgini ürünün başarıyla eklendiğini doğrulamak için products.list yöntemine bakın.

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

1. googleads-shopping-samples/python/shopping/content/products/ dizine eklemek için boş bir my-insert.py dosyası oluşturun. Kodun tamamını bu dosyadaki adımları uygulayın.

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ünle bir sözlük oluşturun. belirler.

   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. İlgili içeriği oluşturmak için kullanılan işlevi, Content API ile etkileşim kuracak bir hizmet nesnesi oluşturur, yapılandırma dosyasındaki satıcı kimliğini oluşturur, isteği oluşturur ve isteği gönderir.

   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 kodu çalıştırın:

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

   Arama başarılı olursa hizmet, terminale aşağıdaki mesajı yazdırır: Teklif kimliği "offerId" olan ürün oluşturuldu.

6. Ürünün başarıyla eklendiğini doğrulamak üzere şunun için API Gezgini'ni kullanın: Merchant Center'daki tüm ürünleri iade etmek için products.list yöntemini kullanın hesap.

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

   1. merchantId girin.
   ziyaret edin.
   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 satıcınızla ilişkili Google Hesabı'nda oturum açın Center hesabı.

   Ürün başarıyla eklendiyse ürün verileri API'de görünür. gerekir.

Satıcılar, Alışveriş ads ve ücretsiz girişleriyle ilgili tüm politikaları ihlal eder. Google Alışveriş, bu politikaları uygulama ve uygun şekilde yanıt verme hakkını saklı tutar. bu politikaları ihlal eden içerik veya davranış tespit etmemiz gerekir.