Pesan Respons Petunjuk

Saat Google mengirimkan 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 ringkasan proses penentuan ulang harga, lihat Memperbarui Harga.

Pesan Respons Petunjuk dapat menggunakan metode berikut untuk menentukan hotel dan itinerari mana yang harus ditentukan ulang harganya oleh Google:

Lama menginap default saat menggunakan petunjuk adalah 5 hari.

Elemen root pesan Respons Petunjuk adalah <Hint>. Anda meminta hotel/itinerari agar diperbarui menggunakan satu atau beberapa elemen <Item>. Satu pesan Respons Petunjuk dapat menentukan sejumlah elemen <Item>.

Setiap pesan Respons Petunjuk harus menentukan minimal 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 itinerari dengan rentang untuk penetapan ulang harga.

Alur permintaan/respons itinerari pasti

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

Pesan Respons Petunjuk berikut menentukan satu properti dan satu itinerari:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2014-06-10</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

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

<Query>
  <Checkin>2014-06-10</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Kemudian, Anda diharapkan untuk membuat <Transaction> dengan pembaruan harga hotel untuk lama menginap berikut:

6/10/14 - 6/13/14

Alur permintaan/respons 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 untuk hotel yang dimulai dengan tanggal tersebut, dan memperpanjang hingga lama menginap yang Anda tentukan.

Contoh pesan Respons Petunjuk berikut menentukan satu properti dengan rentang tanggal check in:

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2014-06-10</FirstDate>
    <LastDate>2014-06-13</LastDate>
  </Item>
</Hint>

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

<Query>
  <FirstDate>2014-06-10</FirstDate>
  <LastDate>2014-06-12</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Anda diharapkan untuk membuat <Transaction> dengan pembaruan harga hotel tersebut untuk lama menginap berikut:

6/10/14 - 6/11/14
6/10/14 - 6/12/14
6/10/14 - 6/13/14
6/10/14 - 6/14/14
6/10/14 - 6/15/14

6/11/14 - 6/12/14
6/11/14 - 6/13/14
6/11/14 - 6/14/14
6/11/14 - 6/15/14
6/11/14 - 6/16/14

6/12/14 - 6/13/14
6/12/14 - 6/14/14
6/12/14 - 6/15/14
6/12/14 - 6/16/14
6/12/14 - 6/17/14

Contoh ini menggunakan lama menginap default, 5 malam.

Alur permintaan/respons itinerari dengan rentang (atau rentang menginap)

Pesan Respons Petunjuk dapat mencakup rentang malam untuk itinerari. Ini akan memberi tahu Google bahwa Google harus mengambil itinerari apa pun yang berisi malam tersebut. Kumpulan itinerari yang sebenarnya diambil adalah fungsi dari kumpulan malam dengan harga yang diubah dan lama menginap maksimum.

Contoh pesan Respons Petunjuk berikut menggunakan rentang menginap:

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2014-06-10</FirstDate>
      <LastDate>2014-06-13</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

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

<Query>
  <FirstDate>2014-06-10</FirstDate>
  <LastDate>2014-06-13</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

Kemudian, Anda diharapkan untuk membuat <Transaction> dengan pembaruan harga hotel untuk lama menginap berikut:

6/07/14 - 6/10/14

6/08/14 - 6/10/14
6/08/14 - 6/11/14

6/09/14 - 6/10/14
6/09/14 - 6/11/14
6/09/14 - 6/12/14

6/10/14 - 6/11/14
6/10/14 - 6/12/14
6/10/14 - 6/13/14

6/11/14 - 6/12/14
6/11/14 - 6/13/14
6/11/14 - 6/14/14

6/12/14 - 6/13/14
6/12/14 - 6/14/14
6/12/14 - 6/15/14

6/13/14 - 6/14/14
6/13/14 - 6/15/14
6/13/14 - 6/16/14

Perhatikan bahwa dengan rentang menginap, semua itinerari, termasuk itinerari yang dimulai sebelum tanggal pertama tetapi tumpang-tindih dengan jadwal tersebut, harus ditentukan ulang harganya.