Creare feed
I feed devono essere forniti a Google su base regolare affinché i dati vengano mostrati direttamente su Google. Sono necessari i feed seguenti.
| Feed | Descrizione | Frequenza |
|---|---|---|
| Professionista | Contiene dati che descrivono i professionisti, che includono link di terze parti alla prenotazione con i professionisti. (parte: FHIR professionista) . [Obbligatorio solo per le prenotazioni con professionisti specifici] | Una volta ogni 24 ore |
| Funzionalità | Contiene dati che descrivono strutture/sedi sanitari, ad esempio centri di test e cliniche, che includono link di terze parti per la prenotazione delle strutture. (parte: località FHIR) | Una volta ogni 24 ore |
| Tipo di appuntamento | Contiene un elenco di tutti i tipi di appuntamenti, inclusi ID e nome. Ad esempio, checkup, malato e nuovo paziente. Verrà utilizzato come riferimento per restringere le pianificazioni. (parte: Tipo di appuntamento FHIR) | Una volta ogni 24 ore |
| Disponibilità | Elenca gli slot di disponibilità per determinati professionisti, strutture, tipi di servizio e tipi di appuntamenti. (parte: slot FHIR) È necessario fornire almeno 24 ore di copertura a partire dal successivo slot disponibile per ogni combinazione di professionista, struttura e tipo di appuntamento. | Una volta ogni 15-60 minuti |
| Conversione | Condividi il tasso di conversione con Google, incluse le metriche per visitare i link e completare gli appuntamenti di prenotazione. | Una volta alla settimana |
Il formato dei feed è descritto con la sintassi del buffer di protocollo 3, tuttavia puoi fare riferimento agli esempi di feed per vedere il formato JSON. Ti consigliamo di caricare i feed in formato JSON.
Dimensioni del file del feed, partizionamento orizzontale e compressione
Guarda i seguenti tutorial per quanto riguarda la compressione e gli shard:Per determinare le dimensioni dei feed, utilizza le seguenti linee guida (un feed può essere costituito da più file denominati "shards"):
- Partizionamento orizzontale del feed consigliato:
- Feed del medico: 1 shard
- Feed struttura: 1 shard
- Feed del tipo di appuntamento: 1 shard
- Feed delle conversioni: 1 shard
- Feed di disponibilità : meno di 20 shard
- Dimensioni dei file del feed e partizionamento orizzontale:
- Mantieni le dimensioni del file di shard al di sotto di 200 MB (dopo la compressione). Se necessario, utilizza più shard.
- I singoli record inviati in uno shard non devono essere inviati nello stesso shard nei feed futuri.
- Per ottenere prestazioni migliori, suddividi i dati in modo uniforme tra gli shard, in modo che le dimensioni di tutti i file di shard siano simili.
- Se necessario, utilizza gzip per comprimere i feed JSON in testo normale. Tuttavia, puoi farlo per ogni singolo shard del feed.
Carica i feed nella tua casella personale SFTP
Per iniziare a caricare i feed, devi prima completare le istruzioni per la configurazione. Successivamente, vai alla pagina Feed nel Portale partner. Tutti i feed devono essere caricati nell'account Generico.
Ogni feed deve essere caricato separatamente tramite SFTP con un file descrittore del set di file. Il nome file di un descrittore di set di file deve essere <feed_name>-< Generation_timestamp>.filesetdesc.json, in cui <feed_name> potrebbe essere healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type e healthappointments.
Per ulteriori informazioni, consulta la sezione Utilizzo della casella personale del feed Generica. Gli esempi sono disponibili nella pagina relativa agli esempi.
Verifica che i tuoi dati siano corretti
Accedi al Portale partner. Passa all'ambiente Sandbox per trovare le seguenti pagine nella sezione Dashboard.
- Feed
- Mostra le statistiche di riepilogo dei feed e segnala gli errori durante il caricamento del feed.
Per verificare che i tuoi dati siano corretti dopo il caricamento iniziale nell'ambiente sandbox, verifica la presenza di eventuali errori nel feed nella pagina Feed.
Caricare i feed in produzione
Una volta che hai caricato in modo coerente feed completi e privi di errori nell'ambiente di sandbox, puoi iniziare a caricarli nell'ambiente di produzione. A questo punto, la tua integrazione non sarà attiva.
Una volta che tutti i dati del feed di produzione vengono caricati in modo coerente e collegati al sistema di produzione, i feed sono pronti per la revisione.
Google valuta i feed
Una volta caricati i feed, Google li valuta e ne valuta la qualità e la completezza.