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

Sorgu mesajlarının ayrıntılı biçimlendirmesi Sorgu XML Referansı konusunda bulunabilir.

Fiyatlandırma sorgusu mesajları

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

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

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

Gerçek zamanlı fiyatlandırma: Etkinleştirilirse kullanıcı, belirtilen tesis veya seyahat planı kombinasyonunun fiyatlarına göz atarken sorgular gönderilir ve yanıt vermek için belirli bir zaman aralığınız olur.
Bağlamla: Etkinleştirilirse kullanıcı bağlamı önerileri, Google'ın size gönderdiği her sorguya dahil edilir ve öneriler, belirli bir tesis veya seyahat planı kombinasyonunu arayan en yaygın kullanıcı türlerini yansıtır. Bu önerilere uyarak yanıtlarınızın verimliliğini artırabilirsiniz.
Meta veri: Bu, belirtilen tesislerdeki odalar ve paketlerle ilgili ayrıntıların istendiği bir istektir.

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, bir otel veya seyahat planı kombinasyonu için kullanıcıdan arama isteği alır ve fiyatlandırma verisi mevcut veya güncel olmadığından arama sırasında sizden fiyat güncellemesi ister. Google, Gerçek Zamanlı Fiyatlandırma Sorgusu ile bir fiyat alıp bunu arama sırasında sonuçlarda görüntülemeyi dener.

Tüm Gerçek Zamanlı Fiyatlandırma Sorgusu isteklerinin bir yanıt süresi sınırı vardır. Bu genellikle 4.000 milisaniyedir. Bu sınır, anlık 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ıyla sonuçlanır. Ancak önbelleğe alınıp gelecekteki fırsatlarda kullanılabilmesi için gene 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 kadar açık kalır.

Gerçek zamanlı fiyatlandırma sorguları aynı zamanda bağlamsaldır ve şu parametreler için fiyat alabilir: kullanıcı ülkesi, cihaz türü, doluluk (konuk sayısı) ve bu konukların yetişkin veya çocuk olup olmadığı. 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 ana mekanizma hâlâ Aktarma veya Değiştirilen Fiyatlandırma mekanizmalarıdır. Gerçek zamanlı fiyatlandırma sorguları, otel veya seyahat planı kombinasyonlarının fiyatlarının Google'da 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. çok uzak bir gelecekteki tarihler) veya otelin çok nadir aranması sebebiyle söz konusu seyahat planı için önbelleğe alınmış veri olmadığında.
İstenen tarih varsayılan olmayan bir tarih olduğunda.

: 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ı için bir daha sorgu yapılmaması için genellikle Gerçek Zamanlı Fiyatlandırma sonuçlarını önbelleğe alır. Hem tek otel veya seyahat planı kombinasyonlarını hem de birden fazla otel veya tek seyahat planı kombinasyonlarını isteyebilir.

Bağlam İçeren Gerçek Zamanlı Fiyatlandırma özelliği; kullanıcının cihaz türüne, arama yaptığı ülkeye ve çocuklar dahil kişi sayısına göre Google'ın 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çinse Oda Paketi, kullanıcı ülkesi veya kullanıcı cihazı içinse Koşullu Fiyat olarak önbelleğe alınabilir.

Bağlamlı sorgular

Bağlam sorguları, belirtilen tesis veya seyahat planı kombinasyonları için veritabanımızı güncellemeye yönelik normal isteklerdir. Bu kombinasyonlar için popüler olan kullanıcı bağlamlarının listesini içerirler. Koşullu fiyatlar kullanılıyorsa tüm olası kullanıcı bağlamları için fiyat göndermek pahalı olabilir. Bu nedenle, yanıtınızı sınırlamak için bu kullanıcı bağlamları listesini kullanabilirsiniz. Yalnızca belirtilen kullanıcı bağlamları için fiyat döndürme, alakalı kullanıcı sorgularının büyük çoğunluğunu kapsar.

Bağlamlı sorgular almak istiyorsanız Teknik Hesap Yöneticinizle (THY) iletişime geçin. Bu tür mesajları almaya hazır olduğunuzu onaylayabilir ve ardından sorgularda kullanıcı bağlamlarını size göndermeye başlamak için bir yapılandırma ayarlaması yapabilirler.

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ız zaman <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 tesisler ve seyahat planlarını nasıl kontrol edebileceğ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.

Tüm otel veya seyahat planı kombinasyonları için geçerli olacak varsayılan <MaxAdvancePurchase> ve <MaxLengthOfStay> değerleri ayarlayabilirsiniz. Ayrıca 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 verilmiştir. Daha fazla örnek Sorgu XML Referansı konusunda bulunabilir.

Ö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 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 istenmiştir:

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ğlam içeren sorgu örnekleri

Aşağıda, bağlam içeren sorgu örnekleri verilmiştir:

Bağlam İçeren Temel Sorgu

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, 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>

Doluluk oranı da dahil olmak üzere bağlam içeren sorgu

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2025-07-10</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <Context>
        <UserCountry>US</UserCountry>
      </Context>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="7"/>
        </Children>
      </OccupancyDetails>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Context>
        <UserCountry>GB</UserCountry>
      </Context>
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
    </PropertyContext>
  </PropertyContextList>
</Query>

WithContext sorguları yalnızca kullanıcı ülke bağlamını belirtir. Gelecekte bu tür sorgularda kullanıcı cihazı 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ı konusuna 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>