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 usuarios que llaman 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 arrow_forward

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 sa@project.iam.gserviceaccount.com, 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.