Pesan transaksi mengirim data tentang kamar, harga, dan paket ke Google. Ada dua jenis utama pesan Transaksi:
Data itinerari: Menentukan paket Room dan itinerari termasuk:
Harga dan inventaris hotel: Tetapkan harga minimum untuk itinerari yang memenuhi persyaratan tertentu. Untuk mengetahui informasi selengkapnya, lihat Memperbarui Harga. Anda juga dapat menghapus ruang 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 menyimpan konten pesan Transaksi dalam cache sehingga harga selalu tersedia. Dalam beberapa kasus, Google menentukan bahwa nilai dalam cache-nya tidak diperbarui, sehingga dapat mengirimkan pesan
<Query>tambahan (atau dalam beberapa kasus, Kueri Harga Real Time) untuk mendapatkan harga terbaru. Data ini biasanya sangat sering berubah. Untuk menetapkan harga dan ketersediaan pesan Transaksi, gunakan<Result>.
Metadata paket dan kamar: Menentukan detail tentang kamar dan paket, seperti deskripsi, foto, serta jumlah maksimum tamu. Data ini tidak terlalu 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 metadata. Untuk informasi selengkapnya, lihat Menentukan metadata kamar dan paket.
Elemen root pesan Transaksi adalah <Transaction>. Pesan yang menggunakan elemen <Transaction> sebagai elemen root memerlukan setidaknya satu elemen turunan. Pesan transaksi dapat memiliki berapa pun elemen turunan, asalkan 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 Mode Pengiriman Harga.
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, biasanya beberapa ratus milidetik, iklan Anda dapat muncul di lelang. Hasil Anda juga dapat lebih cocok dengan pelanggan, termasuk 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, tetapi 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 berpotensi menghindari masalah ukuran dan waktu tunggu pesan, gunakan pesan Transaksi untuk menentukan terlebih dahulu metadata kamar dan paket.
Anda juga dapat menambahkan konten zip GNU ke pesan dengan menambahkan Content-Encoding: gzip ke header pesan.