Query message reference

Note

This beta release of Hotel Price Ads is available to select participants only. For information about participating in the beta release program, please contact your account manager or enroll here.

If you update your hotels' itinerary data using the Pull or Pull with Hints method, you use the Query message to specify the amount of data that Bing should ask for in its pull requests. This topic describes the elements of the Query message defined by the Query XSD.

For information about processing Query messages, see Processing a Query Message.

Note

Bing does not support all Query XSD elements. This topic includes only those elements and attributes that Bing supports.

---

Query

Defines the root element of a Query message.

Element	Description	Children
Query	The root element in a Query message.	Query Type

Query Type

Defines a Query message.

Element	Description	Children
	The group defines the list of properties that Bing wants data for, and the options for the way Bing specifies the dates in the request.	combinedQueryGroup

combinedQueryGroup

Defines the list of properties that Bing wants data for, and the options for the way it specifies the dates in the request.

Element	Description	Children
	Bing uses this option if you signed up for pull requests, or you signed up for pull with hints requests and your Hint message specifies exact itineraries (includes the <Stay> element).	pointQueryGroup
	Bing uses this option if you signed up for pull with hints requests and your hint specifies a check-in date range.	rangeQueryGroup
PropertyList	A list of one or more hotel IDs that you must return itinerary data for.	propertyListType

pointQueryGroup

Defines a check-in date query.

Element	Description	Children
Checkin	The itinerary's check-in date in the form, YYYY-mm-dd.	Date
Nights	The number of nights stay.	PositiveInteger

rangeQueryGroup

Defines a date range query.

Element	Description	Children
FirstDate	The first check-in date of the date range. The date is in the form, YYYY-mm-dd.	Date
LastDate	The last check-in date of the date range. The date is in the form, YYYY-mm-dd.	Date
Nights	The number of nights stay. The Query message contains this element if your Hint message does not include the <StaysIncludingRange> element. Return data only for itineraries that fall within the check-in date range, including of the first and last dates.	PositiveInteger
AffectedNights	The affected number of nights stay. The Query message contains this element if your Hint message includes the <StaysIncludingRange> element. Return data for all itineraries whose check-out date intersects the date range.	PositiveInteger

PropertyListType

Defines a list of hotels.

Element	Description	Children
Property	A hotel's ID.	String