Pesan Respons Petunjuk

Saat Google mengirim pesan Permintaan Petunjuk, server Anda harus merespons dengan pesan Respons Petunjuk yang menentukan hotel yang harganya telah berubah sejak terakhir kali Google menerima Respons Petunjuk yang berhasil 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 mengetahui ringkasan proses penetapan ulang harga, lihat Ringkasan Harga.

Poin Penting: Jika Anda tidak menerapkan Harga yang Diubah, Google akan mengambil data untuk semua hotel di Daftar Hotel Anda.

Pesan Respons Petunjuk menggunakan metode berikut untuk mengubah harga hotel yang dipilih dan itinerarinya:

• Itinerari pasti
• Rentang tanggal check in
• Menginap dengan rentang

Catatan: Lama menginap default menggunakan Harga yang Diubah adalah 5 hari.

Elemen root pesan Respons Petunjuk adalah <Hint>. Anda meminta hotel atau itinerari diperbarui menggunakan satu atau beberapa elemen <Item>. Satu pesan Respons Petunjuk 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 dapat menentukan satu ID hotel untuk setiap blok <Item>. Namun, Anda dapat menginstruksikan Google untuk mengizinkan beberapa hotel dalam blok item jika Anda menggunakan rentang tanggal check-in atau menginap dengan rentang untuk penetapan ulang harga.

Alur permintaan dan respons itinerari yang tepat

Pesan petunjuk dapat didasarkan pada itinerari individual seperti kombinasi tanggal check-in dan lama menginap. Dalam hal ini, Anda menentukan tanggal check-in dan lama menginap untuk hotel Anda, dan Google akan mengambil data harga baru hanya untuk itinerari tersebut.

Respons partner

Pesan Respons Petunjuk berikut menentukan satu properti dan satu itinerari:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Respons Google

Google akan merespons pesan Respons Petunjuk Anda dengan <Query> seperti berikut:

<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 hotel untuk kunjungan berikut:

5/20/23 - 5/23/23

Alur respons dan permintaan rentang tanggal check-in

Pesan Respons Petunjuk dapat menentukan rentang tanggal check-in, dimulai dengan tanggal check-in pertama dan diakhiri dengan tanggal check-in terakhir. Saat Google mengambil data harga baru, Google mengambil itinerari untuk setiap tanggal check-in hotel yang dimulai dengan tanggal tersebut dan memperpanjang hingga lama menginap yang Anda tentukan.

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 akan merespons pesan Respons Petunjuk ini dengan <Query> seperti 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 masa inap berikut untuk hotel tersebut:

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 lama menginap default 5 malam.

Alur permintaan dan respons menginap dengan rentang

Pesan Respons Petunjuk dapat menyertakan rentang tanggal yang telah berubah. Tindakan ini akan memberi tahu Google bahwa Google harus mengambil itinerari apa pun yang terpengaruh oleh salah satu tanggal tersebut. Kumpulan itinerari sebenarnya yang diambil adalah fungsi dari kumpulan tanggal dengan perubahan dan lama menginap maksimum.

Rentang menginap 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 akan merespons pesan Respons Petunjuk Anda dengan <Query> seperti berikut:

<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 hotel untuk lama menginap 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

Catatan: Dengan menginap dengan rentang, semua itinerari termasuk itinerari yang dimulai sebelum tanggal pertama dan yang tumpang-tindih dengan itinerari tersebut harus diubah harga.