Para usar la Merchant API 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 Merchant API usa mecanismos estándar de Google como OAuth 2.0. No se admite el uso de claves de API para la autenticación, lo que genera errores de autenticación. 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 a la pregunta "¿Qué puedes hacer?" según los roles y 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 permite que Google te envíe 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 registras.
- 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 destinados a pruebas y exploración, no a la identidad de la aplicación de producción.
- Registrarlos 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 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 apps 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 el 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 Encuentra 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 el número de tu 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 empresarial de una persona.
- NO: Usa 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 el rol
API_DEVELOPER: Además de los roles estándar (Administrador, Estándar), puedes asignar a los usuarios el rolAPI_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 administrar los contactos de la API agregando usuarios con el rol API_DEVELOPER.
Referencias
Para obtener más información, consulta lo siguiente: