Errores comunes

En esta página, se enumeran los errores comunes y se proporcionan sugerencias para prevenirlos y controlarlos. Para obtener una lista completa de los errores, consulta las referencias de errores. Si necesitas 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 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 controlarlo Asegúrate de que el token de acceso tenga los permisos necesarios. Un motivo habitual de este error es que vuelves a usar 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 obtener 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 de Testing se le emite un token de actualización que vence en 7 días. Cómo controlarlo 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.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Resumen El ID de cliente no es un número. Causas habituales Usar un ID de cliente incorrecto. Cómo controlarlo N/A Sugerencias de prevención 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 en el encabezado HTTP. Causas habituales No especificar un ID de cliente en el encabezado HTTP. Cómo controlarlo 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 Intentar acceder a una cuenta que se acaba de crear antes de que se establezca en el backend. Cómo controlarlo 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 controlarlo 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 vuelve a usar 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 controlarlo 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 se pasó con el encabezado HTTP no era correcto. Cómo controlarlo 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 para la cuenta de administrador. Consulta la guía de autenticación del usuario.
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 organización. 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 controlarlo Asegúrate de que el ID de cliente de OAuth esté asociado a proyectos de Google Cloud en la misma organización de Google Cloud si ya realizaste solicitudes a la API con el token de desarrollador. Sugerencias de prevención Asegúrate de que todos tus proyectos de Google Cloud estén asociados a la misma organización de Google Cloud. Un proyecto de Google Cloud solo se puede asociar a un token de desarrollador, pero un token de desarrollador se puede asociar a varios proyectos de la organización.
DEVELOPER_TOKEN_INVALID	Resumen El token de desarrollador no es válido. Causas habituales Las causas habituales de este error incluyen errores tipográficos en el token de desarrollador o la configuración incorrecta del token de desarrollador en un encabezado de la solicitud diferente. Cómo controlarlo Asegúrate de copiar el token de desarrollador del centro de API para evitar errores tipográficos. Puedes encontrar el centro de 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 de OAuth y los códigos de autorización. Obtén más información sobre los diferentes encabezados de solicitud aquí. Sugerencias de prevención N/A

AuthorizationError
CUSTOMER_NOT_ENABLED	Resumen No se puede acceder a la cuenta de cliente porque no está en un estado habilitado. Causas habituales Esto ocurre cuando la cuenta de cliente no terminó de registrarse o se desactivó. Cómo controlarlo 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 Puedes verificar de forma proactiva si una cuenta de cliente está desactivada. Para ello, 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. Cómo controlarlo Asegúrate de que realmente quieras acceder a una cuenta que no es 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 está permitido con el proyecto enviado en la solicitud. Causas habituales Cada proyecto de 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 al proyecto de la Consola de APIs de Google. Si no usas un proyecto nuevo de Consola de APIs de Google, recibirás un error DEVELOPER_TOKEN_PROHIBITED cuando realices una solicitud. Cómo controlarlo 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 Consola de APIs de Google para las solicitudes a la API de Google Ads que usen el token del nuevo administrador.
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 controlarlo N/A Sugerencias de prevención Especifica el login-customer-id como el ID de la cuenta de administrador sin guiones (-). Las bibliotecas cliente tienen compatibilidad integrada para esto.