API 工作流程

本指南介绍了在 Display & Video 360 中创建、检索和更新竞价包的常见 API 工作流程。

获取竞价包列表

调用 LIST API。 支持按 external_deal_id 进行过滤。

创建新的竞价包

1. external_deal_id 必须是唯一的。使用 external_deal_id 调用 LIST，查看 ID 是否已被使用。
2. 调用 Create API。 系统将分配一个唯一名称，该名称可用于获取创建的软件包。
3. 调用 Get API 以查看已创建的竞价包的详细信息。
4. （可选）为创建的软件包上传徽标。

更新拍卖方案

1. 如果您未存储创建的竞价包名称，请调用按 external_deal_id 过滤的 LIST API，以获取要更新的竞价包。
2. 根据 LIST API 的结果更新相应字段。
3. 调用 Patch API 以更新竞价包。updateMask 是必需的。它用于指明您希望将更新应用于哪些字段。只有允许更新的字段才能在updateMask中设置。

Beta 流程

Beta 版与正式版之间的唯一区别是，在 Beta 版期间，创建的竞价包必须将状态设置为 DISCOVERY_OBJECT_STATUS_PAUSED，并且无法更新状态。暂停的程序包不会显示在 DV360 界面中。这为交易所提供了一种测试 API 集成的方法，而无需显示测试软件包。

通常的做法是在 Beta 版中将所有“真实”软件包创建为 PAUSED，然后在正式版中激活它们。

配额

每个交易平台 2,000 个有效套餐。

每个广告交易平台最多可暂停 2,000 个广告资源包。