Freigeben über

Exemplarische Vorgehensweise: Bing Ads-API-Desktopanwendung in PHP

  • Artikel

In diesem Leitfaden wird beschrieben, wie Sie PHP-Beispiele für die Bing Ads-API aus der GitHub-Quelle herunterladen, mit Ihren Anmeldeinformationen bearbeiten und in einer lokalen Konsole ausführen können.

Standardmäßig können die Beispiele in der Sandboxumgebung ausgeführt werden. Wenn Sie die Produktionsumgebung als Ziel verwenden, benötigen Sie auch Ihr Produktionsentwicklertoken. Sie müssen auch eine Anwendung registrieren und sich die Anwendungs-ID notieren, die in der folgenden exemplarischen Vorgehensweise als ClientID verwendet wird. Weitere Informationen zum Registrieren einer Anwendung und zum Autorisierungscodegenehmigungsflow finden Sie unter Authentifizierung mit OAuth.

Code Exemplarische Vorgehensweise

  1. Navigieren Sie zu einem leeren lokalen Verzeichnis, z. B. c:\dev\BingAdsPHP , und installieren Sie das Bing Ads PHP SDK, z. B composer require microsoft/bingads. . Nun sollte das Anbieterverzeichnis angezeigt werden, das sowohl die SDK-Quelle als auch die Beispiele enthält.

  2. Kopieren Sie das V13-Verzeichnis (mit eingeschlossenen Beispielen) in Ihr lokales Projektverzeichnis, z. B. von c:\dev\BingAdsPHP\vendor\microsoft\bingads\samples nach c:\dev\BingAdsPHP.

  3. Standardmäßig können die Beispiele in der Sandboxumgebung ausgeführt werden. Um die Produktion zu verwenden, legen Sie in c:\dev\BingAdsPHP\V13\AuthHelper.php die ApiEnvironment auf ApiEnvironment::Production fest, und bearbeiten Sie die ClientId mit der Anwendungs-ID, die bei der Registrierung Ihrer Anwendung bereitgestellt wurde. Außerdem müssen Sie den DeveloperToken-Wert mit Ihrem Produktionsentwicklertoken bearbeiten.

  4. Führen Sie an der Konsoleneingabeaufforderung das Beispiel aus, z. B php .\V13\SearchUserAccounts.php. .

  5. Sie sollten aufgefordert werden, die Autorisierungs-URL zu kopieren und in einen Webbrowser einzufügen. Die einmalige Zustimmung des Benutzers ist erforderlich, und danach können Sie das Aktualisierungstoken verwenden, um neue Zugriffs- und Aktualisierungstoken anzufordern.

  6. Nachdem Sie Ihre Anwendung für die Verwaltung Ihrer Microsoft Advertising-Konten autorisiert haben, kopieren Sie die resultierende URL (mit dem Codeparameter ), und fügen Sie sie in das Konsolenfenster ein. Drücken Sie dann die EINGABETASTE (Rückgabe), um die Ausführung fortzusetzen.

  7. Das Aktualisierungstoken wird inrefresh.txtgeschrieben. Nachfolgende Aufrufe der Authenticate-Hilfsfunktion versuchen, das Aktualisierungstoken vom gleichen Speicherort aus zu lesen. Sie können den Speicherort ändern, indem Sie die OAuthRefreshTokenPath-Einstellung in AuthHelper.php bearbeiten.

    Wichtig

    Dieses Schnellstartbeispiel wird in der Produktion nicht unverändert empfohlen. Sie sollten das Aktualisierungstoken nur an einem sicheren Ort speichern.

Siehe auch

Codebeispiele für die Bing Ads-API
Adressen des Bing Ads-API-Webdiensts