Wywoływanie interfejsu API

Repozytorium googleads/googleads-shopping-samples na GitHubie zawiera przykładowy kod dla typowych operacji w każdej bibliotece klienta. Na przykład przykłady w googleads-shopping-samples/python/shopping/content/products/ zapewniają kod do typowych operacji za pomocą zasobu products z Pythonem. W tym przewodniku zaczynasz od pustego pliku i tworzysz przykład, który wstawia nową usługę, aby pokazać podstawową strukturę i wymagane elementy aplikacji zintegrowanych z Content API. Wynik końcowy będzie podobny do przykładu w przykładowym pliku products/insert.py. Następnie możesz użyć Eksploratora interfejsów API metody products.list, aby sprawdzić, czy produkt został dodany.

Aby zadzwonić po raz pierwszy, wykonaj te czynności:

  1. W katalogu googleads-shopping-samples/python/shopping/content/products/ utwórz pusty plik my-insert.py. Dodaj do niego cały kod, wykonując opisane poniżej czynności.

  2. Dodaj instrukcje importu dla 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. Podaj 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ę uruchamianą po uruchomieniu skryptu z poziomu wiersza poleceń. Funkcja ta tworzy obiekt usługi w celu interakcji z interfejsem Content API, pobiera identyfikator sprzedawcy z pliku konfiguracji, konstruuje żądanie i wykonuje żądanie, 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 googleads-shopping-samples/python/ i wykonaj następujące czynności:

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

    Jeśli wywołanie się powiodło, usługa wyświetla w terminalu ten komunikat: Produkt z identyfikatorem oferty „offerId” został utworzony.

  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 Eksploratorze interfejsów API 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 Twoim kontem Merchant Center.

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

Sprzedawcy muszą przestrzegać zasad dotyczących reklam produktowych i bezpłatnych informacji. W Zakupach Google zastrzegamy sobie prawo do egzekwowania tych zasad i odpowiedniego reagowania w przypadku znalezienia treści lub zachowań naruszających te zasady.