Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se enumeran los errores comunes y se brindan sugerencias para evitarlos y abordarlos.
Para ver la lista completa de los errores, revisa las referencias sobre los errores. Para obtener más asistencia, visita nuestro foro.
google.auth.exceptions.RefreshError
invalid_grant
Resumen
El token está vencido 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 al estado de publicación Testing se emite un token de actualización que vence en 7 días.
Procedimiento
El estado de publicación del 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 en 7 días.
123-456-7890 debe ser 1234567890. Consulta Cómo comenzar para obtener información detallada.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Resumen
No se especificó el ID de cliente del cliente en el encabezado HTTP.
Causas habituales
No se especifica un ID de cliente de cliente en el encabezado HTTP.
Procedimiento
N/A
Sugerencias de prevención
El ID de cliente del cliente es obligatorio para todas las llamadas, así que asegúrate de haber especificado uno en el encabezado HTTP. Considera usar nuestras bibliotecas cliente mientras se encargan de esto por ti.
CUSTOMER_NOT_FOUND
Resumen
No se encontró ninguna cuenta para el ID de cliente indicado en el encabezado.
Causas habituales
Se intenta acceder a una cuenta que se acaba de crear antes de que se establezca la cuenta en el backend.
Procedimiento
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 en el encabezado de la solicitud no es válido o venció.
Causas habituales
Se invalidó el token de acceso.
Procedimiento
Solicita un token nuevo. Si usas una de nuestras bibliotecas cliente, consulta su documentació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 utiliza 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.
Procedimiento
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 puede invitar a la Cuenta de Google a acceder a una cuenta de Google Ads existente. Para ello, acceda a su cuenta de administrador, seleccione la cuenta de cliente o de administrador en cuestión, navegue a Tools and Settings > Access and security y, luego, agregue 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.
Procedimiento
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 desea obtener una credencial que pueda acceder a todas las cuentas de cliente de una cuenta de administrador, asegúrese 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.
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ó.
Procedimiento
Acceda a la IU de Google Ads y asegúrese 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 comprobar de forma proactiva si la cuenta de un cliente está desactivada. Para ello, busca el estado CANCELADO.
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.
No se permite el token de desarrollador con el proyecto enviado en la solicitud.
Causas habituales
Cada proyecto de la Consola de APIs de Google puede asociarse con el token de desarrollador desde una sola cuenta de administrador. Una vez que realiza una solicitud a la API de Google Ads, el token de desarrollador se vincula de forma permanente con el proyecto de la Consola de API de Google. Si no usas un proyecto nuevo de la Consola de APIs de Google, recibirás el error DEVELOPER_TOKEN_PROHIBITED cuando realices una solicitud.
Procedimiento
N/A
Sugerencias de prevención
Si cambia a un token de desarrollador en una cuenta de administrador nueva, deberá crear un proyecto nuevo en la Consola de API de Google para las solicitudes a la API de Google Ads que utilicen el token de administrador nuevo.
USER_PERMISSION_DENIED
Resumen
El cliente autorizado no tiene acceso al cliente operativo.
Causas habituales
Se autentica como un usuario con acceso a una cuenta de administrador, pero sin especificar login-customer-id en la solicitud.
Procedimiento
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 este uso.
