Étape 2: Flux

Créez des flux :

Vous devez fournir régulièrement des flux à Google pour que les données soient diffusées directement sur Google. Les flux suivants sont nécessaires.

Flux Description Fréquence
Professionnel de santé Inclut des données décrivant les professionnels, y compris des liens tiers permettant de prendre rendez-vous avec eux. (contrepartie: praticien FHIR) . [Obligatoire uniquement pour les réservations auprès de praticiens spécifiques] Une fois toutes les 24 heures
Équipement Contient des données décrivant des établissements de santé, comme des centres d'analyses et des cliniques, y compris des liens tiers permettant de réserver des services auprès de ces établissements. (équivalent: emplacement FHIR) Une fois toutes les 24 heures
Type de rendez-vous Contient la liste de tous les types de rendez-vous, y compris leur ID et leur nom. Par exemple : consultation, maladie et nouveau patient. 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 praticiens, des établissements, des types de services et des types de rendez-vous donnés. (équivalent: créneau FHIR) Un délai de couverture d'au moins 24 heures à compter du prochain créneau disponible doit être fourni pour chaque combinaison de praticien, d'établissement et de type de rendez-vous. Une fois toutes les 15 à 60 minutes
Conversion Partagez le taux de conversion avec Google, y compris les métriques sur les visites des liens et la prise de rendez-vous. Une fois par semaine

Le format des flux est décrit à l'aide de la syntaxe du Protocol Buffer 3. Vous pouvez toutefois 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 fragments :

Pour déterminer la taille des flux, tenez compte des consignes suivantes (notez qu'un flux peut comprendre plusieurs fichiers appelés "segments"):

  • Segmentation suggérée pour chaque flux :
    • Flux des professionnels: 1 segment
    • Flux d'établissements: 1 segment
    • Flux de type 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 ne doivent pas nécessairement être envoyés dans le même segment dans les flux à venir.
    • 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 la même.
    • Si nécessaire, utilisez gzip pour compresser les flux au format JSON texte brut. Toutefois, faites-le pour chaque segment de vos flux.

Importer les flux dans votre boîte de dépôt SFTP

Pour commencer à importer des flux, suivez d'abord les instructions de configuration. Accédez ensuite à la page Flux du portail des partenaires. Tous les flux doivent être importés dans le compte Generic.

Chaque flux doit être importé séparément via SFTP avec un fichier descripteur de fichiers. Le nom de fichier d'un descripteur de fichier doit être <nom_flux>-< génération_code_temporel>.filesetdesc.json, dans lequel <nom_flux> peut être healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type et healthappointments.availability.

Pour en savoir plus, consultez Utiliser la boîte de dépôt du flux générique. Vous trouverez des exemples sur notre page Exemples.

Vérifier l'exactitude de vos données

Connectez-vous au portail des partenaires. Passez à l'environnement de bac à sable afin de rechercher les pages suivantes dans la section Dashboards (Tableaux de bord).

Flux
Affiche un récapitulatif des statistiques du flux et signale toute erreur enregistrée lors de l'importation du flux.

Pour vérifier l'exactitude de vos données après votre importation initiale dans l'environnement de bac à sable et détecter d'éventuelles erreurs, consultez la page Flux.

Importer vos flux en production

Lorsque vous arrivez au point de pouvoir 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 n'est pas encore publiée.

Une fois que toutes les données de votre flux de production sont importées de manière cohérente et connectées à votre système de production, vos flux sont prêts à être examinés.

Google évalue les flux

Une fois vos flux importés, Google les traite et les évalue pour en vérifier la qualité et s'assurer qu'ils comportent tous les éléments requis.