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, comienzas con un archivo vacío y compilas un ejemplo que inserta un producto nuevo para que puedas ver la estructura básica y los componentes necesarios 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 obligatorios.

    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 la API de Content, obtiene el ID del 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 ejecutar 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 el ID de oferta "offerId".

  6. Para verificar que el producto se haya agregado correctamente, usa el Explorador de APIs para el método products.list para mostrar todos los productos de tu cuenta de Merchant Center.

    En el Explorador de API del 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 anuncios de Shopping y de fichas gratuitas. Google Shopping se reserva el derecho de aplicar estas políticas y responder de manera adecuada si se detecta contenido o comportamientos que las infrinjan.

Anterior
Configura una biblioteca cliente
Siguiente
Explora la API de contenido