API aufrufen

Das googleads/googleads-shopping-samples-Repository 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 häufige 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 werden. 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.

So führen Sie Ihren ersten Anruf 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 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 Dictionary 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 sie aus, um den API-Aufruf zu starten.

   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 Skript auszuführen und den API-Aufruf zu starten, wechseln Sie in einem Terminalfenster zu googleads-shopping-samples/python/ und führen Sie Folgendes aus:

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

   Wenn der Aufruf erfolgreich war, gibt der Dienst die folgende Meldung im 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 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 angemessen zu reagieren, wenn wir Inhalte oder Verhaltensweisen finden, die gegen diese Richtlinien verstoßen.