Errores comunes

En esta página, se enumeran los errores comunes y se brindan sugerencias para prevenirlos y controlarlos. Para obtener una lista completa de los errores, consulta las referencias de errores. Si deseas obtener más ayuda, comunícate con el equipo de asistencia.

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Resumen El token de acceso de OAuth 2.0 no tiene los permisos requeridos. 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 manipularla Asegúrate de que el token de acceso tenga los permisos requeridos. Un motivo común de este error es que reutilizas 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 necesarios. 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 manipularla 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 son el status del anuncio. Cómo manipularla 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 manipularla 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 superó la longitud máxima permitida. Consulta Acerca de los anuncios de texto. Causas habituales Tener una línea de texto demasiado larga Cómo manipularla 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 manipularla N/A Sugerencias de prevención Primero, verifica si la etiqueta que se agregará ya está asociada a 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, incluidos los cambios en su estado. Cómo manipularla 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 manipularla 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 activo o detenido existente Cómo manipularla Registra el error y muestra un mensaje de error al usuario. De manera opcional, sugiere un nombre único para el grupo de anuncios o muestra 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 mutación con operaciones de creación duplicadas que contienen los mismos datos binarios. Cómo manipularla Crea el activo 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 manipularla N/A Sugerencias de prevención 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 en el encabezado HTTP. Causas habituales No se especifica un ID de cliente en el encabezado HTTP. Cómo manipularla 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, 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 manipularla 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 manipularla 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 manipularla 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 manipularla 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.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	Resumen El token de desarrollador ya está asociado a una organización de Google Cloud y no se puede asociar a otra. Causas habituales El token de desarrollador no está asociado a un proyecto de Google Cloud en la misma organización de Google Cloud que el proyecto de Google Cloud que se usó originalmente para realizar solicitudes. Cómo manipularla Si ya realizaste solicitudes a la API con el token de desarrollador, asegúrate de que el ID de cliente de OAuth esté asociado con proyectos de Google Cloud en la misma organización de Google Cloud. Sugerencias de prevención Asegúrate de que todos tus proyectos de Google Cloud estén asociados con la misma organización de Google Cloud. Un proyecto de Google Cloud solo se puede asociar con un token de desarrollador, pero un token de desarrollador se puede asociar con varios proyectos de la organización.
DEVELOPER_TOKEN_INVALID	Resumen El token de desarrollador no es válido. Causas habituales Las causas comunes de este error incluyen errores de escritura en el token de desarrollador o la configuración incorrecta del token de desarrollador en un encabezado de la solicitud diferente. Cómo manipularla Asegúrate de copiar el token de desarrollador del centro de APIs para evitar errores de escritura. Puedes encontrar el Centro de APIs en tu cuenta de administrador de Google Ads. Además, asegúrate de configurar el token de desarrollador en el encabezado correcto. A veces, los tokens de desarrollador se confunden con los tokens de actualización y los códigos de autorización de OAuth. Obtén más información sobre los diferentes encabezados de solicitud aquí. Sugerencias de prevención N/A

AuthorizationError
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 manipularla 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.
DEVELOPER_TOKEN_NOT_APPROVED	Resumen El token de desarrollador solo se aprobó para usarse con cuentas de prueba y se intentó acceder a una cuenta que no es de prueba.