Package google.cloud.healthcare.v1alpha2.fhir.stu3.grpc

Index

FhirService

gRPC service for handling FHIR resources in a FHIR store inside a healthcare dataset.

This service supports FHIR STU3 resources in the protocol buffer format as shown in https://github.com/google/fhir.

The API methods in this service are a gRPC adaptation of the FHIR REST API, and are not part of the FHIR specification. Not all of the methods in the REST API have been implemented. All gRPC and REST methods may be used interchangeably on the same FHIR store.

ConditionalDeleteResource

rpc ConditionalDeleteResource(ConditionalDeleteResourceRequest) returns (Empty)

Deletes FHIR resources that match a search query.

Implements a gRPC adaptation of the FHIR standard conditional delete interaction. If multiple resources match, all of them will be deleted.

Search terms are provided in the request following the same pattern as the SearchResources method.

Note: Unless resource versioning is disabled by setting the disable_resource_versioning flag on the FHIR store, the deleted resources will be moved to a history repository that can still be retrieved through GetResourceVersion and related methods, unless they are removed by the DeleteResourceVersions method.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

ConditionalUpdateResource

rpc ConditionalUpdateResource(ConditionalUpdateResourceRequest) returns (ContainedResource)

If a resource is found based on the search criteria specified in the request, updates the entire contents of that resource.

Implements a gRPC adaptation of the FHIR standard conditional update interaction.

Search terms are provided in the request following the same pattern as the SearchResources method.

If the search criteria identify more than one match, the request will return a FailedPrecondition error. If the search criteria identify zero matches, and the supplied resource body contains an id, and the FHIR store has enable_update_create set, creates the resource with the client-specified ID. If the search criteria identify zero matches, and the supplied resource body does not contain an id, the resource will be created with a server-assigned ID as per the CreateResource method.

On success, the response will be a ContainedResource representation of the updated resource, including the server-assigned version ID. Errors generated by the FHIR store will contain an OperationOutcome resource as an error detail describing the reason for the error.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

CreateResource

rpc CreateResource(CreateResourceRequest) returns (ContainedResource)

Creates a FHIR resource.

Implements a gRPC adaptation of the FHIR standard create interaction, which creates a new resource with a server-assigned resource ID.

Also supports the FHIR standard conditional create interaction, specified by supplying an If-None-Exist key with a value containing a FHIR search query in the gRPC metadata. If no resources match this search query, the server processes the create operation as normal.

On success, the response will be a ContainedResource 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 will contain an OperationOutcome resource as an error detail describing the reason for the error.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

DeleteResource

rpc DeleteResource(DeleteResourceRequest) returns (Empty)

Deletes a FHIR resource.

Implements a gRPC adaptation of the FHIR standard delete interaction.

Note: Unless resource versioning is disabled by setting the disable_resource_versioning flag on the FHIR store, the deleted resources will be moved to a history repository that can still be retrieved through GetResourceVersion and related methods, unless they are removed by the DeleteResourceVersions method.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

ExecuteBundle

rpc ExecuteBundle(ExecuteBundleRequest) returns (ContainedResource)

Executes all the requests in the given Bundle.

Implements a gRPC adaptation of the FHIR standard batch/transaction interaction.

Supports all interactions within a bundle, except search. This method accepts Bundles of type batch and transaction, processing them according to the batch processing rules and transaction processing rules.

For a batch bundle or a successful transaction the response will be a ContainedResource representation of a Bundle resource of type batch-response or transaction-response containing one entry for each entry in the request, with the outcome of processing the entry. Errors for a transaction bundle will contain an OperationOutcome resource as an error detail describing the reason for the error.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

GetLastNObservations

rpc GetLastNObservations(GetLastNObservationsRequest) returns (ContainedResource)

Retrieves the N most recent Observation resources for a subject matching search criteria specified in the request, grouped by Observation.code, sorted from most recent to oldest.

Implements a gRPC adaptation of the FHIR extended operation Observation-lastn.

Search terms are provided in the request following the same pattern as the SearchResources method.

On success, the response body will contain a ContainedResource representation of a Bundle resource of type searchset, containing the results of the operation. Errors generated by the FHIR store will contain an OperationOutcome resource as an error detail describing the reason for the error.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

GetPatientEverything

rpc GetPatientEverything(GetPatientEverythingRequest) returns (ContainedResource)

Retrieves all the resources in the patient compartment for a Patient resource.

Implements a gRPC adaptation of the FHIR extended operation Patient-everything.

On success, the response body will contain a ContainedResource representation of a Bundle resource of type searchset, containing the results of the operation. Errors generated by the FHIR store will contain an OperationOutcome resource as an error detail describing the reason for the error.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

GetResource

rpc GetResource(GetResourceRequest) returns (ContainedResource)

Gets the contents of a FHIR resource.

Implements a gRPC adaptation of the FHIR standard read interaction.

Also supports the FHIR standard conditional read interaction specified by supplying an If-Modified-Since key with a date/time value or an If-None-Match key with an ETag value in the gRPC metadata.

On success, the response will be a ContainedResource representation of the resource. Errors generated by the FHIR store will contain an OperationOutcome resource as an error detail describing the reason for the error.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

GetResourceVersion

rpc GetResourceVersion(GetResourceVersionRequest) returns (ContainedResource)

Gets the contents of a version (current or historical) of a FHIR resource by version ID.

Implements a gRPC adaptation of the FHIR standard vread interaction.

On success, the response will be a ContainedResource representation of the resource. Errors generated by the FHIR store will contain an OperationOutcome resource as an error detail describing the reason for the error.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

SearchResources

rpc SearchResources(SearchResourcesRequest) returns (ContainedResource)

Searches for resources in the given FHIR store according to criteria specified in the request.

Implements a gRPC adaptation of the FHIR standard search interaction using the search semantics described in the FHIR Search specification.

On success, the response body will contain a ContainedResource representation of a Bundle resource of type searchset, containing the results of the search. Errors generated by the FHIR store will contain an OperationOutcome resource as an error detail describing the reason for the error.

The server's capability statement, retrieved through GetCapabilityStatement, 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.

All search modifiers except :recurse are supported.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

UpdateResource

rpc UpdateResource(UpdateResourceRequest) returns (ContainedResource)

Updates the entire contents of a resource.

Implements a gRPC adaptation ofthe 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.

On success, the response will be a ContainedResource representation of the updated resource, including the server-assigned version ID. Errors generated by the FHIR store will contain an OperationOutcome resource as an error detail describing the reason for the error.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

ConditionalDeleteResourceRequest

Deletes a resource from the specified FHIR store that matches the conditions.

Fields
parent

string

The name of the FHIR store, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}.

Authorization requires the following Google IAM permission on the specified resource parent:

  • healthcare.fhirResources.delete

type

string

The FHIR resource type to delete, such as Patient or Observation. For a complete list, see the FHIR Resource Index.

conditions[]

SearchParameter

The search conditions identifying the resource to delete, in the form of a list of key-value pairs.

ConditionalUpdateResourceRequest

Request to update the contents of a resource found by search criteria.

Fields
parent

string

The name of the FHIR store, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}.

Authorization requires the following Google IAM permission on the specified resource parent:

  • healthcare.fhirResources.update

type

string

The FHIR resource type to update, such as Patient or Observation. For a complete list, see the FHIR Resource Index. Must match the resource type in the provided content.

resource

ContainedResource

The updated contents of the resource to store.

conditions[]

SearchParameter

The search conditions identifying the resource to update, in the form of a list of key-value pairs.

CreateResourceRequest

Request to create a resource.

Fields
parent

string

The name of the FHIR store, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}.

Authorization requires the following Google IAM permission on the specified resource parent:

  • healthcare.fhirResources.create

type

string

The FHIR resource type to create, such as Patient or Observation. For a complete list, see the FHIR Resource Index. Must match the resource type in the provided content.

resource

ContainedResource

Contents of the resource to be created.

DeleteResourceRequest

Deletes a resource from the specified FHIR store.

Fields
name

string

The name of the resource to delete, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}/fhir/{resource_type}/{resource_id}.

Authorization requires the following Google IAM permission on the specified resource name:

  • healthcare.fhirResources.delete

ExecuteBundleRequest

Request to execute all included operations in a Bundle.

Fields
parent

string

The name of the FHIR store in which this bundle will be executed, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}.

bundle

ContainedResource

The bundle to execute.

GetLastNObservationsRequest

Get N most recent observations for the subject matching the criteria, grouped by code.

Fields
parent

string

The name of the FHIR store, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}.

Authorization requires the following Google IAM permission on the specified resource parent:

  • healthcare.fhirResources.get

conditions[]

SearchParameter

The search conditions identifying the subject, in the form of a list of key-value pairs.

GetPatientEverythingRequest

Request all the information related to the patient.

Fields
name

string

The name of the patient for which the information is required, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}/fhir/Patient/{resource_id}.

start

string

The response includes records subsequent to the start date. If no start date is provided, all records prior to the end date are in scope.

end

string

The response includes records prior to the end date. If no end date is provided, all records subsequent to the start date are in scope.

GetResourceRequest

Gets a resource from the specified FHIR store.

Fields
name

string

The name of the resource to retrieve, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}/fhir/{resource_type}/{resource_id}.

Authorization requires the following Google IAM permission on the specified resource name:

  • healthcare.fhirResources.get

GetResourceVersionRequest

Gets a specific version of a resource from the specified FHIR store.

Fields
name

string

The name of the resource version to retrieve, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}/fhir/{resource_type}/{resource_id}/_history/{version_id}.

Authorization requires the following Google IAM permission on the specified resource name:

  • healthcare.fhirResources.get

SearchParameter

Fields
key

string

value[]

string

SearchResourcesRequest

Request to search the resources in the specified FHIR store.

Fields
parent

string

The name of the FHIR store, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}.

Authorization requires the following Google IAM permission on the specified resource parent:

  • healthcare.fhirResources.get

resource_type

string

The FHIR resource type to search, such as Patient or Observation. For a complete list, see the FHIR Resource Index. Can be empty, which is equivalent to issuing a REST search against the FHIR store base URL.

params[]

SearchParameter

The search parameters in the form of a list of key-value pairs.

UpdateResourceRequest

Request to update the contents of a resource.

Fields
name

string

The name of the resource to update, in the form projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}/fhir/{resource_type}/{resource_id}.

Authorization requires the following Google IAM permission on the specified resource name:

  • healthcare.fhirResources.update

resource

ContainedResource

The updated contents of the resource to store. The resource type and ID must match those provided in the name.

Var denne siden nyttig? Si fra hva du synes:

Send tilbakemelding om ...

Cloud Healthcare API