Pesan kueri adalah permintaan dari Google untuk pembaruan harga atau metadata. Keduanya digunakan dengan mode pengiriman Pull dan Harga yang Diubah.
Elemen root pesan Kueri adalah <Query>.
Struktur pesan Kueri bergantung pada jenis pesan:
Harga: Google mengirimkan pesan Kueri yang meminta pembaruan harga untuk hotel yang ditentukan.
Metadata: Google mengirimkan pesan Kueri yang meminta data tentang informasi kamar dan paket di hotel yang ditentukan.
Anda menentukan endpoint yang digunakan Google untuk pesan Kueri dan Kueri Harga Real Time selama konfigurasi awal. Untuk informasi selengkapnya, hubungi Manajer Akun Teknis (TAM).
Google mengirimkan pesan Kueri sebagai permintaan POST HTTP dengan header Content-Type
ditetapkan ke "application/xml" dan header User-Agent ditetapkan ke
Google-HotelAdsPrices. Pengecualian untuk aturan ini terjadi selama pengujian manual
integrasi endpoint harga melalui Google-TravelAds-Live. Kueri contoh tersebut mungkin atau mungkin tidak berisi header User-Agent.
Format mendetail untuk pesan Kueri dapat ditemukan di Referensi XML Kueri.
Pesan kueri harga
Pesan Kueri Harga menentukan kombinasi properti atau itinerari yang Anda berikan harganya.
Saat menerima pesan Kueri pricing, server Anda harus merespons dengan pesan <Transaction> yang berisi informasi harga yang diminta.
Untuk mengetahui informasi selengkapnya, lihat Ringkasan Harga.
Ada tiga jenis khusus pesan Kueri:
Harga real time: Jika diaktifkan, kueri akan dikirim saat pengguna secara aktif menelusuri harga untuk kombinasi properti atau itinerari yang ditentukan dan Anda memiliki jangka waktu yang ditentukan untuk merespons.
Dengan Konteks: Jika diaktifkan, rekomendasi konteks pengguna disertakan dalam setiap kueri yang dikirimkan Google kepada Anda dan rekomendasi akan mencerminkan jenis pengguna paling umum yang menelusuri kombinasi properti atau itinerari tertentu. Mengikuti rekomendasi ini dapat meningkatkan efisiensi respons Anda.
Metadata: Ini adalah permintaan untuk detail tentang kamar dan paket untuk properti yang ditentukan.
Kueri harga real time
Kueri harga real time adalah permintaan dari Google untuk pembaruan harga real-time sebagai respons terhadap penelusuran pengguna. Google menerima permintaan penelusuran dari pengguna untuk kombinasi hotel atau itinerari, dan karena data harga tidak tersedia atau tidak aktual, Google akan meminta pembaruan harga dari Anda pada saat penelusuran. Dengan kueri harga real time, Google mencoba mendapatkan harga dan menampilkannya di hasil pada saat penelusuran.
Semua permintaan kueri Harga real time memiliki batas waktu respons yang biasanya hingga 4.000 milidetik. Batas ini ditentukan dalam permintaan kueri Harga real time. Jika respons tidak dapat diberikan dalam batas waktu, hal ini akan mengakibatkan partisipasi yang terlewat untuk peluang tertentu. Namun, sebaiknya berikan harga agar dapat di-cache dan digunakan untuk peluang mendatang. Koneksi untuk respons akan tetap terbuka selama sepuluh menit atau seperti yang ditentukan dalam konfigurasi partner.
Kueri harga real time juga bersifat kontekstual dan dapat mengambil harga untuk parameter berikut: negara pengguna, jenis perangkat, jumlah tamu (jumlah tamu), dan apakah tamu tersebut adalah orang dewasa atau anak-anak. Dengan kueri Harga real time, Anda dapat menampilkan lebih banyak harga terbaru yang sesuai dengan apa yang ditelusuri pelanggan.
Kueri harga real time dimaksudkan sebagai mekanisme sekunder untuk pembaruan harga. Mekanisme utama untuk penetapan ulang harga masih melalui harga Pull atau Harga yang Diubah. Kueri harga real time membantu mengisi kesenjangan saat Google tidak memiliki harga untuk kombinasi hotel atau itinerari.
Aturan untuk menggunakan kueri Harga real time
Tidak ada data yang di-cache untuk itinerari yang ditentukan karena itinerari yang diminta tidak biasa, seperti tanggal di masa mendatang atau hotel sangat jarang ditelusuri.
Tanggal yang diminta adalah tanggal non-default.
: Catatan: Tanggal default tidak memenuhi syarat untuk kueri Harga real time. Kueri harga real time hanya diminta untuk tanggal non-default.
Google biasanya meng-cache hasil Harga real time sehingga hotel atau itinerari yang sama tidak akan dikueri lagi. Fungsi ini dapat meminta kombinasi hotel tunggal atau itinerari serta kombinasi multi-hotel atau itinerari tunggal.
Fitur Harga real time dengan Konteks memungkinkan Google mengirimkan permintaan Harga real time tertentu berdasarkan jenis perangkat pengguna, negara tempat mereka melakukan penelusuran, dan jumlah tamu termasuk anak-anak. Pesan Kueri dan pesan Transaksi diperluas untuk menyertakan elemen <Context> yang menentukan parameter kueri. Harga yang diterima dari kueri harga real time dengan konteks dapat di-cache sebagai Paket Kamar, jika merupakan harga untuk jumlah tamu tertentu dan sebagai Tarif Bersyarat, jika ditujukan untuk negara pengguna atau perangkat pengguna.
Dengan kueri Konteks
Kueri Konteks adalah permintaan rutin untuk memperbarui database kami untuk kombinasi properti atau itinerari yang ditentukan. Template ini berisi daftar konteks pengguna yang populer untuk kombinasi tersebut. Jika Tarif Bersyarat digunakan, tarif pengiriman untuk semua konteks pengguna yang memungkinkan mungkin mahal. Oleh karena itu, Anda dapat menggunakan daftar konteks pengguna ini untuk membatasi respons. Menampilkan harga hanya untuk konteks pengguna tertentu mencakup sebagian besar kueri pengguna yang relevan.
Pesan kueri metadata
Pesan kueri metadata berisi detail tentang informasi paket dan kamar untuk properti yang ditentukan.
Saat menerima pesan Kueri metadata, Anda harus merespons dengan pesan <Transaction> yang menentukan harga untuk properti yang diminta di elemen <Result>.
Untuk mengetahui informasi selengkapnya, lihat Menentukan metadata kamar dan paket.
Kueri kontrol
Bagian ini menjelaskan cara Anda mengontrol properti dan itinerari mana yang dapat menjadi subjek pesan Kueri dari Google.
Batas itinerari
Anda menentukan kemungkinan batas kueri harga menggunakan <ItineraryCapabilities>. Anda menentukan aturan yang menentukan rentang tanggal dan lama menginap maksimum yang Anda dukung.
Anda dapat menetapkan nilai default untuk <MaxAdvancePurchase> dan <MaxLengthOfStay> yang berlaku untuk semua kombinasi hotel atau itinerari. Anda juga dapat menentukan
pengaturan ini untuk grup hotel.
Contoh pesan kueri
Bagian ini menampilkan beberapa contoh pesan Kueri harga dan pesan Kueri metadata. Contoh tambahan dapat ditemukan di Referensi XML Kueri.
Contoh itinerari
Contoh berikut menunjukkan harga <Query> yang meminta pembaruan harga untuk 4 hotel, tersedia untuk 3 malam, dan mulai 23 Mei 2023:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
Contoh ini meminta pembaruan harga untuk setiap hotel:
5/23/18 - 6/26/18
Contoh kueri harga real time
Contoh berikut menunjukkan kueri Harga real time dengan batas waktu respons 500 milidetik:
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
be configured to be displayed, on request, by Google. This attribute is only
displayed for a Live Pricing Query request -->
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
received by. This element is only displayed for a Live Pricing Query request -->
<PropertyList>
<Property>6781291</Property>
</PropertyList>
<!-- Note that Context tags are potentially repeatable -->
<Context>
<!-- The total number of guests occupying the room (adults+children) -->
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
<Children>
<Child age="5"/>
</Children>
</OccupancyDetails>
<!-- The user was located in the US when this search was made -->
<UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
<UserDevice>mobile</UserDevice>
</Context>
</Query>
Contoh ini meminta harga untuk satu hotel:
6/23/23 - 6/25/23
Contoh respons pesan transaksi terhadap kueri ini dapat ditemukan di Referensi XML Harga & Inventaris Kamar (Transaksi).
Dengan contoh kueri Konteks
Contoh berikut menampilkan contoh Dengan kueri Konteks:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<PropertyContextList>
<PropertyContext>
<Property>8675309</Property>
<!-- In the future, occupancy and device might be specified -->
<Context><UserCountry>US</UserCountry></Context>
<Context><UserCountry>GB</UserCountry></Context>
</PropertyContext>
<PropertyContext>
<Property>8675310</Property>
<Property>8675311</Property>
<Context><UserCountry>CA</UserCountry></Context>
</PropertyContext>
</PropertyContextList>
</Query>
Dengan kueri Konteks hanya menentukan konteks negara pengguna. Di masa mendatang, kueri tersebut mungkin juga menentukan perangkat pengguna dan jumlah tamu.
Rentang tanggal check-in
Jika Anda menggunakan Harga yang Diubah, struktur pesan Kueri bergantung pada jenis petunjuk yang Anda gunakan untuk rentang tanggal check-in, itinerari yang tepat, atau itinerari dengan rentang. Untuk mengetahui informasi selengkapnya tentang setiap jenis petunjuk ini, lihat Pesan Respons Petunjuk.
Contoh berikut menampilkan pesan <Query> harga untuk rentang tanggal check in:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
Contoh ini meminta pembaruan harga untuk tanggal menginap berikut (untuk setiap hotel):
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Menginap dengan Rentang
Contoh berikut menampilkan pesan <Query> harga untuk menginap dengan rentang:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
Contoh ini meminta pembaruan harga untuk setiap hotel:
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Plus masa inap yang dimulai sebelum (tetapi termasuk) malam tertentu:
5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
Pesan kueri metadata
Contoh berikut menampilkan pesan <Query> yang meminta pembaruan metadata untuk informasi kamar dan paket untuk beberapa properti:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
Anda merespons jenis pesan Kueri ini dengan pesan Transaksi yang menentukan metadata kamar dan paket. Untuk mengetahui informasi selengkapnya, lihat Menentukan metadata kamar dan paket.