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 emisor tiene permiso para realizar. Por ejemplo, algunos emisores podrían 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 pertenece a una serie de varias partes sobre cómo comenzar a usar la API de Merchant. Si ya tienes configurada la autenticación con la API de Merchant, puedes pasar a la siguiente sección: Registrarse 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 en 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 la respuesta es sí, usa la autorización OAuth 2.0. Elige la autorización de OAuth 2.0 en los siguientes casos:
- Eres un proveedor o una agencia externos: Estás creando una aplicación, como una plataforma SaaS, que usarán otras empresas para administrar sus propios datos de Merchant Center.
- Necesitas administrar muchas cuentas externas: Quieres que una sola aplicación funcione en varias cuentas de Merchant Center independientes que pertenecen a diferentes clientes. Para otorgar permisos, tus clientes deben acceder a sus propias Cuentas de Google y hacer clic en "Permitir" en una pantalla de consentimiento.
¿Estás creando una app para tu propia empresa?
Si la respuesta es sí, 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 propia empresa para administrar tus propios datos de Merchant Center o quieres 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 automáticas de inventario o trabajos "cron".
Autorización OAuth 2.0
Si eres un proveedor o una agencia externos que administran 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:
- Crea credenciales de OAuth 2.0 en APIs y servicios en tu consola de Google Cloud.
- Descarga las credenciales de cliente de OAuth2 en el archivo, como
client-secrets.json. - 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 el Merchant Center. Consulta Cómo agregar o quitar un usuario de Merchant Center para obtener más detalles.
- Asigna el rol
Adminpara realizar el registro. Si quieres obtener más información sobre los roles, consulta Administra personas y niveles de acceso en Merchant Center - Configura la autenticación con ejemplos de código: Sigue las instrucciones de la sección de documentación Configuración de la autenticación y configuración de muestra de los ejemplos de código oficiales.
Si quieres obtener más información sobre la autorización OAuth 2.0, consulta Autoriza el acceso de apps externas a la cuenta de Merchant Center y Usa 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 cuenta de servicio para la API de Merchant:
- Crea credenciales de cuenta de servicio en APIs y servicios en tu consola de Google Cloud.
- Descarga la clave privada: Crea y descarga la clave privada en formato JSON
para la cuenta de servicio. Cambia el nombre del archivo por
service-account.json. - 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 Merchant Center. Consulta Cómo agregar o quitar un usuario de Merchant Center para obtener más detalles. - Asigna acceso
Admin. Si quieres obtener más información sobre los niveles de acceso, consulta Administra personas y niveles de acceso en Merchant Center - Configura la autenticación con ejemplos de código: Sigue las instrucciones de la sección de documentación Configuración de la autenticación y configuración de muestra de los ejemplos de código oficiales.
Si quieres obtener más información sobre la autorización de cuenta de servicio, consulta Autoriza el acceso a tu cuenta de Merchant Center y Descripción general de las cuentas de servicio.