Ringkasan Pesan Transaksi

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

  • Data itinerari: Menentukan Paket Kamar dan data terkait itinerari seperti:

    • 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 men-cache konten pesan Transaksi Anda agar harga selalu tersedia. Dalam beberapa kasus, Google menentukan bahwa nilai dalam cache 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>.

  • Metadata kamar dan paket: Menentukan detail tentang kamar dan paket, seperti deskripsi, foto, serta jumlah tamu maksimum. Data ini tidak terlalu 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 sejumlah elemen turunan, selama ukuran total pesan tidak melebihi 100 MB.

Contoh pesan transaksi yang merespons permintaan oleh Google dapat ditemukan di 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 serta merespons <HintRequest> dan <Query>.

Untuk mengetahui informasi selengkapnya, lihat Memilih 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 (biasanya beberapa ratus milidetik), maka 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.