创建 Feed
您必须定期向 Google 提供 Feed,才能直接在 Google 上显示数据。需要以下 Feed。
动态 | 说明 | 频率 |
---|---|---|
从业者 | 包含描述从业者的数据,包括用于与从业者预约的第三方链接。(对应:FHIR 从业者) 。[仅当预约特定从业者时才需要] | 每 24 小时一次 |
设施 | 包含描述医疗保健机构/地点(例如实验室检测中心和诊所)的数据,其中包括用于预约医疗机构的第三方链接。 (对应项:FHIR 位置) | 每 24 小时一次 |
预约类型 | 包含所有预约类型的列表,包括 ID 和名称。例如,体检、生病和新病人。系统会将其用作参考,以缩小时间表范围。 (对应项:FHIR 预约类型) | 每 24 小时一次 |
适用的国家/地区 | 列出指定从业者、设施、服务类型和预约类型的可用空档。(对应项:FHIR 空档) 对于每种执业者、设施和预约类型组合,必须提供从下一个空档开始的至少 24 小时的覆盖范围。 | 每 15-60 分钟一次 |
转化 | 与 Google 分享转化率,包括访问链接和完成预约的指标。 | 每周一次 |
使用 Protocol Buffer 3 语法描述 Feed 格式,但您可以参阅 Feed 示例查看 JSON 格式。我们建议您以 JSON 格式上传 Feed。
Feed 文件大小、分片和压缩
请查看以下有关压缩和分片的教程:如需确定 Feed 的大小,请遵循以下指南(Feed 可由多个名为“分片”的文件组成):
- 建议的 Feed 分片:
- 从业者 Feed:1 个分片
- 设施 Feed:1 个分片
- 预约类型 Feed:1 个分片
- 转化 Feed:1 个分片
- 可用性 Feed:不到 20 个分片
- Feed 文件和分片的大小:
- 确保分片文件小于 200 MB(压缩后)。如有需要,请使用多个分片。
- 在一个分片中发送的各个记录无需在未来 Feed 中的同一分片中发送。
- 为实现更好的性能,您应将数据平均分到各个分片,使所有分片文件的大小相近。
- 如有必要,请使用 gzip 压缩纯文本 JSON Feed。但是,请分别对每个 Feed 分片执行压缩操作。
将 Feed 上传到 SFTP Dropbox
如需开始上传 Feed,请先完成设置说明。然后,前往合作伙伴门户中的Feed 页面。所有 Feed 都应上传到通用账号。
每个 Feed 都需要单独通过 SFTP 上传,并附上文件集描述符文件。
文件集描述符的文件名应为 <feed_name>-<
generation_timestamp>.filesetdesc.json,其中 <feed_name> 可以是 healthappointments.practitioner
、healthappointments.facility
、healthappointments.appointment_type
和 healthappointments.availability
。
如需了解详情,请参阅使用通用的 Feed Dropbox。您可以访问我们的 示例页面查看示例。
确认数据准确无误
登录合作伙伴门户。切换到沙盒环境,以在信息中心部分找到以下页面。
- Feed
- 显示 Feed 摘要统计信息,并指出 Feed 上传过程中的错误。
如需确认您的数据在最初上传到沙盒环境后准确无误,请检查 Feed 页面是否存在 Feed 错误。
将 Feed 上传到生产环境中
如果您始终能将完整的 Feed 正确无误地上传到沙盒环境,则可以开始将其上传到生产环境中。 目前,您的集成尚未生效。
当所有正式版 Feed 数据都能持续上传并连接到正式版系统后,您的 Feed 就可以送审了。
Google 对 Feed 进行评估
您上传 Feed 后,Google 会对 Feed 进行处理并评估其质量和完整性。