На этой странице представлены ссылки на сообщения транзакций на основе XML.
<Transaction>
Корневым элементом сообщения транзакции является <Transaction>
. Это контейнер для описательной информации о номерах и пакетах, а также ценах и наличии номеров и пакетов.
Элемент <Transaction>
появляется в следующем месте в иерархии XML сообщения транзакции:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Для сообщений, использующих <Transaction>
в качестве корневого элемента, требуется хотя бы один дочерний элемент. Сообщения транзакций могут иметь любое количество дочерних элементов, если общий размер сообщения не превышает 100 МБ.
Синтаксис
Элемент <Transaction>
использует следующий синтаксис:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp" id="transaction_ID">
<!-- Defines data about a room or package (Room Bundle) -->
<PropertyDataSet>
...
</PropertyDataSet>
<!-- Updates/sets prices and availability for rooms and Room Bundles -->
<!-- (Also removes itineraries from inventory) -->
<Result>
...
</Result>
</Transaction>
Атрибуты
Элемент <Transaction>
имеет следующие атрибуты:
Атрибут | Необходимый? | Тип | Описание |
---|---|---|---|
id | Required | нить | Уникальный идентификатор для каждого сообщения транзакции. |
partner | Optional | string | Партнерская учетная запись, для которой предназначено сообщение о транзакции. Обычно вы используете это, если ваш сервер предоставляет потоки цен для нескольких учетных записей партнеров. Это строковое значение представляет собой значение «Партнерского ключа», указанное на странице настроек учетной записи в Hotel Center. |
timestamp | Required | DateTime | Момент времени отправки сообщения транзакции. Любое сообщение, отправленное с отметкой времени в течение предыдущих 24 часов, будет обработано, а те, у которых этого не было, будут удалены. Сообщения обрабатываются в порядке |
Дочерние элементы
Элемент <Transaction>
имеет следующие дочерние элементы:
Дочерний элемент | Необходимый? | Тип | Описание |
---|---|---|---|
<PropertyDataSet> | Optional* | <PropertyDataSet> | Описывает конкретный номер и комплекты номеров. Обычно вы используете этот элемент в отдельном сообщении транзакции, чтобы определить общие значения для пакетов номеров и уменьшить размер сообщений транзакции. |
<Result> | Optional* | <Result> | Данные о ценах для маршрута номера или элемента |
* Требуется хотя бы один из <PropertyDataSet> или <Result> . |
Примеры
Данные о номере
В следующем примере определяются данные о номере в сообщении транзакции:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>5440OF</RoomID>
<Name>
<Text text="Single King Bed Room" language="en"/>
<Text text="Simple Lit de Roi" language="fr"/>
</Name>
<Description>
<Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
and down comforters (bedspreads). City view. 300 square feet. Desk with
rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
complimentary HBO and pay movies." language="en"/>
<Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Bathroom View" language="en"/>
<Text text="La salle de baines" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Capacity>4</Capacity>
</RoomData>
</PropertyDataSet>
</Transaction>
Данные о ценах
В следующем примере определяются данные о ценах в сообщении транзакции:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">278.33</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="site1"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>052213</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">299.98</Baserate>
<Tax currency="USD">26.42</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="otto"/>
<PointOfSale id="simon"/>
</AllowablePointsOfSale>
</Result>
</Transaction>
Ночные тарифы
В следующем примере определяются данные о ценах на срок от 1 до 7 ночей, начиная с 7 июня 2023 г.:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">209.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">419.98</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>3</Nights>
<Baserate currency="USD">614.97</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>4</Nights>
<Baserate currency="USD">819.96</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>5</Nights>
<Baserate currency="USD">999.95</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>6</Nights>
<Baserate currency="USD">1193.94</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>7</Nights>
<Baserate currency="USD">1259.93</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
</Transaction>
Базовые и условные ставки
В следующем примере показано сообщение транзакции, содержащее базовую ставку и условную ставку :
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">200.00</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<Rates>
<!-- The rate_rule_id is required when using conditional rates -->
<Rate rate_rule_id="mobile">
<!-- Override base rate and taxes for conditional rates -->
<Baserate currency="USD">180.00</Baserate>
<Tax currency="USD">18.00</Tax>
<!-- NOTE: OtherFees is inherited from the above setting -->
<Custom1>ratecode123</Custom1>
</Rate>
</Rates>
</Result>
</Transaction>
Удалить инвентарь
В следующем примере из инвентаря удаляется несколько запасов (проживание на 1 ночь на несколько разных дат) для отеля:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-05-23T16:20:00-04:00" id="42">
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-23</Checkin>
<Nights>1</Nights>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-24</Checkin>
<Nights>1</Nights>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
<!---Sending <Baserate> is optional with <Unavailable> -->
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-25</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">-1</Baserate>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
</Transaction>
<PropertyDataSet>
Контейнер для информации о комнате и пакете (или Room Bundle ) в сообщении <Transaction>
. Значения, установленные для отеля, переопределяют значения, установленные для партнера. Google хранит эту информацию, поэтому вам не нужно указывать ее каждый раз, когда вы отправляете обновления цен.
Элемент <PropertyDataSet>
появляется в следующем месте в иерархии XML сообщения транзакции:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Дополнительную информацию см. в метаданных Room Bundle .
Синтаксис
Элемент <PropertyDataSet>
использует следующий синтаксис:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <PropertyDataSet> <!-- (Required) ID that matches the Hotel List Feed --> <Property>hotel_ID</Property> <!-- (Optional) Defines metadata about a room --> <RoomData> ... </RoomData> <!-- (Optional) Defines package metadata to be paired with rooms (Room Bundles) --> <PackageData> ... </PackageData> </PropertyDataSet> ... </Transaction>
Атрибуты
Элемент <PropertyDataSet>
не имеет атрибутов.
Дочерние элементы
Элемент <PropertyDataSet>
имеет следующие дочерние элементы:
Дочерний элемент | Необходимый? | Тип | Описание |
---|---|---|---|
<PackageData> | Optional* | <PackageData> | Описывает комплект номеров. Эти данные связаны с партнером и отелем, но не с маршрутом. Этот элемент похож на <RoomData> , но описывает удобства и термины, которые не являются частью описания физического помещения.Вы ссылаетесь на идентификатор пакета в своих обновлениях цен. Дополнительную информацию см. в метаданных Room Bundle . |
<Property> | Required | string | Идентификатор отеля, к которому относятся связанные данные. Значением этого элемента должна быть строка, соответствующая объявлению <id> в фиде списка отелей. |
<RoomData> | Optional* | <RoomData> | Описывает комнату. Эти данные связаны с партнером и отелем, но не с маршрутом. Вы указываете идентификатор комнаты в своих обновлениях цен. |
* Требуется хотя бы один из <PackageData> или <RoomData> . |
Примеры
Данные о номере и пакете услуг
В следующем примере показаны данные о помещении и пакете в <PropertyDataSet>
:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>180054</Property>
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Bed Room" language="en"/>
<Text text="Chambre single" language="fr"/>
</Name>
<Description>
<Text text="Non-smoking" language="en"/>
<Text text="Pas de fumiers" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Includes a delightful array of jams and jellies." language="en"/>
<Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Когда вы отправляете цены и наличие мест для этого номера и пакета номеров, вы ссылаетесь на идентификаторы номера и пакета в своих сообщениях о ценах. В результате вы значительно уменьшите размер своих сообщений, а также уменьшите количество ошибок, с которыми вы можете столкнуться из-за дублирования данных. Дополнительную информацию см. в метаданных Room Bundle .
<RoomData>
Определяет независимые от маршрута метаданные о номерах и, как следствие, о пакетах номеров (поскольку пакеты номеров представляют собой номера с дополнительными удобствами). Используйте <RoomData>
, чтобы уменьшить повторение описательных данных в вашем фиде цен.
Элемент <RoomData>
появляется в следующем месте в иерархии XML сообщения транзакции:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Элементы <RoomData>
содержат информацию, связанную с партнером и отелем, но не с маршрутом. Предполагаемая цель - для всех немаршрутных данных.
Элемент <RoomData>
похож на <PackageData>
, но описывает физическую комнату, а не удобства и условия пакета. Вы используете <RoomData>
и <PackageData>
в сочетании, чтобы предоставить подробную информацию о пакетах номеров. Для отдельных комнат, которые не являются частью пакета, используйте только <RoomData>
.
Вы можете определить элементы <RoomData>
и <PackageData>
для одной и той же комнаты или пакета комнат. Когда Google отображает эту комнату или пакет в результатах поиска, он будет включать описания обоих, разделенные дефисом.
Дополнительную информацию см. в метаданных Room Bundle .
Синтаксис
Элемент <RoomData>
использует следующий синтаксис:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <PropertyDataSet> ... <RoomData> <RoomID>room_ID</RoomID> <Name> <Text text="room_name" language="language_code"/> ... </Name> <Description> <Text text="room_description" language="language_code"/> ... </Description> <Capacity>max_number_of_occupants</Capacity> <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <!-- optional info about the types of guests, whether adults, children, or seniors --></OccupancyDetails> <OccupancySettings> <MinOccupancy>min_number_of_occupants</MinOccupancy> <MinAge>min_age_of_occupants</MinAge> </OccupancySettings> <PhotoURL> <Caption> <Text text="photo_description" language="language_code"/> ... </Caption> <URL>photo_location</URL> </PhotoURL> <RoomFeatures> ... </RoomFeatures> </RoomData> ... </PropertyDataSet> </Transaction>
Атрибуты
Элемент <RoomData>
не имеет атрибутов.
Дочерние элементы
Элемент <RoomData>
имеет следующие дочерние элементы:
Дочерний элемент | Необходимый? | Тип | Описание |
---|---|---|---|
<Capacity> | Optional | integer | Максимальное количество гостей, которое физически может разместиться в номере. Для комнаты вместимость больше или равна вместимости. Если это значение указано, оно должно быть равно или больше значения элемента Значение |
<Description> | Optional | Object | Подробное описание помещения. Этот элемент должен содержать информацию, не описанную другими элементами или элементом <Name> . При указании описания номера не следует использовать все заглавные буквы. Элемент
Используйте отдельный элемент В следующем примере показаны версии описания комнаты на французском и английском языках: <Description> <Text text="Two queen-sized beds" language="en"/> <Text text="Deux lits de la reine" language="fr"/> </Description> |
<Name> | Required | string | Название категории номера. Это значение должно совпадать с тем, что отображается на целевой странице отеля (ранее — точка продаж). Не устанавливайте значение этого элемента только заглавными буквами. Этот элемент принимает один дочерний элемент
Используйте отдельный элемент В следующем примере показаны версии названия комнаты на французском и английском языках: <Name> <Text text="Standard Double Room" language="en"/> <Text text="Le chambre double" language="fr"/> </Name> |
<Occupancy> | Optional | integer | Максимальное количество гостей , на которое рассчитан номер. Например, в большом люксе могут физически разместиться 6 гостей (вместимость = 6), но он рассчитан только на 4 гостей. Это значение должно быть меньше или равно элементу Значение |
<OccupancySettings> | Optional | Object | Настройки, которые могут ограничить или изменить требования к заполняемости помещения. Элемент
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> Не обязательно включать все дочерние элементы. |
<PhotoURL> | Optional | Object | URL-адрес и необязательная подпись к фотографии данного номера или пакета номеров. Вы можете указать более одного <PhotoURL> для комнаты или пакета комнат. Каждый URL-адрес фотографии должен находиться в собственном <PhotoURL> .Этот элемент принимает следующие дочерние элементы:
Пример: <PhotoURL> <URL>https://www.example.com/static/bar/image1234.jpg</URL> <Caption> <Text text="A bright and breezy way to enjoy your mornin' cuppa tea." language="en"/> <Text text="Une façon lumineuse et aérée pour profiter de votre journée tasse de thé." language="fr"/> </Caption> </PhotoURL> <PhotoURL> <URL>https://www.foo.com/static/bar/image5678.jpg</URL> <Caption> <Text text="Or, perhaps you prefer coffee." language="en"/> <Text text="Ou peut-être préférez-vous le café." language="fr"/> </Caption> </PhotoURL> |
<RoomFeatures> | Optional | <RoomFeatures> | Содержит информацию об особенностях номера. |
<RoomID> | Required | string | Уникальный идентификатор комнаты. Используйте этот идентификатор, чтобы сопоставить данные о номере с блоками <Result> в обновлениях цен. Дополнительную информацию см. в метаданных Room Bundle . (Вы также можете использовать этот идентификатор для ссылки на общее определение помещения в одном сообщении транзакции при встроенном определении данных помещения.) |
Примеры
Данные о номере
В следующем примере определяются данные помещения:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>5440OF</RoomID>
<Name>
<Text text="Single King Bed Room" language="en"/>
<Text text="Simple Lit de Roi" language="fr"/>
</Name>
<Description>
<Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
and down comforters (bedspreads). City view. 300 square feet. Desk with
rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
complimentary HBO and pay movies." language="en"/>
<Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Bathroom View" language="en"/>
<Text text="La salle de baines" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Capacity>4</Capacity>
</RoomData>
</PropertyDataSet>
</Transaction>
Метаданные номера и пакета
В следующем примере определяются метаданные помещения и пакета:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>180054</Property>
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Bed Room" language="en"/>
<Text text="Chambre single" language="fr"/>
</Name>
<Description>
<Text text="Non-smoking" language="en"/>
<Text text="Pas de fumiers" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Includes a delightful array of jams and jellies." language="en"/>
<Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Пакеты из нескольких номеров
В следующем примере определяются метаданные комнаты и пакета для нескольких пакетов комнат:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<!-- A transaction message with room types result. -->
<PropertyDataSet>
<Property>12345</Property>
<RoomData>
<RoomID>single</RoomID>
<Name>
<Text text="Single room" language="en"/>
<Text text="Chambre simple" language="fr"/>
</Name>
<Description>
<Text text="A single room" language="en"/>
<Text text="Le chambre simple" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image1235.jpg</URL>
</PhotoURL>
<Capacity>2</Capacity>
</RoomData>
<RoomData>
<RoomID>double</RoomID>
<Name>
<Text text="Double room" language="en"/>
<Text text="Chambre double" language="fr"/>
</Name>
<Occupancy>1</Occupancy>
</RoomData>
<PackageData>
<PackageID>refundbreakfast</PackageID>
<Name>
<Text text="Refundable Room with Breakfast" language="en"/>
<Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Continental Breakfast" language="en"/>
<Text text="Petit déjeuner continental" language="fr"/>
</Description>
<ChargeCurrency>hotel</ChargeCurrency>
<Refundable available="1" refundable_until_days="3"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>prepaid</PackageID>
<Name>
<Text text="Nonrefundable" language="en"/>
<Text text="Non remboursable" language="fr"/>
</Name>
<Description>
<Text text="Blah blah blad" language="en"/>
<Text text="Le blah blah blad" language="fr"/>
</Description>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="0"/>
</PackageData>
</PropertyDataSet>
</Transaction>
<RoomFeatures>
Определяет особенности помещения.
Элемент <RoomFeatures>
появляется в следующем месте в иерархии XML сообщения транзакции:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<RoomFeatures>
Синтаксис
Элемент <RoomFeatures>
использует следующий синтаксис:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <PropertyDataSet ... > ... <RoomData> <RoomFeatures> <JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle> <Beds> <Bed size="[single|semi_double|double|queen|king]"> <Width unit="cm" number="width"/> <Length unit="cm" number="length"/> </Bed> <!-- Include with any additional beds. --> </Beds> <Suite/> <Capsule/> <Roomsharing>[shared|private]</Roomsharing> <Outdoor/> <MobilityAccessible/> <Smoking>[smoking|non_smoking]</Smoking> <BathAndToilet relation="[together|separate]"> <Bath bathtub="[false|true]" shower="[false|true]"/> <Toilet electronic_bidet="[false|true]" mobility_accessible="[false|true]"/> </BathAndToilet> <OpenAirBath/> <AirConditioning/> <Balcony/> <Views> <!-- (Optional) Defines the type of views from the room. --> <!-- Example: <OceanView/> --> </Views> </RoomFeatures> ... </RoomData> ... </PropertyDataSet> </Transactions>
Атрибуты
Элемент <RoomFeatures>
не имеет атрибутов.
Дочерние элементы
Элемент <RoomFeatures>
имеет следующие дочерние элементы:
Дочерний элемент | Необходимый? | Тип | Описание |
---|---|---|---|
<JapaneseHotelRoomStyle> | Optional | enum | Обозначает стиль японского гостиничного номера. Допустимые значения:
|
<Beds> | Optional | Object | Содержит столько <Bed> , сколько имеется в комнате. Обратите внимание, что японские футоны сюда не следует учитывать. Каждый
<Bed> имеет следующие дочерние элементы:
<Beds> <Bed size="double"> <Width unit="cm" number="140"/> <Length unit="cm" number="195"/> </Bed> <Bed/> <!-- Size unknown --> </Beds> |
<Suite> | Optional | empty | Укажите этот элемент, если это номер люкс. |
<Capsule> | Optional | empty | Укажите этот элемент, если эта комната является капсульной. |
<Roomsharing> | Optional | enum | Проживает ли эта комната с другими жильцами, например владельцами или другими гостями. Допустимые значения являются shared и private . |
<Outdoor> | Optional | empty | Предусмотрите этот элемент, если эта комната представляет собой жилье на открытом воздухе, в котором нет фиксированных стен, водопровода и климат-контроля. Например, гостиничные номера не являются местом проживания на открытом воздухе, тогда как кемпинги, где гости останавливаются в палатках, и стоянки для автодомов, куда гости привозят свои собственные дома на колесах, представляют собой жилье на открытом воздухе. |
<MobilityAccessible> | Optional | empty | Используйте этот элемент, если помещение доступно для передвижения. |
<Smoking> | Optional | enum | Является ли этот номер номером для некурящих или номером для курящих. Допустимые значения: non_smoking и smoking . |
<BathAndToilet> | Optional | Object | Содержит информацию о ванне и туалете в номере. Атрибут:
Элемент опционально принимает следующие дочерние элементы:
Пример: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
<OpenAirBath> | Optional | empty | Предусмотрите этот элемент, если в этой комнате есть собственная ванна под открытым небом. |
<AirConditioning> | Optional | empty | Предусмотрите этот элемент, если в этой комнате есть кондиционер. |
<Balcony> | Optional | empty | Предусмотрите этот элемент, если в комнате есть балкон или веранда. |
<Views> | Optional | Object | Допустимые параметры включают в себя: |
Примеры
JapaneseHotelRoomStyle
не имеет значения по умолчанию. Пропуск значения не приводит к ошибке XML, но ваше объявление не отображается в результатах поиска, когда пользователь выполняет фильтрацию по стилю комнаты или кроватям.
Две односпальные кровати
В следующем примере показано, как использовать <RoomFeatures>
:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
<Beds> <!-- Two single beds -->
<Bed size="single">
<Width unit="cm" number="97"/>
<Length unit="cm" number="195"/>
</Bed>
<Bed size="single">
<Width unit="cm" number="97"/>
<Length unit="cm" number="195"/>
</Bed>
</Beds>
<Suite/>
<Capsule/>
<Roomsharing>private</Roomsharing>
<Outdoor/>
<MobilityAccessible/>
<Smoking>non_smoking</Smoking>
<BathAndToilet relation="separate">
<Bath bathtub="1" shower="1"/>
<Toilet electronic_bidet="1" mobility_accessible="1"/>
</BathAndToilet>
<OpenAirBath/>
<AirConditioning/>
<Balcony/>
<Views>
<LakeView/>
<MarinaView/>
<BeachView/>
<ForestView/>
<MountainView/>
<NatureView/>
</Views>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
Две двуспальные кровати
Ниже приведен пример японской комнаты в western
стиле с двумя double
кроватями.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
<Beds> <!-- Two double beds-->
<Bed size="double"></Bed>
<Bed size="double"></Bed>
</Beds>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
Японский стиль без кровати
Ниже приведен пример комнаты в японском стиле без кровати. Для номеров, оформленных japanese
стиле, информация о кровати не требуется.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese</JapaneseHotelRoomStyle>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
Японский вестерн с кроватью
Ниже приведен пример комнаты japanese_western
стиле с кроватью размера king
-size».
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
<Beds>
<Bed size="king"></Bed>
</Beds>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
Если у партнера нет информации о количестве кроватей в номерах japanese_western
, следуйте примеру:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
<PackageData>
Определяет независимые от маршрута метаданные о пакетах номеров для объекта недвижимости. Этот элемент содержит информацию, связанную с партнером и отелем, но не с маршрутом. Целью является однократное определение всех немаршрутных данных и ссылка на них из маршрутных данных.
Элемент <PackageData>
появляется в следующем месте в иерархии XML сообщения транзакции:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Элемент <PackageData>
аналогичен <RoomData>
, но описывает характеристики и термины тарифов, которые не являются частью описания физического номера. Вы используете <RoomData>
и <PackageData>
в сочетании, чтобы предоставить подробную информацию о пакетах номеров и функциях тарифов. Для отдельных комнат, которые не являются частью пакета, используйте только <RoomData>
.
Вы можете определить элементы <RoomData>
и <PackageData>
для одной и той же комнаты или пакета комнат. Когда Google отображает эту комнату или пакет в результатах поиска, он будет включать описания обоих, разделенные дефисом.
Если вы обновляете один элемент <PackageData>
для свойства, необходимо обновить все элементы <PackageData>
и <RoomData>
для этого свойства. Каждый <PropertyDataSet>
считается всеми данными о свойстве и перезаписывает любые существующие данные.
Дополнительную информацию см. в метаданных Room Bundle .
Синтаксис
Элемент <PackageData>
использует следующий синтаксис:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
<PropertyDataSet ... >
<PackageData>
<PackageID>package_ID</PackageID>
<Name>
<Text text="package_name" language="language_code"/>
...
</Name>
<Description>
<Text text="package_description" language="language_code"/>
...
</Description>
<Refundable available="[false|true]" refundable_until_days="number_of_days"
refundable_until_time="time"/>
<ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>
<Occupancy>max_number_of_intended_occupants</Occupancy>
<OccupancyDetails><!-- optional info about the types of guests,
whether adults or children --></OccupancyDetails>
<!-- For these next 3 elements, boolean_value can be 0/1 or true/false -->
<BreakfastIncluded>boolean_value</BreakfastIncluded>
<InternetIncluded>boolean_value</InternetIncluded>
<ParkingIncluded>boolean_value</ParkingIncluded>
<PhotoURL>
<Caption>
<Text text="photo_description" language="language_code"/>
...
</Caption>
<URL>photo_location</URL>
</PhotoURL>
...
<Meals>
<Breakfast
included="[true|false]" buffet="[true|false]"
in_room="[true|false]" in_private_space="[true|false]"/>
<Dinner
included="[true|false]" buffet="[true|false]"
in_room="[true|false]" in_private_space="[true|false]"/>
</Meals>
<CheckinTime>checkin_time</CheckinTime>
<CheckoutTime>checkout_time</CheckoutTime>
<MembershipBenefitsIncluded>
<ProgramName>
<Text language="en" text="Special Rewards">
</ProgramName>
<ProgramLevel>
<Text language="en" text="Platinum">
</ProgramLevel>
</MembershipBenefitsIncluded>
<OnPropertyCredit>
<Amount currency="USD">123.45</Amount>
</OnPropertyCredit>
</PackageData>
<!-- a PackageID with a MilesIncluded
rate feature -->
<PackageData>
<PackageID>room_with_miles</PackageID>
<Name>
<Text text="Room with Bundled Miles" language="en">
</Name>
<ChargeCurrency>hotel </ChargeCurrency>
<MilesIncluded>
<NumberOfMiles>1000 </NumberOfMiles>
<Provider>
<Text language="en" text="United Airlines">
</Provider>
</MilesIncluded>
</PackageData>
...
...
</PropertyDataSet>
...
</Transaction>
Атрибуты
Элемент <PackageData>
не имеет атрибутов.
Дочерние элементы
Элемент <PackageData>
имеет следующие дочерние элементы:
Дочерний элемент | Необходимый? | Тип | Описание |
---|---|---|---|
<BreakfastIncluded> | Optional | boolean | Указывает, включает ли этот пакет завтрак в стоимость проживания. Допустимые значения: 0 (или false ) и 1 (или true ). Предпочтительно использовать |
<ChargeCurrency> | Optional | enum | Когда и где пользователь платит за бронирование. Этот элемент использует тот же синтаксис, что и <ChargeCurrency> в <Result> . Значение по умолчанию — |
<CheckinTime> | Optional | Time | Самое раннее время заезда. Время должно быть не позднее 24:00 по местному времени отеля. |
<CheckoutTime> | Optional | Time | Самое позднее возможное время выезда по местному времени отеля. |
<Description> | Optional | Object | Подробное описание пакета. Этот элемент должен содержать информацию, не описанную другими элементами или элементом <Name> . При указании описания номера не следует использовать все заглавные буквы. Элемент <Description> <Text text="Two breakfast buffet certificates for each night of stay." language="en"/> <Text text="Deux certificats petit-déjeuner buffet pour chaque nuit de séjour." language="fr"/> </Description> |
<InternetIncluded> | Optional | boolean | Если пакет включает бесплатный доступ в Интернет, а другие пакеты не включают эту услугу. Не устанавливайте этот элемент для пакетов номеров в отеле, где во всех номерах предоставляется бесплатный доступ в Интернет. Этот элемент не распространяется на проводной доступ в Интернет в номере или беспроводной доступ в Интернет, который недоступен в номерах. Допустимые значения: 0 (или false ) и 1 (или true ). |
<Meals> | Optional | Object | Содержит информацию о блюдах в этом пакете. Элемент
Необязательные атрибуты используются только в том случае, если Чтобы фильтры еды ( |
<Name> | Required | string | Имя пакета. Это значение должно соответствовать тому, что отображается на целевой странице отеля. Не устанавливайте значение этого элемента только заглавными буквами. Этот элемент принимает один дочерний элемент <Name> <Text text="Bed and Breakfast" language="en"/> <Text text="Lit et petit déjeuné" language="fr"/> </Name> |
<Occupancy> | Optional | integer | Максимальное количество гостей, на которое рассчитан пакет номеров. Например, в большом люксе могут физически разместиться 6 гостей, но он рассчитан только на 4 гостей. Это значение должно быть меньше или равно элементу Значение Если вы укажете этот элемент как в Примечание : <Occupancy> может сопровождаться <OccupancyDetails> , который определяет тип гостей (взрослые или дети). См. <OccupancyDetails> для получения синтаксиса и описания дочерних элементов. |
<PackageID> | Required | string | Уникальный идентификатор пакета. Используйте этот идентификатор, чтобы сопоставить данные пакета номеров с блоками (Вы также можете использовать этот идентификатор для ссылки на общее определение пакета номеров, используемое в одном сообщении транзакции при определении встроенных данных пакета номеров.) |
<ParkingIncluded> | Optional | boolean | Включает ли пакет услуг бесплатную парковку, хотя в противном случае парковка в этом отеле была бы платной услугой. Не указывайте значение этого элемента для отеля, предлагающего бесплатную парковку. Допустимые значения: |
<PhotoURL> | Optional | Object | (То же, что <PhotoURL> в <RoomData> , но для пакета (например, фотографий еды).) |
<Refundable> | Optional | Object | Позволяет указать тариф как полностью возмещаемый или обеспечить бесплатную отмену. Если не указано, информация о возврате средств не отображается. Политика возврата на уровне <PackageData> переопределяет политику возврата на уровне <Result> . Политика возврата на уровне <Rates> переопределяет политику возврата на уровне <PackageData> . Возвратные цены также могут быть показаны пользователям с помощью альтернативных вариантов без непосредственного изменения схемы сообщения о транзакции. Узнайте больше об этих вариантах. Политика возвратных тарифов . В следующем примере показан элемент <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Примечание. Мы рекомендуем установить все атрибуты. Предупреждающее сообщение о статусе канала генерируется, если один или несколько атрибутов не установлены. Если вы не зададите никаких атрибутов, ставка не будет отображаться как возмещаемая. Атрибуты:
При настройке атрибутов обратите внимание на следующее:
|
<MembershipBenefits Included> | Optional | boolean | В стоимость проживания включены преимущества элитного статуса на весь срок пребывания. Включает следующие параметры:
|
<CarRentalIncluded> | Optional | boolean | В стоимость проживания входит бесплатный прокат автомобиля на весь период проживания. |
<MilesIncluded> > | Optional | boolean | В стоимость включены мили для часто летающих пассажиров. Параметры включают в себя:
|
<OnPropertyCredit> | Optional | boolean | В стоимость входит кредит на недвижимость (питание и напитки, курорт, спа и т. д.). Параметр:
|
<AirportTransportationIncluded> | Optional | Object | В стоимость входит бесплатный трансфер от/до ближайшего аэропорта. Необязательный атрибут direction определяет направление транспортировки. Допустимые значения включают в себя:from : Трансфер предоставляется из аэропорта до объекта размещения. Это значение по умолчанию, если направление не указано. to : от отеля предоставляется транспорт до аэропорта. round_trip : Транспорт предоставляется как в аэропорт, так и из него. |
Примеры
Пакет одноместного номера
В следующем примере определен один пакет номеров, рассчитанный на размещение 2 человек (один взрослый и один ребенок) и включающий завтрак:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<PackageData>
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>1</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Two certificates for continental
breakfast will be provided." language="en"/>
<Text text="Deux certificats pour le petit déjeuner
continental seront fournis." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Метаданные комнаты и пакета
В следующем примере определяются метаданные помещения и пакета:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>180054</Property>
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Bed Room" language="en"/>
<Text text="Chambre single" language="fr"/>
</Name>
<Description>
<Text text="Non-smoking" language="en"/>
<Text text="Pas de fumiers" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Includes a delightful array of jams and jellies." language="en"/>
<Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Пакеты из нескольких номеров
В следующем примере определяются метаданные комнаты и пакета для нескольких пакетов комнат:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<!-- A transaction message with room types result. -->
<PropertyDataSet>
<Property>12345</Property>
<RoomData>
<RoomID>single</RoomID>
<Name>
<Text text="Single room" language="en"/>
<Text text="Chambre simple" language="fr"/>
</Name>
<Description>
<Text text="A single room" language="en"/>
<Text text="Le chambre simple" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image1235.jpg</URL>
</PhotoURL>
<Capacity>2</Capacity>
</RoomData>
<RoomData>
<RoomID>double</RoomID>
<Name>
<Text text="Double room" language="en"/>
<Text text="Chambre double" language="fr"/>
</Name>
<Occupancy>1</Occupancy>
</RoomData>
<PackageData>
<PackageID>refundbreakfast</PackageID>
<Name>
<Text text="Refundable Room with Breakfast" language="en"/>
<Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Continental Breakfast" language="en"/>
<Text text="Petit déjeuner continental" language="fr"/>
</Description>
<ChargeCurrency>hotel</ChargeCurrency>
<Refundable available="1" refundable_until_days="3"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>prepaid</PackageID>
<Name>
<Text text="Nonrefundable" language="en"/>
<Text text="Non remboursable" language="fr"/>
</Name>
<Description>
<Text text="Blah blah blad" language="en"/>
<Text text="Le blah blah blad" language="fr"/>
</Description>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="0"/>
</PackageData>
</PropertyDataSet>
</Transaction>
Пакет номеров со стоимостью
В следующем примере определяются метаданные номера и пакета для пакета номеров с функциями тарифа:
<Transaction timestamp="2010-04-24T20:44:56-04:00" id="TXNID">
<PropertyDataSet>
<Property>12345</Property>
<RoomData>
...
</RoomData>
<!-- definitions of PackageData types including rate features -->
<PackageData>
<PackageID>room_with_addl_benefits</PackageID>
<Name>
<Text text="Acme Hotels 2017 Promotion Package" language="en"/>
</Name>
<ChargeCurrency>hotel</ChargeCurrency>
<BreakfastIncluded>1</BreakfastIncluded>
<MembershipBenefitsIncluded>
<ProgramName>
<Text language="en" text="Marriott Rewards"/>
</ProgramName>
<ProgramLevel>
<Text language="en" text="Platinum"/>
</ProgramLevel>
</MembershipBenefitsIncluded>
<OnPropertyCredit>
<Amount currency="USD">123.45</Amount>
</OnPropertyCredit>
</PackageData>
<PackageData>
<PackageID>room_with_miles</PackageID>
<Name>
<Text text="Room with Bundled Miles" language="en"/>
</Name>
<ChargeCurrency>hotel</ChargeCurrency>
<MilesIncluded>
<NumberOfMiles>1000</NumberOfMiles>
<Provider>
<Text language="en" text="United Airlines"/>
</Provider>
</MilesIncluded>
<AirportTransportationIncluded direction="from"/>
</PackageData>
</PropertyDataSet>
<!-- The actual list of prices -->
<Result>
…
</Result>
</Transaction>
Еда и фотографии
В следующем примере определяются метаданные номера и пакета для блюд, фотографий, а также времени заезда и выезда:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Meals Included" language="en"/>
</Name>
<PhotoURL>
<Caption>
<Text text="Breakfast" language="en"/>
<Text text="朝食" language="ja"/>
</Caption>
<URL>http://example.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Meals>
<!-- Guests can choose to have breakfast in their room or in another
space to avoid contact with other guests. -->
<Breakfast included="1" in_room="1" in_private_space="1"/>
<Dinner included="1" buffet="1"/>
</Meals>
<CheckinTime>15:00</CheckinTime>
<CheckoutTime>11:00</CheckoutTime>
</PackageData>
</PropertyDataSet>
</Transaction>
Завтрак
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
</Name>
<PhotoURL>
<Caption>
<Text text="Breakfast" language="en"/>
<Text text="朝食" language="ja"/>
</Caption>
<URL>http://example.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Meals>
<Breakfast included="true"/>
<!-- Dinner not included needs to be explicitly specified -->
<Dinner included="false"/>
</Meals>
<CheckinTime>15:00</CheckinTime>
<CheckoutTime>11:00</CheckoutTime>
</PackageData>
</PropertyDataSet>
</Transaction>
<Result>
Контейнер для обновлений цен и доступности в сообщении <Transaction>
.
Элемент <Result>
появляется в следующем месте в иерархии XML сообщения транзакции:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Используйте <Result>
, чтобы установить или обновить цены на номера и определить доступный инвентарь. Элементы, определенные в этом элементе, обычно ссылаются на независимые от маршрута метаданные о номере или пакете (например, описание или набор удобств), определенные в <PackageData>
и <RoomData>
.
Обычно вы очень часто отправляете сообщения о транзакциях с обновлениями цен. То, как и как часто вы это делаете, зависит от вашего способа доставки .
Вы можете использовать <Result>
в сообщении транзакции для удаления маршрутов, как описано в разделе Удаление инвентаря . Дополнительные сведения об использовании сообщений о транзакциях для обновления цен и доступности см. в разделе Добавление и обновление инвентаря .
Одно сообщение транзакции может включать в себя любое количество элементов <Result>
, если размер сообщения не превышает 100 МБ.
Синтаксис
Элемент <Result>
использует следующий синтаксис:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> <!-- Required --> <Property>hotel_ID</Property> <!-- Required --> <Checkin>YYYY-MM-DD</Checkin> <!-- Required --> <Nights>number_of_nights</Nights> <Baserate currency="currency_code">price</Baserate> <!-- Only required when <Baserate> contains a real price --> <Tax currency="currency_code">tax_amount</Tax> <!-- Only required when <Baserate> contains a real price --> <OtherFees currency="currency_code">fee_amount</OtherFees> <Refundable available="[false|true]" refundable_until_days="number_of_days" refundable_until_time="time"/> <RoomID>room_ID</RoomID> <PackageID>package_ID</PackageID> <ExpirationTime>expiration_time</ExpirationTime> <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency> <Occupancy>max_number_of_intended_occupants</Occupancy> <!-- For Baserate, occupancy value must be greater than or equal to 2. If a value is not provided for occupancy, it defaults to 2. --> <OccupancyDetails>occupancy_info</OccupancyDetails> <Rates>...</Rates> <RoomBundle>...</RoomBundle> <AllowablePointsOfSale> <PointOfSale id="landing_page_identifier"/> ... </AllowablePointsOfSale> <Custom[1-5]>custom_value</Custom[1-5]> </Result> ... </Transaction>
Атрибуты
Элемент <Result>
имеет следующие атрибуты:
Атрибут | Необходимый? | Тип | Описание |
---|---|---|---|
mergeable | Optional | boolean | По умолчанию новые цены для определенного отеля и пары маршрутов перезапишут все предыдущие (еще не истекшие) цены, присутствующие в кеше Google. Атрибут mergeable позволяет сохранять дополнительные цены в кеше Google, не удаляя предыдущую информацию о ценах. Запрос Live Pricing с ответами на контекст всегда будет иметь значение true для этого атрибута (независимо от вашего ответа на сообщение о транзакции). |
Дочерние элементы
Элемент <Result>
имеет следующие дочерние элементы:
Дочерний элемент | Необходимый? | Тип | Описание |
---|---|---|---|
<AllowablePointsOfSale> | Optional | Object | Одна или несколько целевых страниц, подходящих для отеля. Целевая страница — это веб-сайт, который может обрабатывать процесс бронирования для конечного пользователя. Чтобы явно включить определенную целевую страницу (и исключить другие), добавьте один или несколько элементов <AllowablePointsOfSale> , которые соответствуют атрибуту id элемента <PointOfSale> в файле целевых страниц.Если вы не включите этот элемент, все целевые страницы, определенные в файле целевых страниц, будут считаться подходящими для бронирования номера. Дополнительную информацию см. в разделе Синтаксис файла целевых страниц . |
<Baserate> | Optional | float | Стоимость номера за проживание. Значение этого элемента должно отражать следующее:
Если комната недоступна для маршрута, Чтобы удалить пакет номеров, следуйте инструкциям в разделе «Удаление пакета номеров» . <Baserate currency="USD">1200.40</Baserate> Элемент
|
<ChargeCurrency> | Optional | enum | Когда и где пользователь платит за бронирование. Этот элемент можно использовать в сообщении транзакции в элементе <Result> для цены отеля или блоке <PackageData> для пакета номеров.Допустимые значения:
Значение по умолчанию — |
<Checkin> | Required | Date | Дата регистрации для маршрута в формате даты . Комбинация элемента <Nights> и элемента <Checkin> составляет маршрут. |
<Custom[1‑5]> | Optional | string | Определяет настраиваемое поле, которое можно использовать для передачи дополнительных данных, связанных с отелем. Вы можете передать до пяти пользовательских значений со следующими именами элементов:
Элементы Элементы <Custom>, представленные в элементе |
<ExpirationTime> | Optional | DateTime | Дата и время, когда цена считается истекшей (минимум 3 часа). Мы рекомендуем не указывать временные метки срока действия, если это не критично для вашей структуры ценообразования. Google не обслуживает цены с истекшим сроком действия, и любой маршрут с истекшей ценой станет доступным для запроса цен в реальном времени . |
<Nights> | Required | integer | Количество ночей по маршруту. Значение элемента <Nights> должно быть положительным целым числом. Комбинация <Nights> и <Checkin> составляет маршрут. |
<OtherFees> | Optional | float | Сборы, отличные от базовой ставки, и налоги, влияющие на окончательную стоимость номера. Элемент <OtherFees> принимает один обязательный атрибут currency , который определяет трехбуквенный код валюты для комиссий. Например, USD . Элемент |
<Occupancy> | Optional | integer | Указывает максимально допустимое количество жильцов для этого тарифа. Если <Occupancy> отображается непосредственно под <Result> , в нем должно быть указано 2 или более. <Occupancy> может сопровождаться <OccupancyDetails> , который указывает тип гостей (взрослые или дети). Если типы гостей не указаны, предполагается, что это взрослые. Обратитесь к <OccupancyDetails> для получения синтаксиса и описания дочерних элементов. Если элемент <Occupancy> не указан, заполняемость по умолчанию равна 2 .Примечание. Обратитесь в службу поддержки, чтобы включить функцию отправки цен на размещение без двухместного размещения. |
<PackageID> | Optional | string | Уникальный идентификатор пакета для сопоставления его с предопределенными данными пакета. Также используется для заполнения переменной целевой страницы PACKAGE-ID. Дополнительную информацию см. в метаданных Room Bundle . |
<Property> | Required | string | Идентификатор отеля, на который влияют связанные данные (цена, маршрут, пакет номеров или метаданные). Значение этого элемента должно быть строкой. Значение этого элемента должно соответствовать значению <id> объявления, которое вы определили в фиде списка отелей. |
<Rates> | Optional | <Rates> | Контейнер для одного или нескольких блоков <Rate> . Каждый <Rate> в <Rates> определяет разную цену за комбинацию номер/маршрут. Используйте элемент Примечание. В |
<Refundable> | Optional | Object | Позволяет перечислить ставку как полностью возвратную или обеспечивая бесплатную отмену. Если не предоставлено, информация о возврате не отображается. Политика возмещения на уровне <PackageData> переопределяет политику возврата на уровне <Result> . Политика возмещения на уровне <Rates> переопределяет политику возврата на уровне <PackageData> . Возвращаемая цена также может быть выделена пользователям с помощью альтернативных параметров, не изменяя схему сообщений о транзакции. Узнайте больше о политике возвращаемых ставок . В следующем примере показан элемент <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Примечание. Мы рекомендуем установить все атрибуты. Сообщение о статусе подачи генерируется, когда один или несколько атрибутов не установлены. Если вы не устанавливаете никаких атрибутов, скорость не отображается как возвращаемая. Атрибуты:
При настройке атрибутов обратите внимание на следующее:
|
<RoomBundle> | Optional | <RoomBundle> | Контейнер для получения информации о цене физических описаний комнаты, любой упаковки удобств и некоторых данных политики покупки для данного отеля и маршрута. В целом, используйте этот элемент, чтобы определить цены для базового комнаты и различных типов комнат в одном и том же свойстве. Несмотря на то, что можно определить встроенные описания пакетов комнаты, вы должны использовать отдельное сообщение транзакции для определения этой информации. Google будет хранить метаданные, чтобы вы могли ссылаться на них, а не повторять их, во всех будущих обновлениях ценообразования. |
<RoomID> | Optional | string | Уникальный идентификатор комнаты, чтобы составить его с предопределенными данными комнаты. Также используется для заполнения переменной целевой страницы идентификации партнеров. Для получения дополнительной информации обратитесь к метаданным пакета комнаты . |
<Tax> | Optional | float | Налоги, которые рассчитываются по окончательной цене комнаты. Элемент <Tax> принимает один необходимый атрибут, currency , который определяет трехбуквенную валютную код для налогов. Например, USD . Элемент <Tax> требуется, если <Baserate> больше нуля. Если атрибут « |
<Unavailable> | Optional | Object | Указывает, что маршрут недоступен для бронирования. Служит контейнером по более подробным причинам, почему маршрут был недоступен. Одна или несколько из следующих причин недоступности могут быть вложены под тег <Unavailable> :
|
Примеры
Многопомеренный пример
Следующий пример определяет один маршрут и его цены на два свойства:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">278.33</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="site1"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>052213</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">299.98</Baserate>
<Tax currency="USD">26.42</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="otto"/>
<PointOfSale id="simon"/>
</AllowablePointsOfSale>
</Result>
</Transaction>
В этом примере не показаны подробности о комнате, такие как описание, изображение и подпись, название комнаты и ее емкость.
Вы можете определить эту информацию один раз в отдельном сообщении транзакции, которое хранит Google. Затем вы можете ссылаться на это во всех последующих ценах и обновлениях инвентаря. Для получения дополнительной информации обратитесь к метаданным пакета комнаты .
Многократный пример
В следующем примере определяется один маршрут и свойство с несколькими ставками для различных занятий. Элемент <Rates>
может быть использован для обеспечения многократного ценообразования для конкретного свойства. Следующий пример также полезен для свойств аренды отпуска (VR):
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-23T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2021-01-13</Checkin>
<Nights>9</Nights>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>2</Occupancy>
<Rates>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>1</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>3</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>4</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>5</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>6</Occupancy>
</Rate>
</Rates>
</Result>
</Transaction>
Недоступный пример
В следующем примере определяется один маршрут, доступность которого не может быть извлечена из нисходящих каналов, второй, который находится ниже минимального ночного пребывания и уже забронирована для указанных дат, и треть В ходе пребывания:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Unavailable>
<NotFetched/>
</Unavailable>
</Result>
<Result>
<Property>073313</Property>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Unavailable>
<NoVacancy/>
<MinNightStay value=3/>
</Unavailable>
</Result>
<Result>
<Property>052213</Property>
<Checkin>2018-06-10</Checkin>
<Nights>10</Nights>
<Unavailable>
<PropertyClosed first_open="2018-06-15" first_closed="2018-06-10"/>
</Unavailable>
</Result>
</Transaction>
<Rates>
Контейнер для одного или нескольких блоков <Rate>
. Каждый <Rate>
в <Rates>
определяет различную цену на комбинацию комнаты или маршрута.
Используйте элемент <Rates>
только тогда, когда есть несколько ставок для одной и той же комнаты или маршрута. Например, вы определяете несколько ставок для условных ставок , частных ставок или условных ставок в пакетах в помещении .
Элемент <Rates>
появляется в следующем месте в сообщении транзакции XML Иерархия:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
(Can also contain<Rates>
) + ...
Значения, установленные в <Rate>
переопределяют значения, связанные с ценой, на родительском <Result>
или <RoomBundle>
элементе. Если они не установлены в <Rate>
, они наследуют свое значение от родительского элемента. Только <AlliblePointsOfSale> унаследован в элементе <RoomBundle>
.
Синтаксис
В элементе <Rates>
используется следующий синтаксис:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> <Rates> <Rate rate_rule_id="rate_rule_id"> <Baserate currency="currency_code">price</Baserate> <Tax currency="currency_code">tax_amount</Tax> <OtherFees currency="currency_code">fee_amount</OtherFees> <ExpirationTime>expiration_time</ExpirationTime> <Refundable available="[false|true]" refundable_until_days="number_of_days" refundable_until_time="time"/> <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency> <AllowablePointsOfSale> <PointOfSale id="landing_page_identifier"/> </AllowablePointsOfSale> <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <!-- optional info about the types of guests, whether adults or children --></OccupancyDetails> ... <Custom[1-5]>custom_value</Custom[1-5]> </Rate> ... </Rates> </Result> ... </Transaction>
Атрибуты
Элемент <Rates>
имеет следующие атрибуты:
Атрибут | Необходимый? | Описание |
---|---|---|
rate_rule_id | Optional | Для условных ставок этот идентификатор соответствует ставке с определением в вашем файле определения правил. Предел символов для этого поля составляет 40 символов. |
Дочерние элементы
В элементе <Rates>
есть следующие детские элементы:
Детский элемент | Необходимый? | Тип | Описание |
---|---|---|---|
<AllowablePointsOfSale> | Optional | Object | Одна или несколько целевых страниц, которые имеют право на отель. Этот элемент использует тот же синтаксис, что и <AllowablePointsOfSale> на <Result> . |
<Baserate> | Required | float | Цена комнаты для проживания. Этот элемент использует тот же синтаксис, что и <Baserate> на <Result> . ПРИМЕЧАНИЕ. Дочерний элемент |
<ChargeCurrency> | Optional | enum | Когда и где пользователь платит за бронирование. Этот элемент использует тот же синтаксис, что и <ChargeCurrency> в <Result> . |
<Custom[1‑5]> | Optional | string | Пользовательские поля, которые вы можете использовать для передачи дополнительных данных, связанных с отелем на целевую страницу. Этот элемент использует тот же синтаксис, что и <Custom[1‑5]> в <Result> . Существует предел 200 символов на пользовательское поле. Для получения дополнительной информации обратитесь к файлам целевой страницы . Если в элементе |
<ExpirationTime> | Optional | DateTime | Дата и время, когда ставка считается истек. Этот элемент использует тот же синтаксис, что и <ExpirationTime> в <Result> . |
<Occupancy> | Optional | integer | Определяет максимально разрешенные пассажиры для этой ставки. Если не указано, предполагается, что это то же самое, что и родительская ставка. |
<OtherFees> | Required | float | Сборы, отличные от базовой ставки и налогов, которые влияют на окончательную цену комнаты. В этом элементе используется тот же синтаксис, что и <OtherFees> в <Result> . Если атрибут « |
<Refundable> | Optional | Object | Позволяет перечислить ставку как полностью возвратную или обеспечивая бесплатную отмену. Если не предоставлено, информация о возврате не отображается. Политика возмещения на уровне <PackageData> переопределяет политику возмещения на уровне <Result> . Политика возмещения на уровне <Rates> переопределяет политику возмещения на уровне <PackageData> . Возвращаемая цена также может быть выделена пользователям с помощью альтернативных параметров, не изменяя схему сообщений о транзакции. Узнайте больше об этих вариантах, которые возвращаются в политику . В следующем примере показан элемент <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Примечание. Мы рекомендуем установить все атрибуты. Сообщение о статусе подачи генерируется, когда один или несколько атрибутов не установлены. Если вы не устанавливаете никаких атрибутов, скорость не отображается как возвращаемая. Атрибуты:
При настройке атрибутов обратите внимание на следующее:
|
<Tax> | Required | float | Налоги, которые рассчитываются по окончательной цене комнаты. Этот элемент использует тот же синтаксис, что и a <Tax> в <Result> . |
Примеры
Базовая ставка и условная ставка
В следующем примере показано сообщение транзакции, которое содержит базовую скорость и условную скорость :
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">200.00</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<Rates>
<!-- The rate_rule_id is required when using conditional rates -->
<Rate rate_rule_id="mobile">
<!-- Override base rate and taxes for conditional rates -->
<Baserate currency="USD">180.00</Baserate>
<Tax currency="USD">18.00</Tax>
<!-- NOTE: OtherFees is inherited from the above setting -->
<Custom1>ratecode123</Custom1>
</Rate>
</Rates>
</Result>
</Transaction>
Многочисленные условные ставки
В следующем примере определяется базовая ставка и многочисленные условные ставки в <RoomBundle>
:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>2</Nights>
<!-- When Google receives new room bundle information for an itinerary, all
previous room bundle pricing is dropped from Google's cache. Thus, if you
want to delete a specific room bundle from Google's cache, you may do so
by simply not providing that specific room bundle in subsequent transaction
messages. -->
<RoomBundle>
...
<!-- RoomID is required, PackageID is recommended. -->
<RoomID>5</RoomID>
<PackageID>ABC</PackageID>
<!-- Baserate is required. -->
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<!-- RatePlanID is optional and represents the unique identifier for a
room and package data combination. We strongly recommend using RatePlanID
as a variable to build your dynamic landing page (formerly Point of Sale)
URL. For details, see Using Variables and Conditions. -->
<RatePlanID>5-ABC</RatePlanID>
<!-- Occupancy is mandatory for RoomBundle elements. -->
<!-- Elements below will get inherited to nested rate elements. -->
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
</OccupancyDetails>
<InternetIncluded>1</InternetIncluded>
<!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
<ChargeCurrency>web</ChargeCurrency>
<Custom1>ratebasic</Custom1>
<!-- Neither rate overrides Custom2. -->
<Custom2>ratebasic</Custom2>
<Rates>
<Rate rate_rule_id="mobile">
<Baserate currency="USD">258.33</Baserate>
<Tax currency="USD">25.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides ChargeCurrency from roombundle. -->
<ChargeCurrency>hotel</ChargeCurrency>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode321</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
<Rate rate_rule_id="us_or_gb">
<Baserate currency="USD">268.33</Baserate>
<Tax currency="USD">26.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode432</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>
<RoomBundle>
Определяет цены и доступность для комплектов комнаты как ребенок <Result>
в сообщении <Transaction>
. Определите отдельный элемент для каждого пакета или комбинации маршрутов. Чтобы определить пакет и условия комплексов комнаты, используйте <RoomData>
.
Элемент <RoomBundle>
появляется в следующем месте в сообщении транзакции XML иерархия:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Для получения дополнительной информации обратитесь к использованию комплексов .
Синтаксис
Элемент <RoomBundle>
использует следующий синтаксис:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> ... <RoomBundle> <!-- Required unless specified inline under<RoomData>
--> <RoomID>room_ID</RoomID> <!-- Required<PackageData>
--> <PackageID>package_ID</PackageID> <!-- Required --> <Baserate currency="currency_code">price</Baserate> <!-- Required --> <Tax currency="currency_code">taxes</Tax> <!-- Required --> <OtherFees currency="currency_code">other_fees</OtherFees> <Refundable available="[false|true]" refundable_until_days="number_of_days" refundable_until_time="time"/> <!-- Required --> <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency> <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <!-- optional info about the types of guests, whether adults or children --></OccupancyDetails> <BreakfastIncluded>boolean_value</BreakfastIncluded> <InternetIncluded>boolean_value</InternetIncluded> <ParkingIncluded>boolean_value</ParkingIncluded> <RatePlanID>rate_plan_ID</RatePlanID> <Rates>...</Rates> <Custom1>custom_value_1</Custom1> <Custom2>custom_value_2</Custom2> <Custom3>custom_value_3</Custom3> <Custom4>custom_value_4</Custom4> <Custom5>custom_value_5</Custom5> </RoomBundle> ... </Result> </Transaction>
Атрибуты
У элемента <RoomBundle>
нет атрибутов.
Дочерние элементы
У элемента <RoomBundle>
есть следующие детские элементы:
Детский элемент | Необходимый? | Тип | Описание |
---|---|---|---|
<Baserate> | Required | float | Определяет цену на пакет комнаты для пребывания. Этот элемент использует тот же синтаксис, что и <Baserate> в <Result> , за следующим исключением:
|
<BreakfastIncluded> | Optional | boolean | Указывает, включает ли этот комплект номера завтрак со ставкой. |
<ChargeCurrency> | Optional | enum | Когда и где пользователь платит за бронирование. Этот элемент использует тот же синтаксис, что и <ChargeCurrency> в <Result> . Значение по умолчанию - |
<Custom[1‑5]> | Optional | string | Пользовательские поля для передачи дополнительных данных на целевые страницы для пакета комнаты. Эти элементы используют тот же синтаксис, что и <Custom[1-5]> в <Result> . Существует предел 200 символов на пользовательское поле. Для получения дополнительной информации обратитесь к файлам целевой страницы . Если в элементе |
<InternetIncluded> | Optional | boolean | Если комплект комнаты включает в себя доступ к Интернету бесплатно, в то время как другие пакеты не будут включать это удобство. Не устанавливайте этот элемент для номеров в отеле, который предоставляет бесплатный интернет для всех номеров. Этот элемент не распространяется на проводной интернет или беспроводной интернет, который недоступен в номерах. |
<Occupancy> | Required | integer | Определяет максимально разрешенные пассажиры для этой ставки. Например, большой набор может быть в состоянии физически размещать 6 гостей, но «пакет медового месяца» позволяет только 2 гостям. Это значение должно быть меньше или равным При определении занятости в URL-адресах на целевой странице используйте переменные Стоимость Примечания :
|
<OtherFees> | Required | float | Сборы, отличные от базовой ставки и налогов, которые влияют на окончательную цену комнаты. Элемент <OtherFees> принимает один необходимый атрибут, currency , который определяет трехбуквенную валюту для сборов. Например, используйте USD доллара США. |
<PackageID> | Optional (recommended) | string | Уникальный идентификатор для данных пакета. Используйте этот идентификатор, чтобы соответствовать данным пакета комнаты с тем, что было отправлено в <PackageData> . Для получения дополнительной информации обратитесь к метаданным пакета комнаты . (Вы также можете использовать этот идентификатор для ссылки на общее определение пакета комнаты, используемое в одном сообщении транзакции при определении встроенных данных в помещении.) |
<ParkingIncluded> | Optional | boolean | Будет ли комплект комнаты включать парковку бесплатно, где парковка в противном случае была бы оплачиваемой услугой в этом отеле. Не указывайте значение для этого элемента для отеля, который предлагает бесплатную парковку. Допустимые значения: |
<RatePlanID> | Optional | string | Идентификатор плана тарифов представляет уникальный идентификатор для комбинации комнат и упаковки. Например, учитывая значение <RoomID> 5 и значение <PackageID> ABC, вы можете использовать значение 5-ABC для <RatePlanID> . Мы настоятельно рекомендуем использовать ProcePlanid в качестве переменной для создания URL -адреса динамической целевой страницы (ранее продажа).Для получения дополнительной информации обратитесь к использованию переменных и условий . |
<Rates> | Optional | <Rates> | Оценки, которые переопределяют по умолчанию для этого комплекта комнаты. Этот элемент использует тот же синтаксис, что и <Rates> в <Result> . |
<Refundable> | Optional | Object | Позволяет перечислить ставку как полностью возвратную или обеспечивая бесплатную отмену. Если не предоставлено, информация о возврате не отображается. Политика возмещения на уровне <PackageData> переопределяет политику возврата на уровне <Result> . Политика возмещения на уровне <Rates> переопределяет политику возврата на уровне <PackageData> . Возвращаемая цена также может быть выделена пользователям с помощью альтернативных параметров, не изменяя схему сообщений о транзакции. Узнайте больше об этих вариантах, которые возвращаются в политику . В следующем примере показан элемент <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Примечание. Мы рекомендуем установить все атрибуты. Сообщение о статусе подачи генерируется, когда один или несколько атрибутов не установлены. Если вы не устанавливаете никаких атрибутов, скорость не отображается как возвращаемая. Атрибуты:
При настройке атрибутов обратите внимание на следующее:
|
<RoomID> | Required | string | Уникальный идентификатор для данных комнаты. Используйте этот идентификатор, чтобы соответствовать данным пакета комнаты с тем, что вы отправили в <RoomData> . Для получения дополнительной информации обратитесь к метаданным пакета комнаты . (Вы также можете использовать этот идентификатор для ссылки на общее определение комнаты в одном сообщении транзакции при определении встроенных данных комнаты.) |
<Tax> | Required | float | Налоги, которые рассчитываются по окончательной цене комнаты. Элемент <Tax> принимает один необходимый атрибут, currency , который определяет трехбуквенную валютную код для налогов. Например, используйте USD доллара США. |
Примеры
Одиночный пакет занятости
В следующем примере определяется ответ с одним пучком занятости. Когда пользователь выбирает 1
в сборщике занятости, Google отображает самую низкую соответствующую цену независимо от занятости.
Если единственная цена занятости недоступна, то Google покажет самую низкую цену двойной оценки. Обратите внимание, что цены на одну занятость не запрашиваются в прямом эфире, если на маршруте кэшируются двойные занятия или больше цен.
Этот пример ссылается на предопределенные метаданные комнаты и упаковки с элементами <RoomID>
и <PackageID>
. Используйте элементы <RoomData>
и <PackageData>
для определения этой информации.
<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 1 example ----->
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
<!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
<!-- Note: Once defined it does not have to be repeated for future
Transaction Messages.
PropertyDataSets can also be defined and sent in their own
Transaction Message separately from pricing. Google can be
configured to pull just PropertyDataSets once per day
(or on a predefined frequency). -->
<PropertyDataSet>
<Property>180054</Property>
<!-- Can be reused by multiple Room Bundles -->
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Queen Room - Non-Smoking" language="en"/>
<Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<!-- Room can accommodate up to 4, but package data specifies occupancy
between 1 to 4 -->
<Capacity>4</Capacity>
</RoomData>
<RoomData>
<RoomID>436233</RoomID>
<Name>
<Text text="Premium King Room - Non-Smoking" language="en"/>
<Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<Capacity>4</Capacity>
</RoomData>
<!-- Can be reused by multiple Room Bundles -->
<PackageData>
<PackageID>P11111</PackageID>
<Occupancy>1</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P54321</PackageID>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P12345</PackageID>
<Occupancy>4</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="1"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
</PropertyDataSet>
<!-- Efficient method of defining Room Bundles -->
<!-- Part 2: Reference RoomData and PackageData through ID -->
<Result>
<!-- Single occupancy pricing will be specified in a room bundle below -->
<Property>180054</Property>
<Checkin>2017-10-07</Checkin>
<Nights>2</Nights>
<!-- Base Room Bundle -->
<RoomBundle>
<RoomID>060773</RoomID>
<PackageID>P54321</PackageID>
<Baserate currency="USD">199.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RatePlanID>060773-P54321</RatePlanID>
</RoomBundle>
<RoomBundle>
<RoomID>060773</RoomID>
<PackageID>P11111</PackageID>
<!-- Price for 1 ("occupancy") is the lowest price and will be
displayed -->
<Baserate currency="USD">174.99</Baserate>
<Tax currency="USD">22.08</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RatePlanID>060773-P11111</RatePlanID>
</RoomBundle>
<!-- Premium Room Bundle -->
<RoomBundle>
<RoomID>436233</RoomID>
<PackageID>P12345</PackageID>
<!-- Price for 4 ("occupancy"), any eligible room bundle with 1 or more
occupancy will be displayed-->
<Baserate currency="USD">298.88</Baserate>
<Tax currency="USD">42.12</Tax>
<OtherFees currency="USD">10.00</OtherFees>
<RatePlanID>436233-P12345</RatePlanID>
</RoomBundle>
<!-- ..Continue providing all available RoomBundle rates under matched
property for 1 or more occupancies..-->
</Result>
</Transaction>
Два или более занятости
В следующем примере определяется ответ, содержащий два или более занятости.
Этот пример ссылается на предопределенные метаданные комнаты и упаковки с элементами <RoomID>
и <PackageID>
. Используйте элементы <RoomData>
и <PackageData>
для определения этой информации.
<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 3 example ----->
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
<!-- Efficient method of defining Room Bundles-->
<!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
<PropertyDataSet>
<Property>180054</Property>
<!-- Can be reused by multiple Room Bundles -->
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Queen Room - Non-Smoking" language="en"/>
<Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<!-- Room can accommodate up to 4, but package data specifies occupancy
between 1 to 4 -->
<Capacity>4</Capacity>
</RoomData>
<RoomData>
<RoomID>436233</RoomID>
<Name>
<Text text="Premium King Room - Non-Smoking" language="en"/>
<Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<Capacity>4</Capacity>
</RoomData>
<!-- Can be reused by multiple Room Bundles -->
<PackageData>
<PackageID>P33333</PackageID>
<Occupancy>3</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P12345</PackageID>
<Occupancy>4</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="1"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
</PropertyDataSet>
<Result>
<Property>180054</Property>
<Checkin>2017-10-07</Checkin>
<Nights>2</Nights>
<!-- Efficient method of defining Room Bundles -->
<!-- Part 2: Reference RoomData and PackageData through ID -->
<!-- Base Room Bundle -->
<RoomBundle>
<!-- Baserate above and attributes must match atleast one room bundle
below -->
<RoomID>060773</RoomID>
<PackageID>P33333</PackageID>
<Baserate currency="USD">499.99</Baserate>
<Tax currency="USD">55.12</Tax>
<OtherFees currency="USD">22.00</OtherFees>
</RoomBundle>
<!-- Premium Room Bundle -->
<RoomBundle>
<RoomID>436233</RoomID>
<PackageID>P12345</PackageID>
<!-- Lowest price for 3 ("occupancy"), shown below, will be displayed -->
<Baserate currency="USD">598.88</Baserate>
<Tax currency="USD">62.12</Tax>
<OtherFees currency="USD">30.00</OtherFees>
</RoomBundle>
<!-- ..Continue providing all available RoomBundle rates under matched
property for 2 or more occupancies..-->
</Result>
</Transaction>
Несколько комнат
В следующем примере заполняется занятость в нескольких комплектах комнаты, чтобы продемонстрировать возможные цены в комнате в общежитии.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
<Result>
...
<!-- Suite Room Bundle -->
<RoomBundle>
<RoomID>suite1</RoomID>
<PackageID>standard</PackageID>
<Occupancy>2</Occupancy>
<!-- Price for room -->
<Baserate currency="USD">80.00</Baserate>
<Tax currency="USD">5.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RoomData>
<Name>
<Text text="Suite for 2" language="en"/>
</Name>
</RoomData>
</RoomBundle>
<!-- Small Dorm Room Bundle -->
<RoomBundle>
<RoomID>small_dorm</RoomID>
<PackageID>economy</PackageID>
<Occupancy>1</Occupancy>
<!-- Price per bed -->
<Baserate currency="USD">35.00</Baserate>
<Tax currency="USD">3.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RoomData>
<Name>
<Text text="1 bed in small dorm" language="en"/>
</Name>
</RoomData>
</RoomBundle>
<!-- Large Dorm Room Bundle -->
<RoomBundle>
<RoomID>large_dorm</RoomID>
<PackageID>economy</PackageID>
<Occupancy>1</Occupancy>
<!-- Price per bed -->
<Baserate currency="USD">20.00</Baserate>
<Tax currency="USD">2.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RoomData>
<Name>
<Text text="1 bed in large dorm" language="en"/>
</Name>
</RoomData>
</RoomBundle>
...
</Result>
</Transaction>
Многочисленные условные ставки
В следующем примере определяется базовая ставка и многочисленные условные ставки в <RoomBundle>
:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>2</Nights>
<!-- When Google receives new room bundle information for an itinerary, all
previous room bundle pricing is dropped from Google's cache. Thus, if you
want to delete a specific room bundle from Google's cache, you may do so
by simply not providing that specific room bundle in subsequent transaction
messages. -->
<RoomBundle>
...
<!-- RoomID is required, PackageID is recommended. -->
<RoomID>5</RoomID>
<PackageID>ABC</PackageID>
<!-- Baserate is required. -->
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<!-- RatePlanID is optional and represents the unique identifier for a
room and package data combination. We strongly recommend using RatePlanID
as a variable to build your dynamic landing page (formerly Point of Sale)
URL. For details, see Using Variables and Conditions. -->
<RatePlanID>5-ABC</RatePlanID>
<!-- Occupancy is mandatory for RoomBundle elements. -->
<!-- Elements below will get inherited to nested rate elements. -->
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
</OccupancyDetails>
<InternetIncluded>1</InternetIncluded>
<!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
<ChargeCurrency>web</ChargeCurrency>
<Custom1>ratebasic</Custom1>
<!-- Neither rate overrides Custom2. -->
<Custom2>ratebasic</Custom2>
<Rates>
<Rate rate_rule_id="mobile">
<Baserate currency="USD">258.33</Baserate>
<Tax currency="USD">25.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides ChargeCurrency from roombundle. -->
<ChargeCurrency>hotel</ChargeCurrency>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode321</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
<Rate rate_rule_id="us_or_gb">
<Baserate currency="USD">268.33</Baserate>
<Tax currency="USD">26.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode432</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>
<OccupancyDetails>
<Occupancy>
В сообщении транзакции указывает максимальное количество гостей для комнаты или упаковки. <OccupancyDetails>
может содержать дополнительную информацию, такую как число и тип гостей (взрослые или дети).
Когда <Occupancy>
и <OccupancyDetails>
появляются в элементе <Rates>
<Result>
или <RoomBundle>
, это означает, что скорость ограничена деталями занятости.
Синтаксис
Когда появляются <OccupancyDetails>
, ему всегда предшествует <Occupancy>
. Обратите внимание на следующий синтаксис:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> ... <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <NumAdults>number_of_adults</NumAdults> <Children> <Child age=age_of_one_child_guest/> <Child age=age_of_one_child_guest/> </Children> </OccupancyDetails> </Result> </Transaction>
Дочерние элементы
В элементе <OccupancyDetails>
есть следующие детские элементы:
Детский элемент | Необходимый? | Тип | Описание |
---|---|---|---|
<NumAdults> | Required | integer | Количество взрослых гостей. Мин: 1, макс: 20. |
<Children> | Optional | Object | Контейнер для одного или нескольких элементов <Child> . |
<Child age> | Optional | integer | Максимальный возраст для этого ребенка - например, <Child age="17"> . |
Примеры
Следующие примеры показывают, как <OccupancyDetails>
могут появиться в рамках <Results>
, <RoomBundle>
или дочернего элемента <Rates>
.
Ответ результата
В следующем примере определяется один маршрут и его цены на одно свойство в ответ на запрос на живые цены, где пользователь указал номер и типы гостей. Здесь <OccupancyDetails>
- 2 взрослых и один ребенок - возвращаются в <Result>
.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">278.33</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="site1"/>
</AllowablePointsOfSale>
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
</Result>
</Transaction>
Оценка ответа
В следующем примере определяется один маршрут и его цены для 1 взрослого и 1 ребенка. Здесь <OccupancyDetails>
возвращаются в элементе <Rates>
<Result>
.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Transaction id="Wtdj8QoQIWcAAbaTGlIAAAC4" timestamp="2018-04-18T11:27:45-04:00">
<Result>
<Property>8251</Property>
<Checkin>2018-06-20</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">62.18</Baserate>
<Tax currency="USD">2.45</Tax>
<OtherFees currency="USD">0.00</OtherFees>
<Rates>
<Rate rate_rule_id="rule-951">
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>1</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
<Baserate currency="USD">42.61</Baserate>
<Tax currency="USD">5.70</Tax>
<OtherFees currency="USD">0.00</OtherFees>
<Custom1>abc4</Custom1>
<AllowablePointsOfSale>
<PointOfSale id="yourhotelpartnersite.com"/>
</AllowablePointsOfSale>
</Rate>
</Rates>
</Result>
</Transaction>
Комната
В следующем примере определяется занятость 2 взрослых и 1 ребенка в течение двух ночей, с возвратной скоростью. Здесь <OccupancyDetails>
появляются внутри <RoomBundle>
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>6781291</Property>
<Checkin>2017-08-05</Checkin>
<Nights>2</Nights>
...
<RoomBundle>
<RoomID>10291</RoomID>
<RatePlanID>564739</RatePlanID>
<PackageID>564739</PackageID>
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="true" refundable_until_days="1" refundable_until_time="23:59:00" />
<Baserate currency="USD">185.34</Baserate>
<Tax currency="USD">37.06</Tax>
<OtherFees currency="USD">2.22</OtherFees>
</RoomBundle>
</Result>
</Transaction>
Несколько комнат
В следующем примере определяется несколько ставок <RoomBundle>
, которые ограничены занятостью 2 взрослых и 2 детей. Здесь <OccupancyDetails>
появляются в элементе <Rates>
<RoomBundle>
.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">0</OtherFees>
<RoomBundle>
<RoomID>5</RoomID>
<PackageID>STD</PackageID>
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">0</OtherFees>
<InternetIncluded>1</InternetIncluded>
<ChargeCurrency>web</ChargeCurrency>
<Custom1>ratebasic</Custom1>
<Custom2>ratebasic</Custom2>
<Occupancy>4</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="17"/>
<Child age="17"/>
</Children>
</OccupancyDetails>
<Rates>
<Rate rate_rule_id="mobile">
<Baserate currency="USD">258.33</Baserate>
<Tax currency="USD">25.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<ChargeCurrency>hotel</ChargeCurrency>
<Custom1>ratecode321</Custom1>
</Rate>
<Rate rate_rule_id="us_or_gb">
<Baserate currency="USD">268.33</Baserate>
<Tax currency="USD">26.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<Custom1>ratecode432</Custom1>
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>