Para usar la Merchant API de manera eficaz, es importante comprender los conceptos de registro, autenticación y autorización. Estos conceptos tienen propósitos distintos para garantizar el acceso seguro y correcto a los datos de Merchant Center.
Terminología
El registro, la autenticación y la autorización están relacionados, pero cada uno tiene un significado y un propósito distintos.
- Autenticación: En este proceso, el servicio verifica la identidad del usuario o la aplicación que realiza una solicitud a la API. La Merchant API usa mecanismos estándar de Google como OAuth 2.0. Para obtener más información, consulta Autentica solicitudes y Autentica como tu propia cuenta.
- Autorización: Este proceso determina qué acciones puede realizar el usuario o la aplicación autenticados con una cuenta de Merchant Center. Responde a la pregunta "¿Qué puedes hacer?" en función de las funciones y los permisos otorgados al usuario autenticado dentro de la cuenta de Merchant Center. Por ejemplo, un usuario puede estar autorizado para leer datos de productos, pero no para modificar la configuración de la cuenta.
- Registro: Con respecto a la Merchant API, este es un proceso de configuración único que le permite a Google enviarte anuncios importantes del servicio para las cuentas de comerciante que administras. El registro agrega tus direcciones de correo electrónico de desarrollador a tu cuenta principal de Merchant Center y la vincula a los IDs de proyectos de Google Cloud que usas para la autenticación. Esta vinculación permite que tu aplicación reciba anuncios del servicio para todas las cuentas de comerciante que administras. Para obtener más información, consulta Crea un proyecto de Google Cloud Project.
Registro
El proceso de registro es fundamental para permitir que tu aplicación use la Merchant API. así que sigue leyendo para obtener toda la información:
Requisitos previos
Para registrarte y usar la Merchant API, debes cumplir con los siguientes requisitos:
- Cuenta de Merchant Center: Debes tener una cuenta de Merchant Center.
- Acceso de administrador: La cuenta de usuario de Google que usas para iniciar la llamada de registro debe tener privilegios de administrador en la cuenta de Merchant Center que estás registrando.
- Proyecto de Google Cloud: Tu aplicación debe estar asociada con un proyecto de Google Cloud. Este proyecto proporciona las credenciales necesarias (como los IDs de cliente de OAuth 2.0) para que tu aplicación se autentique.
Por qué no puedes registrar un proyecto de Google Cloud compartido
Las herramientas como Google OAuth Playground y el Explorador de APIs usan proyectos de Google Cloud compartidos que son propiedad de Google. No puedes registrarte con proyectos compartidos por los siguientes motivos:
- Están diseñados para pruebas y exploración, no para la identidad de la aplicación de producción.
- Si los registras, se implicaría un vínculo entre la herramienta compartida y tus datos específicos de Merchant Center, lo que podría generar comunicaciones no deseadas.
Tu aplicación necesita su propio proyecto de Google Cloud dedicado para que las comunicaciones de la Merchant API que te envía Google sigan siendo relevantes para tu uso real.
Sin embargo, puedes usar las aplicaciones web de OAuth Playground y el Explorador de APIs para usar la Merchant API en casos de uso de experimentación y no producción.
Busca tu ID del proyecto de Google Cloud
Puedes encontrar el ID del proyecto y el número del proyecto en la consola de Google Cloud. Para obtener más detalles, consulta Busca el nombre, el número y el ID del proyecto.
Realiza la llamada de registro
Regístrate con el
registerGcp
método dentro de la Accounts sub-API. Esta llamada asocia tu número de proyecto de Google Cloud con la cuenta de Merchant Center.
Durante el proceso, debes proporcionar una dirección de correo electrónico asociada con un usuario individual que usas para llamar a la API. Este correo electrónico debe pertenecer a un usuario con acceso de administrador a la cuenta de Merchant Center.
Acerca del campo de correo electrónico
La comunicación eficaz es clave. Google envía actualizaciones importantes, anuncios obligatorios del servicio (MSA), encuestas para desarrolladores y otras oportunidades relacionadas con la Merchant API. La administración adecuada de los contactos garantiza que estos lleguen a las personas correctas.
- Propósito: Google usa esta dirección de correo electrónico como contacto principal para las comunicaciones relacionadas con la API.
- Correo electrónico de quién: Debe ser la dirección de correo electrónico de un desarrollador individual o un contacto técnico clave que sea responsable de la integración de la API.
- Prácticas recomendadas:
- SÍ: Usa la dirección de correo electrónico corporativa de una persona.
- NO: No uses alias de grupos generales ni correos electrónicos de cuentas de servicio. Las comunicaciones están destinadas a destinatarios humanos.
El recurso users para la administración de contactos
Si bien la dirección de correo electrónico en la llamada de registro establece un contacto inicial, la
forma más sólida de administrar contactos y permisos es usar el recurso de la Merchant API
accounts.users
o la configuración de administración de usuarios en la IU de Merchant Center. Para obtener más
información sobre el uso de Merchant Center, consulta
Administra personas en tu cuenta.
Aprovecha estas funciones de la siguiente manera:
- Agrega a todos los desarrolladores: Agrega a los desarrolladores que trabajan en la integración de la API como usuarios de la cuenta de Merchant Center.
- Asigna la función
API_DEVELOPER: Además de las funciones estándar (Administrador, Estándar), puedes asignar a los usuarios la funciónAPI_DEVELOPER. En particular, asigna esta función a los usuarios que deben recibir comunicaciones relacionadas con la API. Puedes combinarla con otras funciones. - Beneficios:
- Separación clara: Desvincula la administración de contactos de la API del registro único.
- Flexibilidad: Actualiza los contactos a medida que cambian los miembros del equipo.
- Comunicación segmentada: Garantiza que las noticias específicas de la API lleguen a las personas pertinentes.
Incluso si proporcionaste una dirección de correo electrónico durante el registro, te recomendamos administrar los contactos de la API agregando usuarios con la función API_DEVELOPER.
Referencias
Para obtener más información, consulta lo siguiente: