Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Errores comunes

En esta guía, se enumeran los errores comunes de la API y se ofrecen estrategias para prevenirlos y controlarlos.

Para obtener una lista completa de todos los tipos de errores, consulta la referencia de errores de la API de Google Ads. Si necesitas más ayuda, haz una pregunta en el foro de la API de Google Ads.

`google.rpc.ErrorInfo`

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Resumen	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 alcance 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 requeridos. 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 nuevo token de acceso con los permisos requeridos.
Sugerencias de prevención	Asegúrate de que el token de acceso tenga los permisos requeridos. 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.

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

CLIENT_CUSTOMER_ID_INVALID

Resumen	El ID de cliente no es un número.
Causas habituales	Se usa un ID de cliente incorrecto.
Cómo manejar esta situación	N/A
Sugerencias de prevención	123-456-7890 debe ser 1234567890. Consulta Cómo comenzar para obtener más detalles.

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 manejar esta situación	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 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 manejar esta situación	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 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 esta situación	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 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 a acceder a una cuenta de Google Ads existente. Para ello, ingresa 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 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 de 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 del usuario.

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION

Resumen	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 devuelve `AuthorizationError.ACTION_NOT_PERMITTED`).
Cómo manejar esta situación	Si estás realizando pruebas, asegúrate de que tu solicitud se dirija a una cuenta de prueba. Si quieres acceder a una cuenta de producción de Google Ads, verifica el nivel de acceso de tu proyecto de Google Cloud en la página de descripción general de la API de Google Ads y actualiza el nivel de acceso de tu proyecto a acceso de Explorador, Básico o Estándar.
Sugerencias de prevención	N/A

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 finalizó el registro o se desactivó.
Cómo manejar esta situación	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.

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 sin especificar `login-customer-id` en la solicitud
Cómo manejar esta situación	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.