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 permiso 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 necesarios. 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 token de acceso nuevo con los permisos requeridos.
Sugerencias de prevención
Asegúrate de que el token de acceso tenga los permisos necesarios. Vuelve a autenticar a tu usuario con los permisos necesarios para obtener un acceso con los permisos necesarios. 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
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 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.
Este operador no se puede usar con una subclase de Ad.
Causas habituales
Intentar 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 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
Usa caracteres especiales en las 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.
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 existente activo o detenido
Cómo manejar esta situación
Registra el error y muéstrale un mensaje de error al usuario. De manera opcional, sugiere un nombre de grupo de anuncios único o muestra la lista de nombres en uso.
Dos 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.
Cómo manejar esta situación
Crea el recurso en una solicitud independiente y, luego, vincúlalo en la solicitud posterior, o bien usa un ID temporal dentro de la misma solicitud.
Sugerencias de prevención
N/A
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE
Resumen
El ID de promoción del socio usa una variante de oneof (int_value o string_value) que no acepta la integración de promociones de la cuenta.
Causas habituales
Establecer el campo promotion_asset.external_redeem_info.partner_promotion_id.int_value cuando la integración de canje del cliente requiere la variante string_value, o establecer el campo string_value cuando la integración requiere la variante int_value.
Confirma qué formato de identificador de promoción (int_value o string_value) usa tu integración de canje de punto de venta (PDV) antes de crear un mensaje PromotionAsset con el campo external_redeem_info.
123-456-7890 debería ser 1234567890. Consulta Cómo comenzar para obtener información detallada.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Resumen
No se especificó el ID de cliente final en el encabezado HTTP.
Causas habituales
No especificar un ID de cliente final en el encabezado HTTP
Cómo manejar esta situación
N/A
Sugerencias de prevención
El ID de cliente final 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
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 inicialmente y, luego, vuelve a intentarlo cada 30 segundos.
Sugerencias de prevención
Espera unos minutos después de crear la cuenta antes de emitir solicitudes para 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 Google Ads habilitado.
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, 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 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 de usuarios.
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).
No se puede acceder a la cuenta del cliente porque no está habilitada.
Causas habituales
Esto ocurre cuando la cuenta de 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
Puedes verificar de forma proactiva si una cuenta de cliente está desactivada comprobando si tiene el estado CANCELLED.
USER_PERMISSION_DENIED
Resumen
El cliente autorizado no tiene acceso al cliente operativo.
Causas habituales
Autenticarte 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 el login-customer-id como el ID de 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 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 se encuentra dentro del presupuesto de la campaña.
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 importe en micro 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.
Se está agregando una campaña o se le está cambiando el nombre, pero otra campaña ya utiliza ese nombre.
Causas habituales
Crear una campaña nueva con el nombre de una campaña activa o detenida existente
Cómo manejar esta situación
Registra el error y muéstrale 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 todas las palabras clave se tratan como de concordancia amplia de forma predeterminada. Si intentas establecer o modificar este campo, se activará el error.
Cómo manejar esta situación
Aconseja al usuario que use 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` se establece en `true`. Activa o desactiva la concordancia con términos de búsqueda a nivel del grupo de anuncios con `disable_search_term_matching`.
No se puede activar una campaña de generación de demanda migrada antes de que se quite la campaña original o mientras ya esté activa otra campaña migrada para la misma campaña original.
Causas habituales
Actualizar el status de una campaña de generación de demanda migrada a ENABLED cuando no se quita la campaña de origen original o ya está ENABLED otra campaña de generación de demanda migrada de la misma campaña original. En las versiones de la API v25 y anteriores, esta condición devuelve RequestError.UNKNOWN.
Cómo manejar esta situación
Quita la campaña de origen original con CampaignOperation.remove (ya sea de antemano o en la misma solicitud de mutación) antes de activar la campaña de generación de demanda migrada y verifica que no haya ninguna otra campaña de generación de demanda migrada de la misma campaña original activa. Consulta Cómo activar las campañas migradas para obtener más detalles.
Sugerencias de prevención
Si haces un seguimiento de los IDs de tus campañas de origen originales y de sus campañas de generación de demanda migradas, consulta campaign.status antes de establecer status en ENABLED en una campaña migrada, o bien incluye CampaignOperation.remove para la campaña original en la misma solicitud de mutación.
La solicitud contiene dos parámetros que son 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 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 con la rapidez suficiente para devolver una respuesta.
Causas habituales
Se realizó una solicitud de búsqueda que generó una respuesta demasiado grande, o bien una solicitud de mutación era demasiado grande para procesarla.
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.
Se produjo un error inesperado mientras se procesaba 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 con 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 se produce cuando la API encuentra un problema temporal de forma interna.
Cómo manejar esta situación
Vuelve a intentar las solicitudes que fallaron 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 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 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 el mismo usuario que autoriza.
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, si revocas un token de actualización, este no se podrá usar para acceder a la API de Google Ads y se invalidarán todos los tokens de acceso que se hayan generado con él.
Sugerencias de prevención
Asegúrate de almacenar tu token de actualización en una ubicación segura para evitar tener que volver a generarlo.
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 se quitó. O bien, el nombre del recurso proporcionado tiene un formato incorrecto.
Cómo manejar esta situación
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 la biblioteca cliente, que incluyen documentación sobre cómo construir nombres de recursos válidos en todos los lenguajes compatibles.
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 esta situación
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: 2026-10-30 (UTC)"],[],[]]
