Wywoływanie interfejsu API

Repozytorium googleads/googleads-shopping-samples na GitHubie zawiera przykładowy kod do wykonywania typowych operacji w każdej bibliotece klienta. Na przykład przykłady w folderze googleads-shopping-samples/python/shopping/content/products/ zawierają kod do wykonywania typowych operacji za pomocą zasobu products w Pythonie. W tym przewodniku zaczynasz od pustego pliku, a potem przechodzisz do przykładu, w którym wstawiasz nowy produkt. Dzięki temu możesz zobaczyć podstawową strukturę i wymagane komponenty aplikacji, które integrują się z Content API. Efekt końcowy będzie podobny do przykładu w pliku products/insert.py. Następnie możesz użyć narzędzia 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 podanych niżej 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 wykonywana, gdy skrypt zostanie uruchomiony z poziomu wiersza poleceń. Funkcja tworzy obiekt usługi, który będzie współpracować z interfejsem Content API, pobiera identyfikator sprzedawcy z pliku konfiguracyjnego, tworzy żą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 uruchom:

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

    Jeśli wywołanie zakończyło się powodzeniem, usługa wydrukuje na terminalu następujący komunikat: Produkt o identyfikatorze oferty „offerId” został utworzony.

  6. Aby sprawdzić, czy produkt został dodany, użyj Eksploratora interfejsu API do zwrócenia wszystkich produktów na koncie Merchant Center za pomocą metody products.list.

    W narzędzie API Explorer 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, jego dane pojawią się w odpowiedzi interfejsu API Explorer.

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ń, jeśli wykryjemy treści lub zachowania, które je naruszają.

.
Wstecz
Konfigurowanie biblioteki klienta
Dalej
Przeglądaj Content API