El token de desarrollador es una cadena alfanumérica de 22 caracteres que se usaba para conectar tu app a la API de Google Ads. Los tokens de desarrollador dejaron de estar disponibles el 9 de septiembre de 2026. En esta guía, se resumen los cambios y se enumeran las preguntas frecuentes sobre esta migración para ayudar a los desarrolladores existentes.
¿Cuáles son los cambios?
Como parte de la desactivación de los tokens de desarrollador, presentamos varios cambios en la experiencia de incorporación a la API de Google Ads y en la administración del acceso a la API. En esta sección, se destacan los cambios clave.
Los niveles de acceso a la API están asociados con proyectos de Google Cloud
Desactivamos los tokens de desarrollador el 9 de septiembre de 2026. Tu nivel de acceso actual y activo del token de desarrollador se transfirió automáticamente a tus proyectos de Google Cloud en función de la actividad reciente de la API. Puedes seguir enviando tokens de desarrollador en los encabezados de tus llamadas a la API, pero esto es opcional y los servidores de la API lo ignoran. Tu código existente seguirá funcionando sin cambios. Tus niveles de acceso a la API ahora están determinados por el proyecto de Google Cloud que usaste para generar tus credenciales de OAuth.
- Si tu app usa el flujo de trabajo de autenticación de usuarios, este es el proyecto que posee tu ID de cliente y secreto de OAuth.
- Si usas el flujo de trabajo de la cuenta de servicio, este es el proyecto que posee tu cuenta de servicio.
Una nueva experiencia de registro para la API de Google Ads
Ahora puedes registrarte para acceder a la API de Google Ads directamente en la consola de Google Cloud sin necesidad de tener una cuenta de administrador de Google Ads. No te registres para obtener un token de desarrollador en la página del Centro de APIs ni intentes solicitar acceso a la API desde la página del Centro de APIs en tu cuenta de administrador de Google Ads, ya que estos procesos se transfirieron a la consola de Google Cloud y no se procesarán si se inician desde la página del Centro de APIs.
Una nueva experiencia de administración del acceso a la API
Desactivamos todas las funciones nuevas de registro y administración del acceso a la API, como solicitar acceso a la API y administrar los niveles de acceso a la API en la página del Centro de APIs de las cuentas de administrador de Google Ads. Estas funciones ahora están disponibles en la página Descripción general de la API de Google Ads en la consola de Google Cloud.
Aún puedes acceder a la página del Centro de APIs para consultar los detalles históricos de tu desarrollador. Esta página dejará de estar disponible por completo en el futuro.
Nuevos códigos de error
La versión v25 de la API de Google Ads mostrará un CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION error si intentas usar un proyecto de Google Cloud con el nivel de acceso a la cuenta de prueba para realizar llamadas a una cuenta de producción. Las versiones anteriores de la API mostrarán un ACTION_NOT_PERMITTED error en su lugar. Si te encuentras con este error, navega a la página Descripción general de la API de Google Ads de tu proyecto de Google Cloud y solicita acceso de explorador.
Se requiere la verificación de marca para el acceso básico y estándar
Para las nuevas solicitudes de acceso básico y estándar, debes completar la verificación de marca de tu proyecto de Google Cloud. Los titulares de acceso existentes no están obligados a completar la verificación de marca, aunque se recomienda hacerlo.
Las solicitudes de acceso básico ahora son automáticas y se revisarán en cuestión de minutos después de la verificación y el envío de la marca.
Debido a estas actualizaciones de procesos, se cerrarán todas las solicitudes de acceso básico a la API pendientes como parte de esta transición. Los solicitantes afectados recibirán un correo electrónico con detalles y deberán volver a solicitar acceso a la API desde la página Descripción general de la API de Google Ads.
Nuevos correos electrónicos de contacto de la API
Mientras nos preparamos para dar de baja la página del Centro de APIs, haremos la transición para usar la lista de usuarios propietarios y editores de tu proyecto de Google Cloud como el único canal para las comunicaciones administrativas y de cumplimiento obligatorio. Para garantizar una transición sin problemas, seguiremos enviando temporalmente anuncios de servicio obligatorios (MSA) a la dirección de correo electrónico que aparece en tu Centro de APIs. Te mantendremos al tanto a medida que finalicemos la transición de nuestros canales de comunicación.
Qué hacer si eres un desarrollador existente
Revisa los niveles de acceso a la API de tu proyecto de Google Cloud: Si eres un desarrollador existente, te recomendamos que revises la página Descripción general de la API de Google Ads de tus proyectos de Google Cloud para asegurarte de que tengan el mismo nivel de acceso a la API que tu token de desarrollador existente. Sigue las instrucciones de esta guía para abordar cualquier discrepancia que encuentres.
Revisa tu dirección de correo electrónico de contacto de la API: Visita la página IAM (Identity and Access Management) de tu proyecto de Google Cloud. Verifica que a tus desarrolladores y administradores de cuentas de Google Ads activos se les asignen las funciones de propietario o editor adecuadas en tu proyecto de Google Cloud. Comenzaremos a enviar anuncios de servicio obligatorios (MSA) a estas direcciones de correo electrónico para notificarte sobre cualquier cambio futuro en la API de Google Ads. Seguiremos enviando MSA a la dirección de correo electrónico de contacto que aparece en tu Centro de APIs durante un período temporal y te informaremos cuando se actualice este proceso.
Corrige el código de tu app: Te recomendamos que actualices tu app para dejar de enviar el token de desarrollador como parte de las llamadas a la API. Publicamos versiones actualizadas de las bibliotecas cliente, el servidor de MCP de Google Ads y el Asistente para desarrolladores de la API de Google Ads que te permiten realizar llamadas a la API sin configurar un token de desarrollador. Comenzaremos a rechazar los tokens de desarrollador en las llamadas a la API en una versión principal futura de la API de Google Ads. Si tu app usa estas bibliotecas, actualiza las dependencias de la app para usar la versión más reciente.
Comunícate con el equipo de asistencia de la API de Google Ads si necesitas más ayuda o tienes más preguntas.
Preguntas frecuentes
¿Qué sucede con los niveles de acceso a la API?
Los niveles de acceso a la API aún se aplican en la API de Google Ads. Sin embargo, ahora se otorgan a tu proyecto de la consola de Google Cloud en lugar de a tu token de desarrollador. Cuando realizas llamadas a la API, tus niveles de acceso a la API ahora están determinados por el proyecto de Google Cloud que usaste para generar tus credenciales de OAuth.
- Si tu app usa el flujo de trabajo de autenticación de usuarios, este es el proyecto que posee tu ID de cliente y secreto de OAuth.
- Si usas el flujo de trabajo de la cuenta de servicio, este es el proyecto que posee tu cuenta de servicio.
¿Cómo se identificaron los proyectos para transferir los niveles de acceso a la API?
Si ya tenías un token de desarrollador aprobado antes del 9 de septiembre de 2026, sus niveles de acceso se transfirieron a tus proyectos de Google Cloud de la siguiente manera:
- Examinamos los registros de llamadas a la API de los últimos 90 días para identificar qué proyectos de Cloud se usaron para realizar llamadas a la API con tu token de desarrollador aprobado.
- Asignamos los niveles de acceso a la API del token de desarrollador a todos los proyectos de Cloud identificados.
¿Puedo tener varios proyectos de Cloud con diferentes niveles de acceso después de este cambio?
Sí, puedes tener varios proyectos de Google Cloud con diferentes niveles de acceso a la API. Por ejemplo, puedes tener un proyecto de Google Cloud con acceso básico y otro con acceso estándar.
Ejemplo
Como ejemplo, supongamos que tienes 4 tokens de desarrollador y 6 proyectos de Cloud con los siguientes detalles:
- Token de desarrollador 1:
abcdefghijkl1234567890tiene acceso estándar. Se ha usado con los IDs de proyecto:1234567890,5678912345,45678912345. - Token de desarrollador 2:
xyzabcdefghi6789012345tiene acceso básico. Se usó con el ID de proyecto:1231235678. - Token de desarrollador 3:
asdfgflkjhjz7654321012tiene acceso básico, pero nunca se usó para realizar una llamada a la API. Se aprobó recientemente. - Token de desarrollador 4:
qwertypoiuyu6543298790tenía acceso estándar, pero no se usó en los últimos 90 días. El ID de proyecto9876564900se usó con este token de desarrollador en el pasado. - Proyecto de Cloud: El ID de proyecto de Cloud:
7171234567nunca se usó con ninguno de los tokens de desarrollador para realizar una llamada a la API.
Los niveles de acceso a la API se transferirán de los tokens de desarrollador a los proyectos de Google Cloud de la siguiente manera:
| Token del desarrollador | ID del proyecto | Nivel de acceso | Explicación |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
Acceso estándar | El token de desarrollador y el ID del proyecto están asociados entre sí. |
abcdefghijkl1234567890 |
5678912345 |
Acceso estándar | El token de desarrollador y el ID del proyecto están asociados entre sí. |
abcdefghijkl1234567890 |
45678912345 |
Acceso estándar | El token de desarrollador y el ID del proyecto están asociados entre sí. |
xyzabcdefghi6789012345 |
1231235678 |
Acceso básico | El token de desarrollador y el ID del proyecto están asociados entre sí. |
asdfgflkjhjz7654321012 |
-- |
-- |
El acceso a la API del token de desarrollador no se transfirió a ningún proyecto ya que nunca se usó para realizar una llamada a la API. |
qwertypoiuyu6543298790 |
9876564900 |
Acceso a la cuenta de prueba | Se revocó el acceso a la API del token de desarrollador debido a la inactividad durante 90 días. El nivel de acceso a la API del proyecto se establece de forma predeterminada en el acceso a la cuenta de prueba. |
-- |
7171234567 |
Acceso a la cuenta de prueba | Este es un proyecto nuevo que no se usó con ningún token de desarrollador. El nivel de acceso a la API del proyecto se establece de forma predeterminada en el acceso a la cuenta de prueba. |
Tengo más de un token de desarrollador aprobado. ¿A qué proyecto transferirás los niveles de acceso a la API?
Los niveles de acceso de cada token de desarrollador aprobado se transferirán a los proyectos de Google Cloud asociados con ese token de desarrollador. Consulta un ejemplo.
Uso varios proyectos de Google Cloud. ¿A qué proyecto transferirás los niveles de acceso a la API?
Si usaste varios proyectos de Google Cloud con tu token de desarrollador aprobado en los últimos 90 días, todos esos proyectos recibirán los mismos niveles de acceso a la API que tu token de desarrollador. Consulta un ejemplo.
Se asignaron niveles de acceso a la API a un proyecto que ya no uso. ¿Cómo puedo solucionar este problema?
Si el acceso a la API de Google Ads está asignado a un proyecto de Google Cloud que ya no usas, no es necesario que realices ninguna acción adicional. Google revocará el acceso a la API del proyecto no utilizado después de 90 días de inactividad.
No se asignaron niveles de acceso a la API a mi proyecto de Google Cloud. ¿Cómo puedo solucionar este problema?
Tu proyecto de Google Cloud no heredó el nivel de acceso de tu token de desarrollador, probablemente porque nunca usaste tu token de desarrollador y el proyecto de Cloud para realizar una llamada a la API, o bien el acceso a la API de tu token de desarrollador venció recientemente debido a la inactividad. Para solucionar el problema, solicita el nivel de acceso a la API adecuado para ese proyecto desde la página Descripción general de la API de Google Ads. Consulta un ejemplo.
¿Dónde puedo ver los niveles de acceso a la API de mi proyecto?
Puedes ver el nivel de acceso a la API de tu proyecto de Google Cloud desde la página Descripción general de la API de Google Ads.
¿Cómo solicito niveles de acceso a la API más altos?
Puedes solicitar niveles de acceso a la API más altos para tu proyecto de Google Cloud desde la página Descripción general de la API de Google Ads.
¿Qué sucede con mi solicitud de acceso a la API pendiente?
Se cerrarán todas las solicitudes de acceso básico pendientes que hayas iniciado desde el Centro de APIs de tu cuenta de administrador de Google Ads antes del 9 de septiembre de 2026. Debes volver a solicitar acceso básico desde la página Descripción general de la API de Google Ads de tu proyecto de Google Cloud. Si te afecta este cambio, recibirás un correo electrónico con las instrucciones necesarias.
Todas las solicitudes de acceso estándar pendientes que hayas iniciado desde el Centro de APIs de tu cuenta de administrador de Google Ads a partir del 9 de septiembre de 2026 se revisarán como de costumbre. Si se aprueba, el proyecto de Google Cloud asociado con tu token de desarrollador obtendrá acceso estándar.
¿Puedo volver a asociar mi token de desarrollador aprobado con un proyecto nuevo de Google Cloud?
En el pasado, el equipo de la API de Google Ads admitía la reasociación de un token de desarrollador con un proyecto nuevo de Google Cloud caso por caso. Esto ya no es compatible a partir del 9 de septiembre de 2026, ya que desactivamos los tokens de desarrollador. Si necesitas usar un proyecto nuevo de Google Cloud, debes solicitar el acceso a la API adecuado desde la página Descripción general de la API de Google Ads de tu proyecto de Google Cloud.
Tengo un token de desarrollador aprobado, pero nunca lo usé. ¿Puedo usar este token de desarrollador?
No, no puedes usar este token de desarrollador. Hay dos posibilidades:
Es posible que se revoque el acceso a tu token de desarrollador por inactividad: Según las políticas de Google, Google puede revocar tu token de API si no se usa durante 90 días consecutivos. Si no has usado tu token de desarrollador en un tiempo, es probable que se hayan revocado sus niveles de acceso debido a la inactividad. Si este es el caso, vuelve a solicitar acceso a la API para tu proyecto de Google Cloud desde la página Descripción general de la API de Google Ads. Consulta un ejemplo.
Tu token de desarrollador se aprobó recientemente, pero nunca lo usaste antes del 9 de septiembre de 2026: Como nunca usaste tu token de desarrollador aprobado con un proyecto de Google Cloud antes del 9 de septiembre de 2026, sus niveles de acceso no se transfirieron al proyecto de Cloud. Como resultado, ya no puedes usar tu token de desarrollador. Mostraremos un
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONerror si intentas realizar una llamada a la API a una cuenta de producción con este token de desarrollador. Para corregir el error, solicita el acceso a la API adecuado desde la página Descripción general de la API de Google Ads de tu proyecto de Google Cloud. Consulta un ejemplo.
En ambos casos, puedes solicitar acceso de explorador y niveles de acceso básico, y obtenerlos automáticamente revisados. Ya no necesitas trabajar con el equipo de cumplimiento de Google para completar el proceso de revisión. Si necesitas acceso estándar, necesitas una revisión manual. Sin embargo, puedes compartir los detalles de tu token de desarrollador aprobado cuando solicitas acceso estándar para que el equipo de cumplimiento pueda revisar tu nueva solicitud de acceso estándar en consecuencia.
¿Puedo dejar de enviar tokens de desarrollador como parte de mis solicitudes a la API?
Sí, puedes dejar de enviar tokens de desarrollador como parte de tus solicitudes a la API. Si usas una biblioteca cliente, es posible que debas actualizarla a la versión más reciente. Consulta los registros de cambios de la biblioteca para confirmar si admite realizar llamadas a la API sin especificar un token de desarrollador.
Formé parte del programa piloto de nivel de acceso administrado de Cloud. ¿Cómo me afecta?
El programa piloto de nivel de acceso administrado de Cloud se introdujo como una forma para que los desarrolladores de Google Cloud realicen llamadas a la API sin enviar un token de desarrollador como parte de la solicitud a la API. Ahora que desactivamos los tokens de desarrollador, este programa se discontinuará.
Los niveles de acceso de tu token de desarrollador activo se transfirieron a tu proyecto de Google Cloud, por lo que tu código existente debería seguir funcionando sin cambios. Si necesitas usar un proyecto nuevo de Google Cloud, debes solicitar acceso a la API desde la página Descripción general de la API de Google Adsde tu proyecto de Google Cloud.
Mi token de desarrollador formaba parte de una lista de entidades permitidas. ¿Cómo me afecta?
Google puede ejecutar programas piloto que les den a algunos desarrolladores acceso a funciones experimentales. El acceso a estas funciones a veces se proporciona agregando tu token de desarrollador a una lista de entidades permitidas. Si formaste parte de un programa piloto de este tipo, no es necesario que realices ninguna acción.
Actualizamos todos los programas piloto para usar proyectos de Google Cloud en lugar de tokens de desarrollador como mecanismo de lista de entidades permitidas y transferimos el estado de la lista de entidades permitidas del token de desarrollador a los proyectos de Google Cloud asociados. Tu código existente debería seguir funcionando sin cambios. Si sigues teniendo problemas, comunícate con tu administrador de cuentas de Google, quien te inscribió en el programa piloto.
Tengo un token de desarrollador aprobado y quiero usarlo con un proyecto nuevo de Google Cloud. ¿Está permitido?
No, no puedes usar un proyecto nuevo de Google Cloud con tu token de desarrollador aprobado. Como nunca usaste tu token de desarrollador aprobado con el proyecto nuevo de Google Cloud antes del 9 de septiembre de 2026, sus niveles de acceso no se transfirieron al proyecto de Cloud. Mostraremos un
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION error si intentas realizar una llamada a la API con este token de desarrollador, ya que los tokens de desarrollador ya no se usan para determinar tus niveles de acceso a la API. Para corregir el error, solicita el
acceso a la API adecuado desde la página Descripción general de la API de Google Ads
de tu proyecto de Google Cloud. Consulta un ejemplo.
Mi token de desarrollador se filtró externamente. ¿Debo restablecer mi token de desarrollador?
No, no es necesario que restablezcas el token de desarrollador en este caso. Como transferimos los niveles de acceso a la API de tu token de desarrollador a tu proyecto de Google Cloud, un usuario no autorizado ya no puede usar tu token de desarrollador con su propio proyecto de Google Cloud. Sin embargo, puedes restablecer el token de desarrollador desde el Centro de APIs si lo prefieres.
¿Qué sucede con el Centro de APIs?
La página existente del Centro de APIs en la cuenta de administrador de Google Ads dejó de estar disponible y se quitará en el futuro cercano. Si ya tienes un token de desarrollador, aún puedes acceder a tu cuenta de administrador de Google Ads y ver los detalles. Sin embargo, estos se proporcionan solo como referencia. No realices ninguna tarea relacionada con los niveles de acceso del token de desarrollador, como solicitar niveles de acceso a la API más altos desde esta página.
Si necesitas solicitar niveles de acceso a la API más altos, debes hacerlo desde la página Descripción general de la API de Google Ads de tu proyecto de Google Cloud.
¿Aún necesito una cuenta de administrador de Google Ads para usar la API de Google Ads?
Ya no necesitas una cuenta de administrador de Google Ads para usar la API de Google Ads. Solo necesitas una cuenta de administrador si necesitas vincular y administrar varias cuentas con la API.
Soy un desarrollador nuevo. ¿Cómo me registro en la API de Google Ads?
Sigue las instrucciones de la guía Comienza a usar para registrarte en la API de Google Ads. No te registres para obtener un token de desarrollador en el Centro de APIs de tu cuenta de administrador de Google Ads; estas solicitudes no se procesarán. El Centro de APIs dejará de estar disponible en el futuro cercano.