通过

内容 API 入门

  • 项目

若要使用内容 API，需要以下几点：

  1. Microsoft 帐户
  2. Microsoft Advertising 帐户
  3. 开发人员令牌

若要获取 Microsoft Advertising 帐户，请转到 https://ads.microsoft.com。 如果你未登录到 Microsoft 帐户，系统会重定向你登录到你的帐户或注册帐户。 登录后，可以选择 注册新的 Microsoft Advertising 帐户。 选择注册选项，然后单击“ 继续”。

接下来，如果还没有用于生产环境的 Microsoft Advertising 开发人员令牌，请转到 开发人员门户。 单击“ 请求令牌 ”并提供请求的信息。 如果使用 API 管理自己的帐户，将立即收到令牌;但是，如果你正在为其他人管理帐户，则最多可能需要 5 个工作日才能获取令牌。

对凭据进行身份验证

重要

从 2022 年 6 月 1 日起，我们将要求所有通过使用必应广告 API、内容 API 和酒店 API 的第三方应用程序登录的用户进行多重身份验证。

必须使用新msads.manage范围更新应用程序才能获得用户同意。 所有应用程序开发人员都必须采取措施才能使用新范围。

有关详细信息，请参阅 多重身份验证要求 指南。

内容 API 使用与必应广告 API 相同的身份验证方案。 有关使用 OAuth 对 Microsoft 帐户凭据进行身份验证的详细信息，请参阅使用 Microsoft 标识平台进行身份验证。

可以使用适用于 .NET、Java 或 Python 的必应广告 SDK 对 Microsoft 帐户凭据进行身份验证。 有关使用 SDK 获取访问令牌的详细信息，请参阅 C# | Java | Python。 有关使用 SDK 进行身份验证的内容 API 示例，请参阅 管理产品示例。

(请注意，必应广告 SDK 不提供内容 API 的接口。如果你也使用适用于 Microsoft 广告活动的 SDK，则只应使用该 SDK 来获取访问令牌。否则，安装 SDK.)

如果不使用必应广告 SDK 进行身份验证，请参阅 使用 C# 对 Microsoft 帐户凭据进行身份验证 ，获取演示如何使用 OAuth 对 Microsoft 帐户凭据进行身份验证的示例。

在哪里使用凭据和开发人员令牌？

所有调用都必须指定：

  • 设置为开发人员令牌的 DeveloperToken 标头。
  • 设置为访问令牌的 AuthenticationToken 标头。

如果代表其他客户管理目录，则还必须设置以下标头：

  • CustomerId 标头，该标头设置为要管理其商店的客户的客户 ID
  • CustomerAccountId 标头设置为你管理的任何客户帐户的帐户 ID， (哪个托管帐户) 并不重要。

有关请求和响应可能包含的这些标头和其他标头的信息，请参阅 标头。

将 Microsoft 商家中心配置为使用 API

有关 Microsoft 商家中心 (MMC) 的概述，请参阅 什么是 Microsoft 商家中心？ 该主题包括指向所有商家中心主题和相关视频的链接。

如果尚未完成以下步骤，则必须完成以下步骤。

  1. 验证并声明网站的 URL 若要获取验证和声明网站 URL 中提到的网站管理员工具，请参阅 必应网站管理员工具。 使用用于 Microsoft Advertising 的同一 Microsoft 帐户登录。 有关使用该工具的详细信息，请参阅 验证网站的所有权。
  2. 创建 Microsoft 商家中心商店
  3. 添加目录

创建 MMC 存储时，该过程会为你创建一个默认目录。 自动为 API 管理启用存储和创建的所有目录。 应用商店包含默认目录，默认情况下，所有产品操作 (添加、更新、删除和获取) 。 若要指定其他目录，请在资源 URL 中使用 bmc-catalog-id 查询参数。

若要添加和启用目录，请使用 目录 资源。 有关详细信息，请参阅 管理目录。

注意

在某些情况下，可以使用 API 和 FTP/SFTP 更新目录源。 有关将 API 与 FTP/SFTP 配合使用的信息，请参阅 是否可以使用 API 和 FTP/SFTP？

后续步骤

现在，你已准备好开始使用 API，请参阅以下部分。