Sorgu mesajları, Google'ın fiyatlandırma veya meta veri güncellemeleri için yaptığı isteklerdir. Bunlar hem Çekme hem de Değiştirilen Fiyatlandırma iletim modlarıyla kullanılır.
<Query>, Sorgu mesajlarının kök öğesidir.
Sorgu mesajının yapısı, mesajın türüne bağlıdır:
Fiyatlandırma: Google, belirtilen oteller için fiyatlandırma güncellemeleri isteyen bir Sorgu mesajı gönderir.
Meta veri: Google, belirtilen otellerdeki oda ve paket bilgilerini isteyen bir Sorgu mesajı gönderir.
Google'ın Sorgu mesajları ve Gerçek Zamanlı Fiyatlandırma Sorguları için kullandığı uç noktayı ilk yapılandırmanız sırasında tanımlarsınız. Daha fazla bilgi için Teknik Hesap Yöneticinizle (THY) iletişime geçin.
Google, Content-Type üstbilgisi "application/xml" ve User-Agent üst bilgisi Google-HotelAdsPrices olarak ayarlanmış bir HTTP POST isteği olarak bir Sorgu mesajı gönderir. Bu kuralın istisnası, Google-TravelAds-Live üzerinden fiyat uç noktası entegrasyonunun manuel olarak test edilmesi sırasında ortaya çıkar. Bu örnek sorgular, User-Agent başlığını içerebilir veya içermeyebilir.
Sorgu mesajlarının ayrıntılı biçimlendirmesi Sorgu XML Referansı konusunda bulunabilir.
Fiyatlandırma sorgu mesajları
Fiyatlandırma Sorgusu mesajları, fiyatlarını sağladığınız tesis veya seyahat planı kombinasyonlarını belirtir.
Sunucunuz bir pricing Sorgusu mesajı aldığında, istenen fiyatlandırma bilgilerini içeren bir <Transaction> mesajıyla yanıt vermelidir.
Daha fazla bilgi için Fiyatlandırmaya Genel Bakış bölümüne bakın.
Üç özel Sorgu mesajı türü vardır:
Gerçek zamanlı fiyatlandırma: Bu seçenek etkinleştirilirse sorgular, kullanıcı belirtilen tesis veya seyahat planı kombinasyonu için fiyatlara aktif olarak göz atarken ve yanıt vermek için belirli bir zaman zamanınız varsa gönderilir.
Bağlam ile: Etkinleştirildiğinde, Google'ın size gönderdiği her sorguya kullanıcı bağlamı önerileri dahil edilir ve öneriler, belirli bir tesis veya seyahat planı kombinasyonlarını arayan en yaygın kullanıcı türlerini yansıtır. Bu önerileri uygulamanız, yanıtlarınızın verimliliğini artırabilir.
Meta veri: Belirtilen tesisler için oda ve paketlerle ilgili ayrıntılar isteğidir.
Gerçek zamanlı fiyatlandırma sorguları
Gerçek zamanlı fiyatlandırma sorguları, Google'ın kullanıcı aramalarına yanıt olarak gerçek zamanlı fiyat güncellemeleri için yaptığı isteklerdir. Google, kullanıcıdan otel veya seyahat planı kombinasyonu için arama isteği alır. Fiyatlandırma verisi mevcut veya güncel olmadığı için arama sırasında sizden fiyat güncellemesi ister. Gerçek zamanlı fiyatlandırma sorgulamasında Google, bir fiyat alıp bunu arama sırasında sonuçlarda göstermeye çalışır.
Tüm Gerçek zamanlı fiyatlandırma sorgu isteklerinin yanıt süresi sınırı vardır. Bu sınır genellikle 4.000 milisaniyedir. Bu sınır, Gerçek zamanlı fiyatlandırma sorgusu isteğinde belirtilir. Süre sınırı dahilinde yanıt verilemezse ilgili fırsat için katılımın kaçırılmasına neden olur. Ancak önbelleğe alınıp gelecekteki fırsatlarda kullanılabilmesi için yine de bir fiyat sağlamanızı öneririz. Yanıtın bağlantısı on dakika boyunca veya iş ortağının yapılandırmasında belirtildiği şekilde açık kalır.
Gerçek zamanlı fiyatlandırma sorguları aynı zamanda bağlamsaldır ve şu parametreler için fiyatları alabilir: kullanıcı ülkesi, cihaz türü, doluluk (konuk sayısı) ve bu konukların yetişkin mi yoksa çocuk mu olduğu. Gerçek zamanlı fiyatlandırma sorgularıyla, müşterinin aramasıyla eşleşen daha güncel fiyatlar gösterebilirsiniz.
Gerçek zamanlı fiyatlandırma sorguları, fiyatlandırma güncellemeleri için ikincil mekanizma olarak tasarlanmıştır. Yeniden fiyatlandırma için birincil mekanizma hâlâ Çekme veya Değiştirilen fiyatlandırmadır. Gerçek zamanlı fiyatlandırma sorguları, Google'ın otel veya seyahat planı kombinasyonları için fiyat bilgileri olmadığı durumlarda boşlukları doldurmaya yardımcı olur.
Gerçek zamanlı fiyatlandırma sorgularını kullanma kuralları
İstenen seyahat planının alışılmadık olması (ör. tarihler çok ileri bir tarihte olması veya otelin nadiren aranması) nedeniyle söz konusu seyahat planı için önbelleğe alınmış veri mevcut değildir.
İstenen tarih varsayılan olmayan bir tarih.
: Not: Varsayılan tarihler, Gerçek zamanlı fiyatlandırma sorguları için uygun değildir. Gerçek zamanlı fiyatlandırma sorguları, yalnızca varsayılan olmayan tarihler için istenir.
Google, aynı otel veya seyahat planının tekrar sorgulanmaması için gerçek zamanlı fiyatlandırma sonuçlarını genellikle önbelleğe alır. Hem tek otel hem de seyahat planı kombinasyonlarının yanı sıra birden fazla otel veya tek seyahat planı kombinasyonlarını da isteyebilir.
Bağlamlı Gerçek Zamanlı fiyatlandırma özelliği, Google'ın kullanıcının cihaz türüne, arama yaptığı ülkeye ve çocuklar dahil kişi sayısına göre belirli Gerçek zamanlı fiyatlandırma istekleri göndermesini sağlar. Hem Sorgu mesajı hem de Transaction mesajı, sorgu parametrelerini tanımlayan <Context> öğesini içerecek şekilde genişletilir. Bağlamla birlikte gerçek zamanlı fiyatlandırma sorgularından alınan fiyatlar, belirli bir doluluk için fiyat geçerliyse Oda Paketi ve kullanıcının ülkesi veya kullanıcı cihazı için Koşullu Fiyat olarak önbelleğe alınabilir.
Bağlam sorguları ile
Bağlam sorguları, belirtilen tesis veya seyahat planı kombinasyonları için veritabanımızı güncellemeye yönelik düzenli isteklerdir. Bu kombinasyonlar için popüler olan kullanıcı bağlamlarının bir listesini içerir. Koşullu Fiyatlar kullanılıyorsa olası tüm kullanıcı bağlamları için ücret göndermek pahalı olabilir. Bu nedenle, yanıtınızı sınırlandırmak için bu kullanıcı bağlamı listesini kullanabilirsiniz. Yalnızca belirtilen kullanıcı bağlamları için fiyat döndürülmesi, alakalı kullanıcı sorgularının büyük çoğunluğunu kapsar.
Meta veri sorgusu mesajları
Meta veri sorgusu mesajları, belirtilen tesisler için oda ve paket bilgileriyle ilgili ayrıntıları içerir.
Bir meta veri Sorgusu mesajı aldığınızda, istenen tesislerin fiyatlandırmasını <Result> öğelerinde belirten bir <Transaction> mesajıyla yanıt vermeniz gerekir.
Daha fazla bilgi için Oda ve paket meta verilerini tanımlama konusuna bakın.
Kontrol sorguları
Bu bölümde, hangi tesislerin ve seyahat planlarının Google'dan gelen Sorgu mesajlarının konusu olabileceğini nasıl kontrol edeceğiniz açıklanmaktadır.
Seyahat planı sınırları
Fiyat sorgularının olası sınırlarını <ItineraryCapabilities> kullanarak belirlersiniz. Desteklediğiniz tarih aralığını ve maksimum konaklama süresini belirleyen kuralları tanımlarsınız.
<MaxAdvancePurchase> ve <MaxLengthOfStay> için tüm otel veya seyahat planı kombinasyonlarında geçerli olacak varsayılan değerler ayarlayabilirsiniz. Bu ayarları otel grupları için de tanımlayabilirsiniz.
Sorgu mesajı örnekleri
Bu bölümde, fiyatlandırma Sorgusu mesajları ve bir meta veri Sorgusu mesajı için birkaç örnek gösterilmektedir. Daha fazla örneği Sorgu XML Referansı konusunda bulabilirsiniz.
Örnek seyahat planı
Aşağıdaki örnekte 4 otel için 23 Mayıs 2023'ten itibaren 3 gecelik fiyat güncellemeleri isteyen bir fiyatlandırma <Query> gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
Bu örnekte her bir otel için fiyatlandırma güncellemeleri istenmiştir:
5/23/18 - 6/26/18
Gerçek zamanlı fiyatlandırma sorgusu örneği
Aşağıdaki örnekte yanıt süresi sınırı 500 milisaniye olan bir Gerçek zamanlı fiyatlandırma sorgusu gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
be configured to be displayed, on request, by Google. This attribute is only
displayed for a Live Pricing Query request -->
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
received by. This element is only displayed for a Live Pricing Query request -->
<PropertyList>
<Property>6781291</Property>
</PropertyList>
<!-- Note that Context tags are potentially repeatable -->
<Context>
<!-- The total number of guests occupying the room (adults+children) -->
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
<Children>
<Child age="5"/>
</Children>
</OccupancyDetails>
<!-- The user was located in the US when this search was made -->
<UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
<UserDevice>mobile</UserDevice>
</Context>
</Query>
Bu örnekte tek bir otel için fiyat istenmektedir:
6/23/23 - 6/25/23
Bu sorgunun örnek transaction mesajı yanıtı Fiyatlandırma ve Oda Envanteri (Transaction mesajları) XML Referansı konusunda bulunabilir.
Bağlamlı sorgu örneği
Aşağıdaki örnekte Bağlamlı bir sorgu örneği gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<PropertyContextList>
<PropertyContext>
<Property>8675309</Property>
<!-- In the future, occupancy and device might be specified -->
<Context><UserCountry>US</UserCountry></Context>
<Context><UserCountry>GB</UserCountry></Context>
</PropertyContext>
<PropertyContext>
<Property>8675310</Property>
<Property>8675311</Property>
<Context><UserCountry>CA</UserCountry></Context>
</PropertyContext>
</PropertyContextList>
</Query>
Bağlam sorguları yalnızca kullanıcının ülke bağlamını belirtir. Gelecekte, bu tür sorgularda kullanıcının cihazı ve doluluk da belirtilebilir.
Check-in tarih aralıkları
Değiştirilen Fiyatlandırma kullanıyorsanız Sorgu mesajının yapısı; check-in tarih aralıkları, tam seyahat planları veya aralıklı seyahat planları için kullandığınız ipucu türüne bağlıdır. Bu ipucu türlerinin her biri hakkında daha fazla bilgi için İpucu Yanıtı Mesajları bölümüne bakın.
Aşağıdaki örnekte, check-in tarih aralıkları için fiyatlandırma <Query> mesajı gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
Bu örnekte aşağıdaki konaklamalar için fiyatlandırma güncellemeleri istenmiştir (her otel için):
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Aralıklı Konaklamalar
Aşağıdaki örnekte aralıklı konaklamalar için fiyatlandırma <Query> mesajı gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
Bu örnekte her bir otel için fiyatlandırma güncellemeleri istenmiştir:
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Ayrıca belirtilen geceden önce başlayan (ancak bu geceden önce) konaklamalar:
5/20/23 - 5/23/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
Meta veri sorgusu mesajı
Aşağıdaki örnekte çeşitli tesisler için oda ve paket bilgilerinin meta veri güncellemelerini isteyen <Query> mesajı gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
Bu tür Sorgu mesajlarına, oda ve paket meta verilerini tanımlayan bir Transaction mesajıyla yanıt verirsiniz. Daha fazla bilgi için Oda ve paket meta verilerini tanımlama konusuna bakın.