Archiviare i dati sanitari con le librerie client
Questa pagina mostra come utilizzare l'API Cloud Healthcare e le librerie client delle API di Google per completare le seguenti attività:
- 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)
- Memorizzare ed esaminare un particolare tipo di dati medici nell'archivio DICOM, FHIR o HL7v2.
Se ti interessa lavorare solo con un tipo di datastore, puoi passare direttamente a quella sezione della guida rapida dopo aver completato i passaggi descritti in Prima di iniziare e Crea 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 senza costi per l'esecuzione, il test e il deployment dei workload.
-
Installa Google Cloud CLI.
-
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
-
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init -
Crea o seleziona un Google Cloud progetto.
Ruoli richiesti per selezionare o creare un progetto
- Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
-
Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto
(
roles/resourcemanager.projectCreator), che contiene l'autorizzazioneresourcemanager.projects.create. Scopri come concedere i ruoli.
-
Creare un progetto Google Cloud :
gcloud projects create PROJECT_ID
Sostituisci
PROJECT_IDcon un nome per il progetto Google Cloud che stai creando. -
Seleziona il progetto Google Cloud che hai creato:
gcloud config set project PROJECT_ID
Sostituisci
PROJECT_IDcon il nome del progetto Google Cloud .
-
Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .
Abilita l'API Cloud Healthcare:
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (
roles/serviceusage.serviceUsageAdmin), che include l'autorizzazioneserviceusage.services.enable. Scopri come concedere i ruoli.gcloud services enable healthcare.googleapis.com
-
Crea le credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.
-
Concedi ruoli al tuo account utente. Esegui il seguente comando una volta per ciascuno dei seguenti ruoli IAM:
roles/healthcare.datasetAdmin, roles/healthcare.fhirStoreAdmin, roles/healthcare.dicomStoreAdmin, roles/healthcare.hl7V2StoreAdmingcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Sostituisci quanto segue:
PROJECT_ID: il tuo ID progetto.USER_IDENTIFIER: l'identificatore del tuo account utente . Ad esempio:myemail@example.com.ROLE: il ruolo IAM che concedi al tuo account utente.
-
Installa Google Cloud CLI.
-
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
-
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init -
Crea o seleziona un Google Cloud progetto.
Ruoli richiesti per selezionare o creare un progetto
- Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
-
Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto
(
roles/resourcemanager.projectCreator), che contiene l'autorizzazioneresourcemanager.projects.create. Scopri come concedere i ruoli.
-
Creare un progetto Google Cloud :
gcloud projects create PROJECT_ID
Sostituisci
PROJECT_IDcon un nome per il progetto Google Cloud che stai creando. -
Seleziona il progetto Google Cloud che hai creato:
gcloud config set project PROJECT_ID
Sostituisci
PROJECT_IDcon il nome del progetto Google Cloud .
-
Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .
Abilita l'API Cloud Healthcare:
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (
roles/serviceusage.serviceUsageAdmin), che include l'autorizzazioneserviceusage.services.enable. Scopri come concedere i ruoli.gcloud services enable healthcare.googleapis.com
-
Crea le credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.
-
Concedi ruoli al tuo account utente. Esegui il seguente comando una volta per ciascuno dei seguenti ruoli IAM:
roles/healthcare.datasetAdmin, roles/healthcare.fhirStoreAdmin, roles/healthcare.dicomStoreAdmin, roles/healthcare.hl7V2StoreAdmingcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Sostituisci quanto segue:
PROJECT_ID: il tuo ID progetto.USER_IDENTIFIER: l'identificatore del tuo account utente . Ad esempio:myemail@example.com.ROLE: il ruolo IAM che concedi al tuo account utente.
Installazione delle librerie client
Gli esempi seguenti mostrano come installare le librerie client delle API di Google:
Go
Per informazioni sulla configurazione di un ambiente di sviluppo Go, vedi 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, vedi Configurazione di un ambiente di sviluppo Java.
Se utilizzi Maven, aggiungi quanto segue al file pom.xml utilizzando la versione nel file https://github.com/GoogleCloudPlatform/java-docs-samples/blob/main/healthcare/v1/pom.xml.
Ad esempio, nella seguente configurazione, sostituisci VERSION
con la versione nel file:
<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> <version>VERSION</version> </dependency> </dependencies>
Node.js
Per informazioni sulla configurazione di un ambiente di sviluppo Node.js, vedi Configurazione di un ambiente di sviluppo Node.js.
npm install @googleapis/healthcare
Python
Per informazioni sulla configurazione di un ambiente di sviluppo Python, vedi 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 il seguente esempio per creare un set di dati. Utilizzerai questo set di dati in tutta la guida rapida.
Prima di eseguire i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di dati
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Per completare questa guida rapida, scegli una delle seguenti sezioni:
- Archiviare e visualizzare un'istanza DICOM
- Archiviazione e visualizzazione delle risorse FHIR
- Archiviare e visualizzare un messaggio HL7v2
Archiviare e visualizzare 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 i campioni, rimuovi il commento e fornisci i seguenti valori, se necessario:
Gli archivi DICOM si trovano all'interno di set di dati e contengono istanze DICOM. Esegui i seguenti esempi per creare un archivio DICOM.
Prima di eseguire i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di datimy-dicom-storeper l'ID archivio DICOM
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Archiviare un'istanza DICOM
Scarica il file di esempio dell'istanza DICOM sul tuo computer. Il file contiene una radiografia deidentificata del paziente X.
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 i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di datimy-dicom-storeper l'ID archivio DICOMdicom_00000001_000.dcmper il nome del file DICOM
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Visualizzare i metadati delle istanze DICOM
Esegui gli esempi seguenti per visualizzare i metadati dell'istanza.
Prima di eseguire i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di datimy-dicom-storeper l'ID archivio DICOM
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura 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 la sezione Passaggi successivi.
Archiviazione e visualizzazione delle risorse FHIR
Questa sezione mostra come completare le seguenti attività:
- Crea un archivio FHIR.
- Archivia una risorsa FHIR nel datastore FHIR.
- Visualizza i dati della risorsa FHIR.
L'API Cloud Healthcare implementa lo standard specifica FHIR per archiviare e accedere ai dati FHIR.
Crea un archivio FHIR
Gli archivi FHIR si trovano all'interno di set di dati e contengono risorse FHIR. Esegui gli esempi riportati di seguito per creare un archivio FHIR.
Prima di eseguire i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di datimy-fhir-storeper l'ID datastore FHIR
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Archiviazione di una risorsa FHIR
Esegui gli esempi riportati di seguito per archiviare una risorsa Patient.
Prima di eseguire i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di datimy-fhir-storeper l'ID datastore FHIR
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura 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 Patient.
Prima di eseguire i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di datimy-fhir-storeper l'ID datastore FHIRPatientper il tipo di risorsa FHIR
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura 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 per le risorse utilizzate in questa pagina.
Per ulteriori informazioni sull'utilizzo dei dati FHIR, consulta la sezione Passaggi successivi.
Archiviare e visualizzare un messaggio HL7v2
Questa sezione mostra come completare le seguenti attività:
- Crea un archivio HL7v2.
- Memorizza un messaggio HL7v2 nell'archivio HL7v2.
- Visualizza i dati del messaggio HL7v2.
L'implementazione di 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 gli esempi riportati di seguito per creare un archivio HL7v2.
Prima di eseguire i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di datimy-hl7v2-storeper l'ID datastore HL7v2
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Creare un messaggio HL7v2
Scarica il file di esempio del messaggio HL7v2 sul tuo computer:
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, codificate in base 64 nel campo
datadel 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^^^^ORGNMBREsegui 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 i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di datimy-hl7v2-storeper l'ID datastore HL7v2hl7v2-sample.jsonper il nome del file del messaggio HL7v2
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
L'output contiene un ID messaggio HL7v2. Ti servirà nella sezione successiva.
Visualizzare i contenuti dei messaggi HL7v2
Esegui gli esempi riportati di seguito per visualizzare i contenuti del messaggio HL7v2.
Prima di eseguire i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di datimy-hl7v2-storeper l'ID datastore HL7v2- l'ID nella risposta quando hai archiviato il messaggio per l'ID messaggio HL7v2
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Dopo aver archiviato e visualizzato un messaggio HL7v2 nell'API Cloud Healthcare, continua con la liberazione di spazio 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 HL7v2, consulta 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 Elimina 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 locali.
gcloud auth application-default revoke
-
(Facoltativo) Revoca le credenziali da gcloud 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 è definitiva ed elimina permanentemente tutti gli archivi FHIR, HL7v2 o DICOM al suo interno.
Prima di eseguire i campioni, 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-datasetper l'ID set di datius-central1per la posizione del set di dati
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Cloud Healthcare per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Com'è andata?
Passaggi successivi
Consulta le seguenti sezioni per informazioni generali sull'API Cloud Healthcare e su come eseguire le attività di questa guida rapida utilizzando un'altra interfaccia:
- Leggi una panoramica dei concetti dell'API Cloud Healthcare
- Memorizzare dati sanitari con
curlo PowerShell - Memorizzare i dati sanitari con la console Google Cloud
- Archiviare dati sanitari con gcloud CLI
DICOM
- Creazione e gestione degli archivi DICOM
- Connettere un PACS all'API Cloud Healthcare
- Utilizzare lo standard DICOMweb
- Importare ed esportare dati DICOM utilizzando Cloud Storage
Leggi la dichiarazione di conformità DICOM per informazioni su come l'API Cloud Healthcare implementa lo standard DICOMweb.
FHIR
- Creare e gestire gli archivi FHIR
- Creare e gestire risorse FHIR
- Importare ed esportare dati FHIR utilizzando Cloud Storage
Leggi la dichiarazione di conformità FHIR per informazioni su come l'API Cloud Healthcare implementa lo standard FHIR.