Compartir a través de

Tutorial: Aplicación de escritorio de la API de Bing Ads en Java

  • Artículo

En esta guía se describe cómo puede descargar ejemplos de Java para Bing Ads API desde el origen de GitHub, editar con sus credenciales y ejecutarlos en una consola local.

De forma predeterminada, los ejemplos están listos para ejecutarse en el entorno de espacio aislado. Si tiene como destino el entorno de producción, también necesitará el token de desarrollador de producción. También tendrá que registrar una aplicación y tomar nota del identificador de aplicación que se usará como ClientId en el tutorial siguiente. Para obtener más información sobre cómo registrar una aplicación y el flujo de concesión de código de autorización, consulte Autenticación con OAuth.

Tutorial de código

  1. Instale Visual Studio Code y debugger para Java . Puede modificar estos pasos si ya está familiarizado con otro editor o entorno de desarrollo.

  2. Descargue e instale Git.

  3. Vaya a un directorio local vacío, por ejemplo , c:\dev\BingAdsJava y clone el SDK de Java de Bing Ads, por ejemplo, escriba git clone https://github.com/BingAds/BingAds-Java-SDK.git. Ahora debería ver el directorio del SDK que contiene el origen del SDK y ejemplos.

  4. Abra Visual Studio Code y abra el directorio BingAdsDesktopApp (Archivo... Abrir carpeta...) Por ejemplo, C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp.

  5. De forma predeterminada, los ejemplos están listos para ejecutarse en el entorno de espacio aislado. Para usar la producción, en C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp\src\main\java\com\microsoft\bingads\examples\ExampleBase.java, establezca el API_ENVIRONMENTApiEnvironment.PRODUCTION en y edite clientid con el identificador de aplicación que se aprovisionó al registrar la aplicación. También tendrá que editar el valor DeveloperToken con el token de desarrollador de producción.

  6. Agregue la dependencia de Maven para Microsoft.bingads al proyecto antes de realizar llamadas API.

  7. Haga clic con el botón derecho en SearchUserAccounts.java y, a continuación, haga clic en Ejecutar.

  8. Se le pedirá que copie y pegue la dirección URL de autorización en un explorador web. Se requiere el consentimiento del usuario una vez y, a partir de entonces, podrá usar el token de actualización para solicitar nuevos tokens de acceso y actualización.

  9. Después de autorizar a la aplicación para administrar las cuentas de Microsoft Advertising, copie la dirección URL resultante (con el parámetro de código ) y péguela en la ventana de la consola. A continuación, presione la tecla Entrar (devolver) para continuar con la ejecución.

  10. El token de actualización se escribirá en refresh.txt. Las llamadas posteriores a la función auxiliar authenticateWithOAuth intentarán leer el token de actualización desde la misma ubicación. Para cambiar la ubicación, edite la configuración RefreshTokenPath en ExampleBase.java.

    Importante

    Este ejemplo de inicio rápido no se recomienda tal como está en producción. Solo debe almacenar el token de actualización en una ubicación segura.

Consulta también

Espacio aislado
Ejemplos de código de api de Bing Ads
Direcciones del servicio web de la API de Bing Ads