API 工作流程
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
获取竞价包列表
调用 LIST API。支持按 external_deal_id 过滤
创建新的竞价包
- external_deal_id 必须是唯一的。使用 external_deal_id 调用 LIST,查看该 ID 是否已被使用。
- 调用 Create API。系统将分配一个唯一的名称,该名称可用于获取已创建的软件包。
- 调用 Get API 以查看已创建的竞价包的详细信息。
- (可选)为创建的软件包上传徽标。
更新竞价包
- 如果您未存储所创建的竞价包名称,请调用 LIST API,按 external_deal_id 进行过滤,以获取要更新的竞价包。
- 根据 LIST API 的结果更新相应字段。
- 调用 Patch API 以更新竞价包。“updateMask”是必需的,用于指明您希望将更新应用于哪些字段。只有允许更新的字段才能在“updateMask”中设置。
Beta 版流程
Beta 版与正式版之间的唯一区别在于,在 Beta 版期间,创建的竞价包需要将状态设置为“DISCOVERY_OBJECT_STATUS_PAUSED”,并且无法更新状态。暂停的软件包不会显示在 DV3 界面中。这是为了让交易所能够测试 API 集成,而无需显示测试软件包。
通常的做法是在 Beta 版中将所有“真实”软件包创建为 PAUSED,然后在 GA 后将其“激活”。
配额
每个广告交易平台最多可有 2,000 个有效资源包。
每个广告交易平台最多可暂停 2,000 个广告资源包。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-10-08。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-10-08。"],[],["Auction package management involves listing, creating, and updating. To list packages, use the LIST API, filtering by `external_deal_id`. Creation requires a unique `external_deal_id` and uses the Create API; retrieve package details with the Get API. Updating involves using the LIST API to retrieve the package, modifying fields, and using the Patch API with an `updateMask`. During beta, created packages must be \"PAUSED\" and cannot have their status changed. Each exchange has a quota of 1000 active and 1000 paused packages.\n"]]