En esta página, se enumeran los errores comunes y se proporcionan sugerencias para prevenirlos y solucionarlos.
Para obtener 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 habituales |
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 recibe un token de actualización que vence en 7 días.
|
|---|
| Cómo manejarla |
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 siguiendo estas instrucciones para evitar que el token de actualización venza dentro de 7 días.
|
|---|
| Sugerencias de prevención |
Consulta el artículo Apps sin verificar.
|
|---|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
| Resumen | Este operador no se puede utilizar con una subclase de Anuncio. |
|---|
| Causas habituales |
Intentar modificar atributos que no sean status del anuncio
|
|---|
| Cómo manejarla |
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 manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Valida las URLs en tu app antes de realizar la solicitud a la API.
|
|---|
|
LINE_TOO_WIDE |
| Resumen | Uno de los campos del anuncio excedía la longitud máxima permitida. Consulta el artículo Acerca de los anuncios de texto. |
|---|
| Causas habituales |
Tener una línea de texto demasiado larga
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Valida la longitud de la línea antes de realizar la solicitud a la API.
|
|---|
|
|
AD_GROUP_AD_LABEL_ALREADY_EXISTS |
| Resumen | Esta etiqueta ya está asociada a algunos de los anuncios. |
|---|
| Causas habituales |
Se está intentando asociar la etiqueta con anuncios que ya se han asociado.
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Primero, verifique si la etiqueta que desea agregar ya está asociada con los anuncios.
|
|---|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD |
| Resumen | Una operación intentó actualizar un anuncio quitado. |
|---|
| Causas habituales |
Una vez que se quita un anuncio, ya no se puede actualizar, incluidos los cambios en su estado.
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Asegúrese de que su código no intente actualizar los anuncios quitados.
|
|---|
|
|
INVALID_KEYWORD_TEXT |
| Resumen | El texto de la palabra clave contiene caracteres no válidos. Consulte Cómo agregar palabras clave. |
|---|
| Causas habituales |
El texto de la palabra clave contiene caracteres no válidos.
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Valida el texto de la palabra clave en tu app antes de realizar una solicitud a la API.
|
|---|
|
|
DUPLICATE_ADGROUP_NAME |
| Resumen | Se está agregando un grupo de anuncios o se le está cambiando el nombre, pero otro grupo de anuncios ya lo utiliza. |
|---|
| Causas habituales |
Crear un grupo de anuncios nuevo con el nombre de un grupo de anuncios existente, activo o detenido
|
|---|
| Cómo manejarla |
Registra el error y muéstrale al usuario un mensaje de error. De forma opcional, puedes sugerir un nombre de grupo de anuncios único o mostrar la lista de nombres en uso.
|
|---|
| Sugerencias de prevención |
N/A
|
|---|
|
|
DUPLICATE_ASSET |
| Resumen | Dos operaciones en una misma solicitud contienen una operación de creación para un recurso con los mismos datos binarios. |
|---|
| Causas habituales |
Una solicitud de mutación con operaciones de creación duplicadas que contienen los mismos datos binarios.
|
|---|
| Cómo manejarla |
Crea el activo en una solicitud independiente y vincúlalo en la siguiente solicitud. También puedes usar un ID temporal dentro de la misma solicitud.
|
|---|
| Sugerencias de prevención |
N/A
|
|---|
|
|
CLIENT_CUSTOMER_ID_INVALID |
| Resumen | El ID de cliente no es un número. |
|---|
| Causas habituales |
El uso de un ID de cliente incorrecto
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
123-456-7890 debería 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 en el encabezado HTTP. |
|---|
| Causas habituales |
No se especifica un ID de cliente en el encabezado HTTP.
|
|---|
| Cómo manejarla |
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 cuando se encargan de esto.
|
|---|
|
CUSTOMER_NOT_FOUND |
| Resumen | No se encontró ninguna cuenta con 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 manejarla |
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 del encabezado de la solicitud no es válido o venció. |
|---|
| Causas habituales |
Se invalidó el token de acceso.
|
|---|
| Cómo manejarla |
Solicita un token nuevo. Si utilizas una de nuestras bibliotecas cliente, consulta su documentación sobre cómo actualizar el token.
|
|---|
| Sugerencias de prevención |
Almacena y reutiliza tokens de acceso hasta que venzan.
|
|---|
|
NOT_ADS_USER |
| Resumen | La Cuenta de Google que se usa 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 Google Ads habilitado.
|
|---|
| Cómo manejarla |
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 del encabezado no es válido. |
|---|
| Causas habituales |
El token de acceso que se pasó con el encabezado HTTP no era correcto.
|
|---|
| Cómo manejarla |
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 bajo una cuenta de administrador, asegúrate de obtener el token de actualización para la cuenta de administrador. Para obtener más detalles, consulta nuestra guía sobre el token de acceso y el token de actualización y sobre OAuth2.
|
|---|
|
|
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 se completó el registro o se desactivó.
|
|---|
| Cómo manejarla |
Acceda a la IU de Google Ads y asegúrese de completar el proceso de registro para esta cuenta. Para las cuentas desactivadas, consulte Cómo reactivar una cuenta de Google Ads cancelada.
|
|---|
| Sugerencias de prevención |
Puedes verificar de forma proactiva si la cuenta de un cliente está desactivada consultando el estado CANCELLED.
|
|---|
|
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 utilizó un token de desarrollador de prueba para acceder a una cuenta que no es de prueba.
|
|---|
| Cómo manejarla |
Asegúrate de que realmente deseas acceder a una cuenta que no sea de prueba. Si es así, deberá solicitar que se actualice su 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 en el proyecto enviado 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 realizas una solicitud a la API de Google Ads, el token de desarrollador se vincula de forma permanente con el proyecto de la Consola de APIs de Google. Si no usas un proyecto nuevo de la Consola de APIs de Google, recibirás un error DEVELOPER_TOKEN_PROHIBITED cuando realices una solicitud.
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Si cambias a un token de desarrollador en una cuenta de administrador nueva, deberás crear un nuevo proyecto de la Consola de APIs de Google para las solicitudes a la API de Google Ads que utilicen el nuevo token de administrador.
|
|---|
|
USER_PERMISSION_DENIED |
| Resumen | El cliente autorizado no tiene acceso al cliente que opera. |
|---|
| Causas habituales |
Autenticar como un usuario con acceso a una cuenta de administrador, pero sin especificar login-customer-id en la solicitud
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Especifica el login-customer-id como el ID de la cuenta de administrador sin guiones (-). Las bibliotecas cliente son compatibles con esto.
|
|---|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
| Resumen | 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 manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Verifica que las ofertas sean múltiplos de la unidad mínima para la moneda de la cuenta.
|
|---|
|
BID_TOO_BIG |
| Resumen | Se muestra el error a pesar de que la oferta se encuentra dentro del presupuesto de la campaña. |
|---|
| Causas habituales |
N/A
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Verifica si la cuenta participa en Google Ad Grants. En ese caso, restringe las ofertas de CPC al máximo prescrito por el programa.
|
|---|
|
|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC |
| Resumen | El importe del presupuesto es demasiado bajo. |
|---|
| Causas habituales |
N/A
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Verifica que el importe del presupuesto sea superior o igual a la unidad mínima para la moneda de la cuenta.
|
|---|
|
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT |
| Resumen | El importe del presupuesto tendrá demasiados decimales significativos cuando se convierta de un importe micro a un importe en la moneda de la cuenta. |
|---|
| Causas habituales |
N/A
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Verifica que el importe del presupuesto sea divisible por la unidad mínima para la moneda de la cuenta.
|
|---|
|
|
DUPLICATE_CAMPAIGN_NAME |
| Resumen | Se está agregando una campaña o se le cambia el nombre, pero otra campaña ya utiliza el nombre. |
|---|
| Causas habituales |
Crear una campaña nueva con el nombre de una campaña existente activa o detenida
|
|---|
| Cómo manejarla |
Registra el error y muéstrale al usuario un mensaje de error. De forma opcional, puedes sugerir un nombre de campaña único o mostrar la lista de nombres en uso.
|
|---|
| Sugerencias de prevención |
N/A
|
|---|
|
|
KEYWORD_HAS_INVALID_CHARS |
| Resumen | Agregar o modificar palabras clave que contienen caracteres no válidos |
|---|
| Causas habituales |
Utilice caracteres especiales, como ! @ % *, en las palabras clave.
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Asegúrese de no utilizar ningún carácter que no se permita en las palabras clave. Consulte Cómo agregar palabras clave.
|
|---|
|
|
DUPLICATE_ELEMENT |
| Resumen | La solicitud contiene dos parámetros que son idénticos y redundantes. |
|---|
| Causas habituales |
N/A
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Quita los duplicados (operaciones, parámetros, elementos de lista) antes de realizar la solicitud. Busca campos que tengan la restricción DistinctElements.
|
|---|
|
|
DEADLINE_EXCEEDED |
| Resumen | Se agotó el tiempo de espera de la solicitud y no se pudo completar lo suficientemente rápido como para devolver una respuesta. |
|---|
| Causas habituales |
Se realizó una solicitud de búsqueda que generó una respuesta demasiado grande o una solicitud de mutación era demasiado grande para procesarla.
|
|---|
| Cómo manejarla |
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ápidamente.
|
|---|
| Sugerencias de prevención |
Revisa la Segmentación para comprender cómo puede afectar el tamaño de una respuesta. Ten en cuenta las limitaciones de la capa de transporte de gRPC.
|
|---|
|
INTERNAL_ERROR |
| Resumen | Se produjo un error inesperado mientras se procesaba la solicitud. |
|---|
| Causas habituales |
La API no funciona correctamente debido a un error.
|
|---|
| Cómo manejarla |
Vuelve a intentar cualquier solicitud que falló con este error, con un programa de retirada exponencial para los reintentos.
|
|---|
| Sugerencias de prevención |
N/A
|
|---|
|
TRANSIENT_ERROR |
| Resumen | Se produjo un error interno transitorio, por lo que debe volver a intentarlo. |
|---|
| Causas habituales |
Este error se produce cuando la API encuentra internamente un problema temporal.
|
|---|
| Cómo manejarla |
Vuelve a intentar cualquier solicitud que falló con este error, con 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 los 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 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 autorizando al usuario.
|
|---|
| Cómo manejarla |
Si quieres volver a generar un token de actualización para una combinación determinada de credenciales de usuario autorizado y de cliente de OAuth, revoca un token de actualización existente. Ten en cuenta que, si revocas un token, no podrás usarlo para el acceso 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.
|
|---|
|
|
RESOURCE_NOT_FOUND |
| Resumen | La solicitud hacía referencia a un recurso que no se pudo encontrar. |
|---|
| Causas habituales |
La solicitud intentó mutar o hacer referencia a un recurso que no existe o que se eliminó. O bien, el nombre del recurso dado para el recurso tiene errores de formato.
|
|---|
| Cómo manejarla |
Usa una solicitud de búsqueda para recuperar el nombre de recurso de un recurso existente antes de enviar una solicitud de mutación. Revisa nuestras guías sobre bibliotecas 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.
|
|---|
|
|
EMPTY_LIST |
| Resumen | Una lista obligatoria está vacía. |
|---|
| Causas habituales |
Pasa una lista vacía de operaciones a un método mutate.
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
N/A
|
|---|
|
|
RESOURCE_EXHAUSTED |
| Resumen | Se superó un límite de frecuencia del sistema. |
|---|
| Causas habituales |
N/A
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Establece demoras breves entre las solicitudes o combina más operaciones con menos solicitudes.
|
|---|
|
|
TOO_LOW |
| Resumen | Un valor era inferior al mínimo permitido. |
|---|
| Causas habituales |
Si olvidas especificar un ID, se pasará un valor de 0.
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
Ten en cuenta las limitaciones de rango documentadas en la referencia de la API.
|
|---|
|
|
INVALID_INPUT |
| Resumen | La solicitud tiene un formato incorrecto. |
|---|
| Causas habituales |
La URL o el contenido de la solicitud presentan errores de formato.
|
|---|
| Cómo manejarla |
N/A
|
|---|
| Sugerencias de prevención |
N/A
|
|---|
|
REQUIRED_FIELD_MISSING |
| Resumen | Falta información obligatoria en la solicitud. |
|---|
| Causas habituales |
Faltan campos obligatorios cuando se intenta agregar una entidad.
|
|---|
| Cómo manejarla |
Registra el error y presenta un mensaje de error al usuario. El atributo fieldPath del error indica qué campo falta.
|
|---|
| Sugerencias de prevención |
Consulta la referencia de la API para saber qué campos son obligatorios.
|
|---|
|
|
RESOURCE_LIMIT |
| Resumen | La solicitud está intentando crear un recurso, por lo que la cantidad total de esos recursos excede un límite especificado. |
|---|
| Causas habituales |
Existen varios límites para la cantidad de recursos que pueden existir en determinados contextos.
|
|---|
| Cómo manejarla |
Para identificar el límite que se encuentra, revisa los Límites del sistema. Reutiliza un recurso existente o quita recursos a fin de crear espacio para otros nuevos.
|
|---|
| Sugerencias de prevención |
Usa las consultas de búsqueda para supervisar la cantidad de recursos que tienen limitaciones.
|
|---|
|
|
TOO_LONG |
| Resumen | La cadena asignada al campo especificado supera el límite. |
|---|
| Causas habituales |
Los títulos o las descripciones de los anuncios contienen demasiado texto.
|
|---|
| Cómo manejarla |
Identifica el límite encontrado, modifica la cadena según corresponda y vuelve a enviar la solicitud.
|
|---|
| Sugerencias de prevención |
Ten en cuenta los límites de longitud de las cadenas.
|
|---|
|
