Otel Fiyatları İçin Push Yayınlanma Yöntemi

Çekme veya İpuçlarıyla Çekme iletim yöntemlerini desteklemenizi engelleyen sistem sınırlamalarınız varsa lütfen Bize Ulaşın formunu kullanın.

Push İletim Modu'na Genel Bakış

Push iletim moduyla, fiyatlar veya stok durumu değiştiğinde artımlı güncellemeler gönderirsiniz.

Aşağıdaki resimde, Push iletim modu için istek/yanıt akışı gösterilmektedir:

Protokol Yapılandırma Dosyasında Push'u Yapılandırma

Fiyatları Push iletim moduyla güncellemek için Protokol Yapılandırma Dosyanızda aşağıdaki öğeleri belirtin. Bu işlemi yalnızca ortamınızı Otel Fiyatları API'si ile çalışacak şekilde ilk yapılandırdığınızda yaparsınız:

  • <Model>: <Model> öğesinin değerini "push" olarak ayarlayın.
  • <WhitelistedIPs>: Google ile aranızdaki iletişimin kimliğini doğrulamak için kullandığınız IP adreslerinizi listeler. Bu öğenin değeri, IP adreslerinizin noktalı virgülle ayrılmış listesi veya CIDR gösterimine sahip bir IP adresi aralığı olabilir. Bu işlem xxx.xxx.xxx.xxx/YY biçimindedir.

Aşağıdaki örnekte, Push kullanan iş ortakları için bir Protokol Yapılandırma Dosyası gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
  <Model>push</Model>
  <WhiteListedIPs>216.239.32.0/19;64.233.160.0/19</WhiteListedIPs>
</Configuration>

Daha fazla bilgi için Protokol Yapılandırma Dosyası bölümüne bakın.

Push ile Fiyatları Güncelleme

Verilerinizi Push ile güncellemek için verileriniz her değiştiğinde bir Transaction mesajı gönderin.

Transaction mesajını gönderirken aşağıdaki yönergeleri kullanın:

  • Mesajı aşağıdaki uç noktaya gönderin:
    • http://www.google.com/travel/hotels/uploads/price
  • HTTP POST yöntemini kullanın.
  • Content-Type üstbilgisini "application/xml" olarak ayarlayın.
  • Mesajın gövdesi, Fiyatları Ayarlama (fiyatlandırma güncellemeleri için) veya Oda ve Paket Meta Verilerini Tanımlama (meta veri güncellemeleri için) bölümünde açıklandığı gibi Transaction mesajı söz dizimine uygun olmalıdır.
  • Fiyatlandırma güncellemelerinde, güncellemek istediğiniz her seyahat planı için bir <Result> öğesi tanımlayın. Meta veri güncellemelerinde, değişen her tesis için oda verilerini ve paket verilerini tanımlayın.

Google, aldığı her Transaction mesajının başarılı olduğunu belirtmek için sunucudan bir HTTP 200 OK mesajıyla yanıt verir. Google, HTTP hata koduyla yanıt verirse Transaction mesajını yeniden gönderin. Mesaj gönderme veya alma konusunda sorun yaşarsanız Feed'lerle İlgili Sorunları Giderme bölümüne bakın.

Fiyatın değiştiği her seyahat planı (tesis/giriş tarihi/konaklama süresi kombinasyonu) için bir İşlem mesajı göndermeniz gerekir. Saniyede en fazla 5 işlem mesajı gönderebilirsiniz. Google, saniyede 5 adetten daha sık gönderilen mesajları engellemez ancak diğer isteklerin tamamlanması beklenirken mesajınız zaman aşımına uğrayabilir.

Ağ trafiğini azaltmak için birden fazla <Result> öğesini tek bir Transaction mesajında birleştirebilirsiniz.

Google, güncellenen fiyat ve stok durumu verilerinizi genellikle yaklaşık 5 dakika içinde işler. Fiyatlar 90 gün sonra silinir.

Fiyatları güncellemek için Transaction mesajlarını kullanma hakkında daha fazla bilgi için Fiyatları Ayarlama bölümüne bakın.

Push ile Oda ve Paket Meta Verilerini Güncelleme

Oda ve paket meta verilerini güncellemek için diğer güncellemelerde olduğu gibi güncellemeler gönderin. Bu durumda, <RoomData> ve <PackageData> öğelerinde yeni bilgileri içeren bir Transaction mesajı gönderirsiniz. Bu öğeler, <PropertyDataSet> öğesinin alt öğeleridir.

Daha fazla bilgi için Oda ve Paket Meta Verilerini Tanımlama bölümüne bakın.

İletim Modu Hataları

Google'a Transaction mesajı gönderirken HTTP hatası alırsanız isteği 1, 5 ve 20 dakikalık aralıklarla tekrar deneyin. 3 denemeden sonra sorun devam ederse mesaj göndermeyi durdurun ve Google hesap yöneticinizle iletişime geçin.

Bir İşlem mesajı gönderirken aldığınız HTTP hatasını bildirmek için Google hesap yöneticinizle iletişime geçtiğinizde Google, feed'lerinizin doğru şekilde yapılandırıldığını doğrulamak üzere yaklaşık 10 otel için test gerçekleştirir. Testler başarılı olursa Google, Otel Fiyatları Feed'inizde belirtilen otel grubunun tamamını tarar. Bu, yüklemelerin kabul edilebilir olmasını ve fiyatlarınızın 3 ila 5 gün boyunca doğru kalmasını sağlar. Bunun ardından Google, lansmanla ilgili olarak sizi bilgilendirir. Sonuçlarınızı canlı olarak yayınlayabilirsiniz.

Fiyatlar ne sıklıkta aktarmalıdır?

İdeal olarak, bir fiyatın değiştiğini bildiğiniz anda tüm güncellemeleri aktarmanız gerekir. Fiyatların ne zaman değiştiğini bilmiyorsanız fiyatları olabildiğince sık güncellemeye çalışmalısınız. Buna genellikle günde birden fazla aktarma dahildir. Genellikle geçerli gün ve hafta için seyahat planları çok daha sık aktarılır.