API 工作流程

获取竞价包列表

调用 LIST API。支持按 external_deal_id 过滤

创建新的竞价包

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

更新竞价包

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

Beta 版流程

Beta 版与正式版之间的唯一区别在于，在 Beta 版期间，创建的竞价包需要将状态设置为“DISCOVERY_OBJECT_STATUS_PAUSED”，并且无法更新状态。暂停的软件包不会显示在 DV3 界面中。这是为了让交易所能够测试 API 集成，而无需显示测试软件包。

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

配额

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

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