Halaman ini diterjemahkan oleh Cloud Translation API.

Pesan Kueri

Pesan kueri adalah permintaan dari Google untuk pembaruan harga atau metadata. Mereka digunakan dengan harga Pull dan Harga yang Diubah mode pengiriman.

Elemen root pesan Kueri adalah <Query>.

Struktur pesan Kueri bergantung pada jenis pesan:

Harga: Google mengirimkan pesan Kueri yang meminta pembaruan harga untuk hotel-hotel tertentu.
Metadata: Google mengirimkan pesan Kueri yang meminta data tentang kamar dan informasi 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. Sampel tersebut kueri mungkin atau 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 atau 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:

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 merespons.
Dengan Konteks: Jika diaktifkan, rekomendasi konteks pengguna akan disertakan dalam setiap kueri yang dikirimkan Google kepada Anda, dan rekomendasi mencerminkan jenis pengguna umum yang menelusuri properti atau itinerari tertentu kombinasi. Mengikuti rekomendasi ini dapat meningkatkan efisiensi tanggapan Anda.
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 saat ini, Google meminta pembaruan harga dari Anda pada saat melakukan penelusuran. 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 ditetapkan dalam kueri Harga real time permintaan. 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 bersifat kontekstual dan dapat mengambil harga untuk parameter berikut: negara pengguna, jenis perangkat, tingkat keterisian (jumlah tamu), dan apakah tamu tersebut adalah dewasa atau anak-anak. Dengan kueri harga real time, Anda dapat menampilkan harga terbaru yang lebih sesuai dengan penelusuran pelanggan.

Kueri harga real time dimaksudkan sebagai mekanisme sekunder untuk penetapan harga pembaruan. Mekanisme utama penetapan ulang harga masih melalui Pull atau Diubah penetapan harga. Kueri harga real time membantu mengisi kesenjangan yang tidak dimiliki Google harga untuk kombinasi hotel atau itinerari.

Aturan untuk menggunakan kueri Harga real time

Tidak ada data yang di-cache untuk itinerari yang diberikan karena itinerari yang diminta tidak biasa, seperti tanggal yang masih sangat jauh di masa depan atau hotelnya 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. Dapat meminta satu hotel atau itinerari hotel, serta kombinasi multi-hotel atau satu itinerari.

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. Baik Pesan Kueri dan pesan Transaksi diperluas untuk menyertakan <Context> yang menentukan parameter kueri. Harga diterima dari Kueri harga real time dengan konteks dapat di-cache sebagai Paket Kamar, jika itu adalah harga untuk jumlah tamu tertentu dan sebagai Tarif Bersyarat, jika itu untuk negara pengguna atau perangkat pengguna.

Dengan kueri Konteks

Kueri Konteks merupakan permintaan rutin untuk memperbarui database kami untuk kombinasi properti atau itinerari yang ditentukan. Berisi daftar pengguna konteks 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 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 dalam elemen <Result>.

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

Kueri kontrol

Bagian ini menjelaskan cara mengontrol properti dan itinerari mana dapat menjadi subjek pesan Kueri dari Google.

Batas itinerari

Anda menentukan batas yang mungkin dari 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 menunjukkan beberapa contoh pesan Kueri harga dan metadata Pesan kueri. 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 dari 500 md:

<?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 di Harga & Referensi XML 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 Konteks, kueri hanya menentukan 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 jenis petunjuk yang Anda gunakan untuk rentang tanggal check-in, persis itinerari, 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 menampilkan pesan <Query> harga untuk rentang masa inap:

<?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 metadata pembaruan 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 informasi selengkapnya, lihat Menentukan metadata paket dan kamar.