Introducción a la API de hotel
Nota:
Esta versión beta de Hotel Price Ads solo está disponible para seleccionar participantes. Para obtener información sobre cómo participar en el programa de versión beta, póngase en contacto con el administrador de cuentas o inscríbase aquí.
La API y la documentación están sujetas a cambios.
¿Tiene sus credenciales de Microsoft Advertising?
Para usar la API de Hotel, debe tener una cuenta de Microsoft Advertising y una cuenta de Microsoft. Para obtener una cuenta de Microsoft Advertising, vaya a https://ads.microsoft.com. Si no ha iniciado sesión con su cuenta Microsoft, se le pedirá que inicie sesión en su cuenta Microsoft o que se registre para obtener una cuenta de Microsoft. Después de iniciar sesión, tendrá la opción de registrarse para obtener una nueva cuenta de Microsoft Advertising. Seleccione la opción de registro y continúe con el proceso de registro.
A diferencia de las otras API de Bing Ads, La API de Hotel no usa un token de desarrollador. La API la omite si la incluye.
Habilitación de su cuenta para Anuncios de precios de hotel
Una vez que hayamos recibido su información de inscripción, nos veremos en contacto con usted por correo electrónico con respecto a los pasos siguientes.
Autenticación de las credenciales
Importante
A partir del 1 de junio de 2022, requeriremos la autenticación multifactor para todos los usuarios que inicien sesión a través de una aplicación de terceros que use la API de Bing Ads, content API y las API de Hotel.
Debe actualizar la aplicación para obtener el consentimiento del usuario mediante el nuevo msads.manage ámbito. Todos los desarrolladores de aplicaciones deben realizar acciones para usar el nuevo ámbito.
Para obtener más información, consulte la guía de requisitos de autenticación multifactor .
La API de hotel usa el esquema de autenticación de OAuth. Para obtener más información sobre cómo autenticar las credenciales de la cuenta de Microsoft mediante OAuth, consulte Autenticación con OAuth (se recomienda usar el Plataforma de identidad de Microsoft).
Puede usar el SDK de Bing Ads para .NET, Java o Python para autenticar las credenciales de la cuenta de Microsoft. Para obtener más información sobre el uso del SDK para obtener el token de acceso, consulte C# | Java | Python. Es posible que solo quiera usar el SDK para obtener el token de acceso si también usa el SDK para campañas de Microsoft Advertising. De lo contrario, puede que no valga la pena la sobrecarga de instalar el SDK.
Si decide no usar el SDK de Bing Ads para obtener los tokens, consulte Ejemplo de C# de OAuth para obtener un ejemplo de implementación de OAuth.
Nota:
Si usa la API desde un servicio, consulte Uso de la API hotelera desde un servicio.
¿Dónde se usan las credenciales?
Después de obtener el token de acceso de OAuth del usuario, establezca el encabezado Authorization en él.
var headers = new WebHeaderCollection();
headers.Add(HttpRequestHeader.Authorization, "Bearer " + tokens.AccessToken);
Para obtener información sobre el encabezado authorization y otros encabezados que puede contener la solicitud y la respuesta, consulte Encabezados.
Nota:
La API de hotel usa el encabezado de autorización estándar. Si usa el SDK de Bing Ads para obtener los tokens de OAuth, usará el SDK para obtener los tokens y, a continuación, establecer el encabezado de autorización.
¿Tiene su fuente de hotel configurada?
Antes de usar la API de hotel, debe tener sus fuentes de hotel configuradas. Para más información, vea: