İşlem (Tesis Verileri) Mesajı

Genel bakış

ARI Transaction (Tesis Verileri) mesajı, her bir 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 verileri benzersiz bir tanımlayıcı (PackageID), yerelleştirilmiş ad, açıklama, doluluk ve katma değer içerir.

Aşağıdakileri yapmak için bir Transaction mesajı kullanabilirsiniz:

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

Ayrıca, işlemleri aşağıdakileri yapacak şekilde ayarlayabilirsiniz:

• Tesis için oda türü ve paket ekleyin.
• Tesisten oda türü ve paketi kaldırma.

İşlem mesajlarıyla ilgili örnekler için İşlem (Tesis Verileri) Örnekleri başlıklı makaleyi inceleyin.

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

XML Referansı, gerekli ve isteğe bağlı öğelerin açıklamalarını sağlar. Özellikler ve alt öğelerle ilgili ayrıntılar için İşlem (Tesis Verileri) Öğeleri ve Özellikleri bölümüne bakın.

Söz dizimi ve şemalar

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

Google'a göndermeden önce feed'lerinizi yayınlanmış şemalarla doğrulamak için xmllint gibi bir üçüncü taraf XML aracı kullanabilirsiniz. Transaction mesajı şeması için Otel Reklamları şemalarına bakın.

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 güncellemek için kullanın.

overlay: Bir tesisteki tüm oda türlerini ve paketleri yeni bir grupla değiştirmek için kullanın. Hâlâ satmak istediğiniz tüm oda türleri ve ücret planları ile ilgili bilgileri içermelidir.

Dil desteği:

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

Oda türleri ve paketler:

Bir oda türünü veya paketi güncellerken o oda türü veya paketle ilgili tüm bilgileri göndermeniz gerekir. Örneğin, bir fotoğraf eklediğinizde ad ve açıklama da eklemeniz gerekir.

<AllowablePackageIDs> ve <AllowableRoomIDs> isteğe bağlıdır. Ayarlanmazsa herhangi bir oda türü ve ücret planı kombinasyonu yapılabilir. Yine de oda türü ve ücret planı kimlikleriyle birlikte müsaitlik durumu ve fiyatları göndermeniz gerekir. Bu öğeler, ürünleri kontrol etmenize ve sisteminizin artık desteklemediği kombinasyonları devre dışı bırakmanıza olanak tanır.

Oda türleri veya paketlerde ya da eklenmesi gereken oda türleri veya paketlerle ilgili ö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şene" kadar bu verileri kabul edemez. Liste feed'inizdeki tüm mülklerinizi göndermek daha sonraki hataları veya gecikmeleri önlemeye yardımcı olabilir.

Örnek

Bu bölümde, gerekli ve isteğe bağlı öğeleri kullanan ARI Transaction mesajının temel bir örneği verilmiştir. Oda türlerini ve paketleri eklemek veya güncellemek amacıyla, oda türlerini ve paketleri eklemek veya güncellemek için delta işlemi ya da tüm oda türü ve paket tanımlarını değiştirmek (eski girişleri siler) için overlay işlemi kullanırsınız.

Ad, Açıklama ve Altyazı alanları için bir ila iki dil (İngilizce ve gerekirse mülk için yerel bir dil) belirtmeniz gerekir. Ardından, fotoğraf bağlantıları da dahil olmak üzere mülk verisi 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. Sisteminizle tutarlılık, Google'ın fiyatlarınızı ve verilerinizi doğru bir şekilde görüntülemesini sağlamak için çok önemlidir.

Not: Google, oda türü ve paket (ücret planı) tanımlayıcısı için "ID" değerini kullanırken OTA XML'de "kod" kullanılır. Google tarafından oluşturulmadığı için kendi kimliklerinizi kullanmanız gerekir. Tesis verileri için oda türü ve ücret planı kimliklerinin tesis başına benzersiz olması gerekir.

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

Mesajı aktarma/POST gönderme hakkında daha fazla bilgi için Mesaj aktarma konusuna göz atın.

Aşağıdaki örnekte, bir delta işlemi kullanarak 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şlemini kullanma, mevcut tesis verilerine oda türü ve paket ekleme, mevcut oda türleri ile paketleri kaldırma gibi daha fazla örnek için İşlem (Tesis Verileri) Örnekleri bölümüne bakın.

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

Bu bölümde, Transaction mesajları gönderirken karşılaşabileceğiniz senaryolarla ilgili çözümler sunulmaktadır.

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

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

Açıklama

Tesis için "Çift kişilik" ve "Çift kişilik" odalar da dahil olmak üzere birden fazla oda türü gönderdiniz. Yenileme sırasında tüm çift kişilik oda türleri kullanılamaz. Şu anda yalnızca çift kişilik oda seçenekleri mevcuttur.

Çözüm

• Kaldırılan veya devre dışı bırakılan oda türü ve paket kimlikleri için gecelik müsaitlik durumunu, fiyatları veya envanteri güncellemeniz gerekmez.
• Oda türü veya paket kaldırıldıysa ya da devre dışı bırakıldıysa action="overlay" ile 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 yeni bir Transaction mesajı gönderin.

Örnek

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

Not: Bu örnek oda türünü kapsasa da aynı işlemi paket verilerini kaldırmak için de kullanabilirsiniz.

Çift kişilik orta ve kraliçe oda türlerini içeren orijinal delta işlemini aşağıda görebilirsiniz:

  <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 öğesini "Çift kişilik" oda türünü kaldırıp çift kişilik oda türü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>

2. Senaryo: AllowablePackageIDs kullanılarak ürünleri kontrol etme

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

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

Açıklama

Yalnızca belirli oda türlerine sunulan belirli paketleriniz var. Örneğin, mülkünüzde dört oda türü (cumhurbaşkanlığı süiti dahil) ve altı farklı paket olmasına rağmen yalnızca birkaç paket başkanlık paketi için uygunsa uygunluğu belirtebilirsiniz.

Çözüm

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

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

Örnek

Bu XML snippet'i, belirli bir oda türüyle kullanılan paketleri belirtmek için <AllowablePackageIDs> özelliğinin nasıl kullanılacağını gösterir. Burada Penthouse süit oda türünde yalnızca Penthouse her şey dahil paket veya Ücretsiz kahvaltı paketine izin verilirken King süit oda türünde yalnızca King süit oda türünde yalnızca King süit oda veya evcil hayvan dostu pakete izin verilir.

<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 kullandığınız ancak artık sisteminizde izin verilmeyen bir kombinasyonu devre dışı bırakmak için <AllowablePackageIDs> veya <AllowableRoomIDs> kullanıyorsanız yalnızca önceki verileri kaldırmak amacıyla tüm tarihler için ARI'yi yeniden göndermeniz gerekmez.

3. Senaryo: AllowableRoomIDs kullanılarak ürünleri kontrol etme

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

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

Açıklama

Bir oda türü ve paket kombinasyonu artık ürün olarak satılmıyorsa veya yeni bir pakette nelerin bulunduğunu kontrol etmek istiyorsunuz. Örneğin, okyanus manzaralı "Çift kişilik" ve "Çift kişilik" odalar gibi yalnızca belirli oda türlerini paket halinde belirtmek istersiniz.

Çözüm

<AllowableRoomIDs> öğesini kullanarak, pakete dahil olan ürünleri tam olarak belirten güncellenmiş bir Transaction mesajı gönderin.

Örnek

Bu XML snippet'i, pakette oceanview King ve Queen oda türlerini belirtmek için <AllowableRoomID> özelliğinin nasıl kullanılacağını gösterir.

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