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

Cette page explique comment effectuer une lecture groupée des messages d'un magasin HL7v2 à l'aide de la méthode projects.locations.datasets.hl7V2Stores.messages.batchGet. Vous pouvez utiliser batchGet pour récupérer jusqu'à 100 messages HL7v2 au moyen d'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 en avez beaucoup, vous risquez de payer des coûts de réseau excessifs. Pour récupérer plusieurs messages dans un 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 au 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 au 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