Errores comunes

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
ResumenEl 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.
Sugerencias de prevención Consulta Apps sin verificar.

AdError

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR
ResumenEste operador no se puede utilizar con una subclase de Anuncio.
Causas habituales Intenta modificar atributos que no sean el status del anuncio.
Procedimiento N/A
Sugerencias de prevención Una vez que se crea un anuncio, no se puede modificar. Si deseas modificar un anuncio, debes crear uno nuevo y, luego, quitar el anterior. Sin embargo, el status del anuncio se puede modificar con MutateAdGroupAds.
INVALID_INPUT
ResumenUno de los campos de un anuncio contiene caracteres no válidos.
Causas habituales Usar caracteres especiales en las URLs
Procedimiento N/A
Sugerencias de prevención Valida las URLs en tu app antes de realizar la solicitud a la API.
LINE_TOO_WIDE
ResumenUno de los campos de un anuncio superaba la longitud máxima permitida. Consulta el artículo Acerca de los anuncios de texto.
Causas habituales Una línea de texto demasiado larga
Procedimiento 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
ResumenEsta etiqueta ya está asociada a algunos de los anuncios.
Causas habituales Intentas asociar la etiqueta con anuncios que ya se asociaron.
Procedimiento N/A
Sugerencias de prevención Primero, verifica si la etiqueta que quieres agregar ya está asociada con los anuncios.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD
ResumenUna 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.
Procedimiento N/A
Sugerencias de prevención Asegúrese de que su código no intente actualizar los anuncios quitados.

AdGroupCriterionError

INVALID_KEYWORD_TEXT
ResumenEl 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.
Procedimiento 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
ResumenSe está agregando un grupo de anuncios o su nombre, pero otro grupo de anuncios ya usa el nombre.
Causas habituales Crear un grupo de anuncios nuevo con el nombre de un grupo de anuncios existente activo o detenido
Procedimiento Registra el error y muéstrale un mensaje de error al usuario. Para ello, puede 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
ResumenDos operaciones en una sola 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.
Procedimiento Crea el recurso en una solicitud independiente y, luego, vincúlalo en la solicitud posterior, o bien usa un ID temporal en la misma solicitud.
Sugerencias de prevención N/A

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
ResumenEl ID de cliente no es un número.
Causas habituales Usar un ID de cliente de cliente incorrecto
Procedimiento N/A
Sugerencias de prevención 123-456-7890 debe ser 1234567890. Consulta Cómo comenzar para obtener información detallada.
CLIENT_CUSTOMER_ID_IS_REQUIRED
ResumenNo 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
ResumenNo 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.
ResumenEl 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
ResumenLa 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
ResumenEl 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.

AuthorizationError

CUSTOMER_NOT_ENABLED
ResumenNo 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
ResumenEl 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.
Procedimiento Asegúrate de que realmente deseas acceder a una cuenta que no sea de prueba. Si es así, debes solicitar que se actualice tu token de desarrollador a acceso Estándar o Básico.
Sugerencias de prevención N/A
DEVELOPER_TOKEN_PROHIBITED
ResumenNo 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
ResumenEl 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.

BiddingError

BID_TOO_MANY_FRACTIONAL_DIGITS
ResumenEl 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
Procedimiento 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
ResumenSe muestra el error aunque la oferta se encuentre dentro del presupuesto de la campaña.
Causas habituales N/A
Procedimiento N/A
Sugerencias de prevención Compruebe si la cuenta participa en Google Ad Grants. En ese caso, restringe las ofertas de CPC al máximo prescrito por el programa.

CampaignBudgetError

MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC
ResumenEl importe del presupuesto es demasiado bajo.
Causas habituales N/A
Procedimiento N/A
Sugerencias de prevención Verifique 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
ResumenEl 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
Procedimiento N/A
Sugerencias de prevención Verifique que el importe del presupuesto sea divisible por la unidad mínima de la moneda de la cuenta.

CampaignError

DUPLICATE_CAMPAIGN_NAME
ResumenSe está agregando una campaña o se le está renombrando, 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
Procedimiento Registra el error y presenta un mensaje de error al usuario. Para ello, puede sugerir un nombre único de campaña o mostrar la lista de nombres en uso.
Sugerencias de prevención N/A

CriterionError

KEYWORD_HAS_INVALID_CHARS
ResumenAgregar o modificar palabras clave que contienen caracteres no válidos
Causas habituales Usa caracteres especiales, como ! @ % *, en las palabras clave.
Procedimiento N/A
Sugerencias de prevención Asegúrate de no usar caracteres no permitidos en las palabras clave. Consulte Cómo agregar palabras clave.

DistinctError

DUPLICATE_ELEMENT
ResumenLa solicitud contiene dos parámetros idénticos y redundantes.
Causas habituales N/A
Procedimiento 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.

InternalError

DEADLINE_EXCEEDED
ResumenSe 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.
Procedimiento 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 Consulta la sección 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
ResumenSe produjo un error inesperado cuando se procesaba la solicitud.
Causas habituales La API no funciona correctamente debido a un error.
Procedimiento Vuelve a intentar las solicitudes que fallaron con este error mediante un programa de retirada exponencial para los reintentos.
Sugerencias de prevención N/A
TRANSIENT_ERROR
ResumenSe produjo un error interno transitorio y se debe volver a intentar.
Causas habituales Este error se produce cuando la API encuentra un problema temporal de forma interna.
Procedimiento Vuelve a intentar las solicitudes que fallaron con este error mediante un programa de retirada exponencial para los reintentos.
Sugerencias de prevención N/A

InvalidGrantError

invalid_grant (malformed auth code)
ResumenEl 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 cuando se autoriza al usuario.
Procedimiento 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, se vuelve inutilizable para el acceso a la API de Google Ads y se invalidan todos los tokens de acceso que el token de actualización se usó para generar.
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.

MutateError

RESOURCE_NOT_FOUND
ResumenLa solicitud hizo 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 se quitó. O bien, el nombre del recurso dado tiene un formato incorrecto.
Procedimiento Usa una solicitud de búsqueda para recuperar el nombre del recurso de un recurso existente antes de enviar una solicitud de mutación. Revisa nuestras guías de la biblioteca cliente, que incluyen documentación sobre cómo crear nombres de recursos válidos en cada lenguaje compatible.
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
ResumenUna lista obligatoria está vacía.
Causas habituales Pasar una lista vacía de operaciones a un método mutate
Procedimiento N/A
Sugerencias de prevención N/A

QuotaError

RESOURCE_EXHAUSTED
ResumenSe superó un límite de frecuencia del sistema.
Causas habituales N/A
Procedimiento N/A
Sugerencias de prevención Configura retrasos cortos entre las solicitudes o combina más operaciones en menos solicitudes.

RangeError

TOO_LOW
ResumenUn valor era inferior al mínimo permitido.
Causas habituales Si olvidas especificar un ID, se pasará un valor de 0.
Procedimiento N/A
Sugerencias de prevención Ten en cuenta las limitaciones de rango documentadas en la referencia de la API.

RequestError

INVALID_INPUT
ResumenLa solicitud presenta errores de formato.
Causas habituales La URL o el contenido de la solicitud tienen errores de formato.
Procedimiento N/A
Sugerencias de prevención N/A
REQUIRED_FIELD_MISSING
ResumenFalta información obligatoria en la solicitud.
Causas habituales Faltan campos obligatorios cuando se intenta agregar una entidad.
Procedimiento 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 averiguar qué campos son obligatorios.

ResourceCountLimitExceededError

RESOURCE_LIMIT
ResumenLa solicitud está intentando crear un recurso que podría causar que la cantidad total de estos recursos exceda un límite especificado.
Causas habituales Existen varios límites en cuanto a la cantidad de recursos que pueden existir en ciertos contextos.
Procedimiento Para identificar el límite que se está alcanzando, consulta la sección Límites del sistema. Reutiliza un recurso existente o quita recursos para crear espacio para otros.
Sugerencias de prevención Usa las búsquedas para supervisar la cantidad de recursos que tienen limitaciones.

StringLengthError

TOO_LONG
ResumenLa cadena asignada al campo especificado es más larga que el límite.
Causas habituales Los títulos o las descripciones de los anuncios contienen demasiado texto.
Procedimiento Identifica el límite que se encuentra, modifica la string según corresponda y vuelve a enviar la solicitud.
Sugerencias de prevención Ten en cuenta los límites de longitud de las strings.