Pesan transaksi mengirim data tentang kamar, harga, dan paket ke Google. Ada dua jenis utama pesan Transaksi:
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 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 akan menyimpan konten pesan Transaksi Anda ke dalam cache, sehingga harga tersebut selalu tersedia. Dalam beberapa kasus, Google menentukan bahwa nilai dalam cache-nya bukan yang terbaru, sehingga mungkin mengirim pesan
<Query>tambahan (atau dalam beberapa kasus, Kueri Harga Real Time) untuk mendapatkan harga terbaru. Data ini biasanya sangat sering berubah. Untuk menentukan harga dan ketersediaan pesan Transaksi, gunakan<Result>.
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 metadata. Untuk mengetahui informasi selengkapnya, lihat Menentukan metadata kamar dan paket.
Elemen root pesan Transaksi adalah <Transaction>. Pesan yang menggunakan elemen <Transaction> sebagai elemen root memerlukan setidaknya salah satu elemen turunan. Pesan transaksi dapat memiliki elemen turunan dalam jumlah berapa pun, selama total ukuran pesan tidak melebihi 100 MB.
Untuk melihat 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 mungkin juga 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 mereka, 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 untuk ukuran setiap pesan. Biasanya, semua Permintaan Pull dan Petunjuk memiliki batas waktu respons 100 detik. Waktu tunggu adalah kolom yang dapat dikonfigurasi dan dapat disesuaikan oleh Google seperti yang diminta. 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 serta waktu tunggu pesan, gunakan pesan Transaksi untuk menentukan terlebih dahulu metadata kamar dan paket Anda.
Anda juga dapat menambahkan konten yang di-zip GNU ke pesan dengan menambahkan Content-Encoding: gzip ke header pesan.