lib/google/apis/healthcare_v1/service.rb in google-apis-healthcare_v1-0.47.0 vs lib/google/apis/healthcare_v1/service.rb in google-apis-healthcare_v1-0.48.0
- old
+ new
@@ -3951,19 +3951,19 @@
end
# Deletes a FHIR resource that match an identifier search query. Implements the
# FHIR standard conditional delete interaction, limited to searching by resource
# identifier. If multiple resources match, 412 Precondition Failed error will be
- # returned. Search term for identifier should be in the pattern identifier=
- # system|value or identifier=value - similar to the search method on resources
- # with a specific identifier. Note: Unless resource versioning is disabled by
- # setting the disable_resource_versioning flag on the FHIR store, the deleted
- # resource is moved to a history repository that can still be retrieved through
- # vread and related methods, unless they are removed by the purge method. For
- # samples that show how to call `conditionalDelete`, see [Conditionally deleting
- # a FHIR resource](https://cloud.google.com/healthcare/docs/how-tos/fhir-
- # resources#conditionally_deleting_a_fhir_resource).
+ # returned. Search term for identifier should be in the pattern `identifier=
+ # system|value` or `identifier=value` - similar to the `search` method on
+ # resources with a specific identifier. Note: Unless resource versioning is
+ # disabled by setting the disable_resource_versioning flag on the FHIR store,
+ # the deleted resource is moved to a history repository that can still be
+ # retrieved through vread and related methods, unless they are removed by the
+ # purge method. For samples that show how to call `conditionalDelete`, see [
+ # Conditionally deleting a FHIR resource](https://cloud.google.com/healthcare/
+ # docs/how-tos/fhir-resources#conditionally_deleting_a_fhir_resource).
# @param [String] parent
# The name of the FHIR store this resource belongs to.
# @param [String] type
# The FHIR resource type to delete, such as Patient or Observation. For a
# complete list, see the FHIR Resource Index ([DSTU2](https://hl7.org/implement/
@@ -4002,12 +4002,12 @@
# updates part of that resource by applying the operations specified in a [JSON
# Patch](http://jsonpatch.com/) document. Implements the FHIR standard
# conditional patch interaction, limited to searching by resource identifier.
# DSTU2 doesn't define a conditional patch method, but the server supports it in
# the same way it supports STU3. Search term for identifier should be in the
- # pattern identifier=system|value or identifier=value - similar to the search
- # method on resources with a specific identifier. If the search criteria
+ # pattern `identifier=system|value` or `identifier=value` - similar to the `
+ # search` method on resources with a specific identifier. If the search criteria
# identify more than one match, the request returns a `412 Precondition Failed`
# error. The request body must contain a JSON Patch document, and the request
# headers must contain `Content-Type: application/json-patch+json`. On success,
# the response body contains a JSON-encoded representation of the updated
# resource, including the server-assigned version ID. Errors generated by the
@@ -4057,21 +4057,21 @@
end
# If a resource is found with the identifier specified in the query parameters,
# updates the entire contents of that resource. Implements the FHIR standard
# conditional update interaction, limited to searching by resource identifier.
- # Search term for identifier should be in the pattern identifier=system|value or
- # identifier=value - similar to the search method on resources with a specific
- # identifier. If the search criteria identify more than one match, the request
- # returns a `412 Precondition Failed` 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. 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. If the search criteria identify zero matches, and the
+ # Search term for identifier should be in the pattern `identifier=system|value`
+ # or `identifier=value` - similar to the `search` method on resources with a
+ # specific identifier. If the search criteria identify more than one match, the
+ # request returns a `412 Precondition Failed` 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. 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. If the search criteria identify zero matches, and the
# supplied resource body does not contain an `id`, the resource is created with
# a server-assigned ID as per the create method. 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 updated resource, including the server-assigned version
@@ -4124,20 +4124,30 @@
# Creates a FHIR resource. Implements the FHIR standard create interaction ([
# DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#create), [STU3](
# http://hl7.org/implement/standards/fhir/STU3/http.html#create), [R4](http://
# hl7.org/implement/standards/fhir/R4/http.html#create)), 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-encoded `OperationOutcome` resource 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 call `create`, see [Creating a FHIR resource](https://cloud.google.com/
- # healthcare/docs/how-tos/fhir-resources#creating_a_fhir_resource).
+ # resource with a server-assigned resource ID. Also supports the FHIR standard
+ # conditional create interaction ([DSTU2](https://hl7.org/implement/standards/
+ # fhir/DSTU2/http.html#ccreate), [STU3](https://hl7.org/implement/standards/fhir/
+ # STU3/http.html#ccreate), [R4](https://hl7.org/implement/standards/fhir/R4/http.
+ # html#ccreate)), specified by supplying an `If-None-Exist` header containing a
+ # FHIR search query, limited to searching by resource identifier. If no
+ # resources match this search query, the server processes the create operation
+ # as normal. When using conditional create, the search term for identifier
+ # should be in the pattern `identifier=system|value` or `identifier=value` -
+ # similar to the `search` method on resources with a specific identifier. 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-encoded `
+ # OperationOutcome` resource 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 call `create`, see [
+ # Creating a FHIR resource](https://cloud.google.com/healthcare/docs/how-tos/
+ # fhir-resources#creating_a_fhir_resource).
# @param [String] parent
# The name of the FHIR store this resource belongs to.
# @param [String] type
# The FHIR resource type to create, such as Patient or Observation. For a
# complete list, see the FHIR Resource Index ([DSTU2](http://hl7.org/implement/
@@ -4479,28 +4489,14 @@
# parameter 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
- # changed, and the time when the change reflects in search results. The only
- # exception is resource identifier data, which is indexed synchronously as a
- # special index. As a result, searching using resource identifier is not subject
- # to indexing delay. To use the special synchronous index, the search term for
- # identifier should be in the pattern `identifier=[system]|[value]` or `
- # identifier=[value]`, and any of the following search result parameters can be
- # used: * `_count` * `_include` * `_revinclude` * `_summary` * `_elements` If
- # your query contains any other search parameters, the standard asynchronous
- # index will be used instead. Note that searching against the special index is
- # optimized for resolving a small number of matches. The search isn't optimized
- # if your identifier search criteria matches a large number (i.e. more than 2,
- # 000) of resources. For a search query that will match a large number of
- # resources, you can avoiding using the special synchronous index by including
- # an additional `_sort` parameter in your query. Use `_sort=-_lastUpdated` if
- # you want to keep the default sorting order. For samples and detailed
- # information, see [Searching for FHIR resources](https://cloud.google.com/
- # healthcare/docs/how-tos/fhir-search) and [Advanced FHIR search features](https:
- # //cloud.google.com/healthcare/docs/how-tos/fhir-advanced-search).
+ # changes and when the change is reflected in search results. For samples and
+ # detailed information, see [Searching for FHIR resources](https://cloud.google.
+ # com/healthcare/docs/how-tos/fhir-search) and [Advanced FHIR search features](
+ # https://cloud.google.com/healthcare/docs/how-tos/fhir-advanced-search).
# @param [String] parent
# Name of the FHIR store to retrieve resources from.
# @param [Google::Apis::HealthcareV1::SearchResourcesRequest] search_resources_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
@@ -4571,27 +4567,13 @@
# parameter 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
- # changed, and the time when the change reflects in search results. The only
- # exception is resource identifier data, which is indexed synchronously as a
- # special index. As a result, searching using resource identifier is not subject
- # to indexing delay. To use the special synchronous index, the search term for
- # identifier should be in the pattern `identifier=[system]|[value]` or `
- # identifier=[value]`, and any of the following search result parameters can be
- # used: * `_count` * `_include` * `_revinclude` * `_summary` * `_elements` If
- # your query contains any other search parameters, the standard asynchronous
- # index will be used instead. Note that searching against the special index is
- # optimized for resolving a small number of matches. The search isn't optimized
- # if your identifier search criteria matches a large number (i.e. more than 2,
- # 000) of resources. For a search query that will match a large number of
- # resources, you can avoiding using the special synchronous index by including
- # an additional `_sort` parameter in your query. Use `_sort=-_lastUpdated` if
- # you want to keep the default sorting order. For samples and detailed
- # information, see [Searching for FHIR resources](https://cloud.google.com/
- # healthcare/docs/how-tos/fhir-search) and [Advanced FHIR search features](https:
- # //cloud.google.com/healthcare/docs/how-tos/fhir-advanced-search).
+ # changes and when the change is reflected in search results. For samples and
+ # detailed information, see [Searching for FHIR resources](https://cloud.google.
+ # com/healthcare/docs/how-tos/fhir-search) and [Advanced FHIR search features](
+ # https://cloud.google.com/healthcare/docs/how-tos/fhir-advanced-search).
# @param [String] parent
# Name of the FHIR store to retrieve resources from.
# @param [String] resource_type
# The FHIR resource type to search, such as Patient or Observation. For a
# complete list, see the FHIR Resource Index ([DSTU2](http://hl7.org/implement/