İşlem (Tesis Verileri) Mesajı

Genel Bakış

ARI Transaction (Tesis Verileri) mesajı, her bir tesisle ilgili bilgileri tanımlar oda türleri ve paketleri (veya ücret planları). Her oda türü verisinde şunlar yer alır: benzersiz tanımlayıcı (RoomID), yerelleştirilmiş ad, açıklama ve odanın URL'leri fotoğraf. Her paket verisi, yerelleştirilmiş benzersiz bir tanımlayıcı (PackageID) içerir doluluk ve katma değer yer alır.

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

• 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 kontrol etmek.

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

• Tesise oda türü ve paket ekleyin.

  Önemli Nokta: Oda türünde mülk başına 3.000 karakter sınırı vardır. Paketlerde ayrıca bir mülk başına ayrı sınır 3.000 karakterdir. <Transaction> mesajını kullanarak şunları yapabilirsiniz: oda türlerini veya paketleri kaldırabilirsiniz.

• Tesisten oda türünü ve paketi kaldırın.

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

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

XML Referansı zorunlu ve isteğe bağlı öğelerin açıklamalarını içerir. Ö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

Transaction (Tesis Verileri) sayfasını kullanarak Söz dizimi Örneğin, Transaction mesajı oluşturduğunuzda referans olarak doğru biçimi izleyin.

Feed'lerinizi kontrol etmeniz gerekir. İşlem İçin mesaj şeması için Otel Reklamları oluşturabilirsiniz.

Yönergeler

Bir 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 tesise ait tüm oda türlerini ve paketleri yeni set. Aşağıdaki koşulları karşılayan tüm oda türleri ve ücret planlarıyla ilgili bilgileri içermelidir: hâlâ satmak istiyorsanız.

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. Daha fazla ekleyebilirsiniz iki dilde kullanılabilir.

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. Ayarlanmazsa Herhangi bir oda türü ve ücret planı kombinasyonu yapılabilir. Yine de oda türü ve ücret planı kimlikleriyle birlikte müsaitlik durumunu ve ücretleri gönderin. Bu öğeleri kontrol etmenize olanak tanır ve reklam öğelerinizdeki kombinasyonları devre dışı sistemi artık desteklemiyor.

Odada her değişiklik olduğunda Google'a Transaction mesajı güncellemesi gönderin ya da oda türü veya paketlerle ilgili önemli ayrıntıları eklenmesi gerekir.

Not: Google, "eşleşen" ile bağlantılı tesis verilerini depolar. mülk, Google, ilgili mülk bu verileri kabul edene kadar "eşleşti" inceleyebilirsiniz. Liste feed'inizdeki tüm tesislerinizi gönderdiğinizde oluşabilecek hataları veya gecikmeleri önlemeye yardımcı olur.

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğeler. Oda türleri ve paket eklemek ya da bunları güncellemek için: Oda türlerini ve paketleri eklemek veya güncellemek için delta için bir işlem kullanın veya Tüm oda türü ve paket tanımlarını değiştirmek için overlay (eski verileri siler) girişlerde) yapabilirsiniz.

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ğraflara bağlantılar dahil olmak üzere tesis verileriyle ilgili bilgiler

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

Not: Google "Kimlik" alanını kullanır oda türü ve paket tanımlayıcısı (ücret planı) OTA XML'de ise "kod" kullanılı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 bir POST mesajıyla Google'a göndermeniz gerekir şu uç noktaya: https://www.google.com/travel/hotels/uploads/property_data

Mesajın nasıl aktarılacağı/YAYINlanacağı hakkında daha fazla bilgi edinmek için bkz. Aktarma mesajlar bölümüne gidin.

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ğı gibi diğer örnekler için oda türü ekleyin. mevcut tesis verilerine göre düzenleyin ve mevcut oda türlerini hakkında daha fazla bilgi için Transaction (Tesis Verileri) bölümünü inceleyin. Örnekler.

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

1. Senaryo: Oda türü verileri nasıl kaldırılır?

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

Açıklama

Şu etkinlik için Kral ve Çift kişilik orta boy odalar da dahil olmak üzere birden fazla oda türü gönderdiniz. Tadilat sırasında hiçbir çift kişilik orta boy oda seçeneği sunulmaz ve yalnızca çift kişilik büyük boy oda seçeneği sunulur. oda türleri şu anda mevcut.

Çözüm

• Bu özellik için gecelik müsaitlik durumunu, ücretleri veya envanteri güncellemeniz gerekmez. Kaldırılan veya devre dışı bırakılan oda türü ve paket kimlikleri.
• 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 Transaction mesajı gönderin.

Örnek

Bu XML snippet'i, bir 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ı oda türünü de kullanabilirsiniz. paket verilerini kaldırmanız gerekir.

Çift kişilik büyük ve orta boy oda türlerini içeren orijinal delta işlemi aşağıda verilmiştir:

  <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 özelliğini, Queen adlı oda türünü kaldıracak ve Kral'ın rezervasyonunu devam ettirecek şekilde ayarlayabilirsiniz. oda türü:

  <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: AllowablePackageID kullanarak ü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ılıyorsa 3. Senaryo'ya göz atın.

Açıklama

Yalnızca belirli oda türlerinde kullanılabilen belirli paketleriniz var. Örneğin, Örneğin, tesisinizde dört oda türü (başkanlık süiti dahil) varsa altı farklı paket vardır. Ancak bu paket için uygun olan yalnızca uygun olup olmadığını belirtebilirsiniz.

Çözüm

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

Not: <AllowablePackageIDs> veya <AllowableRoomIDs> kullanın ancak kullanmayın ve kullandığınız öğe, sisteminizin bu hiyerarşiyi kullanarak oda>paket veya paket>oda. Bu öğelerin hiçbiri Transaction mesajı, oda türleri herhangi bir paketle birleştirilebilir.

Örnek

Bu XML snippet'i, paketleri belirtmek için <AllowablePackageIDs> yönergesinin nasıl kullanılacağını gösterir belirli bir oda türünde kullanıldığında geçerlidir. Burada, Çatı katı süiti oda türünde yalnızca ücretsiz kahvaltı paketinin yanı sıra ücretsiz kahvaltı Çift kişilik büyük boy süit oda türünde yalnızca King her şey dahil paket veya Evcil hayvan dostu paket.

<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>'yi 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ürü ve paket kombinasyonları) nasıl kontrol edebilirim?

Not: Paketleriniz oda türüne göre gruplandırılıyorsa 2. Senaryo'ya göz atı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

Dahil edilen ürünleri tam olarak belirten güncellenmiş bir Transaction mesajı gönderin <AllowableRoomIDs> öğesini kullanarak paketle değiştirin.

Örnek

Bu XML snippet'i, okyanus manzarasını belirtmek için <AllowableRoomID> öğesinin nasıl kullanılacağını gösterir. ve çift kişilik orta boy oda bulunur.

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