逐步解說:JAVA 中的 Bing 廣告 API 傳統型應用程式
本指南說明如何從 GitHub 來源下載 Bing 廣告 API 的 JAVA 範例、使用您的認證進行編輯,以及在本機主控台中執行。
根據預設,範例已準備好在沙箱環境中執行。 如果您的目標是生產環境,則也需要生產 開發人員權杖。 您也必須註冊應用程式,並記下下列逐步解說中將用來作為 ClientId 的應用程式識別碼。 如需註冊應用程式和授權碼授與流程的詳細資訊,請參閱 使用 OAuth 進行驗證。
程式碼逐步解說
安裝Visual Studio Code和適用于 JAVA 的偵錯工具。 如果您已經熟悉另一個編輯器或開發環境,您可以修改這些步驟。
下載並安裝 Git。
流覽至空白的本機目錄,例如 c:\dev\BingAdsJAVA ,然後複製 Bing 廣告 JAVA SDK,例如輸入
git clone https://github.com/BingAds/BingAds-Java-SDK.git
。 您現在應該會看到同時包含 SDK 來源和範例的 SDK 目錄。開Visual Studio Code並開啟 BingAdsDesktopApp 目錄 (檔案...開啟資料夾...) 例如C:\dev\BingAdsJAVA\BingAds-JAVA-SDK\examples\BingAdsDesktopApp。
根據預設,範例已準備好在沙箱環境中執行。 若要使用生產環境,請在 C:\dev\BingAdsJAVA\BingAds-JAVA-SDK\examples\BingAdsDesktopApp\src\main\java\com\microsoft\bingads\examples\ExampleBase.java中,將 API_ENVIRONMENT 設定為
ApiEnvironment.PRODUCTION
,並使用您註冊應用程式時所布建的應用程式識別碼來編輯 ClientId 。 您也需要使用生產開發人員令牌來編輯DeveloperToken值。在進行 API 呼叫之前,將 Microsoft.bingads 的 Maven 相依性新增至您的專案。
以滑鼠右鍵按一下 SearchUserAccounts.java,然後按一下 [執行]。
系統應該會提示您將授權 URL 複製並貼到網頁瀏覽器中。 需要使用者同意一次,之後您就可以使用重新整理權杖來要求新的存取和重新整理權杖。
授權您的應用程式管理您的 Microsoft Advertising 帳戶之後,請複製產生的 URL (並) 程式 代碼 參數,並將它貼到主控台視窗中。 然後按 Enter 鍵 (傳回) 鍵以繼續執行。
重新整理權杖會寫入 至refresh.txt。 後續對 authenticateWithOAuth 協助程式函式的呼叫會嘗試從相同位置讀取重新整理權杖。 您可以編輯ExampleBase.java內的RefreshTokenPath 設定來變更位置。
重要事項
不建議在生產環境中使用此快速入門範例。 您應該只將重新整理權杖儲存在安全的位置。