Wywoływanie interfejsu API

Strona googleads/googleads-shopping-samples repozytorium na GitHubie zawiera przykładowy kod do typowych operacji na poszczególnych klientach bibliotece. Na przykład przykłady w formacie googleads-shopping-samples/python/shopping/content/products/ – podaj kod. do typowych operacji za pomocą products. w Pythonie. W tym przewodniku zaczynasz od pustego pliku i kompilacji przykład, w którym wstawiany jest nowy produkt, aby można było zobaczyć podstawowe i wymagane komponenty aplikacji, które integrują się z Content API. Efekt końcowy będzie podobny do przykładu w przykładowego pliku products/insert.py. Następnie możesz użyć funkcji Eksplorator interfejsu API dla metody products.list, aby sprawdzić, czy produkt został dodany.

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

  1. Na stronie googleads-shopping-samples/python/shopping/content/products/ utwórz pusty plik my-insert.py. Dodaj cały kod do sekcji czynności, jakie należy wykonać w tym pliku.

  2. Dodaj instrukcje importu dla wymaganych modułów.

    Na początku pliku my-insert.py dodaj następujący 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 dla niego słownik definicji.

    Na końcu pliku my-insert.py dodaj następujący 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ą, gdy skrypt jest uruchamiany z poziomu wiersza poleceń. funkcja tworzy obiekt usługi do interakcji z interfejsem Content API, pobiera wartość z pliku konfiguracji, tworzy żądanie i wykonuje żądanie. żądania wywołania interfejsu API.

    Na końcu pliku my-insert.py dodaj następujący 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 wywołać interfejs API, w oknie terminala przejdź do: do googleads-shopping-samples/python/ i uruchomienie:

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

    Jeśli połączenie się powiedzie, usługa wyświetli w terminalu ten komunikat: Produkt z identyfikatorem oferty „offerId” który został utworzony.

  6. Aby sprawdzić, czy produkt został dodany, użyj narzędzia API Explorer do metody products.list, aby zwrócić wszystkie produkty z Merchant Center koncie.

    W API Explorer dla metody products.list, wpisz następujące wartości:

    1. Wypełnij pole 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 sprzedawcą. koncie Centrum.

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

Sprzedawcy są odpowiedzialni za przestrzeganie zasad Zakupów Google reklam i bezpłatnej informacji o produktach. Google Usługa Zakupy Google zastrzega sobie prawo do egzekwowania tych zasad i odpowiedniego reagowania na nie jeśli zauważymy treści lub zachowania, które naruszają te zasady.