İşlem (Tesis Verileri) Mesajı

Genel Bakış

ARI İşlem (Tesis Verileri) mesajı, her tesisin oda türleri ve paketleri (veya ücret planları) ile ilgili bilgileri tanımlar. Her oda türü verisi, benzersiz bir tanımlayıcı (RoomID), yerelleştirilmiş ad, açıklama ve oda fotoğraflarının URL'lerini içerir. Her paket verisi, benzersiz bir tanımlayıcı (PackageID), yerelleştirilmiş ad, açıklama, doluluk ve katma değer içerir.

İşlem mesajını kullanarak şunları yapabilirsiniz:

• Bir veya daha fazla mülk için verileri tanımlayın.
• Her tesis için oda türünü ve paket bilgilerini tanımlayın.
• Ürün tekliflerini kontrol edin.

Ayrıca, aşağıdaki işlemleri yapacak işlemler ayarlayabilirsiniz:

• Tesise oda türü ve paket ekleme.

  Önemli Bilgi: Oda türü için tesis başına 3.000 sınırı vardır. Paketler için de tesis başına 3.000'lik ayrı bir sınır vardır. Oda türlerini veya paketleri kaldırmak için <Transaction> mesajını kullanabilirsiniz.

• Bir tesisten oda türünü ve paketi kaldırma

• Bir pakete veya tesise bağlılık puanları ve ödül programı ekleyin.

İşlem mesajı örnekleri için Transaction (Tesis Verileri) Örnekleri başlıklı makaleyi inceleyin.

Zorunlu ve isteğe bağlı öğeler

XML Referansı, gerekli ve isteğe bağlı öğelerin açıklamalarını sağlar. Özellikler ve alt öğeler hakkında ayrıntılı bilgi için İşlem (Tesis Verileri) Öğeleri ve Özellikleri başlıklı makaleyi inceleyin.

Söz dizimi ve şemalar

Doğru biçimi kullandığınızdan emin olmak için Transaction mesajını oluştururken Transaction (Tesis Verileri) Söz Dizimi örneğini referans olarak kullanın.

Feed'lerinizi Google'a göndermeden önce xmllint gibi bir üçüncü taraf XML aracı kullanarak yayınlanan şemalarla doğrulayabilirsiniz. İşlem mesajı şeması için Otel Reklamları şemaları başlıklı makaleyi inceleyin.

Yönergeler

Transaction mesajı için aşağıdaki yönergeleri kullanın:

Eylemler:

delta: Yeni oda türleri ve paketler (ücret planları) eklemek veya mevcut olanları güncellemek için kullanılır.

overlay: Bir tesisin tüm oda türlerini ve paketlerini yeni bir grupla değiştirmek için kullanın. Hâlâ satış yapmak istediğiniz tüm oda türleri ve ücret planlarıyla ilgili bilgileri içermelidir.

Dil desteği:

Ad, Açıklama ve Altyazı alanları için bir veya iki dil (İngilizce ve gerekirse tesis için yerel bir dil) belirtin. Gerekirse ikiden fazla dil ekleyebilirsiniz.

Oda türleri ve paketler:

Bir oda türünü veya paketi güncellerken söz konusu oda türü ya da paketle ilgili tüm bilgileri göndermeniz gerekir. Örneğin, fotoğraf eklerken adı ve açıklamayı da eklemeniz gerekir.

<AllowablePackageIDs> ve <AllowableRoomIDs> isteğe bağlıdır ve ayarlanmamışsa oda türü ile ücret planı için herhangi bir kombinasyon yapılabilir. Oda türü ve ücret planı kimlikleriyle birlikte müsaitlik durumunu ve fiyatları göndermeye devam etmeniz gerekir. Bu öğeler, ürünleri kontrol etmenize ve sisteminizin artık desteklemediği kombinasyonları devre dışı bırakmanıza olanak tanır.

Oda türlerinde veya paketlerde değişiklik olduğunda ya da oda türleri veya paketlerle ilgili eklenmesi gereken önemli ayrıntılar olduğunda Google'a bir Transaction mesajı güncellemesi gönderin.

Not: Google, "eşleşen" bir mülke bağlı mülk verilerini depoladığından, ilgili mülk sistemde "eşleştirilene" kadar bu verileri kabul edemez. Tüm mülklerinizi liste feed'inizde göndermek, daha sonra oluşabilecek hataları veya gecikmeleri önlemeye yardımcı olabilir.

Bağlılık puanları:

Ödül programını paketinize dahil etmek veya hariç tutmak için Google ile Bağlılık Puanları yapılandırması oluşturun. Bu işlem, ilgili paketle ilişkili kazanılan puanları gösterir. Bağlılık puanları hakkında daha fazla bilgi edinin.

Bağlılık kampanyanızı tanımlamak veya güncellemek için <MilesIncluded> öğesini kullanın. Daha fazla bilgi için Transaction(Tesis Verileri) bölümüne bakın. Bağlılık puanları, <PackageData> ile birlikte eklenebilir.

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğeleri kullanan bir ARI Transaction mesajı örneği verilmiştir. Oda türleri ve paketleri eklemek veya güncellemek için oda türleri ve paketleri eklemek veya güncellemek üzere delta veya tüm oda türü ve paket tanımlarını değiştirmek (eski girişler silinir) için overlay işlemini kullanırsınız.

Ad, Açıklama ve Altyazı alanları için bir veya iki dil (İngilizce ve gerekirse tesis için yerel bir dil) belirtmeniz gerekir. Ardından, fotoğrafların bağlantıları da dahil olmak üzere mülk veri bilgilerini ekleyin.

<PropertyID> ve <RoomID> için, ücret planları ve oda türleri için sisteminizde kullandığınız kimlikleri (sırasıyla) kullanın. Google'ın fiyatlarınızı ve verilerinizi doğru şekilde göstermesi için sisteminizle tutarlı olmanız önemlidir.

Not: Google, oda türü ve paket (ücret planı) tanımlayıcısı için "ID"yi kullanırken OTA XML "code"u kullanır. Google bu kimlikleri oluşturmadığından kendi kimliklerinizi kullanmanız gerekir. Tesis verileri, oda türü ve ücret planı kimliklerinin tesis başına benzersiz olması gerekir.

Dosyanızı hazırladıktan sonra aşağıdaki uç noktaya bir POST mesajı göndererek Google'a göndermeniz gerekir: https://www.google.com/travel/hotels/uploads/property_data

Mesajın nasıl gönderileceği/POST edileceği hakkında daha fazla bilgi edinmek için Mesaj gönderme bölümüne bakın.

Aşağıdaki örnekte, delta işlemi kullanılarak Transaction mesajının nasıl ayarlanacağı gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

overlay işleminin nasıl kullanılacağı, mevcut tesis verilerine oda türü ve paket ekleme ve mevcut oda türlerini ve paketleri kaldırma gibi daha fazla örnek için Transaction (Tesis Verileri) Örnekleri başlıklı makaleyi inceleyin.

"Nasıl yapılır" kılavuzları

Bu bölümde, işlem mesajları gönderirken karşılaşabileceğiniz senaryolara yönelik çözümler sunulmaktadır.

Senaryo 1: Oda türü verilerini kaldırma

Mevcut oda türü ve/veya paket verilerini nasıl kaldırabilirim?

Açıklama

Tesis için king ve queen odalar da dahil olmak üzere birden fazla oda türü gönderdiyseniz. Yenileme sırasında tüm queen oda türleri kullanılamaz ve şu anda yalnızca king oda türleri kullanılabilir.

Çözüm

• Kaldırılan veya devre dışı bırakılan oda türü ve paket kimliklerinin gecelik müsaitlik durumunu, ücretlerini veya envanterini güncellemeniz gerekmez.
• Oda türü veya paket kaldırıldıysa ya da devre dışı bırakıldıysa yalnızca hâlâ etkin olan oda türlerini ve paketleri içeren ve kaldırılan oda türünü veya paketi hariç tutan action="overlay" ile yeni bir İşlem mesajı gönderin.

Örnek

Bu XML snippet'inde, bir oda türünü kaldırmak için overlay işleminin nasıl kullanılacağı gösterilmektedir.

Not: Bu örnekte oda türü ele alınsa da paket verilerini kaldırmak için de aynı işlemi kullanabilirsiniz.

King ve Queen oda türlerini içeren orijinal delta işlemi:

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

Ardından overlay değerini, çift kişilik oda türünü kaldıracak ve kral yatak odasını koruyacak şekilde ayarlayabilirsiniz:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

Senaryo 2: AllowablePackageIDs'i kullanarak ürünleri kontrol etme

Paketler oda türüne göre gruplandırıldığında ürünleri (oda türleri ve paketlerin kombinasyonları) nasıl kontrol edebilirim?

Not: Oda türleriniz paketlere göre gruplandırılmışsa Senaryo 3'e bakın.

Açıklama

Yalnızca belirli oda türlerinde kullanılabilen belirli paketleriniz var. Örneğin, mülkünüzde dört oda türü (başkanlık süiti dahil) ve altı farklı paket varsa ancak başkanlık süiti için yalnızca birkaç paket uygunsa uygunluk durumunu belirtebilirsiniz.

Çözüm

<AllowablePackageIDs> kullanarak pakete hangi ürünlerin dahil edildiğini belirten güncellenmiş bir Transaction mesajı gönderin.

Not: <AllowablePackageIDs> veya <AllowableRoomIDs> kullanın ancak ikisini birden kullanmayın. Kullandığınız öğe, sisteminizin oda>paket veya paket>oda hiyerarşisini kullanıp kullanmamasına bağlıdır. İşlem mesajında bu öğelerin hiçbiri tanımlanmazsa oda türleri herhangi bir paketle birleştirilebilir.

Örnek

Bu XML snippet'inde, belirli bir oda türüyle kullanılan paketleri belirtmek için <AllowablePackageIDs> öğesinin nasıl kullanılacağı gösterilmektedir. Burada, Penthouse süit oda türü yalnızca Penthouse her şey dahil paketi veya Ücretsiz kahvaltı paketi ile, King süit oda türü ise yalnızca King her şey dahil paketi veya Evcil hayvan dostu paket ile kullanılabilir.

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

Not: Daha önce kullanmış olabileceğiniz ancak artık sisteminizde izin verilmeyen bir kombinasyonu devre dışı bırakmak için <AllowablePackageIDs> veya <AllowableRoomIDs>'i kullanırsanız yalnızca önceki verileri kaldırmak için tüm tarihler için ARI'yi yeniden göndermeniz gerekmez.

Senaryo 3: AllowableRoomIDs özelliğini kullanarak ürünleri kontrol etme

Oda türleri pakete göre gruplandırıldığında ürünleri (oda türleri ve paketlerin kombinasyonları) nasıl kontrol edebilirim?

Not: Paketleriniz oda türüne göre gruplandırılmışsa Senaryo 2'ye bakın.

Açıklama

Bir oda türü ve paket kombinasyonu artık ürün olarak satılmıyorsa veya yeni bir pakete nelerin dahil edileceğini kontrol etmek istiyorsanız Örneğin, bir paketle yalnızca belirli oda türlerini (ör. okyanus manzaralı King ve Queen odalar) belirtmek istiyorsunuz.

Çözüm

<AllowableRoomIDs> öğesini kullanarak pakete dahil edilen ürünlerin tam olarak hangileri olduğunu belirten güncellenmiş bir Transaction mesajı gönderin.

Örnek

Bu XML snippet'inde, pakette deniz manzaralı King ve Queen oda türlerini belirtmek için <AllowableRoomID> öğesinin nasıl kullanılacağı gösterilmektedir.

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>