第 2 步:Feed

创建 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.practitionerhealthappointments.facilityhealthappointments.appointment_typehealthappointments.availability

如需了解详情,请参阅使用通用的 Feed Dropbox。您可以访问我们的 示例页面查看示例。

确认数据准确无误

登录合作伙伴门户。切换到沙盒环境,以在信息中心部分找到以下页面。

Feed
显示 Feed 摘要统计信息,并指出 Feed 上传过程中的错误。

如需确认您的数据在最初上传到沙盒环境后准确无误,请检查 Feed 页面是否存在 Feed 错误。

将 Feed 上传到生产环境中

如果您始终能将完整的 Feed 正确无误地上传到沙盒环境,则可以开始将其上传到生产环境中。 目前,您的集成尚未生效。

所有正式版 Feed 数据都能持续上传并连接到正式版系统后,您的 Feed 就可以送审了。

Google 对 Feed 进行评估

您上传 Feed 后,Google 会对 Feed 进行处理并评估其质量和完整性。