Cuota

La cuota de la API de Display & Video 360 limita la frecuencia con la que un proyecto puede realizar solicitudes a la API.

Sigue estas prácticas recomendadas para aprovechar mejor tu cuota de la API de Display & Video 360.

Realiza solicitudes en varias cuentas de anunciantes al mismo tiempo

La cuota de la API de Display & Video 360 se establece por proyecto y por anunciante. Los límites de cuota del proyecto restringen las solicitudes que realiza un proyecto. La cuota del anunciante limita las solicitudes que un proyecto puede realizar a un anunciante.

Para usar toda la cuota de tu proyecto, realiza solicitudes en todos los anunciantes al mismo tiempo.

Usa parámetros de consulta list

Usa los parámetros de consulta del método list para incluir solo los recursos deseados. Cuantos menos recursos haya, menos solicitudes se necesitarán para enumerarlos.

Los métodos list ofrecen tres parámetros clave:

  • pageSize establece la cantidad de recursos que puede devolver la solicitud. El tamaño de página predeterminado depende del método. Establece este valor en el más alto para incluir más recursos por solicitud.
  • filter limita los recursos enumerados según los criterios proporcionados. Establece este parámetro para enumerar solo un subconjunto de recursos. Consulta Solicitudes de listas de filtros para obtener más información.
  • orderBy ordena los recursos enumerados según la propiedad proporcionada. Establece este parámetro para recuperar el límite superior o inferior de la lista de recursos con menos solicitudes.

Usa funciones masivas y para todos los recursos

Las funciones masivas y las que abarcan todos los recursos realizan tareas complejas. Una sola solicitud a estos métodos puede reemplazar varias solicitudes a otros.

Para obtener más información sobre estos métodos, consulta Solicitudes masivas.

IDs de caché

Muchas acciones de la API de Display & Video 360 requieren IDs recuperados con la API. Entre los ejemplos, se incluyen los IDs de opciones de segmentación y los IDs de públicos de Google. Almacena los IDs de la tienda de forma local para que no tengas que recuperarlos constantemente.

Usar IDs para recursos que están obsoletos o borrados puede devolver un error. Debes recuperar los IDs almacenados en caché semanalmente para confirmar su estado.

Usa la retirada exponencial

La retirada exponencial es una estrategia de manejo de errores. Vuelve a intentar realizar solicitudes durante un período cada vez mayor.

Cuando sondea una tarea de larga duración, como una tarea de descarga de SDF, una estrategia de retirada exponencial puede reducir la cantidad de solicitudes enviadas.

Nuestros ejemplos de código de descarga del SDF usan la retirada exponencial con nuestras bibliotecas cliente. A continuación, se muestra un ejemplo de flujo de retirada exponencial:

  • Recupera el objeto Operation con la solicitud get.
    • Si done no es verdadero, la tarea aún se está ejecutando.
    • Espera 5 segundos más una cantidad aleatoria de segundos y, luego, reintenta la solicitud.
  • Recupera la operación.
    • Si done no es verdadero, la tarea aún se está ejecutando.
    • Espera 10 segundos más una cantidad aleatoria de segundos y, luego, reintenta la solicitud.
  • Recupera la operación.
    • Si done no es verdadero, la tarea aún se está ejecutando.
    • Espera 20 segundos más una cantidad aleatoria de segundos y, luego, reintenta la solicitud.
  • Recupera la operación.
    • Si done no es verdadero, la tarea aún se está ejecutando.
    • Espera 40 segundos más una cantidad aleatoria de segundos y, luego, reintenta la solicitud.
  • Recupera la operación.
    • Si done no es verdadero, la tarea aún se está ejecutando.
    • Espera 80 segundos más una cantidad aleatoria de segundos y, luego, reintenta la solicitud.
  • Continúa con este patrón hasta que done sea verdadero o se alcance un tiempo máximo transcurrido.