Tworzenie plików danych
Aby dane wyświetlały się bezpośrednio w Google, muszą być regularnie przesyłane do Google. Wymagane są te pliki danych.
| Kanał | Opis | Częstotliwość |
|---|---|---|
| Praktykator | Zawiera dane opisujące praktykę, w tym linki zewnętrzne do rezerwacji u specjalistów. (odpowiednik: specjalista FHIR). [Wymagane tylko w przypadku rezerwacji u konkretnych specjalistów] | Co 24 godziny |
| Infrastruktura | Zawiera dane opisujące placówki opieki zdrowotnej i lokalizacje, takie jak centra testów laboratoryjnych i kliniki, w tym linki zewnętrzne do stron rezerwacji w placówkach. (odpowiednik: lokalizacja FHIR) | Co 24 godziny |
| Typ spotkania | Zawiera listę wszystkich typów spotkań, w tym identyfikator i nazwę. Na przykład kontrola pacjenta, choroba i nowy pacjent. Służą one jako punkt odniesienia do zawężania harmonogramów. (odpowiednik: Typ spotkania FHIR) | Co 24 godziny |
| Dostępność | Zawiera listę przedziałów dostępności dla poszczególnych specjalistów, obiektów, typów usług i typów spotkań. (odpowiednik: przedział FHIR) Dla każdej kombinacji specjalisty, placówki i rodzaju spotkania należy zapewnić co najmniej 24 godziny pokrycia, począwszy od następnego dostępnego przedziału czasu. | Co 15–60 minut |
| Konwersje | udostępniać Google współczynnik konwersji, w tym dane dotyczące wizyt po kliknięciu linków i ukończenia rezerwacji. | Raz na tydzień |
Format plików danych jest opisany w składni bufora protokołu 3, ale w przykładach kanałów znajdziesz informacje o formacie JSON. Zalecamy przesłanie plików danych w formacie JSON.
Rozmiar pliku danych, fragmentacja i kompresja
Zapoznaj się z samouczkami dotyczącymi kompresji i fragmentów:Aby określić rozmiar plików danych, korzystaj z tych wskazówek (kanał może składać się z wielu plików nazywanych „fragmentami”):
- Sugerowane fragmenty pliku danych:
- Plik danych praktycznego: 1 fragment
- Plik danych obiektów: 1 fragment
- Plik danych typu spotkania: 1 fragment
- Plik danych konwersji: 1 fragment
- Plik danych o dostępności : mniej niż 20 fragmentów
- Rozmiar plików danych i fragmentacja:
- Zachowaj rozmiar pliku dla fragmentu poniżej 200 MB (po skompresowaniu). W razie potrzeby użyj wielu fragmentów.
- Indywidualne rekordy wysyłane w jednym fragmencie nie muszą być wysyłane w tym samym fragmencie w przyszłych kanałach.
- Aby uzyskać lepszą wydajność, podziel dane po równo między fragmenty, aby rozmiar wszystkich plików fragmentów był podobny.
- W razie potrzeby użyj narzędzia gzip do skompresowania plików danych JSON w postaci zwykłego tekstu. Zrób to jednak w przypadku każdego fragmentu kanału.
Przesyłanie plików danych do skrzynki referencyjnej SFTP
Aby rozpocząć przesyłanie plików danych, najpierw dokończ instrukcje konfiguracji. Następnie przejdź na stronę plików danych w portalu dla partnerów. Wszystkie pliki danych należy przesłać na konto Ogólne.
Każdy plik danych musisz przesłać przez SFTP oddzielnie za pomocą pliku deskryptora zbioru plików.
Nazwa pliku deskryptora zbioru plików powinna wyglądać tak: <feed_name>-<
generation_timestamp>.filesetdesc.json, gdzie <feed_name> może mieć postać healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type i healthappointments.availability.
Więcej informacji znajdziesz w artykule Korzystanie ze skrzynki referencyjnej ogólnego pliku danych. Przykłady znajdziesz na naszej stronie Sample.
Sprawdź, czy dane wyglądają prawidłowo
Zaloguj się w portalu dla partnerów. Przełącz się na środowisko Piaskownica, aby w sekcji Panele znaleźć poniższe strony.
- Pliki danych
- Pokazuje podsumowanie statystyk pliku danych i wskazuje błędy podczas przesyłania.
Aby się upewnić, że po pierwszym przesłaniu do środowiska piaskownicy dane wyglądają prawidłowo, sprawdź, czy na stronie Pliki danych nie ma błędów w pliku danych.
Przesyłanie plików danych do wersji produkcyjnej
Gdy będziesz w stanie regularnie przesyłać do środowiska piaskownicy pełne, wolne od błędów pliki danych, możesz zacząć je przesyłać do środowiska produkcyjnego. Na tym etapie Twoja integracja nie będzie aktywna.
Gdy wszystkie informacje z produkcyjnego pliku danych będą konsekwentnie przesyłane i połączone z systemem produkcyjnym, pliki danych będą gotowe do sprawdzenia.
Google ocenia pliki danych
Gdy prześlesz pliki danych, Google przetwarza je i ocenia pod względem jakości i kompletności.