API aufrufen

Das Repository googleads/googleads-shopping-samples auf GitHub enthält Beispielcode für gängige Vorgänge für jede Clientbibliothek. Die Beispiele in googleads-shopping-samples/python/shopping/content/products/ enthalten beispielsweise Code für gängige Vorgänge mit der Ressource products in Python. In diesem Leitfaden beginnen Sie mit einer leeren Datei und erstellen ein Beispiel, in dem ein neues Produkt eingefügt wird. So können Sie die grundlegende Struktur und die erforderlichen Komponenten von Anwendungen sehen, die in die Content API eingebunden sind. Das Endergebnis ähnelt dem Beispiel in der Beispieldatei products/insert.py. Anschließend kannst du mit dem API Explorer für die Methode products.list prüfen, ob das Produkt erfolgreich hinzugefügt wurde.

So starten Sie Ihren ersten Anruf:

  1. Erstellen Sie im Verzeichnis googleads-shopping-samples/python/shopping/content/products/ die leere Datei my-insert.py. Fügen Sie dieser Datei den gesamten Code aus den folgenden Schritten hinzu.

  2. Fügen Sie die Importanweisungen für die erforderlichen Module hinzu.

    Fügen Sie am Anfang von my-insert.py den folgenden Code ein:

    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. Definieren Sie eine eindeutige Produkt-ID und erstellen Sie ein Wörterbuch mit der Produktdefinition.

    Fügen Sie am Ende von my-insert.py den folgenden Code ein:

    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. Erstellen Sie eine Funktion, die ausgeführt wird, wenn das Script über die Befehlszeile ausgeführt wird. Die Funktion erstellt ein Dienstobjekt, um mit der Content API zu interagieren, ruft die Händler-ID aus der Konfigurationsdatei ab, erstellt die Anfrage und führt sie aus, um den API-Aufruf auszuführen.

    Fügen Sie am Ende von my-insert.py den folgenden Code ein:

    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. Um das Script auszuführen und den API-Aufruf auszuführen, rufen Sie in einem Terminalfenster googleads-shopping-samples/python/ auf und führen Sie Folgendes aus:

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

    Wenn der Aufruf erfolgreich war, gibt der Dienst die folgende Meldung auf dem Terminal aus: Produkt mit Angebots-ID „offerId“ wurde erstellt.

  6. Um zu prüfen, ob das Produkt erfolgreich hinzugefügt wurde, rufen Sie mithilfe des API Explorers für die Methode products.list alle Produkte in Ihrem Merchant Center-Konto ab.

    Geben Sie im API Explorer für die Methode products.list die folgenden Werte ein:

    1. Geben Sie Ihre merchantId ein.
    1. Wählen Sie im Bereich Anmeldedaten die Optionen Google OAuth 2.0 und API-Schlüssel aus.
    2. Klicken Sie auf die Schaltfläche Ausführen.
    3. Melden Sie sich mit dem Google-Konto an, das mit Ihrem Merchant Center-Konto verknüpft ist, wenn Sie dazu aufgefordert werden.

    Wenn das Produkt erfolgreich hinzugefügt wurde, werden die Produktdaten in der API Explorer-Antwort angezeigt.

Händler sind dafür verantwortlich, die Richtlinien für Shopping-Anzeigen und Produkteinträge einzuhalten. Google Shopping behält sich das Recht vor, diese Richtlinien durchzusetzen und entsprechend zu reagieren, wenn wir Inhalte oder Verhaltensweisen finden, die gegen diese Richtlinien verstoßen.

Zurück
Clientbibliothek einrichten
Weiter
Content API entdecken