Errores comunes

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

Errores de límite de entidades

EntityChildrenLimitReachedError

Resumen
Se alcanzó la cantidad máxima de elementos secundarios permitidos para la entidad, y no se le pueden agregar más elementos secundarios.
Sugerencias de manejo recomendadas
Crea un tipo nuevo de entidad que haya alcanzado 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 a él la línea de pedido que intentas crear.

Errores de cuota

QuotaError.EXCEEDED_QUOTA

Resumen
La cantidad de solicitudes realizadas por segundo es demasiado alta y se superó el límite permitido.
Sugerencias de manejo recomendadas
  • Usa métodos por lotes, como updateLineItems, para recopilar los cambios de forma local y realizar una única solicitud a fin de completar todos esos cambios a la vez.
  • Espera unos 5 segundos y vuelve a enviar la solicitud. Ten en cuenta que esto no garantiza que la solicitud se realice de forma correcta. Si vuelve a fallar, aumenta el tiempo de espera. Esto se recomienda para las aplicaciones interactivas que se integran en Ad Manager y que 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. Esto se recomienda para las aplicaciones que se integran con Ad Manager y que no tienen interacción en tiempo real, como ejecutar 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 nueva Cuenta de Google antes de llamar a NetworkService.makeTestNetwork().
Sugerencias de manejo 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 manejo recomendadas
Incluye el código de red de la red que se aborda en el encabezado de la solicitud. Usa solo 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 de encabezados de respuesta y solicitud XML de SOAP.

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 manejo recomendadas
El campo "activador" del registro de errores a menudo 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 tener acceso a la API.
Sugerencias de manejo recomendadas
Habilita el acceso a la API para tu entorno de producción. Consulta Cómo habilitar 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 blanca 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 de SOAP.
Sugerencias de manejo 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 leer o actualizar.
  • Intentaste realizar una tarea que requiere una función adicional para habilitar en tu cuenta.
Sugerencias de manejo recomendadas
  • Si estás creando una IU, indícale al usuario que no tenía permiso para realizar esta acción y hablar con su administrador.
  • Si intentaste realizar una tarea, por ejemplo, una relacionada con una función premium que tu red no tiene permiso para hacer, comunícate con tu administrador de cuentas para habilitar esta función.
  • Recuerda que, de forma predeterminada, las redes de prueba no son de Ad Manager 360, lo que significa que no tienen las funciones premium de 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 completarse correctamente 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 conocer los anuncios de baja.
  • La solicitud que realizaste requiere una versión más reciente de la API para ejecutarse correctamente. Este suele ser el caso cuando se incorpora 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 manejo 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 la conexión a Internet o el proxy estén mal configurados. Es posible que la versión de la API a la que llamas también deje de estar disponible.
Sugerencias de manejo recomendadas
Verifica tu configuración de Internet o del proxy y asegúrate de usar una versión reciente de la API. Te recomendamos que también actualices tu biblioteca cliente a la versión más reciente.
Sugerencias de prevención
Suscríbete al foro de la API de Ad Manager y consulta nuestro blog para mantenerte al tanto de las noticias más recientes sobre la API de Ad Manager.

Error de selección

Resumen
El XML de SOAP en tu solicitud no cumplía con la especificación del WSDL.
Causas habituales
La solicitud contiene campos o entidades no incluidas en la especificación WSDL o en un espacio de nombres incorrecto.
Hay una discrepancia de tipo en la solicitud (p.ej., un campo de números enteros tiene un valor de string).
Sugerencias de manejo recomendadas
Asegúrate de que tu solicitud cumpla con la especificación del WSDL.
Usa una biblioteca cliente para generar SOAP válido y úsala para realizar comparaciones. Todas las bibliotecas cliente admiten el registro de solicitudes y respuestas de SOAP.