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 proporcionan sugerencias para evitarlos y manejarlos.
Para ver 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 comunes
Un proyecto de Google Cloud Platform con una pantalla de consentimiento de OAuth configurada para un tipo de usuario externo y el estado de publicación Testing se emite un token de actualización que vence en 7 días.
Manejo
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 API de Google y navega a la pantalla de consentimiento de OAuth. Luego, cambia el estado de publicación a In production y sigue estas instrucciones para evitar que el token de actualización venza en 7 días.
No se puede usar este operador con una subclase de anuncio.
Causas comunes
Intentar modificar atributos distintos del status del anuncio
Manejo
No corresponde
Sugerencias de prevención
Una vez que se crea un anuncio, no se puede modificar. Si desea modificar el anuncio, debe crear un anuncio nuevo y, luego, quitar el anterior. Sin embargo, el status del anuncio se puede modificar mediante MutateAdGroupAds.
INVALID_INPUT
Resumen
Uno de los campos de un anuncio contiene caracteres no válidos.
Causas comunes
Usar caracteres especiales en las URL
Manejo
No corresponde
Sugerencias de prevención
Valida las URL en tu app antes de realizar la solicitud a la API.
Se está agregando o renombrando un grupo de anuncios, pero otro grupo de anuncios ya está utilizando el nombre.
Causas comunes
Crear un grupo de anuncios nuevo con el nombre de un grupo de anuncios existente activo o detenido.
Manejo
Registre el error y presente un mensaje de error al usuario, que le sugiera un nombre único para el grupo de anuncios o muestre la lista de nombres en uso.
123-456-7890 debe ser 1234567890. Consulta la Guía de inicio rápido para obtener detalles.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Resumen
No se especificó el ID de cliente en el encabezado HTTP.
Causas comunes
No se especifica un ID de cliente en el encabezado HTTP.
Manejo
No corresponde
Sugerencias de prevención
Todas las llamadas requieren un ID de cliente. Por lo tanto, asegúrese de haber especificado uno en el encabezado HTTP. Considera usar nuestras bibliotecas cliente mientras se encargan de esto.
CUSTOMER_NOT_FOUND
Resumen
No se encontró ninguna cuenta para el ID de cliente en el encabezado.
Causas comunes
Intentas acceder a una cuenta que se acaba de crear antes de establecerla en el backend.
Manejo
Espera cinco minutos y vuelve a intentarlo cada 30 segundos.
Sugerencias de prevención
Espera unos minutos después de crear la cuenta antes de emitir solicitudes en ella.
GOOGLE_ACCOUNT_COOKIE_INVALID
Resumen
El token de acceso en el encabezado de la solicitud no es válido o venció.
Causas comunes
Se invalidó el token de acceso.
Manejo
Solicita un token nuevo. Si usas una de nuestras bibliotecas cliente, consulta la documentación sobre 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 utiliza para generar el token de acceso no está asociada con ninguna cuenta de Google Ads.
Causas comunes
La información de acceso proporcionada corresponde a una Cuenta de Google que no tiene Google Ads habilitado.
Manejo
Asegúrese de acceder con una cuenta de Google Ads válida (por lo general, su cuenta de administrador) para el flujo de OAuth. También puede invitar a la Cuenta de Google para que acceda a una cuenta de Google Ads existente. Para ello, acceda a su cuenta de administrador, seleccione la cuenta de cliente o 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
No corresponde
OAUTH_TOKEN_INVALID
Resumen
El token de acceso de OAuth del encabezado no es válido.
Causas comunes
El token de acceso que se pasó con el encabezado HTTP no era correcto.
Manejo
No corresponde
Sugerencias de prevención
Asegúrate de haber pasado el token de acceso correcto asociado a tu cuenta. En ocasiones, se confunde con tokens de actualización y códigos de autorización. Si desea obtener una credencial que pueda acceder a todas las cuentas de cliente en una cuenta de administrador, asegúrese de obtener el token de actualización para la cuenta de administrador. Para obtener más detalles, consulta nuestra guía sobre token de acceso y token de actualización y sobre OAuth2.
No se permite el token de desarrollador con el proyecto enviado en la solicitud.
Causas comunes
Cada proyecto de la Consola de API de Google se puede asociar con el token de desarrollador de una sola cuenta de administrador. Una vez que haya realizado una solicitud a la API de Google Ads, el token de desarrollador se vinculará permanentemente con el proyecto de la Consola de API de Google. Si no usas un proyecto nuevo de la Consola de API de Google, verás un error DEVELOPER_TOKEN_PROHIBITED cuando realices una solicitud.
Manejo
No corresponde
Sugerencias de prevención
Si cambia a un token de desarrollador en una cuenta de administrador nueva, deberá crear un nuevo proyecto de la Consola de API 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 comunes
La autenticación se realiza como un usuario con acceso a una cuenta de administrador, pero sin especificar login-customer-id en la solicitud.
Manejo
No corresponde
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.
El valor de la oferta no es un múltiplo exacto de la unidad mínima de la moneda de la cuenta. Por ejemplo, USD 0.015 (15000 en micros) no es una oferta válida.
Causas comunes
No corresponde
Manejo
No corresponde
Sugerencias de prevención
Verifique que las ofertas sean múltiplos de la unidad mínima correspondiente a la moneda de la cuenta.
BID_TOO_BIG
Resumen
El error se muestra aunque la oferta se encuentre dentro del presupuesto de la campaña.
Se está agregando o renombrando una campaña, pero otra campaña ya está utilizando el nombre.
Causas comunes
Creación de una campaña nueva con el nombre de una campaña existente activa o detenida
Manejo
Registra el error y presenta un mensaje de error al usuario. El propietario puede sugerir un nombre único para la campaña o mostrar la lista de nombres en uso.
La solicitud contiene dos parámetros idénticos y redundantes.
Causas comunes
No corresponde
Manejo
No corresponde
Sugerencias de prevención
Quita los elementos duplicados (operaciones, parámetros, elementos de lista) antes de realizar la solicitud. Busca los campos que tengan la restricción DistinctElements.
Se agotó el tiempo de espera de la solicitud y no se pudo completar lo suficientemente rápido para mostrar una respuesta.
Causas comunes
Se realizó una solicitud de búsqueda que generó una respuesta demasiado grande o una solicitud mutada es demasiado grande para procesarla.
Manejo
Espere unos 30 segundos y vuelva a enviar la solicitud. Si el error persiste, intenta dividir la solicitud en varias solicitudes más pequeñas que se puedan completar más rápido.
Se produjo un error inesperado al procesar la solicitud.
Causas comunes
La API no funciona correctamente debido a un error.
Manejo
Reintentar cualquier solicitud que falló con este error, mediante un programa de retirada exponencial para los reintentos.
Sugerencias de prevención
No corresponde
TRANSIENT_ERROR
Resumen
Se produjo un error interno transitorio, y se debe realizar un reintento.
Causas comunes
Este error ocurre cuando la API encuentra un problema temporal.
Manejo
Reintentar cualquier solicitud que falló con este error, mediante un programa de retirada exponencial para los reintentos.
Sugerencias de prevención
No corresponde
InvalidGrantError
invalid_grant (malformed auth code)
Resumen
El código de autorización intercambiado por tokens de OAuth tenía un formato incorrecto.
Causas comunes
Esto sucede cuando se intenta generar un token de actualización para un usuario que ya tiene acceso a la aplicación solicitante. Por ejemplo, esto puede suceder cuando se ejecuta el ejemplo de generación de credenciales de usuario más de una vez para las mismas credenciales de cliente de OAuth y se autoriza al usuario.
Manejo
A fin de volver a generar un token de actualización para una combinación determinada de credenciales de usuario de OAuth y cliente autorizado, revoque un token de actualización existente. Tenga en cuenta que revocar un token hace que sea inutilizable para el acceso a la API de Google Ads y, además, invalida cualquier token de acceso que se usó para generar el token de actualización.
Sugerencias de prevención
Asegúrese de almacenar su token de actualización en una ubicación segura para evitar la necesidad de volver a generarlo.
La solicitud hacía referencia a un recurso que no se pudo encontrar.
Causas comunes
La solicitud intentó mutar o hacer referencia a un recurso que no existe o que se quitó. O bien, el nombre del recurso dado para el recurso es incorrecto.
Manejo
Usa una solicitud de búsqueda para recuperar el nombre de un recurso existente antes de enviar una solicitud de mutación. Revise nuestras guías de la biblioteca cliente, que incluyen documentación para crear nombres de recursos válidos en todos los lenguajes compatibles.
Sugerencias de prevención
No crees nombres de recursos manualmente. Usa uno de los métodos auxiliares que ofrecen nuestras bibliotecas cliente.
La solicitud intenta crear un recurso que haga que la cantidad total de esos recursos exceda un límite especificado.
Causas comunes
Existen varios límites para la cantidad de recursos que pueden existir en determinados contextos.
Manejo
Para identificar el límite que se alcanza, revisa Límites del sistema. Puedes reutilizar un recurso existente o quitar los recursos a fin de crear espacio para los nuevos.
Sugerencias de prevención
Use las consultas de búsqueda para supervisar la cantidad de recursos que tienen limitaciones.
