Crea 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 |
|---|---|---|
| Practicante | Contiene datos que describen a los profesionales, como vínculos de terceros para reservar con ellos. (contraparte: profesor de FHIR) . [Obligatorio solo para reservas con profesionales específicos] | Una vez cada 24 horas |
| Instalaciones | Contiene datos que describen ubicaciones y centros de atención médica, como clínicas o centros de pruebas en laboratorios, que incluyen vínculos de terceros para reservar con 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, enfermo y paciente nuevo. Se usará como referencia para reducir los programas. (contraparte: Tipo de cita de FHIR) | Una vez cada 24 horas |
| Disponibilidad | Enumera las ranuras de disponibilidad para profesionales, instalaciones, tipos de servicios y tipos de citas determinados. (contraparte: horario disponible) Se debe proporcionar un mínimo de 24 horas de cobertura a partir del siguiente horario 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 para visitar vínculos y completar citas de reservas. | Una vez por semana |
El formato de los feeds se describe con la sintaxis del búfer de protocolo 3. Sin embargo, puedes consultar las muestras 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, usa los siguientes lineamientos (un feed puede constar de varios archivos llamados "Shards"):
- Fragmentación de feed sugerida:
- Feed del profesional: 1 Shard
- Feed de instalaciones: 1 Shard
- 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 que los registros individuales que se envían en un Shard se envíen en el mismo Shard en los feeds futuros.
- 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, debes hacerlo para cada fragmento de feed.
Sube los feeds a tu buzón de SFTP
Para comenzar a subir feeds, primero sigue las instrucciones de Configuración. Luego, navega hasta la página feeds en el portal de socios. Todos los feeds se deben subir a la cuenta Genérica.
Cada feed debe subirse mediante SFTP con un archivo descriptor de conjunto de archivos. El nombre de un descriptor de conjunto de archivos debe ser <feed_name>-< generation_timestamp>.filesetdesc.json, en el que <feed_name> podría ser healthappointments.professionals, healthappointments.facility, healthappointments.appointment_type y healthappointments.availability.
Para obtener más información, consulta Cómo utilizar el dropbox de feed genérico. Encontrarás ejemplos 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 los errores durante la carga del feed.
Para confirmar que los datos sean correctos después de la carga inicial en el entorno de la zona de pruebas, consulta la página Feeds y busca errores del feed.
Sube tus feeds a producción
Una vez que puedas subir constantemente feeds completos y sin errores al entorno de la zona de pruebas, puedes comenzar a subir los datos al entorno de producción. En este punto, tu integración no estará activa.
Una vez que todos los datos del feed de producción se suban de forma constante y estén conectados a tu sistema de producción, tus feeds estarán listos para revisión.
Google evalúa los feeds
Una vez que subes los feeds, Google los procesa y evalúa su calidad y exhaustividad.