Memorizzare 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 utilizzare un solo tipo di datastore, puoi saltare direttamente alla sezione della guida introduttiva dopo aver completato i passaggi descritti in Prima di iniziare e Creare un set di dati.
Prima di iniziare
- 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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
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.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Healthcare API:
gcloud services enable healthcare.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
-
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
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
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.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Healthcare API:
gcloud services enable healthcare.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
-
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
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
Installazione delle librerie client
I seguenti esempi mostrano come installare le librerie client delle API di Google:
Go
Per informazioni sulla configurazione di un ambiente di sviluppo Go, consulta Configurare 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 Configurare 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 configurazione seguente, 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, 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 il seguente esempio per creare un set di dati. Utilizzerai questo set di dati per tutta la guida rapida.
Prima di eseguire i sample, 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 set di datius-central1
per la posizione del set di dati
Go
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per completare questa guida rapida, scegli una delle seguenti sezioni:
- Archiviare e visualizzare un'istanza DICOM
- Archivia e visualizza le 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 sample, 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 sample, 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 set di datius-central1
per la posizione del set di datimy-dicom-store
per l'ID dell'archivio DICOM
Go
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Archivia un'istanza DICOM
Scarica il file di istanza DICOM di esempio sul tuo computer. Il file contiene una radiografia anonimizzata del paziente.
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 i seguenti esempi 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 sample, 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 set di datius-central1
per la posizione del set di datimy-dicom-store
per l'ID dell'archivio DICOMdicom_00000001_000.dcm
per il nome del file DICOM
Go
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Visualizzare i metadati delle istanze DICOM
Esegui i seguenti esempi per visualizzare i metadati dell'istanza.
Prima di eseguire i sample, 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 set di datius-central1
per la posizione del set di datimy-dicom-store
per l'ID dell'archivio DICOM
Go
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori 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 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.
Memorizzare e visualizzare le risorse FHIR
Questa sezione mostra come completare le seguenti attività:
- Crea un archivio FHIR.
- Memorizza una risorsa FHIR nell'archivio 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
Gli archivi FHIR si trovano all'interno di set di dati e includono risorse FHIR. Esegui i seguenti esempi per creare un archivio FHIR.
Prima di eseguire i sample, 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 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 di configurazione Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Memorizzare una risorsa FHIR
Esegui i seguenti esempi per archiviare una risorsa Patient.
Prima di eseguire i sample, 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 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 di configurazione Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Visualizza i contenuti della risorsa FHIR
Esegui i seguenti esempi per visualizzare le informazioni sulla risorsa Patient.
Prima di eseguire i sample, 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 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 di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori 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 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 Passaggi successivi.
Memorizzare 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 i seguenti esempi per creare un archivio HL7v2.
Prima di eseguire i sample, 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 set di datius-central1
per la posizione del set di datimy-hl7v2-store
per l'ID dell'archivio HL7v2
Go
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Crea un messaggio HL7v2
Scarica il file di messaggio HL7v2 di esempio 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, dove è codificato 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 i seguenti esempi 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 sample, 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 set di datius-central1
per la posizione del set di datimy-hl7v2-store
per l'ID dell'archivio HL7v2hl7v2-sample.json
per il nome del file del messaggio HL7v2
Go
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'output contiene un ID messaggio HL7v2. Ti servirà questo ID nella sezione successiva.
Visualizzare i contenuti dei messaggi HL7v2
Esegui i seguenti esempi per visualizzare i contenuti del messaggio HL7v2.
Prima di eseguire i sample, 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 set di datius-central1
per la posizione del set di datimy-hl7v2-store
per l'ID dell'archivio 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 Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori 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 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 HL7v2, consulta Passaggi successivi.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate su 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.
-
Optional: Revoke the authentication credentials that you created, and delete the local credential file.
gcloud auth application-default revoke
-
Optional: Revoke credentials from the gcloud CLI.
gcloud auth revoke
Elimina il progetto
Delete a Google Cloud project:
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 sample, 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 set di datius-central1
per la posizione del set di dati
Go
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Go.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Java.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Node.js.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Cloud Healthcare che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per autenticarti all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare 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à in questa guida rapida utilizzando un'altra interfaccia:
- Leggi una panoramica dei concetti dell'API Cloud Healthcare
- Memorizza i dati sanitari con
curl
o PowerShell - Archiviare i dati sanitari con la console Google Cloud
- Archiviare i dati sanitari con gcloud CLI
DICOM
- Creare e gestire gli archivi DICOM
- Connessione di 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 le risorse FHIR
- Importare ed esportare dati FHIR tramite Cloud Storage
Leggi la dichiarazione di conformità FHIR per informazioni su come l'API Cloud Healthcare implementa lo standard FHIR.