Ringkasan pesan Transaksi

Pesan Transaksi mengirim data tentang kamar, harga, dan paket ke Google. Ada dua jenis utama pesan Transaksi:

  1. Data itinerari: Menentukan Paket Kamar dan data itinerari, termasuk:

    • Harga dan inventaris hotel: Menetapkan harga minimum untuk itinerari yang memenuhi persyaratan tertentu. Untuk mengetahui informasi selengkapnya, lihat Memperbarui Harga. Anda juga dapat menghapus kamar dari inventaris. Untuk mengetahui informasi selengkapnya, lihat Menghapus inventaris.

    • Paket Kamar: Menetapkan harga itinerari untuk kombinasi kamar fisik dan paket layanan tambahan. Untuk mengetahui informasi selengkapnya, Paket Kamar. Google meng-cache konten pesan Transaksi Anda agar harga selalu tersedia. Dalam beberapa kasus, Google menentukan bahwa nilai dalam cache-nya tidak aktual, sehingga dapat mengirimkan pesan <Query> tambahan (atau dalam beberapa kasus, Kueri Harga Real Time) untuk mendapatkan harga terbaru. Data ini biasanya sering berubah. Untuk menentukan harga dan ketersediaan pesan Transaksi, gunakan <Result>.

  2. Metadata kamar dan paket: Menentukan detail tentang kamar dan paket, seperti deskripsi, foto, dan jumlah tamu maksimum. Data ini tidak sering berubah. Untuk menentukan pesan Transaksi metadata, gunakan <PropertyDataSet>. Google menyimpan metadata ini sehingga Anda dapat merujuknya dari pesan harga, bukan menyertakan informasi berulang tentang kamar dan paket di setiap pesan. Untuk mengetahui informasi selengkapnya, lihat Menentukan metadata paket dan kamar.

Elemen root pesan Transaksi adalah <Transaction>. Pesan yang menggunakan elemen <Transaction> sebagai elemen root memerlukan setidaknya salah satu elemen turunan. Pesan Transaksi dapat memiliki sejumlah elemen turunan, selama ukuran total pesan tidak melebihi 100 MB.

Untuk contoh pesan Transaksi yang merespons permintaan oleh Google, lihat Referensi XML Harga & Inventaris Kamar (Transaksi).

Mode pengiriman

Jenis dan frekuensi pengiriman pesan Transaksi bergantung pada mode pengiriman Anda:

  • Untuk mode pengiriman Pull, Anda mengirim pesan Transaksi saat menerima <Query> dari Google.
  • Untuk mode pengiriman Harga yang Diubah, Anda mengirim pesan Transaksi setelah menerima dan merespons <HintRequest> dan <Query>.

Untuk mengetahui informasi selengkapnya, lihat Harga Mode pengiriman.

Kueri harga real time

Terlepas dari mode pengiriman Anda, Google juga dapat mengirimkan permintaan yang dikenal sebagai Kueri harga real time. Pesan Kueri ini mencari harga sebagai respons terhadap penelusuran saat ini. Jika Anda merespons dalam jangka waktu yang ditentukan, yang biasanya berlangsung beberapa ratus milidetik, iklan Anda dapat muncul di lelang. Hasil Anda juga dapat lebih cocok dengan pelanggan, meliputi negara dan jenis perangkat, serta jumlah tamu yang mereka tentukan. Untuk mengetahui informasi selengkapnya, lihat Kueri harga real time.

Ukuran pesan

Anda dapat menyertakan kombinasi pembaruan data dalam satu pesan Transaksi. Namun, ada batas 100 MB pada ukuran setiap pesan. Biasanya, semua Permintaan Pull dan Hint memiliki batas waktu respons 100 detik. Waktu tunggu adalah kolom yang dapat dikonfigurasi dan dapat disesuaikan oleh Google sesuai permintaan. Google merekomendasikan agar Anda menetapkan waktu tunggu ke 10 menit untuk pesan yang sangat besar.

Untuk mengurangi ukuran pesan secara signifikan dan menghindari potensi masalah ukuran serta waktu tunggu pesan, gunakan pesan Transaksi untuk menentukan terlebih dahulu metadata kamar dan paket. Anda juga dapat menambahkan konten yang di-zip GNU ke pesan dengan menambahkan Content-Encoding: gzip ke header pesan.