Halaman ini menjelaskan struktur jalur dan operasi Cloud Healthcare API serta cara menggunakannya untuk mengakses dan mengelola data.
Ringkasan
Data perawatan kesehatan dalam set data dan penyimpanan data dapat diakses dan dikelola menggunakan REST API yang mengidentifikasi setiap penyimpanan data menggunakan:
- Project Google Cloud
- Lokasi Google Cloud
- ID set data
- Jenis penyimpanan data
- ID penyimpanan data
API ini juga menerapkan standar khusus modalitas untuk akses yang konsisten dengan standar industri untuk modalitas tersebut.
Operasi administratif
Operasi administratif tersedia untuk set data dan semua penyimpanan data. Operasi ini secara khusus terdiri dari pembuatan, pembacaan, pembaruan, dan penghapusan (CRUD) set data dan penyimpanan data. Operasi administratif konsisten dengan sebagian besar Google Cloud (Google Cloud) API dan tidak memerlukan kepatuhan apa pun terhadap standar modalitas tertentu.
Contoh operasi administratif meliputi:
- Membuat, menghapus, mendapatkan, mencantumkan, dan menerapkan patch pada set data dan penyimpanan data
- Menetapkan, mendapatkan, dan menguji izin IAM
Nama resource
Nama resource terdiri dari, minimal, project ID dan lokasi. Fungsi ini dapat diperluas untuk menyertakan set data, penyimpanan data, dan resource turunan penyimpanan data.
Format untuk nama resource untuk penyimpanan data yang berada dalam set data Cloud Healthcare API terlihat seperti ini:
/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/DATA_STORE_TYPE/DATA_STORE_ID
Misalnya, nama resource untuk penyimpanan HL7v2 yang disebut clinical-store1 akan terlihat
seperti ini:
/projects/my-project/locations/us-central1/datasets/my-dataset/hl7V2Stores/clinical-store1
Nama resource ini menampilkan project bernama my-project di
region us-central1. Project ini berisi set data bernama my-dataset, dan set data tersebut berisi penyimpanan HL7v2 bernama clinical-store1.
Operasi pada lokasi, set data, penyimpanan data, atau resource turunan penyimpanan data semuanya mengharuskan nama resource diberikan di jalur REST atau permintaan gRPC.
Jalur modalitas untuk operasi khusus modalitas
Operasi yang mengakses data di penyimpanan data khusus modalitas menggunakan jalur permintaan yang terdiri dari dua bagian: nama resource (untuk mengidentifikasi penyimpanan data yang akan diakses), dan jalur modalitas (untuk mengidentifikasi data sebenarnya yang akan diambil).
Jalur modalitas resource FHIR
Misalnya, jalur permintaan lengkap untuk membaca resource FHIR Patient tertentu menggunakan ID pasien mungkin terlihat seperti berikut:
RESOURCE_NAME/resources/Patient/PATIENT_ID
dengan /Patient/PATIENT_ID sebagai jalur modalitas
(terstruktur sesuai dengan standar FHIR) untuk resource Pasien yang
ID-nya ditentukan oleh PATIENT_ID.
Jalur modalitas DICOMweb
Permintaan DICOMweb untuk mengambil semua studi untuk pasien tertentu akan terlihat seperti ini:
RESOURCE_NAME/dicomWeb/studies?PatientName=PATIENT_NAME
Sebagai contoh lain, permintaan untuk mengambil semua instance dalam studi dan rangkaian tertentu akan terlihat seperti ini:
RESOURCE_NAME/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances
Permintaan untuk mengambil instance akan terlihat seperti ini:
RESOURCE_NAME/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances/INSTANCE_UID
Dalam semua contoh ini, spesifikasi jalur modalitas konsisten dengan struktur jalur standar DICOMweb.