google-api-client 0.32.1 → 0.40.0

data/generated/google/apis/healthcare_v1beta1/service.rb

@@ -167,10 +167,15 @@ module Google
         # response field type is
         # DeidentifySummary.
         # If errors occur,
+        # error
         # details field type is
         # DeidentifyErrorDetails.
-        # Errors are also logged to Stackdriver Logging. For more information,
-        # see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging).
+        # 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
+        # DeidentifySummary.failure_resource_count.
+        # Error details are also logged to Cloud Logging. For more information,
+        # see [Viewing logs](/healthcare/docs/how-tos/logging).
         # @param [String] source_dataset
         #   Source dataset resource name. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id``.
@@ -281,6 +286,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -389,6 +397,7 @@ module Google
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -424,7 +433,7 @@ module Google
         
         # Returns 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_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # 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.
@@ -461,6 +470,125 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets the access control policy for a resource.
+        # Returns an empty policy if the resource exists and does not have a policy
+        # set.
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy is being requested.
+        #   See the operation documentation for the appropriate value for this field.
+        # @param [Fixnum] options_requested_policy_version
+        #   Optional. The policy format version to be returned.
+        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        #   rejected.
+        #   Requests for policies with any conditional bindings must specify version 3.
+        #   Policies without any conditional bindings may specify any valid value or
+        #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_location_dataset_annotation_store_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+resource}:getIamPolicy', options)
+          command.response_representation = Google::Apis::HealthcareV1beta1::Policy::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Sets the access control policy on the specified resource. Replaces any
+        # existing policy.
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy is being specified.
+        #   See the operation documentation for the appropriate value for this field.
+        # @param [Google::Apis::HealthcareV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def set_annotation_store_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+resource}:setIamPolicy', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::SetIamPolicyRequest::Representation
+          command.request_object = set_iam_policy_request_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Policy::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns 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_FOUND` error.
+        # 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.
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   See the operation documentation for the appropriate value for this field.
+        # @param [Google::Apis::HealthcareV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::TestIamPermissionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::TestIamPermissionsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def test_annotation_store_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+resource}:testIamPermissions', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::TestIamPermissionsRequest::Representation
+          command.request_object = test_iam_permissions_request_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::TestIamPermissionsResponse::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::TestIamPermissionsResponse
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a new DICOM store within the parent dataset.
         # @param [String] parent
         #   The name of the dataset this DICOM store belongs to.
@@ -498,6 +626,55 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # De-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
+        # DeidentifyDicomStoreSummary. If errors occur,
+        # error
+        # details field type is
+        # DeidentifyErrorDetails.
+        # The LRO result may still be successful if de-identification fails for some
+        # DICOM instances. The output DICOM store will not contain
+        # these failed resources. Failed resource totals are tracked in
+        # DeidentifySummary.failure_resource_count.
+        # Error details are also logged to Cloud Logging
+        # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
+        # @param [String] source_store
+        #   Source DICOM store resource name. For example,
+        #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   dicomStores/`dicom_store_id``.
+        # @param [Google::Apis::HealthcareV1beta1::DeidentifyDicomStoreRequest] deidentify_dicom_store_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def deidentify_dicom_store(source_store, deidentify_dicom_store_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+sourceStore}:deidentify', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::DeidentifyDicomStoreRequest::Representation
+          command.request_object = deidentify_dicom_store_request_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Operation::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Operation
+          command.params['sourceStore'] = source_store unless source_store.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Deletes the specified DICOM store and removes all images that are contained
         # within it.
         # @param [String] name
@@ -531,6 +708,8 @@ module Google
         
         # Exports data to the specified destination by copying it from the DICOM
         # store.
+        # Errors are also logged to Cloud Logging. For more information,
+        # see [Viewing logs](/healthcare/docs/how-tos/logging).
         # The metadata field type is
         # OperationMetadata.
         # @param [String] name
@@ -611,6 +790,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -642,9 +824,8 @@ module Google
         # Imports data into the DICOM store by copying it from the specified source.
         # For errors, the Operation is populated with error details (in the form
         # of ImportDicomDataErrorDetails in error.details), which hold
-        # finer-grained error information. Errors are also logged to Stackdriver
-        # Logging. For more information,
-        # see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging).
+        # finer-grained error information. Errors are also logged to Cloud Logging.
+        # For more information, see [Viewing logs](/healthcare/docs/how-tos/logging).
         # The metadata field type is
         # OperationMetadata.
         # @param [String] name
@@ -766,15 +947,16 @@ module Google
         end
         
         # SearchForInstances returns a list of matching instances. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the SearchForInstancesRequest DICOMweb request (for example,
-        #   `instances` or `series/`series_uid`/instances` or
-        #   `studies/`study_uid`/instances`).
+        #   The path of the SearchForInstancesRequest DICOMweb request. For example,
+        #   `instances`, `series/`series_uid`/instances`, or
+        #   `studies/`study_uid`/instances`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -804,14 +986,15 @@ module Google
         end
         
         # SearchForSeries returns a list of matching series. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the SearchForSeries DICOMweb request(for example, `series` or
-        #   `studies/`study_uid`/series`).
+        #   The path of the SearchForSeries DICOMweb request. For example, `series` or
+        #   `studies/`study_uid`/series`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -841,13 +1024,14 @@ module Google
         end
         
         # SearchForStudies returns a list of matching studies. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the SearchForStudies DICOMweb request (for example, `studies`).
+        #   The path of the SearchForStudies DICOMweb request. For example, `studies`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -878,6 +1062,7 @@ module Google
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -913,14 +1098,16 @@ module Google
         
         # StoreInstances stores DICOM instances associated with study instance unique
         # identifiers (SUID). See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5.
+        # [Store
+        # Transaction](http://dicom.nema.org/medical/dicom/current/output/html/part18.
+        # html#sect_10.5).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the StoreInstances DICOMweb request (for example,
-        #   `studies/[`study_uid`]`). Note that the `study_uid` is optional.
+        #   The path of the StoreInstances DICOMweb request. For example,
+        #   `studies/[`study_uid`]`. Note that the `study_uid` is optional.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -954,7 +1141,7 @@ module Google
         
         # Returns 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_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # 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.
@@ -992,13 +1179,10 @@ module Google
         end
         
         # DeleteStudy deletes all instances within the given study. Delete requests
-        # are equivalent to the GET requests specified in the WADO-RS standard.
+        # are equivalent to the GET requests specified in the Retrieve transaction.
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
-        #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
         # @param [String] dicom_web_path
-        #   The path of the DeleteStudy request (for example, `studies/`study_uid``).
+        #   The path of the DeleteStudy request. For example, `studies/`study_uid``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1029,14 +1213,15 @@ module Google
         
         # RetrieveStudyMetadata returns instance associated with the given study
         # presented as metadata with the bulk data removed. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the RetrieveStudyMetadata DICOMweb request (for example,
-        #   `studies/`study_uid`/metadata`).
+        #   The path of the RetrieveStudyMetadata DICOMweb request. For example,
+        #   `studies/`study_uid`/metadata`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1066,14 +1251,15 @@ module Google
         end
         
         # RetrieveStudy returns all instances within the given study. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the RetrieveStudy DICOMweb request (for example,
-        #   `studies/`study_uid``).
+        #   The path of the RetrieveStudy DICOMweb request. For example,
+        #   `studies/`study_uid``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1103,15 +1289,16 @@ module Google
         end
         
         # SearchForInstances returns a list of matching instances. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the SearchForInstancesRequest DICOMweb request (for example,
-        #   `instances` or `series/`series_uid`/instances` or
-        #   `studies/`study_uid`/instances`).
+        #   The path of the SearchForInstancesRequest DICOMweb request. For example,
+        #   `instances`, `series/`series_uid`/instances`, or
+        #   `studies/`study_uid`/instances`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1141,14 +1328,15 @@ module Google
         end
         
         # SearchForSeries returns a list of matching series. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the SearchForSeries DICOMweb request(for example, `series` or
-        #   `studies/`study_uid`/series`).
+        #   The path of the SearchForSeries DICOMweb request. For example, `series` or
+        #   `studies/`study_uid`/series`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1179,14 +1367,16 @@ module Google
         
         # StoreInstances stores DICOM instances associated with study instance unique
         # identifiers (SUID). See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5.
+        # [Store
+        # Transaction](http://dicom.nema.org/medical/dicom/current/output/html/part18.
+        # html#sect_10.5).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the StoreInstances DICOMweb request (for example,
-        #   `studies/[`study_uid`]`). Note that the `study_uid` is optional.
+        #   The path of the StoreInstances DICOMweb request. For example,
+        #   `studies/[`study_uid`]`. Note that the `study_uid` is optional.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1219,15 +1409,15 @@ module Google
         end
         
         # DeleteSeries deletes all instances within the given study and series.
-        # Delete requests are equivalent to the GET requests specified in the WADO-RS
-        # standard.
+        # Delete requests are equivalent to the GET requests specified in the
+        # Retrieve transaction.
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the DeleteSeries request (for example,
-        #   `studies/`study_uid`/series/`series_uid``).
+        #   The path of the DeleteSeries request. For example,
+        #   `studies/`study_uid`/series/`series_uid``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1258,14 +1448,15 @@ module Google
         
         # RetrieveSeriesMetadata returns instance associated with the given study and
         # series, presented as metadata with the bulk data removed. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the RetrieveSeriesMetadata DICOMweb request (for example,
-        #   `studies/`study_uid`/series/`series_uid`/metadata`).
+        #   The path of the RetrieveSeriesMetadata DICOMweb request. For example,
+        #   `studies/`study_uid`/series/`series_uid`/metadata`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1295,14 +1486,15 @@ module Google
         end
         
         # RetrieveSeries returns all instances within the given study and series. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the RetrieveSeries DICOMweb request (for example,
-        #   `studies/`study_uid`/series/`series_uid``).
+        #   The path of the RetrieveSeries DICOMweb request. For example,
+        #   `studies/`study_uid`/series/`series_uid``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1332,15 +1524,16 @@ module Google
         end
         
         # SearchForInstances returns a list of matching instances. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the SearchForInstancesRequest DICOMweb request (for example,
-        #   `instances` or `series/`series_uid`/instances` or
-        #   `studies/`study_uid`/instances`).
+        #   The path of the SearchForInstancesRequest DICOMweb request. For example,
+        #   `instances`, `series/`series_uid`/instances`, or
+        #   `studies/`study_uid`/instances`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1371,14 +1564,14 @@ module Google
         
         # DeleteInstance deletes an instance associated with the given study, series,
         # and SOP Instance UID. Delete requests are equivalent to the GET requests
-        # specified in the WADO-RS standard.
+        # specified in the Retrieve transaction.
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the DeleteInstance request (for example,
-        #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid``).
+        #   The path of the DeleteInstance request. For example,
+        #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1409,14 +1602,15 @@ module Google
         
         # RetrieveInstance returns instance associated with the given study, series,
         # and SOP Instance UID. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the RetrieveInstance DICOMweb request (for example,
-        #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid``).
+        #   The path of the RetrieveInstance DICOMweb request. For example,
+        #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1448,14 +1642,15 @@ module Google
         # RetrieveInstanceMetadata returns instance associated with the given study,
         # series, and SOP Instance UID presented as metadata with the bulk data
         # removed. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the RetrieveInstanceMetadata DICOMweb request (for example,
-        #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid`/metadata`).
+        #   The path of the RetrieveInstanceMetadata DICOMweb request. For example,
+        #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid`/metadata`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1486,14 +1681,15 @@ module Google
         
         # RetrieveRenderedInstance returns instance associated with the given study,
         # series, and SOP Instance UID in an acceptable Rendered Media Type. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the RetrieveRenderedInstance DICOMweb request (for example,
-        #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid`/rendered`).
+        #   The path of the RetrieveRenderedInstance DICOMweb request. For example,
+        #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid`/rendered`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1524,15 +1720,16 @@ module Google
         
         # RetrieveFrames returns instances associated with the given study, series,
         # SOP Instance UID and frame numbers. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the RetrieveFrames DICOMweb request (for example,
+        #   The path of the RetrieveFrames DICOMweb request. For example,
         #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid`/frames/`
-        #   frame_list``).
+        #   frame_list``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1564,15 +1761,16 @@ module Google
         # RetrieveRenderedFrames returns instances associated with the given study,
         # series, SOP Instance UID and frame numbers in an acceptable Rendered Media
         # Type. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/
+        # part18.html#sect_10.4).
         # @param [String] parent
-        #   The name of the DICOM store that is being accessed (for example,
+        #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
-        #   dicomStores/`dicom_store_id``).
+        #   dicomStores/`dicom_store_id``.
         # @param [String] dicom_web_path
-        #   The path of the RetrieveRenderedFrames DICOMweb request (for example,
+        #   The path of the RetrieveRenderedFrames DICOMweb request. For example,
         #   `studies/`study_uid`/series/`series_uid`/instances/`instance_uid`/frames/`
-        #   frame_list`/rendered`).
+        #   frame_list`/rendered`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1638,6 +1836,51 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # De-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
+        # details field type is
+        # DeidentifyErrorDetails.
+        # Errors are also logged to Cloud Logging
+        # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
+        # @param [String] source_store
+        #   Source FHIR store resource name. For example,
+        #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   fhirStores/`fhir_store_id``.
+        # @param [Google::Apis::HealthcareV1beta1::DeidentifyFhirStoreRequest] deidentify_fhir_store_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def deidentify_fhir_store(source_store, deidentify_fhir_store_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+sourceStore}:deidentify', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::DeidentifyFhirStoreRequest::Representation
+          command.request_object = deidentify_fhir_store_request_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Operation::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Operation
+          command.params['sourceStore'] = source_store unless source_store.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Deletes the specified FHIR store and removes all resources within it.
         # @param [String] name
         #   The resource name of the FHIR store to delete.
@@ -1674,16 +1917,15 @@ module Google
         # GetOperation.
         # Immediate fatal errors appear in the
         # error field, errors are also logged
-        # to Stackdriver (see [Viewing
-        # logs](/healthcare/docs/how-tos/stackdriver-logging)).
+        # to Cloud Logging (see [Viewing
+        # logs](/healthcare/docs/how-tos/logging)).
         # Otherwise, when the operation finishes, a detailed response of type
         # ExportResourcesResponse is returned in the
         # response field.
         # The metadata field type for this
         # operation is OperationMetadata.
         # @param [String] name
-        #   The name of the FHIR store to export resource from. The name should be in
-        #   the format of
+        #   The name of the FHIR store to export resource from, in the format of
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   fhirStores/`fhir_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::ExportResourcesRequest] export_resources_request_object
@@ -1759,6 +2001,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1794,8 +2039,8 @@ module Google
         # an empty FHIR store that is not being used by other clients. In cases
         # where this method is not appropriate, consider using ExecuteBundle to
         # load data.
-        # Every resource in the input must contain a client-supplied ID, and will be
-        # stored using that ID regardless of the
+        # Every resource in the input must contain a client-supplied ID. Each
+        # resource is stored using the supplied ID regardless of the
         # enable_update_create setting on the FHIR
         # store.
         # The import process does not enforce referential integrity, regardless of
@@ -1806,6 +2051,8 @@ module Google
         # if the input data contains invalid references or if some resources fail to
         # be imported, the FHIR store might be left in a state that violates
         # referential integrity.
+        # The import process does not trigger Cloud Pub/Sub notification or BigQuery
+        # streaming update, regardless of how those are configured on the FHIR store.
         # If a resource with the specified ID already exists, the most recent
         # version of the resource is overwritten without creating a new historical
         # version, regardless of the
@@ -1815,10 +2062,10 @@ module Google
         # more than once.
         # The import operation is idempotent unless the input data contains multiple
         # valid resources with the same ID but different contents. In that case,
-        # after the import completes, the store will contain exactly one resource
+        # after the import completes, the store contains exactly one resource
         # with that ID but there is no ordering guarantee on which version of the
         # contents it will have. The operation result counters do not count
-        # duplicate IDs as an error and will count one success for each resource in
+        # duplicate IDs as an error and count one success for each resource in
         # the input, which might result in a success count larger than the number
         # of resources in the FHIR store. This often occurs when importing data
         # organized in bundles produced by Patient-everything
@@ -1843,15 +2090,14 @@ module Google
         # GetOperation.
         # Immediate fatal errors appear in the
         # error field, errors are also logged
-        # to Stackdriver (see [Viewing
-        # logs](/healthcare/docs/how-tos/stackdriver-logging)). Otherwise, when the
+        # to Cloud Logging (see [Viewing
+        # logs](/healthcare/docs/how-tos/logging)). Otherwise, when the
         # operation finishes, a detailed response of type ImportResourcesResponse
         # is returned in the response field.
         # The metadata field type for this
         # operation is OperationMetadata.
         # @param [String] name
-        #   The name of the FHIR store to import FHIR resources to. The name should be
-        #   in the format of
+        #   The name of the FHIR store to import FHIR resources to, in the format of
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   fhirStores/`fhir_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::ImportResourcesRequest] import_resources_request_object
@@ -1968,6 +2214,7 @@ module Google
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -2003,7 +2250,7 @@ module Google
         
         # Returns 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_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # 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.
@@ -2040,20 +2287,148 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Translates a code from one value set to another by searching for
+        # appropriate concept maps.
+        # Implements the FHIR standard $translate operation
+        # ([DSTU2](https://www.hl7.org/fhir/DSTU2/operation-conceptmap-translate.html),
+        # [STU3](https://www.hl7.org/fhir/STU3/operation-conceptmap-translate.html),
+        # [R4](https://www.hl7.org/fhir/R4/operation-conceptmap-translate.html)).
+        # On success, the response body contains a JSON-encoded representation
+        # of a FHIR Parameters resource, which includes the translation result.
+        # 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.
+        # @param [String] parent
+        #   The name for the FHIR store containing the concept map(s) to use for the
+        #   translation.
+        # @param [String] code
+        #   The code to translate.
+        # @param [String] concept_map_version
+        #   The version of the concept map to use. If unset, the most current version
+        #   is used.
+        # @param [String] source
+        #   The source value set of the concept map to be used. If unset, target is
+        #   used to search for concept maps.
+        # @param [String] system
+        #   The system for the code to be translated.
+        # @param [String] target
+        #   The target value set of the concept map to be used. If unset, source is
+        #   used to search for concept maps.
+        # @param [String] url
+        #   The canonical url of the concept map to use. If unset, the source and
+        #   target is used to search for concept maps.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::HttpBody] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::HttpBody]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def concept_project_location_dataset_fhir_store_fhir_map_search_translate(parent, code: nil, concept_map_version: nil, source: nil, system: nil, target: nil, url: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+parent}/fhir/ConceptMap/$translate', options)
+          command.response_representation = Google::Apis::HealthcareV1beta1::HttpBody::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::HttpBody
+          command.params['parent'] = parent unless parent.nil?
+          command.query['code'] = code unless code.nil?
+          command.query['conceptMapVersion'] = concept_map_version unless concept_map_version.nil?
+          command.query['source'] = source unless source.nil?
+          command.query['system'] = system unless system.nil?
+          command.query['target'] = target unless target.nil?
+          command.query['url'] = url unless url.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Translates a code from one value set to another using a concept map.
+        # Implements the FHIR standard $translate operation
+        # ([DSTU2](https://www.hl7.org/fhir/DSTU2/operation-conceptmap-translate.html),
+        # [STU3](https://www.hl7.org/fhir/STU3/operation-conceptmap-translate.html),
+        # [R4](https://www.hl7.org/fhir/R4/operation-conceptmap-translate.html)).
+        # On success, the response body contains a JSON-encoded representation
+        # of a FHIR Parameters resource, which includes the translation result.
+        # 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.
+        # @param [String] name
+        #   The URL for the concept map to use for the translation.
+        # @param [String] code
+        #   The code to translate.
+        # @param [String] concept_map_version
+        #   The version of the concept map to use. If unset, the most current version
+        #   is used.
+        # @param [String] system
+        #   The system for the code to be translated.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::HttpBody] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::HttpBody]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def concept_project_location_dataset_fhir_store_fhir_map_translate(name, code: nil, concept_map_version: nil, system: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+name}/$translate', options)
+          command.response_representation = Google::Apis::HealthcareV1beta1::HttpBody::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::HttpBody
+          command.params['name'] = name unless name.nil?
+          command.query['code'] = code unless code.nil?
+          command.query['conceptMapVersion'] = concept_map_version unless concept_map_version.nil?
+          command.query['system'] = system unless system.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Retrieves the N most recent `Observation` resources for a subject matching
         # search criteria specified as query parameters, grouped by
         # `Observation.code`, sorted from most recent to oldest.
-        # Implements the FHIR extended operation
-        # [Observation-lastn](http://hl7.org/implement/standards/fhir/STU3/observation-
-        # operations.html#lastn).
+        # Implements the FHIR extended operation Observation-lastn
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/observation-operations.
+        # html#lastn),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/observation-operations.html#
+        # lastn)).
+        # DSTU2 doesn't define the Observation-lastn method, but the server supports
+        # it the same way it supports STU3.
         # Search terms are provided as query parameters following the same pattern as
-        # the search method. This operation accepts an additional
-        # query parameter `max`, which specifies N, the maximum number of
-        # Observations to return from each group, with a default of 1.
-        # On success, the response body will contain a JSON-encoded representation
+        # the search method. The following search parameters must
+        # be provided:
+        # - `subject` or `patient` to specify a subject for the Observation.
+        # - `code`, `category` or any of the composite parameters that include
+        # `code`.
+        # Any other valid Observation search parameters can also be provided. This
+        # operation accepts an additional query parameter `max`, which specifies N,
+        # the maximum number of Observations to return from each group, with a
+        # default of 1.
+        # Searches with over 1000 results are rejected. Results are counted before
+        # grouping and limiting the results with `max`. To stay within the limit,
+        # constrain these searches using Observation search parameters such as
+        # `_lastUpdated` or `date`.
+        # On success, the response body contains a JSON-encoded representation
         # of a `Bundle` resource of type `searchset`, containing the results of the
         # operation.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # 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.
@@ -2086,32 +2461,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves all the resources directly referenced by a patient, as well as
-        # all of the resources in the patient compartment.
-        # Implements the FHIR extended operation
-        # [Patient-everything](http://hl7.org/implement/standards/fhir/STU3/patient-
-        # operations.html#everything).
-        # On success, the response body will contain a JSON-encoded representation
+        # Retrieves a Patient resource and resources related to that patient.
+        # Implements the FHIR extended operation Patient-everything
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/patient-operations.
+        # html#everything),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/patient-operations.html#
+        # everything),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/patient-operations.html#
+        # everything)).
+        # On success, the response body contains a JSON-encoded representation
         # of a `Bundle` resource of type `searchset`, containing the results of the
         # operation.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # 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.
+        # 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
+        # ([DSTU2](https://hl7.org/fhir/DSTU2/compartment-patient.html),
+        # [STU3](http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html),
+        # [R4](https://hl7.org/fhir/R4/compartmentdefinition-patient.html)), which
+        # details the eligible resource types and referencing search parameters.
         # @param [String] name
         #   Name of the `Patient` resource for which the information is required.
         # @param [Fixnum] _count
         #   Maximum number of resources in a page. Defaults to 100.
-        # @param [String] end_
-        #   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.
-        # @param [String] page_token
+        # @param [String] _page_token
         #   Used to retrieve the next or previous page of results
-        #   when using pagination. Value should be set to the value of page_token set
-        #   in next or previous page links' urls. Next and previous page are returned
+        #   when using pagination. Value should be set to the value of `page_token` set
+        #   in next or previous page links' URLs. Next and previous page are returned
         #   in the response bundle's links field, where `link.relation` is "previous"
         #   or "next".
         #   Omit `page_token` if no previous request has been made.
+        # @param [String] end_
+        #   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.
         # @param [String] start
         #   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.
@@ -2132,14 +2520,14 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def patient_project_location_dataset_fhir_store_fhir_everything(name, _count: nil, end_: nil, page_token: nil, start: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def patient_project_location_dataset_fhir_store_fhir_everything(name, _count: nil, _page_token: nil, end_: nil, start: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1beta1/{+name}/$everything', options)
           command.response_representation = Google::Apis::HealthcareV1beta1::HttpBody::Representation
           command.response_class = Google::Apis::HealthcareV1beta1::HttpBody
           command.params['name'] = name unless name.nil?
           command.query['_count'] = _count unless _count.nil?
+          command.query['_page_token'] = _page_token unless _page_token.nil?
           command.query['end'] = end_ unless end_.nil?
-          command.query['pageToken'] = page_token unless page_token.nil?
           command.query['start'] = start unless start.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -2179,15 +2567,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the FHIR [capability
-        # statement](http://hl7.org/implement/standards/fhir/STU3/capabilitystatement.
-        # html)
-        # for the store, which contains a description of functionality supported by
-        # the server.
-        # Implements the FHIR standard [capabilities
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#
-        # capabilities).
-        # On success, the response body will contain a JSON-encoded representation
+        # Gets the FHIR capability statement
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/capabilitystatement.html)
+        # ,
+        # [R4](https://hl7.org/implement/standards/fhir/R4/capabilitystatement.html)),
+        # or the [conformance
+        # statement](https://hl7.org/implement/standards/fhir/DSTU2/conformance.html)
+        # in the DSTU2 case for the store, which contains a description of
+        # functionality supported by the server.
+        # Implements the FHIR standard capabilities interaction
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#capabilities),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#capabilities)),
+        # or the [conformance
+        # interaction](https://hl7.org/implement/standards/fhir/DSTU2/http.html#
+        # conformance)
+        # in the DSTU2 case.
+        # On success, the response body contains a JSON-encoded representation
         # of a `CapabilityStatement` resource.
         # @param [String] name
         #   Name of the FHIR store to retrieve the capabilities for.
@@ -2219,24 +2614,29 @@ module Google
         end
         
         # Deletes FHIR resources that match a search query.
-        # Implements the FHIR standard [conditional delete
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.13.
-        # 1).
-        # If multiple resources match, all of them will be deleted.
+        # Implements the FHIR standard conditional delete interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.12.1),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.13.1),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#3.1.0.7.1)).
+        # If multiple resources match, all matching resources are deleted.
         # Search terms are provided as query parameters following the same pattern as
         # the search 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
+        # on the FHIR store, the deleted resources are moved to a history
         # repository that can still be retrieved through vread
         # and related methods, unless they are removed by the
         # purge method.
+        # This method requires the`healthcare.fhirStores.searchResources` and
+        # `healthcare.fhirResources.delete` permissions on the parent FHIR store.
         # @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](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html).
+        #   complete list, see the FHIR Resource Index
+        #   ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
+        #   [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
+        #   [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2268,26 +2668,34 @@ module Google
         # If a resource is found based on the search criteria specified in the query
         # parameters, 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](http://hl7.org/implement/standards/fhir/STU3/http.html#patch).
+        # Implements the FHIR standard conditional patch interaction
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#patch),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#patch)).
+        # DSTU2 doesn't define a conditional patch method, but the server supports it
+        # in the same way it supports STU3.
         # Search terms are provided as query parameters following the same pattern as
         # the search method.
-        # If the search criteria identify more than one match, the request will
-        # return a `412 Precondition Failed` error.
+        # 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 will contain a JSON-encoded representation
+        # 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 will contain a JSON-encoded
+        # 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.
+        # This method requires the`healthcare.fhirStores.searchResources` permission
+        # on the parent FHIR store and the `healthcare.fhirResources.patch`
+        # permission on the requested FHIR store resource.
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
         #   The FHIR resource type to update, such as Patient or Observation. For a
-        #   complete list, see the [FHIR Resource
-        #   Index](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html).
+        #   complete list, see the FHIR Resource Index
+        #   ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
+        #   [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
+        #   [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2321,34 +2729,39 @@ module Google
         
         # If a resource is found based on the search criteria specified in the query
         # parameters, updates the entire contents of that resource.
-        # Implements the FHIR standard [conditional update
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#cond-
-        # update).
+        # Implements the FHIR standard conditional update interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.10.2),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#cond-update),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#cond-update)).
         # Search terms are provided as query parameters following the same pattern as
         # the search method.
-        # If the search criteria identify more than one match, the request will
-        # return a `412 Precondition Failed` error.
+        # 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. 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
+        # 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 will contain a JSON-encoded representation
+        # 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 will contain a JSON-encoded
+        # 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.
+        # This method requires the`healthcare.fhirStores.searchResources` and
+        # `healthcare.fhirResources.update` permissions on the parent FHIR store.
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
         #   The FHIR resource type to update, such as Patient or Observation. For a
-        #   complete list, see the [FHIR Resource
-        #   Index](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html).
+        #   complete list, see the FHIR Resource Index
+        #   ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
+        #   [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
+        #   [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
         #   Must match the resource type in the provided content.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
         # @param [String] fields
@@ -2382,20 +2795,24 @@ module Google
         end
         
         # Creates a FHIR resource.
-        # Implements the FHIR standard [create
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#create),
+        # Implements the FHIR standard create interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#create),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#create),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#create)),
         # which creates a new resource with a server-assigned resource ID.
-        # Also supports the FHIR standard [conditional create
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#ccreate),
+        # 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. If no resources match this search query, the server processes the
         # create operation as normal.
         # 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 will contain a JSON-encoded representation
+        # 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 will contain a JSON-encoded
+        # 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.
@@ -2403,8 +2820,10 @@ module Google
         #   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](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html).
+        #   complete list, see the FHIR Resource Index
+        #   ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
+        #   [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
+        #   [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
         #   Must match the resource type in the provided content.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
         # @param [String] fields
@@ -2438,11 +2857,13 @@ module Google
         end
         
         # Deletes a FHIR resource.
-        # Implements the FHIR standard [delete
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#delete).
+        # Implements the FHIR standard delete interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#delete),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#delete),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#delete)).
         # 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
+        # on the FHIR store, the deleted resources are moved to a history
         # repository that can still be retrieved through vread
         # and related methods, unless they are removed by the
         # purge method.
@@ -2476,25 +2897,36 @@ module Google
         end
         
         # Executes all the requests in the given Bundle.
-        # Implements the FHIR standard [batch/transaction
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#
-        # transaction).
+        # Implements the FHIR standard batch/transaction interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#transaction),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#transaction),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#transaction)).
         # 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](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.1)
-        # and [transaction processing
-        # rules](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.2).
+        # according to the batch processing rules
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.1),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.1),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#brules))
+        # and transaction processing rules
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.2),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.2),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#trules)).
         # The request body must contain a JSON-encoded FHIR `Bundle` resource, and
         # the request headers must contain `Content-Type: application/fhir+json`.
-        # For a batch bundle or a successful transaction the response body will
-        # contain a JSON-encoded representation of a `Bundle` resource of type
+        # For a batch bundle or a successful transaction the response body
+        # contains a JSON-encoded 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. In the
-        # case of an error for a transaction bundle, the response body will contain
+        # case of an error for a transaction bundle, the response body contains
         # 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.
+        # This method requires permission for executing the requests in the bundle.
+        # The `executeBundle` permission grants permission to execute the request in
+        # the bundle but you must grant sufficient permissions to execute the
+        # individual requests in the bundle. For example, if the bundle contains a
+        # `create` request, you must have permission to execute the `create` request.
+        # Logging is available for the `executeBundle` permission.
         # @param [String] parent
         #   Name of the FHIR store in which this bundle will be executed.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
@@ -2529,20 +2961,20 @@ module Google
         
         # Lists 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](http://hl7.org/implement/standards/fhir/STU3/http.html#history).
-        # On success, the response body will contain a JSON-encoded representation
+        # Implements the per-resource form of the FHIR standard history interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#history),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#history),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#history)).
+        # On success, the response body contains a JSON-encoded representation
         # of a `Bundle` resource of type `history`, containing the version history
         # sorted from most recent to oldest versions.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # 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.
         # @param [String] name
         #   The name of the resource to retrieve.
-        # @param [String] _page_token
-        #   Same as `page`. Please use either `page` or `_page_token`.
-        # @param [String] at
+        # @param [String] _at
         #   Only include resource versions that were current at some point during the
         #   time period specified in the date time value. The date parameter format is
         #   yyyy-mm-ddThh:mm:ss[Z|(+|-)hh:mm]
@@ -2551,16 +2983,16 @@ module Google
         #   *  An entire month: `_at=2019-01`
         #   *  A specific day: `_at=2019-01-20`
         #   *  A specific second: `_at=2018-12-31T23:59:58Z`
-        # @param [Fixnum] count
+        # @param [Fixnum] _count
         #   The maximum number of search results on a page. Defaults to 1000.
-        # @param [String] page
+        # @param [String] _page_token
         #   Used to retrieve the first, previous, next, or last page of resource
         #   versions when using pagination. Value should be set to the value of
-        #   `page` set in next or previous page links' URLs. Next and previous
+        #   `_page_token` set in next or previous page links' URLs. Next and previous
         #   page are returned in the response bundle's links field, where
         #   `link.relation` is "previous" or "next".
-        #   Omit `page` if no previous request has been made.
-        # @param [String] since
+        #   Omit `_page_token` if no previous request has been made.
+        # @param [String] _since
         #   Only include resource versions that were created at or after the given
         #   instant in time. The instant in time uses the format
         #   YYYY-MM-DDThh:mm:ss.sss+zz:zz (for example 2015-02-07T13:28:17.239+02:00 or
@@ -2583,16 +3015,15 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def history_project_location_dataset_fhir_store_fhir(name, _page_token: nil, at: nil, count: nil, page: nil, since: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def history_project_location_dataset_fhir_store_fhir(name, _at: nil, _count: nil, _page_token: nil, _since: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1beta1/{+name}/_history', options)
           command.response_representation = Google::Apis::HealthcareV1beta1::HttpBody::Representation
           command.response_class = Google::Apis::HealthcareV1beta1::HttpBody
           command.params['name'] = name unless name.nil?
+          command.query['_at'] = _at unless _at.nil?
+          command.query['_count'] = _count unless _count.nil?
           command.query['_page_token'] = _page_token unless _page_token.nil?
-          command.query['at'] = at unless at.nil?
-          command.query['count'] = count unless count.nil?
-          command.query['page'] = page unless page.nil?
-          command.query['since'] = since unless since.nil?
+          command.query['_since'] = _since unless _since.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -2600,13 +3031,16 @@ module Google
         
         # Updates part of an existing resource by applying the operations specified
         # in a [JSON Patch](http://jsonpatch.com/) document.
-        # Implements the FHIR standard [patch
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#patch).
+        # Implements the FHIR standard patch interaction
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#patch),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#patch)).
+        # DSTU2 doesn't define a patch method, but the server supports it in the same
+        # way it supports STU3.
         # 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 will contain a JSON-encoded representation
+        # 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 will contain a JSON-encoded
+        # 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.
@@ -2643,15 +3077,19 @@ module Google
         end
         
         # Gets the contents of a FHIR resource.
-        # Implements the FHIR standard [read
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#read).
-        # Also supports the FHIR standard [conditional read
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#cread)
+        # Implements the FHIR standard read interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#read),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#read),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#read)).
+        # Also supports the FHIR standard conditional read interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#cread),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#cread),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#cread))
         # specified by supplying an `If-Modified-Since` header with a date/time value
         # or an `If-None-Match` header with an ETag value.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of the resource.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # 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.
@@ -2686,10 +3124,14 @@ module Google
         
         # Searches for resources in the given FHIR store according to criteria
         # specified as query parameters.
-        # Implements the FHIR standard [search
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#search)
-        # using the search semantics described in the [FHIR Search
-        # specification](http://hl7.org/implement/standards/fhir/STU3/search.html).
+        # Implements the FHIR standard search interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#search),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#search),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#search))
+        # using the search semantics described in the FHIR Search specification
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/search.html),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/search.html),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/search.html)).
         # Supports three 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
@@ -2698,26 +3140,31 @@ module Google
         # the same semantics as the `GET` method.
         # The `GET` methods do not support compartment searches. The `POST` method
         # does not support `application/x-www-form-urlencoded` search parameters.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of a `Bundle` resource of type `searchset`, containing the results of the
         # search.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # 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.
         # 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](http://hl7.org/implement/standards/fhir/STU3/searchparameter-
-        # registry.html).
+        # defined by the specification can be found in the FHIR Search Parameter
+        # Registry
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/searchparameter-registry.
+        # html),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/searchparameter-registry.html)
+        # ).
+        # 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`, and `:recurse`.
         # 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 `_count` parameter up to a maximum limit of 1000. If
-        # there are additional results, the returned `Bundle` will contain
+        # there are additional results, the returned `Bundle` contains
         # pagination links.
         # 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
@@ -2758,8 +3205,10 @@ module Google
         end
         
         # Updates the entire contents of a resource.
-        # Implements the FHIR standard [update
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#update).
+        # Implements the FHIR standard update interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#update),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#update),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#update)).
         # If the specified resource does
         # not exist and the FHIR store has
         # enable_update_create set, creates the
@@ -2768,9 +3217,9 @@ module Google
         # headers must contain `Content-Type: application/fhir+json`. The resource
         # must contain an `id` element having an identical value to the ID in the
         # REST path of the request.
-        # On success, the response body will contain a JSON-encoded representation
+        # 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 will contain a JSON-encoded
+        # 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.
@@ -2808,11 +3257,13 @@ module Google
         
         # Gets the contents of a version (current or historical) of a FHIR resource
         # by version ID.
-        # Implements the FHIR standard [vread
-        # interaction](http://hl7.org/implement/standards/fhir/STU3/http.html#vread).
-        # On success, the response body will contain a JSON-encoded representation
+        # Implements the FHIR standard vread interaction
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#vread),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#vread),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#vread)).
+        # On success, the response body contains a JSON-encoded representation
         # of the resource.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # 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.
@@ -2882,8 +3333,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified HL7v2 store and removes all messages that are
-        # contained within it.
+        # Deletes the specified HL7v2 store and removes all messages that it
+        # contains.
         # @param [String] name
         #   The resource name of the HL7v2 store to delete.
         # @param [String] fields
@@ -2956,6 +3407,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3068,6 +3522,7 @@ module Google
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -3103,7 +3558,7 @@ module Google
         
         # Returns 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_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # 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.
@@ -3213,6 +3668,7 @@ module Google
         #   The resource name of the HL7v2 message to retrieve.
         # @param [String] view
         #   Specifies which parts of the Message resource to return in the response.
+        #   When unspecified, equivalent to FULL.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3243,9 +3699,7 @@ module Google
         
         # Ingests a new HL7v2 message from the hospital and sends a notification to
         # the Cloud Pub/Sub topic. Return is an HL7v2 ACK message if the message was
-        # successfully stored. Otherwise an error is returned.  If an identical
-        # HL7v2 message is created twice only one resource is created on the server
-        # and no error is reported.
+        # successfully stored. Otherwise an error is returned.
         # @param [String] parent
         #   The name of the HL7v2 store this message belongs to.
         # @param [Google::Apis::HealthcareV1beta1::IngestMessageRequest] ingest_message_request_object
@@ -3287,8 +3741,8 @@ module Google
         # @param [String] filter
         #   Restricts messages returned to those matching a filter. Syntax:
         #   https://cloud.google.com/appengine/docs/standard/python/search/query_strings
-        #   Fields/functions available for filtering are:
-        #   *  `message_type`, from the MSH-9 segment. For example,
+        #   The following fields and functions are available for filtering:
+        #   *  `message_type`, from the MSH-9.1 field. For example,
         #   `NOT message_type = "ADT"`.
         #   *  `send_date` or `sendDate`, the YYYY-MM-DD date the message was sent in
         #   the dataset's time_zone, from the MSH-7 segment. For example,
@@ -3298,10 +3752,6 @@ module Google
         #   `send_time < "2017-01-02T00:00:00-05:00"`.
         #   *  `send_facility`, the care center that the message came from, from the
         #   MSH-4 segment. For example, `send_facility = "ABC"`.
-        #   *  `HL7RegExp(expr)`, which does regular expression matching of `expr`
-        #   against the message payload using RE2 syntax
-        #   (https://github.com/google/re2/wiki/Syntax). For example,
-        #   `HL7RegExp("^.*\|.*\|EMERG")`.
         #   *  `PatientId(value, type)`, which matches if the message lists a patient
         #   having an ID of the given value and type in the PID-2, PID-3, or PID-4
         #   segments. For example, `PatientId("123456", "MRN")`.
@@ -3309,19 +3759,6 @@ module Google
         #   Message.labels
         #   map. For example, `labels."priority"="high"`. The operator `:*` can be used
         #   to assert the existence of a label. For example, `labels."priority":*`.
-        #   Limitations on conjunctions:
-        #   *  Negation on the patient ID function or the labels field is not
-        #   supported. For example, these queries are invalid:
-        #   `NOT PatientId("123456", "MRN")`, `NOT labels."tag1":*`,
-        #   `NOT labels."tag2"="val2"`.
-        #   *  Conjunction of multiple patient ID functions is not supported, for
-        #   example this query is invalid:
-        #   `PatientId("123456", "MRN") AND PatientId("456789", "MRN")`.
-        #   *  Conjunction of multiple labels fields is also not supported, for
-        #   example this query is invalid: `labels."tag1":* AND labels."tag2"="val2"`.
-        #   *  Conjunction of one patient ID function, one labels field and conditions
-        #   on other fields is supported. For example, this query is valid:
-        #   `PatientId("123456", "MRN") AND labels."tag1":* AND message_type = "ADT"`.
         # @param [String] order_by
         #   Orders messages returned by the specified order_by clause.
         #   Syntax: https://cloud.google.com/apis/design/design_patterns#sorting_order
@@ -3332,6 +3769,11 @@ module Google
         #   If zero the default page size of 100 is used.
         # @param [String] page_token
         #   The next_page_token value returned from the previous List request, if any.
+        # @param [String] view
+        #   Specifies the parts of the Message to return in the response.
+        #   When unspecified, equivalent to BASIC. Setting this to anything other than
+        #   BASIC with a `page_size` larger than the default can generate a large
+        #   response, which impacts the performance of this method.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3349,7 +3791,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_project_location_dataset_hl7_v2_store_messages(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_project_location_dataset_hl7_v2_store_messages(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1beta1/{+parent}/messages', options)
           command.response_representation = Google::Apis::HealthcareV1beta1::ListMessagesResponse::Representation
           command.response_class = Google::Apis::HealthcareV1beta1::ListMessagesResponse
@@ -3358,12 +3800,18 @@ module Google
           command.query['orderBy'] = order_by unless order_by.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['view'] = view unless view.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
         # Update the message.
+        # The contents of the message in Message.data and data extracted from
+        # the contents such as Message.create_time can't 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.
         # @param [String] name
         #   Resource name of the Message, of the form
         #   `projects/`project_id`/datasets/`dataset_id`/hl7V2Stores/`hl7_v2_store_id`/
@@ -3375,9 +3823,6 @@ module Google
         #   see
         #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
         #   fieldmask
-        #   Only the `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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3408,6 +3853,48 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Starts 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 to `Code.CANCELLED`.
+        # @param [String] name
+        #   The name of the operation resource to be cancelled.
+        # @param [Google::Apis::HealthcareV1beta1::CancelOperationRequest] cancel_operation_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+name}:cancel', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::CancelOperationRequest::Representation
+          command.request_object = cancel_operation_request_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Empty::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets 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.