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 link di terze parti per effettuare prenotazioni con i professionisti. (controparte: professionista FHIR) . [Obbligatorio solo per la prenotazione con professionisti specifici] | Una volta ogni 24 ore |
| Struttura | Contiene dati che descrivono le strutture sanitarie o le sedi, come centri per i test di laboratorio e cliniche, tra cui link di terze parti per effettuare prenotazioni presso le strutture. (controparte: località FHIR) | Una volta ogni 24 ore |
| Tipo di appuntamento | Contiene un elenco di tutti i tipi di appuntamento, inclusi ID e nome. Ad esempio check-up, nuovo paziente e malato. Verrà utilizzato come riferimento per restringere le pianificazioni. (controparte: tipo di appuntamento FHIR) | Una volta ogni 24 ore |
| Disponibilità | Elenca gli spazi di disponibilità per professionisti, strutture, tipi di servizi e tipi di appuntamento specifici. (controparte: fHIR slot) È necessario fornire almeno 24 ore di copertura a partire dal successivo spazio 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 la prenotazione di appuntamenti. | Una volta alla settimana |
Il formato dei feed è descritto con la sintassi del buffer di protocollo 3, ma puoi fare riferimento agli esempi di feed per visualizzare il formato JSON. Ti consigliamo di caricare i feed in formato JSON.
Dimensioni del file del feed, partizionamento orizzontale e compressione
Visualizza i seguenti tutorial relativi a compressione e shard:Per determinare le dimensioni dei feed, segui queste linee guida (un feed può essere costituito da più file denominati "shards"):
- Partizionamento orizzontale del feed suggerito:
- Feed del professionista: 1 shard
- Feed della struttura: 1 shard
- Feed del tipo di appuntamento: 1 shard
- Feed di conversione: 1 shard
- Feed di disponibilità : meno di 20 shard
- Dimensioni dei file del feed e partizionamento orizzontale:
- Mantieni le dimensioni del file shard al di sotto di 200 MB (dopo la compressione). Se necessario, utilizza più shard.
- Non è necessario che i singoli record inviati in uno shard vengano inviati nello stesso shard nei feed futuri.
- Per migliorare le prestazioni, suddividi i dati in modo uniforme tra gli shard in modo da rendere tutti i file shard simili.
- Se necessario, utilizza gzip per comprimere i feed JSON di testo normale. Tuttavia, esegui questa operazione per ogni singolo shard del feed.
Caricare i feed nella casella personale SFTP
Per iniziare a caricare i feed, completa le istruzioni di configurazione. In seguito, vai alla pagina Feed nel portale dei partner. Tutti i feed devono essere caricati nell'account Generico.
Ogni feed deve essere caricato tramite SFTP separatamente con un file descrittore del set di file.
Il nome file di un descrittore di un 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.availability.
Per ulteriori informazioni, visita la pagina relativa all'utilizzo della casella personale del feed generico. Alcuni esempi sono disponibili nella nostra pagina Esempi.
Verifica che i dati siano corretti
Accedi al Partner Portal. Passa all'ambiente Sandbox per trovare le pagine seguenti 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, consulta la pagina Feed per individuare eventuali errori nel feed.
Carica i feed in produzione
Una volta riuscito a caricare regolarmente feed completi e privi di errori nell'ambiente sandbox, puoi iniziare a caricarli nell'ambiente di produzione. A questo punto la tua integrazione non sarà attiva.
Quando tutti i dati del feed di produzione vengono caricati in modo coerente e collegati al tuo sistema di produzione, i feed sono pronti per la revisione.
Google valuta i feed
Una volta caricati i feed, Google li elabora e li valuta per verificarne la qualità e la completezza.