Archivia i dati sanitari con le librerie client
Questa pagina mostra come utilizzare l'API Cloud Healthcare e le librerie client dell'API di Google per completare le attività seguenti:
- Creare un set di dati dell'API Cloud Healthcare.
- Crea uno dei seguenti datastore all'interno del set di dati:
- Archivio Digital Imaging and Communications in Medicine (DICOM)
- Archivio Fast Healthcare Interoperability Resources (FHIR)
- Archivio Health Level Seven International Version 2 (HL7v2)
- Archivia e ispeziona un particolare tipo di dati medici nel datastore DICOM, FHIR o HL7v2.
Se vuoi lavorare con un solo tipo di datastore, puoi passare direttamente a quella sezione della guida rapida dopo aver completato i passaggi descritti in Prima di iniziare e Creare un set di dati.
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
Create or select a Google Cloud project.
-
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.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva Cloud Healthcare API.
gcloud services enable healthcare.googleapis.com
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
-
Concedi i ruoli al tuo Account Google. Esegui questo comando una volta per ciascuno dei seguenti ruoli IAM:
roles/healthcare.datasetAdmin, roles/healthcare.fhirStoreAdmin, roles/healthcare.dicomStoreAdmin, roles/healthcare.hl7V2StoreAdmin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Sostituisci
PROJECT_ID
con l'ID progetto. - Sostituisci
EMAIL_ADDRESS
con il tuo indirizzo email. - Sostituisci
ROLE
con ogni singolo ruolo.
- Sostituisci
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
Create or select a Google Cloud project.
-
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.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva Cloud Healthcare API.
gcloud services enable healthcare.googleapis.com
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
-
Concedi i ruoli al tuo Account Google. Esegui questo comando una volta per ciascuno dei seguenti ruoli IAM:
roles/healthcare.datasetAdmin, roles/healthcare.fhirStoreAdmin, roles/healthcare.dicomStoreAdmin, roles/healthcare.hl7V2StoreAdmin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Sostituisci
PROJECT_ID
con l'ID progetto. - Sostituisci
EMAIL_ADDRESS
con il tuo indirizzo email. - Sostituisci
ROLE
con ogni singolo ruolo.
- Sostituisci
Installazione delle librerie client
Gli esempi riportati di seguito mostrano come installare le librerie client delle API di Google:
Go
Per informazioni sulla configurazione di un ambiente di sviluppo Go, consulta Configurazione di un ambiente di sviluppo Go.
go get google.golang.org/api/healthcare/v1
Java
Per informazioni sulla configurazione di un ambiente di sviluppo Java, consulta Configurazione di un ambiente di sviluppo Java.
Se utilizzi Maven, aggiungi quanto segue al file pom.xml
utilizzando una versione nella distinta base (BOM) delle librerie Google Cloud.
Per saperne di più sui BOM, consulta Utilizzo delle librerie client di Cloud.
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>libraries-bom</artifactId>
<version>26.18.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.apis</groupId>
<artifactId>google-api-services-healthcare</artifactId>
</dependency>
</dependencies>
Node.js
Per informazioni sulla configurazione di un ambiente di sviluppo Node.js, consulta Configurare un ambiente di sviluppo Node.js.
npm install @googleapis/healthcare
Python
Per informazioni sulla configurazione di un ambiente di sviluppo Python, consulta Configurazione di un ambiente di sviluppo Python.
# Use a virtual environment as shown in the Python development environment guide.
pip install --upgrade google-api-python-client
crea un set di dati
I set di dati contengono datastore, i quali a loro volta contengono dati sanitari. Per utilizzare l'API Cloud Healthcare, devi creare almeno un set di dati.
Esegui questo esempio per creare un set di dati. Potrai utilizzare questo set di dati durante questa guida rapida.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di dati
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per completare questa guida rapida, scegli una delle seguenti sezioni:
- Archivia e visualizza un'istanza DICOM
- Archivia e visualizza le risorse FHIR
- Archivia e visualizza un messaggio HL7v2
Archivia e visualizza un'istanza DICOM
Questa sezione mostra come completare le seguenti attività:
- Crea un archivio DICOM.
- Archiviare un'istanza DICOM nell'archivio DICOM.
- Visualizza i metadati dell'istanza DICOM.
L'API Cloud Healthcare implementa lo standard DICOMweb per archiviare e accedere ai dati di diagnostica per immagini.
Crea un archivio DICOM
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
Gli archivi DICOM si trovano all'interno di set di dati e contengono le istanze DICOM. Esegui gli esempi seguenti per creare un archivio DICOM.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di datimy-dicom-store
per l'ID datastore DICOM
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Archivia un'istanza DICOM
Scarica il file di istanza DICOM di esempio sulla tua macchina. Il file contiene una radiografia del paziente anonimizzata.
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
Esegui gli esempi riportati di seguito per archiviare l'istanza DICOM. Gli esempi presuppongono che tu stia eseguendo il codice dalla stessa directory in cui hai scaricato l'istanza DICOM.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di datimy-dicom-store
per l'ID datastore DICOMdicom_00000001_000.dcm
per il nome del file DICOM
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Visualizza i metadati dell'istanza DICOM
Esegui gli esempi riportati di seguito per visualizzare i metadati dell'istanza.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di datimy-dicom-store
per l'ID datastore DICOM
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Dopo aver archiviato e visualizzato un'istanza DICOM nell'API Cloud Healthcare, continua con la pulizia per evitare che al tuo account Google Cloud vengano addebitati costi per le risorse utilizzate in questa pagina.
Per ulteriori informazioni sull'utilizzo dei dati DICOM, consulta Passaggi successivi.
Archivia e visualizza le risorse FHIR
Questa sezione mostra come completare le seguenti attività:
- Creare un datastore FHIR.
- Archiviare una risorsa FHIR nel datastore FHIR.
- Visualizza i dati della risorsa FHIR.
L'API Cloud Healthcare implementa lo standard della specifica FHIR per archiviare e accedere ai dati FHIR.
Crea un archivio FHIR
I datastore FHIR esistono all'interno di set di dati e contengono risorse FHIR. Esegui i seguenti esempi per creare un datastore FHIR.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di datimy-fhir-store
per l'ID datastore FHIR
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Archivia una risorsa FHIR
Esegui i seguenti esempi per archiviare una risorsa Patient.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di datimy-fhir-store
per l'ID datastore FHIR
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Visualizza i contenuti della risorsa FHIR
Esegui gli esempi riportati di seguito per visualizzare le informazioni sulla risorsa Paziente.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di datimy-fhir-store
per l'ID datastore FHIRPatient
per il tipo di risorsa FHIR
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Dopo aver archiviato e visualizzato una risorsa FHIR nell'API Cloud Healthcare, continua con la pulizia per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina.
Per ulteriori informazioni sull'utilizzo dei dati FHIR, vedi Passaggi successivi.
archivia e visualizza un messaggio HL7v2
Questa sezione mostra come completare le seguenti attività:
- Creare un archivio HL7v2.
- Archiviare un messaggio HL7v2 nell'archivio HL7v2.
- Visualizzare i dati del messaggio HL7v2.
L'implementazione HL7v2 nell'API Cloud Healthcare è in linea con lo standard HL7v2.
Crea un archivio HL7v2
Gli archivi HL7v2 esistono all'interno di set di dati e includono i messaggi HL7v2. Esegui i seguenti esempi per creare un archivio HL7v2.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di datimy-hl7v2-store
per l'ID store HL7v2
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
crea un messaggio HL7v2
Scarica il file di messaggi HL7v2 di esempio sulla tua macchina:
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
Il messaggio HL7v2 contiene le seguenti informazioni di base, in cui è codificata in base-64 nel campo
data
del file di esempio: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
Esegui gli esempi riportati di seguito per archiviare il messaggio HL7v2. Gli esempi presuppongono che tu stia eseguendo il codice dalla stessa directory in cui hai scaricato il messaggio HL7v2.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di datimy-hl7v2-store
per l'ID store HL7v2hl7v2-sample.json
per il nome del file del messaggio HL7v2
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'output contiene un ID messaggio HL7v2. Questo ID ti servirà nella sezione successiva.
Visualizza il contenuto del messaggio HL7v2
Esegui gli esempi riportati di seguito per visualizzare i contenuti del messaggio HL7v2.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di datimy-hl7v2-store
per l'ID store HL7v2- l'ID nella risposta quando hai archiviato il messaggio per l'ID del messaggio HL7v2
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Dopo aver archiviato e visualizzato un messaggio HL7v2 nell'API Cloud Healthcare, continua con la pulizia per evitare che al tuo account Google Cloud vengano addebitati costi per le risorse utilizzate in questa pagina.
Per ulteriori informazioni su come lavorare con i dati HL7v2, vedi Passaggi successivi.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il progetto Google Cloud con le risorse.
Se hai creato un nuovo progetto per questa guida rapida, segui i passaggi descritti in Eliminare il progetto. In caso contrario, segui i passaggi descritti in Eliminare il set di dati.
-
Facoltativo: revoca le credenziali di autenticazione che hai creato ed elimina il file delle credenziali locale.
gcloud auth application-default revoke
-
Facoltativo: revoca le credenziali dallgcloud CLI.
gcloud auth revoke
Elimina il progetto
Elimina un progetto Google Cloud:
gcloud projects delete PROJECT_ID
Eliminazione del set di dati
Se non hai più bisogno del set di dati creato in questa guida di avvio rapido, puoi eliminarlo. L'eliminazione di un set di dati elimina definitivamente il set di dati e tutti gli archivi FHIR, HL7v2 o DICOM al suo interno.
Prima di eseguire gli esempi, rimuovi il commento e fornisci i seguenti valori, se necessario:
- L'ID del progetto Google Cloud che hai creato o selezionato in Prima di iniziare per l'ID progetto
my-dataset
per l'ID del set di datius-central1
per la posizione del set di dati
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Com'è andata?
Passaggi successivi
Consulta le sezioni seguenti per informazioni generali sull'API Cloud Healthcare e su come eseguire le attività in questa guida rapida utilizzando un'altra interfaccia:
- Leggi una panoramica dei concetti dell'API Cloud Healthcare
- Archivia i dati sanitari con
curl
o PowerShell - Archivia i dati sanitari con la console Google Cloud
- Archivia i dati sanitari con gcloud CLI
DICOM
- Crea e gestisci gli archivi DICOM
- Connetti un PACS all'API Cloud Healthcare
- Usa lo standard DICOMweb
- Importa ed esporta i dati DICOM utilizzando Cloud Storage
Leggi la dichiarazione di conformità DICOM per informazioni su come l'API Cloud Healthcare implementa lo standard DICOMweb.
FHIR
- Crea e gestisci i datastore FHIR
- Crea e gestisci le risorse FHIR
- Importa ed esporta i dati FHIR utilizzando Cloud Storage
Leggi la dichiarazione di conformità FHIR per informazioni su come l'API Cloud Healthcare implementa lo standard FHIR.