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 个广告资源包。