Pesan Transaksi (Data Properti)

Ringkasan

Pesan Transaksi ARI (Data Properti) menentukan informasi tentang jenis dan paket kamar (atau paket tarif) dari setiap properti. Setiap data jenis kamar menyertakan ID unik (RoomID), nama, deskripsi, dan URL yang dilokalkan untuk foto ruang. Setiap data paket berisi ID unik (PackageID), nama yang dilokalkan, deskripsi, jumlah tamu, dan nilai tambah.

Anda dapat menggunakan pesan Transaksi untuk melakukan hal berikut:

• Tentukan data untuk satu atau beberapa properti.
• Tentukan jenis kamar dan informasi paket untuk setiap properti.
• Mengontrol penawaran produk.

Anda juga dapat menetapkan tindakan untuk melakukan hal berikut:

• Tambahkan jenis kamar dan paket ke properti.
• Menghapus jenis kamar dan paket dari properti.

Untuk contoh pesan transaksi, lihat Contoh Transaksi (Data Properti).

Elemen wajib dan opsional

Referensi XML memberikan deskripsi elemen wajib dan opsional. Untuk detail tentang atribut dan elemen turunan, lihat Elemen & Atribut Transaksi (Data Properti).

Sintaksis dan skema

Gunakan contoh Sintaksis Transaksi (Data Properti) sebagai referensi saat membuat pesan Transaksi untuk memastikan Anda mengikuti format yang benar.

Anda dapat menggunakan alat XML pihak ketiga seperti xmllint untuk memvalidasi feed dengan skema yang dipublikasikan sebelum mengirimkannya ke Google. Untuk skema pesan Transaksi, lihat Skema Iklan Hotel.

Panduan

Gunakan panduan berikut untuk pesan Transaksi:

Tindakan:

delta: Gunakan untuk menambah atau memperbarui jenis kamar dan paket baru (paket tarif).

overlay: Gunakan untuk mengganti semua jenis kamar dan paket untuk properti dengan kumpulan baru. Harus menyertakan informasi untuk semua jenis kamar dan paket tarif yang masih ingin Anda jual.

Dukungan bahasa:

Tentukan satu hingga dua bahasa (Inggris, dan bahasa lokal untuk properti jika diperlukan) untuk kolom Nama, Deskripsi, dan Teks. Anda dapat menambahkan lebih dari dua bahasa jika diperlukan.

Jenis dan paket kamar:

Saat memperbarui jenis kamar atau paket, Anda harus mengirim semua informasi terkait untuk jenis kamar atau paket tersebut. Misalnya, saat menambahkan foto, Anda juga harus menyertakan nama dan deskripsi.

<AllowablePackageIDs> dan <AllowableRoomIDs> bersifat opsional, dan jika tidak disetel, kombinasi jenis kamar dan paket tarif dapat dilakukan. Anda tetap harus mengirim ketersediaan dan tarif dengan jenis kamar dan ID paket tarif. Elemen ini memungkinkan Anda mengontrol produk serta menonaktifkan kombinasi yang tidak lagi didukung oleh sistem.

Kirimi Google pembaruan pesan Transaksi setiap kali ada perubahan jenis atau paket kamar, atau detail penting tentang jenis atau paket kamar yang perlu ditambahkan.

Catatan: Karena Google menyimpan data properti yang terhubung ke properti yang "cocok", Google tidak dapat menerima data ini sebelum properti yang terkait "dicocokkan" di dalam sistem. Mengirim semua properti Anda di feed daftar dapat membantu mencegah error atau penundaan di lain waktu.

Contoh

Bagian ini memberikan contoh dasar pesan Transaksi ARI menggunakan elemen wajib dan opsional. Untuk menambahkan atau memperbarui jenis dan paket kamar, Anda menggunakan tindakan bagi delta untuk menambahkan atau memperbarui jenis dan paket kamar, atau overlay untuk mengganti semua jenis kamar dan definisi paket (menghapus entri lama).

Anda perlu menentukan satu hingga dua bahasa (Inggris, dan bahasa lokal untuk properti jika diperlukan) untuk kolom Nama, Deskripsi, dan Teks. Kemudian, tambahkan informasi data properti, termasuk link ke foto.

Untuk <PropertyID> dan <RoomID>, gunakan ID yang sama dengan yang Anda gunakan dalam sistem untuk paket tarif dan jenis kamar (masing-masing). Konsistensi dengan sistem Anda sangat penting untuk memastikan bahwa Google menampilkan harga dan data Anda dengan benar.

Catatan: Google menggunakan "ID" sebagai ID untuk jenis kamar dan paket (paket tarif); sedangkan XML OTA menggunakan "kode". Anda harus menggunakan ID Anda sendiri karena Google tidak membuatnya. Untuk data properti, ID jenis kamar dan paket tarif harus unik per properti.

Setelah menyiapkan file, Anda harus mengirimkannya ke Google melalui pesan POST ke endpoint berikut: https://www.google.com/travel/hotels/uploads/property_data

Untuk mempelajari lebih lanjut cara mengirim/POSTING pesan, lihat Mengirim pesan.

Contoh berikut menunjukkan cara menetapkan pesan Transaksi menggunakan tindakan delta:

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

Untuk contoh lainnya, seperti cara menggunakan tindakan overlay, menambahkan jenis dan paket kamar ke data properti yang ada, serta menghapus jenis dan paket kamar yang ada, lihat Contoh Transaksi (Data Properti).

Petunjuk

Bagian ini memberikan solusi untuk skenario yang mungkin Anda alami saat mengirim pesan Transaksi.

Skenario 1: Cara menghapus data jenis kamar

Bagaimana cara menghapus jenis kamar dan/atau data paket yang ada?

Deskripsi

Anda telah mengirim beberapa jenis kamar, termasuk kamar King dan Queen, untuk properti tersebut. Semua jenis kamar Queen tidak tersedia selama renovasi dan hanya jenis kamar King yang saat ini tersedia.

Solusi

• Anda tidak perlu memperbarui ketersediaan, tarif, atau inventaris per malam untuk jenis kamar dan ID paket yang telah dihapus atau dinonaktifkan.
• Jika jenis kamar atau paket telah dihapus atau dinonaktifkan, kirim pesan Transaksi baru dengan action="overlay" yang hanya menyertakan jenis dan paket kamar yang masih aktif, serta mengecualikan jenis kamar atau paket yang dihapus.

Contoh

Cuplikan XML ini menunjukkan cara menggunakan tindakan overlay untuk menghapus jenis kamar.

Catatan: Meskipun contoh ini mencakup jenis kamar, Anda juga dapat menggunakan tindakan yang sama untuk menghapus data paket.

Berikut adalah tindakan delta asli yang mencakup jenis kamar King dan Queen:

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

Anda kemudian dapat menetapkan overlay untuk menghapus jenis kamar Queen dan mempertahankan jenis Kamar King:

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

Skenario 2: Cara mengontrol produk menggunakan AllowablePackageIDs

Bagaimana cara mengontrol produk (kombinasi jenis kamar dan paket) saat paket dikelompokkan berdasarkan jenis kamar?

Catatan: Jika jenis kamar Anda dikelompokkan menurut paket, lihat Skenario 3.

Deskripsi

Anda memiliki paket tertentu yang hanya tersedia untuk jenis kamar tertentu. Misalnya, jika properti Anda memiliki empat jenis kamar (termasuk Presidential suite), dan enam paket yang berbeda, tetapi hanya beberapa paket yang memenuhi syarat untuk suite presiden, Anda dapat menentukan kelayakan.

Solusi

Mengirim pesan Transaksi yang telah diperbarui yang menentukan produk mana yang disertakan dalam paket menggunakan <AllowablePackageIDs>.

Catatan: Gunakan <AllowablePackageIDs> atau <AllowableRoomIDs>, tetapi tidak keduanya, dan elemen yang Anda gunakan bergantung pada apakah sistem Anda menggunakan ruang hierarki>package atau package>room. Jika tidak satu pun elemen ini ditentukan dalam pesan Transaksi, jenis kamar dapat digabungkan dengan paket apa pun.

Contoh

Cuplikan XML ini menunjukkan cara menggunakan <AllowablePackageIDs> untuk menentukan paket yang digunakan dengan jenis kamar tertentu. Di sini, jenis kamar Penthouse hanya mengizinkan paket lengkap Penthouse atau paket Sarapan gratis, sementara jenis kamar King hanya mengizinkan paket paket King atau paket ramah hewan peliharaan.

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

Catatan: Jika menggunakan <AllowablePackageIDs> atau <AllowableRoomIDs> untuk menonaktifkan kombinasi yang mungkin telah Anda gunakan sebelumnya, tetapi sekarang tidak diizinkan di sistem, Anda tidak perlu mengirim ulang ARI untuk semua tanggal hanya untuk menghapus data sebelumnya.

Skenario 3: Cara mengontrol produk menggunakan AllowableRoomID

Bagaimana cara mengontrol produk (kombinasi jenis kamar dan paket) saat jenis kamar dikelompokkan berdasarkan paket?

Catatan: Jika paket Anda dikelompokkan menurut jenis kamar, lihat Skenario 2.

Deskripsi

Jenis kamar dan kombinasi paket tidak lagi dijual sebagai produk atau Anda ingin mengontrol apa yang disertakan dalam paket baru. Misalnya, Anda ingin menentukan hanya jenis kamar tertentu, seperti kamar King dan Queen dengan pemandangan laut, dengan sebuah paket.

Solusi

Mengirim pesan Transaksi yang telah diperbarui yang menentukan produk persis yang disertakan dalam paket menggunakan elemen <AllowableRoomIDs>.

Contoh

Cuplikan XML ini menunjukkan cara menggunakan <AllowableRoomID> untuk menentukan jenis kamar Oceanview King dan Queen dalam paket.

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