En esta página, se describe la estructura de las rutas y las operaciones de la API de Cloud Healthcare y cómo se pueden usar para acceder a los datos y administrarlos.
Descripción general
Se puede acceder a datos de salud en conjuntos de datos y almacenes de datos mediante una API de REST que identifique cada almacén de datos mediante lo siguiente:
- Un proyecto de Google Cloud
- Una ubicación de Google Cloud
- El ID del conjunto de datos
- El tipo de almacén de datos
- El ID del almacén de datos
La API también implementa estándares específicos de modalidad para el acceso que son coherentes con los estándares de la industria para esa modalidad.
Operaciones administrativas
Las operaciones administrativas están disponibles para los conjuntos de datos y todos los almacenes de datos. En esencia, consisten en crear, leer, actualizar y borrar (CRUD) conjuntos de datos y almacenes de datos. Las operaciones administrativas son coherentes con la mayoría de las API de Google Cloud (Google Cloud) y no requieren ningún cumplimiento de estándares de modalidad específica.
Estos son algunos ejemplos de operaciones administrativas:
- Crear, borrar, obtener, enumerar y aplicar parches a los conjuntos de datos y almacenes de datos
- Configurar, obtener y probar permisos de IAM
Nombres de recursos
Un nombre de recurso consiste, como mínimo, en un ID del proyecto y una ubicación. Se puede extender para incluir un conjunto de datos, un almacén de datos y cualquiera de los recursos secundarios de un almacén de datos.
El formato de un nombre de recurso para un almacén de datos que reside dentro de un conjunto de datos de la API de Cloud Healthcare se ve así:
/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/DATA_STORE_TYPE/DATA_STORE_ID
Por ejemplo, el nombre del recurso para un almacén de HL7v2 llamado clinical-store1
se ve así:
/projects/my-project/locations/us-central1/datasets/my-dataset/hl7V2Stores/clinical-store1
Este nombre de recurso muestra un proyecto llamado my-project
en la región us-central1
. El proyecto contiene un conjunto de datos llamado my-dataset
y el conjunto de datos contiene un almacén de HL7v2 llamado clinical-store1
.
Las operaciones en una ubicación, conjunto de datos, almacén de datos o cualquiera de los recursos secundarios del almacén de datos requieren que se proporcione un nombre de recurso en la ruta de REST o en la solicitud de gRPC.
Rutas de acceso de modalidad para operaciones específicas de la modalidad
Las operaciones que acceden a los datos en un almacén de datos específicos de la modalidad usan una ruta de solicitud que consta de dos partes: el nombre del recurso (para identificar el almacén de datos al que se accede) y una ruta de la modalidad (para identificar los datos reales que se recuperarán).
Rutas de acceso de la modalidad de FHIR
Por ejemplo, la ruta de acceso de solicitud completa para leer un recurso específico del paciente de FHIR mediante el ID del paciente podría verse de la siguiente manera:
RESOURCE_NAME/resources/Patient/PATIENT_ID
con /Patient/PATIENT_ID
como la ruta de la modalidad (estructurada según el estándar de FHIR) para el recurso Paciente cuyo identificador especifica PATIENT_ID
.
Rutas de acceso de modalidad DICOMweb
Las solicitudes de DICOMweb para recuperar todos los estudios de un paciente determinado se verían de la siguiente manera:
RESOURCE_NAME/dicomWeb/studies?PatientName=PATIENT_NAME
Otro ejemplo es una solicitud para recuperar todas las instancias de un estudio y una serie determinados que se vería de la siguiente manera:
RESOURCE_NAME/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances
Una solicitud para recuperar una instancia se vería de la siguiente manera:
RESOURCE_NAME/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances/INSTANCE_UID
En todos estos ejemplos, la especificación de la ruta de la modalidad es coherente con la estructura de la ruta de acceso estándar de DICOMweb.