Partilhar via

Instruções: Aplicação de Ambiente de Trabalho da API de Anúncios do Bing em Java

  • Artigo

Este guia descreve como pode transferir exemplos de Java para a API de Anúncios do Bing a partir da origem do GitHub, editar com as suas credenciais e executar numa consola local.

Por predefinição, os exemplos estão prontos para serem executados no ambiente do sandbox. Se estiver a filtrar o ambiente de produção, também precisará do token de programador de produção. Também terá de registar uma aplicação e tomar nota do ID da Aplicação que será utilizado como ClientId nas instruções abaixo. Para obter mais detalhes sobre o registo de uma aplicação e o fluxo de concessão de código de autorização, veja Authentication with OAuth (Autenticação com OAuth).

Instruções de Código

  1. Instale o Visual Studio Code e o Debugger para Java . Pode modificar estes passos se já estiver familiarizado com outro editor ou ambiente de desenvolvimento.

  2. Transfira e instale o Git.

  3. Navegue para um diretório local vazio, por exemplo , c:\dev\BingAdsJava e clone o SDK Java de Anúncios do Bing, por exemplo, escreva git clone https://github.com/BingAds/BingAds-Java-SDK.git. Agora, deverá ver o diretório do SDK que contém a origem do SDK e exemplos.

  4. Abra o Visual Studio Code e abra o diretório BingAdsDesktopApp (Ficheiro... Abrir Pasta...) por exemplo, C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp.

  5. Por predefinição, os exemplos estão prontos para serem executados no ambiente do sandbox. Para utilizar a produção, em C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp\src\main\java\com\microsoft\bingads\examples\ExampleBase.java, defina o API_ENVIRONMENT para ApiEnvironment.PRODUCTION e edite o ClientId com o ID da Aplicação que foi aprovisionado quando registou a sua aplicação. Também terá de editar o valor DeveloperToken com o token de programador de produção.

  6. Adicione a dependência do Maven para Microsoft.bingads ao seu projeto antes de efetuar chamadas à API.

  7. Clique com o botão direito do rato em SearchUserAccounts.java e, em seguida, clique em Executar.

  8. Deverá ser-lhe pedido para copiar e colar o URL de autorização num browser. O consentimento do utilizador único é necessário e, posteriormente, poderá utilizar o token de atualização para pedir novos tokens de acesso e atualização.

  9. Depois de autorizar a sua aplicação a gerir as suas contas do Microsoft Advertising, copie o URL resultante (com o parâmetro de código ) e cole-o na janela da consola. Em seguida, prima a tecla Enter (enter) para continuar a execução.

  10. O token de atualização será escrito norefresh.txt. As chamadas subsequentes para a função auxiliar authenticateWithOAuth tentarão ler o token de atualização a partir da mesma localização. Pode alterar a localização ao editar a definição RefreshTokenPath em ExampleBase.java.

    Importante

    Este exemplo de início rápido não é recomendado tal como está na produção. Só deve armazenar o token de atualização numa localização segura.

See Also

Sandbox
Exemplos de Código da API de Anúncios do Bing
Endereços do Serviço Web da API de Anúncios do Bing