HL7v2-Nachrichten im Bulk abrufen

Auf dieser Seite wird erläutert, wie Sie Nachrichten mit der Methode projects.locations.datasets.hl7V2Stores.messages.batchGet im Bulk aus einem HL7v2-Speicher lesen. Sie können batchGet verwenden, um bis zu 100 HL7v2-Nachrichten mit einem einzigen Aufruf abzurufen.

Sie können die projects.locations.datasets.hl7V2Stores.messages.get-Nachricht verwenden, um jeweils eine einzelne HL7v2-Nachricht abzurufen. Wenn Sie jedoch viele Nachrichten haben, können übermäßige Netzwerkkosten auftreten. Zum Abrufen mehrerer Nachrichten in einem API-Aufruf verwenden Sie batchGet.

HL7v2-Nachrichten im Bulk abrufen

Die folgenden Beispiele zeigen, wie die Inhalte von HL7v2-Nachrichten im Bulk abgerufen werden.

Weitere Informationen finden Sie unter projects.locations.datasets.hl7V2Stores.messages.batchGet.

curl

Um HL7v2-Nachrichten im Bulk abzurufen, stellen Sie eine GET-Anfrage und geben Sie die folgenden Informationen an:

  • Der Name des übergeordneten Datasets
  • Der Name des HL7v2-Speichers
  • Ein Zugriffstoken
  • Der Abfrageparameter names mit den Namen der HL7v2-Nachrichten, die Sie abrufen möchten. Geben Sie für jeden names-Wert den vollständigen Pfad zur Nachricht im folgenden Format ein: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID

Das folgende Beispiel zeigt eine GET-Anfrage mit curl.

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"

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

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

PowerShell

Um HL7v2-Nachrichten im Bulk abzurufen, stellen Sie eine GET-Anfrage und geben Sie die folgenden Informationen an:

  • Der Name des übergeordneten Datasets
  • Der Name des HL7v2-Speichers
  • Ein Zugriffstoken
  • Der Abfrageparameter names mit den Namen der HL7v2-Nachrichten, die Sie abrufen möchten. Geben Sie für jeden names-Wert den vollständigen Pfad zur Nachricht im folgenden Format ein: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID

Das folgende Beispiel zeigt eine GET-Anfrage mit Windows PowerShell.

$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

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

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

Weitere Informationen