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 la referencia de errores, la guía para comprender los errores de la API o la guía de tipos de errores. Si necesitas más ayuda, comunícate con el equipo de asistencia de la API de Google Ads.

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 alcance de OAuth 2.0 de la API de Google Ads. Cómo manejar esta situación Asegúrate de que el token de acceso tenga los permisos requeridos. Un motivo común de este error es que estás reutilizando 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 ver un ejemplo de cómo generar un nuevo token de acceso con los permisos requeridos. Sugerencias de prevención Asegúrate de que el token de acceso tenga los permisos requeridos. Vuelve a autenticar a tu usuario con los permisos requeridos para obtener un acceso con los permisos requeridos. 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 manejar esta situación 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.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Resumen Este operador no se puede usar con una subclase de Ad. Causas habituales Intentas modificar atributos que no sean el status del anuncio. Cómo manejar esta situación N/A Sugerencias de prevención Una vez que se crea un anuncio, no se puede modificar. Si quieres 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 Uso de caracteres especiales en URLs Cómo manejar esta situación 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 de un anuncio era más largo que la longitud máxima permitida. Consulta Acerca de los anuncios de texto. Causas habituales Tener una línea de texto demasiado larga Cómo manejar esta situación N/A Sugerencias de prevención Valida la longitud de la línea antes de realizar la solicitud a la API.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Resumen Esta etiqueta ya está asociada a algunos de los anuncios. Causas habituales Se intenta asociar la etiqueta con anuncios que ya se asociaron. Cómo manejar esta situación N/A Sugerencias de prevención Primero, verifica si la etiqueta que se agregará ya está asociada con los anuncios.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Resumen Se intentó actualizar un anuncio quitado. Causas habituales Una vez que se quita un anuncio, ya no se puede actualizar, lo que incluye los cambios en su estado. Cómo manejar esta situación N/A Sugerencias de prevención Asegúrate de que tu código no intente actualizar los anuncios quitados.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Resumen El texto de la palabra clave contiene caracteres no válidos. Consulta Cómo agregar palabras clave. Causas habituales El texto de la palabra clave contiene caracteres no válidos. Cómo manejar esta situación N/A Sugerencias de prevención Valida el texto de la palabra clave en tu app antes de realizar una solicitud a la API.

AdGroupError

DUPLICATE_ADGROUP_NAME

Resumen Se está agregando o cambiando el nombre de un grupo de anuncios, 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 existente activo o detenido Cómo manejar esta situación Registra el error y muestra 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. Sugerencias de prevención N/A

AssetError

DUPLICATE_ASSET

Resumen Dos operaciones en una sola solicitud contienen una operación de creación para un recurso con los mismos datos binarios. Causas habituales Es una solicitud de modificación con operaciones de creación duplicadas que contienen los mismos datos binarios. Cómo manejar esta situación Crea el recurso en una solicitud separada y, luego, vincúlalo en la solicitud posterior o usa un ID temporal en la misma solicitud. Sugerencias de prevención N/A

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Resumen El ID de cliente no es un número. Causas habituales Se usa un ID de cliente incorrecto. Cómo manejar esta situación N/A Sugerencias de prevención 123-456-7890 debe ser 1234567890. Consulta Cómo comenzar 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 se especifica un ID de cliente en el encabezado HTTP. Cómo manejar esta situación 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 ellas 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 manejar esta situación Espera cinco minutos 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 esta situación 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 esta situación 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, ingresa 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 manejar esta situación 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 de una cuenta de administrador, asegúrate de obtener el token de actualización de la cuenta de administrador. Consulta la guía de autenticación del usuario.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	Resumen El proyecto de Google Cloud solo tiene acceso de prueba y no se puede usar para acceder a cuentas de producción. Causas habituales Se usó un proyecto de Google Cloud con el nivel de acceso de prueba para realizar una solicitud en una cuenta de Google Ads que no es de prueba (producción). (En las versiones de la API v24 y anteriores, esta condición devuelve AuthorizationError.ACTION_NOT_PERMITTED). Cómo manejar esta situación Si estás realizando pruebas, asegúrate de que tu solicitud se dirija a una cuenta de prueba. Si quieres acceder a una cuenta de producción de Google Ads, verifica el nivel de acceso de tu proyecto de Google Cloud en la página de descripción general de la API de Google Ads y actualiza el nivel de acceso de tu proyecto a acceso de Explorador, Básico o Estándar. Sugerencias de prevención N/A
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 finalizó el registro o se desactivó. Cómo manejar esta situación 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 Para verificar de forma proactiva si una cuenta de cliente está desactivada, busca el estado CANCELLED.
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 sin especificar login-customer-id en la solicitud Cómo manejar esta situación 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.

BiddingError
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 manejar esta situación 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 devuelve incluso si la oferta está dentro del presupuesto de la campaña. Causas habituales N/A Cómo manejar esta situación N/A Sugerencias de prevención Verifica si la cuenta participa en Google Ad Grants. Si es así, restringe las ofertas de CPC al máximo prescrito por el programa.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Resumen El importe del presupuesto es demasiado bajo. Causas habituales N/A Cómo manejar esta situación N/A Sugerencias de prevención Verifica que el importe del presupuesto sea mayor o igual que la unidad mínima de 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 microimporte a un importe en la moneda de la cuenta. Causas habituales N/A Cómo manejar esta situación N/A Sugerencias de prevención Verifica que el importe del presupuesto sea divisible por la unidad mínima de la moneda de la cuenta.

CampaignError
DUPLICATE_CAMPAIGN_NAME	Resumen Se está agregando o cambiando el nombre de una campaña, pero otra campaña ya usa ese nombre. Causas habituales Crear una campaña nueva con el nombre de una campaña existente activa o en pausa Cómo manejar esta situación Registra el error y muestra un mensaje de error al usuario. De manera opcional, sugiere un nombre de campaña único o muestra la lista de nombres en uso. Sugerencias de prevención N/A
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE	Resumen Se intentó cambiar el parámetro de configuración del tipo de concordancia de palabras clave a nivel de la campaña en una campaña con IA Max habilitada. Causas habituales Con IA Max habilitada, los parámetros de configuración de concordancia amplia a nivel de la campaña dejan de estar disponibles porque, de forma predeterminada, todas las palabras clave se tratan como de concordancia amplia. Si intentas establecer o modificar este campo, se activará el error. Cómo manejar esta situación Aconseja al usuario que utilice el parámetro `disable_search_term_matching` a nivel del grupo de anuncios en lugar de establecer la concordancia amplia a nivel de la campaña. Sugerencias de prevención Evita establecer `keyword_match_type` en `BROAD` (o cualquier otro valor) en la campaña si `ai_max_setting.enable_ai_max` está establecido en `true`. Activa o desactiva la concordancia con términos de búsqueda a nivel del grupo de anuncios con `disable_search_term_matching`.

CriterionError
KEYWORD_HAS_INVALID_CHARS	Resumen Agregar o editar palabras clave que contienen caracteres no válidos Causas habituales Usa caracteres especiales, como ! @ % *, en las palabras clave. Cómo manejar esta situación N/A Sugerencias de prevención Asegúrate de no usar caracteres no permitidos en las palabras clave. Consulta Cómo agregar palabras clave.

DistinctError
DUPLICATE_ELEMENT	Resumen La solicitud contiene dos parámetros idénticos y redundantes. Causas habituales N/A Cómo manejar esta situación N/A Sugerencias de prevención Quita los duplicados (operaciones, parámetros, elementos de lista) antes de realizar la solicitud. Busca los campos que tengan la restricción DistinctElements.

InternalError
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 bien una solicitud de modificación fue demasiado grande para procesarse. Cómo manejar esta situación 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. 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 al procesar la solicitud. Causas habituales La API no funciona correctamente debido a un error. Cómo manejar esta situación 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 la operación. Causas habituales Este error se produce cuando la API encuentra internamente un problema temporal. Cómo manejar esta situación 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 intercambiado 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 autorizador. Cómo manejar esta situación Para volver a generar un token de actualización para una combinación determinada de usuario autorizador y credenciales de cliente de OAuth, revoca un token de actualización existente. Ten en cuenta que revocar un token lo inutiliza para el acceso a la API de Google Ads y anula todos los tokens de acceso que se hayan generado con el token de actualización. Sugerencias de prevención Asegúrate de almacenar tu token de actualización en una ubicación segura para evitar la necesidad de regenerarlo.

MutateError

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 de alguna otra manera a un recurso que no existe o que se quitó. O bien, el nombre de recurso proporcionado está mal formado. Cómo manejar esta situación Usa una solicitud de búsqueda para recuperar el nombre del recurso de un recurso existente antes de enviar una solicitud de modificación. Revisa nuestras guías de bibliotecas cliente, que incluyen documentación sobre cómo crear nombres de recursos válidos en todos los lenguajes 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.

NotEmptyError
EMPTY_LIST	Resumen Una lista obligatoria está vacía. Causas habituales Pasar una lista vacía de operaciones a un método mutate Cómo manejar esta situación N/A Sugerencias de prevención N/A

QuotaError
RESOURCE_EXHAUSTED	Resumen Se superó un límite de frecuencia del sistema. Causas habituales N/A Cómo manejar esta situación N/A Sugerencias de prevención Configura retrasos breves entre las solicitudes o combina más operaciones en menos solicitudes.

RangeError
TOO_LOW	Resumen Un valor fue inferior al mínimo permitido. Causas habituales Olvidar especificar un ID, lo que genera que se pase un valor de 0 Cómo manejar esta situación N/A Sugerencias de prevención Ten en cuenta las limitaciones de rango que se documentan en la referencia de la API.

RequestError
INVALID_INPUT	Resumen La solicitud tiene un formato incorrecto. Causas habituales La URL o el contenido de la solicitud tienen un formato incorrecto. Cómo manejar esta situación 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 manejar esta situación Registra el error y muestra 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.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Resumen 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 en la cantidad de recursos que pueden existir en ciertos contextos. Cómo manejar esta situación Revisa Límites del sistema para identificar el límite que se está alcanzando. Reutiliza un recurso existente o quita recursos para crear espacio para los nuevos. Sugerencias de prevención Usa búsquedas para supervisar la cantidad de recursos que tienen limitaciones.

StringLengthError
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 manejar esta situación Identifica el límite que se está alcanzando, 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.