Realiza una llamada a la API

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

Para realizar tu primera llamada, completa los siguientes pasos:

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

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

   Al principio 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. Define un ID de producto único y crea un diccionario con la definición del producto.

   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 la secuencia de comandos se ejecute desde la línea de comandos. La función crea un objeto de servicio para interactuar con la API de Content, obtiene el ID del comercio del archivo de configuración, crea la solicitud y la ejecuta 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 ejecuta lo siguiente:

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

   Si la llamada se realizó correctamente, el servicio imprimirá el siguiente mensaje en la terminal: Se creó el producto con offerId "offerId".

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

   En el 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 es necesario, accede con la Cuenta de Google asociada a tu cuenta de Merchant Center.

   Si el producto se agregó correctamente, los datos del producto aparecerán en la respuesta del Explorador de APIs.

Los comercios son responsables de cumplir con las políticas de los anuncios de Shopping y las fichas gratuitas. Google Shopping se reserva el derecho de aplicar estas políticas y responder según corresponda si detectamos contenido o comportamientos que las infrinjan.