API aufrufen

Das Tag googleads/googleads-shopping-samples Repository auf GitHub enthält Beispielcode für allgemeine Vorgänge für jeden Client Bibliothek. Die Beispiele in googleads-shopping-samples/python/shopping/content/products/ stellt Code bereit. für gängige Operationen mithilfe der products mit Python. In dieser Anleitung beginnen Sie mit einer leeren Datei und erstellen ein Beispiel zum Einfügen eines neuen Produkts, sodass Sie die grundlegenden und erforderliche Komponenten von Anwendungen erstellen, Content API Das Endergebnis wird dem Beispiel in der products/insert.py erstellen. Sie können dann die Methode API-Explorer für die Methode products.list, um zu prüfen, ob das Produkt erfolgreich hinzugefügt wurde.

So starten Sie Ihren ersten Anruf:

1. Geben Sie im Feld googleads-shopping-samples/python/shopping/content/products/ erstellen Sie eine leere Datei my-insert.py. Fügen Sie den gesamten Code den folgenden Schritten auf diese 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. Eindeutige Produkt-ID festlegen und ein Wörterbuch mit dem Produkt erstellen Definition.

   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 erstellt ein Dienstobjekt für die Interaktion mit der Content API, ruft den aus der Konfigurationsdatei aus, erstellt die Anfrage und führt die Anfrage zum Ausführen des API-Aufrufs.

   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 und den API-Aufruf auszuführen, gehen Sie in einem Terminalfenster in googleads-shopping-samples/python/ 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: Produkt mit der Angebots-ID "offerId" wurde erstellt.

6. Um zu überprüfen, ob das Produkt erfolgreich hinzugefügt wurde, verwenden Sie den API Explorer für die products.list-Methode, um alle Produkte im Merchant Center zurückzugeben Konto.

   Im API Explorer für die Methode products.list, geben Sie 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 Händler verknüpft ist. Center-Konto.

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

Die Händler sind für die Einhaltung der Richtlinien für Shopping-Anzeigen anzeigen und kostenlos Richtlinien für Einträge. Google 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.