Partilhar via

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

  • Artigo

Este guia descreve como pode transferir exemplos PHP 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. Navegue para um diretório local vazio, por exemplo , c:\dev\BingAdsPHP e instale o SDK PHP de Anúncios do Bing, por exemplo, escreva composer require microsoft/bingads. Deverá agora ver o diretório do fornecedor que contém a origem do SDK e os exemplos.

  2. Copie o diretório V13 (com exemplos incluídos) para o diretório do projeto local, por exemplo, copie de c:\dev\BingAdsPHP\vendor\microsoft\bingads\samples para c:\dev\BingAdsPHP.

  3. Por predefinição, os exemplos estão prontos para serem executados no ambiente do sandbox. Para utilizar a produção, em c:\dev\BingAdsPHP\V13\AuthHelper.php, defina a ApiEnvironment como 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.

  4. Na linha de comandos da consola, execute o exemplo, por exemplo, escreva php .\V13\SearchUserAccounts.php.

  5. 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.

  6. 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.

  7. O token de atualização será escrito norefresh.txt. As chamadas subsequentes para a função auxiliar Autenticar tentarão ler o token de atualização a partir da mesma localização. Pode alterar a localização ao editar a definição OAuthRefreshTokenPath em AuthHelper.php.

    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

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