Dostawa w trybie push do cen hoteli

Jeśli masz ograniczenia systemowe, które uniemożliwiają korzystanie z metod przesyłania pull, skorzystaj z formularza kontaktowego.

Omówienie trybu dostarczania push

W trybie dostarczania push wysyłasz przyrostowe aktualizacje w przypadku zmiany ceny lub dostępności.

Poniższa ilustracja przedstawia przepływ żądania/odpowiedzi w trybie dostarczania push:

Konfigurowanie push w pliku konfiguracji protokołu

Aby zaktualizować ceny w trybie dostarczania push, w pliku konfiguracji protokołu podaj te elementy: Możesz to zrobić tylko wtedy, gdy po raz pierwszy konfigurujesz środowisko do pracy z interfejsem Hotel Prices API:

  • <Model>: ustaw wartość elementu <Model> na „push”.
  • <WhitelistedIPs>: zawiera listę adresów IP, których używasz do uwierzytelniania komunikacji między Tobą a Google. Wartością tego elementu może być lista rozdzielonych średnikami adresów IP lub zakres adresów IP z notacją CIDR. Ma on format xxx.xxx.xxx.xxx/YY.

Poniższy przykład pokazuje plik konfiguracyjny protokołu dla partnerów, którzy używają push:

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

Więcej informacji znajdziesz w pliku konfiguracji protokołu.

Aktualizacja cen w trybie push

Aby zaktualizować dane za pomocą push, wysyłaj wiadomość o transakcji za każdym razem, gdy dane się zmienią.

Podczas wysyłania wiadomości o transakcji skorzystaj z tych wskazówek:

  • Wyślij wiadomość do tego punktu końcowego:
    • http://www.google.com/travel/hotels/uploads/price
  • Użyj metody HTTP POST.
  • Ustaw nagłówek Content-Type na „application/xml”.
  • Treść wiadomości musi być zgodna ze składnią wiadomości o transakcjach, zgodnie z opisem w sekcji Ustawianie cen (w przypadku aktualizacji cen) lub w Definiowanie metadanych pokoju i pakietu (aktualizacja metadanych).
  • W przypadku aktualizacji cen zdefiniuj element <Result> dla każdego planu podróży, który chcesz zaktualizować. Aby zaktualizować metadane, zdefiniuj dane sali i pakietu dla każdej usługi, która uległa zmianie.

W przypadku każdej otrzymanej wiadomości dotyczącej transakcji Google wysyła z serwera komunikat HTTP 200 OK, aby wskazać, że operacja się udała. Jeśli w Google otrzymasz odpowiedź z kodem błędu HTTP, ponownie wyślij komunikat o transakcji. Jeśli podczas wysyłania lub odbierania wiadomości wystąpią problemy, zapoznaj się z artykułem Rozwiązywanie problemów z plikami danych.

W przypadku każdego planu podróży (usługa, data zameldowania, długość pobytu), w której zmieniła się cena, należy wysłać wiadomość o transakcji. Możesz wysłać maksymalnie 5 wiadomości dotyczących transakcji na sekundę. Google nie będzie blokować wiadomości wysyłanych częściej niż 5 sekund na sekundę, ale może spowodować przekroczenie limitu czasu oczekiwania na zakończenie innych żądań.

Aby ograniczyć ruch w sieci, możesz połączyć wiele elementów <Result> w jedną wiadomość o transakcji.

Google zwykle przetwarza zaktualizowane ceny i dane o dostępności w ciągu ok. 5 minut. Ceny zostaną usunięte po 90 dniach.

Więcej informacji o aktualizowaniu cen znajdziesz w artykule Ustawianie cen.

Aktualizowanie metadanych pokoju i pakietu za pomocą push

Aby zaktualizować metadane dotyczące sali i pakietu, wysyłaj aktualizacje tak samo jak każdą inną aktualizację. W takim przypadku wysyłasz wiadomość o transakcji z nowymi informacjami w elementach <RoomData> i <PackageData>. Te elementy są elementami podrzędnymi elementu <PropertyDataSet>.

Więcej informacji znajdziesz w artykule Definiowanie metadanych pokoju i pakietu.

Błędy związane z trybem dostarczania

Jeśli podczas wysyłania wiadomości o transakcji do Google pojawi się błąd HTTP, spróbuj wysłać żądanie ponownie co 1, 5 lub 20 minut. Jeśli po 3 ponownych próbach problem nadal będzie się pojawiać, przestań wysyłać wiadomości i skontaktuj się z menedżerem konta Google.

Gdy skontaktujesz się z menedżerem konta Google w celu zgłoszenia błędu HTTP, który wystąpił podczas wysyłania wiadomości związanej z transakcją, Google uruchomi testy około 10 hoteli, a Ty sprawdzisz, czy Twoje pliki danych są prawidłowo skonfigurowane. Jeśli testy zakończą się powodzeniem, Google przeskanuje pełny zbiór hoteli podanych w pliku danych z cenami hoteli. Dzięki temu wczytywanie jest akceptowalne, a ceny pozostają dokładne przez 3–5 dni. Google powiadomi Cię o wprowadzeniu tej zmiany i później umożliwi Ci zapoznanie się z jej wynikami.

Z jaką częstotliwością należy przenosić ceny?

Wysyłasz wszystkie aktualizacje, gdy tylko wiesz, że cena się zmieniła. Jeśli nie wiesz, kiedy nastąpiły zmiany cen, postaraj się je aktualizować tak często, jak to możliwe. Zwykle obejmuje to kilka push dziennie. Zwykle plany podróży z bieżącego dnia i tygodnia są przesyłane znacznie częściej.