Introduzione all'API Hotel
Nota
Questa versione beta di Hotel Price Ads è disponibile solo per selezionare i partecipanti. Per informazioni sulla partecipazione al programma di versione beta, contattare il proprio account manager o registrarsi qui.
L'API e la documentazione sono soggette a modifiche.
Hai le tue credenziali di Microsoft Advertising?
Per usare l'API Hotel, è necessario disporre di un account Microsoft Advertising e di un account Microsoft. Per ottenere un account Microsoft Advertising, passare a https://ads.microsoft.com. Se non hai eseguito l'accesso usando il tuo account Microsoft, ti viene chiesto di accedere al tuo account Microsoft o di iscriverti a un account Microsoft. Dopo l'accesso, sarà possibile iscriversi per un nuovo account Microsoft Advertising. Selezionare l'opzione di iscrizione e continuare con il processo di iscrizione.
A differenza delle altre API Bing Ads, l'API Hotel non usa un token per sviluppatori. L'API lo ignora se lo si include.
Abilitare l'account per Gli annunci prezzo hotel
Dopo aver ricevuto le informazioni di registrazione, l'utente verrà contattato tramite posta elettronica per i passaggi successivi.
Autenticazione delle credenziali
Importante
A partire dal 1° giugno 2022 sarà necessaria l'autenticazione a più fattori per tutti gli utenti che accedono tramite un'applicazione di terze parti che usa l'API Bing Ads, l'API Contenuto e le API Hotel.
È necessario aggiornare l'applicazione per ottenere il consenso dell'utente usando il nuovo msads.manage ambito. Tutti gli sviluppatori di applicazioni devono intervenire per usare il nuovo ambito.
Per altre informazioni, vedere la guida ai requisiti per l'autenticazione a più fattori .
L'API Hotel usa lo schema di autenticazione OAuth. Per informazioni dettagliate sull'autenticazione delle credenziali dell'account Microsoft tramite OAuth, vedere Autenticazione con OAuth (è consigliabile usare il Microsoft Identity Platform).
È possibile usare Bing Ads SDK per .NET, Java o Python per autenticare le credenziali dell'account Microsoft. Per informazioni dettagliate sull'uso dell'SDK per ottenere il token di accesso, vedere Python Java C# | | . È possibile usare l'SDK per ottenere il token di accesso solo se si usa l'SDK anche per le campagne di Microsoft Advertising. In caso contrario, potrebbe non valere la pena di installare l'SDK.
Se si sceglie di non usare Bing Ads SDK per ottenere i token, vedere Esempio di OAuth C# per un'implementazione OAuth di esempio.
Nota
Se si usa l'API da un servizio, vedere Uso dell'API Hotel da un servizio.
Dove si usano le credenziali?
Dopo aver ottenuto il token di accesso OAuth dell'utente, impostarvi l'intestazione Authorization.
var headers = new WebHeaderCollection();
headers.Add(HttpRequestHeader.Authorization, "Bearer " + tokens.AccessToken);
Per informazioni sull'intestazione Authorization e altre intestazioni che la richiesta e la risposta possono contenere, vedere Intestazioni.
Nota
L'API Hotel usa l'intestazione Authorization standard. Se si usa Bing Ads SDK per ottenere i token OAuth, si userà l'SDK per ottenere i token e quindi si imposterà l'intestazione Authorization.
Hai configurato il feed dell'hotel?
Prima di usare l'API Hotel, è necessario configurare i feed dell'hotel. Per dettagli, vedere: