Crea tus feeds
Los feeds se deben proporcionar a Google de forma periódica para que los datos se muestren directamente en Google. Se necesitan los siguientes feeds.
| Feed | Descripción | Frecuencia |
|---|---|---|
| Profesional | Contiene datos que describen a los profesionales, incluidos vínculos de terceros para reservar con ellos. (contraparte: practicante 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, que incluyen vínculos de terceros para reservar con 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., revisión, paciente enfermo y nuevo. Se usará como referencia para acotar los horarios. (contraparte: tipo de cita de FHIR) | Una vez cada 24 horas |
| Disponibilidad | Muestra los horarios disponibles para determinados profesionales, instalaciones, tipos de servicios y tipos de citas. (contraparte: horario de FHIR) Se debe proporcionar un mínimo de 24 horas de cobertura a partir del siguiente horario disponible para cada combinación de profesional, institución y tipo de cita. | Una vez cada 15 a 60 minutos |
| Conversión | Compartir el porcentaje de conversiones con Google, incluidas las métricas para visitar los vínculos y completar citas de reserva | Una vez a la semana |
El formato de los feeds se describe con la sintaxis del búfer de protocolo 3. Sin embargo, puedes consultar los ejemplos de feeds para ver el formato JSON. Te recomendamos que subas los feeds en formato JSON.
Tamaño, fragmentación y compresión del archivo del feed
Consulta los siguientes instructivos sobre la compresión y los fragmentos:Para determinar el tamaño de los feeds, utiliza los siguientes lineamientos (un feed puede estar compuesto por varios archivos llamados "fragmentos"):
- Fragmentación de feed sugerida:
- Feed de profesionales: 1 fragmento
- Feed de instalaciones: 1 fragmento
- Feed de tipos de citas: 1 fragmento
- Feed de conversiones: 1 fragmento
- 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 que los registros individuales que se envían en un Shard se envíen en el mismo Shard en futuros feeds.
- Para obtener un mejor rendimiento, divide los datos de manera uniforme entre los Shards a fin de 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 Feeds en el portal de socios. Todos los feeds se deben subir a la cuenta Genérica.
Cada feed se debe subir 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.
Consulta Cómo utilizar el buzón de feeds genérico para obtener más información. Los ejemplos están disponibles en nuestra página Samples.
Confirma que los datos son correctos
Accede al Portal para socios. Cambia al entorno Sandbox y encontrarás las siguientes páginas en la sección Dashboards.
- Feeds
- Muestra las estadísticas de resumen del feed y señala errores durante la carga del feed.
Para confirmar que tus datos se ven correctos después de la carga inicial en el entorno de la zona de pruebas, revisa la página Feeds y comprueba si hay algún error en el feed.
Sube tus feeds a producción
Una vez que los feeds que subas al entorno de la zona de pruebas estén siempre completos y no tengan errores, 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 coherente y se conecten a tu sistema de producción, tus feeds estarán listos para su revisión.
Google evalúa los feeds
Una vez que subas los feeds, Google los procesará y evaluará su integridad y calidad.