配额

Display & Video 360 API 配额限制了项目可以向该 API 发出请求的速率。

请遵循以下最佳实践，以便更好地利用 Display & Video 360 API 配额。

同时向多个广告客户发出请求

Display & Video 360 API 配额是按项目和广告客户设置的。项目配额限制项目发出的请求。广告客户配额用于限制项目向广告客户发出的请求。

如需使用所有项目配额，请同时向多个广告客户发出请求。

使用 list 查询参数

使用 list 方法查询参数仅包含所需的资源。资源越少，列出资源所需的请求就越少。

list 方法提供三个关键参数：

  • pageSize 设置请求可返回的资源数量。默认页面大小取决于方法。将此值设置为最高值，以便在每次请求中列出更多资源。
  • filter 根据提供的条件限制所列资源。将此值设置为仅列出部分资源。如需了解详情，请参阅过滤列表请求。
  • orderBy 按指定属性对列出的资源进行排序。设置此值可使用更少的请求检索资源列表的上限或下限。

使用批量功能和资源级功能

批量函数和资源级函数可执行复杂的任务。对这些方法的单个请求可以取代对其他方法的多个请求。

如需详细了解这些方法，请参阅批量请求。

缓存 ID

许多 Display & Video 360 API 操作都需要使用通过该 API 检索到的 ID。例如，定位选项 ID 和 Google 受众群体 ID。在本地存储 ID，这样您就不需要不断检索它们。

使用已弃用或已删除的资源的 ID 可能会返回错误。您应每周检索缓存的 ID，以确认其状态。

使用指数退避算法

指数退避算法是一种错误处理策略。它会尝试请求，但两次重试之间间隔的时间会不断增加。

在轮询长时间运行的任务（例如 SDF 下载任务）时，指数退避算法策略可以减少发送的请求数量。

我们的 SDF 下载代码示例使用指数退避算法和我们的客户端库。以下是指数退避算法流程的示例：

  • 使用 get 请求检索 Operation 对象。
    • 如果 done 不为 true，则任务仍在运行。
    • 等待 5 秒 + 随机秒数，然后重试该请求。
  • 检索操作。
    • 如果 done 不为 true，则任务仍在运行。
    • 等待 10 秒 + 随机秒数，然后重试该请求。
  • 检索操作。
    • 如果 done 不为 true，则任务仍在运行。
    • 等待 20 秒加上随机秒数，然后重试该请求。
  • 检索操作。
    • 如果 done 不为 true，则任务仍在运行。
    • 等待 40 秒加上随机秒数，然后重试该请求。
  • 检索操作。
    • 如果 done 不为 true，则任务仍在运行。
    • 等待 80 秒加上随机秒数，然后重试该请求。
  • 继续此模式，直到 done 为 true 或达到最大经过时间。