Esegui una chiamata API

Il repository googleads/googleads-shopping-samples su GitHub contiene codice di esempio 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 che utilizzano la risorsa products con Python. In questa guida, inizierai con un file vuoto e creerai un esempio che inserisce un nuovo prodotto, in modo da poter vedere la struttura di base e i componenti richiesti delle applicazioni integrate 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, segui questi passaggi:

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

  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.

    Al termine 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 di 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 all'API.

    Al termine 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 eseguire 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 sul terminale: È stato creato il prodotto con offerId "offerId".

  6. Per verificare che il prodotto sia stato aggiunto correttamente, utilizza l'esploratore 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 Google OAuth 2.0 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 dell'esploratore API.

I commercianti sono responsabili della conformità alle 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 vengono rilevati contenuti o comportamenti che violano queste norme.