Condividi tramite

Procedura dettagliata: Applicazione desktop API Bing Ads in PHP

  • Articolo

Questa guida descrive come scaricare esempi PHP 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. Passare a una directory locale vuota, ad esempio c:\dev\BingAdsPHP e installare Bing Ads PHP SDK, ad esempio, digitare composer require microsoft/bingads. Verrà ora visualizzata la directory del fornitore che contiene sia l'origine dell'SDK che gli esempi.

  2. Copiare la directory V13 (con esempi inclusi) nella directory del progetto locale, ad esempio copiare da c:\dev\BingAdsPHP\vendor\microsoft\bingads\samples in c:\dev\BingAdsPHP.

  3. Per impostazione predefinita, gli esempi sono pronti per l'esecuzione nell'ambiente sandbox. Per usare l'ambiente di produzione, all'interno di c:\dev\BingAdsPHP\V13\AuthHelper.php impostare ApiEnvironmentApiEnvironment::Production su e modificare l'ID client 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.

  4. Al prompt dei comandi della console eseguire l'esempio, ad esempio digitare php .\V13\SearchUserAccounts.php.

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

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

  7. Il token di aggiornamento verrà scritto inrefresh.txt. Le chiamate successive alla funzione helper Authenticate tenteranno di leggere il token di aggiornamento dalla stessa posizione. È possibile modificare il percorso modificando l'impostazione OAuthRefreshTokenPath all'interno di AuthHelper.php.

    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

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