Bu sayfa, Cloud Translation API ile çevrilmiştir.

Sorgu Mesajları

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 üstbilgisi "application/xml" ve User-Agent üstbilgisi Google-HotelAdsPrices olarak ayarlanmış bir HTTP POST isteği olarak bir Sorgu mesajı gönderir. Bu kuralın istisnası, fiyat uç noktası entegrasyonunun Google-TravelAds-Live aracılığıyla manuel test edilmesi sırasında gerçekleşir. Bu örnek sorgular User-Agent başlığını içerebilir veya içermeyebilir.

Sorgu mesajlarının ayrıntılı biçimlendirmesini Sorgu XML Referansı konusunda bulabilirsiniz.

Fiyatlandırma sorgusu mesajları

Fiyatlandırma Sorgusu mesajları, fiyatları sağladığınız tesis veya seyahat planı kombinasyonlarını belirtir.

Sunucunuz bir pricing Sorgu 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ış konusuna bakın.

Üç özel sorgu mesajı türü vardır:

Gerçek zamanlı fiyatlandırma: Etkinleştirildiğinde, bir kullanıcı belirtilen tesis veya seyahat planı kombinasyonuna ait fiyatlara aktif olarak göz atarken ve yanıt vermek için belirli bir zaman aralığınız olduğunda sorgular 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: Bu, belirtilen tesisler için odalar ve paketlerle ilgili ayrıntılara yönelik bir istektir.

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, bir otel veya seyahat planı kombinasyonu için kullanıcıdan arama isteği alır. Fiyatlandırma verileri mevcut veya güncel olmadığından, arama sırasında Google sizden fiyat güncellemesi ister. Gerçek zamanlı fiyatlandırma sorgulaması ile Google, bir fiyat alıp 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ı 4.000 milisaniyedir. Bu sınır, Gerçek zamanlı fiyatlandırma sorgu isteğinde belirtilir. Yanıt, süre sınırı dahilinde sağlanamazsa söz konusu fırsat için katılımın kaçırılmasıyla sonuçlanır. 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 (misafir 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 bir mekanizma olarak tasarlanmıştır. Yeniden fiyatlandırma için temel mekanizma hâlâ Alınan veya Değiştirilen fiyatlandırmadır. Gerçek zamanlı fiyatlandırma sorguları, Google'ın otel veya seyahat planı kombinasyonları için fiyat bulunmadığı durumlarda boşlukları doldurmaya yardımcı olur.

Gerçek zamanlı fiyatlandırma sorgularını kullanma kuralları

İstenen seyahat planı olağan dışı olduğundan (tarihlerin çok ileride olması veya otelin çok nadir aranması gibi) belirli bir 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, genellikle Gerçek zamanlı fiyatlandırma sonuçlarını önbelleğe alır. Böylece, aynı otel veya seyahat planı tekrar sorgulanmaz. Hem tek otel hem de seyahat planı kombinasyonlarının yanı sıra birden fazla otel veya tek seyahat planı kombinasyonları talep edebilir.

Bağlam İçeren Gerçek Zamanlı Fiyatlandırma özelliği, Google'ın kullanıcının cihaz türüne, arama yaptıkları ülkeye ve çocuklar dahil kişi sayısına göre belirli Gerçek Zamanlı fiyatlandırma istekleri göndermesine olanak tanır. Hem Sorgu mesajı hem de Transaction mesajı, sorgu parametrelerini tanımlayan <Context> öğesini içerecek şekilde genişletilir. Bağlamı olan gerçek zamanlı fiyatlandırma sorgularından alınan fiyatlar, belirli bir doluluk için fiyatsa Oda Paketi ve kullanıcının ülkesi ya da kullanıcı cihazı içinse Koşullu Fiyat olarak önbelleğe alınabilir.

Bağlam sorgularıyla

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ırlamak için bu kullanıcı bağlamı listesini kullanabilirsiniz. Yalnızca belirtilen kullanıcı bağlamları için döndürülen fiyatlar, alakalı kullanıcı sorgularının büyük çoğunluğunu kapsar.

Meta veri sorgusu mesajları

Meta veri sorgu mesajları, belirtilen tesisler için oda ve paket bilgileri hakkında ayrıntıları içerir.

Bir meta veri Sorgu mesajı aldığınızda, <Result> öğelerinde istenen tesislerin fiyatlandırmasını belirten bir <Transaction> mesajıyla yanıt vermeniz gerekir.

Daha fazla bilgi için Oda ve paket meta verilerini tanımlama bölümüne 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.

<MaxAdvancePurchase> ve <MaxLengthOfStay> için tüm otel veya seyahat planı kombinasyonlarında geçerli olan 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 çeşitli örnekler gösterilmektedir. Daha fazla örnek Sorgu XML Referansı konusunda bulunabilir.

Örnek seyahat planı

Aşağıdaki örnekte 4 otel için 3 gecelik ve 23 Mayıs 2023'ten itibaren 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 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>

Şu ö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 sorgu örneğiyle

Aşağıdaki örnekte Bağlam İçeren 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 ile birlikte sorgular yalnızca kullanıcının ülke bağlamını belirtir. Gelecekte, bu tür sorgularda kullanıcı cihazı ve doluluk 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 içeren) 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 bilgileri için meta veri güncellemelerini isteyen bir <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 bölümüne bakın.