Se usó la API de Cloud Translation para traducir esta página.

Errores comunes

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

`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 manejar	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 la API 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.
Sugerencias de prevención	Consulta Apps sin verificar.

`AuthenticationError`

CLIENT_CUSTOMER_ID_INVALID

Resumen	El ID de cliente del cliente no es un número.
Causas habituales	Usar un ID de cliente incorrecto
Cómo manejar	N/A
Sugerencias de prevención	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 especificar un ID de cliente del cliente en el encabezado HTTP
Cómo manejar	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, 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	Intenta acceder a una cuenta que se acaba de crear antes de que se establezca en el backend.
Cómo manejar	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 enviar solicitudes a ella.

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	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 manejar	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 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 manejar	N/A
Sugerencias de prevención	Asegúrate de haber pasado el token de acceso correcto asociado con 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 información, consulta nuestra guía sobre tokens de acceso y de actualización y 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 terminó de registrarse o se desactivó.
Cómo manejar	Accede a la IU de Google Ads y asegúrate de haber completado el proceso de registro de esta cuenta. Para 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 está aprobado 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.
Cómo manejar	Asegúrate de que realmente quieres acceder a una cuenta que no sea de prueba. Si es así, debes solicitar que se actualice tu 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 se permite con el proyecto que se envió 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 realices una solicitud a la API de Google Ads, el token de desarrollador se vinculará de forma permanente al proyecto de la consola de la API de Google. Si no usas un proyecto nuevo de la consola de la API de Google, recibirás un error `DEVELOPER_TOKEN_PROHIBITED` cuando realices una solicitud.
Cómo manejar	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 a 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	Autenticación como un usuario con acceso a una cuenta de administrador, pero sin especificar `login-customer-id` en la solicitud
Cómo manejar	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.

Realiza una llamada a la API

Próximos pasos