Cuando trabajas con la API de Google Ads, las direcciones de correo electrónico se usan en varios lugares para la administración de contactos y accesos. Los más importantes son los siguientes:
- Correo electrónico de contacto de la API de Google Ads: Son las direcciones de correo electrónico a las que se les asignó el rol de propietario o editor en tu proyecto de Google Cloud, que Google utiliza para enviar anuncios obligatorios del servicio (MSA) y notificaciones administrativas.
- Correo electrónico de la cuenta de la consola de Google Cloud: Es el correo electrónico que tiene acceso de administrador al proyecto de Google Cloud que se usa para tu aplicación de OAuth 2.0.
- Acceso a la cuenta de administrador de Google Ads: Es la cuenta de servicio (recomendado) o el alias de correo electrónico compartido que tiene permisos de acceso en las cuentas de administrador de Google Ads a las que se accede a través de la API de Google Ads.
En el resto de esta guía, se detallan cada una de las cuentas mencionadas anteriormente y cómo puedes configurarlas para que tu integración no dependa de la dirección de correo electrónico de un usuario individual.
Correo electrónico de contacto de la API de Google Ads
Google envía notificaciones administrativas, actualizaciones de revisión de la API, solicitudes de auditoría, anuncios obligatorios del servicio (MSA) y comunicaciones de emergencia de producción a las direcciones de correo electrónico asociadas con los roles de propietario y editor de tu proyecto de Google Cloud (consulta Nuevos correos electrónicos de contacto de la API, ya que se retiró el parámetro de configuración heredado del correo electrónico de contacto del Centro de API en la IU de Google Ads).
Para actualizar tu correo electrónico de contacto y asegurarte de que todo tu equipo reciba estas notificaciones, otorga el rol de Propietario o Editor a un alias de equipo compartido en tu proyecto de Google Cloud y supervisa los correos electrónicos que se envían a ese alias con regularidad.
Cuenta de la consola de Google Cloud
El proyecto de la consola de Google Cloud contiene las credenciales de OAuth de tu aplicación y controla el acceso a la API de Google Ads. Para garantizar el acceso a este proyecto, otorga el rol de Propietario (o Editor) a un alias de equipo compartido.
Sigue estos pasos para agregar un alias compartido como propietario de un proyecto de Google Cloud:
- Accede a la consola de Google Cloud.
- Selecciona tu proyecto en el selector de proyectos que se encuentra en la parte superior de la página.
- En el menú de navegación, ve a IAM y administración > IAM.
- Haz clic en Otorgar acceso.
- En la sección Agregar principales, ingresa la dirección de correo electrónico compartida en el campo Principales nuevas.
- En la sección Asignar roles, haz clic en Selecciona un rol y elige Básico > Propietario (o Básico > Editor).
- Haz clic en Guardar. Si otorgaste el rol de propietario a una dirección de correo electrónico fuera de tu organización de Google Cloud (o en un proyecto sin una organización), Google Cloud envía un correo electrónico de invitación al alias compartido que se debe aceptar antes de que el rol entre en vigencia. Consulta la documentación de Cloud para obtener más información sobre cómo otorgar y revocar el acceso.
cuenta de administrador de Google Ads
Un método común para administrar cuentas con la API de Google Ads es vincular todas tus cuentas en una cuenta de administrador común y realizar llamadas a la API para todas las cuentas con las credenciales de la cuenta de administrador de nivel superior. En esta configuración, el desarrollador establece el encabezado de la solicitud login-customer-id (o el parámetro de configuración de la biblioteca cliente login_customer_id) en el ID de cliente de 10 dígitos (sin guiones) de la cuenta de administrador de Google Ads y establece el customer_id de destino en la cuenta operativa en la que se realizan las llamadas a la API.
Recomendado: Usa una cuenta de servicio
El uso de una cuenta de servicio es el enfoque preferido para autenticar y acceder a una cuenta de administrador de Google Ads. A diferencia de las cuentas de usuario individuales, las cuentas de servicio se administran en tu proyecto de Google Cloud y no están vinculadas a una persona específica, lo que evita interrupciones cuando los miembros del equipo cambian de rol o dejan la empresa. Sigue la guía de cuentas de servicio para crear una cuenta de servicio y otorgarle acceso a tu cuenta de administrador de Google Ads.
Alternativa: Usa un alias de correo electrónico compartido
Si tu integración no puede usar una cuenta de servicio y, en su lugar, depende del flujo de trabajo de autenticación de un solo usuario, un usuario con acceso a la cuenta de administrador de Google Ads emite un token de actualización de OAuth 2.0.
Para evitar esta situación cuando uses credenciales de usuario, haz lo siguiente:
- Invita a un alias de correo electrónico compartido (respaldado por una Cuenta de Google activa con la verificación con llave de acceso habilitada) para administrar esta cuenta de administrador de Google Ads con los niveles de acceso adecuados.
- Acepta la invitación con el alias de correo electrónico compartido.
- Usa este alias de correo electrónico compartido para emitir el token de actualización de OAuth y realizar llamadas a la API.