Para analizar nuestros productos y brindar comentarios sobre ellos, únete al canal oficial de Discord de Google Ads en el servidor de la Comunidad de Publicidad y Medición de Google.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Cuando trabajas con la API de Google Ads, hay varios lugares en los que se usan direcciones de correo electrónico 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: Es el correo electrónico que aparece como contacto en el Centro de APIs de la IU de Google Ads.
Correo electrónico de la cuenta de la consola de Google Cloud: Es el correo electrónico que tiene acceso de administrador a la cuenta de la consola de Google Cloud que se usa para tu aplicación de OAuth 2.0.
Correos electrónicos de la cuenta de administrador de Google Ads: Son los correos electrónicos que tienen permisos de administrador en las cuentas de administrador de Google Ads a las que accedes a través de la API de Google Ads. Cuando generas un token de actualización para tu aplicación, por lo general, autenticas tu aplicación de la API de Google Ads con una de estas direcciones de correo electrónico.
Te recomendamos que uses alias de equipo compartidos para no perder el acceso a estas cuentas cuando los miembros individuales del equipo cambien de equipo o dejen la empresa.
El resto de esta guía explica cada uno de los correos electrónicos mencionados anteriormente y cómo puedes actualizarlos para usar un alias de equipo compartido en lugar de la dirección de correo electrónico de un usuario individual.
Correo electrónico de contacto de la API de Google Ads
El correo electrónico de contacto de la API de Google Ads es una dirección de correo electrónico que proporcionas cuando te registras en la API de Google Ads. Debes asegurarte de tener acceso a este alias y supervisar los correos electrónicos que se envían a esta dirección con regularidad. Google usa esta dirección de correo electrónico para comunicarse con tu equipo durante las revisiones de la API, las solicitudes de auditoría o las emergencias de producción que requieren atención inmediata. Usa un alias de equipo compartido como correo electrónico de contacto para asegurarte de que todo el equipo reciba estas notificaciones.
Sigue estos pasos para actualizar el correo electrónico de contacto de la API:
Haz clic en Administrador en la parte inferior izquierda de la pantalla.
En Configuración de la cuenta de administrador, haz clic en Centro de APIs.
En Detalles del desarrollador, anota el correo electrónico de contacto de la API. Haz clic en la flecha hacia abajo y edita el correo electrónico. Haz clic en Guardar.
Cuenta de la consola de Google Cloud
El proyecto de la Consola de APIs de Google contiene las credenciales de OAuth de tu aplicación y controla el acceso a la API de Google Ads. Para garantizar el acceso a esta cuenta, haz que un alias compartido sea el propietario de la cuenta.
Sigue estos pasos para actualizar el propietario del proyecto de la Consola de APIs de Google:
Selecciona tu proyecto en el menú desplegable de la esquina superior izquierda de la página.
En el menú de la izquierda, ve a IAM y administración > IAM.
Haz clic en el botón Otorgar acceso.
Ingresa la dirección de correo electrónico compartida en la sección Agregar principales.
Asigna el rol de Propietario.
Haga clic en el botón Guardar. 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 a una cuenta de administrador común y realizar llamadas a la API a todas las cuentas con las credenciales de la cuenta de administrador de nivel superior. En esta configuración, se dan las siguientes situaciones:
El desarrollador emite un token de actualización con las credenciales de un usuario que tiene acceso a la cuenta de administrador de Google Ads.
El desarrollador establece el encabezado login_customer_id como el ID de cliente de la cuenta de administrador de Google Ads y el encabezado customer_id como el ID de cliente de la cuenta a la que se realizan las llamadas a la API.
Un posible riesgo de esta configuración es que, si el usuario autorizado pierde el acceso a la cuenta de administrador de Google Ads, el token de actualización ya no será válido y fallarán todas las llamadas a la API. Para evitar esta situación, puedes invitar a un alias de correo electrónico compartido a administrar esta cuenta de administrador de Google Ads con los niveles de acceso adecuados.
Usa este alias de correo electrónico compartido para emitir el token de actualización para realizar llamadas a la API.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (UTC)"],[[["\u003cp\u003eWhen working with the Google Ads API, ensure continuous access by using shared team aliases for contact, access management, and authentication purposes instead of individual user emails.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Ads API contact email is used for crucial communications, update it to a shared alias to keep your team informed about API reviews, audit requests, and production emergencies.\u003c/p\u003e\n"],["\u003cp\u003eSafeguard your Google Cloud Console account by granting ownership to a shared team alias, ensuring access to your application's OAuth credentials and control over API access.\u003c/p\u003e\n"],["\u003cp\u003eFor managing multiple Google Ads accounts, link them under a manager account and grant access to a shared alias for refresh token generation and uninterrupted API functionality.\u003c/p\u003e\n"],["\u003cp\u003eRegularly monitor and update these email addresses and access levels to maintain seamless API operations and avoid disruptions caused by personnel changes.\u003c/p\u003e\n"]]],[],null,["# Shared aliases\n\nWhen working with the Google Ads API, there are multiple places where email addresses\nare used for contact and access management, the most important of which are the\nfollowing:\n\n- **Google Ads API contact email**: This is the email listed as the contact in the API Center of the Google Ads UI.\n- **Google Cloud Console account email**: This is the email that has administrator access to the Google Cloud Console account used for your OAuth 2.0 application.\n- **Google Ads manager account email(s)**: These are the emails that have administrator permissions on the manager Google Ads account(s) you access through the Google Ads API. When you generate a refresh token for your application, you usually authenticate your Google Ads API application with one of these emails.\n\nWe strongly recommend using shared team aliases so that you don't lose access to\nthese accounts when individual team members switch teams or leave the company.\nThe rest of this guide elaborates on each of the emails listed earlier and how\nyou can update it to use a shared team alias instead of an individual user's\nemail address.\n\nGoogle Ads API contact email\n----------------------------\n\nThe Google Ads API contact email is an email address you provide when signing up for\nthe Google Ads API. You should ensure access to this alias and monitor emails sent to\nthis address regularly. Google uses this email address to contact your team\nduring API reviews, audit requests, or production emergencies that require\nimmediate attention. Use a shared team alias as the contact email to ensure that\nthe whole team receives these notifications.\n\nFollow these steps to update the API contact email:\n\n1. Sign in to your Google Ads [Manager\n Account](//ads.google.com/home/tools/manager-accounts/).\n\n2. Click **Admin** at the bottom left of the screen.\n\n3. Under **Manager account settings** , click **API center**.\n\n4. Under **Developer details** , note the API contact email. Click the down arrow\n and edit the email. Click **Save**.\n\nGoogle Cloud Console account\n----------------------------\n\nThe **Google API Console** project contains your application's OAuth credentials\nand controls access to the Google Ads API. Ensure access to this account by making a\nshared alias the account owner.\n\nFollow these steps to update the Google API Console project's owner:\n\n- Sign in to [**Google API Console**](//console.developers.google.com).\n- Select your project from the drop-down menu on the top-left corner of the page.\n- Navigate to **IAM and admin \\\u003e IAM** from the left menu.\n- Click the **Grant Access** button.\n- Enter the shared email address under the **Add principals** section.\n- Assign the **Owner** role.\n- Click the **Save** button. Refer to the Cloud documentation to learn more about [granting and revoking access](//cloud.google.com/iam/docs/granting-changing-revoking-access#single-role).\n\nGoogle Ads manager account\n--------------------------\n\nA common method of managing accounts using the Google Ads API is to link all your\naccounts under a common manager account, and make API calls to all the accounts\nusing the top-most manager account's credentials. In this configuration:\n\n- The developer issues a refresh token using the credentials of a user who has access to the Google Ads manager account.\n- The developer sets the [`login_customer_id`](/google-ads/api/docs/get-started/select-account#user_access_login_customer_id_and_customer_id) header as the customer ID of the Google Ads manager account, and the `customer_id` header as the customer ID of the account to which API calls are made.\n\nOne potential risk of this setup is that if the authorized user loses access to\nthe Google Ads manager account, the refresh token is no longer valid and all API\ncalls fail. To avoid this scenario, you can invite a shared email alias to\nmanage this Google Ads manager account with the [appropriate access levels](//support.google.com/google-ads/answer/9978556).\nUse this shared email alias to issue the refresh token for making API calls."]]
