Realiza una llamada a la API

La página googleads/googleads-shopping-samples El repositorio en GitHub contiene código de muestra para operaciones comunes para cada cliente biblioteca. Por ejemplo, las muestras de googleads-shopping-samples/python/shopping/content/products/ proporcionan código. para operaciones comunes products recurso con Python. En esta guía, comenzarás con un archivo vacío y compilarás un ejemplo que inserta un nuevo producto, de manera que puedas ver la información los componentes necesarios de las aplicaciones que se integran con el Content API. El resultado final será similar al ejemplo de la products/insert.py de muestra. Luego, puedes usar Explorador de APIs para el método products.list a fin de verificar que el producto se agregó correctamente.

Para realizar tu primera llamada, sigue estos pasos:

1. En googleads-shopping-samples/python/shopping/content/products/ crea un archivo my-insert.py vacío. Agrega todo el código en el los siguientes pasos a este archivo.

2. Agrega las sentencias de importación para los módulos requeridos.

   Al comienzo de my-insert.py, agrega el siguiente código:

   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. Definir un ID del producto único y crear un diccionario con el producto definición.

   Al final de my-insert.py, agrega el siguiente código:

   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 función que se ejecute cuando se ejecute la secuencia de comandos desde la línea de comandos. El construye un objeto Service para interactuar con Content API, obtiene el ID del comerciante del archivo de configuración, construye la solicitud y lo ejecuta. la solicitud para realizar la llamada a la API.

   Al final de my-insert.py, agrega el siguiente código:

   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. Para ejecutar la secuencia de comandos y la llamada a la API, desde una ventana de terminal, navega a googleads-shopping-samples/python/ y ejecutar lo siguiente:

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

   Si la llamada se realizó correctamente, el servicio imprime el siguiente mensaje en la terminal: Producto con el ID de oferta "offerId" se creó.

6. Para verificar que el producto se agregó correctamente, usa el Explorador de APIs para El método products.list para devolver todos los productos de tu cuenta de Merchant Center de servicio predeterminada.

   En la Explorador de APIs para el método products.list, ingresa los siguientes valores:

   1. Ingresa tu merchantId.
   1. En la sección Credenciales, selecciona Google OAuth 2.0 y Clave de API.
   2. Haz clic en el botón Ejecutar.
   3. Si se te solicita, accede con la Cuenta de Google asociada a tu comercio Center.

   Si el producto se agregó correctamente, los datos del producto aparecerán en la API. del explorador.

Los comercios son responsables de cumplir con las Políticas de Shopping anuncios y gratis de fichas. Google Shopping se reserva el derecho de aplicar estas políticas y responder adecuadamente si detectamos contenido o comportamiento que infringe estas políticas.