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 Code für gängige Vorgänge mit der Ressource products mit Python. In diesem Leitfaden beginnen Sie mit einer leeren Datei und erstellen ein Beispiel für ein neues Produkt. Sie sehen dann die Grundstruktur und die erforderlichen Komponenten von Anwendungen, die in die Content API eingebunden sind. Das Endergebnis ähnelt dem Beispiel in der Beispieldatei products/insert.py. Anschließend können Sie mit dem API Explorer für die Methode products.list prüfen, ob das Produkt erfolgreich hinzugefügt wurde.

Führen Sie für Ihren ersten Anruf die folgenden Schritte aus:

  1. Erstellen Sie im Verzeichnis googleads-shopping-samples/python/shopping/content/products/ eine leere Datei my-insert.py. Fügen Sie den gesamten Code in den folgenden Schritten zu dieser Datei 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 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, konstruiert 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. Rufen Sie googleads-shopping-samples/python/ auf und führen Sie den folgenden Befehl aus, um das Skript auszuführen und den API-Aufruf auszuführen:

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

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

  6. Prüfen Sie mit dem API Explorer für die Methode products.list, ob alle Produkte in Ihrem Merchant Center-Konto zurückgegeben wurden.

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

    1. merchantId eingeben.
    1. Wählen Sie im Bereich Anmeldedaten die Option Google OAuth 2.0 und API-Schlüssel aus.
    2. Klicken Sie auf die Schaltfläche Ausführen.
    3. Melde dich mit dem Google-Konto an, das mit deinem Merchant Center-Konto verknüpft ist, wenn du dazu aufgefordert wirst.

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

Die Händler sind selbst dafür verantwortlich, die Richtlinien für Shopping-Anzeigen und kostenlose Einträge einzuhalten. Google Shopping behält sich das Recht vor, diese Richtlinien durchzusetzen und gegebenenfalls entsprechende Maßnahmen zu ergreifen, falls Inhalte oder Verhaltensweisen erkannt werden, die gegen diese Richtlinien verstoßen.

Zurück
Clientbibliothek einrichten
Weiter
Content API entdecken