Flux

Créez des flux

Les flux doivent être envoyés à Google régulièrement 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 décrivant les professionnels, y compris des liens tiers pour les réservations avec les professionnels. (contre: professionnel FHIR) . [Obligatoire uniquement pour une réservation auprès de professionnels spécifiques] Toutes les 24 heures
Emplacement Contient des données décrivant les établissements/établissements de santé (centres de dépistage ou cliniques, par exemple), y compris les liens tiers pour les réservations. (contre: emplacement FHIR) Toutes les 24 heures
Type de rendez-vous Contient une liste de tous les types de rendez-vous, y compris l'ID et le nom. Ex. : contrôle, maladie et nouveau patient. Il servira de référence pour affiner les calendriers. (Réponse : Type de rendez-vous FHIR) Toutes les 24 heures
Disponibilité Répertorie les créneaux de disponibilité pour les professionnels, les installations, les types de services et les types de rendez-vous donnés. (emplacement de l'emplacement FHIR) Vous devez offrir une couverture minimale de 24 heures à partir du prochain créneau disponible pour chaque praticien, site et type de rendez-vous. Toutes les 15 à 60 minutes
Conversion Partagez le taux de conversion avec Google, y compris les métriques permettant d'accéder aux liens et de prendre des rendez-vous de réservation. Une fois par semaine

Le format des flux est décrit avec la syntaxe du Protocol Buffer 3. Toutefois, vous pouvez consulter les exemples de flux pour connaître 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 concernant 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 pour le flux :
    • Flux pour les professionnels: 1 segment
    • Flux d'installations: 1 segment
    • Flux par type de rendez-vous: 1 segment
    • Flux de conversions: 1 segment
    • Flux disponibilité : moins de 20 segments
  • Taille des fichiers de flux et de la segmentation :
    • Assurez-vous que la taille du fichier segmenté ne dépasse pas 200 Mo (après compression). Utilisez plusieurs segments si nécessaire.
    • Les enregistrements individuels envoyés dans un segment ne doivent pas nécessairement l'être 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 de partition soit similaire.
    • Si nécessaire, utilisez gzip pour compresser les flux au format JSON texte brut. Toutefois, cette opération doit être effectuée pour chaque segment du flux.

Importer les flux dans votre compte "Envoi sécurisé" SFTP

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

Veillez à importer tous les flux liés aux rendez-vous médicaux dans le compte "Générique".
Assurez-vous d'importer tous les rendez-vous médicaux associés dans le compte "Générique".

Chaque flux doit être importé séparément via SFTP à l'aide d'un fichier descripteur de l'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> 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. Des exemples sont disponibles sur la page Exemples.

Vérifier l'exactitude de vos données

Connectez-vous au portail des partenaires. Basculez vers l'environnement Sandbox pour trouver les pages suivantes dans la section Tableaux de bord.

Flux
Présente les statistiques récapitulatives du flux et indique les erreurs détectées lors de son importation.

Pour vérifier que vos données s'affichent correctement après votre importation initiale dans l'environnement de bac à sable, consultez la page Flux.

Importer vos flux en production

Une fois que vous êtes en mesure d'importer régulièrement des flux complets 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 mise en ligne.

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 que vous avez importé vos flux, Google les traite et les évalue pour en vérifier la qualité et l'exhaustivité.