google-api-client 0.9.pre3 → 0.9.pre4

data/generated/google/apis/genomics_v1/representations.rb

@@ -38,6 +38,30 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
       
+      class SetIamPolicyRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Policy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Binding
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class GetIamPolicyRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class TestIamPermissionsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class TestIamPermissionsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
       class Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
@@ -122,6 +146,14 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
       
+      class StreamReadsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class StreamReadsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
       class SearchReferenceSetsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
@@ -194,10 +226,6 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
       
-      class MergeVariantsRequest
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      end
-      
       class SearchCallSetsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
@@ -210,6 +238,14 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
       
+      class StreamVariantsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class StreamVariantsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
       class ImportReadGroupSetsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
@@ -257,6 +293,52 @@ module Google
         end
       end
       
+      class SetIamPolicyRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :policy, as: 'policy', class: Google::Apis::GenomicsV1::Policy, decorator: Google::Apis::GenomicsV1::Policy::Representation
+      
+        end
+      end
+      
+      class Policy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :version, as: 'version'
+          collection :bindings, as: 'bindings', class: Google::Apis::GenomicsV1::Binding, decorator: Google::Apis::GenomicsV1::Binding::Representation
+      
+          property :etag, :base64 => true, as: 'etag'
+        end
+      end
+      
+      class Binding
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :role, as: 'role'
+          collection :members, as: 'members'
+        end
+      end
+      
+      class GetIamPolicyRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class TestIamPermissionsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :permissions, as: 'permissions'
+        end
+      end
+      
+      class TestIamPermissionsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :permissions, as: 'permissions'
+        end
+      end
+      
       class Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -500,6 +582,25 @@ module Google
         end
       end
       
+      class StreamReadsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :project_id, as: 'projectId'
+          property :read_group_set_id, as: 'readGroupSetId'
+          property :reference_name, as: 'referenceName'
+          property :start, as: 'start'
+          property :end, as: 'end'
+        end
+      end
+      
+      class StreamReadsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :alignments, as: 'alignments', class: Google::Apis::GenomicsV1::Read, decorator: Google::Apis::GenomicsV1::Read::Representation
+      
+        end
+      end
+      
       class SearchReferenceSetsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -591,6 +692,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :dataset_id, as: 'datasetId'
           property :id, as: 'id'
+          property :reference_set_id, as: 'referenceSetId'
           collection :reference_bounds, as: 'referenceBounds', class: Google::Apis::GenomicsV1::ReferenceBound, decorator: Google::Apis::GenomicsV1::ReferenceBound::Representation
       
           collection :metadata, as: 'metadata', class: Google::Apis::GenomicsV1::VariantSetMetadata, decorator: Google::Apis::GenomicsV1::VariantSetMetadata::Representation
@@ -716,15 +818,6 @@ module Google
         end
       end
       
-      class MergeVariantsRequest
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :variant_set_id, as: 'variantSetId'
-          collection :variants, as: 'variants', class: Google::Apis::GenomicsV1::Variant, decorator: Google::Apis::GenomicsV1::Variant::Representation
-      
-        end
-      end
-      
       class SearchCallSetsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -760,6 +853,26 @@ module Google
         end
       end
       
+      class StreamVariantsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :project_id, as: 'projectId'
+          property :variant_set_id, as: 'variantSetId'
+          collection :call_set_ids, as: 'callSetIds'
+          property :reference_name, as: 'referenceName'
+          property :start, as: 'start'
+          property :end, as: 'end'
+        end
+      end
+      
+      class StreamVariantsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :variants, as: 'variants', class: Google::Apis::GenomicsV1::Variant, decorator: Google::Apis::GenomicsV1::Variant::Representation
+      
+        end
+      end
+      
       class ImportReadGroupSetsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -22,8 +22,10 @@ module Google
     module GenomicsV1
       # Genomics API
       #
-      # An API to store, process, explore, and share DNA sequence reads, reference-
-      #  based alignments, and variant calls.
+      # An API to store, process, explore, and share genomic data. It supports
+      #  reference-based alignements, genetic variants, and reference genomes. This API
+      #  provides an implementation of the Global Alliance for Genomics and Health (
+      #  GA4GH) v0.5.1 API as well as several extensions.
       #
       # @example
       #    require 'google/apis/genomics_v1'
@@ -47,11 +49,13 @@ module Google
           super('https://genomics.googleapis.com/', '')
         end
         
-        # Lists datasets within a project.
+        # Lists datasets within a project. For the definitions of datasets and other
+        # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
+        # com/genomics/fundamentals-of-google-genomics)
         # @param [String] project_id
         #   Required. The project to list datasets for.
         # @param [Fixnum] page_size
-        #   The maximum number of results returned by this request. If unspecified,
+        #   The maximum number of results to return in a single page. If unspecified,
         #   defaults to 50. The maximum value is 1024.
         # @param [String] page_token
         #   The continuation token, which is used to page through large result sets. To
@@ -75,8 +79,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def list_datasets(project_id: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/datasets'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/datasets', options)
           command.response_representation = Google::Apis::GenomicsV1::ListDatasetsResponse::Representation
           command.response_class = Google::Apis::GenomicsV1::ListDatasetsResponse
           command.query['projectId'] = project_id unless project_id.nil?
@@ -87,7 +90,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new dataset.
+        # Creates a new dataset. For the definitions of datasets and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics)
         # @param [Google::Apis::GenomicsV1::Dataset] dataset_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -107,8 +112,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def create_dataset(dataset_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/datasets'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/datasets', options)
           command.request_representation = Google::Apis::GenomicsV1::Dataset::Representation
           command.request_object = dataset_object
           command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
@@ -118,7 +122,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a dataset by ID.
+        # Gets a dataset by ID. For the definitions of datasets and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics)
         # @param [String] dataset_id
         #   The ID of the dataset.
         # @param [String] fields
@@ -139,8 +145,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_dataset(dataset_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/datasets/{datasetId}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/datasets/{datasetId}', options)
           command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
           command.response_class = Google::Apis::GenomicsV1::Dataset
           command.params['datasetId'] = dataset_id unless dataset_id.nil?
@@ -149,14 +154,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a dataset. This method supports patch semantics.
+        # Updates a dataset. For the definitions of datasets and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics) This method supports patch semantics.
         # @param [String] dataset_id
         #   The ID of the dataset to be updated.
         # @param [Google::Apis::GenomicsV1::Dataset] dataset_object
         # @param [String] update_mask
         #   An optional mask specifying which fields to update. At this time, the only
-        #   mutable field is [name][google.genomics.v1.Dataset.name]. The only acceptable
-        #   value is "name". If unspecified, all mutable fields will be updated.
+        #   mutable field is name. The only acceptable value is "name". If unspecified,
+        #   all mutable fields will be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -175,8 +182,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def patch_dataset(dataset_id, dataset_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/datasets/{datasetId}'
-          command =  make_simple_command(:patch, path, options)
+          command =  make_simple_command(:patch, 'v1/datasets/{datasetId}', options)
           command.request_representation = Google::Apis::GenomicsV1::Dataset::Representation
           command.request_object = dataset_object
           command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
@@ -188,7 +194,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a dataset.
+        # Deletes a dataset. For the definitions of datasets and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics)
         # @param [String] dataset_id
         #   The ID of the dataset to be deleted.
         # @param [String] fields
@@ -209,8 +217,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def delete_dataset(dataset_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/datasets/{datasetId}'
-          command =  make_simple_command(:delete, path, options)
+          command =  make_simple_command(:delete, 'v1/datasets/{datasetId}', options)
           command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
           command.response_class = Google::Apis::GenomicsV1::Empty
           command.params['datasetId'] = dataset_id unless dataset_id.nil?
@@ -219,8 +226,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Undeletes a dataset by restoring a dataset which was deleted via this API.
-        # This operation is only possible for a week after the deletion occurred.
+        # Undeletes a dataset by restoring a dataset which was deleted via this API. For
+        # the definitions of datasets and other genomics resources, see [Fundamentals of
+        # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
+        # genomics) This operation is only possible for a week after the deletion
+        # occurred.
         # @param [String] dataset_id
         #   The ID of the dataset to be undeleted.
         # @param [Google::Apis::GenomicsV1::UndeleteDatasetRequest] undelete_dataset_request_object
@@ -242,8 +252,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def undelete_dataset(dataset_id, undelete_dataset_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/datasets/{datasetId}:undelete'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/datasets/{datasetId}:undelete', options)
           command.request_representation = Google::Apis::GenomicsV1::UndeleteDatasetRequest::Representation
           command.request_object = undelete_dataset_request_object
           command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
@@ -254,6 +263,118 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Sets the access control policy on the specified dataset. Replaces any existing
+        # policy. For the definitions of datasets and other genomics resources, see [
+        # Fundamentals of Google Genomics](https://cloud.google.com/genomics/
+        # fundamentals-of-google-genomics) See Setting a Policy for more information.
+        # @param [String] resource
+        #   REQUIRED: The resource for which policy is being specified. Format is `
+        #   datasets/`.
+        # @param [Google::Apis::GenomicsV1::SetIamPolicyRequest] set_iam_policy_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GenomicsV1::Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GenomicsV1::Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def set_dataset_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
+          command.request_representation = Google::Apis::GenomicsV1::SetIamPolicyRequest::Representation
+          command.request_object = set_iam_policy_request_object
+          command.response_representation = Google::Apis::GenomicsV1::Policy::Representation
+          command.response_class = Google::Apis::GenomicsV1::Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the access control policy for the dataset. This is empty if the policy or
+        # resource does not exist. See Getting a Policy for more information. For the
+        # definitions of datasets and other genomics resources, see [Fundamentals of
+        # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
+        # genomics)
+        # @param [String] resource
+        #   REQUIRED: The resource for which policy is being specified. Format is `
+        #   datasets/`.
+        # @param [Google::Apis::GenomicsV1::GetIamPolicyRequest] get_iam_policy_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GenomicsV1::Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GenomicsV1::Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_dataset_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+resource}:getIamPolicy', options)
+          command.request_representation = Google::Apis::GenomicsV1::GetIamPolicyRequest::Representation
+          command.request_object = get_iam_policy_request_object
+          command.response_representation = Google::Apis::GenomicsV1::Policy::Representation
+          command.response_class = Google::Apis::GenomicsV1::Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns permissions that a caller has on the specified resource. See Testing
+        # Permissions for more information. For the definitions of datasets and other
+        # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
+        # com/genomics/fundamentals-of-google-genomics)
+        # @param [String] resource
+        #   REQUIRED: The resource for which policy is being specified. Format is `
+        #   datasets/`.
+        # @param [Google::Apis::GenomicsV1::TestIamPermissionsRequest] test_iam_permissions_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GenomicsV1::TestIamPermissionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GenomicsV1::TestIamPermissionsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def test_dataset_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
+          command.request_representation = Google::Apis::GenomicsV1::TestIamPermissionsRequest::Representation
+          command.request_object = test_iam_permissions_request_object
+          command.response_representation = Google::Apis::GenomicsV1::TestIamPermissionsResponse::Representation
+          command.response_class = Google::Apis::GenomicsV1::TestIamPermissionsResponse
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the latest state of a long-running operation. Clients can use this method
         # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
@@ -276,8 +397,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/{+name}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
           command.response_class = Google::Apis::GenomicsV1::Operation
           command.params['name'] = name unless name.nil?
@@ -290,13 +410,12 @@ module Google
         # @param [String] name
         #   The name of the operation collection.
         # @param [String] filter
-        #   A string for filtering [Operations][google.longrunning.Operation]. The
-        #   following filter fields are supported: * projectId: Required. Corresponds to [
-        #   OperationMetadata.projectId][google.genomics.v1.OperationMetadata.project_id].
-        #   * createTime: The time this job was created, in seconds from the [epoch](http:/
-        #   /en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `= 1432140000` * `
-        #   projectId = my-project AND createTime >= 1432140000 AND createTime <=
-        #   1432150000 AND status = RUNNING`
+        #   A string for filtering Operations. The following filter fields are supported: *
+        #   projectId: Required. Corresponds to OperationMetadata.projectId. * createTime:
+        #   The time this job was created, in seconds from the [epoch](http://en.
+        #   wikipedia.org/wiki/Unix_time). Can use `>=` and/or `= 1432140000` * `projectId
+        #   = my-project AND createTime >= 1432140000 AND createTime <= 1432150000 AND
+        #   status = RUNNING`
         # @param [Fixnum] page_size
         #   The maximum number of results to return. If unspecified, defaults to 256. The
         #   maximum value is 2048.
@@ -320,8 +439,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def list_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/{+name}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::GenomicsV1::ListOperationsResponse::Representation
           command.response_class = Google::Apis::GenomicsV1::ListOperationsResponse
           command.params['name'] = name unless name.nil?
@@ -335,10 +453,8 @@ module Google
         
         # Starts asynchronous cancellation on a long-running operation. The server makes
         # a best effort to cancel the operation, but success is not guaranteed. Clients
-        # may use [Operations.GetOperation][google.longrunning.Operations.GetOperation]
-        # or [Operations.ListOperations][google.longrunning.Operations.ListOperations]
-        # to check whether the cancellation succeeded or the operation completed despite
-        # cancellation.
+        # may use Operations.GetOperation or Operations.ListOperations to check whether
+        # the cancellation succeeded or the operation completed despite cancellation.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
         # @param [Google::Apis::GenomicsV1::CancelOperationRequest] cancel_operation_request_object
@@ -360,8 +476,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/{+name}:cancel'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/{+name}:cancel', options)
           command.request_representation = Google::Apis::GenomicsV1::CancelOperationRequest::Representation
           command.request_object = cancel_operation_request_object
           command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
@@ -372,42 +487,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # This method is not implemented. To cancel an operation, please use [Operations.
-        # CancelOperation][google.longrunning.Operations.CancelOperation].
-        # @param [String] name
-        #   The name of the operation resource to be deleted.
-        # @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::GenomicsV1::Empty] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::GenomicsV1::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_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/{+name}'
-          command =  make_simple_command(:delete, path, options)
-          command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
-          command.response_class = Google::Apis::GenomicsV1::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
-        
         # Creates read group sets by asynchronously importing the provided information.
-        # Note that currently comments in the input file header are **not** imported and
-        # some custom tags will be converted to strings, rather than preserving tag
-        # types. The caller must have WRITE permissions to the dataset.
+        # For the definitions of read group sets and other genomics resources, see [
+        # Fundamentals of Google Genomics](https://cloud.google.com/genomics/
+        # fundamentals-of-google-genomics) The caller must have WRITE permissions to the
+        # dataset. ## Notes on [BAM](https://samtools.github.io/hts-specs/SAMv1.pdf)
+        # import - Tags will be converted to strings - tag types are not preserved -
+        # Comments (`@CO`) in the input file header will not be preserved - Original
+        # header order of references (`@SQ`) will not be preserved - Any reverse
+        # stranded unmapped reads will be reverse complemented, and their qualities (and
+        # "BQ" tag, if any) will be reversed - Unmapped reads will be stripped of
+        # positional information (reference name and position)
         # @param [Google::Apis::GenomicsV1::ImportReadGroupSetsRequest] import_read_group_sets_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -427,8 +517,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def import_read_group_sets(import_read_group_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/readgroupsets:import'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/readgroupsets:import', options)
           command.request_representation = Google::Apis::GenomicsV1::ImportReadGroupSetsRequest::Representation
           command.request_object = import_read_group_sets_request_object
           command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
@@ -438,13 +527,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Exports a read group set to a BAM file in Google Cloud Storage. Note that
-        # currently there may be some differences between exported BAM files and the
-        # original BAM file at the time of import. In particular, comments in the input
-        # file header will not be preserved, some custom tags will be converted to
-        # strings, and original reference sequence order is not necessarily preserved.
+        # Exports a read group set to a BAM file in Google Cloud Storage. For the
+        # definitions of read group sets and other genomics resources, see [Fundamentals
+        # of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
+        # genomics) Note that currently there may be some differences between exported
+        # BAM files and the original BAM file at the time of import. See [
+        # ImportReadGroupSets](google.genomics.v1.ReadServiceV1.ImportReadGroupSets) for
+        # caveats.
         # @param [String] read_group_set_id
-        #   Required. The ID of the read group set to export.
+        #   Required. The ID of the read group set to export. The caller must have READ
+        #   access to this read group set.
         # @param [Google::Apis::GenomicsV1::ExportReadGroupSetRequest] export_read_group_set_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -464,8 +556,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def export_read_group_sets(read_group_set_id, export_read_group_set_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/readgroupsets/{readGroupSetId}:export'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/readgroupsets/{readGroupSetId}:export', options)
           command.request_representation = Google::Apis::GenomicsV1::ExportReadGroupSetRequest::Representation
           command.request_object = export_read_group_set_request_object
           command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
@@ -476,9 +567,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches for read group sets matching the criteria. Implements [
-        # GlobalAllianceApi.searchReadGroupSets](https://github.com/ga4gh/schemas/blob/
-        # v0.5.1/src/main/resources/avro/readmethods.avdl#L135).
+        # Searches for read group sets matching the criteria. For the definitions of
+        # read group sets and other genomics resources, see [Fundamentals of Google
+        # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+        # Implements [GlobalAllianceApi.searchReadGroupSets](https://github.com/ga4gh/
+        # schemas/blob/v0.5.1/src/main/resources/avro/readmethods.avdl#L135).
         # @param [Google::Apis::GenomicsV1::SearchReadGroupSetsRequest] search_read_group_sets_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -498,8 +591,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def search_read_group_sets(search_read_group_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/readgroupsets/search'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/readgroupsets/search', options)
           command.request_representation = Google::Apis::GenomicsV1::SearchReadGroupSetsRequest::Representation
           command.request_object = search_read_group_sets_request_object
           command.response_representation = Google::Apis::GenomicsV1::SearchReadGroupSetsResponse::Representation
@@ -509,16 +601,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a read group set. This method supports patch semantics.
+        # Updates a read group set. For the definitions of read group sets and other
+        # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
+        # com/genomics/fundamentals-of-google-genomics) This method supports patch
+        # semantics.
         # @param [String] read_group_set_id
         #   The ID of the read group set to be updated. The caller must have WRITE
         #   permissions to the dataset associated with this read group set.
         # @param [Google::Apis::GenomicsV1::ReadGroupSet] read_group_set_object
         # @param [String] update_mask
-        #   An optional mask specifying which fields to update. At this time, mutable
-        #   fields are [referenceSetId][google.genomics.v1.ReadGroupSet.reference_set_id]
-        #   and [name][google.genomics.v1.ReadGroupSet.name]. Acceptable values are "
-        #   referenceSetId" and "name". If unspecified, all mutable fields will be updated.
+        #   An optional mask specifying which fields to update. Supported fields: * name. *
+        #   referenceSetId. Leaving `updateMask` unset is equivalent to specifying all
+        #   mutable fields.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -537,8 +631,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def patch_read_group_set(read_group_set_id, read_group_set_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/readgroupsets/{readGroupSetId}'
-          command =  make_simple_command(:patch, path, options)
+          command =  make_simple_command(:patch, 'v1/readgroupsets/{readGroupSetId}', options)
           command.request_representation = Google::Apis::GenomicsV1::ReadGroupSet::Representation
           command.request_object = read_group_set_object
           command.response_representation = Google::Apis::GenomicsV1::ReadGroupSet::Representation
@@ -550,7 +643,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a read group set.
+        # Deletes a read group set. For the definitions of read group sets and other
+        # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
+        # com/genomics/fundamentals-of-google-genomics)
         # @param [String] read_group_set_id
         #   The ID of the read group set to be deleted. The caller must have WRITE
         #   permissions to the dataset associated with this read group set.
@@ -572,8 +667,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def delete_read_group_set(read_group_set_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/readgroupsets/{readGroupSetId}'
-          command =  make_simple_command(:delete, path, options)
+          command =  make_simple_command(:delete, 'v1/readgroupsets/{readGroupSetId}', options)
           command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
           command.response_class = Google::Apis::GenomicsV1::Empty
           command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
@@ -582,7 +676,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a read group set by ID.
+        # Gets a read group set by ID. For the definitions of read group sets and other
+        # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
+        # com/genomics/fundamentals-of-google-genomics)
         # @param [String] read_group_set_id
         #   The ID of the read group set.
         # @param [String] fields
@@ -603,8 +699,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_read_group_set(read_group_set_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/readgroupsets/{readGroupSetId}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/readgroupsets/{readGroupSetId}', options)
           command.response_representation = Google::Apis::GenomicsV1::ReadGroupSet::Representation
           command.response_class = Google::Apis::GenomicsV1::ReadGroupSet
           command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
@@ -615,11 +710,13 @@ module Google
         
         # Lists fixed width coverage buckets for a read group set, each of which
         # correspond to a range of a reference sequence. Each bucket summarizes coverage
-        # information across its corresponding genomic range. Coverage is defined as the
-        # number of reads which are aligned to a given base in the reference sequence.
-        # Coverage buckets are available at several precomputed bucket widths, enabling
-        # retrieval of various coverage 'zoom levels'. The caller must have READ
-        # permissions for the target read group set.
+        # information across its corresponding genomic range. For the definitions of
+        # read group sets and other genomics resources, see [Fundamentals of Google
+        # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+        # Coverage is defined as the number of reads which are aligned to a given base
+        # in the reference sequence. Coverage buckets are available at several
+        # precomputed bucket widths, enabling retrieval of various coverage 'zoom levels'
+        # . The caller must have READ permissions for the target read group set.
         # @param [String] read_group_set_id
         #   Required. The ID of the read group set over which coverage is requested.
         # @param [String] reference_name
@@ -664,8 +761,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def list_coverage_buckets(read_group_set_id, reference_name: nil, start: nil, end_: nil, target_bucket_width: nil, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/readgroupsets/{readGroupSetId}/coveragebuckets'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/readgroupsets/{readGroupSetId}/coveragebuckets', options)
           command.response_representation = Google::Apis::GenomicsV1::ListCoverageBucketsResponse::Representation
           command.response_class = Google::Apis::GenomicsV1::ListCoverageBucketsResponse
           command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
@@ -680,17 +776,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a list of reads for one or more read group sets. Reads search operates
-        # over a genomic coordinate space of reference sequence & position defined over
-        # the reference sequences to which the requested read group sets are aligned. If
-        # a target positional range is specified, search returns all reads whose
-        # alignment to the reference genome overlap the range. A query which specifies
-        # only read group set IDs yields all reads in those read group sets, including
-        # unmapped reads. All reads returned (including reads on subsequent pages) are
-        # ordered by genomic coordinate (reference sequence & position). Reads with
-        # equivalent genomic coordinates are returned in a deterministic order.
-        # Implements [GlobalAllianceApi.searchReads](https://github.com/ga4gh/schemas/
-        # blob/v0.5.1/src/main/resources/avro/readmethods.avdl#L85).
+        # Gets a list of reads for one or more read group sets. For the definitions of
+        # read group sets and other genomics resources, see [Fundamentals of Google
+        # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+        # Reads search operates over a genomic coordinate space of reference sequence &
+        # position defined over the reference sequences to which the requested read
+        # group sets are aligned. If a target positional range is specified, search
+        # returns all reads whose alignment to the reference genome overlap the range. A
+        # query which specifies only read group set IDs yields all reads in those read
+        # group sets, including unmapped reads. All reads returned (including reads on
+        # subsequent pages) are ordered by genomic coordinate (by reference sequence,
+        # then position). Reads with equivalent genomic coordinates are returned in an
+        # unspecified order. This order is consistent, such that two queries for the
+        # same content (regardless of page size) yield reads in the same order across
+        # their respective streams of paginated responses. Implements [GlobalAllianceApi.
+        # searchReads](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/
+        # avro/readmethods.avdl#L85).
         # @param [Google::Apis::GenomicsV1::SearchReadsRequest] search_reads_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -710,8 +811,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def search_reads(search_reads_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/reads/search'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/reads/search', options)
           command.request_representation = Google::Apis::GenomicsV1::SearchReadsRequest::Representation
           command.request_object = search_reads_request_object
           command.response_representation = Google::Apis::GenomicsV1::SearchReadsResponse::Representation
@@ -721,9 +821,43 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches for reference sets which match the given criteria. Implements [
-        # GlobalAllianceApi.searchReferenceSets](http://ga4gh.org/documentation/api/v0.5.
-        # 1/ga4gh_api.html#/schema/org.ga4gh.searchReferenceSets).
+        # Returns a stream of all the reads matching the search request, ordered by
+        # reference name, position, and ID.
+        # @param [Google::Apis::GenomicsV1::StreamReadsRequest] stream_reads_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::GenomicsV1::StreamReadsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GenomicsV1::StreamReadsResponse]
+        #
+        # @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 stream_reads(stream_reads_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/reads:stream', options)
+          command.request_representation = Google::Apis::GenomicsV1::StreamReadsRequest::Representation
+          command.request_object = stream_reads_request_object
+          command.response_representation = Google::Apis::GenomicsV1::StreamReadsResponse::Representation
+          command.response_class = Google::Apis::GenomicsV1::StreamReadsResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Searches for reference sets which match the given criteria. For the
+        # definitions of references and other genomics resources, see [Fundamentals of
+        # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
+        # genomics) Implements [GlobalAllianceApi.searchReferenceSets](https://github.
+        # com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/referencemethods.avdl#
+        # L71)
         # @param [Google::Apis::GenomicsV1::SearchReferenceSetsRequest] search_reference_sets_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -743,8 +877,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def search_reference_sets(search_reference_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/referencesets/search'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/referencesets/search', options)
           command.request_representation = Google::Apis::GenomicsV1::SearchReferenceSetsRequest::Representation
           command.request_object = search_reference_sets_request_object
           command.response_representation = Google::Apis::GenomicsV1::SearchReferenceSetsResponse::Representation
@@ -754,9 +887,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a reference set. Implements [GlobalAllianceApi.getReferenceSet](https://
-        # github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/referencemethods.
-        # avdl#L83).
+        # Gets a reference set. For the definitions of references and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics) Implements [GlobalAllianceApi.
+        # getReferenceSet](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/
+        # resources/avro/referencemethods.avdl#L83).
         # @param [String] reference_set_id
         #   The ID of the reference set.
         # @param [String] fields
@@ -777,8 +912,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_reference_set(reference_set_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/referencesets/{referenceSetId}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/referencesets/{referenceSetId}', options)
           command.response_representation = Google::Apis::GenomicsV1::ReferenceSet::Representation
           command.response_class = Google::Apis::GenomicsV1::ReferenceSet
           command.params['referenceSetId'] = reference_set_id unless reference_set_id.nil?
@@ -787,7 +921,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches for references which match the given criteria. Implements [
+        # Searches for references which match the given criteria. For the definitions of
+        # references and other genomics resources, see [Fundamentals of Google Genomics](
+        # https://cloud.google.com/genomics/fundamentals-of-google-genomics) Implements [
         # GlobalAllianceApi.searchReferences](https://github.com/ga4gh/schemas/blob/v0.5.
         # 1/src/main/resources/avro/referencemethods.avdl#L146).
         # @param [Google::Apis::GenomicsV1::SearchReferencesRequest] search_references_request_object
@@ -809,8 +945,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def search_references(search_references_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/references/search'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/references/search', options)
           command.request_representation = Google::Apis::GenomicsV1::SearchReferencesRequest::Representation
           command.request_object = search_references_request_object
           command.response_representation = Google::Apis::GenomicsV1::SearchReferencesResponse::Representation
@@ -820,9 +955,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a reference. Implements [GlobalAllianceApi.getReference](https://github.
-        # com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/referencemethods.avdl#
-        # L158).
+        # Gets a reference. For the definitions of references and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics) Implements [GlobalAllianceApi.
+        # getReference](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/
+        # avro/referencemethods.avdl#L158).
         # @param [String] reference_id
         #   The ID of the reference.
         # @param [String] fields
@@ -843,8 +980,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_reference(reference_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/references/{referenceId}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/references/{referenceId}', options)
           command.response_representation = Google::Apis::GenomicsV1::Reference::Representation
           command.response_class = Google::Apis::GenomicsV1::Reference
           command.params['referenceId'] = reference_id unless reference_id.nil?
@@ -853,9 +989,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the bases in a reference, optionally restricted to a range. Implements [
-        # GlobalAllianceApi.getReferenceBases](https://github.com/ga4gh/schemas/blob/v0.
-        # 5.1/src/main/resources/avro/referencemethods.avdl#L221).
+        # Lists the bases in a reference, optionally restricted to a range. For the
+        # definitions of references and other genomics resources, see [Fundamentals of
+        # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
+        # genomics) Implements [GlobalAllianceApi.getReferenceBases](https://github.com/
+        # ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/referencemethods.avdl#L221).
         # @param [String] reference_id
         #   The ID of the reference.
         # @param [String] start_position
@@ -868,7 +1006,9 @@ module Google
         #   get the next page of results, set this parameter to the value of `
         #   nextPageToken` from the previous response.
         # @param [Fixnum] page_size
-        #   Specifies the maximum number of bases to return in a single page.
+        #   The maximum number of bases to return in a single page. If unspecified,
+        #   defaults to 200Kbp (kilo base pairs). The maximum value is 10Mbp (mega base
+        #   pairs).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -887,8 +1027,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def list_reference_bases(reference_id, start_position: nil, end_position: nil, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/references/{referenceId}/bases'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/references/{referenceId}/bases', options)
           command.response_representation = Google::Apis::GenomicsV1::ListBasesResponse::Representation
           command.response_class = Google::Apis::GenomicsV1::ListBasesResponse
           command.params['referenceId'] = reference_id unless reference_id.nil?
@@ -901,14 +1040,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates variant data by asynchronously importing the provided information. The
-        # variants for import will be merged with any existing data and each other
-        # according to the behavior of mergeVariants. In particular, this means for
-        # merged VCF variants that have conflicting INFO fields, some data will be
-        # arbitrarily discarded. As a special case, for single-sample VCF files, QUAL
-        # and FILTER fields will be moved to the call level; these are sometimes
-        # interpreted in a call-specific context. Imported VCF headers are appended to
-        # the metadata already in a variant set.
+        # Creates variant data by asynchronously importing the provided information. For
+        # the definitions of variant sets and other genomics resources, see [
+        # Fundamentals of Google Genomics](https://cloud.google.com/genomics/
+        # fundamentals-of-google-genomics) The variants for import will be merged with
+        # any existing variant that matches its reference sequence, start, end,
+        # reference bases, and alternative bases. If no such variant exists, a new one
+        # will be created. When variants are merged, the call information from the new
+        # variant is added to the existing variant, and other fields (such as key/value
+        # pairs) are discarded. In particular, this means for merged VCF variants that
+        # have conflicting INFO fields, some data will be arbitrarily discarded. As a
+        # special case, for single-sample VCF files, QUAL and FILTER fields will be
+        # moved to the call level; these are sometimes interpreted in a call-specific
+        # context. Imported VCF headers are appended to the metadata already in a
+        # variant set.
         # @param [Google::Apis::GenomicsV1::ImportVariantsRequest] import_variants_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -928,8 +1073,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def import_variants(import_variants_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variants:import'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/variants:import', options)
           command.request_representation = Google::Apis::GenomicsV1::ImportVariantsRequest::Representation
           command.request_object = import_variants_request_object
           command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
@@ -939,9 +1083,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a list of variants matching the criteria. Implements [GlobalAllianceApi.
-        # searchVariants](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/
-        # resources/avro/variantmethods.avdl#L126).
+        # Gets a list of variants matching the criteria. For the definitions of variants
+        # and other genomics resources, see [Fundamentals of Google Genomics](https://
+        # cloud.google.com/genomics/fundamentals-of-google-genomics) Implements [
+        # GlobalAllianceApi.searchVariants](https://github.com/ga4gh/schemas/blob/v0.5.1/
+        # src/main/resources/avro/variantmethods.avdl#L126).
         # @param [Google::Apis::GenomicsV1::SearchVariantsRequest] search_variants_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -961,8 +1107,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def search_variants(search_variants_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variants/search'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/variants/search', options)
           command.request_representation = Google::Apis::GenomicsV1::SearchVariantsRequest::Representation
           command.request_object = search_variants_request_object
           command.response_representation = Google::Apis::GenomicsV1::SearchVariantsResponse::Representation
@@ -972,7 +1117,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new variant.
+        # Creates a new variant. For the definitions of variants and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics)
         # @param [Google::Apis::GenomicsV1::Variant] variant_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -992,8 +1139,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def create_variant(variant_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variants'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/variants', options)
           command.request_representation = Google::Apis::GenomicsV1::Variant::Representation
           command.request_object = variant_object
           command.response_representation = Google::Apis::GenomicsV1::Variant::Representation
@@ -1003,15 +1149,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a variant. This method supports patch semantics. Returns the modified
-        # variant without its calls.
+        # Updates a variant. For the definitions of variants and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics) This method supports patch semantics.
+        # Returns the modified variant without its calls.
         # @param [String] variant_id
         #   The ID of the variant to be updated.
         # @param [Google::Apis::GenomicsV1::Variant] variant_object
         # @param [String] update_mask
         #   An optional mask specifying which fields to update. At this time, mutable
-        #   fields are [names][google.genomics.v1.Variant.names] and [info][google.
-        #   genomics.v1.Variant.info]. Acceptable values are "names" and "info". If
+        #   fields are names and info. Acceptable values are "names" and "info". If
         #   unspecified, all mutable fields will be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1031,8 +1178,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def patch_variant(variant_id, variant_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variants/{variantId}'
-          command =  make_simple_command(:patch, path, options)
+          command =  make_simple_command(:patch, 'v1/variants/{variantId}', options)
           command.request_representation = Google::Apis::GenomicsV1::Variant::Representation
           command.request_object = variant_object
           command.response_representation = Google::Apis::GenomicsV1::Variant::Representation
@@ -1044,7 +1190,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a variant.
+        # Deletes a variant. For the definitions of variants and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics)
         # @param [String] variant_id
         #   The ID of the variant to be deleted.
         # @param [String] fields
@@ -1065,8 +1213,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def delete_variant(variant_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variants/{variantId}'
-          command =  make_simple_command(:delete, path, options)
+          command =  make_simple_command(:delete, 'v1/variants/{variantId}', options)
           command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
           command.response_class = Google::Apis::GenomicsV1::Empty
           command.params['variantId'] = variant_id unless variant_id.nil?
@@ -1075,7 +1222,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a variant by ID.
+        # Gets a variant by ID. For the definitions of variants and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics)
         # @param [String] variant_id
         #   The ID of the variant.
         # @param [String] fields
@@ -1096,8 +1245,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_variant(variant_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variants/{variantId}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/variants/{variantId}', options)
           command.response_representation = Google::Apis::GenomicsV1::Variant::Representation
           command.response_class = Google::Apis::GenomicsV1::Variant
           command.params['variantId'] = variant_id unless variant_id.nil?
@@ -1106,13 +1254,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Merges the given variants with existing variants. Each variant will be merged
-        # with an existing variant that matches its reference sequence, start, end,
-        # reference bases, and alternative bases. If no such variant exists, a new one
-        # will be created. When variants are merged, the call information from the new
-        # variant is added to the existing variant, and other fields (such as key/value
-        # pairs) are discarded.
-        # @param [Google::Apis::GenomicsV1::MergeVariantsRequest] merge_variants_request_object
+        # Returns a stream of all the variants matching the search request, ordered by
+        # reference name, position, and ID.
+        # @param [Google::Apis::GenomicsV1::StreamVariantsRequest] stream_variants_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1122,27 +1266,30 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
+        # @yieldparam result [Google::Apis::GenomicsV1::StreamVariantsResponse] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::GenomicsV1::Empty]
+        # @return [Google::Apis::GenomicsV1::StreamVariantsResponse]
         #
         # @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 merge_variants(merge_variants_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variants:merge'
-          command =  make_simple_command(:post, path, options)
-          command.request_representation = Google::Apis::GenomicsV1::MergeVariantsRequest::Representation
-          command.request_object = merge_variants_request_object
-          command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
-          command.response_class = Google::Apis::GenomicsV1::Empty
+        def stream_variants(stream_variants_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/variants:stream', options)
+          command.request_representation = Google::Apis::GenomicsV1::StreamVariantsRequest::Representation
+          command.request_object = stream_variants_request_object
+          command.response_representation = Google::Apis::GenomicsV1::StreamVariantsResponse::Representation
+          command.response_class = Google::Apis::GenomicsV1::StreamVariantsResponse
           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 variant set.
+        # Creates a new variant set. For the definitions of variant sets and other
+        # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
+        # com/genomics/fundamentals-of-google-genomics) The provided variant set must
+        # have a valid `datasetId` set - all other fields are optional. Note that the `
+        # id` field will be ignored, as this is assigned by the server.
         # @param [Google::Apis::GenomicsV1::VariantSet] variant_set_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1162,8 +1309,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def create_variantset(variant_set_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variantsets'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/variantsets', options)
           command.request_representation = Google::Apis::GenomicsV1::VariantSet::Representation
           command.request_object = variant_set_object
           command.response_representation = Google::Apis::GenomicsV1::VariantSet::Representation
@@ -1173,7 +1319,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Exports variant set data to an external destination.
+        # Exports variant set data to an external destination. For the definitions of
+        # variant sets and other genomics resources, see [Fundamentals of Google
+        # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
         # @param [String] variant_set_id
         #   Required. The ID of the variant set that contains variant data which should be
         #   exported. The caller must have READ access to this variant set.
@@ -1196,8 +1344,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def export_variant_set(variant_set_id, export_variant_set_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variantsets/{variantSetId}:export'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/variantsets/{variantSetId}:export', options)
           command.request_representation = Google::Apis::GenomicsV1::ExportVariantSetRequest::Representation
           command.request_object = export_variant_set_request_object
           command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
@@ -1208,7 +1355,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a variant set by ID.
+        # Gets a variant set by ID. For the definitions of variant sets and other
+        # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
+        # com/genomics/fundamentals-of-google-genomics)
         # @param [String] variant_set_id
         #   Required. The ID of the variant set.
         # @param [String] fields
@@ -1229,8 +1378,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_variantset(variant_set_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variantsets/{variantSetId}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/variantsets/{variantSetId}', options)
           command.response_representation = Google::Apis::GenomicsV1::VariantSet::Representation
           command.response_class = Google::Apis::GenomicsV1::VariantSet
           command.params['variantSetId'] = variant_set_id unless variant_set_id.nil?
@@ -1239,9 +1387,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of all variant sets matching search criteria. Implements [
-        # GlobalAllianceApi.searchVariantSets](https://github.com/ga4gh/schemas/blob/v0.
-        # 5.1/src/main/resources/avro/variantmethods.avdl#L49).
+        # Returns a list of all variant sets matching search criteria. For the
+        # definitions of variant sets and other genomics resources, see [Fundamentals of
+        # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
+        # genomics) Implements [GlobalAllianceApi.searchVariantSets](https://github.com/
+        # ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variantmethods.avdl#L49).
         # @param [Google::Apis::GenomicsV1::SearchVariantSetsRequest] search_variant_sets_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1261,8 +1411,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def search_variant_sets(search_variant_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variantsets/search'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/variantsets/search', options)
           command.request_representation = Google::Apis::GenomicsV1::SearchVariantSetsRequest::Representation
           command.request_object = search_variant_sets_request_object
           command.response_representation = Google::Apis::GenomicsV1::SearchVariantSetsResponse::Representation
@@ -1273,6 +1422,9 @@ module Google
         end
         
         # Deletes the contents of a variant set. The variant set object is not deleted.
+        # For the definitions of variant sets and other genomics resources, see [
+        # Fundamentals of Google Genomics](https://cloud.google.com/genomics/
+        # fundamentals-of-google-genomics)
         # @param [String] variant_set_id
         #   The ID of the variant set to be deleted.
         # @param [String] fields
@@ -1293,8 +1445,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def delete_variantset(variant_set_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variantsets/{variantSetId}'
-          command =  make_simple_command(:delete, path, options)
+          command =  make_simple_command(:delete, 'v1/variantsets/{variantSetId}', options)
           command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
           command.response_class = Google::Apis::GenomicsV1::Empty
           command.params['variantSetId'] = variant_set_id unless variant_set_id.nil?
@@ -1303,15 +1454,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a variant set. This method supports patch semantics.
+        # Updates a variant set using patch semantics. For the definitions of variant
+        # sets and other genomics resources, see [Fundamentals of Google Genomics](https:
+        # //cloud.google.com/genomics/fundamentals-of-google-genomics)
         # @param [String] variant_set_id
         #   The ID of the variant to be updated (must already exist).
         # @param [Google::Apis::GenomicsV1::VariantSet] variant_set_object
         # @param [String] update_mask
-        #   An optional mask specifying which fields to update. At this time, the only
-        #   mutable field is [metadata][google.genomics.v1.VariantSet.metadata]. The only
-        #   acceptable value is "metadata". If unspecified, all mutable fields will be
-        #   updated.
+        #   An optional mask specifying which fields to update. Supported fields: *
+        #   metadata. Leaving `updateMask` unset is equivalent to specifying all mutable
+        #   fields.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1330,8 +1482,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def patch_variantset(variant_set_id, variant_set_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/variantsets/{variantSetId}'
-          command =  make_simple_command(:patch, path, options)
+          command =  make_simple_command(:patch, 'v1/variantsets/{variantSetId}', options)
           command.request_representation = Google::Apis::GenomicsV1::VariantSet::Representation
           command.request_object = variant_set_object
           command.response_representation = Google::Apis::GenomicsV1::VariantSet::Representation
@@ -1343,9 +1494,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a list of call sets matching the criteria. Implements [GlobalAllianceApi.
-        # searchCallSets](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/
-        # resources/avro/variantmethods.avdl#L178).
+        # Gets a list of call sets matching the criteria. For the definitions of call
+        # sets and other genomics resources, see [Fundamentals of Google Genomics](https:
+        # //cloud.google.com/genomics/fundamentals-of-google-genomics) Implements [
+        # GlobalAllianceApi.searchCallSets](https://github.com/ga4gh/schemas/blob/v0.5.1/
+        # src/main/resources/avro/variantmethods.avdl#L178).
         # @param [Google::Apis::GenomicsV1::SearchCallSetsRequest] search_call_sets_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1365,8 +1518,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def search_call_sets(search_call_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/callsets/search'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/callsets/search', options)
           command.request_representation = Google::Apis::GenomicsV1::SearchCallSetsRequest::Representation
           command.request_object = search_call_sets_request_object
           command.response_representation = Google::Apis::GenomicsV1::SearchCallSetsResponse::Representation
@@ -1376,7 +1528,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new call set.
+        # Creates a new call set. For the definitions of call sets and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics)
         # @param [Google::Apis::GenomicsV1::CallSet] call_set_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1396,8 +1550,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def create_call_set(call_set_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/callsets'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, 'v1/callsets', options)
           command.request_representation = Google::Apis::GenomicsV1::CallSet::Representation
           command.request_object = call_set_object
           command.response_representation = Google::Apis::GenomicsV1::CallSet::Representation
@@ -1407,14 +1560,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a call set. This method supports patch semantics.
+        # Updates a call set. For the definitions of call sets and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics) This method supports patch semantics.
         # @param [String] call_set_id
         #   The ID of the call set to be updated.
         # @param [Google::Apis::GenomicsV1::CallSet] call_set_object
         # @param [String] update_mask
         #   An optional mask specifying which fields to update. At this time, the only
-        #   mutable field is [name][google.genomics.v1.CallSet.name]. The only acceptable
-        #   value is "name". If unspecified, all mutable fields will be updated.
+        #   mutable field is name. The only acceptable value is "name". If unspecified,
+        #   all mutable fields will be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1433,8 +1588,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def patch_call_set(call_set_id, call_set_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/callsets/{callSetId}'
-          command =  make_simple_command(:patch, path, options)
+          command =  make_simple_command(:patch, 'v1/callsets/{callSetId}', options)
           command.request_representation = Google::Apis::GenomicsV1::CallSet::Representation
           command.request_object = call_set_object
           command.response_representation = Google::Apis::GenomicsV1::CallSet::Representation
@@ -1446,7 +1600,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a call set.
+        # Deletes a call set. For the definitions of call sets and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics)
         # @param [String] call_set_id
         #   The ID of the call set to be deleted.
         # @param [String] fields
@@ -1467,8 +1623,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def delete_call_set(call_set_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/callsets/{callSetId}'
-          command =  make_simple_command(:delete, path, options)
+          command =  make_simple_command(:delete, 'v1/callsets/{callSetId}', options)
           command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
           command.response_class = Google::Apis::GenomicsV1::Empty
           command.params['callSetId'] = call_set_id unless call_set_id.nil?
@@ -1477,7 +1632,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a call set by ID.
+        # Gets a call set by ID. For the definitions of call sets and other genomics
+        # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
+        # genomics/fundamentals-of-google-genomics)
         # @param [String] call_set_id
         #   The ID of the call set.
         # @param [String] fields
@@ -1498,8 +1655,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_call_set(call_set_id, fields: nil, quota_user: nil, options: nil, &block)
-          path = 'v1/callsets/{callSetId}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, 'v1/callsets/{callSetId}', options)
           command.response_representation = Google::Apis::GenomicsV1::CallSet::Representation
           command.response_class = Google::Apis::GenomicsV1::CallSet
           command.params['callSetId'] = call_set_id unless call_set_id.nil?