Esegui una chiamata API

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

Per effettuare la prima chiamata, completa i seguenti passaggi:

  1. In googleads-shopping-samples/python/shopping/content/products/ crea un file my-insert.py vuoto. Aggiungi tutto il codice nella 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 il prodotto definizione di Kubernetes.

    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 genera un oggetto di servizio per interagire con l'API Content, ottiene la l'ID commerciante del 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, dalla finestra del terminale accedi in 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 al terminale: Prodotto con ID offerta "offerId" è stata creata.

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

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

    1. Inserisci il tuo merchantId.
    di Gemini Advanced.
    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 commerciante Account Center.

    Se il prodotto è stato aggiunto correttamente, i dati di prodotto vengono visualizzati nell'API. come explorer.

I commercianti sono tenuti a rispettare le annunci e senza costi relative alle schede. Google Shopping si riserva il diritto di applicare queste norme e di rispondere in modo appropriato se rileviamo contenuti o comportamenti che violano queste norme.