Errores comunes

En esta página, se enumeran los errores comunes y se proporcionan sugerencias para prevenirlos y solucionarlos. Para obtener una lista completa de los errores, consulta las referencias de errores. Para obtener más asistencia, visita nuestro foro.

google.auth.exceptions.RefreshError

invalid_grant

Resumen El token venció o se revocó. Causas habituales 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 recibe un token de actualización que vence en 7 días. Cómo manejarla 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 dentro de 7 días. Sugerencias de prevención Consulta el artículo Apps sin verificar.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Resumen El ID de cliente no es un número. Causas habituales El uso de un ID de cliente incorrecto Cómo manejarla N/A Sugerencias de prevención 123-456-7890 debería 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 en el encabezado HTTP. Causas habituales No se especifica un ID de cliente en el encabezado HTTP. Cómo manejarla N/A Sugerencias de prevención El ID de cliente es obligatorio para todas las llamadas, así que asegúrate de haber especificado uno en el encabezado HTTP. Considera usar nuestras bibliotecas cliente cuando se encargan de esto.
CUSTOMER_NOT_FOUND	Resumen No se encontró ninguna cuenta con 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 manejarla Espera cinco minutos iniciales y vuelve a intentarlo cada 30 segundos. Sugerencias de prevención Espera unos minutos después de crear la cuenta para emitir solicitudes en su contra.
GOOGLE_ACCOUNT_COOKIE_INVALID	Resumen El token de acceso del encabezado de la solicitud no es válido o venció. Causas habituales Se invalidó el token de acceso. Cómo manejarla Solicita un token nuevo. Si utilizas una de nuestras bibliotecas cliente, consulta su documentación sobre cómo actualizar el token. Sugerencias de prevención Almacena y reutiliza tokens de acceso hasta que venzan.
NOT_ADS_USER	Resumen La Cuenta de Google que se usa 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 Google Ads habilitado. Cómo manejarla 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 del encabezado no es válido. Causas habituales El token de acceso que se pasó con el encabezado HTTP no era correcto. Cómo manejarla 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 bajo una cuenta de administrador, asegúrate de obtener el token de actualización para la cuenta de administrador. Para obtener más detalles, consulta nuestra guía sobre el token de acceso y el token de actualización y sobre OAuth2.

AuthorizationError
CUSTOMER_NOT_ENABLED	Resumen No se puede acceder a la cuenta del cliente porque no está habilitada. Causas habituales Esto ocurre cuando la cuenta del cliente no se completó el registro o se desactivó. Cómo manejarla Acceda a la IU de Google Ads y asegúrese de completar el proceso de registro para esta cuenta. Para las cuentas desactivadas, consulte Cómo reactivar una cuenta de Google Ads cancelada. Sugerencias de prevención Puedes verificar de forma proactiva si la cuenta de un cliente está desactivada consultando el estado CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED	Resumen El token de desarrollador solo está aprobado para usarse con cuentas de prueba y se intentó acceder a una cuenta que no es de prueba. Causas habituales Se utilizó un token de desarrollador de prueba para acceder a una cuenta que no es de prueba. Cómo manejarla Asegúrate de que realmente deseas acceder a una cuenta que no sea de prueba. Si es así, deberá solicitar que se actualice su token de desarrollador al acceso estándar o básico. Sugerencias de prevención N/A
DEVELOPER_TOKEN_PROHIBITED	Resumen El token de desarrollador no está permitido en el proyecto enviado en la solicitud. Causas habituales Cada proyecto de la Consola de APIs de Google se puede asociar con el token de desarrollador de una sola cuenta de administrador. Una vez que realizas una solicitud a la API de Google Ads, el token de desarrollador se vincula de forma permanente con el 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 manejarla N/A Sugerencias de prevención Si cambias a un token de desarrollador en una cuenta de administrador nueva, deberás crear un nuevo proyecto de la Consola de APIs de Google para las solicitudes a la API de Google Ads que utilicen el nuevo token de administrador.
USER_PERMISSION_DENIED	Resumen El cliente autorizado no tiene acceso al cliente que opera. Causas habituales Autenticar como un usuario con acceso a una cuenta de administrador, pero sin especificar login-customer-id en la solicitud Cómo manejarla N/A Sugerencias de prevención Especifica el login-customer-id como el ID de la cuenta de administrador sin guiones (-). Las bibliotecas cliente son compatibles con esto.