Realiza una llamada a la API

Nos gustaría presentar la versión beta de la API de Merchant. Es la nueva versión de Content API y el futuro.

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

Nota: En este ejemplo, se usa el módulo python/shopping/content/common.py para crear un objeto de servicio que controla la autenticación y proporciona una interfaz para realizar llamadas a Content API. El módulo common.py también incluye otros métodos útiles para operaciones comunes, como generar ID únicos, verificar si una cuenta es de varios clientes (MCA) y reintentar solicitudes.

Para realizar tu primera llamada, sigue estos pasos:

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

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. Define un ID del 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 se ejecute la secuencia de comandos desde la línea de comandos. La función construye un objeto de servicio para interactuar con Content API, obtiene el ID de comerciante del archivo de configuración, construye 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 imprime el siguiente mensaje en la terminal: Se creó el producto con el ID de oferta “offerId”.

6. Para verificar que el producto se agregó de forma correcta, usa el Explorador de APIs para el método products.list a fin de mostrar todos los productos en tu cuenta de Merchant Center.

   Nota: Es posible que pasen unos minutos después de que se complete la llamada a products.insert antes de que el producto esté disponible a través de products.list o en Merchant Center.

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

   1. Ingresa tu merchantId.
   Nota: Todos los demás parámetros de solicitud son opcionales.
   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 cuenta de Merchant Center.

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

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

Nota: De forma predeterminada, los productos nuevos que se insertan a través de Content API se agregan a un nuevo feed principal en Merchant Center. Si quieres obtener más información para usar diferentes tipos de feeds con Content API, consulta las Prácticas recomendadas.