建立動態饋給
系統會定期向 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.practitioner、healthappointments.facility、healthappointments.appointment_type 和 healthappointments.availability
詳情請參閱使用一般動態饋給 Dropbox 一文。您可以在範例頁面中找到範例。
確認資料正確無誤
登入合作夥伴入口網站。切換至「Sandbox」環境,即可在「Dashboards」(資訊主頁) 區段中找到下列頁面。
- 動態饋給
- 顯示動態饋給摘要統計資料,並指出上傳動態饋給期間發生錯誤。
為確認資料在初次上傳至沙箱環境之後可正常顯示,請前往動態饋給頁面查看是否有動態饋給錯誤。
將動態饋給上傳到正式環境
持續將完整的錯誤動態饋給上傳至沙箱環境之後,就可以開始上傳到實際執行環境。此時,您的整合設定將不會生效。
「所有」正式版動態饋給資料持續上傳並連結正式版系統之後,就能開始審查。
Google 對動態饋給進行評估
在您上傳動態饋給之後,Google 會處理動態饋給並進行評估,確保品質和完整性。