常见问题解答
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
一般措施
该 API 的最新版本是什么?
本文档介绍的 API 的最新版本是 v2
。
我可以使用此 API 管理资源配置吗?
不可以。请使用 Display & Video 360 API 创建、检索和管理 Display & Video 360 资源。
使用 API
使用什么网址访问 API?
https://doubleclickbidmanager.googleapis.com
支持哪些身份验证方法?
OAuth 2.0 是唯一受支持的身份验证方法。所有请求都必须针对以下范围进行授权:
https://www.googleapis.com/auth/doubleclickbidmanager
我想编写代码。在哪里可以找到客户端库?
参阅客户端库指南。
我需要哪些 Display & Video 360 权限?
若要使用 Bid Manager API,需进行身份验证的 Google 帐号必须是 Display & Video 360 用户,并且有权访问您要检索其效果数据的合作伙伴或广告客户。
Display & Video 360 用户必须拥有以下针对合作伙伴或广告客户的用户角色之一:
- 仅限报表
- 读取
- 标准
- 管理
- 仅限报告 - 受限(仅限可与客户分享的报告)
我可以在报告中同时使用哪些指标和过滤条件?
报告需要遵守与报告类型、过滤条件、维度和指标相关的许多限制和要求。
为避免使用 API 调试这些限制,请使用 Display & Video 360 界面生成符合这些限制的新报告。
支持
此 API 是否有任何已知问题或限制?
您的项目每秒和每天可以发出的 API 请求数存在限制,请参阅我们的用量限额指南。
还有其他限制吗?
除了 API 限额之外,整个产品的 Display & Video 360 报告用量配额还限制了您的用户在一天内可以主动安排或生成的报告数量。
如需了解如何在使用 API 时考虑这些报告配额,请参阅我们的报告最佳做法。
在哪里公布了相关变更?
Bid Manager API 变更会在 Google Ads 开发者博客上公布。
整个产品的 Display & Video 360 报告变更会在 Display & Video 360 帮助中心公布。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-31。
[null,null,["最后更新时间 (UTC):2025-08-31。"],[[["\u003cp\u003eThis API, currently in version v2, allows retrieval of performance data but not resource configuration management.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is exclusively through OAuth 2.0, with all requests needing authorization for the 'https://www.googleapis.com/auth/doubleclickbidmanager' scope.\u003c/p\u003e\n"],["\u003cp\u003eDisplay & Video 360 users must have specific roles (Reporting only, Read, Standard, Admin, Reporting only -- limited) to access data through the API.\u003c/p\u003e\n"],["\u003cp\u003eReport building should be done through the Display & Video 360 interface to ensure compliance with restrictions on metrics and filters.\u003c/p\u003e\n"],["\u003cp\u003eUsage is subject to API request limits per project, as well as product-wide Display & Video 360 reporting quotas.\u003c/p\u003e\n"]]],[],null,["# Frequently Asked Questions\n\nGeneral\n-------\n\n### What's the latest version of the API?\n\nThe latest version of the API that this document addresses is\n`v2`.\n\n### Can I manage resource configurations using this API?\n\nNo. Use the [Display \\& Video 360 API](/display-video/api) to create, retrieve, and\nmanage Display \\& Video 360 resources.\n\nUse the API\n-----------\n\n### What URL do I use to access the API?\n\n`https://doubleclickbidmanager.googleapis.com`\n\n### What methods of authentication are supported?\n\nOAuth 2.0 is the only supported method of authentication. All requests must be\nauthorized for the following scope:\n\n- `https://www.googleapis.com/auth/doubleclickbidmanager`\n\n### I want to write code. Where can I find client libraries?\n\nRefer to the [client library](/bid-manager/libraries) guide.\n\n### What Display \\& Video 360 permissions do I need?\n\nIn order to use the Bid Manager API, the authenticating Google Account must be a\nDisplay \\& Video 360 user with access to the partners or advertisers for which\nyou want to retrieve performance data.\n\nThe Display \\& Video 360 user must have one of the following [user\nroles](//support.google.com/displayvideo/answer/2723011) for the partners or advertisers:\n\n- Reporting only\n- Read\n- Standard\n- Admin\n- Reporting only -- limited (restricted to [client-safe](//support.google.com/displayvideo/answer/6078439) reports)\n\n### What metrics and filters can I use together in a report?\n\nReports are subject to a number of restrictions and requirements pertaining to\nreporting types, filters, dimensions, and metrics.\n\nTo avoid debugging these restrictions using the API, use the [Display \\& Video\n360 interface](//displayvideo.google.com) to build new reports that adhere to these restrictions.\n\nSupport\n-------\n\n### Does the API have any known issues or limitations?\n\nThere are limits on the number of API requests your project can make per second\nand per day, which are outlined in our [usage limits guide](/bid-manager/quotas).\n\n### Are there any additional limitations I should know about?\n\nIn addition to the API limits, there are product-wide Display \\& Video 360\nreporting usage quotas that limit the number of reports that your user can have\nactively scheduled or run in a single day.\n\nInstructions on how to consider these reporting quotas when using the API are\navailable in our [reporting best practices](/bid-manager/guides/scheduled-reports/best-practices#consider_reporting_quotas).\n\n### Where are any relevant changes announced?\n\nBid Manager API changes are announced on the [Google Ads Developer\nBlog](//ads-developers.googleblog.com/search/label/dbm_api).\n\nProduct-wide Display \\& Video 360 reporting changes are announced on the [Display\n\\& Video 360 help center](//support.google.com/displayvideo/announcements/9210754)."]]