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:
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.
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
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' } }
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)
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.
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:- Wpisz
merchantId
.
- W sekcji Dane logowania wybierz Google OAuth 2.0 i klucz interfejsu API.
- Kliknij przycisk Wykonaj.
- 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.
- Wpisz
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.