Créez des flux
Les flux doivent être envoyés régulièrement à Google pour que les données s'affichent directement sur Google. Les flux suivants sont nécessaires.
| Flux | Description | Fréquence |
|---|---|---|
| Professionnel | Contient des données sur les professionnels, y compris des liens tiers vers les réservations auprès des professionnels. (équivalent: professionnel FHIR). [Obligatoire uniquement pour les réservations auprès de professionnels spécifiques] | Une fois toutes les 24 heures |
| Emplacement | Contient des données décrivant les établissements/lieux de santé, tels que les centres de dépistage et les cliniques, y compris des liens tiers vers les réservations auprès des établissements. (équivalent: localisation FHIR) | Une fois toutes les 24 heures |
| Type de rendez-vous | Contient une liste de tous les types de rendez-vous, y compris l'identifiant et le nom. (examen de contrôle, malade ou nouveau patient, par exemple). Il servira de référence pour affiner les horaires. (équivalent: type de rendez-vous FHIR) | Une fois toutes les 24 heures |
| Disponibilité | Répertorie les créneaux de disponibilité pour des professionnels, des établissements, des types de services et de rendez-vous donnés. (équivalent: créneau FHIR) Une couverture d'au moins 24 heures à partir du prochain créneau disponible doit être fournie pour chaque combinaison de professionnel, de lieu et de type de rendez-vous. | Toutes les 15 à 60 minutes |
| Conversion | Partagez le taux de conversion avec Google, y compris les métriques sur la visite des liens et les prises de rendez-vous. | Une fois par semaine |
Le format des flux est décrit à l'aide de la syntaxe du Protocol Buffer 3, mais vous pouvez consulter les exemples de flux pour voir le format JSON. Nous vous recommandons d'importer les flux au format JSON.
Taille, segmentation et compression des fichiers de flux
Veuillez consulter les tutoriels suivants sur la compression et les segments :Pour déterminer la taille des flux, respectez les consignes suivantes (un flux peut être constitué de plusieurs fichiers appelés "segments"):
- Segmentation suggérée des flux :
- Flux des professionnels: 1 segment
- Flux d'installations: 1 segment
- Flux de types de rendez-vous: 1 segment
- Flux de conversion: 1 segment
- Flux disponibilité : moins de 20 segments
- Taille des fichiers de flux et segmentation :
- Assurez-vous que la taille du fichier segmenté ne dépasse pas 200 Mo (après compression). Si nécessaire, utilisez plusieurs segments.
- Les enregistrements individuels envoyés dans un segment n'ont pas besoin d'être envoyés dans le même segment dans les futurs flux.
- Pour de meilleures performances, répartissez les données de manière égale entre les segments, afin que la taille de tous les fichiers segmentés soit similaire.
- Si nécessaire, utilisez gzip pour compresser les flux au format JSON texte brut. Toutefois, faites-le pour chaque segment de flux individuel.
Importer les flux dans votre compte "Envoi sécurisé" SFTP
Pour commencer à importer des flux, suivez d'abord les instructions de configuration. Accédez ensuite à la page Flux sur le portail des partenaires. Tous les flux doivent être importés dans le compte générique.
Chaque flux doit être importé séparément via SFTP avec un fichier descripteur d'ensemble de fichiers.
Le nom de fichier d'un descripteur d'ensemble de fichiers doit être <feed_name>-<generation_timestamp>.filesetdesc.json, où <feed_name> pourrait être healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type et healthappointments.availability.
Pour en savoir plus, consultez Utiliser la boîte de dépôt de flux générique. Des exemples sont disponibles sur la page Exemples.
Vérifier l'exactitude de vos données
Connectez-vous au portail des partenaires. Passez à l'environnement Bac à sable pour accéder aux pages suivantes dans la section Tableaux de bord.
- Flux
- Affiche un récapitulatif des statistiques du flux et signale les erreurs survenues lors de son importation.
Pour vérifier que vos données sont correctes après votre importation initiale dans l'environnement de bac à sable, consultez la page Flux pour identifier d'éventuelles erreurs de flux.
Importer vos flux en production
Une fois que vous êtes en mesure d'importer régulièrement des flux complets et sans erreur dans l'environnement de bac à sable, vous pouvez commencer à les importer dans l'environnement de production. À ce stade, votre intégration ne sera pas publiée.
Une fois que toutes les données de votre flux de production sont importées régulièrement et connectées à votre système de production, vos flux sont prêts à être examinés.
Google évalue les flux
Une fois que vous avez importé vos flux, Google les traite et les évalue pour en vérifier la qualité et l'exhaustivité.