Tworzenie plików danych
Pliki danych muszą być regularnie udostępniane Google, aby mogły być bezpośrednio wyświetlane w Google. Potrzebujemy tych plików danych.
Kanał | Opis | Częstotliwość |
---|---|---|
Praktyka | Zawiera dane dotyczące specjalistów, w tym linki innych firm do rezerwacji u specjalistów. (odpowiednik: praktyka FHIR) [Wymagany tylko w przypadku rezerwacji u konkretnych specjalistów] | Raz na 24 godziny |
Obiekty | Zawiera dane opisujące placówki opieki zdrowotnej i lokalizacje takie jak ośrodki diagnostyczne, kliniki, linki do stron z rezerwacjami u innych podmiotów. (odpowiednik: lokalizacja FHIR) | Raz na 24 godziny |
Typ spotkania | Zawiera listę wszystkich typów spotkań, w tym identyfikator i nazwę. Na przykład: kontrola, choroba i nowy pacjent. Będzie służyć jako podstawa do zawężenia harmonogramów. (odpowiednik: typ spotkania FHIR) | Raz na 24 godziny |
Dostępność | Wyświetla listę przedziałów dostępności dla praktyków, obiektów, typów usług i terminów spotkań. (drugi: przedział czasu FHIR) Dla każdej kombinacji specjalisty, placówki i rodzaju spotkania należy zapewnić co najmniej 24 godziny pokrycia od rozpoczęcia kolejnego dostępnego przedziału czasu. | Raz na 15–60 minut |
Konwersja | Udostępnij Google współczynnik konwersji, w tym dane dotyczące odwiedzania linków i rezerwowania spotkań. | Raz na tydzień |
Format pliku danych jest opisany za pomocą składni bufora protokołu 3, ale możesz sprawdzić przykładowy plik danych, aby zobaczyć format JSON. Zalecamy przesyłanie plików danych w formacie JSON.
Rozmiar pliku danych, fragmentacja i kompresja
Zapoznaj się z tymi samouczkami dotyczącymi kompresji i fragmentów:Aby określić rozmiar kanałów, postępuj według tych wytycznych (plik danych może składać się z wielu plików nazywanych „fragmentami”):
- Sugerowana fragmentacja pliku danych:
- Kanał praktykujący: 1 fragment
- Plik danych obiektu: 1 fragment
- Plik danych typu spotkania: 1 fragment
- Kanał konwersji: 1 fragment
- Plik danych o dostępności : mniej niż 20 fragmentów
- Rozmiar plików danych i fragmentacja:
- Rozmiar pliku zrzutu nie może przekraczać 200 MB (po kompresji). W razie potrzeby użyj wielu fragmentów.
- Poszczególne rekordy wysyłane w jednym fragmencie nie muszą być wysyłane w tym samym fragmencie w kolejnych plikach danych.
- Aby uzyskać lepszą wydajność, podziel dane równomiernie między fragmenty, aby wszystkie pliki były podobne do rozmiaru.
- W razie potrzeby możesz skompresować kanały JSON zawierające zwykły tekst w formacie gzip. Musisz to jednak zrobić dla poszczególnych fragmentów kanału.
Przesyłanie plików danych do skrzynki domyślnej SFTP
Aby rozpocząć przesyłanie plików danych, najpierw wykonaj instrukcje konfiguracji. Następnie otwórz w portalu dla partnerów stronę Pliki danych. Wszystkie pliki danych należy przesłać na konto ogólne.
Każdy plik danych należy przesłać za pomocą SFTP oddzielnie za pomocą deskryptora zbioru plików. Nazwa pliku z deskryptorami zbioru danych powinna wyglądać tak: <feed_name>-< generation_timestamp>.filesetdesc.json, gdzie <feed_name> to healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type i healthappointments.
Więcej informacji znajdziesz w artykule Korzystanie z ogólnego pliku danych. Przykłady są dostępne na stronie Przykłady.
Sprawdzanie poprawności danych
Zaloguj się w portalu dla partnerów. Przełącz się na środowisko Piaskownica, aby w sekcji Panele znaleźć te strony.
- Kanały
- Pokazuje statystyki podsumowania pliku danych i wskazuje błędy podczas przesyłania pliku danych.
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 już regularnie przesyłać kompletne, bezbłędne pliki danych do środowiska piaskownicy, możesz rozpocząć przesyłanie do środowiska produkcyjnego. Na tym etapie integracja nie będzie aktywna.
Gdy wszystkie pliki danych produkcyjnych będą regularnie 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 je przetwarza i ocenia pod kątem jakości i kompletności.