Paso 2: Feeds

Crea feeds

Se deben proporcionar a Google con regularidad para que los datos se muestren directamente en la plataforma. Se necesitan los siguientes feeds.

Feed Descripción Frecuencia
Profesional Contiene datos que describen a los profesionales, incluidos vínculos de terceros para realizar reservas. (contraparte: Profesional de FHIR). [Obligatorio solo para reservas con profesionales específicos] Una vez cada 24 horas
Instalaciones Contiene datos que describen instalaciones o ubicaciones de atención médica, como centros de pruebas de laboratorio y clínicas, lo que incluye vínculos de terceros para hacer reservas en las instalaciones. (contraparte: ubicación de FHIR) Una vez cada 24 horas
Tipo de cita Contiene una lista de todos los tipos de citas, incluidos el ID y el nombre. P.ej., chequeo, paciente enfermo y paciente nuevo. Se usará como referencia para acotar los programas. (contraparte: Tipo de cita de FHIR) Una vez cada 24 horas
Disponibilidad Enumera los horarios disponibles para profesionales, instalaciones, tipos de servicios y tipos de citas determinados. (Contraparte: Horario disponible para FHIR) Se debe proporcionar un mínimo de 24 horas de cobertura a partir del siguiente horario disponible disponible para cada combinación de profesional, centro y tipo de cita. Una vez cada 15 a 60 minutos
Conversión Comparte el porcentaje de conversiones con Google, incluidas las métricas de visitas a los vínculos y de reservas de citas. Una vez por semana

El formato de los feeds se describe mediante la sintaxis del búfer de protocolo 3. Sin embargo, puedes consultar las muestras de feed para ver el formato JSON. Te recomendamos que subas los feeds en formato JSON.

Tamaño, fragmentación y compresión del archivo de feed

Consulta los siguientes instructivos sobre la compresión y los fragmentos:

Para determinar el tamaño de los feeds, usa los siguientes lineamientos (un feed puede constar de varios archivos llamados "fragmentos"):

  • Fragmentación de feeds sugerida:
    • Feed para profesionales: 1 fragmento
    • Feed de instalaciones: 1 fragmento
    • Feed de tipo de cita: 1 shard
    • Feed de conversión: 1 shard
    • Feed de disponibilidad: menos de 20 Shards
  • Tamaño de los archivos del feed y fragmentación:
    • El tamaño de cada archivo debe ser inferior a los 200 MB (después de la compresión). Usa varios fragmentos si es necesario.
    • No es necesario enviar los registros individuales que se envían en un fragmento en el mismo fragmento en feeds futuros.
    • Si deseas obtener un mejor rendimiento, divide los datos de manera uniforme entre los fragmentos para que todos tengan un tamaño similar.
    • Si es necesario, usa gzip para comprimir los feeds JSON de texto sin formato. Sin embargo, hazlo para cada fragmento de feed individual.

Sube los feeds a tu buzón de SFTP

Para comenzar a subir feeds, primero completa las instrucciones de configuración. Luego, navega a la página de feeds en el Portal para socios. Todos los feeds deben subirse a la cuenta Genérica.

Cada feed debe subirse a través de SFTP por separado con un archivo descriptor de conjunto de archivos. El nombre de archivo de un descriptor de conjunto de archivos debe ser <feed_name>-< generation_timestamp>.filesetdesc.json, en el que <feed_name> podría ser healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type y healthappointments.availability.

Para obtener más información, visita Cómo usar el dropbox de feed genérico. Hay ejemplos disponibles en nuestra página Muestras.

Confirma que los datos son correctos

Accede al Portal para socios. Cambia al entorno Zona de pruebas para encontrar las siguientes páginas en la sección Paneles.

Feeds
Muestra las estadísticas de resumen del feed y señala errores durante la carga del feed.

Para confirmar que tus datos se vean correctos después de la carga inicial al entorno de la zona de pruebas, consulta la página Feeds para ver si hay errores en el feed.

Sube tus feeds a producción

Una vez que puedas subir feeds completos y sin errores de forma constante al entorno de la zona de pruebas, podrás comenzar a subirlos al entorno de producción. En este momento, tu integración no estará activa.

Una vez que todos los datos de tu feed de producción se suban de forma constante y se conecten al sistema de producción, los feeds estarán listos para revisarse.

Google evalúa los feeds

Una vez que subes tus feeds, Google los procesa y evalúa en cuanto a su integridad y calidad.