Erste Schritte mit der Inhalts-API

  • Artikel

Um die Inhalts-API verwenden zu können, benötigen Sie einige Dinge:

  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, um 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 Registrierungsoption aus, und klicken Sie auf Weiter.

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

Authentifizieren Ihrer Anmeldeinformationen

Wichtig

Ab dem 1. Juni 2022 ist die mehrstufige Authentifizierung für alle Benutzer erforderlich, 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 Benutzerzustimmung mithilfe des neuen msads.manage Bereichs zu erhalten. Alle Anwendungsentwickler müssen Maßnahmen ergreifen, um den neuen Bereich zu verwenden.

Weitere Informationen finden Sie im Anforderungsleitfaden für die mehrstufige Authentifizierung .

Die Inhalts-API verwendet dieselben Authentifizierungsschemas wie die Bing Ads-API. Ausführliche Informationen zur Authentifizierung der Anmeldeinformationen für Microsoft-Konten mit OAuth finden Sie unter Authentifizierung mit dem Microsoft Identity Platform.

Sie können das Bing Ads SDK für .NET, Java oder Python verwenden, um Anmeldeinformationen für Microsoft-Konten zu authentifizieren. Ausführliche Informationen zur Verwendung des SDK zum Abrufen des Zugriffstokens finden Sie unter C# | Java | Python. Ein Beispiel für die 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 nur verwenden, um das Zugriffstoken abzurufen, wenn Sie auch das SDK für Microsoft Advertising-Kampagnen verwenden. Andernfalls lohnt sich der Mehraufwand 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 für die Verwendung von OAuth zum Authentifizieren von Microsoft-Kontoanmeldeinformationen.

Wo können Sie Ihre Anmeldeinformationen und Entwicklertoken verwenden?

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 Namen anderer Kunden verwalten, müssen Sie auch die folgenden Header festlegen:

  • Der CustomerId-Header, der auf die Kunden-ID des Kunden festgelegt ist, dessen Geschäft Sie verwalten
  • Der CustomerAccountId-Header, der auf die Konto-ID eines der Konten des Kunden festgelegt ist, die Sie verwalten (es spielt keine Rolle, welches verwaltete Konto verwendet wird).

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

Konfigurieren von Microsoft Merchant Center 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 verwandten Videos.

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

  1. Überprüfen und Anfordern der URL Ihrer Website Informationen zu den Webmastertools, die unter Überprüfen und Anfordern der URL Ihrer Website erwähnt werden, finden Sie unter Bing Webmaster Tools. 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 Ihrer Website.
  2. Erstellen eines Microsoft Merchant Center-Stores
  3. Hinzufügen eines Katalogs

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

Verwenden Sie die Catalogs-Ressource, um Kataloge hinzuzufügen und zu aktivieren. 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

Da Sie nun bereit sind, die API zu verwenden, lesen Sie die folgenden Abschnitte.