Para usar la API de Merchant de manera eficaz, es importante comprender los conceptos de registro, autenticación y autorización. Cumplen 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 API de Merchant utiliza mecanismos estándar de Google, como OAuth 2.0. Para obtener más información, consulta Autentica solicitudes y Autentícate 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 la pregunta: "¿Qué puedes hacer?" en función de los roles 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: En relación con la API de Merchant, este es un proceso de configuración único que permite que Google te envíe anuncios de servicio importantes para las cuentas de comerciante que administras. El registro agrega las direcciones de correo electrónico de tu 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 de servicio para todas las cuentas de comerciante que administras. Para obtener más información, consulta Crea un proyecto de Google Cloud.
Registro
El proceso de registro es fundamental para permitir que tu aplicación use la API de Merchant. Tenga en cuenta lo siguiente:
Requisitos previos
Para registrarte y usar la API de Merchant, debes cumplir con los siguientes requisitos:
- Cuenta de Merchant Center: Necesitas una cuenta de Merchant Center existente.
- Acceso de administrador: La Cuenta de Google de usuario que uses para iniciar la llamada de registro debe tener privilegios de administrador en la cuenta de Merchant Center que registres.
- Proyecto de Google Cloud: Tu aplicación debe estar asociada a 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 compartido de Google Cloud
Herramientas como Google OAuth Playground y APIs Explorer usan proyectos de Google Cloud compartidos y propiedad de Google. No puedes registrarte con proyectos compartidos por los siguientes motivos:
- Están diseñadas para pruebas y exploración, no para la identidad de la aplicación de producción.
- Registrarlas implicaría un vínculo entre la herramienta compartida y tus datos específicos de Merchant Center, y podría generar comunicaciones no deseadas.
Tu aplicación necesita su propio proyecto de Google Cloud exclusivo para que las comunicaciones de la API de Merchant que Google te envía sigan siendo relevantes para tu uso real.
Sin embargo, puedes usar las apps web de OAuth Playground y API Explorer para usar la API de Merchant en casos de uso experimentales y que no sean de producción.
Busca tu ID del proyecto de Google Cloud
Puedes encontrar tu ID del proyecto y tu número de proyecto en la consola de Google Cloud. Para obtener más detalles, consulta Cómo encontrar el nombre, el número y el ID del proyecto.
Realiza la llamada de registro
Regístrate con el método registerGcp dentro de la sub-API de Accounts. 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 a un usuario individual que uses 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 API de Merchant. 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 de un contacto técnico clave 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 uses alias de grupos generales ni correos electrónicos de cuentas de servicio. Las comunicaciones están dirigidas a personas.
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 accounts.users de la API de Merchant 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 Cómo administrar 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 el rol de
API_DEVELOPER: Además de los roles estándar (Administrador, Estándar), puedes asignar a los usuarios el rol deAPI_DEVELOPER. En particular, asigna este rol a los usuarios que deben recibir comunicaciones relacionadas con la API. Puedes combinarlo con otros roles. - 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 que administres los contactos de la API agregando usuarios con el rol de API_DEVELOPER.
Referencias
Para obtener más información, consulta lo siguiente: