googleapis.com – healthcare
Manage, store, and access healthcare data in Google Cloud Platform.
- Homepage
- https://api.apis.guru/v2/specs/googleapis.com:healthcare/v1.json
- Provider
- googleapis.com:healthcare / healthcare
- OpenAPI version
- 3.0.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/googleapis.com/healthcare/v1/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/googleapis.com/healthcare/v1/openapi.yaml
Tools (60)
Extracted live via the executor SDK.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresAttributeDefinitionsCreateCreates a new Attribute definition in the parent consent store.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresAttributeDefinitionsListLists the Attribute definitions in the specified consent store.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresCheckDataAccessChecks if a particular data_id of a User data mapping in the specified consent store is consented for the specified use.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresConsentArtifactsCreateCreates a new Consent artifact in the parent consent store.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresConsentArtifactsListLists the Consent artifacts in the specified consent store.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresConsentsActivateActivates the latest revision of the specified Consent by committing a new revision with
stateupdated toACTIVE. If the latest revision of the specified Consent is in theACTIVEstate, no new revision is committed. A FAILED_PRECONDITION error occurs if the latest revision of the specified Consent is in theREJECTEDorREVOKEDstate. -
projects.healthcareProjectsLocationsDatasetsConsentStoresConsentsCreateCreates a new Consent in the parent consent store.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresConsentsDeleteRevisionDeletes the specified revision of a Consent. An INVALID_ARGUMENT error occurs if the specified revision is the latest revision.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresConsentsListLists the Consent in the given consent store, returning each Consent's latest revision.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresConsentsListRevisionsLists the revisions of the specified Consent in reverse chronological order.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresConsentsRejectRejects the latest revision of the specified Consent by committing a new revision with
stateupdated toREJECTED. If the latest revision of the specified Consent is in theREJECTEDstate, no new revision is committed. A FAILED_PRECONDITION error occurs if the latest revision of the specified Consent is in theACTIVEorREVOKEDstate. -
projects.healthcareProjectsLocationsDatasetsConsentStoresConsentsRevokeRevokes the latest revision of the specified Consent by committing a new revision with
stateupdated toREVOKED. If the latest revision of the specified Consent is in theREVOKEDstate, no new revision is committed. A FAILED_PRECONDITION error occurs if the latest revision of the given consent is inDRAFTorREJECTEDstate. -
projects.healthcareProjectsLocationsDatasetsConsentStoresCreateCreates a new consent store in the parent dataset. Attempting to create a consent store with the same ID as an existing store fails with an ALREADY_EXISTS error.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresEvaluateUserConsentsEvaluates the user's Consents for all matching User data mappings. Note: User data mappings are indexed asynchronously, which can cause a slight delay between the time mappings are created or updated and when they are included in EvaluateUserConsents results.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresListLists the consent stores in the specified dataset.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresQueryAccessibleDataQueries all data_ids that are consented for a specified use in the given consent store and writes them to a specified destination. The returned Operation includes a progress counter for the number of User data mappings processed. If the request is successful, a detailed response is returned of type QueryAccessibleDataResponse, contained in the response field when the operation finishes. The metadata field type is OperationMetadata. Errors are logged to Cloud Logging (see ). For example, the following sample log entry shows a
failed to evaluate consent policyerror that occurred during a QueryAccessibleData call to consent storeprojects/{project_id}/locations/{location_id}/datasets/{dataset_id}/consentStores/{consent_store_id}.json jsonPayload: { @type: "type.googleapis.com/google.cloud.healthcare.logging.QueryAccessibleDataLogEntry" error: { code: 9 message: "failed to evaluate consent policy" } resourceName: "projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/consentStores/{consent_store_id}/consents/{consent_id}" } logName: "projects/{project_id}/logs/healthcare.googleapis.com%2Fquery_accessible_data" operation: { id: "projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/operations/{operation_id}" producer: "healthcare.googleapis.com/QueryAccessibleData" } receiveTimestamp: "TIMESTAMP" resource: { labels: { consent_store_id: "{consent_store_id}" dataset_id: "{dataset_id}" location: "{location_id}" project_id: "{project_id}" } type: "healthcare_consent_store" } severity: "ERROR" timestamp: "TIMESTAMP" -
projects.healthcareProjectsLocationsDatasetsConsentStoresUserDataMappingsArchiveArchives the specified User data mapping.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresUserDataMappingsCreateCreates a new User data mapping in the parent consent store.
-
projects.healthcareProjectsLocationsDatasetsConsentStoresUserDataMappingsListLists the User data mappings in the specified consent store.
-
projects.healthcareProjectsLocationsDatasetsCreateCreates a new health dataset. Results are returned through the Operation interface which returns either an
Operation.responsewhich contains a Dataset orOperation.error. The metadata field type is OperationMetadata. -
projects.healthcareProjectsLocationsDatasetsDeidentifyCreates a new dataset containing de-identified data from the source dataset. The metadata field type is OperationMetadata. If the request is successful, the response field type is DeidentifySummary. If errors occur, error is set. The LRO result may still be successful if de-identification fails for some DICOM instances. The new de-identified dataset will not contain these failed resources. Failed resource totals are tracked in Operation.metadata. Error details are also logged to Cloud Logging. For more information, see .
-
projects.healthcareProjectsLocationsDatasetsDicomStoresCreateCreates a new DICOM store within the parent dataset.
-
projects.healthcareProjectsLocationsDatasetsDicomStoresListLists the DICOM stores in the given dataset.
-
projects.healthcareProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteDeleteInstance deletes an instance associated with the given study, series, and SOP Instance UID. Delete requests are equivalent to the GET requests specified in the Retrieve transaction. Study and series search results can take a few seconds to be updated after an instance is deleted using DeleteInstance. For samples that show how to call DeleteInstance, see .
-
projects.healthcareProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedRetrieveRenderedFrames returns instances associated with the given study, series, SOP Instance UID and frame numbers in an acceptable Rendered Media Type. See [RetrieveTransaction] (). For details on the implementation of RetrieveRenderedFrames, see in the Cloud Healthcare API conformance statement. For samples that show how to call RetrieveRenderedFrames, see .
-
projects.healthcareProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesStoreInstances stores DICOM instances associated with study instance unique identifiers (SUID). See [Store Transaction] (). For details on the implementation of StoreInstances, see in the Cloud Healthcare API conformance statement. For samples that show how to call StoreInstances, see .
-
projects.healthcareProjectsLocationsDatasetsFhirStoresCreateCreates a new FHIR store within the parent dataset.
-
projects.healthcareProjectsLocationsDatasetsFhirStoresDeidentifyDe-identifies data from the source store and writes it to the destination store. The metadata field type is OperationMetadata. If the request is successful, the response field type is DeidentifyFhirStoreSummary. If errors occur, error is set. Error details are also logged to Cloud Logging (see ).
-
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirCapabilitiesGets the FHIR capability statement (, ), or the in the DSTU2 case for the store, which contains a description of functionality supported by the server. Implements the FHIR standard capabilities interaction (, ), or the in the DSTU2 case. On success, the response body contains a JSON-encoded representation of a
CapabilityStatementresource. -
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirCreateCreates a FHIR resource. Implements the FHIR standard create interaction (, , ), which creates a new resource with a server-assigned resource ID. The request body must contain a JSON-encoded FHIR resource, and the request headers must contain
Content-Type: application/fhir+json. On success, the response body contains a JSON-encoded representation of the resource as it was created on the server, including the server-assigned resource ID and version ID. Errors generated by the FHIR store contain a JSON-encodedOperationOutcomeresource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead. For samples that show how to callcreate, see . -
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirExecuteBundleExecutes all the requests in the given Bundle. Implements the FHIR standard batch/transaction interaction (, , ). Supports all interactions within a bundle, except search. This method accepts Bundles of type
batchandtransaction, processing them according to the batch processing rules (, , ) and transaction processing rules (, , ). The request body must contain a JSON-encoded FHIRBundleresource, and the request headers must containContent-Type: application/fhir+json. For a batch bundle or a successful transaction, the response body contains a JSON-encoded representation of aBundleresource of typebatch-responseortransaction-responsecontaining one entry for each entry in the request, with the outcome of processing the entry. In the case of an error for a transaction bundle, the response body contains a JSON-encodedOperationOutcomeresource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead. This method checks permissions for each request in the bundle. TheexecuteBundlepermission is required to call this method, but you must also grant sufficient permissions to execute the individual requests in the bundle. For example, if the bundle contains a request to create a FHIR resource, the caller must also have been granted thehealthcare.fhirResources.createpermission. You can use audit logs to view the permissions forexecuteBundleand each request in the bundle. For more information, see . For samples that show how to callexecuteBundle, see . -
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirHistoryLists all the versions of a resource (including the current version and deleted versions) from the FHIR store. Implements the per-resource form of the FHIR standard history interaction (, , ). On success, the response body contains a JSON-encoded representation of a
Bundleresource of typehistory, containing the version history sorted from most recent to oldest versions. Errors generated by the FHIR store contain a JSON-encodedOperationOutcomeresource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead. For samples that show how to callhistory, see . -
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirPatientEverythingRetrieves a Patient resource and resources related to that patient. Implements the FHIR extended operation Patient-everything (, , ). On success, the response body contains a JSON-encoded representation of a
Bundleresource of typesearchset, containing the results of the operation. Errors generated by the FHIR store contain a JSON-encodedOperationOutcomeresource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead. The resources in scope for the response are: * The patient resource itself. * All the resources directly referenced by the patient resource. * Resources directly referencing the patient resource that meet the inclusion criteria. The inclusion criteria are based on the membership rules in the patient compartment definition (, , ), which details the eligible resource types and referencing search parameters. For samples that show how to callPatient-everything, see . -
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirResourcePurgeDeletes all the historical versions of a resource (excluding the current version) from the FHIR store. To remove all versions of a resource, first delete the current version and then call this method. This is not a FHIR standard operation. For samples that show how to call
Resource-purge, see . -
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirResourceValidateValidates an input FHIR resource's conformance to its profiles and the profiles configured on the FHIR store. Implements the FHIR extended operation $validate (, , or ). The request body must contain a JSON-encoded FHIR resource, and the request headers must contain
Content-Type: application/fhir+json. TheParametersinput syntax is not supported. Theprofilequery parameter can be used to request that the resource only be validated against a specific profile. If a profile with the given URL cannot be found in the FHIR store then an error is returned. Errors generated by validation contain a JSON-encodedOperationOutcomeresource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead. -
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirSearchSearches for resources in the given FHIR store according to criteria specified as query parameters. Implements the FHIR standard search interaction (, , ) using the search semantics described in the FHIR Search specification (, , ). Supports four methods of search defined by the specification: *
GET [base]?[parameters]to search across all resources. *GET [base]/[type]?[parameters]to search resources of a specified type. *POST [base]/_search?[parameters]as an alternate form having the same semantics as theGETmethod across all resources. *POST [base]/[type]/_search?[parameters]as an alternate form having the same semantics as theGETmethod for the specified type. TheGETandPOSTmethods do not support compartment searches. ThePOSTmethod does not supportapplication/x-www-form-urlencodedsearch parameters. On success, the response body contains a JSON-encoded representation of aBundleresource of typesearchset, containing the results of the search. Errors generated by the FHIR store contain a JSON-encodedOperationOutcomeresource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead. The server's capability statement, retrieved through capabilities, indicates what search parameters are supported on each FHIR resource. A list of all search parameters defined by the specification can be found in the FHIR Search Parameter Registry (, ). FHIR search parameters for DSTU2 can be found on each resource's definition page. Supported search modifiers::missing,:exact,:contains,:text,:in,:not-in,:above,:below,:[type],:not, andrecurse(DSTU2 and STU3) or:iterate(R4). Supported search result parameters:_sort,_count,_include,_revinclude,_summary=text,_summary=data, and_elements. The maximum number of search results returned defaults to 100, which can be overridden by the_countparameter up to a maximum limit of 1000. The server might return fewer resources than requested to prevent excessively large responses. If there are additional results, the returnedBundlecontains a link ofrelation"next", which has a_page_tokenparameter for an opaque pagination token that can be used to retrieve the next page. Resources with a total size larger than 5MB or a field count larger than 50,000 might not be fully searchable as the server might trim its generated search index in those cases. Note: FHIR resources are indexed asynchronously, so there might be a slight delay between the time a resource is created or changes and when the change is reflected in search results. For samples and detailed information, see and . -
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirSearchTypeSearches for resources in the given FHIR store according to criteria specified as query parameters. Implements the FHIR standard search interaction (, , ) using the search semantics described in the FHIR Search specification (, , ). Supports four methods of search defined by the specification: *
GET [base]?[parameters]to search across all resources. *GET [base]/[type]?[parameters]to search resources of a specified type. *POST [base]/_search?[parameters]as an alternate form having the same semantics as theGETmethod across all resources. *POST [base]/[type]/_search?[parameters]as an alternate form having the same semantics as theGETmethod for the specified type. TheGETandPOSTmethods do not support compartment searches. ThePOSTmethod does not supportapplication/x-www-form-urlencodedsearch parameters. On success, the response body contains a JSON-encoded representation of aBundleresource of typesearchset, containing the results of the search. Errors generated by the FHIR store contain a JSON-encodedOperationOutcomeresource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead. The server's capability statement, retrieved through capabilities, indicates what search parameters are supported on each FHIR resource. A list of all search parameters defined by the specification can be found in the FHIR Search Parameter Registry (, ). FHIR search parameters for DSTU2 can be found on each resource's definition page. Supported search modifiers::missing,:exact,:contains,:text,:in,:not-in,:above,:below,:[type],:not, andrecurse(DSTU2 and STU3) or:iterate(R4). Supported search result parameters:_sort,_count,_include,_revinclude,_summary=text,_summary=data, and_elements. The maximum number of search results returned defaults to 100, which can be overridden by the_countparameter up to a maximum limit of 1000. The server might return fewer resources than requested to prevent excessively large responses. If there are additional results, the returnedBundlecontains a link ofrelation"next", which has a_page_tokenparameter for an opaque pagination token that can be used to retrieve the next page. Resources with a total size larger than 5MB or a field count larger than 50,000 might not be fully searchable as the server might trim its generated search index in those cases. Note: FHIR resources are indexed asynchronously, so there might be a slight delay between the time a resource is created or changes and when the change is reflected in search results. For samples and detailed information, see and . -
projects.healthcareProjectsLocationsDatasetsFhirStoresFhirUpdateUpdates the entire contents of a resource. Implements the FHIR standard update interaction (, , ). If the specified resource does not exist and the FHIR store has enable_update_create set, creates the resource with the client-specified ID. It is strongly advised not to include or encode any sensitive data such as patient identifiers in client-specified resource IDs. Those IDs are part of the FHIR resource path recorded in Cloud Audit Logs and Pub/Sub notifications. Those IDs can also be contained in reference fields within other resources. The request body must contain a JSON-encoded FHIR resource, and the request headers must contain
Content-Type: application/fhir+json. The resource must contain anidelement having an identical value to the ID in the REST path of the request. On success, the response body contains a JSON-encoded representation of the updated resource, including the server-assigned version ID. Errors generated by the FHIR store contain a JSON-encodedOperationOutcomeresource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead. For samples that show how to callupdate, see . -
projects.healthcareProjectsLocationsDatasetsFhirStoresGetFhirStoreMetricsGets metrics associated with the FHIR store.
-
projects.healthcareProjectsLocationsDatasetsFhirStoresListLists the FHIR stores in the given dataset.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresCreateCreates a new HL7v2 store within the parent dataset.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresExportExports the messages to a destination. To filter messages to be exported, define a filter using the start and end time, relative to the message generation time (MSH.7). This API returns an Operation that can be used to track the status of the job by calling GetOperation. Immediate fatal errors appear in the error field. Otherwise, when the operation finishes, a detailed response of type ExportMessagesResponse is returned in the response field. The metadata field type for this operation is OperationMetadata.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresGetIamPolicyGets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresImportImport messages to the HL7v2 store by loading data from the specified sources. This method is optimized to load large quantities of data using import semantics that ignore some HL7v2 store configuration options and are not suitable for all use cases. It is primarily intended to load data into an empty HL7v2 store that is not being used by other clients. An existing message will be overwritten if a duplicate message is imported. A duplicate message is a message with the same raw bytes as a message that already exists in this HL7v2 store. When a message is overwritten, its labels will also be overwritten. The import operation is idempotent unless the input data contains multiple valid messages with the same raw bytes but different labels. In that case, after the import completes, the store contains exactly one message with those raw bytes but there is no ordering guarantee on which version of the labels it has. The operation result counters do not count duplicated raw bytes as an error and count one success for each message in the input, which might result in a success count larger than the number of messages in the HL7v2 store. If some messages fail to import, for example due to parsing errors, successfully imported messages are not rolled back. This method returns an Operation that can be used to track the status of the import by calling GetOperation. Immediate fatal errors appear in the error field, errors are also logged to Cloud Logging (see ). Otherwise, when the operation finishes, a response of type ImportMessagesResponse is returned in the response field. The metadata field type for this operation is OperationMetadata.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresListLists the HL7v2 stores in the given dataset.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresMessagesCreateParses and stores an HL7v2 message. This method triggers an asynchronous notification to any Pub/Sub topic configured in Hl7V2Store.Hl7V2NotificationConfig, if the filtering matches the message. If an MLLP adapter is configured to listen to a Pub/Sub topic, the adapter transmits the message when a notification is received.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresMessagesDeleteDeletes an HL7v2 message.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresMessagesIngestParses and stores an HL7v2 message. This method triggers an asynchronous notification to any Pub/Sub topic configured in Hl7V2Store.Hl7V2NotificationConfig, if the filtering matches the message. If an MLLP adapter is configured to listen to a Pub/Sub topic, the adapter transmits the message when a notification is received. If the method is successful, it generates a response containing an HL7v2 acknowledgment (
ACK) message. If the method encounters an error, it returns a negative acknowledgment (NACK) message. This behavior is suitable for replying to HL7v2 interface systems that expect these acknowledgments. -
projects.healthcareProjectsLocationsDatasetsHl7V2StoresMessagesListLists all the messages in the given HL7v2 store with support for filtering. Note: HL7v2 messages are indexed asynchronously, so there might be a slight delay between the time a message is created and when it can be found through a filter.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresMessagesPatchUpdate the message. The contents of the message in Message.data and data extracted from the contents such as Message.create_time cannot be altered. Only the Message.labels field is allowed to be updated. The labels in the request are merged with the existing set of labels. Existing labels with the same keys are updated.
-
projects.healthcareProjectsLocationsDatasetsHl7V2StoresSetIamPolicySets the access control policy on the specified resource. Replaces any existing policy. Can return
NOT_FOUND,INVALID_ARGUMENT, andPERMISSION_DENIEDerrors. -
projects.healthcareProjectsLocationsDatasetsHl7V2StoresTestIamPermissionsReturns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a
NOT_FOUNDerror. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning. -
projects.healthcareProjectsLocationsDatasetsListLists the health datasets in the current project.
-
projects.healthcareProjectsLocationsDatasetsOperationsCancelStarts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns
google.rpc.Code.UNIMPLEMENTED. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding toCode.CANCELLED. -
projects.healthcareProjectsLocationsDatasetsOperationsGetGets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
-
projects.healthcareProjectsLocationsDatasetsOperationsListLists operations that match the specified filter in the request. If the server doesn't support this method, it returns
UNIMPLEMENTED. -
projects.healthcareProjectsLocationsListLists information about the supported locations for this service.
-
projects.healthcareProjectsLocationsServicesNlpAnalyzeEntitiesAnalyze heathcare entity in a document. Its response includes the recognized entity mentions and the relationships between them. AnalyzeEntities uses context aware models to detect entities.
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools