Google bir İpucu İsteği mesajı gönderdiğinde sunucularınız, Google'ın aynı sunuculardan başarılı bir İpucu Yanıtı almasından bu yana fiyatlarının değiştiği otelleri belirten bir İpucu Yanıtı mesajı ile yanıt vermelidir. Herhangi bir fiyat değişikliği varsa Google, belirtilen oteller ve seyahat planlarının güncellenmiş fiyatlandırma verilerini getiren bir <Query>
gönderir.
Yeniden fiyatlandırma işlemine genel bakış için Fiyatlandırmaya Genel Bakış konusuna bakın.
İpucu Yanıtı mesajları, seçilen otelleri ve seyahat planlarını yeniden fiyatlandırmak için aşağıdaki yöntemleri kullanır:
İpucu Yanıtı mesajının kök öğesi <Hint>
şeklindedir. Bir otelin veya seyahat planının güncellenmesini, bir veya daha fazla <Item>
öğesi kullanarak istersiniz. Tek bir İpucu Yanıtı mesajı, herhangi bir sayıda <Item>
öğesi tanımlayabilir.
Her İpucu Yanıtı mesajında her <Item>
için en az bir <Property>
öğesi belirtilmelidir. <Property>
, Otel Listesi ile aynı kimlikleri kullanarak bir oteli tanımlar. Varsayılan olarak, her bir <Item>
bloğu için tek bir otel kimliği belirtirsiniz. Ancak, yeniden fiyatlandırma için check-in tarih aralıkları veya aralıklı konaklama süreleri kullanıyorsanız Google'dan bir öğe bloğunda birden fazla otele izin vermesini isteyebilirsiniz.
Tam seyahat planı istek ve yanıt akışı
İpucu mesajları, giriş tarihi ve konaklama süresinin kombinasyonu gibi ayrı seyahat planlarına dayalı olabilir. Bu durumda, otelleriniz için check-in tarihi ve konaklama süresi belirtirsiniz. Google, söz konusu seyahat planı için yeni fiyatlandırma verilerini getirir.
Aşağıdaki İpucu Yanıtı mesajı tek bir tesis ve tek bir seyahat planı tanımlar:
<Hint>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2023-05-20</CheckInDate>
<LengthOfStay>3</LengthOfStay>
</Stay>
</Item>
</Hint>
Google, İpucu Yanıtı mesajınıza aşağıdakine benzer bir <Query>
ile yanıt verir:
<Query>
<Checkin>2023-05-20</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Daha sonra aşağıdaki konaklama için otelin fiyat güncellemeleriyle birlikte bir <Transaction>
oluşturmanız gerekir:
5/20/23 - 5/23/23
Check-in tarih aralıkları istek ve yanıt akışı
İpucu Yanıtı mesajı, ilk check-in tarihiyle başlayıp son check-in tarihiyle biten bir check-in tarihleri aralığı belirtebilir. Google yeni fiyatlandırma verilerini getirdiğinde, otel için bu tarihlerle başlayan ve belirttiğiniz konaklama süresine kadar uzanan her check-in tarihi için seyahat planlarını çeker.
Aşağıdaki örnek İpucu Yanıtı mesajı, check-in için bir tarih aralığı ile tek bir tesis tanımlar:
<Hint>
<Item>
<Property>12345</Property>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</Item>
</Hint>
Google, bu İpucu Yanıtı mesajına aşağıdakine benzer <Query>
ile yanıt verir:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<Nights>5</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Daha sonra bu otel için aşağıdaki konaklamalara yönelik fiyat güncellemeleriyle birlikte bir <Transaction>
oluşturmanız gerekir:
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
Bu örnekte 5 gecelik konaklama süresi kullanılmıştır. Varsayılan konaklama süresi 30 gündür.
Aralıklı konaklamalar istek ve yanıt akışı
İpucu Yanıtı mesajı, değişen bir tarih aralığı içerebilir. Bu şekilde Google, bu tarihlerden herhangi birinden etkilenen seyahat planını getirmesi gerektiği konusunda bilgilendirilir. Getirilen gerçek seyahat planları grubu, hem değişiklik yapılan tarihler kümesi hem de maksimum konaklama süresinden oluşan bir fonksiyondur.
Aşağıdaki örnek İpucu Yanıtı mesajında aralıklı konaklamalar kullanılır:
<Hint>
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</StaysIncludingRange>
</Item>
</Hint>
Google, İpucu Yanıtı mesajınıza aşağıdakine benzer bir <Query>
ile yanıt verir:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>12345</Property>
<Property>67891</Property>
</PropertyList>
</Query>
Daha sonra aşağıdaki konaklamalar için otelin fiyat güncellemeleriyle birlikte bir <Transaction>
oluşturmanız gerekir:
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