第 2 步:Feed

创建 Feed

您必须定期向 Google 提供 Feed,数据才能直接在 Google 上显示。 您需要提供以下 Feed。

信息流 说明 频率
实操人员 包含描述从业者的数据,包括用于向从业者进行预订的第三方链接。(副本:FHIR 从业者) 。[仅在向特定从业者预约时需要] 每 24 小时一次
设施 包含描述医疗保健机构/地点(如实验室检测中心和诊所)的数据,其中包括用于向机构进行预订的第三方链接。 (副本:FHIR location 每 24 小时一次
预约类型 包含所有预约类型(包括 ID 和名称)的列表。例如,检查、生病和新患者。您可以参考该时间表来缩小时间表。 (对应项:FHIR 预约类型 每 24 小时一次
适用的国家/地区 列出给定从业者、设施、服务类型和预约类型的可用性空档。(副本:FHIR 时段) 对于每个从业者、设施和预约类型组合,必须提供从下一个可用空档开始至少 24 小时的覆盖时间。 每 15-60 分钟一次
转化 与 Google 分享转化率,包括有关访问链接和完成预约的指标。 每周一次

Feed 格式使用 Protocol Buffer 3 语法进行描述,不过,您可以参考 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 的质量和完整性