Pesan Kueri

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 Live Kueri Harga selama konfigurasi awal. Untuk informasi selengkapnya, hubungi Manajer Akun Teknis (TAM) Anda.

Google mengirim pesan Kueri sebagai permintaan POST HTTP dengan Content-Type header disetel ke "application/xml" dan header User-Agent disetel ke Google-HotelAdsPrices. Pengecualian terhadap aturan ini terjadi selama pengujian manual integrasi endpoint harga melalui Google-TravelAds-Live. Kueri sampel tersebut mungkin atau mungkin tidak berisi header User-Agent.

Format detail untuk pesan Kueri dapat ditemukan di Referensi XML Kueri.

Pesan kueri harga

Pesan Kueri Harga menentukan kombinasi properti dan itinerari yang Anda menyediakan harga.

Saat menerima pesan Kueri harga, server harus merespons dengan Pesan <Transaction> yang berisi informasi harga yang diminta.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Harga.

Ada tiga jenis pesan Kueri khusus:

1. Harga real time: Jika diaktifkan, kueri akan dikirim saat pengguna aktif menelusuri harga untuk kombinasi properti atau itinerari yang ditentukan dan Anda memiliki jangka waktu tertentu untuk menanggapi.

2. Dengan Konteks: Jika diaktifkan, rekomendasi konteks pengguna akan disertakan dalam setiap kueri yang dikirim Google kepada Anda dan rekomendasi tersebut mencerminkan jenis pengguna yang paling umum yang menelusuri properti atau kombinasi itinerari tertentu. Dengan mengikuti rekomendasi ini, efisiensi respons Anda dapat meningkat.

3. Metadata: Ini adalah permintaan terkait detail tentang kamar dan paket untuk properti tertentu.

Kueri harga real time

Kueri harga real time adalah permintaan dari Google untuk pembaruan harga real-time dalam terhadap penelusuran pengguna. Google menerima permintaan penelusuran dari pengguna untuk kombinasi hotel atau itinerari, dan karena data harga tidak tersedia atau tidak aktual, Google meminta pembaruan harga dari Anda saat penelusuran dilakukan. Dengan Kueri harga real time, Google berupaya mendapatkan harga dan menampilkannya di hasil penelusuran pada saat dilakukannya.

Semua permintaan kueri harga real time memiliki batas waktu respons yang biasanya hingga 4000 milidetik. Batas ini ditentukan dalam permintaan kueri harga Real Time. Jika respons tidak dapat diberikan dalam batas waktu yang diberikan, partisipasi yang terlewat untuk peluang tertentu. Namun, sebaiknya memberikan harga agar dapat di-cache dan digunakan untuk peluang di masa mendatang. Sambungan untuk respons tetap terbuka selama sepuluh menit atau yang ditentukan dalam konfigurasi partner.

Kueri harga real time juga kontekstual dan dapat mengambil harga untuk parameter berikut: negara pengguna, jenis perangkat, tingkat keterisian (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 pengaturan ulang harga masih melalui harga Pull atau yang Diubah. Kueri harga real time membantu mengisi kesenjangan yang tidak dimiliki Google harga untuk kombinasi hotel atau itinerari.

Poin Penting: Karena Pengalaman Penelusuran Baru, Kueri Real Time tidak lagi tersedia saat pengguna berada di negara EEA dan mengalami masalah kueri navigasi (khusus hotel) dengan tanggal atau perubahan tanggal dalam penelusuran halaman hasil penelusuran.

Aturan untuk menggunakan Kueri harga real time

• Tidak ada data yang di-cache untuk itinerari yang ditentukan karena itinerari yang diminta tidak standar, seperti tanggal yang sangat jauh 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. Aktif kueri harga hanya diminta untuk tanggal non-default.

Google biasanya meng-cache hasil Harga real time agar hotel atau itinerari tidak dikueri lagi. Kueri ini dapat meminta kombinasi hotel atau itinerari tunggal serta kombinasi multi-hotel atau itinerari tunggal.

Fitur Harga real time dengan Konteks memungkinkan Google untuk mengirimkan Permintaan harga real time berdasarkan jenis perangkat pengguna dan negara asal yang mereka telusuri, dan jumlah penghuni 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 untuk negara pengguna atau perangkat pengguna.

Dengan Kueri konteks

Dengan Kueri konteks adalah permintaan rutin untuk memperbarui database kami untuk kombinasi properti atau itinerari yang ditentukan. File ini berisi daftar konteks pengguna yang populer untuk kombinasi tersebut. Jika Tarif Bersyarat digunakan, lalu mengirimkan tarif untuk semua konteks pengguna yang mungkin mahal, oleh karena itu Anda dapat gunakan daftar konteks pengguna ini untuk membatasi respons Anda. Menampilkan harga hanya untuk konteks pengguna yang ditentukan mencakup sebagian besar kueri pengguna yang relevan.

Jika Anda tertarik untuk menerima kueri Dengan Konteks, hubungi tim Teknis Pengelola Akun (TAM). Mereka dapat mengonfirmasi bahwa Anda siap untuk menerima lalu buat penyesuaian konfigurasi untuk mulai mengirimkan konteks pengguna kueri kepada Anda.

Poin Penting: Bahasa tidak ditentukan dalam pesan permintaan Dengan Konteks. Jadi, jika Anda tentukan <LanguageCode> dalam aturan tarif Anda, lalu respons Dengan Konteks harus mencakup semua tarif spesifik per bahasa yang relevan. Jika tidak yakin, sebaiknya gunakan kondisi negara, bukan kondisi bahasa, untuk menentukan asal atau kewarganegaraan pengguna. Namun, jika Anda memiliki tarif yang khusus untuk bahasa utama pengguna, gunakan kondisi bahasa.

Pesan kueri metadata

Pesan kueri metadata berisi detail tentang informasi kamar dan paket untuk properti yang ditentukan.

Saat menerima pesan Kueri metadata, Anda harus merespons dengan pesan <Transaction> yang menentukan harga untuk properti yang diminta dalam elemen <Result>.

Untuk mengetahui informasi selengkapnya, lihat Menentukan metadata paket dan kamar.

Mengontrol kueri

Bagian ini menjelaskan cara mengontrol properti dan itinerari mana 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 panjang masa inap maksimum yang Anda dukung.

Anda dapat menetapkan nilai default untuk <MaxAdvancePurchase> dan <MaxLengthOfStay> yang berlaku untuk semua kombinasi hotel atau itinerari. Anda juga bisa menentukan setelan 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 menampilkan <Query> harga 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 untuk kueri ini dapat ditemukan dalam Referensi XML Harga & Inventaris Kamar (Transaksi).

Dengan contoh kueri Context

Contoh berikut menampilkan contoh kueri Dengan 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 tentukan konteks negara pengguna. Di masa mendatang, seperti kueri juga dapat 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 pasti, atau itinerari dengan rentang. Untuk informasi selengkapnya tentang masing-masing jenis petunjuk, lihat Pesan Respons Petunjuk.

Contoh berikut menampilkan pesan <Query> harga untuk tanggal check-in rentang:

<?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 masa inap berikut (untuk masing-masing 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 menunjukkan pesan <Query> harga untuk rentang tanggal menginap:

<?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 tanggal menginap yang dimulai sebelum (tetapi termasuk) malam berikut:

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 perlu merespons jenis pesan Kueri ini dengan pesan Transaksi yang menentukan metadata kamar dan paket. Untuk informasi selengkapnya, lihat Menentukan metadata paket dan kamar.