Realiza una llamada a la API

El repositorio googleads/googleads-shopping-samples de GitHub contiene código de muestra para operaciones comunes en 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 crearás un ejemplo que inserta un producto nuevo, de modo 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 del archivo de muestra products/insert.py. Luego, puedes usar el Explorador de API para que el método products.list verifique que el producto se haya agregado de forma correcta.

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 en 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. 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 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, obtener el ID del comercio del archivo de configuración, crear la solicitud y ejecutarla 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 ejecutar la llamada a la API, dirígete a googleads-shopping-samples/python/ y ejecuta lo siguiente desde una ventana de terminal:

    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 offerId “offerId”.

  6. A fin de verificar que el producto se haya agregado de forma correcta, usa el Explorador de API para el método products.list a fin de mostrar todos los productos de tu cuenta de Merchant Center.

    En el Explorador de API 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. Haga clic en el botón Execute.
    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 de productos aparecerán en la respuesta del explorador de API.

Los comercios son responsables de satisfacer las políticas de anuncios de Shopping y fichas gratuitas. Google Shopping se reserva el derecho de hacer cumplir estas políticas y responder de forma adecuada si encontramos contenido o comportamiento que las infrinja.