Compartir a través de

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

  • Artículo

En esta guía se describe cómo puede descargar ejemplos de PHP 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. Vaya a un directorio local vacío, por ejemplo , c:\dev\BingAdsPHP e instale el SDK de PHP de Bing Ads, por ejemplo, escriba composer require microsoft/bingads. Ahora debería ver el directorio del proveedor que contiene el origen del SDK y los ejemplos.

  2. Copie el directorio V13 (con ejemplos incluidos) en el directorio del proyecto local, por ejemplo, copie desde c:\dev\BingAdsPHP\vendor\microsoft\bingads\samples a c:\dev\BingAdsPHP.

  3. De forma predeterminada, los ejemplos están listos para ejecutarse en el entorno de espacio aislado. Para usar la producción, en c:\dev\BingAdsPHP\V13\AuthHelper.php, establezca ApiEnvironmentApiEnvironment::Production en y edite el ClientId con el identificador de aplicación que se aprovisionó cuando registró la aplicación. También tendrá que editar el valor DeveloperToken con el token de desarrollador de producción.

  4. En el símbolo del sistema de la consola, ejecute el ejemplo, por ejemplo, escriba php .\V13\SearchUserAccounts.php.

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

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

  7. El token de actualización se escribirá en refresh.txt. Las llamadas posteriores a la función auxiliar Authenticate intentarán leer el token de actualización desde la misma ubicación. Para cambiar la ubicación, edite la configuración de OAuthRefreshTokenPath en AuthHelper.php.

    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

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