步驟 2:動態饋給

建立動態饋給

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

動態消息 說明 頻率
從業人員 包含從業人員說明資料,包括可讓從業人員預訂的第三方連結。(對應項目:FHIR 從業人員)。[只有特定從業人員可預訂時才需要] 每 24 小時一次
功能 含有醫療照護設施/地點 (例如檢測中心和診所) 的資料,其中包含透過設施預訂的第三方連結。(計數器:FHIR 位置) 每 24 小時一次
預約類型 包含所有預約類型的清單,包括 ID 和名稱。例如檢查檢查、生病和新患者。這項資訊會做為縮減時間表時的參考。(計數器:FHIR 預約類型) 每 24 小時一次
適用地區 列出特定從業人員、設施、服務類型和預約類型的可預約時段。(對應項目:FHIR 運算單元) 每個從業人員、設施和預約類型組合中,至少須提供 24 小時的保固服務。 每 15 到 60 分鐘一次
轉換 將轉換率提供給 Google,包括造訪連結和完成預約的指標。 每週 1 次

您需要使用通訊協定緩衝區 3 語法來說明動態饋給格式,但您也可以參考動態饋給範例來查看 JSON 格式。建議您以 JSON 格式上傳動態饋給。

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

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

如要判斷動態饋給的大小,請使用下列規範 (動態饋給可由多個稱為「資料分割」的檔案組成):

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

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

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

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

詳情請參閱使用一般動態饋給 Dropbox 一文。如需範例,請前往 範例頁面。

確認資料正確無誤

登入合作夥伴入口網站。切換至「沙箱」環境,即可在「資訊主頁」區段中查看下列頁面。

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

初次上傳至沙箱環境後,如要確認資料是否正確無誤,請前往「動態饋給頁面查看是否有任何動態饋給錯誤。

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

當您能夠持續將完整且不含錯誤的動態饋給上傳至沙箱環境後,就可以開始將動態饋給上傳至正式環境。 此時,您的整合服務並不會上線。

所有正式環境動態饋給資料持續上傳並連結到正式環境系統後,就可開始進行審核。

Google 對動態饋給進行評估

動態饋給上傳完畢後,Google 會處理並評估動態饋給的品質和完整性。