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 bilgileri hakkında veri 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 üst bilgisi "application/xml" ve User-Agent başlığı Google-HotelAdsPrices olarak ayarlanmış bir HTTP POST isteği olarak bir Sorgu mesajı gönderir. Bu kuralın istisnası, Google-TravelAds-Live aracılığıyla fiyat uç noktası entegrasyonunun manuel test edilmesi sırasında ortaya çıkar. Bu örnek sorgular, User-Agent başlığını içerebilir veya içermeyebilir.
Sorgu mesajlarıyla ilgili ayrıntılı biçimlendirmeyi Sorgu XML Referansı konusunda bulabilirsiniz.
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.
Sorgu mesajının üç özel türü vardır:
Gerçek zamanlı fiyatlandırma: Etkinleştirilirse sorgular, kullanıcı belirtilen tesis veya seyahat planı kombinasyonu için aktif olarak fiyatlara göz atarken ve yanıt vermek için belirli bir zaman zamanınız olduğunda 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ı için arama yapan 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 odalar ve paketlerle ilgili ayrıntılar isteğidir.
Gerçek zamanlı fiyatlandırma sorguları
Gerçek zamanlı fiyatlandırma sorguları, kullanıcı aramalarına yanıt olarak gerçek zamanlı fiyat güncellemeleri için Google'ın 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ığından arama sırasında sizden fiyat güncellemesi ister. Gerçek zamanlı fiyatlandırma sorgulamasıyla Google, bir fiyat alıp arama sırasında bunu sonuçlarda göstermeye çalışır.
Tüm gerçek zamanlı fiyatlandırma sorgu isteklerinin yanıt süresi sınırı, genellikle 4.000 milisaniyeye kadar sürer. Bu sınır, Gerçek zamanlı fiyatlandırma sorgusu isteğinde belirtilir. Süre sınırı dahilinde yanıt alınamazsa söz konusu 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ı da bağlamsaldır ve şu parametreler için fiyat alabilir: kullanıcının ü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ı sayesinde, 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 sahibi olmadığı durumlarda boşlukları doldurmaya yardımcı olur.
Gerçek zamanlı fiyatlandırma sorgularını kullanma kuralları
İstenen seyahat planı alışılmadık olduğundan (ör. tarihler çok uzak gelecekte olduğundan veya otel çok nadir arandığından) söz konusu seyahat planı için önbelleğe alınmış veri yoktur.
İ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ı 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ğlam içeren gerçek zamanlı fiyatlandırma sorgularından alınan fiyatlar, belirli bir doluluk için Oda Paketi, kullanıcının ülkesi veya kullanıcı cihazı içinse 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üncellememiz için yapılan 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, <Result> öğelerinde istenen tesislerin fiyatlandırmasını belirten <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, Google'dan gelen Sorgu mesajlarının konusu olabilecek tesis ve seyahat planlarını nasıl kontrol edeceğiniz açıklanmaktadır.
Seyahat planı sınırları
Fiyatlandırma sorgularının olası sınırlarını <ItineraryCapabilities> kullanarak belirlersiniz. Desteklediğiniz tarih aralığını ve maksimum konaklama sürelerini belirleyen kurallar tanımlarsınız.
Tüm otel veya seyahat planı kombinasyonlarında geçerli olan <MaxAdvancePurchase> ve <MaxLengthOfStay> için 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 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 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 istenmiştir:
6/23/23 - 6/25/23
Bu sorguya verilen örnek transaction mesajı yanıtı Fiyatlandırma ve Oda Envanteri (Transaction mesajları) XML Referansı konusunda bulunabilir.
Bağlam sorgusu örneğiyle
Aşağıdaki örnekte Bağlamlı 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ı cihazı ve doluluğu da belirtilebilir.
Check-in tarih aralıkları
Değiştirilen Fiyatlandırma özelliğini kullanırsanı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 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 gece dahil) 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.