Creare feed
I feed devono essere forniti a Google regolarmente affinché i dati vengano mostrati direttamente su Google. Sono necessari i seguenti feed.
| Feed | Descrizione | Frequenza |
|---|---|---|
| Professionista | Contiene dati che descrivono i professionisti, inclusi i link di terze parti per la prenotazione con i professionisti. (controparte: professionista FHIR) . [Obbligatorio solo per la prenotazione con professionisti specifici] | Una volta ogni 24 ore |
| Struttura | Contiene dati che descrivono strutture/luoghi sanitari, come centri di test di laboratorio e cliniche, inclusi link di terze parti per la prenotazione con le strutture. (counterpart: FHIR location) | Una volta ogni 24 ore |
| Tipo di appuntamento | Contiene un elenco di tutti i tipi di appuntamenti, inclusi ID e nome. Ad es. controllo, malato e nuovo paziente. Verrà utilizzato come riferimento per restringere le programmazioni. (corrispondente: tipo di appuntamento FHIR) | Una volta ogni 24 ore |
| Disponibilità | Elenca gli slot di disponibilità per determinati professionisti, strutture, tipi di servizi e tipi di appuntamenti. (corrispondente: slot FHIR) Per ogni combinazione di professionista, struttura e tipo di appuntamento deve essere fornita una copertura minima di 24 ore a partire dallo slot disponibile successivo. | Una volta ogni 15-60 minuti |
| Conversione | Condividere con Google il tasso di conversione, incluse le metriche per le visite ai link e il completamento degli appuntamenti di prenotazione. | Una volta a settimana |
Il formato dei feed è descritto con la sintassi di Protocol Buffer 3, ma puoi fare riferimento ai Sample di feed per visualizzare il formato JSON. Ti consigliamo di caricare i feed in formato JSON.
Dimensioni, suddivisione e compressione dei file del feed
Guarda i seguenti tutorial sulla compressione e sui frammenti:Per determinare le dimensioni dei feed, segui le linee guida riportate di seguito (un feed può essere costituito da più file chiamati "shard"):
- Sharding del feed suggerito:
- Feed dei professionisti: 1 shard
- Feed delle strutture: 1 shard
- Feed di tipo di appuntamento: 1 shard
- Feed delle conversioni: 1 shard
- Feed di disponibilità : meno di 20 shard
- Dimensioni dei file del feed e suddivisione in parti:
- Mantieni le dimensioni del file del frammento inferiori a 200 MB (dopo la compressione). Utilizza più shard, se necessario.
- I singoli record inviati in uno shard non devono essere inviati nello stesso shard nei feed futuri.
- Per migliorare le prestazioni, suddividi i dati in modo uniforme tra gli shard in modo che tutti i file degli shard abbiano dimensioni simili.
- Se necessario, utilizza gzip per comprimere i feed JSON in testo normale. Tuttavia, fai così per ogni singolo shard del feed.
Carica i feed nella tua casella personale SFTP
Per iniziare a caricare i feed, completa prima le istruzioni di configurazione. Successivamente, vai alla pagina Feed nel portale per i 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 del file di un descrittore di set di file deve essere <feed_name>-<
generation_timestamp>.filesetdesc.json,
in cui <feed_name> può essere
healthappointments.practitioner, healthappointments.facility,
healthappointments.appointment_type e healthappointments.availability.
Per ulteriori informazioni, consulta la sezione Utilizzare la dropbox del feed generico. Gli esempi sono disponibili nella nostra pagina Samples.
Verifica che i dati siano corretti
Accedi al Partner Portal. Passa all'ambiente Sandbox per trovare le seguenti pagine nella sezione Dashboard.
- Feed
- Mostra le statistiche di riepilogo del feed e segnala gli errori durante il caricamento del feed.
Per verificare che i dati siano corretti dopo il caricamento iniziale nell'ambiente sandbox, controlla la pagina Feed per verificare la presenza di eventuali errori.
Caricare i feed in produzione
Quando sarai in grado di caricare in modo coerente feed completi e privi di errori nell'ambiente sandbox, potrai iniziare a caricarli nell'ambiente di produzione. A questo punto, l'integrazione non sarà attiva.
Una volta che tutti i dati dei 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, Google li elabora e li valuta per verificarne la qualità e la completezza.