Procedura dettagliata: Applicazione desktop per l'API Bing Ads in Java

Questa guida descrive come scaricare esempi Java per l'API Bing Ads dall'origine GitHub, modificare con le credenziali ed eseguire in una console locale.

Per impostazione predefinita, gli esempi sono pronti per l'esecuzione nell'ambiente sandbox. Se si ha come destinazione l'ambiente di produzione, è necessario anche il token per sviluppatori di produzione. Sarà anche necessario registrare un'applicazione e prendere nota dell'ID applicazione che verrà usato come ClientId nella procedura dettagliata seguente. Per altre informazioni sulla registrazione di un'applicazione e sul flusso di concessione del codice di autorizzazione, vedere Autenticazione con OAuth.

Procedura dettagliata per il codice

  1. Installare Visual Studio Code e il debugger per Java . È possibile modificare questi passaggi se si ha già familiarità con un altro editor o un ambiente di sviluppo.

  2. Scaricare e installare Git.

  3. Passare a una directory locale vuota, ad esempio c:\dev\BingAdsJava e clonare Bing Ads Java SDK, ad esempio, digitare git clone https://github.com/BingAds/BingAds-Java-SDK.git. Verrà ora visualizzata la directory SDK che contiene sia l'origine dell'SDK che gli esempi.

  4. Aprire Visual Studio Code e aprire la directory BingAdsDesktopApp (file... Apri cartella...) Ad esempio, C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp.

  5. Per impostazione predefinita, gli esempi sono pronti per l'esecuzione nell'ambiente sandbox. Per usare l'ambiente di produzione, in C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp\src\main\java\com\microsoft\bingads\examples\ExampleBase.java impostare il API_ENVIRONMENTApiEnvironment.PRODUCTION su e modificare Il ClientId con l'ID applicazione di cui è stato effettuato il provisioning al momento della registrazione dell'applicazione. Dovrai anche modificare il valore DeveloperToken con il token di sviluppo di produzione.

  6. Aggiungere la dipendenza Maven per Microsoft.bingads al progetto prima di effettuare chiamate API.

  7. Fare clic con il pulsante destro del mouse su SearchUserAccounts.java e quindi scegliere Esegui.

  8. Verrà richiesto di copiare e incollare l'URL di autorizzazione in un Web browser. È necessario il consenso dell'utente una sola volta e successivamente sarà possibile usare il token di aggiornamento per richiedere nuovi token di accesso e aggiornamento.

  9. Dopo aver autorizzato l'applicazione a gestire gli account Microsoft Advertising, copiare l'URL risultante (con il parametro di codice ) e incollarlo nella finestra della console. Premere quindi invio ( invio) per continuare l'esecuzione.

  10. Il token di aggiornamento verrà scritto inrefresh.txt. Le chiamate successive alla funzione helper authenticateWithOAuth tenteranno di leggere il token di aggiornamento dalla stessa posizione. È possibile modificare la posizione modificando l'impostazione RefreshTokenPath in ExampleBase.java.

    Importante

    Questo esempio di avvio rapido non è consigliato così come è nell'ambiente di produzione. È consigliabile archiviare il token di aggiornamento solo in una posizione sicura.

Vedere anche

Sandbox
Esempi di codice API Bing Ads
Indirizzi del servizio Web dell'API Bing Ads