Fiyatlandırma ve Oda Envanteri (Transaction mesajları) XML Referansı

Bu sayfa XML tabanlı Transaction mesajları için referans sağlamaktadır.

<Transaction>

Transaction mesajının kök öğesi şu anda <Transaction>. Bu sayfa, hakkında açıklayıcı bilgiler içeren bir kapsayıcıdır: oda ve paketler ile odalar ve paketler için fiyatlandırma ve müsaitlik durumu bilgilerini sağlar.

<Transaction> öğesi İşlem mesajı XML hiyerarşisi:

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

Kök öğe olarak <Transaction> kullanan mesajlar en az bir tane gerektirir alt öğedir. İşlem mesajlarının (toplam ileti boyutu 100 MB'ı aşmadığı sürece)

Söz dizimi

<Transaction> öğesi şu söz dizimini kullanır:

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

Özellikler

<Transaction> öğesi aşağıdaki özelliklere sahiptir:

Özellik Zorunlu mu? Tür Açıklama
id Required dize Her Transaction mesajının benzersiz tanımlayıcısı.
partner Optional string Transaction mesajının ait olduğu iş ortağı hesabıdır. Siz arka ucunuz birden fazla cihaz için fiyat feed'i sağlıyorsa iş ortağı hesapları. Bu dize değeri "İş ortağı anahtarı"dır. değeri şurada listelenir: Hotel Center'daki hesap ayarları sayfası.
timestamp Required DateTime

Transaction mesajının gönderilir.

Önceki 24 saat içinde zaman damgasıyla gönderilen tüm iletiler işlenmemiş olanlar ise silinecek.

Mesajlar timestamp sırasına göre işlenir, işleme alınma sırasına göre işlenmez sırasını ifade eder. Örneğin, 2019-05-03 14:09:00 öğesinin zaman damgası 2019-05-03 14:10:00 olan mesaj sırasıyla işlenmeye devam eder ve 2019-05-03 14:10:00 zaman damgası kullanılacak.

Alt öğeler

<Transaction> öğesi aşağıdaki alt öğelere sahiptir:

Alt Öğe Zorunlu mu? Tür Açıklama
<PropertyDataSet> Optional* <PropertyDataSet>

Belirli bir oda ve Oda Paketlerini açıklar. Genellikle bunu öğesini ayrı bir Transaction mesajında ekleyebilirsiniz. Oda Paketleri'ni tıklayın ve Transaction mesajlarınızın boyutunu küçültün.
<Result> Optional* <Result>

Bir odanın seyahat planı veya Oda Paketlerini tanımlayan <RoomBundle> öğesi ve ek oda türü olabilir. İlgili içeriği oluşturmak için kullanılan Kaldırmak için <Result> öğesi de kullanılabilir seyahat planlarını kullanabilirsiniz.
* En az bir <PropertyDataSet> veya <Result> gereklidir.

Örnekler

Oda verileri

Aşağıdaki örnek, bir Transaction mesajında oda verilerini tanımlar:

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

Fiyatlandırma verileri

Aşağıdaki örnek, bir Transaction mesajında fiyatlandırma verilerini tanımlar:

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

Gecelik ücretler

Aşağıdaki örnekte, şu tarihten itibaren 1 ila 7 gece için fiyatlandırma verileri tanımlanmaktadır: 7 Haziran 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>


Taban ve koşullu fiyatlar

Aşağıdaki örnekte, koşullu fiyat sunuyor:

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

Envanteri kaldır

Aşağıdaki örnekte çeşitli envanterler (1 gecelik konaklamalar için 1 gecelik konaklamalar) birkaç farklı tarih) ayırma:

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

Oda ve paket (veya Oda Paketi) bilgilerinin bir kapsayıcısındaki <Transaction> mesajı. Otel üzerinde ayarlanan değerler, iş ortağı üzerinde ayarlanan değerleri geçersiz kılar. Google bu bilgileri, her seferinde tanımlamanıza gerek kalmaması için saklar fiyatlandırma güncellemeleri göndermeniz gerekiyor.

<PropertyDataSet> öğesi İşlem mesajı XML hiyerarşisi:

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

Daha fazla bilgi için Oda Paketi meta verileri konusuna bakın.

Söz dizimi

<PropertyDataSet> öğesi şu söz dizimini kullanır:

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

Özellikler

<PropertyDataSet> öğesinin özelliği yok.

Alt öğeler

<PropertyDataSet> öğesi aşağıdaki alt öğelere sahiptir:

Alt Öğe Zorunlu mu? Tür Açıklama
<PackageData> Optional* <PackageData> Bir Oda Paketini tanımlar. Bu veriler bir iş ortağıyla ilişkilendirilir ve ancak seyahat planıyla değil. Bu öğe şuna benzer: <RoomData> ancak dahil olmayan imkanlar ve şartlar bir boşluk karakteridir.

Fiyatlandırma güncellemelerinizde paket kimliğini referans gösterirsiniz.

Daha fazla bilgi için: Oda Paketi meta verileri.
<Property> Required string İlişkili verilerin geçerli olduğu otelin kimliğidir. İlgili içeriği oluşturmak için kullanılan bu öğenin değeri girişle eşleşen bir dize olmalıdır Otel Listesi Feed'inizde <id>.
<RoomData> Optional* <RoomData> Bir odayı tanımlar. Bu veriler bir iş ortağı ve otelle ilişkilendirilir. ancak seyahat planıyla değil.

Fiyatlandırma güncellemelerinizde oda kimliğini referans gösterirsiniz.
* En az bir <PackageData> veya <RoomData> gereklidir.

Örnekler

Oda ve paket verileri

Aşağıdaki örnekte hem oda hem de paket verileri gösterilmektedir <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>

Bu oda ve Oda Paketi için fiyatları ve müsaitlik durumunu gönderdiğinizde fiyatlandırma mesajlarınızda oda ve paket kimliklerine referans verin. Sonuç hem de iletilerinizin boyutunu önemli ölçüde küçültüp ve yinelenen veriler nedeniyle karşılaşabileceğiniz hata miktarını belirtmelidir. Daha fazla Oda Paketi meta verileri konusuna bakın.

<RoomData>

Odalar ve buna bağlı olarak Oda hakkındaki seyahat planından bağımsız meta verileri tanımlar. Paketler (Oda Paketleri odalar ve ek imkanlardır). Tekliflerinizi otomatikleştirmek ve optimize etmek için Fiyatınızdaki açıklayıcı verilerin tekrarını azaltmak için <RoomData> Kartlar.

<RoomData> öğesi İşlem mesajı XML hiyerarşisi:

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

<RoomData> öğeleri, iş ortağı ve otel arasında yer alıyor. Amaç, herkesin seyahat planı dışındaki veriler.

<RoomData> öğesi, <PackageData> öğesine benzer ancak şuna benzer: paketteki imkanlar ve şartlardan ziyade fiziki odadır. Kullandığınız Aşağıdakilerle ilgili ayrıntılı bilgi sağlamak için birlikte <RoomData> ve <PackageData> Oda Paketleri. Paketin parçası olmayan ayrı odalar için yalnızca <RoomData>

Şu öğe için hem <RoomData> hem de <PackageData> öğelerini tanımlayabilirsiniz: aynı oda veya Oda Paketi. Google bu odayı veya paketi arama sonuçlarında ise her ikisinden de, bir kısa çizgi.

Daha fazla bilgi için Oda Paketi meta verileri konusuna bakın.

Söz dizimi

<RoomData> öğesi şu söz dizimini kullanır:

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

Özellikler

<RoomData> öğesinin özelliği yok.

Alt öğeler

<RoomData> öğesi aşağıdaki alt öğelere sahiptir:

Alt Öğe Zorunlu mu? Tür Açıklama
<Capacity> Optional integer Bir odanın fiziksel olarak katabileceği maksimum konuk sayısı uyum sağlamasıdır. Bir oda için kapasite şundan büyük veya şuna eşittir: doluluk oranı.

Bu değer belirtildiğinde değere eşit veya değerden büyük olmalıdır <Occupancy> öğesinin amaçlanan yardımcı olan bir metriktir. Örneğin, büyük bir süitin <Capacity> 6 olabilir, ancak <Occupancy> 4'tür.

<Capacity> değeri, pozitif bir tam sayı olmalıdır 1 ile 20 arasında olmalıdır.
<Description> Optional Object Odanın ayrıntılı açıklamasıdır. Bu öğe, başka unsurlar tarafından açıklanmayan bilgileri veya <Name> öğesi. Metnin tamamında büyük harf kullanmamalısınız. harf kullanmalarını öneririz.

<Description> öğesi tek bir alt öğe alır öğesi, <Text> ve şu iki öğeyi içerir: gerekli özellikler:

  • text: Odanın ayrıntılı açıklamasıdır.
  • language: İki harfli dil kodudur; örneğin, fr.

Her dil için ayrı bir <Text> öğesi kullanın reklamınızın veya ücretsiz rezervasyon bağlantınızın (her öğe için farklı değerlerle language özellikleri).

Aşağıdaki örnekte odanın Fransızca ve İngilizce sürümleri gösterilmektedir açıklama:

<Description>
  <Text text="Two queen-sized beds" language="en"/>
  <Text text="Deux lits de la reine" language="fr"/>
</Description>
<Name> Required string Oda kategorisinin adı. Bu değer, Otelin açılış sayfasında (eski adıyla satış noktası) görünür. Ayarlama bu öğenin değerinin tamamı büyük harfle yazılmalıdır.

Bu öğede tek bir alt öğe (<Text>) yer alır. sahip olmalıdır:

  • text: Odanın adı.
  • language: İki harfli dil kodudur; örneğin, fr.

Her dil için ayrı bir <Text> öğesi kullanın reklamınızın veya ücretsiz rezervasyon bağlantınızın (farklı language özellikleri için değerleri) kullanın.

Aşağıdaki örnekte odanın Fransızca ve İngilizce sürümleri gösterilmektedir ad:

<Name>
  <Text text="Standard Double Room" language="en"/>
  <Text text="Le chambre double" language="fr"/>
</Name>
<Occupancy> Optional integer Bir odanın amaçlanan maksimum konuk sayısıdır. Örneğin, büyük bir süit fiziksel olarak 6 kişiyi ağırlayabilir. konuklar (kapasite = 6) ancak yalnızca 4 konuk kapasitelidir.

Bu değer, <Capacity> öğesi (kişi sayısı) odanın fiziksel olarak ağırlayabileceği kadardır.

<Occupancy> değeri pozitif olmalıdır 1 ile 99 arasında (1 ve 99 dahil) tam sayı.

<Occupancy> eşlik edebilir <OccupancyDetails>; konuklara (yetişkinler veya çocuklar) izin verilmez. Söz dizimi için <OccupancyDetails> konusuna bakın ve alt öğelerin açıklaması.
<OccupancySettings> Optional Object Bir reklamverenin doluluk gereksinimlerini kısıtlayabilen veya değiştirebilen ayarlar oda.

<OccupancySettings> öğesi, şu alt öğeleri kullanın:

  • <MinOccupancy>: Minimum konuk sayısı bir odada kalabilecektir. Örneğin, 2, bu oda tek bir konuk için rezerve edilemez.

    <MinOccupancy> değeri pozitif olmalıdır 1 ile 99 arasında (1 ve 99 dahil) tam sayı.

  • <MinAge>: Tüm konuklar için minimum yaş sınırı bir odada kalmaya bayılıyorum. Örneğin, 18 olarak ayarlanırsa bu oda yalnızca tüm konukların 18 yaşında olduğu gruplar için rezerve edilebilir veya daha eski.

    <MinAge> değeri, pozitif bir tam sayı olmalıdır arasında (0 ve 99 dahil) olmalıdır.

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

Tüm alt öğelerin eklenmesi gerekmez.
<PhotoURL> Optional Object Belirtilen odanın veya ilgili odanın fotoğrafına ait URL ve isteğe bağlı başlık Oda Paketi. Birden fazla <PhotoURL> belirtebilirsiniz oda veya Oda Paketi için uygun. Her fotoğraf URL'si kendi içinde olmalıdır <PhotoURL>

Bu öğe aşağıdaki alt öğeleri alır:

  • <URL>: Fotoğrafın konumunu belirtir. İlgili içeriği oluşturmak için kullanılan konum herkese açık olmalı (güvenlik duvarı arkasında olmamalıdır) ve protokolü (örneğin, https://). Yalnızca bir tane kullan <URL>/<PhotoURL>.
  • <Caption>: Fotoğrafın başlığını tanımlar. Bu öğede tek bir alt öğe (<Text>) yer alır. (iki zorunlu özelliğe sahip): text ve language. text özelliği başlıktır. language özelliği de iki harfli bir en gibi bir dil kodu kullanabilirsiniz.

Örnek:

<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> Oda özellikleriyle ilgili bilgileri içerir.
<RoomID> Required string Odanın benzersiz kimliğidir. Oda verilerini eşleştirmek için bu kimliği kullanın fiyatlandırma güncellemelerinizdeki <Result> engellemeyle. Örneğin, Daha fazla bilgi için Oda Paketi meta verileri konusuna bakın. ( bu kimliği, tek bir odadaki ortak oda tanımına referans vermek için de kullanabilir. Oda verileri satır içinde tanımlanırken işlem mesajı gösterilir.)

Örnekler

Oda verileri

Aşağıdaki örnekte oda verileri tanımlanmaktadır:

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

Oda ve paket meta verileri

Aşağıdaki örnekte oda ve paket meta verileri tanımlanmaktadır:

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

Birden fazla oda paketi

Aşağıdaki örnekte birden çok Oda için oda ve paket meta verileri tanımlanmaktadır Paketler:

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

Odada bulunan özellikleri tanımlar.

<RoomFeatures> öğesi İşlem mesajı XML hiyerarşisi:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
            + <RoomFeatures>

Söz dizimi

<RoomFeatures> öğesi şu söz dizimini kullanır:

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

Özellikler

<RoomFeatures> öğesinin özelliği yok.

Alt öğeler

<RoomFeatures> öğesi aşağıdaki alt öğelere sahiptir:

Alt Öğe Zorunlu mu? Tür Açıklama
<JapaneseHotelRoomStyle> Optional enum

Bir Japon otel odasının tarzını belirtir.

Geçerli değerler şunlardır:

  • western: Yataklı, Batı tarzı bir oda.
  • japanese: Futon yatak bulunan Japon tarzı bir oda.
  • japanese_western: Japon ve kovboy tarzı bir oda ve Japon tarzı futon yataklar vardır.
<Beds> Optional Object Odadaki kadar <Bed> bulunur. Not Japon futonları burada sayılmaz.

Her <Bed> aşağıdaki özelliklere sahiptir:

  • size (isteğe bağlı): Geçerli değerler şunlardır: single, semi_double, double, queen, ve king.
Her <Bed> aşağıdaki alt öğelere sahiptir:
  • <Width> (isteğe bağlı): Yatak genişliğini belirtir. Zorunluluk unit özelliğine sahip olan cm ve yatağın tam sayı genişliğine sahip number özelliği santimetre.
  • <Length> (isteğe bağlı): Yatak uzunluğunu belirtir. cm değerine sahip unit özelliği bulunmalıdır ve yatağın uzunluğuyla number özelliği tam sayı santimetre.
Örnek: 
<Beds>
  <Bed size="double">
    <Width unit="cm" number="140"/>
    <Length unit="cm" number="195"/>
  </Bed>
  <Bed/> <!-- Size unknown -->
</Beds>
<Suite> Optional empty Bu oda bir süitse bu öğeyi sağlayın.
<Capsule> Optional empty Bu oda, kapsül oda olduğunda bu öğeyi sağlayın.
<Roomsharing> Optional enum Bu odanın sahipler veya diğer konuklarla paylaşılıp paylaşılmadığı konuklar. Geçerli değerler shared ve private değerleridir.
<Outdoor> Optional empty Bu oda, şu özelliklere sahip olmayan bir açık hava konaklama tesisiyse bu öğeyi sağlayın: Sabit duvarlara, sıhhi tesisata ve klimaya sahip. Örneğin, otel odaları konukların çadırda kaldığı ve çadırda kaldığı kamp alanları Konukların kendi karavanlarıyla geldiği karavan parkları, açık hava konaklama yerleridir.
<MobilityAccessible> Optional empty Bu oda, hareket kabiliyetine uygun olduğunda bu öğeyi sağlayın.
<Smoking> Optional enum Bu odanın sigara içilmeyen oda mı yoksa sigara içilen oda mı olduğu bilgisi. Geçerli değerler non_smoking ve smoking.
<BathAndToilet> Optional Object Odadaki banyo ve tuvalet hakkında bilgiler içerir.

Özellik:

  • relation (isteğe bağlı): Banyo ve tuvaletin nasıl yapıldığını gösterir. birbirlerine yerleştirin. Geçerli değerler: together (banyo ve tuvalet aynı odada aynı yerde olmalıdır. (ör. banyo) ve separate (Banyo ve tuvaletin her birinde ayrı bir alan vardır). Bu özellik odanın hem banyo hem de tuvaletin bulunmadığı durumlarda ayarlayın.

Öğe isteğe bağlı olarak aşağıdaki alt öğeleri alır:

  • <Bath> (isteğe bağlı): Bu öğenin varlığı odada banyo olduğunu gösterir.

    Özellikler şunlardır:

    • bathtub (isteğe bağlı): Banyoda banyoda küvet var. Geçerli değerler: 0 (veya false) ve 1 (veya true).
    • shower (isteğe bağlı): Banyoda duş. Geçerli değerler 0 (veya false) ve 1 (veya true).
  • <Toilet> (isteğe bağlı): Bu öğenin varlığı bu odada tuvalet olduğunu gösterir.

    Özellikler şunlardır:

    • electronic_bidet (isteğe bağlı): tuvalette elektronik Bide bulunur. Geçerli değerler 0 (veya false) ve 1 (veya true).
    • mobility_accessible (isteğe bağlı): tuvalet, engellilere uygun. Geçerli değerler: 0 (veya false) ve 1 (veya true).

Örnek:

<BathAndToilet relation="separate">
  <Bath bathtub="1" shower="1"/>
  <Toilet
    electronic_bidet="1"
    mobility_accessible="1"/>
</BathAndToilet>
<OpenAirBath> Optional empty Bu odada özel açık hava banyosu varsa bu öğeyi sağlayın.
<AirConditioning> Optional empty Bu odada klima varsa bu öğeyi sağlayın.
<Balcony> Optional empty Bu odada balkon veya veranda varsa bu öğeyi sağlayın.
<Views> Optional Object Geçerli seçenekler şunlardır:

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

Örnekler

JapaneseHotelRoomStyle öğesinin varsayılan değeri yok. Atlanıyor bir değer XML hatasına neden olmuyor, ancak girişiniz şurada gösterilmiyor: Kullanıcı oda stiline veya yataklara göre filtrelendiğinde arama sonuçları.

İki adet tek kişilik yatak

Aşağıdaki örnekte <RoomFeatures> hizmetinin nasıl kullanılacağı gösterilmektedir:

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

İki adet çift kişilik yatak

Aşağıda iki kişilik western tarzı Japon oda örneği verilmiştir. double yatak.

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


Yataksız Japon tarzı

Aşağıda yataksız Japon tarzı bir oda örneği verilmiştir. Yatak japanese stili oda için bilgi gerekmiyor.

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

Yataklı kovboy Japon tarzı

Aşağıda king bulunan japanese_western tarzı bir oda örneği verilmiştir. yatak.

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

İş ortağı, japanese_western içindeki yatak sayısı hakkında bilgiye sahip değilse oda ayarını tıklayın, ardından aşağıdaki örneği uygulayın:

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

Bir tesisin Oda Paketleri hakkındaki seyahat planından bağımsız meta verileri tanımlar. Bu öğe iş ortağı ve otelle ilişkilendirilmiş bilgiler içerir. ancak seyahat planıyla değil. Amaç, seyahat planı dışındaki tüm planların tanımlanmasıdır. ve seyahat planı verilerinden bu verilere referansta bulunabilirsiniz.

<PackageData> öğesi İşlem mesajı XML hiyerarşisi:

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

<PackageData> öğesi, <RoomData> ile benzer ancak Fiziksel odanın parçası olmayan ücret özellikleri ve şartları açıklıyor dokunun. <RoomData> ve <PackageData> özelliklerini şu amaçlarla birlikte kullanıyorsunuz: Oda Paketleri ve ücret özellikleri hakkında ayrıntılı bilgi sağlar. Şu özelliklere sahip ayrı odalar için: pakete dahil değilse yalnızca <RoomData> kullanın.

Şu öğe için hem <RoomData> hem de <PackageData> öğelerini tanımlayabilirsiniz: aynı oda veya Oda Paketi. Google bu odayı veya paketi arama sonuçlarında ise her ikisinden de, bir kısa çizgi.

Bir tesis için tek bir <PackageData> öğesini güncellerseniz özelliğin tüm <PackageData> ve <RoomData> öğelerini güncelleyin. Her <PropertyDataSet>, mülkle ilgili tüm veriler olarak kabul edilir ve mevcut verilerin üzerine yazar.

Daha fazla bilgi için Oda Paketi meta verileri konusuna bakın.

Söz dizimi

<PackageData> öğesi şu söz dizimini kullanır:

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

Özellikler

<PackageData> öğesinin özelliği yok.

Alt öğeler

<PackageData> öğesi aşağıdaki alt öğelere sahiptir:

Alt Öğe Zorunlu mu? Tür Açıklama
<BreakfastIncluded> Optional boolean Bu pakette, ücrete tabi kahvaltının dahil olup olmadığını belirtir. Geçerli değerler 0 (veya false) ve 1'dir (veya true).

Optimum kampanya performansı için -<Meals> <BreakfastIncluded>.
<ChargeCurrency> Optional enum Kullanıcının rezervasyon için ödeme yaptığı zaman ve yer. Bu öğe, aynı öğedeki <Result> içinde <ChargeCurrency> olarak söz dizimi.

Varsayılan değer: web.
<CheckinTime> Optional Time Mümkün olan en erken giriş saati. Saat, otelin yerel saatine göre 24:00'ten az olmalıdır.
<CheckoutTime> Optional Time Otelin yerel saatine göre mümkün olan en geç çıkış saati.
<Description> Optional Object Paketin ayrıntılı bir açıklamasıdır. Bu öğe, başka unsurlar tarafından açıklanmayan bilgileri veya <Name> öğesi. Metnin tamamında büyük harf kullanmamalısınız. harf kullanmalarını öneririz.

<Description> öğesi, tek bir iki zorunlu özelliğe sahip <Text> alt öğesi: text ve language. text özelliğinin değeri, açıklama ve language özelliğidir. aşağıdaki örnekte olduğu gibi iki harfli bir dil kodu belirtir gösterir:

<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 Pakette ücretsiz internet erişimi varsa diğer paketler ise bu imkanı içermiyor. Bunu ayarlama ücretsiz internet bağlantısı sunan bir otelde bulunan oda paketleri odalar. Bu öğe, oda içi kablolu internet veya kablosuz için geçerli değildir. internet erişimi vardır. Geçerli değerler: 0 (veya false) ve 1 (veya true).
<Meals> Optional Object Bu paketteki yemeklerle ilgili bilgiler içerir.

<Meals> öğesi, isteğe bağlı iki alt öğe alır öğeler, <Breakfast> ve <Dinner>, Bunlar aşağıdaki özelliklere sahiptir:

  • included (gerekli): 1 (veya true) olarak ayarlayın fiyata kahvaltı/akşam yemeği dahilse aksi takdirde 0 olarak ayarlanır veya false.
  • in_room (isteğe bağlı): 1 (veya true) olarak ayarlayın konukların konakladıkları odada kahvaltı/akşam yemeği yapma seçeneği olup olmadığı in; aksi takdirde 0 (veya false) olarak ayarlanır.
  • in_private_space (isteğe bağlı): 1 (veya true). Konukların restoranda kahvaltı/akşam yemeği servisi varsa Kendileriyle temastan kaçınabilecekleri bir alan (kaldıkları oda hariç) diğer konuklar; aksi takdirde 0 (veya false) olarak ayarlanır.
  • buffet (isteğe bağlı): 1 (veya true) olarak ayarlayın kahvaltı/akşam yemeği açık büfe olarak servis ediliyorsa; aksi takdirde 0 olarak ayarlanır (veya false).

İsteğe bağlı özellikler yalnızca included aşağıdaki durumlarda kullanılır: doğru.

Yemek filtreleri için (no meals, breakfast only, dinner only ve breakfast and dinner) iş yerine, hem <Breakfast> hem de <Dinner> gerekiyor included özelliğiyle sağlanacak.
<Name> Required string Paketin adı. Bu değer, otelin açılış sayfasına Bu öğenin değerini tamamen büyük harf olarak ayarlamayın anlamına gelir.

Bu öğede tek bir alt öğe (<Text>) yer alır. (text ve language) olmak üzere iki özelliğe sahip. text özelliği açıklama, language özelliği, iki harfli dil kodunu belirtir aşağıdaki örnekte gösterildiği gibi:

<Name>
  <Text text="Bed and Breakfast" language="en"/>
  <Text text="Lit et petit déjeuné" language="fr"/>
</Name>
<Occupancy> Optional integer Oda Paketi'nin amaçlandığı maksimum konuk sayısıdır. Örneğin, büyük bir süit fiziksel olarak 6 kişiyi ağırlayabilir. Yalnızca 4 konuk kapasitelidir.

Bu değer, <Capacity> öğesi (kişi sayısı) odanın fiziksel olarak ağırlayabileceği kadardır.

<Occupancy> değeri pozitif olmalıdır 1 ile 99 arasında (1 ve 99 dahil) tam sayı.

Bu öğeyi hem <RoomBundle> hem de <PackageData> ise <RoomBundle> içindeki değer öncelikli olur.

Not:

<Occupancy> eşlik edebilir <OccupancyDetails>: Davetlilerin türünü belirtir. (yetişkinler veya çocuklar) için geçerli değildir. Söz dizimi ve<OccupancyDetails> alt öğelerin açıklaması.
<PackageID> Required string

Paketin benzersiz kimliğidir. Şunu eşleştirmek için bu kimliği kullanın: <Result> bloğundaki Oda Paketi verileri fiyatlandırma güncellemeleri. Daha fazla bilgi için: Oda Paket meta verileri.

(Bu kimliği ortak bir Oda Paketi tanımına referans vermek için de kullanabilirsiniz. Oda Paketi verileri tanımlanırken tek bir Transaction mesajında kullanılır inline.)
<ParkingIncluded> Optional boolean Oda Paketi'ne ücretsiz otopark dahil olup olmadığı, Aksi takdirde bu otelde otopark ücretlidir. Belirtme ücretsiz otopark sunan bir otelde bu öğe için bir değer.

Geçerli değerler 0 (veya false) ve 1 (veya true). Varsayılan değer: false.
<PhotoURL> Optional Object (<RoomData> içindeki <PhotoURL> ile aynı, ancak paket için (ör. yemek fotoğrafları) bakın.
<Refundable> Optional Object Bir ücretin tamamen geri ödenebilir olarak listelenmesini veya ücretsiz iptal eder. Sağlanmazsa geri ödemeyle ilgili hiçbir bilgi gösterilmez. <PackageData> düzeyindeki geri ödeme politikası, şu adresteki geri ödeme politikasını geçersiz kılar: <Result> seviyesinde. <Rates> düzeyinde geri ödeme politikasının geçersiz kılınması <PackageData> düzeyinde geri ödeme politikası. Geri ödenebilir fiyatlandırma kullanıcılara doğrudan verilmeksizin alternatif seçeneklerle işlem mesajı şemanızı değiştirme. Bu seçenekler hakkında daha fazla bilgi edinin Geri ödenebilir ücret politikası.

Aşağıdaki örnekte <Refundable> gösterilmektedir öğesi:

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

Not: Tüm özellikleri ayarlamanızı öneririz. Feed bir veya daha fazla özellik eklendiğinde durum uyarı mesajı oluşturulur ayarlanmadı.

Hiçbir özelliği ayarlamazsanız ücret geri ödeme yapılabilir. Özellikler şunlardır:

  • available: (Zorunlu) 1 veya Fiyatın tam değere izin verip vermediğini belirtmek için true refund; aksi takdirde 0 veya false olarak ayarlanır.
  • refundable_until_days: (Aşağıdaki durumlarda gereklidir: available, true) Belirtir Eksiksiz geri ödeme alınabileceği gün sayısı check-in işleminden önce istendi. refundable_until_days değeri 0 ile 330 arasında (0 ve 330 dahil) bir tam sayı olmalıdır.
  • refundable_until_time: (Aşağıdaki durumlarda önemle tavsiye edilir: available, true) Belirtir günün en son saatine, otelin yerel saatine göre, geri ödeme isteği dikkate alınır. Bu, Belirtmek için refundable_until_days, Örneğin, "geri ödemeler iki gün önce saat 16:00'a kadar yapılabilir. check-in" yazın. refundable_until_time ayarlanmazsa varsayılan olarak gece yarısına ayarlanır.

    Bu özelliğin değeri Zaman biçimini kullanır.

Özellikleri ayarlarken aşağıdakilere dikkat edin:

  • available veya refundable_until_days değilse ücret geri ödenebilir olarak görüntülenmez.
  • available değeri 0 veya false ise diğer özellikler yoksayılır. Ücret şu şekilde görüntülenmez: diğer özelliklerden biri veya her ikisi de ayarlanmış olsa bile geri ödenebilir.
<MembershipBenefits Included> Optional boolean Ücrete konaklama süresi boyunca elit statü avantajları dahildir. Dahil olan hizmetler: şu parametrelere sahip olursunuz:
  • ProgramName: Elit statü programının adı
  • ProgramLevel: Programın düzeyi. Örnek: "Altın."
  • NightlyValue (optional): Etiketin gecelik değeri avantajları
<CarRentalIncluded> Optional boolean Ücrete, konaklama süresi boyunca ücretsiz araç kiralama dahildir.
<MilesIncluded>&gt; Optional boolean Ücrete sık uçan yolcu programı milleri dahildir. Parametreler şunları içerir:
  • NumberofMiles: Seyahat planı başına mil sayısı.
  • Provider: Sık uçan yolcu programı milleri sağlar.
<OnPropertyCredit> Optional boolean Ücrete tesis kredisi (yiyecek ve/veya alkolsüz içecekler, tatil köyü, spa vb.) dahildir. Parametre:
  • Amount: Kredinin seyahat planı başına yerel değeri para birimi.
<AirportTransportationIncluded> Optional Object Ücrete, yakındaki bir havaalanına çift yönlü ücretsiz ulaşım dahildir. İsteğe bağlı direction özelliği, ulaşım. Geçerli değerler şunlardır:
    from: Havaalanından otele ulaşım sağlanır Yön belirtilmezse varsayılan olarak bu değer kullanılır. to: Havaalanından otele ulaşım sağlanır round_trip: Hem otele hem de kalkış noktası için ulaşım sağlanır görebilirsiniz.

Örnekler

Tek oda paketi

Aşağıdaki örnekte doluluk oranı şu olan tek Oda Paketi tanımlanmaktadır: 2 kişilik (bir yetişkin ve bir çocuk) kahvaltı dahil:

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

Oda ve paket meta verileri

Aşağıdaki örnekte oda ve paket meta verileri tanımlanmaktadır:

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

Birden fazla oda paketi

Aşağıdaki örnekte birden çok Oda için oda ve paket meta verileri tanımlanmaktadır Paketler:

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


Ücretli oda paketi

Aşağıdaki örnekte bir Oda paketi için oda ve paket meta verileri tanımlanmaktadır ücret özellikleri:

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

Yemekler ve fotoğraflar

Aşağıdaki örnekte yemekler için oda ve paket meta verileri tanımlanmaktadır. fotoğraflara ve check-in ile çıkış saatlerine bakın:

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

Kahvaltı

<?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>'daki fiyatlandırma ve müsaitlik durumu güncellemelerinin kapsayıcısıdır. mesajını alırsınız.

<Result> öğesi İşlem mesajı XML hiyerarşisi:

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

Oda fiyatlarını ayarlamak veya güncellemek ve tanımlamak için <Result> kullanın envanterdir. Bu öğede tanımlanan öğeler genellikle Bir oda veya paket hakkında seyahat planından bağımsız meta veriler (ör. açıklama veya olanak grubu) <PackageData> ve <RoomData> içinde tanımlanır.

Fiyatlandırma güncellemeleri içeren Transaction mesajlarını genellikle çok sık gönderirsiniz. Bunu tam olarak nasıl ve ne sıklıkta yaptığınız iletim modunuza bağlıdır.

Seyahat planlarını kaldırmak için Transaction mesajında <Result> kullanabilirsiniz. Envanter Kaldırma bölümünde açıklanmıştır. Fiyatları güncellemek için Transaction mesajlarını kullanma hakkında daha fazla bilgi Envanter Ekleme ve Güncelleme.

Tek bir Transaction mesajı, herhangi bir sayıda <Result> öğesi içerebilir olması gerekir. Ancak iletinin boyutu 100 MB'ı aşmamalıdır.

Söz dizimi

<Result> öğesi şu söz dizimini kullanır:

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

Özellikler

<Result> öğesi aşağıdaki özelliklere sahiptir:

Özellik Zorunlu mu? Tür Açıklama
mergeable Optional boolean Varsayılan olarak, belirli bir otel ve seyahat planı çifti için yeni fiyatlar Google'ın önbelleğinde bulunan önceki (süresi dolmamış) fiyatların üzerine yazar. İlgili içeriği oluşturmak için kullanılan birleştirilebilir özellik, Google'ın önbelleğine ek fiyatlar depolamanıza olanak tanır. önceki fiyatlandırma bilgilerini silmenize gerek yoktur. Şununla Gerçek Zamanlı Fiyatlandırma Sorgusu: Bağlam yanıtlarında bu özellik her zaman true olarak ayarlanır (işlem mesajı yanıtınızdan bağımsız olarak).

Alt öğeler

<Result> öğesi aşağıdaki alt öğelere sahiptir:

Alt Öğe Zorunlu mu? Tür Açıklama
<AllowablePointsOfSale> Optional Object Bu kampanya için uygun olan bir veya daha fazla açılış sayfası otel. Açılış sayfası, bir mağazanın rezervasyon sürecini yürütebilen bir web sitesidir. son kullanıcı. Belirli açılış sayfalarını açıkça dahil etmek (ve hariç tutmak) diğerleri), bir veya daha fazla <AllowablePointsOfSale> ekleyin <PointOfSale> öğesinin id özelliğini gönderin.

Bu öğeyi dahil etmezseniz bir dosyanın rezervasyonunu yaptırmak için kullanılmaya uygun oda. Daha fazla bilgi için: Açılış Sayfaları Dosya Söz Dizimi.
<Baserate> Optional float

Konaklama için oda fiyatıdır. Bu öğenin değeri şunları yansıtmalıdır:

  • Özel oda için en ucuz çift kişilik ücreti belirleyin yardımcı olur. Burada daha yüksek doluluk oranına izin verilir. İki kişilik oda doluluk oranı ve hesabınızda çift kişilik olmayan doluluk oranı etkinleştirdik. Çift kişilik olmayan doluluk oranlarını etkinleştirmek için lütfen bize ulaşın. Burada tek kişilik oda sayısına izin verilmiyor. <Rates> altında ayarlanmalıdır.
  • Paylaşılan oda söz konusuysa boş bırakın ve şunu kullanın: <RoomBundle>
  • Bu değer, ortalama gecelik ücret.

Oda, seyahat planı için müsait olmadığında <Baserate> atlanmalı veya -1 ve <Unavailable> olmalıdır ve özelliğin kullanılamamasının bilinen nedenleri gösterilir.

Oda Paketini kaldırmak için Oda Paketini Kaldırma başlıklı makaledeki talimatları uygulayın.

<Baserate> hiçbir rakam gruplandırması içermemelidir virgül (,) veya nokta (.) gibi semboller kullanabilirsiniz. Her zaman ayrı ondalık işareti olarak nokta (.) kullanılan kesirler. Örneğin, 1.200,40 ABD dolarını temsil eder:

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

<Baserate> öğesi şunları alır: isteğe bağlı özellikler:

  • all_inclusive: Bu oranın geçerli olup olmadığını gösteren bir boole değeri vergi ve ücretler dahildir. Genel olarak bu değeri ABD ve Kanada'daki son kullanıcılar ile tedarik değerleri için false <Tax> ve <OtherFees> için öğeler. Her şey dahil fiyatlar kullanıyorsanız tekliften yararlanamayabilirsiniz Fiyatlarınız vergileri ayırmıyorsa listelemelerde gösterilir ve Kanada'daki kullanıcılar için geçerli ücretlerdir.

    Her şey dahil fiyatlar artık ABD'deki kullanıcılara gösteriliyor.

    Diğer tüm son kullanıcılar için genellikle vergileri ve ücretleri eklersiniz seçeneğini belirleyin ve all_inclusive değerini ayarlayın özelliğini true olarak tanımlar. Daha fazla bilgi için: Vergiler ve Ücretler Politikası.

    Varsayılan değer: false.

  • currency: Üç harfli para birimi kodu. Örneğin, örneğin, Türk lirası için USD.
<ChargeCurrency> Optional enum Kullanıcının rezervasyon için ödeme yaptığı zaman ve yer. Bu öğe <Result> içindeki bir Transaction mesajında kullanılmalıdır Otel Fiyatı veya <PackageData> bloğu için öğe satın alabilirsiniz.

Geçerli değerler şunlardır:

  • web: Kullanıcıdan şu anda internetten ödeme alınır yardımcı olur. Bu, varsayılan değerdir. Gerçek açılış sayfası tarafından tanımlanır açılış sayfası dosyasıdır ve kullanıcının para biriminden etkilenebilir. konum, dil veya diğer faktörler.
  • hotel: Şuraya giriş yaparken kullanıcıdan ödeme alınır: otel. Ödemenin her zaman otelin para biriminde yapılması gerekiyorsa <ChargeCurrency> değeri ile hotel. Asıl açılış sayfası kullanıcının para birimi.
  • deposit: Kullanıcıdan hemen bir miktar ödeme alınır kalan kısmı ise daha sonra ücretlendirilir. Kullanıcı otelden çıkış yaptığında.
  • installments: Kullanıcıdan başlangıçta kesirli ücret alınır ödenmesi gereken toplam tutardan ve belirli bir bakiyeyi düzenli olarak ödemesi beklenir. sabit bir süre boyunca devam edebilir.

Varsayılan değer: web.
<Checkin> Required Date Seyahat planının Tarih özelliğini kullanan check-in tarihidir. biçimindedir. <Nights> öğesi ile <Checkin> öğesi, seyahat planı oluşturur.
<Custom[1‑5]> Optional string Ek veri iletmek için kullanabileceğiniz özel bir alan tanımlar bir otelle ilişkilidir. şu öğe adlarını kullanabilirsiniz:
  • <Custom1>
  • <Custom2>
  • <Custom3>
  • <Custom4>
  • <Custom5>

<Custom> öğeleri rastgele verileri iletmenize olanak tanır. Örneğin, bu alanda şu değeri temsil eden bir değer belirtebilirsiniz: bir açılış için özel URL oluşturmak üzere açılış sayfaları dosyası tarafından kullanılır sayfasını ziyaret edin. Özel alan başına 200 karakter sınırı vardır. Örneğin, daha fazla bilgi için açılış sayfası dosyaları ziyaret edin.

&lt;Custom&gt; <Rate> içinde sağlanan öğeler öğesi <RoomBundle> öğesine devralınmaz. Şunları yapmalısınız: <Custom> öğesini tanımla özelliğini her <RoomBundle> içinde ayrı ayrı işleyeceğiz.

<ExpirationTime> Optional DateTime Fiyatın geçerliliğinin sona erdiği tarih ve saat (3 saat) .

Bu özellik varsa geçerlilik sonu zaman damgalarını sağlamamanızı öneririz. olduğunu unutmayın.

Google, süresi dolan fiyatları ve seyahat planlarını sunmaz süresi dolmuş bir fiyatı olan Gerçek Zamanlı Fiyatlandırma Sorgusu.
<Nights> Required integer Seyahat planı için gece sayısıdır. The value of <Nights> öğesi pozitif bir tam sayı olmalıdır. <Nights> ve kombinasyonu <Checkin>, seyahat planı oluşturur.
<OtherFees> Optional float Taban ücret ve vergiyi etkileyen vergiler dışındaki ücretler odanın son fiyatıdır. <OtherFees> öğesi tanımlayan tek bir gerekli özellik, currency Ücretler için üç harfli para birimi kodu. Örneğin, USD.

Aşağıdaki durumlarda <OtherFees> öğesi gereklidir <Baserate> sıfırdan büyük.
<Occupancy> Optional integer Bu fiyat için izin verilen maksimum kişi sayısını belirtir. <Occupancy>, doğrudan <Result> altında göründüğünde 2 veya daha fazlasını belirtmelidir. <Occupancy> ile birlikte <OccupancyDetails> eşlik eder. Bu koşul, konukların (yetişkinler veya çocuklar) türünü belirtmelidir. Davetli türleri belirtilmemişse bu kişilerin yetişkin olduğu varsayılır. Şu konu için: <OccupancyDetails> söz dizimini ve açıklamasını içerir. Öğe <Occupancy> öğesi sağlanmadı, doluluk: varsayılan olarak 2 değerine ayarlanmıştır.

Not: Destek ekibinizle iletişime geçerek özelliği etkinleştirmek için çift kişilik olmayan fiyatlar gönderin.
<PackageID> Optional string Paketin önceden tanımlanmış paket verileriyle eşleştirileceği benzersiz kimliğidir. PACKAGE-ID açılış sayfası değişkenini doldurmak için de kullanılır. Daha fazla bilgi için: Oda Paket meta verileri.
<Property> Required string İlişkili verilerden (fiyat, seyahat planı, Oda Paketi veya meta veriler). Bu öğenin değeri şöyle olmalıdır: kullanabilirsiniz. Bu öğenin değeri girişle eşleşmelidir Otel Listesi Feed'inizde tanımladığınız <id>.
<Rates> Optional <Rates> Bir veya daha fazla <Rate> bloğunun kapsayıcısıdır. Her <Rate> <Rates>, oda/seyahat planı için farklı bir fiyat tanımlıyor seçilebilir.

Birden fazla ücret olduğunda <Rates> öğesini kullanın. aynı oda/seyahat planı kombinasyonunun bulunduğu veya bir ücretin <Result> düzeyinde belirtilmelidir. Örneğin, birden fazla ücretleri koşullu fiyatlar, özel indirimler, koşullu fiyatlar oda paketlerinde veya farklı doluluk oranlarında gösterilebilir.

Not: <Result> sınırları içinde tek kişilik rezervasyonlarda yalnızca <Rates> içinde belirtilmelidir. İzin vermek için lütfen bize ulaşın çift kişilik olmayan fiyatlarla.
<Refundable> Optional Object Bir ücretin tamamen geri ödenebilir olarak listelenmesini veya ücretsiz iptal eder. Sağlanmazsa geri ödemeyle ilgili hiçbir bilgi gösterilmez. <PackageData> düzeyindeki geri ödeme politikası, şu adresteki geri ödeme politikasını geçersiz kılar: <Result> seviyesinde. <Rates> düzeyinde geri ödeme politikasının geçersiz kılınması <PackageData> düzeyinde geri ödeme politikası. Geri ödenebilir fiyatlandırma kullanıcılara doğrudan verilmeksizin alternatif seçeneklerle işlem mesajı şemanızı değiştirme. Daha fazla bilgi: Geri ödenebilir ücret politikası.

Aşağıdaki örnekte <Refundable> gösterilmektedir öğesi:

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

Not: Tüm özellikleri ayarlamanızı öneririz. Feed bir veya daha fazla özellik eklendiğinde durum uyarı mesajı oluşturulur ayarlanmadı.

Hiçbir özelliği ayarlamazsanız ücret geri ödeme yapılabilir. Özellikler şunlardır:

  • available: (Zorunlu) 1 (veya true) kullanarak ücretin tam fiyat refund; aksi takdirde 0 (veya false) olarak ayarlanır.
  • refundable_until_days: (Aşağıdaki durumlarda gereklidir: available, true) Belirtir Eksiksiz geri ödeme alınabileceği gün sayısı check-in işleminden önce istendi. refundable_until_days değeri 0 ile 330 arasında (0 ve 330 dahil) bir tam sayı olmalıdır.
  • refundable_until_time: (Aşağıdaki durumlarda önemle tavsiye edilir: available, true) Belirtir günün en son saatine, otelin yerel saatine göre, geri ödeme isteği dikkate alınır. Bu, Belirtmek için refundable_until_days, Örneğin, "geri ödemeler iki gün önce saat 16:00'a kadar yapılabilir. check-in" yazın. refundable_until_time ayarlanmazsa varsayılan olarak gece yarısına ayarlanır.

    Bu özelliğin değeri Zaman biçimini kullanır.

Özellikleri ayarlarken aşağıdakilere dikkat edin:

  • available veya refundable_until_days değilse ücret geri ödenebilir olarak görüntülenmez.
  • available değeri 0 ise (veya false ise) diğer özellikler yoksayılır. Ücret şu şekilde görüntülenmez: diğer özelliklerden biri veya her ikisi de ayarlanmış olsa bile geri ödenebilir.
<RoomBundle> Optional <RoomBundle> Odaların ücretli fiziksel açıklamalarıyla ilgili bilgilerin yer aldığı kapsayıcı paketlerini ve ek açıklamaya ilişkin bazı satın alma politikası belirtilen otel ve seyahat planını gösterir.

Genel olarak bu öğeyi, taban oda ve odanın fiyatını tanımlamak için kullanın. oda türü olabilir. Bir e-postada oda Paketi açıklamalarını satır içinde tanımlamak için ayrı bir Transaction mesajı (bu bilgiyi tanımlamak için kullanılır). Google, Böylece, her durumda tekrarlamak yerine referans olarak kullanabilirsiniz. fiyat güncellemelerinden yararlanabilirsiniz.
<RoomID> Optional string Odanın, önceden tanımlanmış oda verileriyle eşleştirileceği benzersiz kimliğidir. Ayrıca PARTNER-ROOM-ID açılış sayfası değişkenini doldurmak için kullanılır. Daha fazla bilgi için: Oda Paket meta verileri.
<Tax> Optional float Odanın son fiyatı için hesaplanan vergilerdir. <Tax> öğesi tek bir gerekli özellik alır. currency (üç harfli para birimi kodunu tanımlar) için teşekkür ederiz. Örneğin, USD. İlgili içeriği oluşturmak için kullanılan Şu durumda <Tax> öğesi gereklidir: <Baserate> sıfırdan büyük.

<Baserate> öğesinin "her_şey_dahil" özelliğinin açıkça doğru değerine ayarlanmasıyla birlikte, değeri isteğe bağlıdır.
<Unavailable> Optional Object Seyahat planının rezervasyon için kullanılamadığını belirtir. Şu görevi yapar: kapsayıcısının neden mevcut olmadığı hakkında daha ayrıntılı bilgi için. Bir veya daha fazlası <Unavailable> etiket:
  • <NoVacancy/>: Satılık başka oda yok konaklamanın bir veya daha fazla gecesi için.
  • <MinNightStay value=N/>: Seyahat planı, şu değerin altındaydı: konaklama tarihleri için minimum gece konaklama süresi N.
  • <MaxNightStay value=N/>: Seyahat planı, şu değerin üzerindeydi: Konaklama tarihleri için maksimum N gecelik konaklama.
  • <MinAdvancePurchase value=N/>: Seyahat planı şuydu: konaklama için N olan minimum ön rezervasyon aralığının altında .
  • <MaxAdvancePurchase value=N/>: Seyahat planı şuydu: konaklama için N olan maksimum ön rezervasyon aralığının üzerinde .
  • <ClosedToArrival/>: Mülk izin vermiyor seyahat planının varış tarihinde check-in yapma
  • <ClosedToDeparture/>: Mülk izin vermiyor çıkış tarihinde çıkış yapacak.
  • <PropertyClosed first_open="YYYY-MM-DD" first_closed="YYYY-MM-DD"/>: Tesis bazı veya kaldığı sürece. Önerilen özellikler first_open ve first_closed, şundan büyük veya şuna eşit olan ilk tarihleri belirtir: sırasıyla tesisin açık veya kapalı olduğu varış tarihidir. Varış tarihinden sonra kapanan bir tesis için first_open varış tarihine eşit olmalı ve first_closed, tesisin kapandığı tarih olmalıdır. Tarihinde kapalı olan bir tesis için varış tarihi (first_closed, varış tarihine eşit olmalıdır) tarihi (first_opened) ise kapsama alanının emin olun.
  • <NotFetched/>: Seyahat planında belirtilen fiyat şu değildi aşağı akış veri kaynakları tarafından sağlanır.
  • <InvalidProperty/>: İstenen mülk tanımlayıcısı tanınmadı.
  • <InvalidOccupancy/>: İstenen doluluk oranı şu değil: mülk tarafından desteklenir.
  • <PriceIssue/>: Fiyatla ilgili bir sorun nedeniyle gönderilmez.
  • <InternalError reason=""/>: Numaralandırılmamış bazı hatalar meydana geldi. İsteğe bağlı neden özelliği, hatayı metin olarak bildirebilir.
  • <OtherRestriction restriction=""/>: Seyahat planı şuydu: numaralandırılmamış rezervasyon kısıtlamaları nedeniyle kullanılamıyor. İsteğe bağlı kısıtlama özelliği, kısıtlamanın metin olarak raporlanmasına olanak tanır.

Örnekler

Çoklu tesis örneği

Aşağıdaki örnekte bir seyahat planı ve iki kişilik fiyatlandırması tanımlanmaktadır. özellikler:

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

Bu örnekte, odayla ilgili şu gibi ayrıntılar gösterilmemiştir: açıklama, resim ve başlık, odanın adı ve kapasitesi.

Bu bilgileri bir kez ayrı bir İşlem'de tanımlayabilirsiniz. Google'ın sakladığı bir mesaj görürsünüz. Böylece, oluşturduğunuz güncellemeleri takip edebilirsiniz. Daha fazla bilgi için: Oda Paketi meta verileri.

Çoklu ücret örneği

Aşağıdaki örnekte birden fazla değer içeren tek bir seyahat planı ve tesis tanımlanmaktadır. farklı doluluk oranlarını görebilirsiniz. <Rates> öğesi şu amaçlarla kullanılabilir: Belirli bir tesis için çoklu ücret fiyatlandırması sunmalıdır. Aşağıdaki örnek Kiralık Yer (Kiralık Yerler) tesisleri için de faydalıdır:

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

Kullanılamayan örnek

Aşağıdaki örnekte kullanılabilirliği kullanılamayacak olan bir seyahat planı tanımlanmaktadır. alt akış kanallarından gelir elde edilir. Bu da her ikisi de minimumun altında ve üçte biri, belirtilen tarihler için daha önce rezervasyon yapmış, Tesis varış tarihinde kapalı, ancak şu aralıkta açılış: konaklama:

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

Bir veya daha fazla <Rate> bloğunun kapsayıcısıdır. Her <Rate> <Rates>, oda veya seyahat planı kombinasyonu için farklı bir fiyat tanımlıyor.

<Rates> öğesini yalnızca şunun için birden fazla ücret olduğunda kullanın: aynı oda veya seyahat planı kombinasyonuna sahip olmanız gerekir. Örneğin, birden fazla koşullu fiyatlar için geçerli fiyatlar özel indirimler veya Oda Paketlerindeki koşullu fiyatlar.

<Rates> öğesi İşlem mesajı XML hiyerarşisi:

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

<Rate> için ayarlanan değerler, üst <Result> veya <RoomBundle> öğesi. <Rate> içinde ayarlanmamışsa değerlerini üst öğeden devralırlar. Yalnızca &lt;AllowablePointsofSale&gt; <RoomBundle> öğesine devralınır.

Söz dizimi

<Rates> öğesi şu söz dizimini kullanır:

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

Özellikler

<Rates> öğesi aşağıdaki özelliklere sahiptir:

Özellik Zorunlu mu? Açıklama
rate_rule_id Optional için koşullu fiyatlar'ı seçerseniz bu kimlik bir ücreti Ücret Kuralı Tanımlama dosyası. Bu alan için karakter sınırlaması 40'tır karakteri ekleyin.

Alt öğeler

<Rates> öğesi aşağıdaki alt öğelere sahiptir:

Alt Öğe Zorunlu mu? Tür Açıklama
<AllowablePointsOfSale> Optional Object Bu kampanya için uygun olan bir veya daha fazla açılış sayfası otel. Bu öğe, <Result> üzerinde <AllowablePointsOfSale>.
<Baserate> Required float Konaklama için oda fiyatıdır. Bu öğe, aynı öğedeki söz dizimini <Result> üzerinde <Baserate> olarak belirtmelisiniz.

Not: Şunun altındaki <Baserate> alt öğesi: <Rate> kullanılamıyor olarak tanımlanamaz.
<ChargeCurrency> Optional enum Kullanıcının rezervasyon için ödeme yaptığı zaman ve yer. Bu öğe, içindeki <ChargeCurrency> ile aynı söz dizimi <Result>
<Custom[1‑5]> Optional string Aşağıdakilerle ilişkili ek verileri iletmek için kullanabileceğiniz özel alanlar: bir otelin açılış sayfasına yönlendirilir. Bu öğe, şununla aynı söz dizimini kullanır: <Result> içinde <Custom[1‑5]>. Sınır vardır özel alan başına 200 karakter uzunluğunda olabilir. Daha fazla bilgi için: açılış sayfası dosyalarına eklenmiş olması gerekir.

<Custom> ise öğeleri <Result> öğesi içinde yer alıyorsa bunlar <RoomBundle> öğesidir ve her biri için ayrı ayrı tanımlanmalıdır <RoomBundle> veya <PackageData> öğesine dahil edilebilir eğer gerekir.
<ExpirationTime> Optional DateTime Ücretin geçerliliğinin sona erdiği tarih ve saattir. Bu öğesi, <Result> içinde <ExpirationTime>.
<Occupancy> Optional integer

Bu fiyat için izin verilen maksimum kişi sayısını belirtir. Değilse üst ücretle aynı olduğu varsayılır. <Occupancy> eşlik edebilir <OccupancyDetails>. belirtir, konukların türünü (yetişkinler veya çocuklar). Söz dizimi ve açıklaması için <OccupancyDetails> alt öğelere karşılık gelir.
<OtherFees> Required float Taban ücret ve son fiyatı etkileyen vergiler dışındaki ücretler bir oda gibi. Bu öğe, <Result> içinde <OtherFees>.

<Baserate> öğesinin "her_şey_dahil" özelliğinin açıkça doğru değerine ayarlanmasıyla birlikte, değeri isteğe bağlıdır.
<Refundable> Optional Object Bir ücretin tamamen geri ödenebilir olarak listelenmesini veya ücretsiz iptal eder. Sağlanmazsa geri ödemeyle ilgili hiçbir bilgi gösterilmez. <PackageData> düzeyindeki geri ödeme politikası, geri ödeme politikasını geçersiz kılar <Result> düzeyinde. <Rates> düzeyinde geri ödeme politikasının geçersiz kılınması <PackageData> düzeyinde geri ödeme politikası. Geri ödenebilir fiyatlandırma kullanıcılara doğrudan verilmeksizin alternatif seçeneklerle işlem mesajı şemanızı değiştirme. Bu seçenekler hakkında daha fazla bilgi edinin Geri ödenebilir ücret politikası.

Aşağıdaki örnekte <Refundable> gösterilmektedir öğesi:

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

Not: Tüm özellikleri ayarlamanızı öneririz. Feed bir veya daha fazla özellik eklendiğinde durum uyarı mesajı oluşturulur ayarlanmadı.

Hiçbir özelliği ayarlamazsanız ücret geri ödeme yapılabilir. Özellikler şunlardır:

  • available: (Zorunlu) 1 (veya true) kullanarak ücretin tam fiyat refund; aksi takdirde 0 (veya false) olarak ayarlanır.
  • refundable_until_days: (Aşağıdaki durumlarda gereklidir: available, true) Belirtir Eksiksiz geri ödeme alınabileceği gün sayısı check-in işleminden önce istendi. refundable_until_days değeri 0 ile 330 arasında (0 ve 330 dahil) bir tam sayı olmalıdır.
  • refundable_until_time: (Aşağıdaki durumlarda önemle tavsiye edilir: available, true) Belirtir günün en son saatine, otelin yerel saatine göre, geri ödeme isteği dikkate alınır. Bu, Belirtmek için refundable_until_days, Örneğin, "geri ödemeler iki gün önce saat 16:00'a kadar yapılabilir. check-in" yazın. refundable_until_time ayarlanmazsa varsayılan olarak gece yarısına ayarlanır.

    Bu özelliğin değeri Zaman biçimini kullanır.

Özellikleri ayarlarken aşağıdakilere dikkat edin:

  • available veya refundable_until_days değilse ücret geri ödenebilir olarak görüntülenmez.
  • available değeri 0 ise (veya false ise) diğer özellikler yoksayılır. Ücret şu şekilde görüntülenmez: diğer özelliklerden biri veya her ikisi de ayarlanmış olsa bile geri ödenebilir.
<Tax> Required float Odanın son fiyatı için hesaplanan vergilerdir. Bu öğesi, bir <Tax> ile aynı <Result>

Örnekler

Taban ücret ve koşullu fiyat

Aşağıdaki örnekte, taban ücret içeren bir Transaction mesajı gösterilmektedir koşullu fiyat ise aşağıdaki gibidir:

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

Birden fazla koşullu fiyat

Aşağıdaki örnekte taban ücret ve birden fazla koşullu fiyat tanımlanmaktadır <RoomBundle> içinde:

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

Şu öğenin alt öğesi olarak Oda Paketleri için fiyatlandırmayı ve müsaitlik durumunu tanımlar: <Transaction> mesajında <Result>. Her biri için ayrı bir öğe tanımlayın size yardımcı olabilir. Etiketin paketini ve şartlarını Oda Paketleri için <RoomData> kullanın.

<RoomBundle> öğesi İşlem mesajı XML hiyerarşisi:

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

Daha fazla bilgi için Oda Paketlerini Kullanma başlıklı makaleye bakın.

Söz dizimi

<RoomBundle> öğesi şu söz dizimini kullanır:

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

Özellikler

<RoomBundle> öğesinin özelliği yok.

Alt öğeler

<RoomBundle> öğesi aşağıdaki alt öğelere sahiptir:

Alt Öğe Zorunlu mu? Tür Açıklama
<Baserate> Required float Konaklama için Oda Paketi fiyatını tanımlar. Bu öğe <Result> içindeki <Baserate> ile aynı söz dizimi, şu istisna:
  • Oda seyahat planı için müsait değilse Odanın olmadığını belirten <RoomBundle> öğesi bu süreyi uzatır. Daha fazla bilgi için: Oda Paketlerini kaldırma.
<BreakfastIncluded> Optional boolean Bu Oda Paketinde kahvaltının ücrete dahil olup olmadığını belirtir.
<ChargeCurrency> Optional enum Kullanıcının rezervasyon için ödeme yaptığı zaman ve yer. Bu öğe, aynı öğedeki <Result> içinde <ChargeCurrency> olarak söz dizimi.

Varsayılan değer: web.
<Custom[1‑5]> Optional string Açılış sayfalarına ek veri iletmek için kullanılan özel alanlar oda paketidir. Bu öğeler, <Result> içinde <Custom[1-5]>. Bu sınır 200'dür. karakter sayısı (özel alan başına) Daha fazla bilgi için: açılış sayfası dosyaları.

<Custom> ise öğeleri <Result> öğesi içinde yer alıyorsa bunlar <RoomBundle> öğesidir ve her biri için ayrı ayrı tanımlanmalıdır <RoomBundle> veya <PackageData> öğesine dahil edilebilir eğer gerekir.
<InternetIncluded> Optional boolean Oda Paketi ücretsiz internet erişimi içeriyorsa: diğer paketler ise bu olanağı içermiyor. Bunu ayarlama ücretsiz internet bağlantısı sunan bir otelde bulunan oda paketleri odalar. Bu öğe, oda içi kablolu internet veya kablosuz için geçerli değildir. internet erişimi vardır.
<Occupancy> Required integer Bu fiyat için izin verilen maksimum kişi sayısını belirtir. Örneğin, büyük bir süit fiziksel olarak 6 kişiyi ağırlayabilir ancak "Balayı Paketi" yalnızca 2 konuk kapasitelidir.

Bu değer, <Capacity> veya bu metrik, odanın fiziksel olarak ağırlayabileceği kadardır.

Açılış sayfası URL'nizde doluluk tanımlarken NUM-ADULTS ve NUM-CHILDREN değişkenleri Değişkenler ve Koşullar Varsayılan değer: 2 yetişkinler ve 0 çocuk.

<Occupancy> değeri pozitif olmalıdır 1 ile 99 arasında (1 ve 99 dahil) tam sayı.

Notlar:

  • <RoomBundle> boyunca <Occupancy> zorunlu olarak işaretlenmesini ve atlanırsa kesinlikle 1097 hatası verir.
  • <Occupancy>, sipariş: <RoomBundle>, <PackageData> ve ardından = <RoomData>. Bunların herhangi birinde değer yoksa değer varsayılan olarak 2'dir.
  • <Occupancy> eşlik edebilir <OccupancyDetails>, Misafirin türünü (yetişkinler veya çocuklar) belirten bir ad girin. Davetli türleri belirtilmemişse yetişkin olduğu varsayılır. Danışma Alt öğelerin söz dizimi ve açıklaması için <OccupancyDetails>.
  • Her ikisinde de <Occupancy> öğesini ayarladığınızda <RoomBundle> ve <PackageData>, <RoomBundle> içindeki değer öncelik sırasına koyduk.
<OtherFees> Required float Taban ücret ve vergiyi etkileyen vergiler dışındaki ücretler odanın son fiyatıdır. <OtherFees> öğesi tanımlayan tek bir gerekli özellik, currency Ücretler için üç harfli para birimi kodu. Örneğin, şunu kullanın: ABD doları için USD.
<PackageID> Optional (recommended) string Paket verilerinin benzersiz kimliğidir. Şunu eşleştirmek için bu kimliği kullanın: <PackageData> içinde gönderilenleri içeren Oda Paketi verileri. Örneğin, daha fazla bilgi için Oda Paket meta verileri. ( bu kimliği, kullanılan ortak bir Oda Paketi tanımına referans vermek için de kullanabilir Oda Paketi verileri tanımlanırken tek bir Transaction mesajında inline.)
<ParkingIncluded> Optional boolean Oda Paketi'ne ücretsiz otopark dahil olup olmadığı, Aksi takdirde bu otelde otopark ücretlidir. Belirtme ücretsiz otopark sunan bir otelde bu öğe için bir değer.

Geçerli değerler 0 (veya false) ve 1 (veya true). Varsayılan değer: false.
<RatePlanID> Optional string Ücret Planı Kimliği, şunun benzersiz tanımlayıcısını temsil eder: oda ve paket kombinasyonuna bakalım. Örneğin, <RoomID> değeri 5 ve a ABC değeri <PackageID> ise şu değeri kullanabilirsiniz: <RatePlanID> 5-ABC. Şunu kesinlikle öneririz: Dinamik açılış sayfanızı oluşturmak için RatePlanID değişkeni olarak (eski adıyla Satış Noktası) URL'si.

Daha fazla bilgi için: Değişkenleri Kullanma Koşullar.
<Rates> Optional <Rates> Bu Oda Paketi için varsayılanları geçersiz kılan ücretlerdir. Bu öğesi, <Result> içindeki <Rates> ile aynı söz dizimini kullanır.
<Refundable> Optional Object Bir ücretin tamamen geri ödenebilir olarak listelenmesini veya ücretsiz iptal eder. Sağlanmazsa geri ödemeyle ilgili hiçbir bilgi gösterilmez. <PackageData> düzeyindeki geri ödeme politikası, şu adresteki geri ödeme politikasını geçersiz kılar: <Result> seviyesinde. <Rates> düzeyinde geri ödeme politikasının geçersiz kılınması <PackageData> düzeyinde geri ödeme politikası. Geri ödenebilir fiyatlandırma kullanıcılara doğrudan verilmeksizin alternatif seçeneklerle işlem mesajı şemanızı değiştirme. Bu seçenekler hakkında daha fazla bilgi edinin Geri ödenebilir ücret politikası.

Aşağıdaki örnekte <Refundable> gösterilmektedir öğesi:

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

Not: Tüm özellikleri ayarlamanızı öneririz. Feed bir veya daha fazla özellik eklendiğinde durum uyarı mesajı oluşturulur ayarlanmadı.

Hiçbir özelliği ayarlamazsanız ücret geri ödeme yapılabilir. Özellikler şunlardır:

  • available: (Zorunlu) 1 (veya true) kullanarak ücretin tam fiyat refund; aksi takdirde 0 (veya false) olarak ayarlanır.
  • refundable_until_days: (Aşağıdaki durumlarda gereklidir: available, true) Belirtir Eksiksiz geri ödeme alınabileceği gün sayısı check-in işleminden önce istendi. refundable_until_days değeri 0 ile 330 arasında (0 ve 330 dahil) bir tam sayı olmalıdır.
  • refundable_until_time: (Aşağıdaki durumlarda önemle tavsiye edilir: available, true) Belirtir günün en son saatine, otelin yerel saatine göre, geri ödeme isteği dikkate alınır. Bu, Belirtmek için refundable_until_days, Örneğin, "geri ödemeler iki gün önce saat 16:00'a kadar yapılabilir. check-in" yazın. refundable_until_time ayarlanmazsa varsayılan olarak gece yarısına ayarlanır.

    Bu özelliğin değeri Zaman biçimini kullanır.

Özellikleri ayarlarken aşağıdakilere dikkat edin:

  • Eğer available veya refundable_until_days ayarlanmazsa ücret geri ödenebilir olarak gösterilmez.
  • available değeri 0 ise (veya false ise) diğer özellikler yoksayılır. Ücret şu şekilde görüntülenmez: diğer özelliklerden biri veya her ikisi de ayarlanmış olsa bile geri ödenebilir.
<RoomID> Required string Oda verilerinin benzersiz kimliğidir. Şunu eşleştirmek için bu kimliği kullanın: <RoomData> içinde gönderdiklerinizi içeren Oda Paketi verileri. Daha fazla bilgi için: Oda Paketi meta verileri. (Bu kimliği bir tek bir Transaction mesajında ortak oda tanımı oda verilerini satır içi olarak ayarlayın.)
<Tax> Required float Odanın son fiyatı için hesaplanan vergilerdir. <Tax> öğesi tek bir gerekli özellik alır. currency (üç harfli para birimi kodunu tanımlar) için teşekkür ederiz. Örneğin, ABD doları için USD kullanın.

Örnekler

Tek kişilik paket

Aşağıdaki örnekte tek bir doluluk paketi içeren bir yanıt tanımlanmaktadır. Bir kullanıcı Doluluk seçicide 1 seçeneğini belirlediğinde Google en düşük uygun fiyata sahip olmalıdır.

Tek bir doluluk fiyatı yoksa Google, çift kişilik en düşük fiyat. Tek kişilik fiyat, veya daha fazla fiyat için önbelleğe alınan veriler seyahat planı.

Bu örnekte, <RoomID> ve <PackageID> öğeleri. <RoomData> ve <PackageData> öğeleri kullanın.

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

İki veya daha fazla doluluk

Aşağıdaki örnekte iki veya daha fazla doluluk içeren bir yanıt tanımlanmaktadır.

Bu örnekte, <RoomID> ve <PackageID> öğeleri. <RoomData> ve <PackageData> öğeleri kullanın.

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


Birden fazla oda paketi

Aşağıdaki örnekte, olası hostel odası fiyatlandırmasını kullanabilirsiniz.

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

Birden fazla Koşullu fiyat

Aşağıdaki örnekte taban ücret ve birden fazla koşullu fiyat tanımlanmaktadır <RoomBundle> içinde:

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

Transaction mesajındaki <Occupancy>, maksimum konuk sayısını belirtir oda veya paket fiyatıdır. <OccupancyDetails> ek bilgiler içerebilir konuk sayısı ve türü (yetişkinler veya çocuklar) gibi.

<Rates> öğesi içinde <Occupancy> ve <OccupancyDetails> göründüğünde <Result> veya <RoomBundle> arasındaysa bu, oranın doluluk bilgilerini girin.

Söz dizimi

<OccupancyDetails> göründüğü zaman öncesinde her zaman <Occupancy> bulunur. Şu söz dizimine dikkat edin:

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

Alt öğeler

<OccupancyDetails> öğesi aşağıdaki alt öğelere sahiptir:

Alt Öğe Zorunlu mu? Tür Açıklama
<NumAdults> Required integer Yetişkin konukların sayısıdır. Min:1, Maks:20.
<Children> Optional Object Bir veya daha fazla <Child> öğesinin kapsayıcısıdır.
<Child age> Optional integer Bu çocuk için maksimum yaş sınırı; örneğin, <Child age="17">.

Örnekler

Aşağıdaki örnekler, <OccupancyDetails> etki alanının <Results>, <RoomBundle> veya <Rates> alt öğesi.

Sonuç yanıtı

Aşağıdaki örnekte bir seyahat planı ve tek bir seyahat planı için fiyatlandırması tanımlanmaktadır bir Gerçek Zamanlı Fiyatlandırma Sorgusuna yanıt olarak konuk sayısını ve türünü belirtmelisiniz. Burada <OccupancyDetails> -- 2 yetişkin ve <Result> içinde döndürülür.

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

Yanıtı değerlendir

Aşağıdaki örnekte bir seyahat planı ve 1 yetişkin için fiyatlandırması tanımlanmaktadır ve 1 çocuk. Burada <OccupancyDetails>, <Rates> içindeki <Result> öğesi.

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

Oda paketi

Aşağıdaki örnekte 2 yetişkin ve 1 çocuktan oluşan bir doluluk tanımlanmaktadır. geri ödenebilir ücretle iki gecelik konaklama dahildir. Burada <OccupancyDetails> görünür <RoomBundle> içinde

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

Birden fazla oda paketi

Aşağıdaki örnekte hedeflenen birden fazla <RoomBundle> ücreti 2 yetişkin ve 2 çocukla sınırlıdır. Burada, <OccupancyDetails>, <RoomBundle> öğesinin <Rates> öğesinde görünüyor.

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