कीमत और रूम इन्वेंट्री (ट्रांज़ैक्शन) एक्सएमएल रेफ़रंस

यह पेज एक्सएमएल पर आधारित लेन-देन के मैसेज के लिए रेफ़रंस देता है.

<Transaction>

लेन-देन से जुड़े मैसेज का रूट एलिमेंट <Transaction> है. यह एक कंटेनर है, जिसमें कमरों और पैकेज के लिए कमरे, उनके पैकेज, और उनका किराया और उनकी उपलब्धता की जानकारी.

<Transaction> एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है लेन-देन के मैसेज की एक्सएमएल हैरारकी:

+ <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 वह पार्टनर खाता जिससे लेन-देन का मैसेज मिला है. आपने लोगों तक पहुंचाया मुफ़्त में आम तौर पर इसका इस्तेमाल तब करें, जब आपका बैकएंड एक से ज़्यादा वीडियो के लिए कीमत फ़ीड उपलब्ध कराता हो पार्टनर खाते. इस स्ट्रिंग का मान "Partner key" है वैल्यू यहां दी गई है खाते की सेटिंग वाले पेज पर जाएं.
timestamp Required DateTime

वह समय जब लेन-देन मैसेज भेजा गया.

पिछले 24 घंटों के भीतर के टाइमस्टैंप के साथ भेजा गया कोई भी मैसेज प्रोसेस किया जा सकता है और जिन्हें नहीं खारिज किया गया है.

मैसेज timestamp के क्रम में प्रोसेस किए जाते हैं, न कि मिलने का मतलब है. उदाहरण के लिए, 2019-05-03 14:09:00 का टाइमस्टैंप जो एक 2019-05-03 14:10:00 के टाइमस्टैंप वाले मैसेज में अब भी क्रम से प्रोसेस किए जाते हैं और मैसेज में बताई गई कीमत 2019-05-03 14:10:00 के टाइमस्टैंप का इस्तेमाल किया जाएगा.

चाइल्ड एलीमेंट

<Transaction> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट ज़रूरी है? टाइप ब्यौरा
<PropertyDataSet> Optional* <PropertyDataSet>

किसी खास कमरे और रूम बंडल के बारे में बताता है. आप आम तौर पर इसका इस्तेमाल करते/करती हैं एलिमेंट जोड़ा गया है, ताकि शेयर की गई वैल्यू तय की जा सके रूम बंडल खरीदने और लेन-देन के मैसेज का साइज़ कम करने के लिए.

<Result> Optional* <Result>

कमरे की यात्रा की योजना के लिए कीमत का डेटा या <RoomBundle> एलिमेंट, जो रूम बंडल और प्रॉपर्टी के लिए अलग-अलग तरह के कमरे उपलब्ध हैं. कॉन्टेंट बनाने <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>

एक रात का किराया

नीचे दिए गए उदाहरण में, एक से सात रातों की शुरुआत के लिए किराये का डेटा बताया गया है 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>

इन्वेंट्री हटाएं

इस उदाहरण में, कई इन्वेंट्री हटाई गई हैं (एक रात ठहरने के लिए कई अलग-अलग तारीखें) के आधार पर दिखाया जाता है:

<?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>

कंटेनर में कमरे और पैकेज (या कमरे के बंडल) की जानकारी के लिए <Transaction> मैसेज. किसी होटल पर सेट की गई वैल्यू, पार्टनर पर सेट की गई वैल्यू को बदलती हैं. Google यह जानकारी सेव करता है, ताकि आपको हर बार जानकारी देने की ज़रूरत न पड़े तो आप कीमतों के बारे में अपडेट भेजते हैं.

<PropertyDataSet> एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है लेन-देन के मैसेज की एक्सएमएल हैरारकी:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>  // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा देखें.

सिंटैक्स

<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>, लेकिन इसमें उन सुविधाओं और शर्तों के बारे में बताया गया है जो इसमें शामिल नहीं हैं कमरे के ब्यौरे में शामिल किया गया है.

कीमत के अपडेट में, पैकेज आईडी का रेफ़रंस दिया जाता है.

ज़्यादा जानकारी के लिए, इसे देखें रूम बंडल का मेटाडेटा.

<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>

इस कमरे और रूम बंडल के किराये और उपलब्धता की जानकारी भेजने पर, कीमत बताने वाले मैसेज में कमरे और पैकेज आईडी का रेफ़रंस दें. इसका नतीजा यह है कि आप अपने संदेशों का आकार बहुत अधिक घटा सकते हैं, और साथ ही डुप्लीकेट डेटा की वजह से आपको कितनी गड़बड़ियां मिल सकती हैं. ज़्यादा के लिए रूम बंडल मेटाडेटा देखें.

<RoomData>

इससे, कमरों की जानकारी, यात्रा की योजना, और एक्सटेंशन की मदद से अलग-अलग कमरों की जानकारी मिलती है बंडल (रूम बंडल में कमरे और दूसरी सुविधाएं शामिल होती हैं). इस्तेमाल की जाने वाली चीज़ें कीमत में, ज़्यादा जानकारी वाले डेटा का दोहराव कम करने के लिए <RoomData> करें फ़ीड.

<RoomData> एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है लेन-देन के मैसेज की एक्सएमएल हैरारकी:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

<RoomData> एलिमेंट में शामिल जानकारी पार्टनर और होटल के लिए ज़रूरी है, लेकिन यात्रा की योजना के साथ नहीं. सभी मकसद के लिए सामान्य डेटा.

<RoomData> एलिमेंट, <PackageData> की तरह है, लेकिन यह इसके बारे में बताता है जैसी सुविधाओं और पैकेज की शर्तों को पूरा करने की ज़रूरत नहीं होती. आप उपयोग करते हैं <RoomData> और <PackageData> को मिलाकर, इस बारे में जानकारी दें कमरों के बंडल. जो अलग-अलग कमरे किसी पैकेज में शामिल नहीं हैं उनके लिए, सिर्फ़ <RoomData>.

आप इसके लिए <RoomData> और <PackageData> दोनों एलिमेंट तय कर सकते हैं एक ही कमरे या अलग-अलग कमरे. जब Google उस कमरे या पैकेज को खोज परिणामों में शामिल होंगे, तो इसमें दोनों के वर्णन शामिल होंगे, जो हाइफ़न.

ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा देखें.

सिंटैक्स

<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 उन मेहमानों की ज़्यादा से ज़्यादा संख्या जो एक कमरे में थक सकते हैं जगह की जानकारी. किसी कमरे की क्षमता इससे ज़्यादा या इसके बराबर है बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या.

तय किए जाने पर, यह मान, मान के बराबर या उससे ज़्यादा होना चाहिए <Occupancy> एलिमेंट का इस्तेमाल करके, जो लक्ष्य के तौर पर इस्तेमाल किया जा सकता है किसी कमरे में कितने मेहमान हैं. उदाहरण के लिए, किसी बड़े सुइट का <Capacity> की लंबाई छह हो सकती है, लेकिन इसके लिए <Occupancy>, 4 है.

<Capacity> की वैल्यू एक पॉज़िटिव पूर्णांक होनी चाहिए 1 से 20 के बीच.

<Description> Optional Object कमरे के बारे में पूरी जानकारी. इस एलिमेंट को ऐसा करना चाहिए उसमें ऐसी जानकारी शामिल हो जिसे अन्य एलिमेंट या <Name> एलिमेंट. आपको पूरी पूंजी का इस्तेमाल नहीं करना चाहिए कमरे का विवरण तय करते समय अक्षरों का इस्तेमाल करें.

<Description> एलिमेंट में एक चाइल्ड खाता होता है <Text> एलिमेंट में, नीचे दिए गए दो एलिमेंट शामिल हैं ज़रूरी एट्रिब्यूट:

  • text: चैट रूम के बारे में पूरी जानकारी.
  • language: दो अक्षरों वाला भाषा कोड; उदाहरण के लिए, fr.

हर भाषा के लिए अलग <Text> एलिमेंट का इस्तेमाल करें जिसमें आपका विज्ञापन या मुफ़्त बुकिंग लिंक दिख सकता है (जिसमें language एट्रिब्यूट).

नीचे दिए गए उदाहरण में, रूम के फ़्रेंच और अंग्रेज़ी वर्शन दिखाए गए हैं विवरण:

<Description>
  <Text text="Two queen-sized beds" language="en"/>
  <Text text="Deux lits de la reine" language="fr"/>
</Description>
<Name> Required string रूम की कैटगरी का नाम. यह मान इससे मेल खाना चाहिए: होटल के लैंडिंग पेज पर दिखाई देता है (पहले बिक्री की जगह था). सेट न करें सभी बड़े अक्षरों में इस एलिमेंट की वैल्यू डालें.

इस एलिमेंट को <Text>, सिंगल चाइल्ड एलिमेंट की ज़रूरत होती है. इसमें ये दो ज़रूरी एट्रिब्यूट होते हैं:

  • text: रूम का नाम.
  • language: दो अक्षरों वाला भाषा कोड; उदाहरण के लिए, fr.

हर भाषा के लिए अलग <Text> एलिमेंट का इस्तेमाल करें जिसमें आपका विज्ञापन या मुफ़्त बुकिंग लिंक दिख सकता है ( language एट्रिब्यूट के लिए वैल्यू).

नीचे दिए गए उदाहरण में, रूम के फ़्रेंच और अंग्रेज़ी वर्शन दिखाए गए हैं नाम:

<Name>
  <Text text="Standard Double Room" language="en"/>
  <Text text="Le chambre double" language="fr"/>
</Name>
<Occupancy> Optional integer ज़्यादा से ज़्यादा मेहमानों की संख्या जिनके लिए कमरा बुक किया गया है. उदाहरण के लिए, एक बड़ा सुइट छह मेहमान (क्षमता = 6), लेकिन यह ज़्यादा से ज़्यादा 4 मेहमानों के लिए है.

यह मान इससे कम या इसके बराबर होना चाहिए: <Capacity> एलिमेंट, जिसमें लोगों की संख्या होती है जिन्हें कोई भी कमरा दे सके.

<Occupancy> की वैल्यू पॉज़िटिव होनी चाहिए 1 से 99 के बीच का पूर्णांक.

<Occupancy> के साथ शायद <OccupancyDetails>, जो यह बताता है कि मेहमान (वयस्क या बच्चे). सिंटैक्स के लिए <OccupancyDetails> देखें चाइल्ड एलिमेंट की जानकारी शामिल होती है.

<OccupancySettings> Optional Object ऐसी सेटिंग जो किसी कमरा.

<OccupancySettings> एलिमेंट ये चाइल्ड एलिमेंट:

  • <MinOccupancy>: मेहमानों की कम से कम संख्या जो एक कमरे में रह सकते हैं. उदाहरण के लिए, अगर यह 2, यह कमरा एक मेहमान के लिए बुक नहीं किया जा सकता.

    <MinOccupancy> की वैल्यू पॉज़िटिव होनी चाहिए 1 से 99 के बीच का पूर्णांक.

  • <MinAge>: सभी मेहमानों के लिए कम से कम उम्र एक कमरे में रहना. उदाहरण के लिए, अगर इसे 18 पर सेट किया जाता है, यह कमरा सिर्फ़ उन ग्रुप के लिए बुक किया जा सकता है जिनमें सभी मेहमानों की उम्र 18 साल है या उससे पुराने.

    <MinAge> की वैल्यू एक पॉज़िटिव पूर्णांक होनी चाहिए 0 से 99 के बीच, 0 से 99 के बीच.

<OccupancySettings>
  <MinOccupancy>2</MinOccupancy>
  <MinAge>16</MinAge>
</OccupancySettings>

सभी चाइल्ड एलिमेंट शामिल करना ज़रूरी नहीं है.

<PhotoURL> Optional Object दिए गए कमरे की फ़ोटो का यूआरएल और वैकल्पिक कैप्शन या अलग-अलग कमरों का बंडल. एक से ज़्यादा <PhotoURL> दिए जा सकते हैं एक कमरे या अलग-अलग कमरे के बंडल के लिए. हर फ़ोटो का यूआरएल उसका अपना होना चाहिए <PhotoURL>.

इस एलिमेंट में ये चाइल्ड एलिमेंट शामिल होते हैं:

  • <URL>: फ़ोटो की जगह के बारे में बताता है. कॉन्टेंट बनाने स्थान सार्वजनिक होना चाहिए (फ़ायरवॉल के पीछे नहीं) और उसमें शामिल होना चाहिए प्रोटोकॉल (उदाहरण के लिए, https://). सिर्फ़ एक का इस्तेमाल करें हर <PhotoURL> के लिए <URL>.
  • <Caption>: फ़ोटो के कैप्शन के बारे में बताता है. इस एलिमेंट को <Text>, सिंगल चाइल्ड एलिमेंट की ज़रूरत होती है. जिसमें दो ज़रूरी एट्रिब्यूट हैं: text और language. text एट्रिब्यूट कैप्शन है, और language एट्रिब्यूट, दो अक्षरों वाले फ़ील्ड के बारे में बताता है भाषा कोड, जैसे en.

उदाहरण:

<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> ब्लॉक को शामिल करना होगा. इसके लिए ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा देखें. (आप इस आईडी का इस्तेमाल किसी सिंगल रूम की कॉमन डेफ़िनिशन के बारे में बताने के लिए भी किया जा सकता है रूम के डेटा को इनलाइन तय करते समय लेन-देन की जानकारी देने वाला मैसेज दिखेगा.)

उदाहरण

रूम का डेटा

नीचे दिए गए उदाहरण में कमरे के डेटा के बारे में बताया गया है:

<?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> एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है लेन-देन के मैसेज की एक्सएमएल हैरारकी:

+ <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

जैपनीज़ होटल के कमरे की शैली को दिखाता है.

मान्य मान हैं:

  • western: पश्चिमी शैली का एक कमरा, जिसमें बेड हैं.
  • japanese: जैपनीज़ शैली का एक कमरा, जिसमें फ़ुटॉन (जापानी शैली वाले सोफ़े) बेड हैं.
  • japanese_western: जैपनीज़ पश्चिमी शैली का एक कमरा, जिसमें पश्चिमी शैली के बेड और जैपनीज़ शैली के फ़ूटॉन, दोनों.
<Beds> Optional Object रूम में ज़्यादा से ज़्यादा <Bed> शामिल हैं. नोट जोड़ें कि यहां जापानी फ़ुटॉन की गिनती नहीं की जानी चाहिए.

हर <Bed> में ये एट्रिब्यूट होते हैं:

  • size (ज़रूरी नहीं): मान्य वैल्यू single हैं, semi_double, double, queen, और king.
हर <Bed> में ये चाइल्ड एलिमेंट होते हैं:
  • <Width> (ज़रूरी नहीं): बेड की चौड़ाई बताता है. ज़रूर जिनके पास cm मान के साथ unit एट्रिब्यूट है और एट्रिब्यूट number, जिसमें बेड की चौड़ाई पूर्णांक में है सेंटीमीटर.
  • <Length> (ज़रूरी नहीं): बेड की लंबाई बताता है. cm मान के साथ unit विशेषता होनी चाहिए और एट्रिब्यूट number, जिसमें बेड की लंबाई पूर्णांक सेंटीमीटर.
उदाहरणः
<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 इसमें कमरे में नहाने और शौचालय के बारे में जानकारी है.

एट्रिब्यूट है:

  • relation (ज़रूरी नहीं): यह बताता है कि नहाने की जगह और टॉयलेट कैसा है एक-दूसरे के ख़िलाफ़ रखे जाते हैं. मान्य वैल्यू together हैं (स्नान और शौचालय दोनों एक ही कमरे में एक साथ स्थित हैं (जैसे, बाथरूम) और separate (नहाने और शौचालय, दोनों में अलग से जगह है). यह एट्रिब्यूट सेट करें.

वैकल्पिक रूप से, ये एलिमेंट इन चाइल्ड एलिमेंट को भी शामिल करते हैं:

  • <Bath> (ज़रूरी नहीं): यह एलिमेंट मौजूद है बताता है कि कमरे में नहाने की सुविधा है.

    एट्रिब्यूट:

    • bathtub (ज़रूरी नहीं): यह बताता है कि नहाने की जगह में कोई बाथरूम में रखा है. मान्य वैल्यू 0 हैं (या false) और 1 (या true).
    • shower (ज़रूरी नहीं): यह बताता है कि नहाने की जगह में कोई शावर. मान्य वैल्यू 0 (या false) हैं और 1 (या true).
  • <Toilet> (ज़रूरी नहीं): यह एलिमेंट मौजूद है बताता है कि इस कमरे में शौचालय है.

    एट्रिब्यूट:

    • electronic_bidet (ज़रूरी नहीं): यह बताता है कि टॉयलेट में इलेक्ट्रॉनिक बिडेट लगा है. मान्य वैल्यू 0 (या false) हैं और 1 (या true).
    • mobility_accessible (ज़रूरी नहीं): यह बताता है कि शौचालय की सुविधा उपलब्ध है. मान्य वैल्यू 0 हैं (या false) और 1 (या true).

उदाहरण:

<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 मान्य विकल्पों में ये शामिल हैं:

<AirportView/>
<BayView/>
<BeachView>/>
<CastleView/>
<CityView/>
<CountrysideView/>
<CourtyardView/>
<DuneView/>
<ForestView/>
<GardenView/>
<GolfCourseView/>
<HarborView/>
<LagoonView/>
<LakeView/>
<MarinaView/>
<MountainView/>
<NatureView/>
<OceanView/>
<ParkView/>
<PartialOceanView/>
<PisteView/>
<PoolView/>
<PyramidView/>
<RiverView/>
<StreetView/>

उदाहरण

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>

बिस्तर के साथ जैपनीज़ वेस्टर्न

यहां king के साथ 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>
        <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> एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है लेन-देन के मैसेज की एक्सएमएल हैरारकी:

+ <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> को प्रॉपर्टी का पूरा डेटा माना जाता है और किसी मौजूदा डेटा को ओवरराइट कर देता है.

ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा देखें.

सिंटैक्स

<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).

बेहतर होगा कि आप इसके बजाय <Meals> <BreakfastIncluded>.

<ChargeCurrency> Optional enum उपयोगकर्ता बुकिंग के लिए कब और कहां पैसे चुकाता है. यह एलिमेंट उसी यूआरएल का इस्तेमाल करता है <Result> में <ChargeCurrency> के रूप में सिंटैक्स.

डिफ़ॉल्ट वैल्यू web है.

<CheckinTime> Optional Time चेक-इन करने का जल्द से जल्द समय. होटल के स्थानीय समय के हिसाब से, समय 24:00 से कम होना चाहिए.
<CheckoutTime> Optional Time होटल के स्थानीय समय के हिसाब से, चेक-आउट करने का सबसे हाल का समय.
<Description> Optional Object पैकेज के बारे में ज़्यादा जानकारी. इस एलिमेंट को ऐसा करना चाहिए उसमें ऐसी जानकारी शामिल हो जिसे अन्य एलिमेंट या <Name> एलिमेंट. आपको पूरी पूंजी का इस्तेमाल नहीं करना चाहिए कमरे का विवरण तय करते समय अक्षरों का इस्तेमाल करें.

<Description> एलिमेंट के लिए चाइल्ड एलिमेंट, <Text>, जिसमें दो ज़रूरी एट्रिब्यूट हैं, text और language. text एट्रिब्यूट, ब्यौरा है और language एट्रिब्यूट एक दो अक्षरों वाला भाषा कोड तय करता है, जैसा कि नीचे दिया गया उदाहरण दिया गया है दिखाता है:

<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 इस पैकेज में खाने के बारे में जानकारी होती है.

<Meals> एलिमेंट में दो वैकल्पिक चाइल्ड एलिमेंट को शामिल किया जाता है एलिमेंट, <Breakfast> और <Dinner>, इसमें ये एट्रिब्यूट होते हैं:

  • included (ज़रूरी है): 1 (या true) पर सेट करें अगर किराये में नाश्ता/रात का खाना शामिल है; अगर ऐसा नहीं है, तो 0 पर सेट करें या false.
  • in_room (ज़रूरी नहीं): 1 या true पर सेट करें अगर मेहमानों के ठहरने के लिए, कमरे में नाश्ता/डिनर करने का विकल्प है में; नहीं होना चाहिए, तो 0 (या false) पर सेट करें.
  • in_private_space (ज़रूरी नहीं): 1 पर सेट करें (या true) अगर मेहमानों के पास नाश्ते/डिनर का विकल्प है ऐसी जगह (उस कमरे को छोड़कर जिसमें वे रहते हैं) जहां वे संपर्क करने से बच सकें अन्य मेहमान; नहीं होना चाहिए, तो 0 (या false) पर सेट करें.
  • buffet (ज़रूरी नहीं): 1 या true पर सेट करें अगर नाश्ता/रात का खाना बुफ़े के तौर पर परोसा जाता है; अगर ऐसा नहीं है, तो 0 पर सेट करें (या false).

वैकल्पिक विशेषताओं का इस्तेमाल सिर्फ़ तब किया जाता है, जब included सही है.

मील फ़िल्टर (no meals, breakfast only, dinner only, और breakfast and dinner) तक पहुंचने में समय लगेगा, <Breakfast> और <Dinner>, दोनों को को included एट्रिब्यूट के साथ सबमिट किया जाना चाहिए.

<Name> Required string पैकेज का नाम. यह वैल्यू, होटल का लैंडिंग पेज. इस एलिमेंट की वैल्यू को पूरी तरह से कैपिटल पर सेट न करें अंग्रेज़ी वर्णमाला के छोटे अक्षर दिखाएं.

इस एलिमेंट को <Text>, सिंगल चाइल्ड एलिमेंट की ज़रूरत होती है. जिसमें दो एट्रिब्यूट, text और language हैं. text एट्रिब्यूट, ब्यौरा है और language एट्रिब्यूट, दो अक्षरों वाले भाषा कोड के बारे में बताता है, जैसा कि नीचे दिए गए उदाहरण में बताया गया है:

<Name>
  <Text text="Bed and Breakfast" language="en"/>
  <Text text="Lit et petit déjeuné" language="fr"/>
</Name>
<Occupancy> Optional integer ज़्यादा से ज़्यादा इतने मेहमानों की संख्या जिनके लिए कमरे का बंडल बनाया गया है. उदाहरण के लिए, एक बड़ा सुइट छह यह ज़्यादा से ज़्यादा चार लोगों के लिए है.

यह मान इससे कम या इसके बराबर होना चाहिए: <Capacity> एलिमेंट, जिसमें लोगों की संख्या होती है जिन्हें कोई भी कमरा दे सके.

<Occupancy> की वैल्यू पॉज़िटिव होनी चाहिए 1 से 99 के बीच का पूर्णांक.

अगर इस एलिमेंट को <RoomBundle> और, दोनों में तय किया जाता है <PackageData>, <RoomBundle> में दी गई वैल्यू को प्राथमिकता दी जाती है.

ध्यान दें:

<Occupancy> के साथ शायद <OccupancyDetails>,यह दिखाता है कि मेहमान किस तरह के हैं (वयस्क या बच्चे). सिंटैक्स के लिए <OccupancyDetails> देखें और चाइल्ड एलिमेंट की जानकारी.
<PackageID> Required string

पैकेज का यूनीक आईडी. इस आईडी का इस्तेमाल आपके स्पेस में <Result> ब्लॉक के साथ, रूम बंडल का डेटा कीमत से जुड़े अपडेट. ज़्यादा जानकारी के लिए, इसे देखें रूम बंडल मेटाडेटा.

(आप इस आईडी का इस्तेमाल, रूम बंडल की सामान्य परिभाषा बताने के लिए भी कर सकते हैं रूम बंडल डेटा तय करते समय एक ही लेन-देन मैसेज में इस्तेमाल किया गया inline.)

<ParkingIncluded> Optional boolean रूम बंडल में बिना किसी शुल्क के पार्किंग शामिल है या नहीं, अगर ऐसा नहीं है, तो इस होटल में पार्किंग की सुविधा के लिए पैसे चुकाने होंगे. जानकारी न दें मुफ़्त पार्किंग की सुविधा देने वाले होटल के लिए इस एलिमेंट का मान.

मान्य वैल्यू 0 (या false) हैं और 1 (या true). डिफ़ॉल्ट मान यह है false.

<PhotoURL> Optional Object (<RoomData> में <PhotoURL> की तरह, लेकिन पैकेज (जैसे कि खाने की फ़ोटो) के लिए.
<Refundable> Optional Object इससे किराये की जानकारी को पूरा रिफ़ंड या मुफ़्त उपलब्ध कराने के तौर पर लिस्ट किया जाता है रद्द करने की प्रक्रिया. अगर यह जानकारी नहीं दी जाती है, तो रिफ़ंड के बारे में कोई जानकारी नहीं दिखाई जाएगी. <PackageData> के लेवल पर रिफ़ंड नीति, रिफ़ंड नीति की जगह लागू हो जाती है <Result> लेवल. <Rates> लेवल पर रिफ़ंड नीति में बदलाव रिफ़ंड नीति को <PackageData> के लेवल पर सबमिट करें. रिफ़ंड की जा सकने वाली कीमत उपयोगकर्ताओं के लिए, सीधे तौर पर नहीं दिए गए अन्य विकल्पों की मदद से भी उन्हें हाइलाइट किया जाएगा ट्रांज़ैक्शन मैसेज के स्कीमा में बदलाव किया जा रहा है. इन विकल्पों के बारे में ज़्यादा जानें किराये के रिफ़ंड के लिए बनी नीति.

यहां दिए गए उदाहरण में, <Refundable> को दिखाया गया है वह एलिमेंट जिसमें इसके सभी एट्रिब्यूट सेट हैं:

<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>

ध्यान दें: हमारा सुझाव है कि आप सभी एट्रिब्यूट को सेट करें. एक फ़ीड स्थिति के बारे में चेतावनी देने वाला मैसेज तब जनरेट होता है, जब एक या उससे ज़्यादा एट्रिब्यूट सेट नहीं है.

अगर आपने कोई एट्रिब्यूट सेट नहीं किया है, तो दर इस तरह नहीं दिखती है रिफ़ंड किया जा सकता है. एट्रिब्यूट:

  • available: (ज़रूरी है) 1 पर सेट करें या true से पता चलता है कि दर में पूरा किराया दिखाया जा सकता है या नहीं रिफ़ंड; अगर वैल्यू को 0 या false पर सेट करना है.
  • refundable_until_days: (अगर यह ज़रूरी है, तो available true है) खास जानकारी चेक-इन से इतने दिन पहले पूरा रिफ़ंड मिल सकता है अनुरोध किया गया है. refundable_until_days की वैल्यू यह 0 से 330 के बीच का कोई पूर्णांक होना चाहिए.
  • refundable_until_time: (अगर इसका सुझाव दिया जाता है, तो available true है) खास जानकारी होटल के स्थानीय समय में दिन के सबसे हाल के समय में, रिफ़ंड के अनुरोध पर ध्यान दिया जाएगा. इसे एक साथ जोड़ा जा सकता है इसकी जानकारी देने के लिए refundable_until_days उदाहरण के लिए, "रिफ़ंड की सुविधा दो दिन पहले शाम 4 बजे तक उपलब्ध है चेक-इन". अगर refundable_until_time सेट नहीं है, तो डिफ़ॉल्ट रूप से आधी रात पर सेट होती है.

    इस एट्रिब्यूट की वैल्यू, Time फ़ॉर्मैट का इस्तेमाल करती है.

एट्रिब्यूट सेट करते समय, इन बातों का ध्यान रखें:

  • अगर available या refundable_until_days नहीं है सेट है, तो दर रिफ़ंड के रूप में नहीं दिखती है.
  • अगर available, 0 या false है, तो इसके अलावा, अन्य एट्रिब्यूट पर ध्यान नहीं दिया जाता. दर इस तरह नहीं दिख रही है यह रिफ़ंड तब भी दिया जा सकता है, जब एक या दोनों अन्य एट्रिब्यूट सेट हों.
<MembershipBenefits Included> Optional boolean किराये में ठहरने के दौरान मिलने वाले खास स्टेटस के फ़ायदे शामिल हैं. इसमें शामिल है नीचे दिए पैरामीटर:
  • ProgramName: एलीट स्टेटस प्रोग्राम का नाम
  • ProgramLevel: प्रोग्राम का लेवल. जैसे: "गोल्ड."
  • NightlyValue (optional): एक रात के लिए होटल का किराया फ़ायदे.
<CarRentalIncluded> Optional boolean इस किराये में, ठहरने के दौरान किराये पर कार लेने की सुविधा भी शामिल है.
<MilesIncluded>&gt; Optional boolean दर में नियमित हवाई यात्री मील शामिल हैं. इनमें ये पैरामीटर शामिल हैं:
  • NumberofMiles: हर यात्रा की योजना में मील की संख्या.
  • Provider: फ़्रीक्वेंट फ़्लायर मील देते हैं.
<OnPropertyCredit> Optional boolean किराये में प्रॉपर्टी के लिए क्रेडिट कार्ड शामिल हैं. जैसे, खाने-पीने की चीज़ें, रिज़ॉर्ट, स्पा वगैरह. पैरामीटर:
  • Amount: स्थानीय भाषा में, हर यात्रा की योजना के लिए क्रेडिट की वैल्यू मुद्रा.
<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> एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है लेन-देन के मैसेज की एक्सएमएल हैरारकी:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

कमरे का किराया सेट या अपडेट करने और तय करने के लिए <Result> का इस्तेमाल करें उपलब्ध इन्वेंट्री में. इस एलिमेंट में तय किए गए आइटम आम तौर पर रेफ़रंस के लिए दिए जाते हैं किसी कमरे या पैकेज की यात्रा का मेटाडेटा (जैसे, इवेंट का ब्यौरा या सुविधाओं का सेट) के बारे में <PackageData> और <RoomData> में बताया गया है.

आम तौर पर, आपको कीमत के अपडेट के साथ लेन-देन की जानकारी बार-बार भेजी जाती है. यह आपके डिलीवरी मोड पर निर्भर करता है कि आप ऐसा कितनी बार और कब करते हैं.

लेन-देन वाले मैसेज में <Result> का इस्तेमाल करके, यात्रा की योजनाएं इस तरह से हटाई जा सकती हैं: इन्वेंट्री हटाना सेक्शन में बताया गया है. कीमतें अपडेट करने के लिए, लेन-देन से जुड़े मैसेज का इस्तेमाल करने और खरीदारी के लिए उपलब्धता, इन्वेंट्री जोड़ना और अपडेट करना.

एक लेन-देन मैसेज में कई <Result> एलिमेंट शामिल हो सकते हैं उसमें, जब तक कि संदेश का आकार 100MB से अधिक न हो.

सिंटैक्स

<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 की कैश मेमोरी में मौजूद, पिछली (समयसीमा खत्म नहीं हुई) कीमतों को ओवरराइट कर दें. कॉन्टेंट बनाने मर्ज किए जा सकने वाले एट्रिब्यूट की मदद से, Google की कैश मेमोरी में अतिरिक्त कीमतें सेव की जा सकती हैं कीमत से जुड़ी पिछली जानकारी मिटाए बिना. इसके साथ लाइव मूल्य-निर्धारण क्वेरी कॉन्टेक्स्ट के हिसाब से दिए जाने वाले जवाबों में, इस एट्रिब्यूट को हमेशा true पर सेट किया जाएगा (आपके लेन-देन वाले मैसेज के जवाब पर ध्यान दिए बिना).

चाइल्ड एलीमेंट

<Result> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट ज़रूरी है? टाइप ब्यौरा
<AllowablePointsOfSale> Optional Object एक या एक से ज़्यादा ऐसे लैंडिंग पेज हैं जो होटल. लैंडिंग पेज एक ऐसी वेबसाइट है जो असली उपयोगकर्ता. किसी खास लैंडिंग पेज को साफ़ तौर पर शामिल करने और अन्य), एक या ज़्यादा <AllowablePointsOfSale> जोड़ें <PointOfSale> एलिमेंट से मेल खाने वाले एलिमेंट लैंडिंग पेजों की फ़ाइल में id एट्रिब्यूट की वैल्यू सबमिट करें.

अगर आप इस एलिमेंट को शामिल नहीं करते हैं, तो लैंडिंग पेज फ़ाइल का इस्तेमाल बुकिंग के लिए किया जा सकता है कमरा. ज़्यादा जानकारी के लिए, इसे देखें लैंडिंग पेजों वाली फ़ाइल सिंटैक्स.

<Baserate> Optional float

ठहरने के लिए कमरे का किराया. इस एलिमेंट की वैल्यू इसमें नीचे दी गई जानकारी शामिल होनी चाहिए:

  • निजी कमरे के लिए, दो लोगों के लिए सबसे सस्ता किराया सेट करें ऑफ़र कैसे करते हैं. अगर आपने ऐसा नहीं किया है, तो यहां ज़्यादा बुकिंग की अनुमति है दो लोगों के रहने की दर और आपके खाते में दो लोग नहीं हैं दरें चालू की गईं. दो लोग नहीं होने पर की गई बुकिंग के लिए किराये की सुविधा चालू करने के लिए, कृपया हमसे संपर्क करें. यहां एक व्यक्ति के लिए तय किए गए किराये की अनुमति नहीं है—वे <Rates> के तहत सेट होना चाहिए.
  • शेयर किए गए रूम के लिए, खाली छोड़ें और इसका इस्तेमाल करें <RoomBundle>.
  • यह वैल्यू सभी रातों के लिए कुल मूल कीमत होनी चाहिए, न कि एक रात का औसत किराया.

जब यात्रा की योजना के लिए कमरा उपलब्ध न हो, <Baserate> को या तो छोड़ा जाना चाहिए या इस पर सेट करना चाहिए -1 और <Unavailable> को ऐसा होना चाहिए इसके अलावा, इस प्रॉडक्ट के उपलब्ध न होने की सभी वजहों के बारे में भी बताया जाना चाहिए.

रूम बंडल हटाने के लिए, रूम बंडल हटाने में दिए गए निर्देशों का इस्तेमाल करें.

<Baserate> में अंकों का कोई ग्रुप नहीं होना चाहिए सिंबल, जैसे कि कॉमा (,) या पीरियड (.). हमेशा अलग करें दशमलव चिह्न के रूप में विराम चिह्न (.) का इस्तेमाल करने वाले भिन्न. उदाहरण के लिए, $1,200.40 को इस तरह दिखाते हैं:

<Baserate currency="USD">1200.40</Baserate>

<Baserate> एलिमेंट के लिए ये सुविधाएं मिलती हैं ऐसे एट्रिब्यूट जो ज़रूरी नहीं हैं:

  • all_inclusive: बूलियन, जिससे पता चलता है कि यह दर है या नहीं टैक्स और शुल्क शामिल हैं. आम तौर पर, इस वैल्यू को अमेरिका और कनाडा के असली उपयोगकर्ताओं के लिए false और सप्लाई वैल्यू <Tax> और <OtherFees> के लिए एलिमेंट. अगर आपने सभी सेवाओं के लिए एक ही कीमत ली है, तो हो सकता है कि आपको इसकी मंज़ूरी न मिले अगर आपकी कीमतों में टैक्स को अलग-अलग नहीं किया गया है, तो लिस्टिंग में आपका प्रॉडक्ट दिखेगा के लिए पेमेंट करना होगा.

    सभी शुल्क अब अमेरिका में रहने वाले लोगों को दिखेंगे.

    अन्य सभी असली उपयोगकर्ताओं के लिए, आपके खाते में आम तौर पर टैक्स और शुल्क शामिल होते हैं मूल दर में और all_inclusive की वैल्यू सेट करें एट्रिब्यूट की वैल्यू true को दें. ज़्यादा जानकारी के लिए, इसे देखें टैक्स और शुल्क की नीति.

    डिफ़ॉल्ट वैल्यू false है.

  • currency: तीन अक्षर वाला मुद्रा कोड. इसके लिए जैसे, डॉलर के लिए USD.
<ChargeCurrency> Optional enum उपयोगकर्ता बुकिंग के लिए कब और कहां पैसे चुकाता है. यह एलिमेंट ये काम कर सकता है: <Result> में लेन-देन मैसेज में इस्तेमाल किया जाएगा होटल की कीमत या <PackageData> ब्लॉक के लिए एलिमेंट एक अलग कमरे बुक करने के लिए.

मान्य मान हैं:

  • web: उपयोगकर्ता से इस समय ऑनलाइन शुल्क लिया जाता है बुकिंग. यह डिफ़ॉल्ट मान है. वास्तविक लैंडिंग पेज यह है द्वारा निर्धारित लैंडिंग पेज फ़ाइल और वे उपयोगकर्ता की मुद्रा से प्रभावित हो सकते हैं. आपके स्थान, भाषा, या अन्य कारक.
  • hotel: उपयोगकर्ता से होटल. अगर पेमेंट हमेशा होटल की मुद्रा में करना ज़रूरी है, तो सेट करें <ChargeCurrency> की वैल्यू को hotel. वास्तविक लैंडिंग पृष्ठ मुद्रा.
  • deposit: उपयोगकर्ता से कुछ हिस्से का शुल्क तुरंत ले लिया जाता है और बाकी बचा शुल्क बाद में लिया जाता है. आम तौर पर, जब उपयोगकर्ता होटल से चेक आउट करता है.
  • installments: उपयोगकर्ता से शुरुआती हिस्से के लिए शुल्क लिया जाता है की राशि का कुल बकाया राशि का प्रतिशत है और राशि नियमित रूप से निर्धारित एक तय समयावधि में.

डिफ़ॉल्ट वैल्यू web है.

<Checkin> Required Date तारीख का इस्तेमाल करके, यात्रा की योजना में चेक इन करने की तारीख फ़ॉर्मैट. <Nights> एलिमेंट और <Checkin> एलिमेंट, यात्रा की योजना बनाता है.
<Custom[1‑5]> Optional string कस्टम फ़ील्ड के बारे में बताता है. इसका इस्तेमाल करके, अतिरिक्त डेटा भेजा जा सकता है किसी होटल से जुड़ा हुआ है. आपके पास ज़्यादा से ज़्यादा पांच कस्टम वैल्यू पास करने का विकल्प होता है. ये एलिमेंट के नाम:
  • <Custom1>
  • <Custom2>
  • <Custom3>
  • <Custom4>
  • <Custom5>

<Custom> एलिमेंट की मदद से, आर्बिट्रेरी डेटा पास किया जा सकता है. उदाहरण के लिए, आप इस फ़ील्ड में एक मान तय कर सकते हैं, जो इसका इस्तेमाल लैंडिंग पेज फ़ाइल में किया जाता है, ताकि लैंडिंग पेज का कस्टम यूआरएल बनाया जा सके पेज. हर कस्टम फ़ील्ड में ज़्यादा से ज़्यादा 200 वर्ण हो सकते हैं. इसके लिए ज़्यादा जानकारी के लिए, लैंडिंग पेज की फ़ाइलें .

<कस्टम> <Rate> में दिए गए एलिमेंट एलिमेंट, <RoomBundle> एलिमेंट के लिए इनहेरिट नहीं किए जाते. आपको ऐसा करना चाहिए <कस्टम> को परिभाषित करें एट्रिब्यूट की अलग-अलग वैल्यू <RoomBundle> में जोड़ें.

<ExpirationTime> Optional DateTime वह तारीख और समय जब कीमत को खत्म माना जाता है (3 घंटे कम से कम).

हमारा सुझाव है कि अगर समयसीमा खत्म होने की तारीख है, तो उसे न दें आपके कीमतें तय करने के तरीके के लिए अहम नहीं है.

Google ऐसे किराये और यात्रा की योजना नहीं दिखाता जिनकी समयसीमा खत्म हो गई हो जिसकी समयसीमा खत्म हो चुकी है, वह इस ऑफ़र का फ़ायदा ले पाएगा मौजूदा कीमत के बारे में क्वेरी करना.

<Nights> Required integer किसी यात्रा की योजना के लिए रातों की संख्या. इस कीवर्ड का मान <Nights> एलिमेंट एक पॉज़िटिव पूर्णांक होना चाहिए. <Nights> और का कॉम्बिनेशन <Checkin> एक यात्रा योजना तैयार करता है.
<OtherFees> Optional float मूल दर और टैक्स के अलावा शुल्क, जो कमरे की कुल कीमत. <OtherFees> एलिमेंट currency के लिए एक ऐसा ज़रूरी एट्रिब्यूट है जो शुल्क के लिए तीन अक्षर वाला मुद्रा कोड. उदाहरण के लिए, USD.

<OtherFees> एलिमेंट की ज़रूरत होती है, अगर <Baserate>, शून्य से ज़्यादा है.

<Occupancy> Optional integer इससे पता चलता है कि इस किराये के लिए, ज़्यादा से ज़्यादा कितने लोगों की बुकिंग की जा सकती है. जब <Occupancy> सीधे <Result> के नीचे दिखता है, इसमें 2 या इससे ज़्यादा की जानकारी होनी चाहिए. <Occupancy> हो सकते हैं <OccupancyDetails> के साथ होना चाहिए, जो यह बताता है कि मेहमानों की संख्या (वयस्क या बच्चे). अगर मेहमान टाइप तय नहीं किया गया है, उन्हें वयस्क माना जाता है. इसके लिए, <OccupancyDetails> से सलाह लें चाइल्ड एलिमेंट का सिंटैक्स और जानकारी. अगर <Occupancy> एलिमेंट नहीं दिया गया है, व्यस्तता की दर डिफ़ॉल्ट तौर पर 2 पर सेट है.

ध्यान दें: इस सुविधा को चालू करने के लिए, अपनी सहायता टीम से संपर्क करें दो लोग नहीं होने पर की गई बुकिंग के लिए किराये की जानकारी भेज सकते हैं.

<PackageID> Optional string पहले से तय पैकेज डेटा के साथ मैप करने के लिए पैकेज का यूनीक आईडी. इसका इस्तेमाल PACKAGE-ID के लैंडिंग पेज वैरिएबल में जानकारी भरने के लिए भी किया जाता है. ज़्यादा जानकारी के लिए, इसे देखें रूम बंडल मेटाडेटा.
<Property> Required string ऐसे होटल का आईडी जिस पर संबंधित डेटा (कीमत, यात्रा की योजना, रूम बंडल या मेटाडेटा). इस एलिमेंट का मान यह होना चाहिए स्ट्रिंग. इस एलिमेंट की वैल्यू, स्टोर पेज पर मौजूद वैल्यू से मेल खानी चाहिए <id>, जिसे आपने अपने होटल सूची फ़ीड में तय किया है.
<Rates> Optional <Rates> एक या उससे ज़्यादा <Rate> ब्लॉक के लिए कंटेनर. हर <Rate> इंच <Rates> ने कमरे/यात्रा की योजना के लिए अलग कीमत तय की है संयोजन.

जब के लिए एक से ज़्यादा दरें हों, तो <Rates> एलिमेंट का इस्तेमाल करें वही कमरा/यात्रा की योजना का कॉम्बिनेशन या किराये की जानकारी उपलब्ध न हो <Result> लेवल पर तय किया जाना चाहिए. उदाहरण के लिए, आप एकाधिक की दरें खास किराया, निजी दरें, खास किराये शामिल हैं.

ध्यान दें: <Result> के अंदर, एक व्यक्ति के लिए किराये पर लिया जाने वाला किराया सिर्फ़ <Rates> में बताया जाना चाहिए. अनुमति देने के लिए, कृपया हमसे संपर्क करें दो लोग नहीं होने पर की गई बुकिंग के लिए किराये.

<Refundable> Optional Object इससे किराये की जानकारी को पूरा रिफ़ंड या मुफ़्त उपलब्ध कराने के तौर पर लिस्ट किया जाता है रद्द करने की प्रक्रिया. अगर यह जानकारी नहीं दी जाती है, तो रिफ़ंड के बारे में कोई जानकारी नहीं दिखाई जाएगी. <PackageData> के लेवल पर रिफ़ंड नीति, रिफ़ंड नीति की जगह लागू हो जाती है <Result> लेवल. <Rates> लेवल पर रिफ़ंड नीति में बदलाव रिफ़ंड नीति को <PackageData> के लेवल पर सबमिट करें. रिफ़ंड की जा सकने वाली कीमत उपयोगकर्ताओं के लिए, सीधे तौर पर नहीं दिए गए अन्य विकल्पों की मदद से भी उन्हें हाइलाइट किया जाएगा ट्रांज़ैक्शन मैसेज के स्कीमा में बदलाव किया जा रहा है. इसके बारे में ज़्यादा जानें किराये के रिफ़ंड के लिए बनी नीति.

यहां दिए गए उदाहरण में, <Refundable> को दिखाया गया है वह एलिमेंट जिसमें इसके सभी एट्रिब्यूट सेट हैं:

<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>

ध्यान दें: हमारा सुझाव है कि आप सभी एट्रिब्यूट को सेट करें. एक फ़ीड स्थिति के बारे में चेतावनी देने वाला मैसेज तब जनरेट होता है, जब एक या उससे ज़्यादा एट्रिब्यूट सेट नहीं है.

अगर आपने कोई एट्रिब्यूट सेट नहीं किया है, तो दर इस तरह नहीं दिखती है रिफ़ंड किया जा सकता है. एट्रिब्यूट:

  • available: (ज़रूरी है) 1 पर सेट करें (या true) से पता चलता है कि दर में पूरा रिफ़ंड; नहीं होना चाहिए, तो 0 (या false) पर सेट करें.
  • refundable_until_days: (अगर यह ज़रूरी है, तो available true है) खास जानकारी चेक-इन से इतने दिन पहले पूरा रिफ़ंड मिल सकता है अनुरोध किया गया है. refundable_until_days की वैल्यू यह 0 से 330 के बीच का कोई पूर्णांक होना चाहिए.
  • refundable_until_time: (अगर इसका सुझाव दिया जाता है, तो available true है) खास जानकारी होटल के स्थानीय समय में दिन के सबसे हाल के समय में, रिफ़ंड के अनुरोध पर ध्यान दिया जाएगा. इसे एक साथ जोड़ा जा सकता है इसकी जानकारी देने के लिए refundable_until_days उदाहरण के लिए, "रिफ़ंड की सुविधा दो दिन पहले शाम 4 बजे तक उपलब्ध है चेक-इन". अगर refundable_until_time सेट नहीं है, तो डिफ़ॉल्ट रूप से आधी रात पर सेट होती है.

    इस एट्रिब्यूट की वैल्यू, Time फ़ॉर्मैट का इस्तेमाल करती है.

एट्रिब्यूट सेट करते समय, इन बातों का ध्यान रखें:

  • अगर available या refundable_until_days नहीं है सेट है, तो दर रिफ़ंड के रूप में नहीं दिखती है.
  • अगर available, 0 (या false) है, इसके अलावा, अन्य एट्रिब्यूट पर ध्यान नहीं दिया जाता. दर इस तरह नहीं दिख रही है यह रिफ़ंड तब भी दिया जा सकता है, जब एक या दोनों अन्य एट्रिब्यूट सेट हों.
<RoomBundle> Optional <RoomBundle> एक कंटेनर, जिसमें कमरे की कीमत के बारे में जानकारी होती है, सभी सुविधाओं की पैकेजिंग और खरीदारी की नीति के बारे में जानकारी होटल और यात्रा की योजना.

आम तौर पर, इस एलिमेंट का इस्तेमाल करके बेस रूम का किराया तय करें और एक ही प्रॉपर्टी में अलग-अलग तरह के कमरे. हालांकि, यह मुमकिन है अगर कमरे के बंडल की जानकारी को इनलाइन तरीके से परिभाषित करना है, तो लेन-देन से जुड़ा मैसेज लिखें. Google सेव करेगा मेटाडेटा को दोहराने के बजाय इसका संदर्भ दें आने वाले समय में कीमत से जुड़े अपडेट.

<RoomID> Optional string रूम का यूनीक आईडी, ताकि उसे पहले से तय किए गए रूम के डेटा से मैप किया जा सके. साथ ही इसका इस्तेमाल PARTNER-ROOM-ID के लैंडिंग पेज वैरिएबल को भरने के लिए किया जाता है. ज़्यादा जानकारी के लिए, इसे देखें रूम बंडल मेटाडेटा.
<Tax> Optional float इनमें कमरे की कुल कीमत के हिसाब से टैक्स दिए जाते हैं. <Tax> एलिमेंट में एक ज़रूरी एट्रिब्यूट होता है, currency, जो तीन अक्षरों वाले मुद्रा कोड की जानकारी देता है टैक्स के लिए. उदाहरण के लिए, USD. कॉन्टेंट बनाने <Tax> एलिमेंट ज़रूरी है, अगर <Baserate>, शून्य से ज़्यादा है.

अगर <Baserate> एलिमेंट "सभी के लिए" विशेषता को 'सही' पर सेट करें, फिर इसे सेट करें मान वैकल्पिक है.

<Unavailable> Optional Object इससे पता चलता है कि यात्रा की योजना, बुकिंग के लिए उपलब्ध नहीं है. के तौर पर काम करता है . एक अनुपलब्धता के अन्य कारणों को <Unavailable> टैग:
  • <NoVacancy/>: बिक्री के लिए और कमरा उपलब्ध नहीं है ठहरने की एक या ज़्यादा रातों के लिए.
  • <MinNightStay value=N/>: यात्रा की योजना की कीमत इससे कम थी इन तारीखों के लिए, कम से कम एक रात ठहरने का N.
  • <MaxNightStay value=N/>: यात्रा की योजना ठहरने की तारीखों के लिए, ज़्यादा से ज़्यादा N रात ठहरने का विकल्प.
  • <MinAdvancePurchase value=N/>: यात्रा की योजना यह थी होटल में ठहरने के लिए, एडवांस बुकिंग की तय अवधि N से कम है तारीखें.
  • <MaxAdvancePurchase value=N/>: यात्रा की योजना यह थी होटल में ठहरने के लिए, एडवांस बुकिंग की तय अवधि N से ज़्यादा है तारीखें.
  • <ClosedToArrival/>: प्रॉपर्टी अनुमति नहीं देती है यात्रा की योजना वाले पहुंचने की तारीख पर चेक-इन करें.
  • <ClosedToDeparture/>: प्रॉपर्टी अनुमति नहीं देती है यात्रा की योजना के रवाना होने की तारीख पर चेक-आउट करें.
  • <PropertyClosed first_open="YYYY-MM-DD" first_closed="YYYY-MM-DD"/>: प्रॉपर्टी कुछ लोगों के लिए बंद हो गई है या ठहरने का समय तय कर दिया है. सुझाए गए एट्रिब्यूट first_open और first_closed इससे ज़्यादा या इसके बराबर पहली तारीखें तय करते हैं आने की तारीख, प्रॉपर्टी के खुलने या बंद होने की तारीख. आने की तारीख के बाद बंद होने वाली प्रॉपर्टी के लिए, first_open यह फ़्लाइट पहुंचने की तारीख के बराबर होनी चाहिए और first_closed को प्रॉपर्टी के बंद होने की तारीख होनी चाहिए. ऐसी प्रॉपर्टी के लिए जो कि आने की तारीख, first_closed पहुंचने की तारीख के बराबर होने चाहिए तारीख हो और first_opened अगले तारीख की होनी चाहिए जिस दिन प्रॉपर्टी खुली है.
  • <NotFetched/>: यात्रा की योजना का किराया यह नहीं था डाउनस्ट्रीम डेटा सोर्स से मिला.
  • <InvalidProperty/>: अनुरोध किया गया प्रॉपर्टी आइडेंटिफ़ायर की पहचान नहीं की गई थी.
  • <InvalidOccupancy/>: अनुरोध किया गया ऑक्युपेंसी नहीं है प्रॉपर्टी द्वारा समर्थित नहीं.
  • <PriceIssue/>: किराये से जुड़ी किसी समस्या की वजह से नहीं भेजा जाएगा.
  • <InternalError reason=""/>: कुछ बिना गिनती वाली गड़बड़ी हुआ. वजह एट्रिब्यूट की मदद से, गड़बड़ी को टेक्स्ट के तौर पर रिपोर्ट किया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है.
  • <OtherRestriction restriction=""/>: यात्रा की योजना यह थी यह सुविधा, बुकिंग पर लगी कुछ पाबंदियों की वजह से उपलब्ध नहीं है. ज़रूरी नहीं है पाबंदी एट्रिब्यूट का इस्तेमाल करके, पाबंदी को टेक्स्ट के तौर पर रिपोर्ट किया जा सकता है.

उदाहरण

एक से ज़्यादा प्रॉपर्टी का उदाहरण

नीचे दिए गए उदाहरण में, एक यात्रा की योजना और दो फ़्लाइट की कीमत के बारे में बताया गया है प्रॉपर्टी:

<?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> एलिमेंट का इस्तेमाल इन कामों के लिए किया जा सकता है किसी खास प्रॉपर्टी के लिए अलग-अलग किराया दिखाने की सुविधा देता है. यह उदाहरण है छुट्टियों में किराये पर लेने की सुविधा (वीआर) प्रॉपर्टी के लिए भी मददगार:

<?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> एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है लेन-देन के मैसेज की एक्सएमएल हैरारकी:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>         // Pricing and availability
        + <Rates>
        + <RoomBundle> (Can also contain <Rates>)
        + ...

<Rate> में सेट की गई वैल्यू, पैरंट <Result> या <RoomBundle> एलिमेंट. अगर इन्हें <Rate> में सेट नहीं किया गया है, उनकी वैल्यू, पैरंट एलिमेंट से इनहेरिट की जाती है. सिर्फ़ &lt;AllowablePointsofSale&gt; <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 एक या एक से ज़्यादा ऐसे लैंडिंग पेज हैं जो होटल. यह एलिमेंट, <Result> पर <AllowablePointsOfSale>.
<Baserate> Required float ठहरने के लिए कमरे का किराया. यह एलिमेंट उसी यूआरएल का इस्तेमाल करता है <Result> पर <Baserate> के रूप में सिंटैक्स.

ध्यान दें: नीचे दिया गया <Baserate> चाइल्ड एलिमेंट <Rate> को 'उपलब्ध नहीं है' के तौर पर नहीं बताया जा सकता.

<ChargeCurrency> Optional enum उपयोगकर्ता बुकिंग के लिए कब और कहां पैसे चुकाता है. यह एलिमेंट <ChargeCurrency> जैसा सिंटैक्स <Result>.
<Custom[1‑5]> Optional string ऐसे कस्टम फ़ील्ड जिनका इस्तेमाल करके, उपयोगकर्ता से जुड़ा अतिरिक्त डेटा भेजा जा सकता है होटल को लैंडिंग पेज पर ले जाता है. यह एलिमेंट, <Result> में <Custom[1‑5]>. इसकी सीमा तय है हर कस्टम फ़ील्ड में ज़्यादा से ज़्यादा 200 वर्ण. ज़्यादा जानकारी के लिए, इसे देखें लैंडिंग पेज फ़ाइलें शामिल होती हैं.

अगर <कस्टम> इन एलिमेंट में <Result> एलिमेंट का इस्तेमाल किया जाता है, तो वे <RoomBundle> एलिमेंट के साथ-साथ, हर एलिमेंट के लिए अलग से बताया जाना चाहिए <RoomBundle> या इसे <packageData> में शामिल किया जा सकता है अगर की ज़रूरत नहीं है.

<ExpirationTime> Optional DateTime वह तारीख और समय जब किराये की अवधि को खत्म माना जाता है. यह तत्व उसी सिंटैक्स का उपयोग करता है, <Result> में <ExpirationTime>.
<Occupancy> Optional integer

इससे पता चलता है कि इस किराये के लिए, ज़्यादा से ज़्यादा कितने लोगों की बुकिंग की जा सकती है. अगर नहीं माना जाता है कि यह मूल दर ही है. <Occupancy> के साथ शायद <OccupancyDetails>, जिसमें यह बताया जाता है कि मेहमान किस तरह के हैं (वयस्क या बच्चे). इसके सिंटैक्स और ब्यौरे के लिए, <OccupancyDetails> से संपर्क करें चाइल्ड एलिमेंट.

<OtherFees> Required float मूल दर और टैक्स के अलावा वे शुल्क जो आखिरी कीमत पर असर डालते हैं एक कमरे में रखा. यह एलिमेंट, उसी सिंटैक्स का इस्तेमाल करता है जो <Result> में <OtherFees>.

अगर <Baserate> एलिमेंट "सभी के लिए" विशेषता को 'सही' पर सेट करें, फिर इसे सेट करें मान वैकल्पिक है.

<Refundable> Optional Object इससे किराये की जानकारी को पूरा रिफ़ंड या मुफ़्त उपलब्ध कराने के तौर पर लिस्ट किया जाता है रद्द करने की प्रक्रिया. अगर यह जानकारी नहीं दी जाती है, तो रिफ़ंड के बारे में कोई जानकारी नहीं दिखाई जाएगी. <PackageData> लेवल पर रिफ़ंड नीति, रिफ़ंड नीति को बदल देती है <Result> लेवल पर. <Rates> लेवल पर रिफ़ंड नीति में बदलाव रिफ़ंड नीति को <PackageData> के लेवल पर सबमिट करें. रिफ़ंड की जा सकने वाली कीमत उपयोगकर्ताओं के लिए, सीधे तौर पर नहीं दिए गए अन्य विकल्पों की मदद से भी उन्हें हाइलाइट किया जाएगा ट्रांज़ैक्शन मैसेज के स्कीमा में बदलाव किया जा रहा है. इन विकल्पों के बारे में ज़्यादा जानें किराये के रिफ़ंड के लिए बनी नीति.

यहां दिए गए उदाहरण में, <Refundable> को दिखाया गया है वह एलिमेंट जिसमें इसके सभी एट्रिब्यूट सेट हैं:

<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>

ध्यान दें: हमारा सुझाव है कि आप सभी एट्रिब्यूट को सेट करें. एक फ़ीड स्थिति के बारे में चेतावनी देने वाला मैसेज तब जनरेट होता है, जब एक या उससे ज़्यादा एट्रिब्यूट सेट नहीं है.

अगर आपने कोई एट्रिब्यूट सेट नहीं किया है, तो दर इस तरह नहीं दिखती है रिफ़ंड किया जा सकता है. एट्रिब्यूट:

  • available: (ज़रूरी है) 1 पर सेट करें (या true) से पता चलता है कि दर में पूरा रिफ़ंड; नहीं होना चाहिए, तो 0 (या false) पर सेट करें.
  • refundable_until_days: (अगर यह ज़रूरी है, तो available true है) खास जानकारी चेक-इन से इतने दिन पहले पूरा रिफ़ंड मिल सकता है अनुरोध किया गया है. refundable_until_days की वैल्यू यह 0 से 330 के बीच का कोई पूर्णांक होना चाहिए.
  • refundable_until_time: (अगर इसका सुझाव दिया जाता है, तो available true है) खास जानकारी होटल के स्थानीय समय में दिन के सबसे हाल के समय में, रिफ़ंड के अनुरोध पर ध्यान दिया जाएगा. इसे एक साथ जोड़ा जा सकता है इसकी जानकारी देने के लिए refundable_until_days उदाहरण के लिए, "रिफ़ंड की सुविधा दो दिन पहले शाम 4 बजे तक उपलब्ध है चेक-इन". अगर refundable_until_time सेट नहीं है, तो डिफ़ॉल्ट रूप से आधी रात पर सेट होती है.

    इस एट्रिब्यूट की वैल्यू, Time फ़ॉर्मैट का इस्तेमाल करती है.

एट्रिब्यूट सेट करते समय, इन बातों का ध्यान रखें:

  • अगर available या refundable_until_days नहीं है सेट है, तो दर रिफ़ंड के रूप में नहीं दिखती है.
  • अगर available, 0 (या false) है, इसके अलावा, अन्य एट्रिब्यूट पर ध्यान नहीं दिया जाता. दर इस तरह नहीं दिख रही है यह रिफ़ंड तब भी दिया जा सकता है, जब एक या दोनों अन्य एट्रिब्यूट सेट हों.
<Tax> Required float इनमें कमरे की कुल कीमत के हिसाब से टैक्स दिए जाते हैं. यह एलिमेंट एक ही सिंटैक्स का इस्तेमाल करता है, जैसा कि <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> एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है लेन-देन के मैसेज की एक्सएमएल हैरारकी:

+ <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 इससे, ठहरने के लिए कमरे के बंडल का किराया तय होता है. यह एलिमेंट, वही सिंटैक्स जो <Result> में <Baserate> में है, जिसमें अपवाद:
  • जब यात्रा की योजना के लिए कमरा उपलब्ध न हो, तो इसे हटा दें <RoomBundle> एलिमेंट बताता है कि कमरा नहीं है काफ़ी ज़्यादा समय लगता है. ज़्यादा जानकारी के लिए, इसे देखें कमरे के बंडल को हटाना.
<BreakfastIncluded> Optional boolean इससे पता चलता है कि इस रूम बंडल में, किराये पर मिलने वाला नाश्ता शामिल है या नहीं.
<ChargeCurrency> Optional enum उपयोगकर्ता बुकिंग के लिए कब और कहां पैसे चुकाता है. यह एलिमेंट उसी यूआरएल का इस्तेमाल करता है <Result> में <ChargeCurrency> के रूप में सिंटैक्स.

डिफ़ॉल्ट वैल्यू web है.

<Custom[1‑5]> Optional string लैंडिंग पेजों को अतिरिक्त डेटा भेजने के लिए कस्टम फ़ील्ड कमरे के बंडल के लिए. ये एलिमेंट, एक ही सिंटैक्स का इस्तेमाल करते हैं <Result> में <Custom[1-5]>. इसकी सीमा 200 है वर्ण प्रति कस्टम फ़ील्ड. ज़्यादा जानकारी के लिए, इसे देखें लैंडिंग पेज फ़ाइलों में भी ये फ़ाइलें शामिल होती हैं.

अगर <कस्टम> इन एलिमेंट में <Result> एलिमेंट का इस्तेमाल किया जाता है, तो वे <RoomBundle> एलिमेंट के साथ-साथ, हर एलिमेंट के लिए अलग से बताया जाना चाहिए <RoomBundle> या इसे <packageData> में शामिल किया जा सकता है अगर की ज़रूरत नहीं है.

<InternetIncluded> Optional boolean अगर किसी रूम बंडल में बिना किसी शुल्क के इंटरनेट की सुविधा शामिल है, जबकि अन्य बंडल में यह सुविधा उपलब्ध नहीं होगी. इसे सेट न करें होटल के उस होटल के रूम बंडल में इस्तेमाल होने वाले एलिमेंट जो मुफ़्त इंटरनेट की सुविधा देते हैं कमरे. यह एलिमेंट, कमरे में वायर वाले इंटरनेट या वायरलेस इंटरनेट कनेक्शन पर लागू नहीं होता जो कमरों में उपलब्ध नहीं है.
<Occupancy> Required integer इससे पता चलता है कि इस किराये के लिए, ज़्यादा से ज़्यादा कितने लोगों की बुकिंग की जा सकती है. उदाहरण के लिए, बड़े सुइट में छह मेहमानों के बैठने की सुविधा हो सकती है. हालांकि, "हनीमून पैकेज" सिर्फ़ दो मेहमानों के इस्तेमाल की अनुमति है.

यह मान इससे कम या इसके बराबर होना चाहिए: <Capacity>, इसका मतलब है कि कमरे में ठहरने की सुविधा भी उपलब्ध है.

अपने लैंडिंग पेज यूआरएल में व्यस्तता की जानकारी देते समय, NUM-ADULTS और NUM-CHILDREN वैरिएबल, जैसे में बताया गया है इस्तेमाल करना वैरिएबल और शर्तें. डिफ़ॉल्ट वैल्यू 2 है वयस्क और 0 बच्चे.

<Occupancy> की वैल्यू पॉज़िटिव होनी चाहिए 1 से 99 के बीच का पूर्णांक.

ध्यान दें:

  • <RoomBundle> के लिए <Occupancy> का सुझाव दिया जाता है, इसलिए इसे ज़रूरत के हिसाब से फ़्लैग किया जाता है. अगर इसे छोड़ा जाता है, तो 1097 की गड़बड़ी दिखाना.
  • <Occupancy>, इसमें मौजूद डेटा ऑब्जेक्ट से मिलता है ऑर्डर: <RoomBundle>, <PackageData>, और फिर = <RoomData>. अगर इनमें से किसी में भी कोई वैल्यू मौजूद नहीं है, तो डिफ़ॉल्ट तौर पर वैल्यू 2 हो जाती है.
  • <Occupancy> के साथ शायद <OccupancyDetails>, जो मेहमानों (वयस्क या बच्चे) के प्रकार के बारे में बताता है. अगर मेहमान टाइप की जानकारी नहीं दी जाती है, तो उन्हें वयस्क माना जाता है. सलाह लें चाइल्ड एलिमेंट के सिंटैक्स और ब्यौरे के लिए <OccupancyDetails>.
  • जब आपने <Occupancy> को दोनों में सेट किया <RoomBundle> और <PackageData>, <RoomBundle> में मौजूद वैल्यू को प्राथमिकता मिलती है.
<OtherFees> Required float मूल दर और टैक्स के अलावा शुल्क, जो कमरे की कुल कीमत. <OtherFees> एलिमेंट currency के लिए एक ऐसा ज़रूरी एट्रिब्यूट है जो शुल्क के लिए तीन अक्षर वाला मुद्रा कोड. उदाहरण के लिए, डॉलर में USD चुकाएं.
<PackageID> Optional (recommended) string पैकेज डेटा के लिए यूनीक आईडी. इस आईडी का इस्तेमाल <PackageData> में भेजी गई जानकारी के साथ कमरे का बंडल डेटा. इसके लिए ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा. (आप इस आईडी का इस्तेमाल, इस्तेमाल किए गए रूम बंडल की परिभाषा का रेफ़रंस देने के लिए भी किया जा सकता है रूम बंडल डेटा तय करते समय एक ही लेन-देन मैसेज में inline.)
<ParkingIncluded> Optional boolean रूम बंडल में बिना किसी शुल्क के पार्किंग शामिल है या नहीं, अगर ऐसा नहीं है, तो इस होटल में पार्किंग की सुविधा के लिए पैसे चुकाने होंगे. जानकारी न दें मुफ़्त पार्किंग की सुविधा देने वाले होटल के लिए इस एलिमेंट का मान.

मान्य वैल्यू 0 (या false) हैं और 1 (या true). डिफ़ॉल्ट मान यह है false.

<RatePlanID> Optional string किराये के प्लान का आईडी, कमरा और पैकेज का कॉम्बिनेशन. उदाहरण के लिए, दिए गए 5 और एक का <RoomID> मान ABC का <PackageID> मान, आप <RatePlanID> के लिए 5-ABC. हमारा सुझाव है कि आप अपना डाइनैमिक लैंडिंग पेज बनाने के लिए, RatePlanID का वैरिएबल के रूप में रेट (पहले पॉइंट ऑफ़ सेल था) यूआरएल.

ज़्यादा जानकारी के लिए, इसे देखें वैरिएबल का इस्तेमाल करना और शर्तें.

<Rates> Optional <Rates> किराये जो इस रूम बंडल के लिए डिफ़ॉल्ट सेटिंग को बदल देते हैं. यह एलिमेंट, <Result> में <Rates> के समान सिंटैक्स का इस्तेमाल करता है.
<Refundable> Optional Object इससे किराये की जानकारी को पूरा रिफ़ंड या मुफ़्त उपलब्ध कराने के तौर पर लिस्ट किया जाता है रद्द करने की प्रक्रिया. अगर यह जानकारी नहीं दी जाती है, तो रिफ़ंड के बारे में कोई जानकारी नहीं दिखाई जाएगी. <PackageData> के लेवल पर रिफ़ंड नीति, रिफ़ंड नीति की जगह लागू हो जाती है <Result> लेवल. <Rates> लेवल पर रिफ़ंड नीति में बदलाव रिफ़ंड नीति को <PackageData> के लेवल पर सबमिट करें. रिफ़ंड की जा सकने वाली कीमत उपयोगकर्ताओं के लिए, सीधे तौर पर नहीं दिए गए अन्य विकल्पों की मदद से भी उन्हें हाइलाइट किया जाएगा ट्रांज़ैक्शन मैसेज के स्कीमा में बदलाव किया जा रहा है. इन विकल्पों के बारे में ज़्यादा जानें किराये के रिफ़ंड के लिए बनी नीति.

यहां दिए गए उदाहरण में, <Refundable> को दिखाया गया है वह एलिमेंट जिसमें इसके सभी एट्रिब्यूट सेट हैं:

<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>

ध्यान दें: हमारा सुझाव है कि आप सभी एट्रिब्यूट को सेट करें. एक फ़ीड स्थिति के बारे में चेतावनी देने वाला मैसेज तब जनरेट होता है, जब एक या उससे ज़्यादा एट्रिब्यूट सेट नहीं है.

अगर आपने कोई एट्रिब्यूट सेट नहीं किया है, तो दर इस तरह नहीं दिखती है रिफ़ंड किया जा सकता है. एट्रिब्यूट:

  • available: (ज़रूरी है) 1 पर सेट करें (या true) से पता चलता है कि दर में पूरा रिफ़ंड; नहीं होना चाहिए, तो 0 (या false) पर सेट करें.
  • refundable_until_days: (अगर यह ज़रूरी है, तो available true है) खास जानकारी चेक-इन से इतने दिन पहले पूरा रिफ़ंड मिल सकता है अनुरोध किया गया है. refundable_until_days की वैल्यू यह 0 से 330 के बीच का कोई पूर्णांक होना चाहिए.
  • refundable_until_time: (अगर इसका सुझाव दिया जाता है, तो available true है) खास जानकारी होटल के स्थानीय समय में दिन के सबसे हाल के समय में, रिफ़ंड के अनुरोध पर ध्यान दिया जाएगा. इसे एक साथ जोड़ा जा सकता है इसकी जानकारी देने के लिए refundable_until_days उदाहरण के लिए, "रिफ़ंड की सुविधा दो दिन पहले शाम 4 बजे तक उपलब्ध है चेक-इन". अगर refundable_until_time सेट नहीं है, तो डिफ़ॉल्ट रूप से आधी रात पर सेट होती है.

    इस एट्रिब्यूट की वैल्यू, Time फ़ॉर्मैट का इस्तेमाल करती है.

एट्रिब्यूट सेट करते समय, इन बातों का ध्यान रखें:

  • अगर available या refundable_until_days सेट नहीं है, तो दर को रिफ़ंड नहीं माना जा सकता.
  • अगर available, 0 (या false) है, इसके अलावा, अन्य एट्रिब्यूट पर ध्यान नहीं दिया जाता. दर इस तरह नहीं दिख रही है यह रिफ़ंड तब भी दिया जा सकता है, जब एक या दोनों अन्य एट्रिब्यूट सेट हों.
<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 बच्चा. यहां, <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>

रूम बंडल

नीचे दिए गए उदाहरण में, दो वयस्कों और एक बच्चे के लिए बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या के बारे में बताया गया है दो रातों के लिए कमरा बुक करें. इसके लिए, कमरे का किराया रिफ़ंड किया जा सकता है. यहां, <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> के ऐसे कई किराये के बारे में बताया गया है जिन्हें दो वयस्कों और दो बच्चों के लिए, बुकिंग करने पर पाबंदी है. यहां, <OccupancyDetails>, <RoomBundle> के <Rates> एलिमेंट में दिखता है.

<?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>