共用方式為


逐步解說:JAVA 中的 Bing 廣告 API 傳統型應用程式

本指南說明如何從 GitHub 來源下載 Bing 廣告 API 的 JAVA 範例、使用您的認證進行編輯,以及在本機主控台中執行。

根據預設,範例已準備好在沙箱環境中執行。 如果您的目標是生產環境,則也需要生產 開發人員權杖。 您也必須註冊應用程式,並記下下列逐步解說中將用來作為 ClientId 的應用程式識別碼。 如需註冊應用程式和授權碼授與流程的詳細資訊,請參閱 使用 OAuth 進行驗證

程式碼逐步解說

  1. 安裝Visual Studio Code適用于 JAVA 的偵錯工具。 如果您已經熟悉另一個編輯器或開發環境,您可以修改這些步驟。

  2. 下載並安裝 Git

  3. 流覽至空白的本機目錄,例如 c:\dev\BingAdsJAVA ,然後複製 Bing 廣告 JAVA SDK,例如輸入 git clone https://github.com/BingAds/BingAds-Java-SDK.git 。 您現在應該會看到同時包含 SDK 來源和範例的 SDK 目錄。

  4. 開Visual Studio Code並開啟 BingAdsDesktopApp 目錄 (檔案...開啟資料夾...) 例如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 ,並使用您註冊應用程式時所布建的應用程式識別碼來編輯 ClientId 。 您也需要使用生產開發人員令來編輯DeveloperToken值。

  6. 在進行 API 呼叫之前,將 Microsoft.bingads 的 Maven 相依性新增至您的專案。

  7. 以滑鼠右鍵按一下 SearchUserAccounts.java,然後按一下 [執行]。

  8. 系統應該會提示您將授權 URL 複製並貼到網頁瀏覽器中。 需要使用者同意一次,之後您就可以使用重新整理權杖來要求新的存取和重新整理權杖。

  9. 授權您的應用程式管理您的 Microsoft Advertising 帳戶之後,請複製產生的 URL (並) 程式 代碼 參數,並將它貼到主控台視窗中。 然後按 Enter 鍵 (傳回) 鍵以繼續執行。

  10. 重新整理權杖會寫入 至refresh.txt。 後續對 authenticateWithOAuth 協助程式函式的呼叫會嘗試從相同位置讀取重新整理權杖。 您可以編輯ExampleBase.java內的RefreshTokenPath 設定來變更位置。

    重要事項

    不建議在生產環境中使用此快速入門範例。 您應該只將重新整理權杖儲存在安全的位置。

另請參閱

沙 箱
Bing 廣告 API 程式碼範例
Bing 廣告 API Web 服務位址