google-api-client 0.39.4 → 0.41.0

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

@@ -357,7 +357,7 @@ module Google
         
         # Updates dataset metadata.
         # @param [String] name
-        #   Output only. Resource name of the dataset, of the form
+        #   Resource name of the dataset, of the form
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id``.
         # @param [Google::Apis::HealthcareV1beta1::Dataset] dataset_object
         # @param [String] update_mask
@@ -470,6 +470,196 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a new Annotation store within the parent dataset.
+        # @param [String] parent
+        #   The name of the dataset this Annotation store belongs to.
+        # @param [Google::Apis::HealthcareV1beta1::AnnotationStore] annotation_store_object
+        # @param [String] annotation_store_id
+        #   The ID of the Annotation store that is being created.
+        #   The string must match the following regex: `[\p`L`\p`N`_\-\.]`1,256``.
+        # @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::AnnotationStore] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::AnnotationStore]
+        #
+        # @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 create_project_location_dataset_annotation_store(parent, annotation_store_object = nil, annotation_store_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+parent}/annotationStores', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::AnnotationStore::Representation
+          command.request_object = annotation_store_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::AnnotationStore::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::AnnotationStore
+          command.params['parent'] = parent unless parent.nil?
+          command.query['annotationStoreId'] = annotation_store_id unless annotation_store_id.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 Annotation store and removes all annotations that are
+        # contained within it.
+        # @param [String] name
+        #   The resource name of the Annotation store to delete.
+        # @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 delete_project_location_dataset_annotation_store(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1beta1/{+name}', options)
+          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
+        
+        # Evaluate an Annotation store against a
+        # ground truth Annotation store.
+        # When the operation finishes successfully, a detailed response is returned
+        # of type EvaluateAnnotationStoreResponse, contained in the response. The
+        # metadata field type is
+        # OperationMetadata.
+        # Errors are logged to Cloud Logging
+        # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
+        # @param [String] eval_store
+        #   The Annotation store to compare against `golden_store`, in the format of
+        #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   annotationStores/`annotation_store_id``.
+        # @param [Google::Apis::HealthcareV1beta1::EvaluateAnnotationStoreRequest] evaluate_annotation_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 evaluate_annotation_store(eval_store, evaluate_annotation_store_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+evalStore}:evaluate', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::EvaluateAnnotationStoreRequest::Representation
+          command.request_object = evaluate_annotation_store_request_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Operation::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Operation
+          command.params['evalStore'] = eval_store unless eval_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
+        
+        # Export
+        # Annotations from
+        # the Annotation
+        # store.
+        # If the request is successful, a detailed response is returned of type
+        # ExportAnnotationsResponse, contained in the
+        # response field when the
+        # operation finishes.
+        # The metadata field type is
+        # OperationMetadata.
+        # If errors occur, the error
+        # field type is ImportAnnotationsErrorDetails.
+        # Errors are also logged to Cloud Logging
+        # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
+        # @param [String] annotation_store
+        #   The name of the Annotation store to export annotations to, in
+        #   the format of
+        #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   annotationStores/`annotation_store_id``.
+        # @param [Google::Apis::HealthcareV1beta1::ExportAnnotationsRequest] export_annotations_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 export_annotation_store_annotations(annotation_store, export_annotations_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+annotationStore}:export', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::ExportAnnotationsRequest::Representation
+          command.request_object = export_annotations_request_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Operation::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Operation
+          command.params['annotationStore'] = annotation_store unless annotation_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
+        
+        # Gets the specified Annotation store or returns NOT_FOUND if it does not
+        # exist.
+        # @param [String] name
+        #   The resource name of the Annotation store to get.
+        # @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::AnnotationStore] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::AnnotationStore]
+        #
+        # @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(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+name}', options)
+          command.response_representation = Google::Apis::HealthcareV1beta1::AnnotationStore::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::AnnotationStore
+          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 access control policy for a resource.
         # Returns an empty policy if the resource exists and does not have a policy
         # set.
@@ -514,6 +704,139 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Import
+        # Annotations to
+        # the Annotation
+        # store by
+        # loading data from the specified sources.
+        # If the request is successful, a detailed response is returned as of type
+        # ImportAnnotationsResponse, contained in the
+        # response field when the
+        # operation finishes.
+        # The metadata field type is
+        # OperationMetadata.
+        # If errors occur, the error
+        # field type is ImportAnnotationsErrorDetails.
+        # Errors are also logged to Cloud Logging
+        # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
+        # @param [String] annotation_store
+        #   The name of the Annotation store to which the server imports annotations,
+        #   in the format
+        #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   annotationStores/`annotation_store_id``.
+        # @param [Google::Apis::HealthcareV1beta1::ImportAnnotationsRequest] import_annotations_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 import_annotation_store_annotations(annotation_store, import_annotations_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+annotationStore}:import', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::ImportAnnotationsRequest::Representation
+          command.request_object = import_annotations_request_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Operation::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Operation
+          command.params['annotationStore'] = annotation_store unless annotation_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
+        
+        # Lists the Annotation stores in the given dataset for a source store.
+        # @param [String] parent
+        #   Name of the dataset.
+        # @param [String] filter
+        #   Restricts stores returned to those matching a filter. Syntax:
+        #   https://cloud.google.com/appengine/docs/standard/python/search/query_strings
+        #   Only filtering on labels is supported, for example `labels.key=value`.
+        # @param [Fixnum] page_size
+        #   Limit on the number of Annotation stores to return in a single response.
+        #   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] 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::ListAnnotationStoresResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::ListAnnotationStoresResponse]
+        #
+        # @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_annotation_stores(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+parent}/annotationStores', options)
+          command.response_representation = Google::Apis::HealthcareV1beta1::ListAnnotationStoresResponse::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::ListAnnotationStoresResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates the specified Annotation store.
+        # @param [String] name
+        #   Resource name of the Annotation store, of the form
+        #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   annotationStores/`annotation_store_id``.
+        # @param [Google::Apis::HealthcareV1beta1::AnnotationStore] annotation_store_object
+        # @param [String] update_mask
+        #   The update mask applies to the resource. For the `FieldMask` definition,
+        #   see
+        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        #   fieldmask
+        # @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::AnnotationStore] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::AnnotationStore]
+        #
+        # @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 patch_project_location_dataset_annotation_store(name, annotation_store_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1beta1/{+name}', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::AnnotationStore::Representation
+          command.request_object = annotation_store_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::AnnotationStore::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::AnnotationStore
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.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.
@@ -589,6 +912,198 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a new Annotation record. It is
+        # valid to create Annotation objects for the same source more than once since
+        # a unique ID is assigned to each record by this service.
+        # @param [String] parent
+        #   The name of the Annotation store this annotation belongs to. For example,
+        #   `projects/my-project/locations/us-central1/datasets/mydataset/annotationStores/
+        #   myannotationstore`.
+        # @param [Google::Apis::HealthcareV1beta1::Annotation] annotation_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::Annotation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::Annotation]
+        #
+        # @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 create_project_location_dataset_annotation_store_annotation(parent, annotation_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+parent}/annotations', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::Annotation::Representation
+          command.request_object = annotation_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Annotation::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Annotation
+          command.params['parent'] = parent unless parent.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 an Annotation or returns
+        # NOT_FOUND if it does not exist.
+        # @param [String] name
+        #   The resource name of the Annotation to delete.
+        # @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 delete_project_location_dataset_annotation_store_annotation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1beta1/{+name}', options)
+          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 an Annotation.
+        # @param [String] name
+        #   The resource name of the Annotation to retrieve.
+        # @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::Annotation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::Annotation]
+        #
+        # @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_annotation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+name}', options)
+          command.response_representation = Google::Apis::HealthcareV1beta1::Annotation::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Annotation
+          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
+        
+        # Lists the Annotations in the given
+        # Annotation store for a source
+        # resource.
+        # @param [String] parent
+        #   Name of the Annotation store to retrieve Annotations from.
+        # @param [String] filter
+        #   Restricts Annotations returned to those matching a filter. Functions
+        #   available for filtering are:
+        #   - `matches("annotation_source.cloud_healthcare_source.name", substring)`.
+        #   Filter on `cloud_healthcare_source.name`. For example:
+        #   `matches("annotation_source.cloud_healthcare_source.name", "some source")`.
+        #   - `matches("annotation", substring)`. Filter on all fields of annotation.
+        #   For example: `matches("annotation", "some-content")`.
+        #   - `type("text")`, `type("image")`, `type("resource")`. Filter on the type
+        #   of annotation `data`.
+        # @param [Fixnum] page_size
+        #   Limit on the number of Annotations to return in a single response.
+        #   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
+        #   Controls which fields are populated in the response.
+        # @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::ListAnnotationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::ListAnnotationsResponse]
+        #
+        # @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_annotation_store_annotations(parent, filter: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+parent}/annotations', options)
+          command.response_representation = Google::Apis::HealthcareV1beta1::ListAnnotationsResponse::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::ListAnnotationsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.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
+        
+        # Updates the Annotation.
+        # @param [String] name
+        #   Resource name of the Annotation, of the form
+        #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   annotationStores/`annotation_store_id`/annotations/`annotation_id``.
+        # @param [Google::Apis::HealthcareV1beta1::Annotation] annotation_object
+        # @param [String] update_mask
+        #   The update mask applies to the resource. For the `FieldMask` definition,
+        #   see
+        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        #   fieldmask
+        # @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::Annotation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::Annotation]
+        #
+        # @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 patch_project_location_dataset_annotation_store_annotation(name, annotation_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1beta1/{+name}', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::Annotation::Representation
+          command.request_object = annotation_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Annotation::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Annotation
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.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.
@@ -907,7 +1422,7 @@ module Google
         
         # Updates the specified DICOM store.
         # @param [String] name
-        #   Output only. Resource name of the DICOM store, of the form
+        #   Resource name of the DICOM store, of the form
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   dicomStores/`dicom_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::DicomStore] dicom_store_object
@@ -947,7 +1462,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -985,7 +1501,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1022,7 +1539,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1095,7 +1613,9 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1208,7 +1728,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1245,7 +1766,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1282,7 +1804,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1320,7 +1843,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1358,7 +1882,9 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1437,7 +1963,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1474,7 +2001,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1511,7 +2039,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1551,6 +2080,8 @@ 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 Retrieve transaction.
+        # Study and series search results can take a few seconds to be updated after
+        # an instance is deleted using DeleteInstance.
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1588,7 +2119,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1627,7 +2159,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1665,7 +2198,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1703,7 +2237,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1743,7 +2278,8 @@ 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,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1906,8 +2442,7 @@ module Google
         # 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
@@ -2021,8 +2556,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
@@ -2044,10 +2579,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
@@ -2079,8 +2614,7 @@ module Google
         # 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
@@ -2388,9 +2922,9 @@ module Google
         # search criteria specified as query parameters, grouped by
         # `Observation.code`, sorted from most recent to oldest.
         # Implements the FHIR extended operation Observation-lastn
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/observation-operations.
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/observation-operations.
         # html#lastn),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/observation-operations.html#
+        # [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.
@@ -2408,10 +2942,10 @@ module Google
         # 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 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
         # 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.
@@ -2446,16 +2980,16 @@ module Google
         
         # Retrieves a Patient resource and resources related to that patient.
         # Implements the FHIR extended operation Patient-everything
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/patient-operations.html#
-        # everything),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/patient-operations.html#
+        # ([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](http://hl7.org/implement/standards/fhir/R4/patient-operations.html#
+        # [R4](https://hl7.org/implement/standards/fhir/R4/patient-operations.html#
         # everything)).
-        # 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
         # 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.
@@ -2465,9 +2999,9 @@ module Google
         # * 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](http://hl7.org/fhir/DSTU2/compartment-patient.html),
+        # ([DSTU2](https://hl7.org/fhir/DSTU2/compartment-patient.html),
         # [STU3](http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html),
-        # [R4](http://hl7.org/fhir/R4/compartmentdefinition-patient.html)), which
+        # [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.
@@ -2475,8 +3009,8 @@ module Google
         #   Maximum number of resources in a page. Defaults to 100.
         # @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.
@@ -2551,20 +3085,21 @@ module Google
         end
         
         # Gets the FHIR capability statement
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/capabilitystatement.html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/capabilitystatement.html)),
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/capabilitystatement.html)
+        # ,
+        # [R4](https://hl7.org/implement/standards/fhir/R4/capabilitystatement.html)),
         # or the [conformance
-        # statement](http://hl7.org/implement/standards/fhir/DSTU2/conformance.html)
+        # 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](http://hl7.org/implement/standards/fhir/STU3/http.html#capabilities),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#capabilities)),
+        # ([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](http://hl7.org/implement/standards/fhir/DSTU2/http.html#
+        # interaction](https://hl7.org/implement/standards/fhir/DSTU2/http.html#
         # conformance)
         # in the DSTU2 case.
-        # On success, the response body will contain a JSON-encoded representation
+        # 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.
@@ -2597,15 +3132,15 @@ module Google
         
         # Deletes FHIR resources that match a search query.
         # Implements the FHIR standard conditional delete interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.12.1),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.13.1),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#3.1.0.7.1)).
-        # If multiple resources match, all of them will be deleted.
+        # ([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.
@@ -2616,9 +3151,9 @@ module Google
         # @param [String] type
         #   The FHIR resource type to delete, such as Patient or Observation. For a
         #   complete list, see the FHIR Resource Index
-        #   ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
-        #   [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
-        #   [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
+        #   ([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
@@ -2651,19 +3186,19 @@ module Google
         # 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
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#patch),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#patch)).
+        # ([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.
@@ -2675,9 +3210,9 @@ module Google
         # @param [String] type
         #   The FHIR resource type to update, such as Patient or Observation. For a
         #   complete list, see the FHIR Resource Index
-        #   ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
-        #   [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
-        #   [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
+        #   ([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.
@@ -2712,25 +3247,25 @@ 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
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.10.2),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#cond-update),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#cond-update)).
+        # ([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.
@@ -2741,9 +3276,9 @@ module Google
         # @param [String] type
         #   The FHIR resource type to update, such as Patient or Observation. For a
         #   complete list, see the FHIR Resource Index
-        #   ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
-        #   [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
-        #   [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
+        #   ([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
@@ -2778,23 +3313,23 @@ module Google
         
         # Creates a FHIR resource.
         # Implements the FHIR standard create interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#create),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#create),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#create)),
+        # ([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
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#ccreate),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#ccreate),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#ccreate)),
+        # ([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.
@@ -2803,9 +3338,9 @@ module Google
         # @param [String] type
         #   The FHIR resource type to create, such as Patient or Observation. For a
         #   complete list, see the FHIR Resource Index
-        #   ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
-        #   [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
-        #   [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
+        #   ([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
@@ -2840,12 +3375,12 @@ module Google
         
         # Deletes a FHIR resource.
         # Implements the FHIR standard delete interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#delete),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#delete),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#delete)).
+        # ([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.
@@ -2880,26 +3415,26 @@ module Google
         
         # Executes all the requests in the given Bundle.
         # Implements the FHIR standard batch/transaction interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#transaction),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#transaction),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#transaction)).
+        # ([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
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.1),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.1),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#brules))
+        # ([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](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.2),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.2),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#trules)).
+        # ([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.
@@ -2944,13 +3479,13 @@ 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
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#history),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#history),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#history)).
-        # On success, the response body will contain a JSON-encoded representation
+        # ([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.
@@ -3014,15 +3549,15 @@ 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
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#patch),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#patch)).
+        # ([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.
@@ -3060,18 +3595,18 @@ module Google
         
         # Gets the contents of a FHIR resource.
         # Implements the FHIR standard read interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#read),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#read),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#read)).
+        # ([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](http://hl7.org/implement/standards/fhir/DSTU2/http.html#cread),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#cread),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#cread))
+        # ([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.
@@ -3107,13 +3642,13 @@ module Google
         # Searches for resources in the given FHIR store according to criteria
         # specified as query parameters.
         # Implements the FHIR standard search interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#search),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#search),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#search))
+        # ([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](http://hl7.org/implement/standards/fhir/DSTU2/search.html),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/search.html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/search.html)).
+        # ([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
@@ -3122,10 +3657,10 @@ 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.
@@ -3134,10 +3669,10 @@ module Google
         # 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
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/searchparameter-registry.
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/searchparameter-registry.
         # html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/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`,
@@ -3146,7 +3681,7 @@ module Google
         # `_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
@@ -3188,9 +3723,9 @@ module Google
         
         # Updates the entire contents of a resource.
         # Implements the FHIR standard update interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#update),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#update),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#update)).
+        # ([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
@@ -3199,9 +3734,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.
@@ -3240,12 +3775,12 @@ module Google
         # Gets the contents of a version (current or historical) of a FHIR resource
         # by version ID.
         # Implements the FHIR standard vread interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#vread),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#vread),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#vread)).
-        # On success, the response body will contain a JSON-encoded representation
+        # ([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.
@@ -3315,8 +3850,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
@@ -3464,7 +3999,7 @@ module Google
         
         # Updates the HL7v2 store.
         # @param [String] name
-        #   Output only. Resource name of the HL7v2 store, of the form
+        #   Resource name of the HL7v2 store, of the form
         #   `projects/`project_id`/datasets/`dataset_id`/hl7V2Stores/`hl7v2_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::Hl7V2Store] hl7_v2_store_object
         # @param [String] update_mask
@@ -3723,7 +4258,7 @@ 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:
+        #   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
@@ -3790,7 +4325,7 @@ module Google
         
         # Update the message.
         # The contents of the message in Message.data and data extracted from
-        # the contents such as Message.create_time cannot be altered. Only the
+        # 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.