Bagian ini menyediakan referensi untuk pesan Permintaan Petunjuk, pesan Respons Petunjuk, dan pesan Kueri berbasis XML Google.
<Hint>
(Pesan Respons Petunjuk)
Elemen root pesan Respons Petunjuk. Pesan Respons Petunjuk menentukan kombinasi hotel/itinerari mana yang perlu ditetapkan ulang harganya. Pesan ini adalah respons Anda terhadap pesan Permintaan Petunjuk dari Google.
Pesan Respons Petunjuk hanya boleh menentukan hotel yang harganya telah berubah sejak terakhir kali Google menerima Respons Petunjuk yang berhasil dari server Anda.
Pesan Respons Petunjuk menggunakan salah satu metode berikut untuk menentukan hotel dan itinerari mana yang harus ditentukan ulang harganya oleh Google:
Itinerari yang tepat: Kombinasi tanggal check-in dan lama menginap.
Rentang tanggal check-in: Menentukan rentang tanggal check-in, yang dimulai dengan tanggal check-in pertama dan diakhiri dengan tanggal check-in terakhir.
Menginap dengan rentang (atau itinerari dengan rentang)
Setiap metode ini memerlukan sintaksis yang berbeda untuk pesan Respons Petunjuk.
Untuk mengetahui informasi selengkapnya, lihat Pesan Respons Petunjuk.
Sintaksis
Elemen <Hint>
menggunakan sintaksis yang berbeda, bergantung pada jenis pesan Respons Petunjuk:
Itinerari pasti
Berikut adalah sintaksis untuk itinerari yang tepat dalam pesan Respons Petunjuk:
<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<Property>hotel_ID</Property>
...
<Stay>
<CheckInDate>checkin_date</CheckInDate>
<LengthOfStay>number_of_nights</LengthOfStay>
</Stay>
</Item>
...
</Hint>
Rentang check-in
Berikut adalah sintaksis untuk rentang check-in dalam pesan Respons Petunjuk:
<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<!-- At least one is required -->
<!-- Can be > 1 if MultipleItineraries is "checkin_range" in your
QueryControl message -->
<Property>hotel_ID</Property>
[...]
<!-- Required -->
<FirstDate>first_checkin_date</FirstDate>
<!-- Required -->
<LastDate>last_checkin_date</LastDate>
</Item>
...
</Hint>
Dengan rentang menginap
Berikut adalah sintaksis untuk menginap dengan rentang pada pesan Respons Petunjuk:
<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<!-- At least one is required -->
<!-- Can be > 1 if MultipleItineraries is "affected_dates" in your
QueryControl message -->
<Property>hotel_ID</Property>
[...]
<StaysIncludingRange>
<!-- Required -->
<FirstDate>first_date</FirstDate>
<!-- Optional -->
<LastDate>last_date</LastDate>
</StaysIncludingRange>
</Item>
...
</Hint>
Atribut
Elemen <Hint>
berisi atribut opsional: id
. Jika
disediakan, atribut ini akan disertakan sebagai atribut hintId
dalam pesan <Query>
yang dikirim berdasarkan <Hint>
ini.
Elemen turunan
Elemen <Hint>
memiliki elemen turunan berikut:
Elemen Turunan | Wajib diisi? | Jenis | Jenis Respons Petunjuk | Deskripsi |
---|---|---|---|---|
<CheckInDate> | Required | Date | Itinerari pasti | Tanggal check-in untuk itinerari. |
<FirstDate> | Required | Date | Rentang check-in dan itinerari dengan rentang | Tanggal pertama rentang tanggal untuk pesan Respons Petunjuk rentang check-in atau menginap dengan rentang. Tanggal bersifat inklusif. |
<Item> | Required | Object | Semua | Container untuk hotel/itinerari yang akan diperbarui. |
<LastDate> | Required* | Date | Rentang check-in dan itinerari dengan rentang | Tanggal terakhir dari rentang tanggal untuk pesan Respons Petunjuk rentang check-in atau menginap dengan rentang. Tanggal bersifat inklusif. * Elemen ini bersifat opsional untuk menginap dengan rentang. |
<LengthOfStay> | Required | integer | Itinerari persis | Jumlah malam untuk itinerari, yang dinyatakan sebagai bilangan bulat positif. |
<Property> | Required | string | Semua | ID hotel, yang menggunakan ID yang sama seperti Daftar Hotel. Jumlah elemen
|
<Stay> | Required | Object | Itinerari pasti | Container untuk elemen <CheckinDate> dan <LengthOfStay> dalam pesan Respons Petunjuk itinerari yang tepat. Setiap <Item> hanya dapat berisi satu
<Stay> . |
<StaysIncludingRange> | Required | Object | Itinerari dengan rentang | Penampung untuk elemen <FirstDate> dan <LastDate> dalam pesan Respons Petunjuk menginap dengan rentang. |
Contoh
Itinerari pasti
Contoh berikut menentukan beberapa itinerari untuk pesan Respons Petunjuk satu properti:
<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2018-07-03</CheckInDate>
<LengthOfStay>3</LengthOfStay>
</Stay>
</Item>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2018-07-03</CheckInDate>
<LengthOfStay>4</LengthOfStay>
</Stay>
</Item>
</Hint>
Rentang check-in
Contoh berikut menentukan dua hotel yang harganya telah berubah dan harus diambil lagi. Google mendapatkan semua itinerari antara 3 Juli dan 6 Juli untuk properti 12345 dan 67890:
<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<Property>12345</Property>
<Property>67890</Property>
<FirstDate>2018-07-03</FirstDate>
<LastDate>2018-07-06</LastDate>
</Item>
</Hint>
Perhatikan bahwa agar pesan rentang check-in dapat menentukan beberapa properti dalam satu <Item>
, nilai <MultipleItineraries>
dalam <QueryControl>
harus ditetapkan ke "checkin_range"
.
Dengan rentang menginap
Contoh berikut menunjukkan dua penggunaan menginap dengan rentang yang berbeda, satu untuk rentang malam dan lainnya untuk satu malam:
<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<!-- Google fetches prices for all itineraries (first and last date are set) -->
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2018-07-03</FirstDate>
<LastDate>2018-07-06</LastDate>
</StaysIncludingRange>
</Item>
<!-- Google fetches prices for a single night (first date only) -->
<Item>
<Property>67890</Property>
<StaysIncludingRange>
<FirstDate>2018-07-03</FirstDate>
</StaysIncludingRange>
</Item>
</Hint>
Perhatikan bahwa agar pesan menginap rentang dapat menentukan beberapa properti dalam satu <Item>
, nilai <MultipleItineraries>
dalam <QueryControl>
harus ditetapkan ke "affected_dates"
.
Untuk setiap contoh ini, Google merespons dengan <Query>
, kemudian Anda harus merespons dengan <Transaction>
yang menyertakan pembaruan harga untuk hotel/itinerari yang ditentukan.
<HintRequest>
Elemen root pesan Permintaan Petunjuk. Google mengirimkan pesan Permintaan Petunjuk ke server Anda dan mengharapkan respons yang menentukan hotel dan itinerari yang harganya telah berubah sejak terakhir kali Google menerima Respons Petunjuk yang berhasil dari server Anda.
Jika ada perubahan harga, Google akan mengirimkan <Query>
yang mengambil data harga yang diperbarui untuk hotel dan itinerari yang ditunjukkan.
Untuk mengetahui informasi selengkapnya, baca Pesan Permintaan Petunjuk.
Sintaksis
Elemen <HintRequest>
menggunakan sintaksis berikut:
Sintaksis
<?xml version="1.0" encoding="UTF-8"?>
<HintRequest>
<LastFetchTime>last_fetch_time</LastFetchTime>
</HintRequest>
Atribut
Elemen <HintRequest>
tidak memiliki atribut.
Elemen turunan
Elemen <HintRequest>
memiliki elemen turunan berikut:
Elemen Turunan | Jenis | Deskripsi |
---|---|---|
<LastFetchTime> | DateTime | Saat terakhir Google berhasil mendapatkan pesan Respons Petunjuk ke pesan Permintaan Petunjuk.
Jika waktu ini lebih lama dari waktu terakhir kali Anda memperbarui harga di server, Anda harus merespons dengan pesan Respons Petunjuk yang menentukan hotel yang telah berubah. Jika belum ada pengambilan terbaru yang berhasil, nilai ini akan ditetapkan ke nilai interval tetap (untuk menghindari masalah yang lebih serius dengan backlog yang besar). Nilai interval tetap saat ini adalah 1.000 detik, tetapi dapat berubah. Untuk mengetahui informasi selengkapnya, baca Pesan Respons Petunjuk. |
Contoh
Contoh berikut menampilkan pesan Permintaan Petunjuk:
Pesan Permintaan Petunjuk
Contoh berikut menampilkan pesan Permintaan Petunjuk:
<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="ABCDEF" timestamp="2018-06-07T16:20:00Z">
<LastFetchTime>2018-03-25T00:04:09Z</LastFetchTime>
</HintRequest>
<Query>
Elemen root pesan Query
. Query
pesan adalah permintaan dari Google untuk pembaruan harga atau metadata. Harga ini digunakan dengan mode pengiriman
harga Pull dan Harga yang Diubah.
Ada tiga jenis pesan Query
:
Harga real time: Google merespons permintaan pengguna tertentu untuk meminta pembaruan harga real-time. Saat partner menerima pesan
Live pricing query
, partner harus merespons dengan pesan<Transaction>
yang berisi informasi harga yang diminta di elemen<Result>
.Dengan harga konteks: Google memperbarui cache harga berdasarkan konteks yang secara historis populer. Saat menerima pesan
With context query
, Anda harus merespons dengan pesan<Transaction>
yang berisi informasi harga yang diminta di elemen<Result>
.Metadata: Google meminta pembaruan metadata untuk kamar dan Paket Kamar untuk hotel yang ditentukan. Saat menerima pesan
Metadata Query
, Anda harus merespons dengan pesan<Transaction>
yang menentukan data tentang kamar dan Paket Kamar di elemen<PropertyDataSet>
.
Untuk mengetahui informasi selengkapnya, baca Ringkasan harga untuk kueri harga dan metadata Paket Kamar untuk kueri metadata.
Sintaksis untuk ketiga jenis yang berbeda tersebut dijelaskan di bawah ini.
Sintaksis
Elemen <Query>
menggunakan sintaksis berikut:
Harga real time
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
<Checkin>YYYY-MM-DD</Checkin>
<Nights>number_of_nights</Nights>
<!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
<FirstDate>YYYY-MM-DD</FirstDate>
<LastDate>YYYY-MM-DD</LastDate>
<!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
<AffectedNights>number_of_nights</AffectedNights>
<PropertyList>
<Property>hotel_id</Property>
...
</PropertyList>
<!-- See documentation below for <Context> -->
<Context>
...
</Context>
</Query>
Dengan konteks
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>YYYY-MM-DD</Checkin>
<Nights>number_of_nights</Nights>
<!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
<FirstDate>YYYY-MM-DD</FirstDate>
<LastDate>YYYY-MM-DD</LastDate>
<!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
<AffectedNights>number_of_nights</AffectedNights>
<PropertyContextList>
<PropertyContext>
<Property>hotel_id</Property>
...
<!-- See documentation below for <Context> -->
<Context>
...
</Context>
</PropertyContext>
</PropertyContextList>
</Query>
Metadata
<HotelInfoProperties>
<Property>property_ID</Property>
...
</HotelInfoProperties>
Atribut
Elemen <Query>
dapat berisi satu atribut: latencySensitive
.
Atribut latencySensitive
bersifat opsional. Jika disediakan dan ditetapkan ke
true
, hal ini menunjukkan bahwa kueri tersebut adalah Live Pricing Query
. Agar Google mengirim kueri dengan atribut latencySensitive
, tanyakan kepada Manajer Akun Teknis (TAM) Anda.
Elemen turunan
Elemen <Query>
memiliki elemen turunan berikut:
Elemen Turunan | Jenis Kueri | Jenis | Deskripsi |
---|---|---|---|
<AffectedNights> | Pricing | integer | Jumlah malam untuk menginap dengan rentang. Elemen ini hanya digunakan untuk kueri harga Menginap dengan Rentang yang digunakan dengan Harga yang Diubah. |
<Checkin> | Pricing | Date | Tanggal perubahan harga tertentu. |
<Context> | Pricing (Live Pricing Queries only) | <Context> | Untuk Kueri Harga Real Time, tentukan parameter tertentu yang digunakan untuk membuat kueri. Elemen turunan meliputi:
Elemen |
<FirstDate> | Pricing | Date | Tanggal mulai untuk rentang itinerari saat harga diterapkan. Elemen ini hanya digunakan untuk kueri harga Rentang Tanggal Check-in yang digunakan dengan Harga yang Diubah. |
<HotelInfoProperties> | Metadata | string | Satu atau beberapa properti yang diinginkan Google untuk memperbarui metadata kamar dan Paket Kamar dalam pesan Query metadata. Elemen ini dapat berisi satu atau beberapa elemen <Property> yang menentukan ID properti hotel. |
<LastDate> | Pricing | Date | Tanggal akhir untuk rentang itinerari saat harga berlaku. Elemen ini hanya digunakan untuk kueri harga Rentang Tanggal Check-in yang digunakan dengan Pull + Petunjuk. |
<Nights> | Pricing | integer | Jumlah malam untuk itinerari tertentu, maksimal 30. |
<PropertyList> | Pricing | Object | Satu atau beberapa ID untuk hotel yang memerlukan pembaruan harga. Tentukan setiap hotel di elemen <PropertyList> <Property>pid1</Property> <Property>pid2</Property> </PropertyList> |
Contoh
Kueri harga
Contoh berikut menampilkan pesan Kueri harga yang meminta pembaruan harga untuk serangkaian hotel, yang tersedia untuk 3 malam, dan mulai 10 Juni 2018:
<?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>
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">
<Checkin>2017-06-07</Checkin>
<Nights>5</Nights>
<DeadlineMs>500</DeadlineMs>
<PropertyList>
<Property>8675309</Property>
</PropertyList>
<Context>
<Occupancy>4</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="8"/>
<Child age="5"/>
</Children>
</OccupancyDetails>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
</Query>
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>
Kueri metadata
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
Untuk contoh tambahan, termasuk kueri harga masa inap dengan rentang tanggal check-in dan rentang tanggal check-in, lihat contoh pesan Query
.
<Context>
Elemen <Context>
menjelaskan informasi untuk Live pricing query
,
termasuk jumlah dan jenis tamu, negara pengguna, dan perangkat pengguna.
Beberapa <Context>
tidak akan pernah digunakan dengan negara pengguna atau
perangkat pengguna yang berbeda. Jika beberapa <Context>
digunakan untuk mengkueri beberapa jumlah tamu, berikan harga setiap jumlah tamu sebagai Paket Kamar tambahan untuk properti/itinerari yang sesuai. Setiap properti/itinerari harus memiliki satu blok <Result>
dengan harga untuk beberapa jumlah tamu yang disertakan.
Untuk mengetahui detail respons untuk kueri <Context>
, lihat <OccupancyDetails>
.
Sintaksis
Elemen <Context>
menggunakan sintaksis berikut:
Sintaksis
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
<Checkin>date</Checkin>
<Nights>number_of_nights</Nights>
<DeadlineMs>number_of_milliseconds</DeadlineMs>
<PropertyList>
<Property>property_ID</Property>
</PropertyList>
<Context>
<Occupancy>total_number_of_guests</Occupancy>
<OccupancyDetails>
<NumAdults>number_of_adults</NumAdults>
<Children>
<Child age=age_of_one_child_guest/>
<Child age=age_of_one_child_guest/>
</Children>
</OccupancyDetails>
<UserCountry>end_user_country</UserCountry>
<UserDevice>user_device_type</UserDevice>
</Context>
</Query>
Elemen turunan
Elemen <Context>
memiliki elemen turunan berikut:
Elemen Turunan | Jenis kueri | Jenis | Deskripsi |
---|---|---|---|
<Occupancy> | Pricing | integer | Menentukan jumlah total tamu. Meskipun tidak wajib, kueri yang berisi Catatan: |
<OccupancyDetails> | Pricing | Object | Didahului oleh <Occupancy> . Menentukan tamu menurut jenis, termasuk:
Meskipun tidak wajib, kueri yang berisi Catatan: |
<UserCountry> | Pricing | string | Memfilter tarif berdasarkan negara tempat pengguna berada. Nilainya adalah
kode negara 2 huruf seperti Kueri dengan |
<UserDevice> | Pricing | string | Memfilter tarif berdasarkan jenis perangkat yang digunakan pengguna untuk melakukan penelusuran. Kemungkinan nilai:
Kueri yang berisi |
Contoh
Kehadiran
Contoh berikut menampilkan kueri Harga real time untuk <Occupancy>
dalam <Context>
. Kueri harga real time ditujukan untuk 3 tamu dewasa.
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<Checkin>2017-06-07</Checkin>
<Nights>4</Nights>
<DeadlineMs>500</DeadlineMs>
<PropertyList>
<Property>45617</Property>
</PropertyList>
<Context>
<Occupancy>3</Occupancy>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
</Query>
Detail hunian
Contoh berikut menunjukkan kueri Harga real time dengan <OccupancyDetails>
dalam <Context>
.
Kueri harga Live adalah untuk 4 tamu, 2 di antaranya adalah anak-anak, dan mencari tarif yang berlaku untuk pemesanan tamu di AS dari perangkat seluler:
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<Checkin>2017-06-07</Checkin>
<Nights>5</Nights>
<DeadlineMs>500</DeadlineMs>
<PropertyList>
<Property>8675309</Property>
</PropertyList>
<Context>
<Occupancy>4</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="4"/>
<Child age="12"/>
</Children>
</OccupancyDetails>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
</Query>
Berbagai konteks
Contoh berikut menunjukkan penggunaan elemen <Context>
tambahan dalam kueri Harga real time.
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<Checkin>2017-06-07</Checkin>
<Nights>4</Nights>
<DeadlineMs>500</DeadlineMs>
<PropertyList>
<Property>45617</Property>
</PropertyList>
<Context>
<Occupancy>3</Occupancy>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
<Context>
<Occupancy>6</Occupancy>
<OccupancyDetails>
<NumAdults>4</NumAdults>
<Children>
<Child age="6"/>
<Child age="10"/>
</Children>
</OccupancyDetails>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
</Query>