チュートリアル: Java Bing Ads API Desktop アプリケーション
このガイドでは、 GitHub ソースから Bing Ads API の Java の例をダウンロードし、資格情報を使用して編集し、ローカル コンソールで実行する方法について説明します。
既定では、例はサンドボックス環境で実行する準備ができています。 運用環境を対象とする場合は、運用 開発者トークンも必要です。 また、アプリケーションを登録し、以下のチュートリアルで ClientId として使用されるアプリケーション ID を書き留める必要があります。 アプリケーションの登録と承認コード付与フローの詳細については、「 OAuth による認証」を参照してください。
コードチュートリアル
Visual Studio Code とデバッガー for Java をインストールします。 別のエディターまたは開発環境に既に慣れている場合は、これらの手順を変更できます。
Git をダウンロードしてインストール します。
空のローカル ディレクトリ ( 例: c:\dev\BingAdsJava ) に移動し、「」と入力
git clone https://github.com/BingAds/BingAds-Java-SDK.gitして、Bing Ads Java SDK を複製します。 SDK のソースと例の両方を含む SDK ディレクトリが表示されます。Visual Studio Code を開き、BingAdsDesktopApp ディレクトリ (File...フォルダーを開く...)たとえば、 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設定し、アプリケーションを登録したときにプロビジョニングされたアプリケーション ID で ClientId を編集します。 また、運用開発者トークンを使用して DeveloperToken 値を編集する必要もあります。API 呼び出しを行う前に、Microsoft.bingads の Maven 依存関係をプロジェクトに追加します。
[SearchUserAccounts.java] を右クリックし、[実行] をクリックします。
承認 URL をコピーして Web ブラウザーに貼り付ける必要があります。 1 回限りのユーザーの同意が必要です。その後、更新トークンを使用して新しいアクセストークンと更新トークンを要求できます。
Microsoft Advertising アカウントの管理をアプリケーションに承認したら、結果の URL ( コード パラメーター付き) をコピーし、コンソール ウィンドウに貼り付けます。 次に、 Enter キー (return) キーを押して実行を続行します。
更新トークンは refresh.txtに書 き込まれます。 authenticationWithOAuth ヘルパー関数の後続の呼び出しでは、同じ場所から更新トークンの読み取りが試行されます。 場所を変更するには、ExampleBase.java 内の RefreshTokenPath 設定を編集します。
重要
このクイック スタートの例は、運用環境ではそのままお勧めしません。 更新トークンは、セキュリティで保護された場所にのみ格納する必要があります。