Almacenar datos sanitarios con curl y PowerShell

En esta página se muestra cómo usar la API Cloud Healthcare y curl o PowerShell para completar las siguientes tareas:

  1. Crea un conjunto de datos de la API Cloud Healthcare.
  2. Crea uno de los siguientes almacenes de datos en el conjunto de datos:
    • Almacén Digital Imaging and Communications in Medicine (DICOM)
    • Almacén Fast Healthcare Interoperability Resources (FHIR)
    • Almacén Health Level Seven International Version 2 (HL7v2)
  3. Almacena e inspecciona un tipo concreto de datos médicos en el almacén DICOM, FHIR o HL7v2.

Si solo te interesa trabajar con un tipo de almacén de datos, puedes ir directamente a esa sección de la guía de inicio rápido después de completar los pasos de las secciones Antes de empezar y Crear un conjunto de datos.

Antes de empezar

  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 utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  4. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    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 utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  11. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    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.

    Crear conjunto de datos

    Los conjuntos de datos contienen almacenes de datos, y estos, a su vez, contienen datos sanitarios. Para utilizar la API Cloud Healthcare, antes debes crear al menos un conjunto de datos.

    En el siguiente ejemplo se muestra cómo crear un conjunto de datos llamado my-dataset en la región us-central1. En esta guía de inicio rápido, usarás el conjunto de datos para crear almacenes DICOM, almacenes FHIR y almacenes HL7v2.

    REST

    1. Crea el conjunto de datos con el método projects.locations.datasets.create.

      Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

      • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

      Para enviar tu solicitud, elige una de estas opciones:

      curl

      Ejecuta el comando siguiente: 

      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

      Ejecuta el comando siguiente: 

      $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

      Explorador de APIs

      Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.

      El resultado es el siguiente. La respuesta contiene un identificador de una operación de larga duración. Las operaciones de larga duración se devuelven cuando las llamadas a métodos pueden tardar más tiempo en completarse. Anota el valor de OPERATION_ID. Necesitarás este valor en el siguiente paso.

    2. Obtén el estado de la operación de larga duración mediante el método projects.locations.datasets.operations.get.

      Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

      • PROJECT_ID: el ID de tu Google Cloud proyecto
      • OPERATION_ID: el ID devuelto por la operación de larga duración

      Para enviar tu solicitud, elige una de estas opciones:

      curl

      Ejecuta el comando siguiente: 

      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

      Ejecuta el comando siguiente: 

      $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

      Explorador de APIs

      Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.

      El resultado es el siguiente. Cuando la respuesta contiene "done": true, la operación de larga duración ha finalizado.

    Para completar esta guía de inicio rápido, elige una de las siguientes secciones:

    Almacenar y ver una instancia DICOM

    En esta sección se explica cómo completar las siguientes tareas:

    1. Crea un almacén DICOM.
    2. Almacena una instancia DICOM en el almacén DICOM.
    3. Consulta los metadatos de la instancia DICOM.

    La API de Cloud Healthcare implementa el estándar DICOMweb para almacenar y acceder a datos de imágenes médicas.

    Crear un almacén DICOM

    Los almacenes DICOM están dentro de conjuntos de datos y contienen instancias DICOM. En el siguiente ejemplo se muestra cómo crear un almacén DICOM llamado my-dicom-store.

    REST

    Crea un almacén DICOM con el método projects.locations.datasets.dicomStores.create.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

    Para enviar tu solicitud, elige una de estas opciones:

    curl

    Ejecuta el comando siguiente: 

    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

    Ejecuta el comando siguiente: 

    $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

    Explorador de APIs

    Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.

    Deberías recibir una respuesta JSON similar a la siguiente:

    Almacenar una instancia DICOM

    1. Descarga el archivo de instancia DICOM de ejemplo en tu máquina. El archivo contiene una radiografía de un paciente cuya identidad se ha anonimizado.

      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. Almacena la instancia DICOM con el método dicomStores.storeInstances. En esta guía de inicio rápido se da por hecho que vas a ejecutar el comando en el mismo directorio en el que has descargado la instancia DICOM.

      REST

      Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

      • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

      Para enviar tu solicitud, elige una de estas opciones:

      curl

      Ejecuta el comando siguiente: 

      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

      Ejecuta el comando siguiente: 

      $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

      El resultado es la siguiente respuesta XML. En este resultado:

      • PROJECT_ID, us-central1, my-dataset y my-dicom-store: los valores que has proporcionado al ejecutar el comando
      • SOPClassUID: identifica de forma única la clase de par de servicio y objeto (SOP)
      • SOPInstanceUID: identifica de forma única la instancia del par de servicio y objeto (SOP)
      • STUDY_UID: identifica de forma única la instancia del estudio.
      • SERIES_UID: identifica de forma única la instancia de la serie.
      • INSTANCE_UID: identifica de forma única la instancia.

    Ver metadatos de instancias DICOM

    REST

    Consulta los metadatos de la instancia con el método dicomStores.searchForInstances.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

    Para enviar tu solicitud, elige una de estas opciones:

    curl

    Ejecuta el comando siguiente: 

    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

    Ejecuta el comando siguiente: 

    $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

    Explorador de APIs

    Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.

    Deberías recibir una respuesta JSON similar a la siguiente:

    Después de almacenar y ver la instancia DICOM en la API Cloud Healthcare, ve a la sección Limpieza para evitar que se te cobren los recursos utilizados en esta página en tu Google Cloud cuenta.

    Para obtener más información sobre cómo trabajar con datos DICOM, consulta la sección Pasos siguientes.

    Almacenar y ver recursos FHIR

    En esta sección se explica cómo completar las siguientes tareas:

    1. Crea un almacén FHIR.
    2. Almacena un recurso FHIR en el almacén FHIR.
    3. Consulta los datos del recurso FHIR.

    La API Cloud Healthcare implementa el estándar FHIR para almacenar y acceder a datos FHIR.

    Crear un almacén FHIR

    Los almacenes FHIR están dentro de conjuntos de datos y contienen recursos FHIR. En el siguiente ejemplo se muestra cómo crear un almacén FHIR llamado my-fhir-store que usa la versión R4 de FHIR.

    REST

    Crea un almacén FHIR con el método projects.locations.datasets.fhirStores.create.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

    Cuerpo JSON de la solicitud: 

    {
  "version": "R4"
}

    Para enviar tu solicitud, elige una de estas opciones:

    curl

    Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual: 

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

    A continuación, ejecuta el siguiente comando para enviar tu solicitud 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

    Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual: 

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

    A continuación, ejecuta el siguiente comando para enviar tu solicitud 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

    Explorador de APIs

    Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Pega el cuerpo de la solicitud en esta herramienta, rellena los campos obligatorios y haz clic en Ejecutar.

    Deberías recibir una respuesta JSON similar a la siguiente:

    Almacenar un recurso FHIR

    REST

    Crea un recurso Patient en el almacén FHIR mediante el método projects.locations.datasets.fhirStores.fhir.create.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

    Cuerpo JSON de la solicitud: 

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

    Para enviar tu solicitud, elige una de estas opciones:

    curl

    Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual: 

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

    A continuación, ejecuta el siguiente comando para enviar tu solicitud 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

    Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual: 

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

    A continuación, ejecuta el siguiente comando para enviar tu solicitud 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

    Deberías recibir una respuesta JSON similar a la siguiente:

    Ver el contenido de los recursos FHIR

    REST

    Consulta información sobre el recurso Patient mediante el método projects.locations.datasets.fhirStores.fhir.search.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

    Para enviar tu solicitud, elige una de estas opciones:

    curl

    Ejecuta el comando siguiente: 

    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

    Ejecuta el comando siguiente: 

    $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

    Deberías recibir una respuesta JSON similar a la siguiente:

    {
  "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"
}

    Después de almacenar y ver un recurso FHIR en la API Cloud Healthcare, ve a la sección Limpiar para evitar que se te cobren los recursos utilizados en esta página en tu cuenta Google Cloud .

    Para obtener más información sobre cómo trabajar con datos de FHIR, consulta la sección Pasos siguientes.

    Almacenar y ver un mensaje HL7v2

    En esta sección se explica cómo completar las siguientes tareas:

    1. Crea un almacén HL7v2.
    2. Almacena un mensaje HL7v2 en el almacén HL7v2.
    3. Ver los datos del mensaje HL7v2.

    La implementación de HL7 v. 2 en la API Cloud Healthcare se ajusta al estándar HL7 v. 2.

    Crear un almacén HL7v2

    Los almacenes HL7v2 están dentro de conjuntos de datos y contienen mensajes HL7v2. En el siguiente ejemplo se muestra cómo crear un almacén HL7v2 llamado my-hl7v2-store.

    REST

    Crea un almacén HL7v2 con el método projects.locations.datasets.hl7V2Stores.create.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

    Para enviar tu solicitud, elige una de estas opciones:

    curl

    Ejecuta el comando siguiente: 

    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

    Ejecuta el comando siguiente: 

    $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

    Explorador de APIs

    Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.

    Deberías recibir una respuesta JSON similar a la siguiente:

    Crear un mensaje HL7v2

    1. Descarga el archivo de mensaje HL7v2 de ejemplo en tu máquina:

      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

      El mensaje HL7v2 contiene la siguiente información codificada en base 64 en el campo data del archivo de ejemplo:

      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. Almacena el mensaje HL7v2 en el almacén HL7v2 mediante el método projects.locations.datasets.hl7V2Stores.messages.create. En esta guía de inicio rápido se da por hecho que vas a ejecutar el comando en el mismo directorio en el que has descargado el mensaje HL7v2.

      REST

      Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

      • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

      Para enviar tu solicitud, elige una de estas opciones:

      curl

      Ejecuta el comando siguiente: 

      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

      Ejecuta el comando siguiente: 

      $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

      Explorador de APIs

      Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.

      El resultado es el siguiente. En este resultado:

      • PROJECT_ID, us-central1, my-dataset y my-hl7v2-store: los valores que has proporcionado en la llamada al método
      • MESSAGE_ID: identificador del mensaje HL7v2 proporcionado por la API de Cloud Healthcare. Anota el valor de MESSAGE_ID. Necesitarás este valor en el siguiente paso.

    Ver el contenido de mensajes HL7v2

    Busca el MESSAGE_ID en la respuesta que recibiste al crear el mensaje HL7v2.

    REST

    Consulta los detalles del mensaje HL7v2 con el método projects.locations.datasets.hl7V2stores.messages.get.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud
    • HL7V2_MESSAGE_ID: el ID de la respuesta que recibiste al crear el mensaje HL7v2

    Para enviar tu solicitud, elige una de estas opciones:

    curl

    Ejecuta el comando siguiente: 

    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

    Ejecuta el comando siguiente: 

    $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

    Explorador de APIs

    Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.

    Deberías recibir una respuesta JSON similar a la siguiente:

    Después de almacenar y ver el mensaje HL7v2 en la API Cloud Healthcare, ve a la sección Limpiar para evitar que se te cobren los recursos que has usado en esta página en tu cuenta Google Cloud .

    Para obtener más información sobre cómo trabajar con datos de HL7v2, consulta la sección Pasos siguientes.

    Limpieza

    Para evitar que se apliquen cargos en tu Google Cloud cuenta por los recursos utilizados en esta página, elimina el Google Cloud proyecto con los recursos.

    Si has creado un proyecto para esta guía de inicio rápido, sigue los pasos que se indican en la sección Eliminar el proyecto. De lo contrario, sigue los pasos que se indican en Eliminar el conjunto de datos.

    Optional: Revoke credentials from the gcloud CLI. 

    gcloud auth revoke

    Eliminar el proyecto

      Delete a Google Cloud project:

      gcloud projects delete PROJECT_ID

    Eliminar el conjunto de datos

    Si ya no necesitas el conjunto de datos creado en esta guía de inicio rápido, puedes eliminarlo. Si eliminas un conjunto de datos, se eliminará de forma permanente, así como los almacenes FHIR, HL7v2 o DICOM que contenga.

    REST

    Elimina el conjunto de datos con el método projects.locations.datasets.delete.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto que has creado o seleccionado en Antes de empezar Google Cloud

    Para enviar tu solicitud, elige una de estas opciones:

    curl

    Ejecuta el comando siguiente: 

    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

    Ejecuta el comando siguiente: 

    $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

    Explorador de APIs

    Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.

    Deberías recibir un código de estado que indique que la operación se ha realizado correctamente (2xx) y una respuesta vacía.

    ¿Cómo ha ido?

    Siguientes pasos

    Consulta las siguientes secciones para obtener información general sobre la API Cloud Healthcare y cómo realizar las tareas de esta guía de inicio rápido con otra interfaz:

    DICOM

    Consulta la declaración de conformidad de DICOM para obtener información sobre cómo implementa la API Cloud Healthcare el estándar DICOMweb.

    FHIR

    Consulta la declaración de conformidad de FHIR para obtener información sobre cómo implementa la API Cloud Healthcare el estándar FHIR.

    HL7v2