擷取大量的 HL7v2 訊息

本頁說明如何使用 projects.locations.datasets.hl7V2Stores.messages.batchGet 方法，從 HL7v2 儲存區大量讀取訊息。您可以使用 batchGet，透過單一呼叫擷取最多 100 則 HL7v2 訊息。

您可以使用 projects.locations.datasets.hl7V2Stores.messages.get 訊息一次擷取一則 HL7v2 訊息，但如果訊息數量眾多，可能會產生過高的網路費用。如要在一次 API 呼叫中擷取多則訊息，請使用 batchGet。

大量取得 HL7v2 訊息

下列範例說明如何大量取得 HL7v2 訊息的內容。

詳情請參閱 projects.locations.datasets.hl7V2Stores.messages.batchGet。

curl

如要大量取得 HL7v2 訊息，請提出 GET 要求並指定下列資訊：

  • 父項資料集的名稱
  • HL7v2 儲存庫名稱
  • 存取權杖
  • 查詢參數 names，其中包含要擷取的 HL7v2 訊息名稱。針對每個 names 值，以以下格式輸入訊息的完整路徑：projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID

以下範例顯示如何使用 curl 發出 GET 要求。

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID
      /locations/LOCATION/datasets/DATASET_ID
      /hl7V2Stores/HL7V2_STORE_ID/messages:batchGet?names=MESSAGE_NAME_1&names=MESSAGE_NAME_2&names=
      MESSAGE_NAME_3&view=FULL"

如果要求成功，伺服器會以 JSON 格式傳回回應：

{
  "messages" : [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
    }
  ]
}

PowerShell

如要大量取得 HL7v2 訊息，請提出 GET 要求並指定下列資訊：

  • 父項資料集的名稱
  • HL7v2 儲存庫名稱
  • 存取權杖
  • 查詢參數 names，其中包含要擷取的 HL7v2 訊息名稱。針對每個 names 值，以以下格式輸入訊息的完整路徑：projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID

下列範例顯示如何使用 Windows PowerShell 提出 GET 要求。

$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }

Invoke-WebRequest `
  -Method Get `
  -Headers $headers `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:batchGet?names=MESSAGE_NAME_1&names=MESSAGE_NAME_2&names=MESSAGE_NAME_3&view=FULL" | Select-Object -Expand Content

如果要求成功，伺服器會以 JSON 格式傳回回應：

{
  "messages" : [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
    }
  ]
}

另請參閱