Configura la autenticación para la API de Merchant

Para garantizar la seguridad de los datos, aplicar el control de acceso y mantener la integridad del sistema, debes autenticar todas las solicitudes a la API de Merchant. La API usa la identidad autenticada para determinar las acciones que el llamador tiene permiso para realizar. Por ejemplo, algunos llamadores pueden tener acceso de solo lectura a los datos de productos, mientras que otros pueden modificar la configuración de la cuenta en Merchant Center.

Este documento forma parte de una serie de varias partes sobre cómo comenzar a usar la API de Merchant. Si ya configuraste la autenticación con la API de Merchant, puedes pasar a la siguiente sección: Regístrate como desarrollador

Autoriza solicitudes a la API de Merchant

Cada solicitud que se envía a la API de Merchant debe incluir un token de autorización para identificar tu aplicación ante Google. Para configurar la autenticación y la autorización, decide el caso de uso que mejor describa la forma en que planeas trabajar con la API de Merchant:

¿Estás creando una aplicación para que la usen otras empresas?

Si es así, usa la autorización de OAuth 2.0. Elige la autorización OAuth 2.0 en los siguientes casos:

• Eres un proveedor o una agencia externos: Estás creando una aplicación, como una plataforma de SaaS, que otras empresas usarán para administrar sus propios datos de Merchant Center.
• Necesitas administrar muchas cuentas externas: Quieres que una sola aplicación funcione en varias cuentas independientes de Merchant Center que pertenecen a diferentes clientes. Tus clientes otorgan permisos accediendo a sus propias Cuentas de Google y haciendo clic en "Permitir" en una pantalla de consentimiento.

¿Estás creando una app para tu propia empresa?

Si es así, usa una autorización de cuenta de servicio para obtener acceso a la API de Merchant. Elige una autorización de cuenta de servicio en los siguientes casos:

• Estás creando tu propia aplicación interna: Estás desarrollando una herramienta específicamente para tu empresa para administrar tus propios datos de Merchant Center, o bien deseas que las credenciales pertenezcan a la aplicación en sí en lugar de a un usuario individual específico.
• Necesitas automatización sin acceso humano: Tu aplicación ejecuta tareas en segundo plano, como actualizaciones de inventario automatizadas o trabajos "cron".

Autorización OAuth 2.0

Si eres un proveedor externo o una agencia que administra varias cuentas de clientes, tu aplicación debe usar OAuth 2.0 para autorizar solicitudes. Sigue estos pasos para configurar OAuth 2.0 para la API de Merchant:

1. Crea credenciales de OAuth 2.0 en APIs and Services en tu consola de Google Cloud.
2. Descarga las credenciales de cliente de OAuth2 en el archivo, como client-secrets.json
3. Agrega la cuenta de correo electrónico como usuario a Merchant Center: Asegúrate de que la Cuenta de Google que usas para autorizar solicitudes exista como usuario en Merchant Center. Consulta Cómo agregar o quitar un usuario de Merchant Center para obtener más detalles.
4. Asigna el rol Admin para realizar el registro. Para obtener más información sobre los roles, consulta Administra personas y niveles de acceso en Merchant Center.
5. Configura la autenticación con muestras de código: Sigue las instrucciones de la sección de documentación sobre la configuración de la autenticación y la configuración de muestra de las muestras de código oficiales.

Si deseas obtener más información sobre la autorización de OAuth 2.0, consulta Cómo autorizar el acceso de apps de terceros a la cuenta de Merchant Center y Cómo usar OAuth 2.0 para acceder a las APIs de Google.

Autorización de cuenta de servicio

Usas una cuenta de servicio para autorizar el acceso a la API de Merchant a tu propia cuenta de Merchant Center. Sigue estos pasos para configurar la autorización de la cuenta de servicio para la API de Merchant:

1. Crea credenciales de cuenta de servicio en APIs and Services en tu consola de Google Cloud
2. Descarga la clave privada: Crea y descarga la clave privada en formato JSON para la cuenta de servicio. Cambia el nombre del archivo a service-account.json.
3. Agrega la cuenta de servicio a Merchant Center: Copia la dirección de correo electrónico única de la cuenta de servicio, como [e-mail], y agrégala como un usuario nuevo en tu cuenta de Merchant Center. Consulta Cómo agregar o quitar un usuario de Merchant Center para obtener más detalles.
4. Asigna acceso de Admin. Para obtener más información sobre los niveles de acceso, consulta Administra personas y niveles de acceso en Merchant Center
5. Configura la autenticación con muestras de código: Sigue las instrucciones de la sección de documentación sobre la configuración de la autenticación y la configuración de muestra de las muestras de código oficiales.

Para obtener más información sobre la autorización de cuentas de servicio, consulta Autoriza el acceso a tu cuenta de Merchant Center y Descripción general de las cuentas de servicio.