Configura una biblioteca cliente

Te recomendamos que uses las bibliotecas cliente de la API de Google para configurar la API de Content for Shopping. En esta guía, se usan las bibliotecas cliente de la API de Content para Python como ejemplo, pero están disponibles para muchos lenguajes de programación populares y simplifican las 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 lenguajes, consulta el archivo README.md del lenguaje en el repositorio googleads/googleads-shopping-samples en GitHub.

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. Dentro de tu directorio principal, crea los siguientes directorios:

   ~/shopping-samples/content/

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ú que se encuentra en la parte superior de la página. Si aún no tienes uno, haz clic en Proyecto nuevo para crear uno.
   3. Si aún no habilitaste la Content API for Shopping para este proyecto, búscalo en la lista de las APIs de Google y habilítalo.
   4. Haz clic en el menú de navegación (☰) en la esquina superior izquierda, selecciona APIs y servicios y, luego, Credenciales.
   5. Para configurar una cuenta de servicio, selecciona Crear credenciales y, luego, Cuenta de servicio.
   6. Asigna un nombre a la nueva cuenta de servicio. Este también sirve como el 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, luego, sigue los pasos opcionales para otorgar acceso al proyecto y a los usuarios, y haz clic en Listo.
   7. Se te dirigirá a la página Cuentas de servicio, donde podrás acceder a tu nueva cuenta de servicio.

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 nueva clave se descarga automáticamente.

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

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

6. En tu 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 cuenta de servicio como la dirección de correo electrónico para el usuario nuevo.

   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 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 es necesario que esté en tu directorio principal ni en ~/shopping-samples/content/.

10. Si descargaste y descomprimiste el repositorio en lugar de clonarlo, cambia el nombre del directorio descomprimido a googleads-shopping-samples.

11. Para instalar las dependencias de muestra necesarias, en una ventana de la terminal, navega a googleads-shopping-samples/python/ y ejecuta lo siguiente:

    pip install -r requirements.txt
    

Ahora tienes configurada la biblioteca cliente de la API de Google para Python 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.