Feeds erstellen
Feeds müssen Google regelmäßig zur Verfügung gestellt werden, damit die Daten direkt auf Google angezeigt werden können. Die folgenden Feeds sind erforderlich.
| Feed | Beschreibung | Frequenz |
|---|---|---|
| Praxisexperte | Enthält Daten, die Fachkräfte beschreiben, einschließlich Links von Drittanbietern zu Buchungen bei Fachkräften. (Gegenstück: FHIR practitioner) [Nur bei Buchungen bei bestimmten Fachärzten erforderlich] | Alle 24 Stunden |
| Einrichtung | Enthält Daten zu Gesundheitseinrichtungen oder -standorten wie Labortestzentren und Kliniken, einschließlich Links von Drittanbietern zu Buchungen bei Einrichtungen. (Gegenstück: FHIR-Standort) | Alle 24 Stunden |
| Art des Termins | Enthält eine Liste aller Termintypen, einschließlich ID und Name. z.B. Check-up, Krankheit oder neue Patientinnen und Patienten. Er dient als Referenz, um die Zeitpläne einzugrenzen. (Gegenstück: FHIR-Termintyp) | Alle 24 Stunden |
| Verfügbarkeit | Listet die verfügbaren Slots für bestimmte Fachkräfte, Einrichtungen, Dienstleistungs- und Termintypen auf. (Gegenstück: FHIR-Zeitblock) Für jede Kombination aus Arzt, Einrichtung und Termintyp muss ab dem nächsten verfügbaren Slot eine Abdeckung von mindestens 24 Stunden angegeben werden. | Alle 15 bis 60 Minuten |
| Conversion | Sie können die Conversion-Rate mit Google teilen, einschließlich Messwerten für den Besuch der Links und das Abschließen von Terminbuchungen. | Einmal pro Woche |
Das Feedformat wird mit der Protokollpuffer-3-Syntax beschrieben. Das JSON-Format finden Sie in den Feedbeispielen. Wir empfehlen, die Feeds im JSON-Format hochzuladen.
Größe, Fragmentierung und Komprimierung von Feeddateien
In den folgenden Anleitungen wird die Komprimierung und Shards beschrieben:Beachte die folgenden Richtlinien, um die Größe der Feeds zu bestimmen (ein Feed kann aus mehreren Dateien bestehen, die als „Shards“ bezeichnet werden):
- Vorgeschlagene Feedfragmentierung:
- Feed für Ärzte: 1 Shard
- Einrichtungsfeed: 1 Shard
- Feed für Termintyp: 1 Shard
- Conversion-Feed: 1 Shard
- Verfügbarkeitsfeed: weniger als 20 Shards
- Größe der Feeddateien und Fragmentierung:
- Komprimierte Shard-Dateien dürfen maximal 200 MB groß sein. Verwenden Sie bei Bedarf mehrere Shards.
- Einzelne Datensätze, die in einem Shard gesendet werden, müssen in zukünftigen Feeds nicht im selben Shard gesendet werden.
- Für eine bessere Leistung sollten die Daten gleichmäßig auf die Shards aufgeteilt werden, damit alle Shard-Dateien eine ähnliche Größe haben.
- Bei Bedarf kannst du gzip verwenden, um JSON-Feeds im Nur-Text-Format zu komprimieren. Tun Sie dies jedoch für jeden einzelnen Feed-Shard.
Feeds in deine SFTP-Dropbox hochladen
Schließen Sie zuerst die Einrichtungsanleitung ab, um mit dem Hochladen von Feeds zu beginnen. Rufen Sie dann im Partner-Portal die Seite Feeds auf. Alle Feeds sollten in das Konto Allgemein hochgeladen werden.
Jeder Feed muss separat über SFTP hochgeladen werden und enthält eine Dateisatz-Deskriptor-Datei.
Der Dateiname eines Dateisatzdeskriptors sollte <feed_name>-<generation_timestamp>.filesetdesc.json lauten, wobei <feed_name> healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type und healthappointments.availability sein könnte.
Weitere Informationen findest du unter Allgemeine Feed-Dropbox verwenden. Beispiele finden Sie auf der Seite Beispiele.
Daten prüfen
Melde dich im Partner-Portal an. Wechseln Sie zur Sandbox-Umgebung, um die folgenden Seiten im Bereich Dashboards zu finden.
- Feeds
- Zeigt Zusammenfassungsstatistiken des Feeds an und weist auf Fehler während des Feeduploads hin.
Wenn du prüfen möchtest, ob deine Daten nach dem ersten Upload in die Sandbox-Umgebung korrekt angezeigt werden, prüfe die Seite Feeds auf Feedfehler.
Feeds in die Produktionsumgebung hochladen
Sobald du in der Lage bist, vollständige, fehlerfreie Feeds in die Sandbox-Umgebung hochzuladen, kannst du mit dem Upload in die Produktionsumgebung beginnen. Deine Integration ist dann nicht aktiv.
Sobald alle Daten Ihres Produktionsfeeds konsistent hochgeladen und mit dem Produktionssystem verbunden sind, können Ihre Feeds überprüft werden.
Google wertet Feeds aus
Sobald du deine Feeds hochgeladen hast, werden sie von Google verarbeitet und auf Qualität und Vollständigkeit überprüft.