Esegui una chiamata API

Il repository googleads/googleads-shopping-samples su GitHub contiene il codice campione per le operazioni comuni di ciascuna 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 vedere la struttura di base e i componenti richiesti delle applicazioni che si integrano con 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, procedi nel seguente modo:

  1. Nella directory googleads-shopping-samples/python/shopping/content/products/, crea un file my-insert.py vuoto. Aggiungi tutto il codice nei seguenti passaggi 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. Creare una funzione che viene eseguita quando lo script viene eseguito dalla riga di comando. La funzione costruisce un oggetto di servizio per interagire con la Content API, recupera l'ID commerciante dal file di configurazione, crea la richiesta e la esegue 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 eseguire la chiamata API, vai alla pagina googleads-shopping-samples/python/ dalla finestra del terminale ed esegui:

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

    Se la chiamata ha avuto esito positivo, il servizio stampa il seguente messaggio al terminale: Il prodotto con ID offerta "offerId" è stato creato.

  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 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 di 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 violano queste norme.

Indietro
Configurare una libreria client
Avanti
Esplora la Content API