google-api-client 0.40.2 → 0.42.1

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

@@ -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.
@@ -1565,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`/
@@ -2486,6 +3003,10 @@ module Google
         # [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.
+        # For samples that show how to call `Patient-everything`, see
+        # [Getting all patient compartment
+        # resources](/healthcare/docs/how-tos/fhir-resources#
+        # getting_all_patient_compartment_resources).
         # @param [String] name
         #   Name of the `Patient` resource for which the information is required.
         # @param [Fixnum] _count
@@ -2497,6 +3018,14 @@ module Google
         #   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] _since
+        #   If provided, only resources updated after this time are
+        #   exported. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz.
+        #   For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`.
+        #   The time must be specified to the second and include a time zone.
+        # @param [String] _type
+        #   String of comma-delimited FHIR resource types. If provided, only resources
+        #   of the specified resource type(s) are returned.
         # @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.
@@ -2520,13 +3049,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 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)
+        def patient_project_location_dataset_fhir_store_fhir_everything(name, _count: nil, _page_token: nil, _since: nil, _type: 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['_since'] = _since unless _since.nil?
+          command.query['_type'] = _type unless _type.nil?
           command.query['end'] = end_ unless end_.nil?
           command.query['start'] = start unless start.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -2538,6 +3069,10 @@ module Google
         # version) from the FHIR store. To remove all versions of a resource, first
         # delete the current version and then call this method.
         # This is not a FHIR standard operation.
+        # For samples that show how to call `Resource-purge`, see
+        # [Deleting historical versions of a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#
+        # deleting_historical_versions_of_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to purge.
         # @param [String] fields
@@ -2629,6 +3164,10 @@ module Google
         # purge method.
         # This method requires the`healthcare.fhirStores.searchResources` and
         # `healthcare.fhirResources.delete` permissions on the parent FHIR store.
+        # For samples that show how to call `conditionalDelete`, see
+        # [Conditionally deleting a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#
+        # conditionally_deleting_a_fhir_resource).
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
@@ -2688,6 +3227,10 @@ module Google
         # 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.
+        # For samples that show how to call `conditionalPatch`, see
+        # [Conditionally patching a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#
+        # conditionally_patching_a_fhir_resource).
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
@@ -2754,6 +3297,10 @@ module Google
         # GCP error might be returned instead.
         # This method requires the`healthcare.fhirStores.searchResources` and
         # `healthcare.fhirResources.update` permissions on the parent FHIR store.
+        # For samples that show how to call `conditionalUpdate`, see
+        # [Conditionally updating a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#
+        # conditionally_updating_a_fhir_resource).
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
@@ -2816,6 +3363,9 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `create`, see
+        # [Creating a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#creating_a_fhir_resource).
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
@@ -2867,6 +3417,9 @@ module Google
         # repository that can still be retrieved through vread
         # and related methods, unless they are removed by the
         # purge method.
+        # For samples that show how to call `delete`, see
+        # [Deleting a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#deleting_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to delete.
         # @param [String] fields
@@ -2927,6 +3480,9 @@ module Google
         # 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.
+        # For samples that show how to call `executeBundle`, see
+        # [Managing FHIR resources using FHIR
+        # bundles](/healthcare/docs/how-tos/fhir-bundles).
         # @param [String] parent
         #   Name of the FHIR store in which this bundle will be executed.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
@@ -2972,6 +3528,10 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `history`, see
+        # [Listing FHIR resource
+        # versions](/healthcare/docs/how-tos/fhir-resources#
+        # listing_fhir_resource_versions).
         # @param [String] name
         #   The name of the resource to retrieve.
         # @param [String] _at
@@ -3044,6 +3604,9 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `patch`, see
+        # [Patching a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#patching_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to update.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
@@ -3093,6 +3656,9 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `read`, see
+        # [Getting a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#getting_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to retrieve.
         # @param [String] fields
@@ -3172,6 +3738,9 @@ module Google
         # Note: FHIR resources are indexed asynchronously, so there might be a slight
         # delay between the time a resource is created or changes and when the change
         # is reflected in search results.
+        # For samples and detailed information, see [Searching for FHIR
+        # resources](/healthcare/docs/how-tos/fhir-search) and [Advanced FHIR search
+        # features](/healthcare/docs/how-tos/fhir-advanced-search).
         # @param [String] parent
         #   Name of the FHIR store to retrieve resources from.
         # @param [Google::Apis::HealthcareV1beta1::SearchResourcesRequest] search_resources_request_object
@@ -3223,6 +3792,9 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `update`, see
+        # [Updating a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#updating_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to update.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
@@ -3267,6 +3839,10 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `vread`, see
+        # [Retrieving a FHIR resource
+        # version](/healthcare/docs/how-tos/fhir-resources#
+        # retrieving_a_fhir_resource_version).
         # @param [String] name
         #   The name of the resource version to retrieve.
         # @param [String] fields