API aufrufen

Das Repository googleads/googleads-shopping-samples auf GitHub enthält Beispielcode für gängige Vorgänge in jeder Clientbibliothek. So enthalten beispielsweise die Beispiele in googleads-shopping-samples/python/shopping/content/products/ Code für gängige Vorgänge mit der Ressource products mit Python. In dieser Anleitung beginnen Sie mit einer leeren Datei und erstellen ein Beispiel, in dem ein neues Produkt eingefügt wird. So können Sie sich die grundlegende Struktur und die erforderlichen Komponenten von Anwendungen ansehen, die in die Content API eingebunden werden können. Das Endergebnis ähnelt dem Beispiel in der Beispieldatei products/insert.py. Sie können dann den API Explorer für die Methode products.list verwenden, um zu 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/ eine leere my-insert.py-Datei. Fügen Sie den gesamten Code der folgenden Schritte in diese Datei ein.

  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 Skript über die Befehlszeile ausgeführt wird. Die Funktion erstellt ein Dienstobjekt für die Interaktion mit der Content API, ruft die Händler-ID aus der Konfigurationsdatei ab, erstellt die Anfrage und führt die Anfrage für den API-Aufruf aus.

    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. Wenn Sie das Skript ausführen und den API-Aufruf ausführen möchten, rufen Sie in einem Terminalfenster googleads-shopping-samples/python/ auf und führen Sie folgenden Befehl aus:

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

    Wenn der Aufruf erfolgreich war, gibt der Dienst die folgende Nachricht an das Terminal aus: Product with OfferId „offerId“ was created.

  6. Wenn Sie prüfen möchten, ob das Produkt erfolgreich hinzugefügt wurde, verwenden Sie den API Explorer für die Methode products.list, um alle Produkte in Ihrem Merchant Center-Konto zurückzugeben.

    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 Abschnitt Anmeldedaten die Option Google OAuth 2.0 und den API-Schlüssel aus.
    2. Klicken Sie auf die Schaltfläche Ausführen.
    3. Wenn Sie dazu aufgefordert werden, melden Sie sich mit dem Google-Konto an, das mit Ihrem Merchant Center-Konto verknüpft ist.

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

Die 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 angemessen zu reagieren, wenn wir Inhalte oder Verhaltensweisen feststellen, die gegen diese Richtlinien verstoßen.

Zurück
Clientbibliothek einrichten
Weiter
Content API entdecken