演练:Java 中的必应广告 API 桌面应用程序

本指南介绍如何从 GitHub 源下载必应广告 API 的 Java 示例、使用凭据进行编辑,以及如何在本地控制台中运行。

默认情况下,这些示例已准备好在沙盒环境中运行。 如果面向生产环境,则还需要生产 开发人员令牌。 还需要注册应用程序,并记下将在下面的演练中用作 ClientId 的应用程序 ID 。 有关注册应用程序和授权代码授予流的详细信息,请参阅 使用 OAuth 进行身份验证

代码演练

  1. 安装 Visual Studio Code适用于 Java 的调试器。 如果已熟悉其他编辑器或开发环境,则可以修改这些步骤。

  2. 下载并安装 Git

  3. 导航到空的本地目录(例如 c:\dev\BingAdsJava), 并克隆必应广告 Java SDK,例如键入 git clone https://github.com/BingAds/BingAds-Java-SDK.git。 现在应会看到包含 SDK 源和示例的 SDK 目录。

  4. 打开Visual Studio Code并打开 BingAdsDesktopApp 目录 (文件...Open Folder...) 例如 C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp

  5. 默认情况下,这些示例已准备好在沙盒环境中运行。 若要使用生产,请在 C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp\src\main\java\com\microsoft\bingads\examples\ExampleBase.java 中,将API_ENVIRONMENT设置为 ApiEnvironment.PRODUCTION ,并使用注册应用程序时预配的应用程序 ID 编辑 ClientId。 还需要使用生产开发人员令牌编辑 DeveloperToken 值。

  6. 在进行 API 调用之前,将 Microsoft.bingads 的 Maven 依赖项添加到项目。

  7. 右键单击“SearchUserAccounts.java”,然后单击“运行”。

  8. 系统应提示复制授权 URL 并将其粘贴到 Web 浏览器中。 需要一次性用户同意,之后你将能够使用刷新令牌来请求新的访问和刷新令牌。

  9. 授权应用程序管理 Microsoft Advertising 帐户后,使用 代码 参数) 复制生成的 URL (并将其粘贴到控制台窗口中。 然后按 Enter (返回) 键以继续执行。

  10. 刷新令牌将写入 refresh.txt。 对 authenticateWithOAuth 帮助程序函数的后续调用将尝试从同一位置读取刷新令牌。 可以通过编辑 ExampleBase.java 中的 RefreshTokenPath 设置来更改位置。

    重要

    不建议在生产环境中按原样使用此快速入门示例。 应仅将刷新令牌存储在安全位置。

另请参阅

沙盒
必应广告 API 代码示例
必应广告 API Web 服务地址