Stocker des données médicales avec curl et PowerShell

Cette page explique comment utiliser l'API Cloud Healthcare et curl ou PowerShell pour effectuer les tâches suivantes :

  1. créer un ensemble de données pour l'API Cloud Healthcare ;
  2. Créer l'un des datastores suivants dans l'ensemble de données :
    • Magasin DICOM (Digital Imaging and Communications in Medicine)
    • Datastore FHIR (Fast Healthcare Interoperability Resources)
    • Datastore HL7v2 (Health Level Seven International Version 2)
  3. Stocker et inspecter un type spécifique de données médicales dans les datastores DICOM, FHIR ou HL7v2.

Si vous souhaitez n'utiliser qu'un seul type de data store, vous pouvez passer directement à cette section du guide de démarrage rapide après avoir suivi les étapes décrites dans les sections Avant de commencer et Créer un ensemble de données.

Avant de commencer

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. Install the Google Cloud CLI.

  3. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  4. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

  5. Create or select a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Healthcare API:

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles. 

    gcloud services enable healthcare.googleapis.com

  8. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/healthcare.datasetAdmin, roles/healthcare.fhirStoreAdmin, roles/healthcare.dicomStoreAdmin, roles/healthcare.hl7V2StoreAdmin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

    Replace the following:

    • PROJECT_ID: your project ID.
    • USER_IDENTIFIER: the identifier for your user account—for example, myemail@example.com.
    • ROLE: the IAM role that you grant to your user account.

  9. Install the Google Cloud CLI.

  10. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  11. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

  12. Create or select a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  13. Verify that billing is enabled for your Google Cloud project.

  14. Enable the Cloud Healthcare API:

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles. 

    gcloud services enable healthcare.googleapis.com

  15. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/healthcare.datasetAdmin, roles/healthcare.fhirStoreAdmin, roles/healthcare.dicomStoreAdmin, roles/healthcare.hl7V2StoreAdmin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

    Replace the following:

    • PROJECT_ID: your project ID.
    • USER_IDENTIFIER: the identifier for your user account—for example, myemail@example.com.
    • ROLE: the IAM role that you grant to your user account.
    16.

    Créer un ensemble de données

    Les ensembles de données contiennent des datastores. Les datastores contiennent des données de santé. Pour utiliser l'API Cloud Healthcare, vous devez créer au moins un ensemble de données.

    L'exemple suivant montre comment créer un ensemble de données nommé my-dataset dans la région us-central1. Vous utiliserez l'ensemble de données tout au long de ce guide de démarrage rapide pour créer des magasins DICOM, FHIR et HL7v2.

    REST

    1. Créez l'ensemble de données à l'aide de la méthode projects.locations.datasets.create.

      Avant d'utiliser les données de requête, effectuez les remplacements suivants :

      • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

      Pour envoyer votre requête, choisissez l'une des options suivantes :

      curl

      Exécutez la commande suivante :

      curl -X POST \
           -H "Authorization: Bearer $(gcloud auth print-access-token)" \
           -H "Content-Type: application/json; charset=utf-8" \
           -d "" \
           "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets?datasetId=my-dataset"

      PowerShell

      Exécutez la commande suivante :

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

      Invoke-WebRequest `
          -Method POST `
          -Headers $headers `
          -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets?datasetId=my-dataset" | Select-Object -Expand Content

      Explorateur d'API

      Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).

      Le résultat est le suivant. La réponse contient un identifiant pour une opération de longue durée (LRO). Les opérations de longue durée sont renvoyées lorsque les appels de méthode peuvent prendre davantage de temps. Notez la valeur de OPERATION_ID. Vous en aurez besoin à l'étape suivante.

    2. Obtenez l'état de l'opération de longue durée à l'aide de la méthode projects.locations.datasets.operations.get.

      Avant d'utiliser les données de requête, effectuez les remplacements suivants :

      • PROJECT_ID : ID de votre projet Google Cloud
      • OPERATION_ID : ID renvoyé par l'opération de longue durée

      Pour envoyer votre requête, choisissez l'une des options suivantes :

      curl

      Exécutez la commande suivante :

      curl -X GET \
           -H "Authorization: Bearer $(gcloud auth print-access-token)" \
           "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/operations/OPERATION_ID"

      PowerShell

      Exécutez la commande suivante :

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

      Invoke-WebRequest `
          -Method GET `
          -Headers $headers `
          -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/operations/OPERATION_ID" | Select-Object -Expand Content

      Explorateur d'API

      Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).

      Le résultat est le suivant. Lorsque la réponse contient "done": true, l'opération de longue durée est terminée.

    Pour suivre ce guide de démarrage rapide, choisissez l'une des sections suivantes :

    Stocker et afficher une instance DICOM

    Ce document explique comment effectuer les tâches suivantes :

    1. Créer un magasin DICOM.
    2. Stocker une instance DICOM dans le magasin DICOM.
    3. Afficher les métadonnées de l'instance DICOM.

    L'API Cloud Healthcare met en œuvre la norme DICOMweb pour stocker et accéder aux données d'imagerie médicale.

    Créer un datastore DICOM

    Les magasins DICOM existent à l'intérieur des ensembles de données et contiennent des instances DICOM. L'exemple suivant montre comment créer un datastore DICOM nommé my-dicom-store.

    REST

    Créez un magasin DICOM à l'aide de la méthode projects.locations.datasets.dicomStores.create.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

    Pour envoyer votre requête, choisissez l'une des options suivantes :

    curl

    Exécutez la commande suivante :

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d "" \
         "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores?dicomStoreId=my-dicom-store"

    PowerShell

    Exécutez la commande suivante :

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

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores?dicomStoreId=my-dicom-store" | Select-Object -Expand Content

    Explorateur d'API

    Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.

    Vous devriez recevoir une réponse JSON de ce type :

    Stocker une instance DICOM

    1. Téléchargez l'exemple de fichier d'instance DICOM sur votre ordinateur. Le fichier contient une radiographie de patient anonymisée.

      curl

      curl -O https://cloud.google.com/healthcare-api/docs/resources/dicom_00000001_000.dcm

      PowerShell

      Invoke-WebRequest -Uri "https://cloud.google.com/healthcare-api/docs/resources/dicom_00000001_000.dcm" -OutFile $pwd/dicom_00000001_000.dcm

    2. Stockez l'instance DICOM en utilisant la méthode dicomStores.storeInstances. Dans ce guide de démarrage rapide, nous partons du principe que vous exécutez la commande dans le répertoire dans lequel vous avez téléchargé l'instance DICOM.

      REST

      Avant d'utiliser les données de requête, effectuez les remplacements suivants :

      • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

      Pour envoyer votre requête, choisissez l'une des options suivantes :

      curl

      Exécutez la commande suivante :

      curl -X POST \
           -H "Authorization: Bearer $(gcloud auth print-access-token)" \
           -H "Content-Type: application/dicom" \
           --data-binary @dicom_00000001_000.dcm \
           "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store/dicomWeb/studies"

      PowerShell

      Exécutez la commande suivante :

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

      Invoke-WebRequest `
          -Method POST `
          -Headers $headers `
          -InFile dicom_00000001_000.dcm `
          -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store/dicomWeb/studies" | Select-Object -Expand Content

      Le résultat est la réponse XML suivante. Dans ce résultat :

      • PROJECT_ID, us-central1, my-dataset, my-dicom-store : valeurs que vous avez fournies lors de l'exécution de la commande
      • SOPClassUID : identifie de manière unique la classe de paire service-objet (SOP, Service-Object Pair)
      • SOPInstanceUID : identifie de manière unique l'instance de la paire objet-service
      • STUDY_UID : identifie de manière unique l'instance de l'étude
      • SERIES_UID : identifie de manière unique l'instance de série
      • INSTANCE_UID : identifie de manière unique l'instance

    Afficher les métadonnées d'instance DICOM

    REST

    Affichez les métadonnées de l'instance à l'aide de la méthode dicomStores.searchForInstances.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

    Pour envoyer votre requête, choisissez l'une des options suivantes :

    curl

    Exécutez la commande suivante :

    curl -X GET \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store/dicomWeb/instances"

    PowerShell

    Exécutez la commande suivante :

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

    Invoke-WebRequest `
        -Method GET `
        -Headers $headers `
        -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store/dicomWeb/instances" | Select-Object -Expand Content

    Explorateur d'API

    Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.

    Vous devriez recevoir une réponse JSON de ce type :

    Après avoir stocké et affiché l'instance DICOM dans l'API Cloud Healthcare, passez à la section Effectuer un nettoyage pour éviter que des frais ne soient facturés sur votre compte Google Cloud pour les ressources utilisées sur cette page.

    Pour en savoir plus sur l'utilisation des données DICOM, consultez la section Étapes suivantes.

    Stocker et afficher des ressources FHIR

    Ce document explique comment effectuer les tâches suivantes :

    1. Créer un magasin FHIR.
    2. Créer une ressource FHIR dans le magasin FHIR.
    3. Afficher les données des ressources FHIR.

    L'API Cloud Healthcare met en œuvre la norme FHIR pour stocker des données FHIR et y accéder.

    Créer un datastore FHIR

    Les magasins FHIR existent à l'intérieur des ensembles de données et contiennent des ressources FHIR. L'exemple suivant montre comment créer un magasin FHIR nommé my-fhir-store qui utilise la version R4 de FHIR.

    REST

    Créez un magasin FHIR à l'aide de la méthode projects.locations.datasets.fhirStores.create.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

    Corps JSON de la requête :

    {
  "version": "R4"
}

    Pour envoyer votre requête, choisissez l'une des options suivantes :

    curl

    Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel : 

    cat > request.json << 'EOF'
{
  "version": "R4"
}
EOF

    Exécutez ensuite la commande suivante pour envoyer votre requête REST : 

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
         "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores?fhirStoreId=my-fhir-store"

    PowerShell

    Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel : 

    @'
{
  "version": "R4"
}
'@  | Out-File -FilePath request.json -Encoding utf8

    Exécutez ensuite la commande suivante pour envoyer votre requête REST : 

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

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores?fhirStoreId=my-fhir-store" | Select-Object -Expand Content

    Explorateur d'API

    Copiez le corps de la requête et ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Collez le corps de la requête dans cet outil, renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).

    Vous devriez recevoir une réponse JSON de ce type :

    Stocker une ressource FHIR

    REST

    Créez une ressource Patient dans le magasin FHIR à l'aide de la méthode projects.locations.datasets.fhirStores.fhir.create.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

    Corps JSON de la requête :

    {
  "name": [
    {
      "use": "official",
      "family": "Smith",
      "given": [
        "Darcy"
      ]
    }
  ],
  "gender": "female",
  "birthDate": "1970-01-01",
  "resourceType": "Patient"
}

    Pour envoyer votre requête, choisissez l'une des options suivantes :

    curl

    Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel : 

    cat > request.json << 'EOF'
{
  "name": [
    {
      "use": "official",
      "family": "Smith",
      "given": [
        "Darcy"
      ]
    }
  ],
  "gender": "female",
  "birthDate": "1970-01-01",
  "resourceType": "Patient"
}
EOF

    Exécutez ensuite la commande suivante pour envoyer votre requête REST : 

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/fhir+json" \
         -d @request.json \
         "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient"

    PowerShell

    Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel : 

    @'
{
  "name": [
    {
      "use": "official",
      "family": "Smith",
      "given": [
        "Darcy"
      ]
    }
  ],
  "gender": "female",
  "birthDate": "1970-01-01",
  "resourceType": "Patient"
}
'@  | Out-File -FilePath request.json -Encoding utf8

    Exécutez ensuite la commande suivante pour envoyer votre requête REST : 

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

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/fhir+json" `
        -InFile request.json `
        -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient" | Select-Object -Expand Content

    Vous devriez recevoir une réponse JSON de ce type :

    Afficher le contenu des ressources FHIR

    REST

    Affichez des informations sur la ressource Patient en utilisant la méthode projects.locations.datasets.fhirStores.fhir.search.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

    Pour envoyer votre requête, choisissez l'une des options suivantes :

    curl

    Exécutez la commande suivante :

    curl -X GET \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient"

    PowerShell

    Exécutez la commande suivante :

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

    Invoke-WebRequest `
        -Method GET `
        -Headers $headers `
        -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient" | Select-Object -Expand Content

    Vous devriez recevoir une réponse JSON de ce type :

    {
  "entry": [
    {
      "fullUrl": "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient/PATIENT_ID",
      "resource": {
        "birthDate": "1970-01-01",
        "gender": "female",
        "id": "PATIENT_ID",
        "meta": {
          "lastUpdated": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
          "versionId": "MTY5MDQxMDk5ODU1OTkxNTAwMA"
        },
        "name": [
          {
            "family": "Smith",
            "given": [
              "Darcy"
            ],
            "use": "official"
          }
        ],
        "resourceType": "Patient"
      },
      "search": {
        "mode": "match"
      }
    }
  ],
  "link": [
    {
      "relation": "search",
      "url": "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient/?"
    },
    {
      "relation": "first",
      "url": "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient/?"
    },
    {
      "relation": "self",
      "url": "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient/?"
    }
  ],
  "resourceType": "Bundle",
  "total": 1,
  "type": "searchset"
}

    Après avoir stocké et affiché une ressource FHIR dans l'API Cloud Healthcare, passez à la section Effectuer un nettoyage pour éviter que des frais ne soient facturés sur votre compte Google Cloud pour les ressources utilisées sur cette page.

    Pour en savoir plus sur l'utilisation des données FHIR, consultez la section Étapes suivantes.

    Stocker et afficher un message HL7v2

    Ce document explique comment effectuer les tâches suivantes :

    1. Créer un magasin HL7v2.
    2. Stocker un message HL7v2 dans le magasin HL7v2.
    3. Affichez les données du message HL7v2.

    L'implémentation HL7v2 de l'API Cloud Healthcare est conforme à la norme HL7v2.

    Créer un datastore HL7v2

    Les datastores HL7v2 existent au sein des ensembles de données et contiennent des messages HL7v2. L'exemple suivant montre comment créer un magasin HL7v2 nommé my-hl7v2-store.

    REST

    Créez un magasin HL7v2 à l'aide de la méthode projects.locations.datasets.hl7V2Stores.create.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

    Pour envoyer votre requête, choisissez l'une des options suivantes :

    curl

    Exécutez la commande suivante :

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d "" \
         "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores?hl7V2StoreId=my-hl7v2-store"

    PowerShell

    Exécutez la commande suivante :

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

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores?hl7V2StoreId=my-hl7v2-store" | Select-Object -Expand Content

    Explorateur d'API

    Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.

    Vous devriez recevoir une réponse JSON de ce type :

    Créer un message HL7v2

    1. Téléchargez l'exemple de fichier de message HL7v2 sur votre ordinateur :

      curl

      curl -O https://cloud.google.com/healthcare-api/docs/resources/hl7v2-sample.json

      PowerShell

      Invoke-WebRequest -Uri "https://cloud.google.com/healthcare-api/docs/resources/hl7v2-sample.json" -OutFile $pwd/hl7v2-sample.json

      Le message HL7v2 contient les informations suivantes encodées en base64 dans le champ data de l'exemple de fichier :

      MSH|^~\&|A|SEND_FACILITY|A|A|20180101000000||TYPE^A|20180101000000|T|0.0|||AA||00|ASCII
EVN|A00|20180101040000
PID||14^111^^^^MRN|11111111^^^^MRN~1111111111^^^^ORGNMBR

    2. Stockez le message HL7v2 dans le magasin HL7v2 à l'aide de la méthode projects.locations.datasets.hl7V2Stores.messages.create. Dans ce guide de démarrage rapide, nous partons du principe que vous exécutez la commande dans le répertoire où vous avez téléchargé le message HL7v2.

      REST

      Avant d'utiliser les données de requête, effectuez les remplacements suivants :

      • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

      Pour envoyer votre requête, choisissez l'une des options suivantes :

      curl

      Exécutez la commande suivante :

      curl -X POST \
           -H "Authorization: Bearer $(gcloud auth print-access-token)" \
           -H "Content-Type: application/json; charset=utf-8" \
           --data-binary @hl7v2-sample.json \
           "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores/my-hl7v2-store/messages"

      PowerShell

      Exécutez la commande suivante :

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

      Invoke-WebRequest `
          -Method POST `
          -Headers $headers `
          -InFile hl7v2-sample.json `
          -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores/my-hl7v2-store/messages" | Select-Object -Expand Content

      Explorateur d'API

      Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).

      Le résultat est le suivant. Dans ce résultat :

      • PROJECT_ID, us-central1, my-dataset, my-hl7v2-store : valeurs que vous avez fournies dans l'appel de méthode
      • MESSAGE_ID : identifiant du message HL7v2 fourni par l'API Cloud Healthcare. Notez la valeur de MESSAGE_ID. Vous aurez besoin de cette valeur à l'étape suivante.

    Afficher le contenu des messages HL7v2

    Recherchez l'élément MESSAGE_ID dans la réponse que vous avez reçue lors de la création du message HL7v2.

    REST

    Affichez les détails du message HL7v2 à l'aide de la méthode projects.locations.datasets.hl7V2stores.messages.get.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer
    • HL7V2_MESSAGE_ID : ID de la réponse que vous avez reçue lors de la création du message HL7v2

    Pour envoyer votre requête, choisissez l'une des options suivantes :

    curl

    Exécutez la commande suivante :

    curl -X GET \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores/my-hl7v2-store/messages/HL7V2_MESSAGE_ID"

    PowerShell

    Exécutez la commande suivante :

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

    Invoke-WebRequest `
        -Method GET `
        -Headers $headers `
        -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores/my-hl7v2-store/messages/HL7V2_MESSAGE_ID" | Select-Object -Expand Content

    Explorateur d'API

    Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.

    Vous devriez recevoir une réponse JSON de ce type :

    Après avoir stocké et affiché le message HL7v2 dans l'API Cloud Healthcare, passez à la section Effectuer un nettoyage pour éviter que des frais ne soient facturés sur votre compte Google Cloud pour les ressources utilisées sur cette page.

    Pour en savoir plus sur l'utilisation des données HL7v2, consultez la section Étapes suivantes.

    Effectuer un nettoyage

    Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , supprimez le projet Google Cloud qui les contient.

    Si vous avez créé un projet pour ce démarrage rapide, suivez les étapes décrites dans la section Supprimer le projet. Sinon, suivez la procédure décrite dans la section Supprimer l'ensemble de données.

    Optional: Revoke credentials from the gcloud CLI. 

    gcloud auth revoke

    Supprimer le projet

      Delete a Google Cloud project:

      gcloud projects delete PROJECT_ID

    Supprimer l'ensemble de données

    Si vous n'avez plus besoin de l'ensemble de données créé dans ce guide de démarrage rapide, vous pouvez le supprimer. La suppression d'un ensemble de données entraîne la suppression définitive de l'ensemble de données et des datastores FHIR, HL7v2 ou DICOM qu'il contient.

    REST

    Supprimez l'ensemble de données à l'aide de la méthode projects.locations.datasets.delete.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet Google Cloud que vous avez créé ou sélectionné dans la section Avant de commencer

    Pour envoyer votre requête, choisissez l'une des options suivantes :

    curl

    Exécutez la commande suivante :

    curl -X DELETE \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset"

    PowerShell

    Exécutez la commande suivante :

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

    Invoke-WebRequest `
        -Method DELETE `
        -Headers $headers `
        -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset" | Select-Object -Expand Content

    Explorateur d'API

    Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.

    Vous devriez recevoir un code d'état indiquant le succès de l'opération (2xx), ainsi qu'une réponse vide.

    Comment ça s'est passé ?

    Étapes suivantes

    Consultez les sections suivantes pour obtenir des informations générales sur l'API Cloud Healthcare et découvrir comment effectuer les tâches de ce guide de démarrage rapide à l'aide d'une autre interface :

    DICOM

    Consultez la déclaration de conformité DICOM pour en savoir plus sur la manière dont l'API Cloud Healthcare implémente la norme DICOMweb.

    FHIR

    Consultez la déclaration de conformité FHIR pour en savoir plus sur la manière dont l'API Cloud Healthcare implémente la norme FHIR.

    HL7v2