Krok 2. Pliki danych

Tworzenie plików danych

Aby dane były wyświetlane bezpośrednio w Google, muszą być regularnie przesyłane do Google. Potrzebne są te pliki danych:

Kanał Opis Częstotliwość
Praktykujący Zawiera dane opisujące specjalistów, w tym linki stron trzecich do rezerwacji wizyty u specjalisty. (osoba kontaktowa: praktyk FHIR) . [Wymagany tylko w przypadku rezerwacji u określonych specjalistów] Co 24 godziny
Obiekt Zawiera dane opisujące placówki medyczne, takie jak centra badań laboratoryjnych i kliniki, w tym linki firm zewnętrznych do rezerwacji. (odpowiednik: lokalizacja FHIR) Co 24 godziny
Typ spotkania Zawiera listę wszystkich typów spotkań, w tym identyfikator i nazwę. np. kontrola, choroba i nowy pacjent. Będzie on służył jako punkt odniesienia do zawężenia zakresu harmonogramów. (partner: Typ spotkania FHIR) Co 24 godziny
Dostępność Wyświetla dostępne terminy dla danego lekarza, placówki, rodzaju usługi i rodzaju spotkania. (counterpart: FHIR slot) W przypadku każdej kombinacji usługodawcy, placówki i typu wizyty musisz podać co najmniej 24 godziny od następnego dostępnego slotu. Raz na 15–60 minut
Konwersja Udostępnianie Google współczynnika konwersji, w tym danych o odwiedzaniu linków i zamawianiu wizyt. Raz w tygodniu

Format plików danych jest opisany za pomocą składniki protokołu 3 bufora, ale możesz też zapoznać się z przykładami plików danych, aby zobaczyć format JSON. Zalecamy przesyłanie plików danych w formacie JSON.

Rozmiar pliku danych, dzielenie na fragmenty i kompresja

Zapoznaj się z tymi samouczkami dotyczącymi kompresji i fragmentów:

Aby określić rozmiar plików danych, skorzystaj z tych wytycznych (plik danych może składać się z kilku plików zwanych „fragmentami”):

  • Sugerowany podział pliku danych:
    • Plik danych praktykanta: 1 fragment
    • Plik danych o jednostkach: 1 część
    • Kanał typu spotkanie: 1 fragment
    • Plik danych konwersji: 1 część
    • Plik danych o dostępności : mniej niż 20 fragmentów
  • Rozmiar plików danych i dzielenie na fragmenty:
    • Rozmiar pliku fragmentu nie powinien przekraczać 200 MB (po kompresji). W razie potrzeby użyj wielu fragmentów.
    • Pojedyncze rekordy wysłane w ramach jednego fragmentu nie muszą być wysyłane w tym samym fragmencie w przyszłych plikach danych.
    • Aby uzyskać lepszą wydajność, podziel dane równomiernie na fragmenty, aby wszystkie pliki fragmentów miały zbliżony rozmiar.
    • W razie potrzeby użyj gzip do skompresowania plików danych w formacie JSON w postaci zwykłego tekstu. Zrób to jednak dla każdego pojedynczego fragmentu pliku danych.

Przesyłanie plików danych do skrzynki referencyjnej SFTP

Aby rozpocząć przesyłanie plików danych, najpierw wykonaj czynności opisane w sekcji Konfiguracja. Następnie otwórz stronę plików danych w portalu dla partnerów. Wszystkie pliki danych należy przesłać na konto Generic.

Każdy plik danych musi być przesyłany osobno przez SFTP z plikiem opisu zbioru. Nazwa pliku opisu zbioru plików powinna mieć postać <feed_name>-< generation_timestamp>.filesetdesc.json, gdzie <feed_name> może być zastąpione przez healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type lub healthappointments.availability.

Więcej informacji znajdziesz w artykule Używanie sekcji Pliki ogólne. Przykłady znajdziesz na stronie Przykłady.

Sprawdź, czy dane wyglądają prawidłowo

Zaloguj się w Portalu Partnera. Przełącz się na środowisko sandboksa, aby w sekcji Panele znaleźć te strony.

Pliki danych
Pokazuje statystyki podsumowania pliku danych i wskazuje błędy podczas przesyłania pliku danych.

Aby sprawdzić, czy dane są prawidłowe po ich pierwszym przesłaniu do środowiska piaskownicy, sprawdź na stronie Pliki danych, czy nie ma w nich błędów.

Przesyłanie plików danych do wersji produkcyjnej

Gdy będziesz regularnie przesyłać kompletne, pozbawione błędów pliki danych do środowiska piaskownicy, możesz rozpocząć przesyłanie do środowiska produkcyjnego. W tej chwili integracja nie jest aktywna.

Gdy wszystkie dane w pliku danych produkcyjnych są przesyłane w sposób spójny i połączone z systemem produkcyjnym, pliki danych są gotowe do sprawdzenia.

Google ocenia pliki danych

Gdy prześlesz pliki danych, Google przetworzy je i oceni ich jakość oraz kompletność.