Freigeben über

Exemplarische Vorgehensweise: Bing Ads-API-Desktopanwendung in Java

  • Artikel

In diesem Leitfaden wird beschrieben, wie Sie Java-Beispiele für die Bing Ads-API aus der GitHub-Quelle herunterladen, mit Ihren Anmeldeinformationen bearbeiten und in einer lokalen Konsole ausführen können.

Standardmäßig können die Beispiele in der Sandboxumgebung ausgeführt werden. Wenn Sie die Produktionsumgebung als Ziel verwenden, benötigen Sie auch Ihr Produktionsentwicklertoken. Sie müssen auch eine Anwendung registrieren und sich die Anwendungs-ID notieren, die in der folgenden exemplarischen Vorgehensweise als ClientID verwendet wird. Weitere Informationen zum Registrieren einer Anwendung und zum Autorisierungscodegenehmigungsflow finden Sie unter Authentifizierung mit OAuth.

Code Exemplarische Vorgehensweise

  1. Installieren Sie Visual Studio Code und den Debugger für Java . Sie können diese Schritte ändern, wenn Sie bereits mit einem anderen Editor oder einer anderen Entwicklungsumgebung vertraut sind.

  2. Laden Sie Git herunter, und installieren Sie es.

  3. Navigieren Sie zu einem leeren lokalen Verzeichnis, z. B. c:\dev\BingAdsJava , und klonen Sie das Bing Ads Java SDK, git clone https://github.com/BingAds/BingAds-Java-SDK.gitz. B. . Nun sollte das SDK-Verzeichnis angezeigt werden, das sowohl die SDK-Quelle als auch Beispiele enthält.

  4. Öffnen Sie Visual Studio Code, und öffnen Sie das Verzeichnis BingAdsDesktopApp (Datei... Ordner öffnen...) Beispiel : C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp.

  5. Standardmäßig können die Beispiele in der Sandboxumgebung ausgeführt werden. Um die Produktion zu verwenden, legen Sie in C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp\src\Standard\java\com\microsoft\bingads\examples\ExampleBase.java die API_ENVIRONMENT auf ApiEnvironment.PRODUCTION fest, und bearbeiten Sie die Client-ID mit der Anwendungs-ID, die bei der Registrierung Ihrer Anwendung bereitgestellt wurde. Außerdem müssen Sie den DeveloperToken-Wert mit Ihrem Produktionsentwicklertoken bearbeiten.

  6. Fügen Sie Ihrem Projekt die Maven-Abhängigkeit für Microsoft.bingads hinzu, bevor Sie API-Aufrufe ausführen.

  7. Klicken Sie mit der rechten Maustaste auf SearchUserAccounts.java, und klicken Sie dann auf Ausführen.

  8. Sie sollten aufgefordert werden, die Autorisierungs-URL zu kopieren und in einen Webbrowser einzufügen. Die einmalige Zustimmung des Benutzers ist erforderlich, und danach können Sie das Aktualisierungstoken verwenden, um neue Zugriffs- und Aktualisierungstoken anzufordern.

  9. Nachdem Sie Ihre Anwendung für die Verwaltung Ihrer Microsoft Advertising-Konten autorisiert haben, kopieren Sie die resultierende URL (mit dem Codeparameter ), und fügen Sie sie in das Konsolenfenster ein. Drücken Sie dann die EINGABETASTE (Rückgabe), um die Ausführung fortzusetzen.

  10. Das Aktualisierungstoken wird inrefresh.txtgeschrieben. Nachfolgende Aufrufe der authenticateWithOAuth-Hilfsfunktion versuchen, das Aktualisierungstoken vom gleichen Speicherort aus zu lesen. Sie können den Speicherort ändern, indem Sie die Einstellung RefreshTokenPath in ExampleBase.java bearbeiten.

    Wichtig

    Dieses Schnellstartbeispiel wird in der Produktion nicht unverändert empfohlen. Sie sollten das Aktualisierungstoken nur an einem sicheren Ort speichern.

Siehe auch

Sandbox
Codebeispiele für die Bing Ads-API
Adressen des Bing Ads-API-Webdiensts