Method: projects.locations.dataStores.addPatientFilter

為資料儲存庫新增一組病患 ID 做為病患篩選器。建立資料儲存庫時,預設會將患者篩選條件留空,並儲存在獨立資料表中。您必須先建立資料儲存庫,且必須是醫療照護資料儲存庫。篩選器群組必須是「群組」類型的 FHIR 資源名稱,篩選器會從群組的直接成員 (即「病患」資源) 建構而成。

HTTP 要求


POST https://discoveryengine.googleapis.com/v1alpha/{dataStore=projects/*/locations/*/dataStores/*}:addPatientFilter

這些網址使用 gRPC 轉碼語法。

路徑參數

參數
dataStore

string

這是必要旗標,DataStore 的完整資源名稱,例如 projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId}。

如果呼叫者沒有權限存取 DataStore (無論是否存在),系統都會傳回 PERMISSION_DENIED 錯誤。

如果要求的 DataStore 不存在,系統會傳回 NOT_FOUND 錯誤。如果要求的 DataStore 已有病患篩選器,系統會傳回 ALREADY_EXISTS 錯誤。

要求主體

要求主體包含下列結構的資料:

JSON 表示法
{
  "filterGroups": [
    string
  ]
}
欄位
filterGroups[]

string

這是必要旗標,要用來做為病患篩選條件依據的群組資源名稱,格式為 projects/{projectId}/locations/{locationId}/datasets/{datasetId}/fhirStores/{fhir_store_id}/fhir/Group/{groupId}。如果呼叫者沒有存取 FHIR 儲存庫的權限,無論該儲存庫是否存在,系統都會傳回 PERMISSION_DENIED 錯誤。如果探索引擎服務帳戶沒有存取 FHIR 儲存庫的權限 (無論該儲存庫是否存在),系統都會傳回 PERMISSION_DENIED 錯誤。如果系統在該位置找不到群組,就會傳回 RESOURCE_NOT_FOUND 錯誤。篩選器群組必須是「群組」類型的 FHIR 資源名稱,篩選器會從群組的直接成員 (即「病患」資源) 建構而成。

回應主體

如果成功,回應主體會包含 Operation 的執行個體。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

詳情請參閱Authentication Overview。