Acompáñanos en vivo en Discord en el servidor de la Comunidad de publicidad y medición de Google y en YouTube el 15 de octubre a las 10:00 a.m. (EST). Analizaremos las nuevas funciones agregadas en la versión 26 de la API de Google Ads.
Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.
El token de acceso de OAuth 2.0 no tiene los permisos necesarios.
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 manejar esta situación
Asegúrate de que el token de acceso tenga los permisos necesarios. Un motivo común de este error es que estás reutilizando 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 necesarios.
Sugerencias de prevención
Asegúrate de que el token de acceso tenga los permisos necesarios. Vuelve a autenticar al usuario con los permisos necesarios para obtener un acceso con los permisos necesarios. 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 Testing, se le emite un token de actualización que vence en 7 días.
Cómo manejar esta situación
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 para evitar que el token de actualización venza en 7 días.
123-456-7890 debe ser 1234567890. Consulta Comienza para obtener más detalles.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Resumen
No se especificó el ID de cliente final en el encabezado HTTP.
Causas habituales
No especificar un ID de cliente en el encabezado HTTP.
Cómo manejar esta situación
N/A
Sugerencias de prevención
Se requiere el ID de cliente para todas las llamadas, así que asegúrate de haber especificado uno en el encabezado HTTP. Considera usar nuestras bibliotecas cliente, ya que 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 manejar esta situación
Espera cinco minutos iniciales y, luego, vuelve a intentarlo cada 30 segundos.
Sugerencias de prevención
Espera unos minutos después de crear la cuenta antes de emitir solicitudes en su contra.
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 manejar esta situación
Solicita un token nuevo. Si usas una de nuestras bibliotecas cliente, consulta su documentación para obtener información sobre 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 con 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 manejar esta situación
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 para que acceda 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 pasaste con el encabezado HTTP no era correcto.
Cómo manejar esta situación
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 en una cuenta de administrador, asegúrate de obtener el token de actualización de la cuenta de administrador. Consulta la guía de autenticación de usuarios.
El proyecto de Google Cloud solo tiene acceso de prueba y no se puede usar para acceder a cuentas de producción.
Causas habituales
Se usó un proyecto de Google Cloud con el nivel de acceso de prueba para realizar una solicitud en una cuenta de Google Ads que no es de prueba (producción). (En las versiones de la API v24 y anteriores, esta condición muestra AuthorizationError.ACTION_NOT_PERMITTED).
Puedes verificar de forma proactiva si una cuenta de cliente está desactivada. Para ello, busca el estado CANCELLED.
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 manejar esta situación
N/A
Sugerencias de prevención
Especifica el login-customer-id como el ID de 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: 2026-10-14 (UTC)"],[],[]]
