Pesan Respons Petunjuk

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 akan mengirimkan <Query> yang mengambil data harga yang diperbarui untuk hotel dan itinerari yang ditunjukkan.

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 agar 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/respons itinerari pasti

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. Kumpulan itinerari yang sebenarnya diambil adalah fungsi dari kumpulan tanggal dengan perubahan dan lama menginap 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