Errores comunes

En esta página, se describen los errores que se devuelven con mayor frecuencia en 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 pueden agregar más elementos secundarios a esa entidad.
Sugerencias de manipulación recomendadas
Crea un nuevo tipo de entidad que haya alcanzado la cantidad máxima permitida de elementos secundarios 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, reuniendo los cambios de forma local y realizando una sola solicitud para aplicar 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 correctamente. Si vuelve a fallar, intenta aumentar el tiempo de espera. Se recomienda para las 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 con Ad Manager y 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 nueva Cuenta de Google 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 la solicitud 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 de 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 respuesta XML de SOAP.

AuthenticationError.NETWORK_NOT_FOUND

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

AuthenticationError.NO_NETWORKS_TO_ACCESS

Resumen
El usuario no está asociado a 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 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 blanca para la 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 requerido para 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 creas una IU, indícale al usuario que no tenía permiso para realizar esta acción y que debe hablar con su administrador.
  • Si intentaste realizar una tarea, como una que involucra una función exclusiva para usuarios premium que tu red no tiene permiso para usar, habla con tu administrador de cuentas para habilitar esta función.
  • Recuerda que las redes de prueba no son redes de Ad Manager 360 de forma predeterminada, lo que significa que no tienen las funciones premium que se encuentran en las redes de Ad Manager 360. Habla con tu administrador de cuentas para habilitar funciones en tu red de prueba.

Errores de versión

ApiVersionError.UPDATE_TO_NEWER_VERSION

Resumen
La aplicación hizo una solicitud que requiere una versión más reciente para completarse correctamente o hizo 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 sobre las bajas.
  • La solicitud que realizaste requiere una versión más reciente de la API para completarse 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 día con 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 proxy estén mal configurados. También es posible que se descontinúe la versión de la API que llamas.
Sugerencias de manipulación recomendadas
Verifica la configuración de Internet o del proxy y asegúrate de usar una versión reciente de la API. También te recomendamos que actualices tu 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 de la API de Ad Manager.

Error de deserialización

Resumen
El XML de SOAP de tu solicitud no cumplió con la especificación de WSDL.
Causas habituales
La solicitud contiene campos o entidades que no se incluyen en la especificación de WSDL o en el espacio de nombres incorrecto.
Hay una discrepancia de tipos en la solicitud (p.ej., un campo de números enteros 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 SOAP válidos y úsalos para la comparación. Todas las bibliotecas cliente admiten el registro de solicitudes y respuestas de SOAP.