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 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.
Este operador no se puede usar con una subclase de Ad.
Causas habituales
Intenta modificar atributos que no sean el status del anuncio.
Cómo manejar
N/A
Sugerencias de prevención
Una vez que se crea un anuncio, no se puede modificar. Si deseas modificar el anuncio, debes crear uno nuevo y, luego, quitar el anterior. Sin embargo, el status del anuncio se puede modificar con MutateAdGroupAds.
INVALID_INPUT
Resumen
Uno de los campos de un anuncio contiene caracteres no válidos.
Causas habituales
Usar caracteres especiales en las URLs
Cómo manejar
N/A
Sugerencias de prevención
Valida las URLs en tu app antes de realizar la solicitud a la API.
Se está agregando un grupo de anuncios o se le está cambiando el nombre, pero otro grupo de anuncios ya utiliza ese nombre.
Causas habituales
Crear un grupo de anuncios nuevo con el nombre de un grupo de anuncios activo o detenido existente
Cómo manejar
Registra el error y presenta un mensaje de error al usuario. De manera opcional, puedes sugerir un nombre único para el grupo de anuncios o mostrar la lista de nombres en uso.
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 lo 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.
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.
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 habituales
N/A
Cómo manejar
N/A
Sugerencias de prevención
Verifica que las ofertas sean múltiplos de la unidad mínima de la moneda de la cuenta.
BID_TOO_BIG
Resumen
El error se muestra aunque la oferta esté dentro del presupuesto de la campaña.
Se agregará una campaña o se cambiará su nombre, pero otra campaña ya está usando ese nombre.
Causas habituales
Crear una campaña nueva con el nombre de una campaña existente activa o pausada
Cómo manejar
Registra el error y presenta un mensaje de error al usuario. De manera opcional, puedes sugerir un nombre de campaña único o mostrar la lista de nombres en uso.
La solicitud contiene dos parámetros que son idénticos y redundantes.
Causas habituales
N/A
Cómo manejar
N/A
Sugerencias de prevención
Quita los duplicados (operaciones, parámetros y elementos de lista) antes de realizar la solicitud. Busca 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 como para mostrar una respuesta.
Causas habituales
Se realizó una solicitud de búsqueda que generó una respuesta demasiado grande o una solicitud de mutación demasiado grande para procesarse.
Cómo manejar
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 mientras se procesaba la solicitud.
Causas habituales
La API no funciona correctamente debido a un error.
Cómo manejar
Vuelve a intentar las solicitudes que fallaron con este error usando un programa de retirada exponencial para los reintentos.
Sugerencias de prevención
N/A
TRANSIENT_ERROR
Resumen
Se produjo un error interno transitorio y se debe volver a intentar.
Causas habituales
Este error ocurre cuando la API encuentra un problema temporal de forma interna.
Cómo manejar
Vuelve a intentar las solicitudes que fallaron con este error usando un programa de retirada exponencial para los reintentos.
Sugerencias de prevención
N/A
InvalidGrantError
invalid_grant (malformed auth code)
Resumen
El código de autorización que se intercambió por tokens de OAuth tenía un formato incorrecto.
Causas habituales
Esto sucede cuando se intenta generar un token de actualización para un usuario al que ya se le otorgó acceso a la aplicación solicitante. Por ejemplo, esto puede ocurrir 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 el mismo usuario autorizado.
Cómo manejar
Para volver a generar un token de actualización para una combinación determinada de credenciales de cliente de OAuth y usuario autorizado, renuncia a un token de actualización existente. Ten en cuenta que, si revocas un token, este no se podrá usar para acceder a la API de Google Ads y se invalidarán los tokens de acceso que se hayan generado con el token de actualización.
Sugerencias de prevención
Asegúrate de almacenar el token de actualización en una ubicación segura para evitar tener que volver a generarlo.
La solicitud se refería a un recurso que no se pudo encontrar.
Causas habituales
La solicitud intentó mutar o hacer referencia a un recurso que no existe o se quitó. O bien, el nombre del recurso proporcionado tiene un formato incorrecto.
Cómo manejar
Usa una solicitud de búsqueda para recuperar el nombre de un recurso existente antes de enviar una solicitud de mutación. Revisa nuestras guías de biblioteca cliente, que incluyen documentación sobre cómo crear nombres de recursos válidos en todos los idiomas admitidos.
Sugerencias de prevención
No crees nombres de recursos de forma manual. Usa uno de los métodos auxiliares que ofrecen nuestras bibliotecas cliente.
La solicitud intenta crear un recurso que haría que la cantidad total de esos recursos supere un límite especificado.
Causas habituales
Existen varios límites para la cantidad de recursos que pueden existir en ciertos contextos.
Cómo manejar
Revisa los límites del sistema para identificar el límite que se está alcanzando. Reutiliza un recurso existente o quita recursos para crear espacio para otros nuevos.
Sugerencias de prevención
Usa consultas de búsqueda para supervisar la cantidad de recursos que tienen limitaciones.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2024-12-02 (UTC)"],[],[]]
