Configura una biblioteca cliente

Conoce la API de Merchant (beta), el sucesor oficial de Content API for Shopping.

Obtén las últimas novedades sobre las funciones nuevas, las correcciones de errores y las actualizaciones de lanzamiento de la API de Merchant (beta).

Aprende a administrar tu empresa y tus productos en Google, y a obtener acceso programático a datos, estadísticas y funciones únicas a gran escala. Comienza ahora

Te recomendamos usar las bibliotecas cliente de la API de Google para configurar la API de contenido para Shopping. En esta guía, se usan las bibliotecas cliente de la API de Content de Python como ejemplo, pero están disponibles para muchos lenguajes de programación populares y simplifican tareas comunes de la API, como la autenticación, el envío de solicitudes y el análisis de respuestas. Si necesitas ayuda para configurar bibliotecas cliente para otros idiomas, consulta el archivo README.md del idioma en el repositorio googleads/googleads-shopping-samples en GitHub.

Nota: Debes instalar varias bibliotecas obligatorias para usar el código de muestra en Python. Por este motivo, te recomendamos que crees un entorno virtual de Python antes de continuar. Para obtener más información, consulta Cómo instalar paquetes con pip y entornos virtuales.

Para configurar la biblioteca cliente de la API de Google para Python, completa los siguientes pasos:

1. Crea un directorio para los archivos de configuración y autenticación de la biblioteca cliente. En el directorio principal, crea los siguientes directorios:

   ~/shopping-samples/content/

   Nota: Esta ruta de acceso, así como el nombre del archivo merchant-info.json que se creó en el paso 5, se definen en el archivo python/shopping/content/common.py dentro del directorio de muestras de Content API que se descargó en el paso 7.

2. Para descargar las credenciales de tu cuenta de servicio, completa los siguientes pasos:

   1. Ve a la biblioteca de la API de Google.
   2. Selecciona un proyecto en el menú de la parte superior de la página. Si aún no tienes uno, haz clic en New project para crear uno.
   3. Si aún no habilitaste Content API for Shopping para este proyecto, búscala en la lista de APIs de Google y habilítala.
   4. En la barra lateral izquierda, selecciona Credenciales. Es posible que debas hacer clic en la flecha que apunta hacia la izquierda en la parte superior izquierda para ver esta opción.
   5. Para configurar una cuenta de servicio, selecciona Crear credenciales y, luego, Cuenta de servicio.
   6. Asigna un nombre a la cuenta de servicio nueva. Esto también sirve como nombre de usuario predeterminado para el ID de la cuenta de servicio. Registra el ID de la cuenta de servicio, incluida la parte después del carácter "@", para usarlo más adelante. Haz clic en Crear y, luego, sigue los pasos opcionales para otorgar acceso al proyecto y a los usuarios. Haz clic en Listo.
   7. Se te dirigirá a la página Cuentas de servicio, en la que podrás acceder a tu cuenta de servicio nueva.

3. Para obtener una clave privada JSON, haz clic en la cuenta de servicio y, luego, en la pestaña Claves. Haz clic en Agregar clave > Crear clave nueva y, luego, selecciona JSON como el tipo de clave. Haz clic en Crear para descargar la clave privada en tu computadora. La clave nueva se descarga automáticamente.

4. Cambia el nombre del archivo de credenciales descargado a service-account.json.

   Nota: Este nombre de archivo se define en el archivo _constants.py, que se encuentra en python/shopping/content/ dentro del directorio de muestras de la API de Content que descargaste en el paso 7.

5. Mueve el archivo service-account.json a home directory/shopping-samples/content/.

6. En home directory/shopping-samples/content/, crea un archivo merchant-info.json vacío.

7. En merchant-info.json, agrega el siguiente texto:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. Agrega la nueva cuenta de servicio como usuario a tu cuenta de Merchant Center. Si eres desarrollador externo, deberás pedirle a tu cliente que realice este paso por ti.

   1. Ve a tu cuenta de Merchant Center.
   2. En la configuración de tu cuenta de Merchant Center, selecciona Personas y acceso.

   3. Haz clic en + Agregar persona y usa el ID de la cuenta de servicio como la dirección de correo electrónico del usuario nuevo.

      Nota: Si no tomaste nota del ID de la cuenta de servicio antes, ve a la página de administración de cuentas de servicio y selecciona el proyecto que creaste.

   4. El uso del servicio Accounts requiere acceso de administrador, por lo que debes seleccionar Administrador.

   5. Haz clic en Agregar usuario para guardar las preferencias y volver a la lista de usuarios. El ID de la cuenta de servicio aparece en la lista con el rol de usuario elegido.

   6. Repite el proceso para todas las demás cuentas de servicio que quieras agregar.

9. Clona (o descarga y descomprime) el repositorio de GitHub googleads/googleads-shopping-samples en cualquier ubicación de tu computadora. No tiene que estar en el directorio principal ni en ~/shopping-samples/content/.

10. Si descargaste y descomprimiste el repositorio, en lugar de clonarlo, cámbiale el nombre al directorio descomprimido a googleads-shopping-samples.

11. Para instalar las dependencias de muestra requeridas, en una ventana de terminal, navigate to googleads-shopping-samples/python/ y ejecuta lo siguiente:

    pip install -r requirements.txt
    

Ahora tienes la biblioteca cliente de la API de Google para Python configurada y lista para usar con la API de Content. En la siguiente sección, crearás y enviarás una solicitud para insertar un producto nuevo.