Gesundheitsdaten mit curl und PowerShell speichern
Auf dieser Seite erfahren Sie, wie Sie die Cloud Healthcare API und curl
oder PowerShell verwenden
um die folgenden Aufgaben auszuführen:
- ein Cloud Healthcare API-Dataset erstellen
- Erstellen Sie einen der folgenden Datenspeicher im Dataset:
- DICOM-Speicher (Digital Imaging and Communications in Medicine)
- FHIR-Speicher (Fast Healthcare Interoperability Resources)
- Health Level Seven International Version 2-Speicher (HL7v2)
- Bestimmte Arten von medizinischen Daten im DICOM-, FHIR- oder HL7v2-Speicher speichern und prüfen
Wenn Sie nur mit einer Art von Datenspeicher arbeiten möchten, können Sie diesen Schritt überspringen. direkt zu diesem Abschnitt der Kurzanleitung, nachdem Sie die Schritte in Vorbereitung und Dataset erstellen
Hinweise
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
- Testen Sie die Authentifizierungsumgebung mit der Google Cloud CLI.
Prüfen Sie, ob der folgende Befehl einen Textstring ohne Fehler ausgibt:
gcloud auth application-default print-access-token
Dataset erstellen
Datasets enthalten Datenspeicher und Datenspeicher enthalten medizinische Daten. Um die Cloud Healthcare API verwenden zu können, müssen Sie mindestens ein Dataset erstellen.
Im folgenden Beispiel wird gezeigt, wie Sie ein Dataset mit dem Namen my-dataset
in der
us-central1
. Sie verwenden das Dataset in dieser Kurzanleitung,
DICOM-, FHIR- und HL7v2-Speicher erstellen.
REST
Erstellen Sie das Dataset mit der Methode
projects.locations.datasets.create
.Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets?datasetId=my-dataset"PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets?datasetId=my-dataset" | Select-Object -Expand ContentAPIs Explorer
Öffnen Sie das Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
OPERATION_ID
. Sie benötigen diesen Wert im nächsten Schritt.Rufen Sie den Status des lang andauernden Vorgangs mit der Methode
projects.locations.datasets.operations.get
ab.Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsOPERATION_ID
: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/operations/OPERATION_ID"PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
Öffnen Sie das Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
"done": true
enthält, wird der lang andauernden Vorgang abgeschlossen ist.
Wählen Sie einen der folgenden Abschnitte aus, um diese Kurzanleitung abzuschließen:
- DICOM-Instanz speichern und ansehen
- FHIR-Ressourcen speichern und ansehen
- HL7v2-Nachricht speichern und ansehen
DICOM-Instanz speichern und ansehen
In diesem Abschnitt wird beschrieben, wie Sie die folgenden Aufgaben ausführen:
- DICOM-Speicher erstellen
- DICOM-Instanz im DICOM-Speicher speichern
- Metadaten der DICOM-Instanz aufrufen
Die Cloud Healthcare API implementiert die DICOMweb für die Speicherung und den Zugriff auf medizinische Bildgebungsdaten.
DICOM-Speicher erstellen
DICOM-Speicher sind in Datasets vorhanden und enthalten DICOM-Instanzen. Die folgenden
Beispiel zeigt, wie Sie einen DICOM-Speicher mit dem Namen my-dicom-store
erstellen.
REST
Erstellen Sie mit der Methode projects.locations.datasets.dicomStores.create
einen DICOM-Speicher.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores?dicomStoreId=my-dicom-store"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores?dicomStoreId=my-dicom-store" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie das Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
DICOM-Instanz speichern
Laden Sie die Beispiel-DICOM-Instanzdatei auf Ihren Rechner herunter. Die Datei enthält eine de-identifizierte Röntgenaufnahme eines Patienten.
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
Speichern Sie die DICOM-Instanz mit der Methode
dicomStores.storeInstances
. In diesem Schnellstart wird davon ausgegangen, dass Sie den Befehl im selben Verzeichnis ausführen, wo Sie die DICOM-Instanz heruntergeladen haben.REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/dicom" \
--data-binary @dicom_00000001_000.dcm \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store/dicomWeb/studies"PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-InFile dicom_00000001_000.dcm `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store/dicomWeb/studies" | Select-Object -Expand ContentDie Ausgabe ist die folgende XML-Antwort. In dieser Ausgabe gilt:
PROJECT_ID
,us-central1
,my-dataset
,my-dicom-store
: die Werte, die Sie beim Ausführen des Befehls angegeben habenSOPClassUID
: Kennzeichnet die SOP-Klasse (Service Object Pair) eindeutigSOPInstanceUID
: Identifiziert die SOP-Instanz (Dienst-Objekt-Paar) eindeutigSTUDY_UID
: Identifiziert die Studieninstanz eindeutigSERIES_UID
: Kennzeichnet die Serieninstanz eindeutigINSTANCE_UID
: Identifiziert die Instanz eindeutig
Metadaten der DICOM-Instanz ansehen
REST
Rufen Sie mit der Methode dicomStores.searchForInstances
die Metadaten für die Instanz auf.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store/dicomWeb/instances"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store/dicomWeb/instances" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie das Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Nachdem Sie die DICOM-Instanz in der Cloud Healthcare API gespeichert und aufgerufen haben, Fahren Sie mit dem Abschnitt Bereinigen fort, damit keine Gebühren für Ihr Google Cloud-Konto für die auf dieser Seite verwendeten Ressourcen.
Weitere Informationen zum Arbeiten mit DICOM-Daten finden Sie unter Nächste Schritte.
FHIR-Ressourcen speichern und ansehen
In diesem Abschnitt wird beschrieben, wie Sie die folgenden Aufgaben ausführen:
- Erstellen Sie einen FHIR-Speicher.
- Speichern Sie eine FHIR-Ressource im FHIR-Speicher.
- Sehen Sie sich die Daten zur FHIR-Ressource an.
Die Cloud Healthcare API implementiert den FHIR-Standard. um FHIR-Daten zu speichern und darauf zuzugreifen.
FHIR-Speicher erstellen
FHIR-Speicher befinden sich in Datasets und enthalten FHIR-Ressourcen. Die folgenden
zeigt, wie Sie einen FHIR-Speicher mit dem Namen my-fhir-store
erstellen, der
FHIR-Version R4.
REST
Erstellen Sie mit der Methode projects.locations.datasets.fhirStores.create
einen FHIR-Speicher.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
JSON-Text der Anfrage:
{ "version": "R4" }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "version": "R4" } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores?fhirStoreId=my-fhir-store"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "version": "R4" } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores?fhirStoreId=my-fhir-store" | Select-Object -Expand Content
APIs Explorer
Kopieren Sie den Anfragetext und öffnen Sie die Referenzseite für Methoden. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Fügen Sie den Anfragetext in dieses Tool ein, füllen Sie alle Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
FHIR-Ressourcen speichern
REST
Erstellen Sie mit der Methode projects.locations.datasets.fhirStores.fhir.create
eine Patientenressource im FHIR-Speicher.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
JSON-Text der Anfrage:
{ "name": [ { "use": "official", "family": "Smith", "given": [ "Darcy" ] } ], "gender": "female", "birthDate": "1970-01-01", "resourceType": "Patient" }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "name": [ { "use": "official", "family": "Smith", "given": [ "Darcy" ] } ], "gender": "female", "birthDate": "1970-01-01", "resourceType": "Patient" } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/fhir+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "name": [ { "use": "official", "family": "Smith", "given": [ "Darcy" ] } ], "gender": "female", "birthDate": "1970-01-01", "resourceType": "Patient" } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/fhir+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient" | Select-Object -Expand Content
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
FHIR-Ressourceninhalte ansehen
REST
Sehen Sie sich Informationen zur Patientenressource mithilfe der
projects.locations.datasets.fhirStores.fhir.search
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "entry": [ { "fullUrl": "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient/PATIENT_ID", "resource": { "birthDate": "1970-01-01", "gender": "female", "id": "PATIENT_ID", "meta": { "lastUpdated": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ", "versionId": "MTY5MDQxMDk5ODU1OTkxNTAwMA" }, "name": [ { "family": "Smith", "given": [ "Darcy" ], "use": "official" } ], "resourceType": "Patient" }, "search": { "mode": "match" } } ], "link": [ { "relation": "search", "url": "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient/?" }, { "relation": "first", "url": "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient/?" }, { "relation": "self", "url": "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store/fhir/Patient/?" } ], "resourceType": "Bundle", "total": 1, "type": "searchset" }
Nach dem Speichern und Aufrufen einer FHIR-Ressource in der Cloud Healthcare API Fahren Sie mit dem Abschnitt Bereinigen fort, damit keine Gebühren für Ihr Google Cloud-Konto für die auf dieser Seite verwendeten Ressourcen.
Weitere Informationen zum Arbeiten mit FHIR-Daten finden Sie unter Nächste Schritte.
HL7v2-Nachricht speichern und ansehen
In diesem Abschnitt wird beschrieben, wie Sie die folgenden Aufgaben ausführen:
- HL7v2-Speicher erstellen.
- HL7v2-Nachricht im HL7v2-Speicher speichern.
- Sehen Sie sich die HL7v2-Nachrichtendaten an.
Die HL7v2-Implementierung in der Cloud Healthcare API entspricht der HL7v2-Standard.
HL7v2-Speicher erstellen
HL7v2-Speicher sind in Datasets vorhanden und enthalten HL7v2-Nachrichten. Die folgenden
Das Beispiel zeigt, wie ein HL7v2-Speicher mit dem Namen my-hl7v2-store
erstellt wird.
REST
Erstellen Sie mit der Methode projects.locations.datasets.hl7V2Stores.create
einen HL7v2-Speicher.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores?hl7V2StoreId=my-hl7v2-store"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores?hl7V2StoreId=my-hl7v2-store" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie das Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
HL7v2-Nachricht erstellen
Laden Sie die Beispieldatei für eine HL7v2-Nachricht auf Ihren Computer herunter:
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
Die HL7v2-Nachricht enthält die folgenden, base-64-codierten Informationen in dem Feld
data
der Beispieldatei: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
Speichern Sie die HL7v2-Nachricht mit der Methode
projects.locations.datasets.hl7V2Stores.messages.create
im HL7v2-Speicher. In dieser Kurzanleitung wird davon ausgegangen, und führen den Befehl in dem Verzeichnis aus, in dem Sie die HL7v2-Nachricht heruntergeladen haben.REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
--data-binary @hl7v2-sample.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores/my-hl7v2-store/messages"PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-InFile hl7v2-sample.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores/my-hl7v2-store/messages" | Select-Object -Expand ContentAPIs Explorer
Öffnen Sie das Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Die Ausgabe sieht so aus. In dieser Ausgabe gilt:
PROJECT_ID
,us-central1
,my-dataset
,my-hl7v2-store
: die Werte, die Sie im Methodenaufruf angegeben habenMESSAGE_ID
: eine Kennung für die HL7v2-Nachricht, die von der Cloud Healthcare API bereitgestellt wird. Notieren Sie sich den Wert vonMESSAGE_ID
. Sie benötigen diesen Wert im nächsten Schritt.
Inhalt von HL7v2-Nachrichten ansehen
Suchen Sie die MESSAGE_ID
in der Antwort, die Sie beim Erstellen erhalten haben
der HL7v2-Nachricht.
REST
Sehen Sie sich die HL7v2-Nachrichtendetails mit der Methode projects.locations.datasets.hl7V2stores.messages.get
an.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt habenHL7V2_MESSAGE_ID
: die ID in der Antwort, die Sie beim Erstellen der HL7v2-Nachricht erhalten haben
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores/my-hl7v2-store/messages/HL7V2_MESSAGE_ID"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores/my-hl7v2-store/messages/HL7V2_MESSAGE_ID" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie das Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Nachdem Sie die HL7v2-Nachricht in der Cloud Healthcare API gespeichert und angezeigt haben, Fahren Sie mit dem Abschnitt Bereinigen fort, damit keine Gebühren für Ihr Google Cloud-Konto für die auf dieser Seite verwendeten Ressourcen.
Weitere Informationen zum Arbeiten mit HL7v2-Daten finden Sie unter Nächste Schritte.
Bereinigen
Löschen Sie das Google Cloud-Projekt mit den Ressourcen, damit Ihrem Google Cloud-Konto die auf dieser Seite verwendeten Ressourcen nicht in Rechnung gestellt werden.
Wenn Sie ein neues Projekt für diese Kurzanleitung erstellt haben, führen Sie die Schritte unter Projekt löschen aus. Andernfalls führen Sie die Schritte unter Dataset löschen aus.
Projekt löschen
Google Cloud-Projekt löschen:
gcloud projects delete PROJECT_ID
Dataset löschen
Wenn Sie das in dieser Kurzanleitung erstellte Dataset nicht mehr benötigen, können Sie es löschen. Durch das Löschen eines Datasets werden das Dataset und alle darin enthaltenen FHIR-, HL7v2- oder DICOM-Speicher endgültig gelöscht.
REST
Löschen Sie das Dataset mit der Methode projects.locations.datasets.delete
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Die ID des Google Cloud-Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie das Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die erforderlichen Felder aus und klicken Sie auf Ausführen.
Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.
Wie ist es gelaufen?
Nächste Schritte
In den folgenden Abschnitten finden Sie allgemeine Informationen zur Cloud Healthcare API und wie Sie die Aufgaben in dieser Kurzanleitung über eine andere Benutzeroberfläche ausführen:
- Übersicht über die Konzepte der Cloud Healthcare API lesen
- Gesundheitsdaten mit Clientbibliotheken speichern
- Gesundheitsdaten mit der Google Cloud Console speichern
- Gesundheitsdaten mit der gcloud CLI speichern
DICOM
- DICOM-Speicher erstellen und verwalten
- PACS mit der Cloud Healthcare API verbinden
- DICOMweb-Standard verwenden
- DICOM-Daten mit Cloud Storage importieren und exportieren
Informationen dazu, wie die Cloud Healthcare API den DICOMweb-Standard umsetzt, finden Sie in der DICOM-Konformitätserklärung.
FHIR
- FHIR-Speicher erstellen und verwalten
- FHIR-Ressourcen erstellen und verwalten
- FHIR-Daten mit Cloud Storage importieren und exportieren
Informationen dazu, wie die Cloud Healthcare API den FHIR-Standard umsetzt, finden Sie in der FHIR-Konformitätserklärung.