資訊提供

建立動態饋給

系統會定期向 Google 提供動態饋給,讓資料直接顯示在 Google 上。 需要以下資訊提供。

動態消息 說明 頻率
從業人員 包含從業人員提供的資料,其中包含第三方與從業人員預訂的連結。(對等項目:FHIR Practitioner)。[僅在與特定專業執業人員預訂時才需要填寫] 每 24 小時一次
功能 內含有關醫療設施/地點 (例如實驗室檢測中心和診所) 的資料,其中包含透過設施預訂的第三方連結。(對應:FHIR 位置) 每 24 小時一次
預約類型 內含所有預約類型的清單,包括 ID 和名稱。例如檢查、病症和新病患。將會做為參考範圍,以縮小時間表。 (對應:FHIR 預約類型) 每 24 小時一次
適用地區 列出特定從業人員、設施、服務類型和預約類型的有空時段。 每 15 到 60 分鐘一次
轉換 與 Google 分享轉換率,包括造訪連結及完成預約行程的指標。 每週一次

我們使用通訊協定緩衝區 3 語法來描述動態饋給格式,但您也可以參照動態饋給範例來查看 JSON 格式。我們建議您以 JSON 格式上傳動態饋給。

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

請查看下列關於壓縮和資料分割的教學課程:

如要確定動態饋給的大小,請遵循下列規範 (動態饋給可由多個「資料分割」檔案組成):

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

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

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

務必將所有醫療保健相關動態饋給上傳至「一般」帳戶
請確保您上傳的所有醫療保健相關動態饋給都上傳到「一般」帳戶。

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

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

確認資料正確無誤

登入合作夥伴入口網站。切換至「Sandbox」環境,即可在「Dashboards」(資訊主頁) 區段中找到下列頁面。

動態饋給
顯示動態饋給摘要統計資料,並指出上傳動態饋給期間發生錯誤。

為確認資料在初次上傳至沙箱環境之後可正常顯示,請前往動態饋給頁面查看是否有動態饋給錯誤。

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

持續將完整的錯誤動態饋給上傳至沙箱環境之後,就可以開始上傳到實際執行環境。此時,您的整合設定將不會生效。

「所有」正式版動態饋給資料持續上傳並連結正式版系統之後,就能開始審查。

Google 對動態饋給進行評估

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