Introdução à API de Hotel
Nota
Esta versão beta do Hotel Price Ads está disponível apenas para participantes selecionados. Para obter informações sobre como participar no programa de versão beta, contacte o seu gestor de conta ou inscreva-se aqui.
A API e a documentação estão sujeitas a alterações.
Tem as suas credenciais do Microsoft Advertising?
Para utilizar a API de Hotel, tem de ter uma conta Microsoft Advertising e uma conta Microsoft. Para obter uma conta do Microsoft Advertising, aceda a https://ads.microsoft.com. Se não tiver sessão iniciada com a sua conta Microsoft, ser-lhe-á pedido para iniciar sessão na sua conta Microsoft ou inscrever-se numa conta Microsoft. Depois de iniciar sessão, terá a opção de Se inscrever numa nova conta do Microsoft Advertising. Selecione a opção de inscrição e continue com o processo de inscrição.
Ao contrário das outras APIs de Anúncios do Bing, a API de Hotel não utiliza um token de programador. A API ignora-a se a incluir.
Ativar a sua conta para Anúncios de Preços de Hotel
Depois de recebermos as suas informações de inscrição, iremos contactá-lo por e-mail relativamente aos próximos passos.
Autenticar as suas credenciais
Importante
A partir de 1 de junho de 2022, iremos precisar da autenticação multifator para todos os utilizadores que iniciem sessão através de uma aplicação de terceiros que utilize a API de Anúncios do Bing, a API de Conteúdo e as APIs de Hotel.
Tem de atualizar a aplicação para obter o consentimento do utilizador através do novo msads.manage âmbito. Todos os programadores de aplicações têm de tomar medidas para utilizar o novo âmbito.
Para obter mais informações, veja o Guia de requisitos de autenticação multifator .
A API de Hotel utiliza o esquema de autenticação OAuth. Para obter detalhes sobre como autenticar as credenciais da conta Microsoft com o OAuth, veja Autenticação com OAuth (recomenda-se utilizar o plataforma de identidades da Microsoft).
Pode utilizar o SDK de Anúncios do Bing para .NET, Java ou Python para autenticar as credenciais da conta Microsoft. Para obter detalhes sobre como utilizar o SDK para obter o token de acesso, veja C# | Java | Python. Poderá querer utilizar apenas o SDK para obter o token de acesso se também estiver a utilizar o SDK para campanhas de Publicidade da Microsoft. Caso contrário, poderá não valer a pena a sobrecarga da instalação do SDK.
Se optar por não utilizar o SDK de Anúncios do Bing para obter os tokens, veja Exemplo de OAuth C# para obter um exemplo de implementação OAuth.
Nota
Se utilizar a API de um serviço, consulte Utilizar a API do Hotel a partir de um serviço.
Onde utiliza as suas credenciais?
Depois de obter o token de acesso OAuth do utilizador, defina o cabeçalho Autorização para o mesmo.
var headers = new WebHeaderCollection();
headers.Add(HttpRequestHeader.Authorization, "Bearer " + tokens.AccessToken);
Para obter informações sobre o cabeçalho Autorização e outros cabeçalhos que o pedido e a resposta podem conter, veja Cabeçalhos.
Nota
A API de Hotel utiliza o cabeçalho de Autorização padrão. Se utilizar o SDK de Anúncios do Bing para obter os tokens OAuth, irá utilizar o SDK para obter os tokens e, em seguida, definir o cabeçalho Autorização.
Tem o seu feed de hotel configurado?
Antes de utilizar a API de Hotel, deve ter os feeds do hotel configurados. Para obter detalhes, consulte: