Esegui una chiamata API

Il repository googleads/googleads-shopping-samples su GitHub contiene un codice campione per le operazioni comuni per ciascuna 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, 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 l'API Content. Il risultato finale sarà simile all'esempio nel file di esempio products/insert.py. Potrai 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 da eseguire quando lo script viene eseguito dalla riga di comando. La funzione genera un oggetto di servizio per interagire con l'API Content, ottiene l'ID commerciante dal file di configurazione, crea la richiesta ed esegue la richiesta di 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 a googleads-shopping-samples/python/ da una 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 nel terminale: È stato creato un prodotto con ID offerta "offerId".

  6. Per verificare che il prodotto sia stato aggiunto correttamente, utilizza Explorer API per il metodo products.list in modo da 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 dell'explorer API.

I commercianti sono tenuti a rispettare le 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 individuiamo contenuti o comportamenti che violano queste norme.

Indietro
Configurare una libreria client
Avanti
Esplora la Content API