Saat Google mengirimkan Permintaan Petunjuk
pesan, server Anda
harus merespons dengan pesan Respons Petunjuk yang menentukan hotel yang
harga telah berubah sejak terakhir kali Google menerima Petunjuk yang berhasil
Respons dari server yang sama. Jika ada perubahan harga, Google
mengirimkan <Query>
yang mengambil data harga terbaru untuk harga
hotel, serta itinerari.
Untuk ringkasan proses penetapan ulang harga, lihat Ringkasan Harga.
Pesan Respons Petunjuk menggunakan metode berikut untuk menentukan ulang harga hotel yang dipilih dan itinerarinya:
Elemen root pesan Respons Petunjuk adalah <Hint>
. Anda meminta
hotel atau
itinerari diperbarui menggunakan satu atau beberapa elemen <Item>
. Satu Petunjuk
Pesan respons dapat menentukan sejumlah elemen <Item>
.
Setiap pesan Respons Petunjuk harus menentukan setidaknya satu elemen <Property>
untuk
setiap <Item>
. <Property>
mengidentifikasi hotel menggunakan ID yang sama seperti
Daftar Hotel. Secara default, Anda menentukan satu ID hotel untuk setiap <Item>
diblokir. Namun, Anda dapat menginstruksikan Google untuk mengizinkan beberapa hotel dalam satu item
blokir jika Anda menggunakan rentang tanggal check-in atau rentang masa inap untuk penetapan ulang harga.
Alur permintaan dan respons itinerari yang tepat
Pesan petunjuk dapat didasarkan pada itinerari individual seperti kombinasi tanggal check-in dan panjang masa inap. Dalam hal ini, Anda menentukan tanggal {i>check-in<i} dan lama menginap hotel Anda, dan Google mengambil data harga baru hanya itinerari tersebut.
Respons partner
Pesan Respons Petunjuk berikut menentukan satu properti dan satu properti itinerari:
<Hint>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2023-05-20</CheckInDate>
<LengthOfStay>3</LengthOfStay>
</Stay>
</Item>
</Hint>
Respons Google
Google merespons pesan Respons Petunjuk Anda dengan <Query>
yang mirip dengan
berikut ini:
<Query>
<Checkin>2023-05-20</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Buat <Transaction>
Kemudian, Anda diharapkan untuk membuat <Transaction>
dengan pembaruan harga untuk
hotel untuk masa inap berikut:
5/20/23 - 5/23/23
Alur permintaan dan respons rentang tanggal check-in
Pesan Respons Petunjuk dapat menentukan rentang tanggal {i>check-in<i}, dimulai dengan tanggal {i>check-in<i} pertama dan diakhiri dengan tanggal {i>check-in<i} terakhir. Ketika Google mengambil data harga baru, Google mengambil itinerari untuk setiap tanggal check-in hotel dimulai dari tanggal tersebut dan memanjang hingga panjang masa inap yang yang Anda tunjukkan.
Rentang tanggal partner
Contoh untuk pesan Respons Petunjuk berikut menentukan satu properti dengan rentang tanggal check-in:
<Hint>
<Item>
<Property>12345</Property>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</Item>
</Hint>
Respons Google
Google merespons pesan Respons Petunjuk ini dengan <Query>
yang mirip dengan
hal berikut:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<Nights>5</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Buat <Transaction>
Kemudian, Anda diharapkan untuk membuat <Transaction>
dengan pembaruan harga
untuk tamu hotel tersebut berikut ini:
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23
5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23
Contoh ini menggunakan panjang masa inap default 5 malam.
Alur permintaan dan respons masa inap dengan rentang
Pesan Respons Petunjuk dapat menyertakan rentang tanggal yang telah berubah. Ini memberi tahu Google agar mengambil itinerari yang terpengaruh oleh salah satu dari tanggal. Rangkaian itinerari sebenarnya yang diambil adalah fungsi dari kumpulan tanggal dengan perubahan dan panjang masa inap maksimum.
Rentang penginapan partner
Contoh pesan Respons Petunjuk berikut menggunakan rentang menginap:
<Hint>
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</StaysIncludingRange>
</Item>
</Hint>
Respons Google
Google merespons pesan Respons Petunjuk Anda dengan <Query>
yang mirip dengan
berikut ini:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>12345</Property>
<Property>67891</Property>
</PropertyList>
</Query>
Buat <Transaction>
Kemudian, Anda diharapkan untuk membuat <Transaction>
dengan pembaruan harga untuk
hotel untuk masa inap berikut:
5/17/23 - 5/20/23
5/18/23 - 5/20/23
5/18/23 - 5/21/23
5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/21/23 - 5/22/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
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23