Wywoływanie interfejsu API

Repozytorium googleads/googleads-shopping-samples w GitHubie zawiera przykładowy kod typowych operacji dla każdej biblioteki klienta. Na przykład przykłady w googleads-shopping-samples/python/shopping/content/products/ zawierają kod do wykonywania typowych operacji przy użyciu zasobu products w języku Python. W tym przewodniku zaczniesz od pustego pliku i utworzysz przykład, który wstawia nowy produkt. Dzięki temu zobaczysz podstawową strukturę i wymagane komponenty aplikacji zintegrowanych z Content API. Wynik będzie podobny do przykładu w pliku products/insert.py. Następnie możesz użyć API Explorer dla metody products.list, aby sprawdzić, czy produkt został dodany.

Aby wykonać pierwsze połączenie, wykonaj te czynności:

1. W katalogu googleads-shopping-samples/python/shopping/content/products/ utwórz pusty plik my-insert.py. Dodaj do tego pliku cały kod z poniższych kroków.

2. Dodaj instrukcje importowania wymaganych modułów.

   Na początku pliku my-insert.py dodaj ten kod:

   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. Zdefiniuj unikalny identyfikator produktu i utwórz słownik z definicją produktu.

   Na końcu pliku my-insert.py dodaj ten kod:

   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. Utwórz funkcję, która będzie uruchamiana, gdy skrypt jest uruchamiany z wiersza poleceń. Funkcja tworzy obiekt usługi do interakcji z interfejsem Content API, pobiera identyfikator sprzedawcy z pliku konfiguracyjnego, tworzy żądanie i wykonuje je, aby wywołać interfejs API.

   Na końcu pliku my-insert.py dodaj ten kod:

   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. Aby uruchomić skrypt i wykonać wywołanie interfejsu API, w oknie terminala przejdź do katalogu googleads-shopping-samples/python/ i uruchom to polecenie:

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

   Jeśli wywołanie się powiedzie, usługa wyświetli w terminalu ten komunikat:Utworzono produkt o identyfikatorze oferty „offerId”.

6. Aby sprawdzić, czy produkt został dodany, użyj Eksploratora interfejsu API dla metody products.list, aby zwrócić wszystkie produkty na koncie Merchant Center.

   W API Explorerze dla metody products.list wpisz te wartości:

   1. Wpisz merchantId.
   1. W sekcji Dane logowania wybierz Google OAuth 2.0 i Klucz interfejsu API.
   2. Kliknij przycisk Wykonaj.
   3. Jeśli pojawi się taka prośba, zaloguj się na konto Google powiązane z kontem Merchant Center.

   Jeśli produkt został dodany, dane produktu pojawią się w odpowiedzi eksploratora interfejsu API.

Sprzedawcy są odpowiedzialni za przestrzeganie zasad dotyczących reklam produktowych i bezpłatnych informacji. Google Shopping zastrzega sobie prawo do egzekwowania tych zasad i podejmowania odpowiednich działań w przypadku wykrycia treści lub zachowań, które je naruszają.