Configura una biblioteca cliente

Te recomendamos que utilices Bibliotecas cliente de la API de Google para configurar la Content API for Shopping. En esta guía, se usa el cliente de Content API de Python como bibliotecas de ejemplo, pero que están disponibles para muchas aplicaciones lenguajes de programación y simplifican las tareas comunes de la API, como la autenticación, el envío de solicitudes, y analizar respuestas. Para obtener ayuda con la configuración de bibliotecas cliente otros lenguajes, consulta el archivo README.md para el lenguaje dentro de googleads/googleads-shopping-samples repo en GitHub.

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

1. Crea un directorio para la configuración y la autenticación de la biblioteca cliente archivos. En 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ú de la parte superior de la página. Si no tienes una Sin embargo, haz clic en Proyecto nuevo para crear uno.
   3. Si aún no habilitaste Content API for Shopping, haz lo siguiente: de la API de Google, búscalo en la lista de APIs de Google y habilítalo.
   4. En la barra lateral izquierda, selecciona Credenciales. Es posible que debas hacer clic la flecha que apunta a la izquierda en la parte superior izquierda para ver esto.
   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 de la "@" para usar más adelante. Haz clic en Crear y, luego, los pasos opcionales para otorgar acceso al proyecto y a los usuarios, y haz clic Listo.
   7. Se te redireccionará a la página Cuentas de servicio, en la que se encuentra el acceso a la 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 > Crea una clave nueva y, luego, selecciona JSON como tipo de clave. Haz clic en Crear para descargar la clave privada en tu computadora. La clave nueva se descargará 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 archivo 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 cuenta de servicio nueva como usuario a tu cuenta de Merchant Center. Si Si eres un desarrollador externo, deberás pedirle al cliente que complete 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 para el usuario nuevo.

   4. El uso del servicio Accounts requiere acceso de administrador; por lo tanto, selecciona 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 del usuario elegido.

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

9. Clona (o descarga y descomprime) el googleads/googleads-shopping-samples Repositorio de GitHub en cualquier ubicación de tu computadora; no tiene que estar en tu o en ~/shopping-samples/content/.

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

11. Para instalar las dependencias de muestra requeridas, en una ventana de terminal, haz lo siguiente: Navegue a googleads-shopping-samples/python/ y ejecute lo siguiente:

    pip install -r requirements.txt
    

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