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.
En esta página, se enumeran los errores comunes y se brindan sugerencias para prevenirlos y controlarlos. Para obtener una lista completa de los errores, consulta las referencias de errores. Para obtener más ayuda, visita nuestro foro.
google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
Resumen
El token de acceso de OAuth 2.0 no tiene los permisos requeridos.
Causas habituales
Se rechaza la solicitud porque el token de acceso proporcionado no incluye el permiso de OAuth 2.0 de la API de Google Ads.
Cómo manipularla
Asegúrate de que el token de acceso tenga los permisos requeridos. Un motivo común de este error es que reutilizas un token de acceso existente que se generó con un conjunto diferente de permisos de OAuth. Consulta los parámetros de autorización de OAuth para ver un ejemplo de cómo generar un token de acceso nuevo con los permisos requeridos.
Sugerencias de prevención
Asegúrate de que el token de acceso tenga los permisos necesarios. Vuelve a autenticar a tu usuario con los permisos requeridos para obtener un acceso con los permisos requeridos. Si tu aplicación usa varios permisos de OAuth, es posible que debas implementar permisos de OAuth detallados.
google.auth.exceptions.RefreshError
invalid_grant
Resumen
El token venció o se revocó.
Causas habituales
A un proyecto de Google Cloud Platform con una pantalla de consentimiento de OAuth configurada para un tipo de usuario externo y un estado de publicación de Testing se le emite un token de actualización que vence en 7 días.
Cómo manipularla
El estado de publicación de tu proyecto de Google es Testing, por lo que el token de actualización vence cada 7 días y recibe un error invalid_grant. Ve a la Consola de APIs de Google y navega a la pantalla de consentimiento de OAuth. Luego, cambia el estado de publicación a In production siguiendo estas instrucciones para evitar que el token de actualización venza en 7 días.
123-456-7890 debe ser 1234567890. Consulta Cómo comenzar para obtener más información.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Resumen
No se especificó el ID de cliente del cliente en el encabezado HTTP.
Causas habituales
No se especifica un ID de cliente en el encabezado HTTP.
Cómo manipularla
N/A
Sugerencias de prevención
El ID de cliente es obligatorio para todas las llamadas, así que asegúrate de especificar uno en el encabezado HTTP. Considera usar nuestras bibliotecas cliente, ya que ellas se encargan de esto por ti.
CUSTOMER_NOT_FOUND
Resumen
No se encontró ninguna cuenta para el ID de cliente proporcionado en el encabezado.
Causas habituales
Intentar acceder a una cuenta que se acaba de crear antes de que se establezca en el backend
Cómo manipularla
Espera cinco minutos y, luego, vuelve a intentarlo cada 30 segundos.
Sugerencias de prevención
Espera unos minutos después de crear la cuenta antes de enviar solicitudes.
GOOGLE_ACCOUNT_COOKIE_INVALID
Resumen
El token de acceso en el encabezado de la solicitud no es válido o venció.
Causas habituales
Se invalidó el token de acceso.
Cómo manipularla
Solicita un token nuevo. Si usas una de nuestras bibliotecas cliente, consulta su documentación para saber cómo actualizar el token.
Sugerencias de prevención
Almacena y reutiliza los tokens de acceso hasta que venzan.
NOT_ADS_USER
Resumen
La Cuenta de Google que se usó para generar el token de acceso no está asociada a ninguna cuenta de Google Ads.
Causas habituales
La información de acceso proporcionada corresponde a una Cuenta de Google que no tiene habilitado Google Ads.
Cómo manipularla
Asegúrate de acceder con una cuenta de Google Ads válida (por lo general, tu cuenta de administrador) para el flujo de OAuth. También puedes invitar a la Cuenta de Google a acceder a una cuenta de Google Ads existente. Para ello, accede a tu cuenta de administrador, selecciona la cuenta de cliente o de administrador en cuestión, navega a Tools and Settings > Access and security y, luego, agrega la dirección de correo electrónico de la Cuenta de Google.
Sugerencias de prevención
N/A
OAUTH_TOKEN_INVALID
Resumen
El token de acceso de OAuth en el encabezado no es válido.
Causas habituales
El token de acceso que se pasó con el encabezado HTTP no era correcto.
Cómo manipularla
N/A
Sugerencias de prevención
Asegúrate de haber pasado el token de acceso correcto asociado a tu cuenta. A veces, se confunde con los tokens de actualización y los códigos de autorización. Si deseas obtener una credencial que pueda acceder a todas las cuentas de cliente de una cuenta de administrador, asegúrate de obtener el token de actualización de la cuenta de administrador. Para obtener más detalles, consulta nuestra guía sobre tokens de acceso y actualización y OAuth2.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
Resumen
El token de desarrollador ya está asociado a una organización de Google Cloud y no se puede asociar a otra.
Causas habituales
El token de desarrollador no está asociado a un proyecto de Google Cloud en la misma organización de Google Cloud que el proyecto de Google Cloud que se usó originalmente para realizar solicitudes.
Cómo manipularla
Si ya realizaste solicitudes a la API con el token de desarrollador, asegúrate de que el ID de cliente de OAuth esté asociado con proyectos de Google Cloud en la misma organización de Google Cloud.
Sugerencias de prevención
Asegúrate de que todos tus proyectos de Google Cloud estén asociados con la misma organización de Google Cloud. Un proyecto de Google Cloud solo se puede asociar con un token de desarrollador, pero un token de desarrollador se puede asociar con varios proyectos de la organización.
DEVELOPER_TOKEN_INVALID
Resumen
El token de desarrollador no es válido.
Causas habituales
Las causas comunes de este error incluyen errores de escritura en el token de desarrollador o la configuración incorrecta del token de desarrollador en un encabezado de solicitud diferente.
Cómo manipularla
Asegúrate de copiar el token de desarrollador del centro de la API para evitar errores de escritura. Puedes encontrar el centro de la API en tu cuenta de administrador de Google Ads. Además, asegúrate de configurar el token de desarrollador en el encabezado correcto. A veces, los tokens de desarrollador se confunden con los tokens de actualización y los códigos de autorización de OAuth. Obtén más información sobre los diferentes encabezados de solicitud aquí.
No se puede acceder a la cuenta del cliente porque no está habilitada.
Causas habituales
Esto ocurre cuando la cuenta del cliente no finalizó el registro o se desactivó.
Cómo manipularla
Accede a la IU de Google Ads y asegúrate de haber completado el proceso de registro para esta cuenta. En el caso de las cuentas desactivadas, consulta Cómo reactivar una cuenta de Google Ads cancelada.
Sugerencias de prevención
Para verificar de forma proactiva si una cuenta de cliente está desactivada, busca el estado CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED
Resumen
El token de desarrollador solo se aprobó para usarse con cuentas de prueba y se intentó acceder a una cuenta que no es de prueba.
Causas habituales
Se usó un token de desarrollador de prueba para acceder a una cuenta que no es de prueba.
El token de desarrollador no se permite con el proyecto enviado en la solicitud.
Causas habituales
Cada proyecto de la Consola de APIs de Google solo se puede asociar con el token de desarrollador de una cuenta de administrador. Una vez que realices una solicitud a la API de Google Ads, el token de desarrollador se vinculará de forma permanente al proyecto de la consola de APIs de Google. Si no usas un proyecto nuevo de la consola de APIs de Google, recibirás un error DEVELOPER_TOKEN_PROHIBITED cuando realices una solicitud.
Cómo manipularla
N/A
Sugerencias de prevención
Si cambias a un token de desarrollador en una cuenta de administrador nueva, deberás crear un proyecto nuevo de la Consola de APIs de Google para las solicitudes de la API de Google Ads que usen el token del administrador nuevo.
USER_PERMISSION_DENIED
Resumen
El cliente autorizado no tiene acceso al cliente operativo.
Causas habituales
Autenticarse como un usuario con acceso a una cuenta de administrador, pero no especificar login-customer-id en la solicitud
Cómo manipularla
N/A
Sugerencias de prevención
Especifica login-customer-id como el ID de la cuenta de administrador sin guiones (-). Las bibliotecas cliente tienen compatibilidad integrada para esto.
[[["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-08-21 (UTC)"],[[["\u003cp\u003eThis page provides solutions and preventative measures for common Google Ads API errors.\u003c/p\u003e\n"],["\u003cp\u003eFor a comprehensive list of errors, refer to the dedicated error references section.\u003c/p\u003e\n"],["\u003cp\u003eAdditional assistance and community support can be found on the Google Ads API forum.\u003c/p\u003e\n"],["\u003cp\u003eUnderstanding and addressing these errors is crucial for successful API integration and campaign management.\u003c/p\u003e\n"]]],[],null,[]]
