Query message reference
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 |