Errores comunes

En esta página, se describen los errores más frecuentes que devuelve la API de Google Ad Manager. Los errores se devuelven en el formato Error.REASON:

Errores de límite de entidades

EntityChildrenLimitReachedError

Resumen
Se alcanzó la cantidad máxima de entidades secundarias permitidas para la entidad y no se pueden agregar más entidades secundarias a esa entidad.
Sugerencias de manipulación recomendadas
Crea un tipo nuevo de la entidad que alcanzó la cantidad máxima permitida de entidades secundarias y agrega la entidad secundaria que intentas crear a la nueva. Por ejemplo, si recibes LINE_ITEM_LIMIT_FOR_ORDER_REACHED, deberás crear un pedido nuevo y agregar la línea de pedido que intentas crear a ese pedido nuevo.

Errores de cuota

QuotaError.EXCEEDED_QUOTA

Resumen
La cantidad de solicitudes realizadas por segundo es demasiado alta y superó el límite permitido.
Sugerencias de manipulación recomendadas
  • Usa métodos por lotes, como updateLineItems, para recopilar los cambios de forma local y realizar una sola solicitud para aplicarlos todos a la vez.
  • Espera unos 5 segundos y, luego, vuelve a intentar la solicitud. Ten en cuenta que esto no garantiza que la solicitud se realice correctamente. Si vuelve a fallar, intenta aumentar el tiempo de espera. Se recomienda para aplicaciones interactivas que se integran con Ad Manager y se usan en tiempo real.
  • Limita las solicitudes a 2 por segundo para las redes de Ad Manager o a 8 por segundo para las redes de Ad Manager 360. Una vez más, esto no garantiza que todas las solicitudes se realicen correctamente, pero puede ayudar a reducir la cantidad de veces que recibes este error. Se recomienda para las aplicaciones que se integran en Ad Manager y que no tienen interacción en tiempo real, como la ejecución de informes nocturnos.

Errores de autenticación

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Resumen
El usuario intentó crear una red de prueba con una cuenta que ya está asociada a una red.
Causas habituales
El usuario no creó una Cuenta de Google nueva antes de llamar a NetworkService.makeTestNetwork().
Sugerencias de manipulación recomendadas
Crea una cuenta nueva antes de llamar a NetworkService.makeTestNetwork(). Consulta cómo crear una red de prueba para obtener más información.

AuthenticationError.NETWORK_CODE_REQUIRED

Resumen
El usuario no proporcionó un networkCode. Para realizar la solicitud, se requiere un código de red.
Causas habituales
Los códigos de red son obligatorios para todas las solicitudes, excepto NetworkService.getAllNetworks() y NetworkService.makeTestNetwork().
Sugerencias de manipulación recomendadas
Incluye el código de red de la red a la que se dirige en el encabezado de la solicitud. Solo usa un código de red disponible para el acceso a tu cuenta. Puedes encontrar el código en el sitio web de Ad Manager para tu cuenta, en la página Administrador > Configuración de red, junto a "Código de red". Puedes encontrar más información para configurar tu código de red en la página Encabezados de solicitud y encabezados de respuesta de SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

Resumen
No se pudo realizar la solicitud porque el código de red proporcionado en la configuración no se encuentra en el servidor.
Causas habituales
Especificaste un código de red incorrecto en tu configuración.
Sugerencias de manipulación recomendadas
El campo "trigger" del registro de errores suele sugerir la red correcta para el usuario.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Resumen
El usuario no está asociado con ninguna red.
Causas habituales
No habilitaste tu cuenta de producción para el acceso a la API.
Sugerencias de manipulación recomendadas
Habilita el acceso a la API en tu entorno de producción. Consulta Habilita el acceso a la API para obtener más información.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Resumen
El cliente no está incluido en la lista de entidades permitidas para acceder a la API.
Causas habituales
Tu red no está incluida en la lista de entidades permitidas para producción, pero proporcionaste un código de red en el encabezado SOAP.
Sugerencias de manipulación recomendadas
Habilita el acceso a la API.

Errores de permisos

PermissionError.PERMISSION_DENIED

Resumen
El usuario no tiene el permiso necesario para realizar la solicitud.
Causas habituales
  • Intentaste acceder a un objeto que existe en otra red.
  • Intentaste acceder a un objeto que existe en tu red, pero no tienes permiso para leerlo ni actualizarlo.
  • Intentaste realizar una tarea que requiere que se habilite una función adicional en tu cuenta.
Sugerencias de manipulación recomendadas
  • Si estás creando una IU, indícale al usuario que no tiene permiso para realizar esta acción y que debe comunicarse con su administrador.
  • Si intentaste realizar una tarea, como una que involucra una función solo para cuentas premium para la que tu red no tiene permiso, comunícate con tu administrador de cuentas para habilitar esta función.
  • Recuerda que, de forma predeterminada, las redes de prueba no son redes de Ad Manager 360, lo que significa que no tienen las funciones premium que se encuentran en las redes de Ad Manager 360. Comunícate con tu administrador de cuentas para habilitar las funciones en tu red de prueba.

Errores de versión

ApiVersionError.UPDATE_TO_NEWER_VERSION

Resumen
La aplicación inició una solicitud que requiere una versión más reciente para tener éxito o inició una solicitud a una versión obsoleta.
Causas habituales
  • La versión de la llamada a la API dejó de estar disponible. Suscríbete a nuestro blog para recibir anuncios de baja.
  • La solicitud que realizaste requiere una versión más reciente de la API para que se complete correctamente. Este suele ser el caso cuando se introduce una función en la IU y, para que la API envíe el objeto correctamente, necesita una versión más reciente de la API.
Sugerencias de manipulación recomendadas
  • Mantente al tanto de las versiones de la API y planifica actualizaciones periódicas.
  • Suscríbete a nuestro blog para recibir notificaciones sobre las bajas.

Error 404

Resumen
Tu solicitud no llegó al servidor.
Causas habituales
Es posible que tu conexión a Internet o el proxy estén mal configurados. También es posible que se retire la versión de la API a la que llamas.
Sugerencias de manipulación recomendadas
Verifica tu configuración de Internet o proxy, y asegúrate de usar una versión reciente de la API. También puedes actualizar la biblioteca cliente a la versión más reciente.
Sugerencias de prevención
Consulta la Comunidad de ayuda de Ad Manager y nuestro blog para mantenerte al tanto de las novedades más recientes de la API de Ad Manager.

Error de desorganización

Resumen
El XML de SOAP de tu solicitud no se ajustaba a la especificación de WSDL.
Causas habituales
La solicitud contiene campos o entidades que no se incluyen en la especificación de WSDL o que se encuentran en el espacio de nombres incorrecto.
Hay una discrepancia de tipo en la solicitud (p.ej., un campo de número entero tiene un valor de cadena).
Sugerencias de manipulación recomendadas
Asegúrate de que tu solicitud cumpla con la especificación de WSDL.
Usa una biblioteca cliente para generar un SOAP válido y úsalo para realizar la comparación. Todas las bibliotecas cliente admiten el registro de solicitudes y respuestas de SOAP.