El token de desarrollador es una cadena alfanumérica de 22 caracteres que se usó para conectar tu aplicación 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 baja del token 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 a proyectos de Google Cloud

Los tokens de desarrollador dejarán de estar disponibles 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 según 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 se determinan según 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 propietario de tu ID de cliente y secreto de OAuth.
• Si usas el flujo de trabajo de la cuenta de servicio, este es el proyecto propietario de tu cuenta de servicio.

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 desde 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 migraron 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

Descontinuamos todas las funciones nuevas de administración de acceso a la API y registro, como la solicitud de acceso a la API y la administración de los niveles de acceso a la API en la página del Centro de APIs de las cuentas de administrador de Google Ads. Estas funcionalidades ahora están disponibles en la página de 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 tus detalles históricos de 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 arrojará un error CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION si intentas usar un proyecto de Google Cloud con acceso de prueba para realizar llamadas a una cuenta de producción. Las versiones anteriores de la API mostrarán un error ACTION_NOT_PERMITTED. Si te encuentras con este error, navega a la página de descripción general de la API de Google Ads para 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

En el caso de las solicitudes de acceso básico y estándar nuevas, debes completar la verificación de marca para tu proyecto de Google Cloud. No es necesario que los titulares de acceso existentes completen la verificación de marca, aunque se recomienda que lo hagan.

Las solicitudes de acceso básico ahora son automáticas y se revisarán minutos después de la verificación y el envío de la marca.

Debido a estas actualizaciones del proceso, se cerrarán todas las solicitudes de acceso básico pendientes como parte de esta transición. Los solicitantes afectados recibirán un correo electrónico con detalles y deberán volver a solicitar el acceso básico desde la página de descripción general de la API de Google Ads.

Nuevos correos electrónicos de contacto de la API

A medida que nos preparamos para retirar la página del Centro de APIs, comenzaremos a 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 fluida, seguiremos enviando temporalmente anuncios obligatorios del servicio (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 ya eres desarrollador

Revisa los niveles de acceso a la API de tu proyecto de Google Cloud: Si ya eres desarrollador, te recomendamos que revises la página de 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 las discrepancias que encuentres.

Revisa la dirección de correo electrónico de contacto de la API: Visita la página de IAM (Identity and Access Management) de tu proyecto de Google Cloud. Verifica que tus desarrolladores y administradores de cuentas activos de Google Ads tengan asignadas 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 API durante un período temporal y te informaremos cada vez que se actualice este proceso.

Corrige el código de tu app: Te recomendamos que actualices tu app para que deje 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é sucederá 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 realices llamadas a la API, tus niveles de acceso a la API se determinarán según 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 propietario de tu ID de cliente y secreto de OAuth.
• Si usas el flujo de trabajo de la cuenta de servicio, este es el proyecto propietario de 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

Por ejemplo, supongamos que tienes 4 tokens de desarrollador y 6 proyectos de Cloud con los siguientes detalles:

• Token de desarrollador 1: abcdefghijkl1234567890 tiene acceso estándar. Se usó con los IDs de proyecto: 1234567890, 5678912345 y 45678912345.
• El token de desarrollador 2: xyzabcdefghi6789012345 tiene acceso básico. Se usó con los IDs de proyecto: 1231235678.
• Token de desarrollador 3: asdfgflkjhjz7654321012 tiene acceso básico, pero nunca se usó para hacer una llamada a la API. Se aprobó recientemente.
• Token de desarrollador 4: qwertypoiuyu6543298790 tenía acceso estándar, pero no se usó en los últimos 90 días. El ID del proyecto 9876564900 se usó con este token de desarrollador en el pasado.
• Proyecto de Cloud: El ID del proyecto de Cloud 7171234567 nunca 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	Prueba el acceso	Se revocó el acceso a la API del token de desarrollador debido a inactividad durante 90 días. El nivel de acceso a la API del proyecto se establece de forma predeterminada en Acceso de prueba.
--	7171234567	Prueba el acceso	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 Acceso 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 se asigna 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 inactivo 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 en la página de 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 en la página de 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 de 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 la API 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 de descripción general de la API de Google Ads de tu proyecto de Google Cloud. Si este cambio te afecta, recibirás un correo electrónico con las instrucciones necesarias.

Se revisarán como de costumbre todas las solicitudes de acceso estándar pendientes que hayas iniciado desde el Centro de la API de tu cuenta de administrador de Google Ads hasta el 9 de septiembre de 2026. Si se aprueba, se otorgará acceso estándar al proyecto de Google Cloud asociado con tu token de desarrollador.

¿Puedo volver a asociar mi token de desarrollador aprobado con un nuevo proyecto 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 nuevo proyecto de Google Cloud caso por caso. Esta opción ya no es compatible a partir del 9 de septiembre de 2026, ya que retiramos los tokens de desarrollador. Si necesitas usar un nuevo proyecto de Google Cloud, debes solicitar el acceso a la API correspondiente desde la página de 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. Existen dos posibilidades:

1. Es posible que se revoque tu acceso al 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 usaste tu token de desarrollador en un tiempo, es probable que se hayan revocado sus niveles de acceso debido a la inactividad. Si es así, vuelve a solicitar acceso a la API para tu proyecto de Google Cloud desde la página de descripción general de la API de Google Ads. Consulta un ejemplo.

2. 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. Por lo tanto, ya no puedes usar tu token de desarrollador. Se mostrará un error de CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 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 de 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 de nivel Básico, y se revisarán automáticamente. Ya no es necesario que trabajes con el equipo de Cumplimiento de Google para completar el proceso de revisión. Si necesitas acceso estándar, debes solicitar una revisión manual. Sin embargo, puedes compartir los detalles de tu token de desarrollador aprobado cuando solicites acceso estándar para que el equipo de Cumplimiento pueda revisar tu nueva solicitud de acceso estándar según corresponda.

¿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 su 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.

Participé en el programa piloto del nivel de acceso administrado por Cloud. ¿Cómo me afecta?

El programa piloto del nivel de acceso administrado por Cloud se presentó 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 descontinuamos los tokens de desarrollador, este programa también se descontinuará.

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 nuevo proyecto de Google Cloud, debes solicitar acceso a la API desde la página de descripción general de la API de Google Ads de 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 brinden a algunos desarrolladores acceso a funciones experimentales. A veces, el acceso a estas funciones se proporciona agregando tu token de desarrollador a una lista de entidades permitidas. Si fuiste parte de un programa piloto de este tipo, no es necesario que realices ninguna acción.

Actualizamos todos los programas piloto para que usen proyectos de Google Cloud en lugar de tokens de desarrollador como mecanismo de inclusión en la 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 el administrador de cuentas de Google que te inscribió en el programa piloto.

Tengo un token de desarrollador aprobado y quiero usarlo con un nuevo proyecto 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 nuevo proyecto de Google Cloud antes del 9 de septiembre de 2026, sus niveles de acceso no se transfirieron al proyecto de Cloud. Se generará un error CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 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 correspondiente desde la página de descripción general de la API de Google Ads de tu proyecto de Google Cloud. Consulta un ejemplo.

Se filtró mi token de desarrollador de forma externa. ¿Debo restablecer mi token de desarrollador?

No, en este caso no es necesario restablecer el token de desarrollador. Dado que 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.

¿Qué sucederá 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, se proporcionan solo como referencia. No realices ninguna tarea relacionada con los niveles de acceso de los tokens 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 de 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 de introducción 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, ya que no se procesarán estas solicitudes. El Centro de APIs se desactivará en un futuro cercano.