Erste Schritte mit der Inhalts-API

Für die Verwendung der Inhalts-API sind einige Schritte erforderlich:

  1. Ein Microsoft-Konto
  2. Ein Microsoft Advertising-Konto
  3. Ein Entwicklertoken

Um ein Microsoft Advertising-Konto zu erhalten, wechseln Sie zu https://ads.microsoft.com. Wenn Sie nicht bei Ihrem Microsoft-Konto angemeldet sind, werden Sie umgeleitet, sich bei Ihrem Konto anzumelden oder sich für ein Konto zu registrieren. Nach der Anmeldung haben Sie die Möglichkeit, sich für ein neues Microsoft Advertising-Konto zu registrieren. Wählen Sie die Option "Anmelden" aus, und klicken Sie auf "Weiter".

Wenn Sie noch nicht über einen Microsoft Advertising-Entwicklertoken für die Produktionsumgebung verfügen, wechseln Sie als Nächstes zum Entwicklerportal. Klicken Sie auf Token anfordern und geben Sie die angeforderten Informationen an. Wenn Sie die API zur Verwaltung Ihres eigenen Kontos verwenden, erhalten Sie Ihr Token sofort. Wenn Sie jedoch Konten für andere verwalten, kann es bis zu fünf Werktage dauern, bis Sie ein Token erhalten.

Authentifizieren Ihrer Anmeldeinformationen

Wichtig

Ab dem 1. Juni 2022 verlangen wir eine mehrstufige Authentifizierung für alle Benutzer, die sich über eine Drittanbieteranwendung anmelden, die die Bing Ads-API, die Inhalts-API und Hotel-APIs verwendet.

Sie müssen Ihre Anwendung aktualisieren, um die Zustimmung des Benutzers für den neuen msads.manage Bereich einzuholen. Alle Anwendungsentwickler müssen Maßnahmen ergreifen, um den neuen Bereich zu verwenden.

Weitere Informationen finden Sie im Leitfaden zu den Anforderungen für die mehrstufige Authentifizierung .

Die Inhalts-API verwendet dieselben Authentifizierungsschemas wie die Bing Ads-API. Weitere Informationen zur Authentifizierung von Microsoft-Kontoanmeldeinformationen mit OAuth finden Sie unter Authentifizierung mit der Microsoft Identity Platform.

Sie können das Bing Ads SDK für .NET, Java oder Python verwenden, um Microsoft-Kontoanmeldeinformationen zu authentifizieren. Ausführliche Informationen zur Verwendung des SDK zum Abrufen des Zugriffstokens finden Sie unter C# | Java | Python. Ein Beispiel für eine Inhalts-API, das das SDK für die Authentifizierung verwendet, finden Sie unter Beispiel für die Verwaltung von Produkten.

(Beachten Sie, dass das Bing Ads SDK keine Schnittstellen für die Inhalts-API bereitstellt. Sie sollten das SDK zum Abrufen des Zugriffstokens nur verwenden, wenn Sie das SDK auch für Microsoft Advertising-Kampagnen verwenden. Andernfalls lohnt sich der Aufwand für die Installation des SDK möglicherweise nicht.)

Wenn Sie das Bing Ads SDK nicht für die Authentifizierung verwenden, finden Sie unter Authentifizieren von Microsoft-Kontoanmeldeinformationen in C# ein Beispiel, das zeigt, wie OAuth zur Authentifizierung von Microsoft-Kontoanmeldeinformationen verwendet wird.

Wo sollen Ihre Anmeldeinformationen und Entwicklertoken verwendet werden?

Alle Aufrufe müssen Folgendes angeben:

  • Der DeveloperToken-Header, der auf Ihr Entwicklertoken festgelegt ist.
  • Der AuthenticationToken-Header, der auf Ihr Zugriffstoken festgelegt ist.

Wenn Sie Kataloge im Auftrag anderer Kunden verwalten, müssen Sie auch die folgenden Header festlegen:

  • Der CustomerId-Header, der auf die Kunden-ID des Kunden festgelegt ist, dessen Shop Sie verwalten
  • Der CustomerAccountId-Header, der auf die Konto-ID eines der von Ihnen verwalteten Kundenkonten festgelegt ist (es spielt keine Rolle, welches verwaltete Konto).

Informationen zu diesen und anderen Headern, die die Anforderung und Antwort enthalten können, finden Sie unter Header.

Konfigurieren des Microsoft Merchant Centers für die Verwendung der API

Eine Übersicht über Microsoft Merchant Center (MMC) finden Sie unter Was ist Microsoft Merchant Center? Das Thema enthält Links zu allen Merchant Center-Themen und zugehörigen Videos.

Wenn Sie dies noch nicht getan haben, müssen Sie die folgenden Schritte ausführen.

  1. Bestätigen und Anfordern der URL Ihrer Website Informationen zum Abrufen der unter "Überprüfen und Anfordern der URL Ihrer Website" erwähnten Webmastertools finden Sie unter Bing Webmastertools. Melden Sie sich mit demselben Microsoft-Konto an, das Sie für Microsoft Advertising verwenden. Weitere Informationen zur Verwendung des Tools finden Sie unter Überprüfen des Besitzes der Eigentümerschaft Ihrer Website.
  2. Erstellen eines Microsoft Merchant Center-Shops
  3. Hinzufügen eines Katalogs

Wenn Sie einen MMC-Shop erstellen, erstellt der Prozess einen Standardkatalog für Sie. Der Shop und alle Kataloge, die Sie erstellen, werden automatisch für API Management aktiviert. Der Store enthält einen Standardkatalog, für den standardmäßig alle Produktvorgänge (Hinzufügen, Aktualisieren, Löschen und Abrufen) gelten. Verwenden Sie zum Angeben eines anderen Katalogs den Abfrageparameter bmc-catalog-id in der Ressourcen-URL.

Verwenden Sie zum Hinzufügen und Aktivieren von Katalogen die Katalogressource . Weitere Informationen finden Sie unter Verwalten Ihrer Kataloge.

Hinweis

Unter bestimmten Umständen können Sie die API und FTP/SFTP verwenden, um einen Katalogfeed zu aktualisieren. Informationen zur Verwendung der API mit FTP/SFTP finden Sie unter Kann ich die API und FTP/SFTP verwenden?

Nächste Schritte

Nachdem Sie nun mit der Verwendung der API beginnen können, lesen Sie die folgenden Abschnitte.

  • Zuletzt aktualisiert um