本页面介绍了如何使用 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"
}
]
}