Esegui una chiamata API

Il repository googleads/googleads-shopping-samples su GitHub contiene codice campione per le operazioni comuni per ogni libreria client. Ad esempio, gli esempi in googleads-shopping-samples/python/shopping/content/products/ forniscono codice per operazioni comuni utilizzando la risorsa products con Python. In questa guida, inizi con un file vuoto e crei un esempio che inserisce un nuovo prodotto, in modo da poter vedere la struttura di base e i componenti richiesti delle applicazioni che si integrano con la Content API. Il risultato finale sarà simile all'esempio nel file di esempio products/insert.py. Puoi quindi utilizzare Explorer API per il metodo products.list per verificare che il prodotto sia stato aggiunto correttamente.

Per effettuare la prima chiamata, completa i seguenti passaggi:

1. Nella directory googleads-shopping-samples/python/shopping/content/products/, crea un file my-insert.py vuoto. Aggiungi tutto il codice nei passaggi seguenti a questo file.

2. Aggiungi le istruzioni di importazione per i moduli richiesti.

   All'inizio di my-insert.py, aggiungi il seguente codice:

   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. Definisci un ID prodotto univoco e crea un dizionario con la definizione del prodotto.

   Alla fine di my-insert.py, aggiungi il seguente codice:

   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. Crea una funzione che viene eseguita quando lo script viene eseguito dalla riga di comando. La funzione crea un oggetto servizio per interagire con l'API Content, recupera l'ID commerciante dal file di configurazione, crea la richiesta ed esegue la richiesta per effettuare la chiamata API.

   Alla fine di my-insert.py, aggiungi il seguente codice:

   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. Per eseguire lo script ed effettuare la chiamata API, da una finestra del terminale, vai a googleads-shopping-samples/python/ ed esegui:

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

   Se la chiamata ha avuto esito positivo, il servizio stampa il seguente messaggio nel terminale: È stato creato il prodotto con offerId "offerId".

6. Per verificare che il prodotto sia stato aggiunto correttamente, utilizza Explorer API per il metodo products.list per restituire tutti i prodotti nel tuo account Merchant Center.

   In Explorer API per il metodo products.list, inserisci i seguenti valori:

   1. Inserisci il tuo merchantId.
   1. Nella sezione Credenziali, seleziona OAuth 2.0 di Google e Chiave API.
   2. Fai clic sul pulsante Esegui.
   3. Se richiesto, accedi con l'Account Google associato al tuo account Merchant Center.

   Se il prodotto è stato aggiunto correttamente, i dati del prodotto vengono visualizzati nella risposta di Explorer API.

I commercianti sono responsabili del rispetto delle norme relative agli annunci Shopping e alle schede senza costi. Google Shopping si riserva il diritto di applicare queste norme e di rispondere in modo appropriato se rileva contenuti o comportamenti che le violano.