常见问题解答

Microsoft Q&A 论坛可供开发人员社区提问和回答有关Bing Ads API 和Microsoft广告脚本的问题。 Microsoft监视论坛，并回复社区尚未回答的问题。

如果调查涉及敏感帐户或个人详细信息，或者如果您没有找到通过 Microsoft Q&A 解决问题所需的信息，请联系 Microsoft广告支持。 若要有效地解决此问题，请提供支持，并提供 参与支持中请求的详细信息。

发行说明和迁移指南是很好的入门资源。

可以通过开发人员门户的“ 新闻 ”选项卡注册每月新闻稿，这也是汇总最新 博客 公告的位置。

若要 开始，需要注册 Microsoft广告 帐户，然后通过开发人员门户的“ 帐户 ”选项卡获取开发人员令牌。

可以使用支持 Web 服务的任何编程语言开发Bing Ads API 应用程序。 Bing Ads API 软件开发工具包 (SDK) 增强了使用 .NET、Java、PHP 和 Python 语言开发Bing Ads API 应用程序的体验。 每个 SDK 都包含所有Bing Ads API Web 服务的代理，并提取了使用 OAuth 进行身份验证的低级别详细信息。 可以使用高级 BulkServiceManager 和 ReportingServiceManager 接口在低级别 Bulk 和 Reporting 服务中抽象和执行操作。

我们已听到有关其他 SDK（例如 Perl 和 Ruby）的请求，但近期没有计划添加支持。

除了 代码示例 ，还可以在许多技术指南（例如 入门 指南）中找到代码片段。 可以使用这些页面顶部或右侧的语言选择器查看 CSharp、Java、Php 或 Python 中的示例。 选择语言时，会在导航其他页面时保留该设置。 语言选择器将仅包括具有该特定页面示例的语言，并且如果之前设置的语言不适用于导航到的页面，则默认为 C#。

建议 使用批量服务 ，尤其是在需要跨帐户中的多个广告组或市场活动添加或更新广告和关键字时。 某些功能在批量中不可用，例如 AddUetTags、 GetBMCStoresByCustomerId、 GetGeoLocationsFileUrl 和 GetMediaMetaDataByAccountId。 当然，对于这些功能，必须使用 市场活动管理服务。

Reporting 服务支持大多数可以在 Microsoft Advertising Web 应用程序中找到的相同 报表类型 。 请务必检查报表属性和性能统计信息以及报告数据保留时间段指南，了解可用性详细信息。

当用户单击广告时，系统最多可能需要 2 小时才能处理点击 (3 小时，以便) 转换并使其可供报告。 当前一天的所有数据都已处理并可供报告时，此状态称为“已关闭书籍”。 有关何时关闭书籍进行报告的详细信息，请参阅 Reporting 中的时区。

必须通过 Microsoft 标识平台 终结点更新应用程序以使用新msads.manage范围。 所有应用程序开发人员都必须采取措施才能使用新范围。

必须通过新msads.manage范围和Microsoft 标识平台终结点提示用户同意。

如果具有格式化为十六进制值（例如 0000000012345A67）的较旧应用程序 ID (又称为客户端 ID) ，则必须注册新应用程序。 有效的Microsoft 标识平台应用程序 ID 的格式设置为带短划线的 GUID，例如 00001111-aaaa-2222-bbbb-3333cccc4444。 如果在Azure 门户中看不到现有应用（应用注册），则表明应将其替换为新应用。

是。 必须通过新msads.manage范围和Microsoft 标识平台终结点提示用户同意。

提示用户同意 (将公共租户) 与 Microsoft 标识平台 终结点结合使用时，用户的登录体验将因凭据背后的基础标识而异。

• 只有 MSA 标识的人员将被定向到 MSA 登录页。
• 只有 Azure AD 标识的人员将被定向到其组织登录页。
• 其凭据在 MSA 和 Azure AD 域中都有效的人员将遇到一个消除歧义页面，要求他们在个人标识和工作或学校标识之间进行选择。 只要此用户具有绑定到同一电子邮件地址的两个标识，这种消除歧义就会始终存在。 用户可以通过 更改其个人Microsoft帐户的电子邮件地址来停止看到此内容。 有关详细信息，请参阅 https://cloudblogs.microsoft.com/enterprisemobility/2016/09/15/cleaning-up-the-azure-ad-and-microsoft-account-overlap/。

如果用户不再具有 MSA 个人帐户标识，则Bing Ads API 将不再接受其现有访问令牌。 同样，刷新令牌不能再用于请求新的访问令牌，因此需要再次请求用户同意，以便应用程序管理其Microsoft广告帐户。 应放弃以前的刷新令牌。

不正确。 仅在生产环境中支持工作或学校帐户。

若要以编程方式管理Microsoft广告帐户，必须至少通过 Web 应用程序同意流提供一次同意。 对于重复或长期身份验证，应遵循授权代码授予流来获取访问令牌和刷新令牌。 此后，可以使用最新的刷新令牌来请求新的访问和刷新令牌，而无需进行任何进一步的用户交互。 可能需要再次请求用户同意，例如，如果用户经历了帐户恢复、更改了其密码，或者删除了应用程序代表其进行身份验证的权限。

访问令牌通常在一小时后过期，但每次请求新令牌时，应始终检查过期时间。

刷新令牌对应用程序而言始终是完全不透明的。 它们是长期存在的，例如，对于公共客户端，90 天，但不应写入应用，以预期刷新令牌将持续任何一段时间。 刷新令牌随时可能失效，应用知道刷新令牌是否有效的唯一方法是尝试通过发出令牌请求来兑换刷新令牌。 即使你使用最新的刷新令牌连续刷新同一设备上的令牌，也应该预期会再次启动并请求用户同意，例如，你已将用户注销、Microsoft Advertising 用户更改了其密码、从其受信任设备列表中删除了设备，或者删除了应用程序代表其进行身份验证的权限。 在没有任何事先警告的情况下，Microsoft可以随时确定应再次授予用户同意。 作为最佳做法，每次请求新的访问和刷新令牌时，应始终安全地存储最新的刷新令牌。

访问令牌表示有权访问一个或多个Microsoft广告帐户的用户凭据。 应用程序 ID (a.k.a. client_id) 标识授予同意的每个Microsoft广告用户的应用程序。 开发人员令牌授予应用程序使用Bing Ads API 的权限。

Bing Ads现在是Microsoft广告。 我们的新名称反映了我们如何发展广告解决方案，以帮助你吸引更多客户。 没有计划重新命名任何当前 API 版本。 下表列出了已更改或尚未更改的名称。 有关详细信息，请参阅 品牌公告。