Schritt 2: Feeds

Feeds erstellen

Feeds müssen Google regelmäßig zur Verfügung gestellt werden, damit die Daten direkt auf Google angezeigt werden. Die folgenden Feeds sind erforderlich.

Feed Beschreibung Häufigkeit
Praktiker Enthält Daten zu Ärzten, einschließlich Links von Drittanbietern zur Buchung von Ärzten. (Entsprechung: FHIR-Nutzer) . [Nur für die Buchung bei bestimmten Ärzten erforderlich] Einmal alle 24 Stunden
Einrichtung Enthält Daten zu Gesundheitseinrichtungen/-standorten wie Laboren und Kliniken, einschließlich Links von Drittanbietern zur Buchung bei Einrichtungen. (entspricht FHIR-Speicherort) Einmal alle 24 Stunden
Termintyp Enthält eine Liste aller Termintypen, einschließlich ID und Name. z.B. Vorsorgeuntersuchung, kranker Patient und neuer Patient. Sie wird als Referenz verwendet, um Zeitpläne einzugrenzen. (entspricht dem FHIR-Termintyp) Einmal alle 24 Stunden
Verfügbarkeit Listet die verfügbaren Zeitblöcke für bestimmte Ärzte, Einrichtungen, Dienstleistungstypen und Termintypen auf. (entspricht dem FHIR-Slot) Für jede Kombination aus Arzt, Einrichtung und Termintyp muss eine Abdeckung von mindestens 24 Stunden ab dem nächsten verfügbaren Slot verfügbar sein. Alle 15 bis 60 Minuten
Conversion Teilen Sie die Conversion-Rate mit Google, einschließlich Messwerten für die Aufrufe der Links und die abgeschlossenen Buchungen. Einmal pro Woche

Das Feedformat wird mithilfe der Protobuf-3-Syntax beschrieben. In den Feedbeispielen finden Sie jedoch das JSON-Format. Wir empfehlen, die Feeds im JSON-Format hochzuladen.

Feeddateigröße, Sharding und Komprimierung

Sehen Sie sich die folgenden Anleitungen zu Komprimierung und Shards an:

Beachte die folgenden Richtlinien, um die Größe der Feeds zu bestimmen. Ein Feed kann aus mehreren Dateien bestehen, die als „Shards“ (Fragmente) bezeichnet werden.

  • Vorgeschlagene Feed-Sharding-Methode:
    • Feed für Praxisexperten: 1 Shard
    • Einrichtungsfeed: 1 Shard
    • Feed mit Termintyp: 1 Shard
    • Conversion-Feed: 1 Shard
    • Verfügbarkeitsfeed: weniger als 20 Shards
  • Größe von Feeddateien und Sharding:
    • Komprimierte Shard-Dateien dürfen maximal 200 MB groß sein. Verwende 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, sodass alle Shard-Dateien eine ähnliche Größe haben.
    • Bei Bedarf kannst du gzip verwenden, um JSON-Feeds im Nur-Text-Format zu komprimieren. Das muss für jeden Feed-Shard einzeln erledigt werden.

Feeds in deine SFTP-Dropbox hochladen

Bevor Sie Feeds hochladen können, müssen Sie zuerst die Einrichtungsanleitung durchgehen. Rufen Sie anschließend die Seite Feeds im Partner-Portal auf. Alle Feeds sollten in das Konto Generic hochgeladen werden.

Jeder Feed muss separat über SFTP mit einer Dateiensatz-Deskriptordatei hochgeladen werden. Der Dateiname eines Fileset-Beschreibungselements sollte <feed_name>-< generation_timestamp>.filesetdesc.json sein. Dabei kann <feed_name> healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type oder healthappointments.availability sein.

Weitere Informationen finden Sie unter Die allgemeine Dropbox für Feeds verwenden. Beispiele finden Sie auf der Seite Beispiele.

Daten prüfen

Melde dich im Partner-Portal an. Wechsle zur Sandbox-Umgebung und rufe die folgenden Seiten im Bereich Dashboards auf.

Feeds
Hier finden Sie zusammenfassende Statistiken zu Feeds und Informationen zu Fehlern, die beim Feedupload aufgetreten sind.

Auf der Seite Feeds kannst du nach dem ersten Upload in die Sandbox-Umgebung nachsehen, ob es Feedfehler gibt.

Feeds in die Produktionsumgebung hochladen

Sobald deine Feeds durchweg vollständig und fehlerfrei in der Sandbox hochgeladen werden, kannst du mit dem Upload in die Produktionsumgebung beginnen. Deine Integration ist dann noch nicht online.

Sobald alle Daten Ihres Produktionsfeeds regelmäßig hochgeladen und mit Ihrem Produktionssystem verbunden werden, können Ihre Feeds überprüft werden.

Google wertet Feeds aus

Sobald du deine Feeds hochgeladen hast, verarbeitet und bewertet Google sie auf Qualität und Vollständigkeit.