Armazene dados de cuidados de saúde com curl e PowerShell

Esta página mostra-lhe como usar a Cloud Healthcare API e curl ou o PowerShell para concluir as seguintes tarefas:

  1. Crie um conjunto de dados da Cloud Healthcare API.
  2. Crie um dos seguintes arquivos de dados no conjunto de dados:
    • Armazenamento de imagens digitais e comunicações em medicina (DICOM)
    • Armazenamento de Fast Healthcare Interoperability Resources (FHIR)
    • Armazenamento da versão 2 (HL7v2) da Health Level Seven International
  3. Armazene e inspecione um tipo específico de dados médicos no armazenamento DICOM, FHIR ou HL7v2.

Se só tiver interesse em trabalhar com um tipo de arquivo de dados, pode avançar diretamente para essa secção do início rápido depois de concluir os passos em Antes de começar e Criar um conjunto de dados.

Antes de começar

  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. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

  4. Para inicializar a CLI gcloud, execute o seguinte 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. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

  11. Para inicializar a CLI gcloud, execute o seguinte 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.

    Crie um conjunto de dados

    Os conjuntos de dados contêm arquivos de dados e os arquivos de dados contêm dados de cuidados de saúde. Para usar a Cloud Healthcare API, tem de criar, pelo menos, um conjunto de dados.

    O exemplo seguinte mostra como criar um conjunto de dados denominado my-dataset na região us-central1. Vai usar o conjunto de dados ao longo deste início rápido para criar armazenamentos DICOM, armazenamentos FHIR e armazenamentos HL7v2.

    REST

    1. Crie o conjunto de dados com o método projects.locations.datasets.create.

      Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

      • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

      Para enviar o seu pedido, escolha uma destas opções:

      curl

      Execute o seguinte comando: 

      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

      Execute o seguinte comando: 

      $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

      Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.

      O resultado é o seguinte. A resposta contém um identificador para uma operação de longa duração (LRO). As operações de longa duração são devolvidas quando as chamadas de métodos podem demorar mais tempo a serem concluídas. Repare no valor de OPERATION_ID. Precisa deste valor no passo seguinte.

    2. Obtenha o estado da operação de execução longa através do método projects.locations.datasets.operations.get.

      Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

      • PROJECT_ID: o ID do seu Google Cloud projeto
      • OPERATION_ID: o ID devolvido pela operação de longa duração

      Para enviar o seu pedido, escolha uma destas opções:

      curl

      Execute o seguinte comando: 

      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

      Execute o seguinte comando: 

      $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

      Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.

      O resultado é o seguinte. Quando a resposta contém "done": true, a operação de longa duração terminou.

    Para concluir este início rápido, escolha uma das seguintes secções:

    Armazene e veja uma instância DICOM

    Esta secção mostra como concluir as seguintes tarefas:

    1. Crie um arquivo DICOM.
    2. Armazenar uma instância DICOM no armazenamento DICOM.
    3. Ver os metadados da instância DICOM.

    A Cloud Healthcare API implementa a norma DICOMweb para armazenar e aceder a dados de imagens médicas.

    Crie um arquivo DICOM

    Os arquivos DICOM existem em conjuntos de dados e contêm instâncias DICOM. O exemplo seguinte mostra como criar um arquivo DICOM denominado my-dicom-store.

    REST

    Crie um arquivo DICOM através do método projects.locations.datasets.dicomStores.create.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

    Para enviar o seu pedido, escolha uma destas opções:

    curl

    Execute o seguinte comando: 

    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

    Execute o seguinte comando: 

    $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

    Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.

    Deve receber uma resposta JSON semelhante à seguinte:

    Armazene uma instância DICOM

    1. Transfira o ficheiro de instância DICOM de exemplo para a sua máquina. O ficheiro contém uma radiografia de um paciente sem identificação.

      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. Armazene a instância DICOM através do método dicomStores.storeInstances. Este início rápido pressupõe que está a executar o comando no mesmo diretório onde transferiu a instância DICOM.

      REST

      Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

      • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

      Para enviar o seu pedido, escolha uma destas opções:

      curl

      Execute o seguinte comando: 

      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

      Execute o seguinte comando: 

      $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

      O resultado é a seguinte resposta XML. Neste resultado:

      • PROJECT_ID, us-central1, my-dataset, my-dicom-store: os valores que forneceu quando executou o comando
      • SOPClassUID: identifica de forma exclusiva a classe de par de objetos de serviço (SOP)
      • SOPInstanceUID: identifica de forma exclusiva a instância do par de objetos de serviço (SOP)
      • STUDY_UID: identifica exclusivamente a instância do estudo
      • SERIES_UID: identifica de forma exclusiva a instância da série
      • INSTANCE_UID: identifica exclusivamente a instância

    Veja os metadados da instância DICOM

    REST

    Veja os metadados da instância através do método dicomStores.searchForInstances.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

    Para enviar o seu pedido, escolha uma destas opções:

    curl

    Execute o seguinte comando: 

    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

    Execute o seguinte comando: 

    $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

    Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.

    Deve receber uma resposta JSON semelhante à seguinte:

    Depois de armazenar e ver a instância DICOM na Cloud Healthcare API, continue a limpar para evitar incorrer em custos na sua Google Cloud conta pelos recursos usados nesta página.

    Para mais informações sobre como trabalhar com dados DICOM, consulte a secção O que se segue.

    Armazene e veja recursos FHIR

    Esta secção mostra como concluir as seguintes tarefas:

    1. Crie uma loja FHIR.
    2. Armazene um recurso FHIR no armazenamento FHIR.
    3. Ver os dados do recurso FHIR.

    A Cloud Healthcare API implementa a norma FHIR para armazenar e aceder a dados FHIR.

    Crie um FHIR store

    Os FHIR stores existem em conjuntos de dados e contêm recursos FHIR. O exemplo seguinte mostra como criar uma loja FHIR denominada my-fhir-store que usa a versão R4 do FHIR.

    REST

    Crie uma loja FHIR com o método projects.locations.datasets.fhirStores.create.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

    Corpo JSON do pedido: 

    {
  "version": "R4"
}

    Para enviar o seu pedido, escolha uma destas opções:

    curl

    Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual: 

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

    Em seguida, execute o seguinte comando para enviar o seu pedido 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

    Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual: 

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

    Em seguida, execute o seguinte comando para enviar o seu pedido 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

    Copie o corpo do pedido e abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Cole o corpo do pedido nesta ferramenta, preencha todos os outros campos obrigatórios e clique em Executar.

    Deve receber uma resposta JSON semelhante à seguinte:

    Armazene um recurso FHIR

    REST

    Crie um recurso Patient na loja FHIR através do método projects.locations.datasets.fhirStores.fhir.create.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

    Corpo JSON do pedido: 

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

    Para enviar o seu pedido, escolha uma destas opções:

    curl

    Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual: 

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

    Em seguida, execute o seguinte comando para enviar o seu pedido 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

    Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual: 

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

    Em seguida, execute o seguinte comando para enviar o seu pedido 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

    Deve receber uma resposta JSON semelhante à seguinte:

    Veja o conteúdo dos recursos FHIR

    REST

    Veja informações sobre o recurso Patient através do método projects.locations.datasets.fhirStores.fhir.search.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

    Para enviar o seu pedido, escolha uma destas opções:

    curl

    Execute o seguinte comando: 

    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

    Execute o seguinte comando: 

    $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

    Deve receber uma resposta JSON semelhante à seguinte:

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

    Depois de armazenar e ver um recurso FHIR na Cloud Healthcare API, continue a limpar para evitar incorrer em custos na sua Google Cloud conta pelos recursos usados nesta página.

    Para mais informações sobre como trabalhar com dados FHIR, consulte a secção O que se segue.

    Armazene e veja uma mensagem HL7v2

    Esta secção mostra como concluir as seguintes tarefas:

    1. Crie um armazenamento de HL7v2.
    2. Armazena uma mensagem de HL7v2 no armazenamento de HL7v2.
    3. Ver os dados das mensagens HL7v2.

    A implementação de HL7v2 na Cloud Healthcare API está alinhada com a norma HL7v2.

    Crie um armazenamento de HL7v2

    Os armazenamentos de HL7v2 existem em conjuntos de dados e contêm mensagens HL7v2. O exemplo seguinte mostra como criar um armazenamento de HL7v2 denominado my-hl7v2-store.

    REST

    Crie um armazenamento de HL7v2 com o método projects.locations.datasets.hl7V2Stores.create.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

    Para enviar o seu pedido, escolha uma destas opções:

    curl

    Execute o seguinte comando: 

    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

    Execute o seguinte comando: 

    $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

    Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.

    Deve receber uma resposta JSON semelhante à seguinte:

    Crie uma mensagem HL7v2

    1. Transfira o ficheiro de mensagens HL7v2 de exemplo para o seu computador:

      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

      A mensagem HL7v2 contém as seguintes informações codificadas em base64 no campo data do ficheiro de exemplo:

      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. Armazene a mensagem HL7v2 no armazenamento HL7v2 através do método projects.locations.datasets.hl7V2Stores.messages.create. Este início rápido pressupõe que está a executar o comando no mesmo diretório onde transferiu a mensagem HL7v2.

      REST

      Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

      • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

      Para enviar o seu pedido, escolha uma destas opções:

      curl

      Execute o seguinte comando: 

      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

      Execute o seguinte comando: 

      $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

      Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.

      O resultado é o seguinte. Neste resultado:

      • PROJECT_ID, us-central1, my-dataset, my-hl7v2-store: os valores que forneceu na chamada do método
      • MESSAGE_ID: um identificador para a mensagem HL7v2 fornecida pela Cloud Healthcare API. Repare no valor de MESSAGE_ID. Precisa deste valor no passo seguinte.

    Veja o conteúdo das mensagens de HL7v2

    Encontre o MESSAGE_ID na resposta que recebeu quando criou a mensagem HL7v2.

    REST

    Veja os detalhes das mensagens HL7v2 através do método projects.locations.datasets.hl7V2stores.messages.get.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar
    • HL7V2_MESSAGE_ID: o ID na resposta que recebeu quando criou a mensagem HL7v2

    Para enviar o seu pedido, escolha uma destas opções:

    curl

    Execute o seguinte comando: 

    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

    Execute o seguinte comando: 

    $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

    Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.

    Deve receber uma resposta JSON semelhante à seguinte:

    Depois de armazenar e ver a mensagem HL7v2 na Cloud Healthcare API, continue a limpar para evitar incorrer em custos na sua Google Cloud conta pelos recursos usados nesta página.

    Para mais informações sobre como trabalhar com dados HL7v2, consulte a secção Passos seguintes.

    Limpar

    Para evitar incorrer em custos na sua Google Cloud conta pelos recursos usados nesta página, elimine o Google Cloud projeto com os recursos.

    Se criou um novo projeto para este início rápido, siga os passos em Elimine o projeto. Caso contrário, siga os passos em Elimine o conjunto de dados.

    Optional: Revoke credentials from the gcloud CLI. 

    gcloud auth revoke

    Elimine o projeto

      Delete a Google Cloud project:

      gcloud projects delete PROJECT_ID

    Elimine o conjunto de dados

    Se já não precisar do conjunto de dados criado neste início rápido, pode eliminá-lo. A eliminação de um conjunto de dados elimina permanentemente o conjunto de dados e quaisquer armazenamentos FHIR, HL7v2 ou DICOM que contenha.

    REST

    Elimine o conjunto de dados através do método projects.locations.datasets.delete.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do Google Cloud projeto que criou ou selecionou em Antes de começar

    Para enviar o seu pedido, escolha uma destas opções:

    curl

    Execute o seguinte comando: 

    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

    Execute o seguinte comando: 

    $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

    Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.

    Deve receber um código de estado de êxito (2xx) e uma resposta vazia.

    Como correu?

    O que se segue?

    Consulte as secções seguintes para ver informações gerais sobre a Cloud Healthcare API e como realizar as tarefas neste início rápido através de outra interface:

    DICOM

    Consulte a declaração de conformidade com o DICOM para obter informações sobre como a Cloud Healthcare API implementa a norma DICOMweb.

    FHIR

    Consulte a declaração de conformidade com a FHIR para obter informações sobre como a Cloud Healthcare API implementa a norma FHIR.

    HL7v2