Erste Schritte mit der Hotel-API
Hinweis
Diese Betaversion von HotelPreisanzeigen ist nur für ausgewählte Teilnehmer verfügbar. Informationen zur Teilnahme am Beta-Release-Programm finden Sie bei Ihrem Account Manager, oder registrieren Sie sich hier.
Api und Dokumentation können geändert werden.
Verfügen Sie über Ihre Microsoft Advertising-Anmeldeinformationen?
Um die Hotel-API verwenden zu können, benötigen Sie ein Microsoft Advertising-Konto und ein Microsoft-Konto. Um ein Microsoft Advertising-Konto zu erhalten, wechseln Sie zu https://ads.microsoft.com. Wenn Sie nicht mit Ihrem Microsoft-Konto angemeldet sind, werden Sie aufgefordert, sich bei Ihrem Microsoft-Konto anzumelden oder sich für ein Microsoft-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 fahren Sie mit dem Registrierungsvorgang fort.
Im Gegensatz zu den anderen Bing Ads-APIs verwendet die Hotel-API kein Entwicklertoken. Die API ignoriert sie, wenn Sie sie einschließen.
Aktivieren Ihres Kontos für Hotelpreisanzeigen
Sobald wir Ihre Registrierungsinformationen erhalten haben, werden wir Sie per E-Mail bezüglich der nächsten Schritte kontaktieren.
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 Hotel-API verwendet das OAuth-Authentifizierungsschema. Ausführliche Informationen zur Authentifizierung der Anmeldeinformationen für Microsoft-Konten mithilfe von OAuth finden Sie unter Authentifizierung mit OAuth (verwendung der Microsoft Identity Platform empfohlen).
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. Möglicherweise möchten Sie 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 zum Abrufen der Token verwenden möchten, finden Sie unter OAuth C#-Beispiel eine OAuth-Beispielimplementierung.
Hinweis
Wenn Sie die API von einem Dienst aus verwenden, finden Sie weitere Informationen unter Verwenden der Hotel-API über einen Dienst.
Wo verwenden Sie Ihre Anmeldeinformationen?
Nachdem Sie das OAuth-Zugriffstoken des Benutzers abgerufen haben, legen Sie den Autorisierungsheader darauf fest.
var headers = new WebHeaderCollection();
headers.Add(HttpRequestHeader.Authorization, "Bearer " + tokens.AccessToken);
Informationen zum Autorisierungsheader und anderen Headern, die die Anforderung und Antwort enthalten können, finden Sie unter Header.
Hinweis
Die Hotel-API verwendet den Standardautorisierungsheader. Wenn Sie das Bing Ads SDK zum Abrufen der OAuth-Token verwenden, verwenden Sie das SDK zum Abrufen der Token und legen dann den Autorisierungsheader fest.
Haben Sie Ihren Hotelfeed eingerichtet?
Bevor Sie die Hotel-API verwenden, sollten Sie Ihre Hotelfeeds eingerichtet haben. Weitere Informationen finden Sie unter: