Récupérer des messages HL7v2 de façon groupée

Cette page explique comment lire des messages d'un magasin HL7v2 de façon groupée à l'aide de la méthode projects.locations.datasets.hl7V2Stores.messages.batchGet. Vous pouvez utiliser batchGet pour récupérer jusqu'à 100 messages HL7v2 avec un seul appel.

Vous pouvez utiliser le message projects.locations.datasets.hl7V2Stores.messages.get pour récupérer un seul message HL7v2 à la fois, mais si vous avez de nombreux messages, des coûts de réseau excessifs peuvent s'appliquer. Pour récupérer plusieurs messages dans un même appel d'API, utilisez batchGet.

Obtenir des messages HL7v2 de façon groupée

Les exemples suivants montrent comment obtenir le contenu des messages HL7v2 de façon groupée.

Pour en savoir plus, consultez les sections sur projects.locations.datasets.hl7V2Stores.messages.batchGet

curl

Pour obtenir des messages HL7v2 de façon groupée, envoyez une requête GET et spécifiez les informations suivantes :

  • Le nom de l'ensemble de données parent
  • Le nom du magasin HL7v2
  • Un jeton d'accès
  • Le paramètre de requête names, avec les noms des messages HL7v2 que vous souhaitez récupérer. Pour chaque valeur names, saisissez le chemin d'accès complet du message au format suivant : projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID

L'exemple suivant montre une requête GET utilisant 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"

Si la requête aboutit, le serveur renvoie la réponse au format JSON :

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

PowerShell

Pour obtenir des messages HL7v2 de façon groupée, envoyez une requête GET et spécifiez les informations suivantes :

  • Le nom de l'ensemble de données parent
  • Le nom du magasin HL7v2
  • Un jeton d'accès
  • Le paramètre de requête names, avec les noms des messages HL7v2 que vous souhaitez récupérer. Pour chaque valeur names, saisissez le chemin d'accès complet du message au format suivant : projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID

L'exemple suivant montre une requête GET utilisant 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

Si la requête aboutit, le serveur renvoie la réponse au format JSON :

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

Voir aussi