步驟 2:動態饋給

建立動態饋給

你必須定期向 Google 提供動態饋給,資料才能直接顯示在 Google 上。 你需要提供下列動態饋給。

動態消息 說明 頻率
醫師 包含描述執業人員的資料,包括與執業人員預約的第三方連結。(對應項目:FHIR 實務人員) . [僅適用於預約特定執業人員] 每 24 小時一次
設施 包含描述醫療照護機構/地點的資料,例如檢驗中心和診所,其中包括與機構預約的第三方連結。(對應項目:FHIR 位置) 每 24 小時一次
預約類型 包含所有預約類型的清單,包括 ID 和名稱。例如:健康檢查、生病和新病患。系統會參考這項資訊,縮小排程範圍。 (對應項目:FHIR 預約類型) 每 24 小時一次
適用地區 列出特定醫師、機構、服務類型和預約類型的供應時段。(對應項目:FHIR 時段) 每個醫師、機構和預約類型組合,必須提供至少 24 小時的覆蓋範圍,從下一個可用時段開始。 每 15 到 60 分鐘一次
轉換 與 Google 分享轉換率,包括造訪連結和完成預約的指標。 每週一次

您需要使用 Protocol Buffers 第 3 版的語法來說明動態饋給的格式,不過您可以參考動態饋給範例,查看 JSON 格式。建議你以 JSON 格式上傳動態饋給。

動態饋給檔案大小、分割和壓縮

請觀看以下教學課程,瞭解壓縮和分割:

如要判斷動態饋給的大小,請參考下列指南 (動態饋給可由多個「資料分片」檔案組成):

  • 建議的動態饋給資料分割方式如下:
    • 從業人員動態饋給:1 個資料分片
    • 設施動態饋給:1 個資料分片
    • 預約類型動態饋給:1 個資料分片
    • 轉換動態饋給:1 個資料分片
    • 預訂情形動態饋給:少於 20 個資料分片
  • 動態饋給檔案和資料分片的大小:
    • 資料分片檔案大小不超過 200 MB (壓縮後大小);視需要使用多個資料分片。
    • 已透過單一資料分片傳送的個別記錄,在日後的動態饋給中不需要再透過同一個資料分片傳送。
    • 為提升效能,請將資料平均分配給資料分片,讓所有資料分片檔案的大小都相似。
    • 可視需要使用 gzip 壓縮純文字 JSON 動態饋給,但請為每個動態饋給資料分片分別進行這項作業。

將動態饋給上傳至安全檔案傳輸通訊協定 Dropbox

如要開始上傳動態饋給,請先完成設定操作說明。接著,前往合作夥伴入口網站的「動態饋給」頁面。所有動態饋給都應上傳至「Generic」帳戶。

每個動態饋給都必須透過 SFTP 個別上傳,並附上檔案集描述檔。檔案集描述元的檔案名稱應為 <feed_name>-< generation_timestamp>.filesetdesc.json,其中 <feed_name> 可以是 healthappointments.practitionerhealthappointments.facilityhealthappointments.appointment_typehealthappointments.availability

詳情請參閱「使用一般動態饋給 Dropbox」。您可以在「 範例」頁面中找到相關範例。

確認資料正確無誤

登入合作夥伴入口網站。切換至「Sandbox」(沙箱) 環境,然後在「Dashboards」(資訊主頁) 部分找出下列頁面。

動態饋給
顯示動態饋給摘要統計資料,並列出上傳動態饋給時發生的錯誤。

請到「動態饋給」頁面查看有沒有任何動態饋給錯誤,確認初次上傳到沙箱環境中的資料是否正確。

將動態饋給上傳到正式環境

當您能夠持續將完整且正確的動態饋給上傳到沙箱環境時,就可以著手將動態饋給上傳至正式環境;這時您的整合功能「不會」啟用。

所有正式版動態饋給資料上傳一致且已連結至正式版系統後,動態饋給即可送審。

Google 對動態饋給進行評估

您上傳動態饋給後,Google 會進行處理並評估其品質和完整性。