google-api-client 0.9.25 → 0.9.26

Sign up to get free protection for your applications and to get access to all the features.
Files changed (79) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +3 -0
  3. data/api_names.yaml +279 -0
  4. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  5. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +110 -110
  6. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +25 -25
  7. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +145 -145
  8. data/generated/google/apis/adsense_v1_4.rb +1 -1
  9. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  10. data/generated/google/apis/calendar_v3.rb +1 -1
  11. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  12. data/generated/google/apis/cloudbuild_v1/classes.rb +419 -419
  13. data/generated/google/apis/cloudbuild_v1/representations.rb +73 -73
  14. data/generated/google/apis/cloudbuild_v1/service.rb +86 -86
  15. data/generated/google/apis/cloudkms_v1beta1.rb +34 -0
  16. data/generated/google/apis/cloudkms_v1beta1/classes.rb +999 -0
  17. data/generated/google/apis/cloudkms_v1beta1/representations.rb +448 -0
  18. data/generated/google/apis/cloudkms_v1beta1/service.rb +932 -0
  19. data/generated/google/apis/cloudresourcemanager_v1.rb +4 -4
  20. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +478 -478
  21. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +96 -96
  22. data/generated/google/apis/cloudresourcemanager_v1/service.rb +271 -271
  23. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +4 -4
  24. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +353 -353
  25. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +81 -81
  26. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +299 -299
  27. data/generated/google/apis/container_v1.rb +1 -1
  28. data/generated/google/apis/container_v1/classes.rb +287 -16
  29. data/generated/google/apis/container_v1/representations.rb +113 -2
  30. data/generated/google/apis/container_v1/service.rb +130 -0
  31. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  32. data/generated/google/apis/drive_v2.rb +1 -1
  33. data/generated/google/apis/drive_v3.rb +1 -1
  34. data/generated/google/apis/genomics_v1.rb +8 -8
  35. data/generated/google/apis/genomics_v1/classes.rb +2259 -2257
  36. data/generated/google/apis/genomics_v1/representations.rb +461 -526
  37. data/generated/google/apis/genomics_v1/service.rb +1203 -1105
  38. data/generated/google/apis/gmail_v1.rb +1 -1
  39. data/generated/google/apis/logging_v2beta1.rb +1 -1
  40. data/generated/google/apis/logging_v2beta1/classes.rb +852 -852
  41. data/generated/google/apis/logging_v2beta1/representations.rb +168 -168
  42. data/generated/google/apis/logging_v2beta1/service.rb +230 -230
  43. data/generated/google/apis/manufacturers_v1.rb +34 -0
  44. data/generated/google/apis/manufacturers_v1/classes.rb +258 -0
  45. data/generated/google/apis/manufacturers_v1/representations.rb +103 -0
  46. data/generated/google/apis/manufacturers_v1/service.rb +138 -0
  47. data/generated/google/apis/monitoring_v3.rb +7 -7
  48. data/generated/google/apis/monitoring_v3/classes.rb +744 -744
  49. data/generated/google/apis/monitoring_v3/representations.rb +164 -164
  50. data/generated/google/apis/monitoring_v3/service.rb +335 -335
  51. data/generated/google/apis/plus_domains_v1.rb +1 -1
  52. data/generated/google/apis/plus_v1.rb +1 -1
  53. data/generated/google/apis/pubsub_v1.rb +3 -3
  54. data/generated/google/apis/pubsub_v1/classes.rb +325 -325
  55. data/generated/google/apis/pubsub_v1/representations.rb +80 -80
  56. data/generated/google/apis/pubsub_v1/service.rb +256 -256
  57. data/generated/google/apis/sheets_v4.rb +3 -3
  58. data/generated/google/apis/sheets_v4/classes.rb +4283 -4283
  59. data/generated/google/apis/sheets_v4/representations.rb +833 -833
  60. data/generated/google/apis/sheets_v4/service.rb +184 -184
  61. data/generated/google/apis/speech_v1beta1.rb +1 -1
  62. data/generated/google/apis/speech_v1beta1/classes.rb +213 -211
  63. data/generated/google/apis/speech_v1beta1/representations.rb +49 -49
  64. data/generated/google/apis/speech_v1beta1/service.rb +71 -71
  65. data/generated/google/apis/sqladmin_v1beta4.rb +1 -1
  66. data/generated/google/apis/sqladmin_v1beta4/classes.rb +20 -0
  67. data/generated/google/apis/sqladmin_v1beta4/representations.rb +2 -0
  68. data/generated/google/apis/vision_v1.rb +1 -1
  69. data/generated/google/apis/vision_v1/classes.rb +861 -859
  70. data/generated/google/apis/vision_v1/representations.rb +140 -140
  71. data/generated/google/apis/vision_v1/service.rb +4 -4
  72. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  73. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  74. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  75. data/generated/google/apis/youtubereporting_v1/classes.rb +139 -139
  76. data/generated/google/apis/youtubereporting_v1/representations.rb +36 -36
  77. data/generated/google/apis/youtubereporting_v1/service.rb +152 -152
  78. data/lib/google/apis/version.rb +1 -1
  79. metadata +9 -1
@@ -22,7 +22,7 @@ module Google
22
22
  module GenomicsV1
23
23
  # Genomics API
24
24
  #
25
- # Stores, processes, explores and shares genomic data.
25
+ # Upload, process, query, and search Genomics data in the cloud.
26
26
  #
27
27
  # @example
28
28
  # require 'google/apis/genomics_v1'
@@ -30,7 +30,7 @@ module Google
30
30
  # Genomics = Google::Apis::GenomicsV1 # Alias the module
31
31
  # service = Genomics::GenomicsService.new
32
32
  #
33
- # @see https://cloud.google.com/genomics/
33
+ # @see https://cloud.google.com/genomics
34
34
  class GenomicsService < Google::Apis::Core::BaseService
35
35
  # @return [String]
36
36
  # API key. Your API key identifies your project and provides you with API access,
@@ -46,118 +46,133 @@ module Google
46
46
  super('https://genomics.googleapis.com/', '')
47
47
  end
48
48
 
49
- # Creates a new annotation set. Caller must have WRITE permission for the
50
- # associated dataset. The following fields are required: * datasetId *
51
- # referenceSetId All other fields may be optionally specified, unless documented
52
- # as being server-generated (for example, the `id` field).
53
- # @param [Google::Apis::GenomicsV1::AnnotationSet] annotation_set_object
54
- # @param [String] fields
55
- # Selector specifying which fields to include in a partial response.
49
+ # Searches for reference sets which match the given criteria.
50
+ # For the definitions of references and other genomics resources, see
51
+ # [Fundamentals of Google
52
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
53
+ # Implements
54
+ # [GlobalAllianceApi.searchReferenceSets](https://github.com/ga4gh/schemas/blob/
55
+ # v0.5.1/src/main/resources/avro/referencemethods.avdl#L71)
56
+ # @param [Google::Apis::GenomicsV1::SearchReferenceSetsRequest] search_reference_sets_request_object
56
57
  # @param [String] quota_user
57
58
  # Available to use for quota purposes for server-side applications. Can be any
58
59
  # arbitrary string assigned to a user, but should not exceed 40 characters.
60
+ # @param [String] fields
61
+ # Selector specifying which fields to include in a partial response.
59
62
  # @param [Google::Apis::RequestOptions] options
60
63
  # Request-specific options
61
64
  #
62
65
  # @yield [result, err] Result & error if block supplied
63
- # @yieldparam result [Google::Apis::GenomicsV1::AnnotationSet] parsed result object
66
+ # @yieldparam result [Google::Apis::GenomicsV1::SearchReferenceSetsResponse] parsed result object
64
67
  # @yieldparam err [StandardError] error object if request failed
65
68
  #
66
- # @return [Google::Apis::GenomicsV1::AnnotationSet]
69
+ # @return [Google::Apis::GenomicsV1::SearchReferenceSetsResponse]
67
70
  #
68
71
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
69
72
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
70
73
  # @raise [Google::Apis::AuthorizationError] Authorization is required
71
- def create_annotation_set(annotation_set_object = nil, fields: nil, quota_user: nil, options: nil, &block)
72
- command = make_simple_command(:post, 'v1/annotationsets', options)
73
- command.request_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
74
- command.request_object = annotation_set_object
75
- command.response_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
76
- command.response_class = Google::Apis::GenomicsV1::AnnotationSet
77
- command.query['fields'] = fields unless fields.nil?
74
+ def search_reference_sets(search_reference_sets_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
75
+ command = make_simple_command(:post, 'v1/referencesets/search', options)
76
+ command.request_representation = Google::Apis::GenomicsV1::SearchReferenceSetsRequest::Representation
77
+ command.request_object = search_reference_sets_request_object
78
+ command.response_representation = Google::Apis::GenomicsV1::SearchReferenceSetsResponse::Representation
79
+ command.response_class = Google::Apis::GenomicsV1::SearchReferenceSetsResponse
78
80
  command.query['quotaUser'] = quota_user unless quota_user.nil?
81
+ command.query['fields'] = fields unless fields.nil?
79
82
  execute_or_queue_command(command, &block)
80
83
  end
81
84
 
82
- # Gets an annotation set. Caller must have READ permission for the associated
83
- # dataset.
84
- # @param [String] annotation_set_id
85
- # The ID of the annotation set to be retrieved.
86
- # @param [String] fields
87
- # Selector specifying which fields to include in a partial response.
85
+ # Gets a reference set.
86
+ # For the definitions of references and other genomics resources, see
87
+ # [Fundamentals of Google
88
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
89
+ # Implements
90
+ # [GlobalAllianceApi.getReferenceSet](https://github.com/ga4gh/schemas/blob/v0.5.
91
+ # 1/src/main/resources/avro/referencemethods.avdl#L83).
92
+ # @param [String] reference_set_id
93
+ # The ID of the reference set.
88
94
  # @param [String] quota_user
89
95
  # Available to use for quota purposes for server-side applications. Can be any
90
96
  # arbitrary string assigned to a user, but should not exceed 40 characters.
97
+ # @param [String] fields
98
+ # Selector specifying which fields to include in a partial response.
91
99
  # @param [Google::Apis::RequestOptions] options
92
100
  # Request-specific options
93
101
  #
94
102
  # @yield [result, err] Result & error if block supplied
95
- # @yieldparam result [Google::Apis::GenomicsV1::AnnotationSet] parsed result object
103
+ # @yieldparam result [Google::Apis::GenomicsV1::ReferenceSet] parsed result object
96
104
  # @yieldparam err [StandardError] error object if request failed
97
105
  #
98
- # @return [Google::Apis::GenomicsV1::AnnotationSet]
106
+ # @return [Google::Apis::GenomicsV1::ReferenceSet]
99
107
  #
100
108
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
101
109
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
102
110
  # @raise [Google::Apis::AuthorizationError] Authorization is required
103
- def get_annotation_set(annotation_set_id, fields: nil, quota_user: nil, options: nil, &block)
104
- command = make_simple_command(:get, 'v1/annotationsets/{annotationSetId}', options)
105
- command.response_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
106
- command.response_class = Google::Apis::GenomicsV1::AnnotationSet
107
- command.params['annotationSetId'] = annotation_set_id unless annotation_set_id.nil?
108
- command.query['fields'] = fields unless fields.nil?
111
+ def get_reference_set(reference_set_id, quota_user: nil, fields: nil, options: nil, &block)
112
+ command = make_simple_command(:get, 'v1/referencesets/{referenceSetId}', options)
113
+ command.response_representation = Google::Apis::GenomicsV1::ReferenceSet::Representation
114
+ command.response_class = Google::Apis::GenomicsV1::ReferenceSet
115
+ command.params['referenceSetId'] = reference_set_id unless reference_set_id.nil?
109
116
  command.query['quotaUser'] = quota_user unless quota_user.nil?
117
+ command.query['fields'] = fields unless fields.nil?
110
118
  execute_or_queue_command(command, &block)
111
119
  end
112
120
 
113
- # Updates an annotation set. The update must respect all mutability restrictions
114
- # and other invariants described on the annotation set resource. Caller must
115
- # have WRITE permission for the associated dataset.
116
- # @param [String] annotation_set_id
117
- # The ID of the annotation set to be updated.
118
- # @param [Google::Apis::GenomicsV1::AnnotationSet] annotation_set_object
119
- # @param [String] update_mask
120
- # An optional mask specifying which fields to update. Mutable fields are name,
121
- # source_uri, and info. If unspecified, all mutable fields will be updated.
122
- # @param [String] fields
123
- # Selector specifying which fields to include in a partial response.
121
+ # Creates read group sets by asynchronously importing the provided
122
+ # information.
123
+ # For the definitions of read group sets and other genomics resources, see
124
+ # [Fundamentals of Google
125
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
126
+ # The caller must have WRITE permissions to the dataset.
127
+ # ## Notes on [BAM](https://samtools.github.io/hts-specs/SAMv1.pdf) import
128
+ # - Tags will be converted to strings - tag types are not preserved
129
+ # - Comments (`@CO`) in the input file header will not be preserved
130
+ # - Original header order of references (`@SQ`) will not be preserved
131
+ # - Any reverse stranded unmapped reads will be reverse complemented, and
132
+ # their qualities (also the "BQ" and "OQ" tags, if any) will be reversed
133
+ # - Unmapped reads will be stripped of positional information (reference name
134
+ # and position)
135
+ # @param [Google::Apis::GenomicsV1::ImportReadGroupSetsRequest] import_read_group_sets_request_object
124
136
  # @param [String] quota_user
125
137
  # Available to use for quota purposes for server-side applications. Can be any
126
138
  # arbitrary string assigned to a user, but should not exceed 40 characters.
139
+ # @param [String] fields
140
+ # Selector specifying which fields to include in a partial response.
127
141
  # @param [Google::Apis::RequestOptions] options
128
142
  # Request-specific options
129
143
  #
130
144
  # @yield [result, err] Result & error if block supplied
131
- # @yieldparam result [Google::Apis::GenomicsV1::AnnotationSet] parsed result object
145
+ # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
132
146
  # @yieldparam err [StandardError] error object if request failed
133
147
  #
134
- # @return [Google::Apis::GenomicsV1::AnnotationSet]
148
+ # @return [Google::Apis::GenomicsV1::Operation]
135
149
  #
136
150
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
137
151
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
138
152
  # @raise [Google::Apis::AuthorizationError] Authorization is required
139
- def update_annotationset(annotation_set_id, annotation_set_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
140
- command = make_simple_command(:put, 'v1/annotationsets/{annotationSetId}', options)
141
- command.request_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
142
- command.request_object = annotation_set_object
143
- command.response_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
144
- command.response_class = Google::Apis::GenomicsV1::AnnotationSet
145
- command.params['annotationSetId'] = annotation_set_id unless annotation_set_id.nil?
146
- command.query['updateMask'] = update_mask unless update_mask.nil?
147
- command.query['fields'] = fields unless fields.nil?
153
+ def import_read_group_sets(import_read_group_sets_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
154
+ command = make_simple_command(:post, 'v1/readgroupsets:import', options)
155
+ command.request_representation = Google::Apis::GenomicsV1::ImportReadGroupSetsRequest::Representation
156
+ command.request_object = import_read_group_sets_request_object
157
+ command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
158
+ command.response_class = Google::Apis::GenomicsV1::Operation
148
159
  command.query['quotaUser'] = quota_user unless quota_user.nil?
160
+ command.query['fields'] = fields unless fields.nil?
149
161
  execute_or_queue_command(command, &block)
150
162
  end
151
163
 
152
- # Deletes an annotation set. Caller must have WRITE permission for the
153
- # associated annotation set.
154
- # @param [String] annotation_set_id
155
- # The ID of the annotation set to be deleted.
156
- # @param [String] fields
157
- # Selector specifying which fields to include in a partial response.
164
+ # Deletes a read group set.
165
+ # For the definitions of read group sets and other genomics resources, see
166
+ # [Fundamentals of Google
167
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
168
+ # @param [String] read_group_set_id
169
+ # The ID of the read group set to be deleted. The caller must have WRITE
170
+ # permissions to the dataset associated with this read group set.
158
171
  # @param [String] quota_user
159
172
  # Available to use for quota purposes for server-side applications. Can be any
160
173
  # arbitrary string assigned to a user, but should not exceed 40 characters.
174
+ # @param [String] fields
175
+ # Selector specifying which fields to include in a partial response.
161
176
  # @param [Google::Apis::RequestOptions] options
162
177
  # Request-specific options
163
178
  #
@@ -170,420 +185,478 @@ module Google
170
185
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
171
186
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
172
187
  # @raise [Google::Apis::AuthorizationError] Authorization is required
173
- def delete_annotationset(annotation_set_id, fields: nil, quota_user: nil, options: nil, &block)
174
- command = make_simple_command(:delete, 'v1/annotationsets/{annotationSetId}', options)
188
+ def delete_read_group_set(read_group_set_id, quota_user: nil, fields: nil, options: nil, &block)
189
+ command = make_simple_command(:delete, 'v1/readgroupsets/{readGroupSetId}', options)
175
190
  command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
176
191
  command.response_class = Google::Apis::GenomicsV1::Empty
177
- command.params['annotationSetId'] = annotation_set_id unless annotation_set_id.nil?
178
- command.query['fields'] = fields unless fields.nil?
192
+ command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
179
193
  command.query['quotaUser'] = quota_user unless quota_user.nil?
194
+ command.query['fields'] = fields unless fields.nil?
180
195
  execute_or_queue_command(command, &block)
181
196
  end
182
197
 
183
- # Searches for annotation sets that match the given criteria. Annotation sets
184
- # are returned in an unspecified order. This order is consistent, such that two
185
- # queries for the same content (regardless of page size) yield annotation sets
186
- # in the same order across their respective streams of paginated responses.
187
- # Caller must have READ permission for the queried datasets.
188
- # @param [Google::Apis::GenomicsV1::SearchAnnotationSetsRequest] search_annotation_sets_request_object
189
- # @param [String] fields
190
- # Selector specifying which fields to include in a partial response.
198
+ # Exports a read group set to a BAM file in Google Cloud Storage.
199
+ # For the definitions of read group sets and other genomics resources, see
200
+ # [Fundamentals of Google
201
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
202
+ # Note that currently there may be some differences between exported BAM
203
+ # files and the original BAM file at the time of import. See
204
+ # ImportReadGroupSets
205
+ # for caveats.
206
+ # @param [String] read_group_set_id
207
+ # Required. The ID of the read group set to export. The caller must have
208
+ # READ access to this read group set.
209
+ # @param [Google::Apis::GenomicsV1::ExportReadGroupSetRequest] export_read_group_set_request_object
191
210
  # @param [String] quota_user
192
211
  # Available to use for quota purposes for server-side applications. Can be any
193
212
  # arbitrary string assigned to a user, but should not exceed 40 characters.
213
+ # @param [String] fields
214
+ # Selector specifying which fields to include in a partial response.
194
215
  # @param [Google::Apis::RequestOptions] options
195
216
  # Request-specific options
196
217
  #
197
218
  # @yield [result, err] Result & error if block supplied
198
- # @yieldparam result [Google::Apis::GenomicsV1::SearchAnnotationSetsResponse] parsed result object
219
+ # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
199
220
  # @yieldparam err [StandardError] error object if request failed
200
221
  #
201
- # @return [Google::Apis::GenomicsV1::SearchAnnotationSetsResponse]
222
+ # @return [Google::Apis::GenomicsV1::Operation]
202
223
  #
203
224
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
204
225
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
205
226
  # @raise [Google::Apis::AuthorizationError] Authorization is required
206
- def search_annotationset_annotation_sets(search_annotation_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
207
- command = make_simple_command(:post, 'v1/annotationsets/search', options)
208
- command.request_representation = Google::Apis::GenomicsV1::SearchAnnotationSetsRequest::Representation
209
- command.request_object = search_annotation_sets_request_object
210
- command.response_representation = Google::Apis::GenomicsV1::SearchAnnotationSetsResponse::Representation
211
- command.response_class = Google::Apis::GenomicsV1::SearchAnnotationSetsResponse
212
- command.query['fields'] = fields unless fields.nil?
227
+ def export_read_group_sets(read_group_set_id, export_read_group_set_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
228
+ command = make_simple_command(:post, 'v1/readgroupsets/{readGroupSetId}:export', options)
229
+ command.request_representation = Google::Apis::GenomicsV1::ExportReadGroupSetRequest::Representation
230
+ command.request_object = export_read_group_set_request_object
231
+ command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
232
+ command.response_class = Google::Apis::GenomicsV1::Operation
233
+ command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
213
234
  command.query['quotaUser'] = quota_user unless quota_user.nil?
235
+ command.query['fields'] = fields unless fields.nil?
214
236
  execute_or_queue_command(command, &block)
215
237
  end
216
238
 
217
- # Creates a new annotation. Caller must have WRITE permission for the associated
218
- # annotation set. The following fields are required: * annotationSetId *
219
- # referenceName or referenceId ### Transcripts For annotations of type
220
- # TRANSCRIPT, the following fields of transcript must be provided: * exons.start
221
- # * exons.end All other fields may be optionally specified, unless documented as
222
- # being server-generated (for example, the `id` field). The annotated range must
223
- # be no longer than 100Mbp (mega base pairs). See the Annotation resource for
224
- # additional restrictions on each field.
225
- # @param [Google::Apis::GenomicsV1::Annotation] annotation_object
226
- # @param [String] fields
227
- # Selector specifying which fields to include in a partial response.
239
+ # Searches for read group sets matching the criteria.
240
+ # For the definitions of read group sets and other genomics resources, see
241
+ # [Fundamentals of Google
242
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
243
+ # Implements
244
+ # [GlobalAllianceApi.searchReadGroupSets](https://github.com/ga4gh/schemas/blob/
245
+ # v0.5.1/src/main/resources/avro/readmethods.avdl#L135).
246
+ # @param [Google::Apis::GenomicsV1::SearchReadGroupSetsRequest] search_read_group_sets_request_object
228
247
  # @param [String] quota_user
229
248
  # Available to use for quota purposes for server-side applications. Can be any
230
249
  # arbitrary string assigned to a user, but should not exceed 40 characters.
250
+ # @param [String] fields
251
+ # Selector specifying which fields to include in a partial response.
231
252
  # @param [Google::Apis::RequestOptions] options
232
253
  # Request-specific options
233
254
  #
234
255
  # @yield [result, err] Result & error if block supplied
235
- # @yieldparam result [Google::Apis::GenomicsV1::Annotation] parsed result object
256
+ # @yieldparam result [Google::Apis::GenomicsV1::SearchReadGroupSetsResponse] parsed result object
236
257
  # @yieldparam err [StandardError] error object if request failed
237
258
  #
238
- # @return [Google::Apis::GenomicsV1::Annotation]
259
+ # @return [Google::Apis::GenomicsV1::SearchReadGroupSetsResponse]
239
260
  #
240
261
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
241
262
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
242
263
  # @raise [Google::Apis::AuthorizationError] Authorization is required
243
- def create_annotation(annotation_object = nil, fields: nil, quota_user: nil, options: nil, &block)
244
- command = make_simple_command(:post, 'v1/annotations', options)
245
- command.request_representation = Google::Apis::GenomicsV1::Annotation::Representation
246
- command.request_object = annotation_object
247
- command.response_representation = Google::Apis::GenomicsV1::Annotation::Representation
248
- command.response_class = Google::Apis::GenomicsV1::Annotation
249
- command.query['fields'] = fields unless fields.nil?
264
+ def search_read_group_sets(search_read_group_sets_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
265
+ command = make_simple_command(:post, 'v1/readgroupsets/search', options)
266
+ command.request_representation = Google::Apis::GenomicsV1::SearchReadGroupSetsRequest::Representation
267
+ command.request_object = search_read_group_sets_request_object
268
+ command.response_representation = Google::Apis::GenomicsV1::SearchReadGroupSetsResponse::Representation
269
+ command.response_class = Google::Apis::GenomicsV1::SearchReadGroupSetsResponse
250
270
  command.query['quotaUser'] = quota_user unless quota_user.nil?
271
+ command.query['fields'] = fields unless fields.nil?
251
272
  execute_or_queue_command(command, &block)
252
273
  end
253
274
 
254
- # Creates one or more new annotations atomically. All annotations must belong to
255
- # the same annotation set. Caller must have WRITE permission for this annotation
256
- # set. For optimal performance, batch positionally adjacent annotations together.
257
- # If the request has a systemic issue, such as an attempt to write to an
258
- # inaccessible annotation set, the entire RPC will fail accordingly. For lesser
259
- # data issues, when possible an error will be isolated to the corresponding
260
- # batch entry in the response; the remaining well formed annotations will be
261
- # created normally. For details on the requirements for each individual
262
- # annotation resource, see CreateAnnotation.
263
- # @param [Google::Apis::GenomicsV1::BatchCreateAnnotationsRequest] batch_create_annotations_request_object
264
- # @param [String] fields
265
- # Selector specifying which fields to include in a partial response.
275
+ # Updates a read group set.
276
+ # For the definitions of read group sets and other genomics resources, see
277
+ # [Fundamentals of Google
278
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
279
+ # This method supports patch semantics.
280
+ # @param [String] read_group_set_id
281
+ # The ID of the read group set to be updated. The caller must have WRITE
282
+ # permissions to the dataset associated with this read group set.
283
+ # @param [Google::Apis::GenomicsV1::ReadGroupSet] read_group_set_object
284
+ # @param [String] update_mask
285
+ # An optional mask specifying which fields to update. Supported fields:
286
+ # * name.
287
+ # * referenceSetId.
288
+ # Leaving `updateMask` unset is equivalent to specifying all mutable
289
+ # fields.
266
290
  # @param [String] quota_user
267
291
  # Available to use for quota purposes for server-side applications. Can be any
268
292
  # arbitrary string assigned to a user, but should not exceed 40 characters.
293
+ # @param [String] fields
294
+ # Selector specifying which fields to include in a partial response.
269
295
  # @param [Google::Apis::RequestOptions] options
270
296
  # Request-specific options
271
297
  #
272
298
  # @yield [result, err] Result & error if block supplied
273
- # @yieldparam result [Google::Apis::GenomicsV1::BatchCreateAnnotationsResponse] parsed result object
299
+ # @yieldparam result [Google::Apis::GenomicsV1::ReadGroupSet] parsed result object
274
300
  # @yieldparam err [StandardError] error object if request failed
275
301
  #
276
- # @return [Google::Apis::GenomicsV1::BatchCreateAnnotationsResponse]
302
+ # @return [Google::Apis::GenomicsV1::ReadGroupSet]
277
303
  #
278
304
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
279
305
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
280
306
  # @raise [Google::Apis::AuthorizationError] Authorization is required
281
- def batch_create_annotations(batch_create_annotations_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
282
- command = make_simple_command(:post, 'v1/annotations:batchCreate', options)
283
- command.request_representation = Google::Apis::GenomicsV1::BatchCreateAnnotationsRequest::Representation
284
- command.request_object = batch_create_annotations_request_object
285
- command.response_representation = Google::Apis::GenomicsV1::BatchCreateAnnotationsResponse::Representation
286
- command.response_class = Google::Apis::GenomicsV1::BatchCreateAnnotationsResponse
287
- command.query['fields'] = fields unless fields.nil?
307
+ def patch_read_group_set(read_group_set_id, read_group_set_object = nil, update_mask: nil, quota_user: nil, fields: nil, options: nil, &block)
308
+ command = make_simple_command(:patch, 'v1/readgroupsets/{readGroupSetId}', options)
309
+ command.request_representation = Google::Apis::GenomicsV1::ReadGroupSet::Representation
310
+ command.request_object = read_group_set_object
311
+ command.response_representation = Google::Apis::GenomicsV1::ReadGroupSet::Representation
312
+ command.response_class = Google::Apis::GenomicsV1::ReadGroupSet
313
+ command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
314
+ command.query['updateMask'] = update_mask unless update_mask.nil?
288
315
  command.query['quotaUser'] = quota_user unless quota_user.nil?
316
+ command.query['fields'] = fields unless fields.nil?
289
317
  execute_or_queue_command(command, &block)
290
318
  end
291
319
 
292
- # Gets an annotation. Caller must have READ permission for the associated
293
- # annotation set.
294
- # @param [String] annotation_id
295
- # The ID of the annotation to be retrieved.
296
- # @param [String] fields
297
- # Selector specifying which fields to include in a partial response.
320
+ # Gets a read group set by ID.
321
+ # For the definitions of read group sets and other genomics resources, see
322
+ # [Fundamentals of Google
323
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
324
+ # @param [String] read_group_set_id
325
+ # The ID of the read group set.
298
326
  # @param [String] quota_user
299
327
  # Available to use for quota purposes for server-side applications. Can be any
300
328
  # arbitrary string assigned to a user, but should not exceed 40 characters.
329
+ # @param [String] fields
330
+ # Selector specifying which fields to include in a partial response.
301
331
  # @param [Google::Apis::RequestOptions] options
302
332
  # Request-specific options
303
333
  #
304
334
  # @yield [result, err] Result & error if block supplied
305
- # @yieldparam result [Google::Apis::GenomicsV1::Annotation] parsed result object
335
+ # @yieldparam result [Google::Apis::GenomicsV1::ReadGroupSet] parsed result object
306
336
  # @yieldparam err [StandardError] error object if request failed
307
337
  #
308
- # @return [Google::Apis::GenomicsV1::Annotation]
338
+ # @return [Google::Apis::GenomicsV1::ReadGroupSet]
309
339
  #
310
340
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
311
341
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
312
342
  # @raise [Google::Apis::AuthorizationError] Authorization is required
313
- def get_annotation(annotation_id, fields: nil, quota_user: nil, options: nil, &block)
314
- command = make_simple_command(:get, 'v1/annotations/{annotationId}', options)
315
- command.response_representation = Google::Apis::GenomicsV1::Annotation::Representation
316
- command.response_class = Google::Apis::GenomicsV1::Annotation
317
- command.params['annotationId'] = annotation_id unless annotation_id.nil?
318
- command.query['fields'] = fields unless fields.nil?
343
+ def get_read_group_set(read_group_set_id, quota_user: nil, fields: nil, options: nil, &block)
344
+ command = make_simple_command(:get, 'v1/readgroupsets/{readGroupSetId}', options)
345
+ command.response_representation = Google::Apis::GenomicsV1::ReadGroupSet::Representation
346
+ command.response_class = Google::Apis::GenomicsV1::ReadGroupSet
347
+ command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
319
348
  command.query['quotaUser'] = quota_user unless quota_user.nil?
349
+ command.query['fields'] = fields unless fields.nil?
320
350
  execute_or_queue_command(command, &block)
321
351
  end
322
352
 
323
- # Updates an annotation. Caller must have WRITE permission for the associated
324
- # dataset.
325
- # @param [String] annotation_id
326
- # The ID of the annotation to be updated.
327
- # @param [Google::Apis::GenomicsV1::Annotation] annotation_object
328
- # @param [String] update_mask
329
- # An optional mask specifying which fields to update. Mutable fields are name,
330
- # variant, transcript, and info. If unspecified, all mutable fields will be
331
- # updated.
332
- # @param [String] fields
333
- # Selector specifying which fields to include in a partial response.
353
+ # Lists fixed width coverage buckets for a read group set, each of which
354
+ # correspond to a range of a reference sequence. Each bucket summarizes
355
+ # coverage information across its corresponding genomic range.
356
+ # For the definitions of read group sets and other genomics resources, see
357
+ # [Fundamentals of Google
358
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
359
+ # Coverage is defined as the number of reads which are aligned to a given
360
+ # base in the reference sequence. Coverage buckets are available at several
361
+ # precomputed bucket widths, enabling retrieval of various coverage 'zoom
362
+ # levels'. The caller must have READ permissions for the target read group
363
+ # set.
364
+ # @param [String] read_group_set_id
365
+ # Required. The ID of the read group set over which coverage is requested.
366
+ # @param [String] end_
367
+ # The end position of the range on the reference, 0-based exclusive. If
368
+ # specified, `referenceName` must also be specified. If unset or 0, defaults
369
+ # to the length of the reference.
370
+ # @param [String] page_token
371
+ # The continuation token, which is used to page through large result sets.
372
+ # To get the next page of results, set this parameter to the value of
373
+ # `nextPageToken` from the previous response.
374
+ # @param [Fixnum] page_size
375
+ # The maximum number of results to return in a single page. If unspecified,
376
+ # defaults to 1024. The maximum value is 2048.
377
+ # @param [String] start
378
+ # The start position of the range on the reference, 0-based inclusive. If
379
+ # specified, `referenceName` must also be specified. Defaults to 0.
380
+ # @param [String] target_bucket_width
381
+ # The desired width of each reported coverage bucket in base pairs. This
382
+ # will be rounded down to the nearest precomputed bucket width; the value
383
+ # of which is returned as `bucketWidth` in the response. Defaults
384
+ # to infinity (each bucket spans an entire reference sequence) or the length
385
+ # of the target range, if specified. The smallest precomputed
386
+ # `bucketWidth` is currently 2048 base pairs; this is subject to
387
+ # change.
388
+ # @param [String] reference_name
389
+ # The name of the reference to query, within the reference set associated
390
+ # with this query. Optional.
334
391
  # @param [String] quota_user
335
392
  # Available to use for quota purposes for server-side applications. Can be any
336
393
  # arbitrary string assigned to a user, but should not exceed 40 characters.
394
+ # @param [String] fields
395
+ # Selector specifying which fields to include in a partial response.
337
396
  # @param [Google::Apis::RequestOptions] options
338
397
  # Request-specific options
339
398
  #
340
399
  # @yield [result, err] Result & error if block supplied
341
- # @yieldparam result [Google::Apis::GenomicsV1::Annotation] parsed result object
400
+ # @yieldparam result [Google::Apis::GenomicsV1::ListCoverageBucketsResponse] parsed result object
342
401
  # @yieldparam err [StandardError] error object if request failed
343
402
  #
344
- # @return [Google::Apis::GenomicsV1::Annotation]
403
+ # @return [Google::Apis::GenomicsV1::ListCoverageBucketsResponse]
345
404
  #
346
405
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
347
406
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
348
407
  # @raise [Google::Apis::AuthorizationError] Authorization is required
349
- def update_annotation(annotation_id, annotation_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
350
- command = make_simple_command(:put, 'v1/annotations/{annotationId}', options)
351
- command.request_representation = Google::Apis::GenomicsV1::Annotation::Representation
352
- command.request_object = annotation_object
353
- command.response_representation = Google::Apis::GenomicsV1::Annotation::Representation
354
- command.response_class = Google::Apis::GenomicsV1::Annotation
355
- command.params['annotationId'] = annotation_id unless annotation_id.nil?
356
- command.query['updateMask'] = update_mask unless update_mask.nil?
357
- command.query['fields'] = fields unless fields.nil?
408
+ def list_coverage_buckets(read_group_set_id, end_: nil, page_token: nil, page_size: nil, start: nil, target_bucket_width: nil, reference_name: nil, quota_user: nil, fields: nil, options: nil, &block)
409
+ command = make_simple_command(:get, 'v1/readgroupsets/{readGroupSetId}/coveragebuckets', options)
410
+ command.response_representation = Google::Apis::GenomicsV1::ListCoverageBucketsResponse::Representation
411
+ command.response_class = Google::Apis::GenomicsV1::ListCoverageBucketsResponse
412
+ command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
413
+ command.query['end'] = end_ unless end_.nil?
414
+ command.query['pageToken'] = page_token unless page_token.nil?
415
+ command.query['pageSize'] = page_size unless page_size.nil?
416
+ command.query['start'] = start unless start.nil?
417
+ command.query['targetBucketWidth'] = target_bucket_width unless target_bucket_width.nil?
418
+ command.query['referenceName'] = reference_name unless reference_name.nil?
358
419
  command.query['quotaUser'] = quota_user unless quota_user.nil?
420
+ command.query['fields'] = fields unless fields.nil?
359
421
  execute_or_queue_command(command, &block)
360
422
  end
361
423
 
362
- # Deletes an annotation. Caller must have WRITE permission for the associated
363
- # annotation set.
364
- # @param [String] annotation_id
365
- # The ID of the annotation to be deleted.
366
- # @param [String] fields
367
- # Selector specifying which fields to include in a partial response.
424
+ # Gets a list of reads for one or more read group sets.
425
+ # For the definitions of read group sets and other genomics resources, see
426
+ # [Fundamentals of Google
427
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
428
+ # Reads search operates over a genomic coordinate space of reference sequence
429
+ # & position defined over the reference sequences to which the requested
430
+ # read group sets are aligned.
431
+ # If a target positional range is specified, search returns all reads whose
432
+ # alignment to the reference genome overlap the range. A query which
433
+ # specifies only read group set IDs yields all reads in those read group
434
+ # sets, including unmapped reads.
435
+ # All reads returned (including reads on subsequent pages) are ordered by
436
+ # genomic coordinate (by reference sequence, then position). Reads with
437
+ # equivalent genomic coordinates are returned in an unspecified order. This
438
+ # order is consistent, such that two queries for the same content (regardless
439
+ # of page size) yield reads in the same order across their respective streams
440
+ # of paginated responses.
441
+ # Implements
442
+ # [GlobalAllianceApi.searchReads](https://github.com/ga4gh/schemas/blob/v0.5.1/
443
+ # src/main/resources/avro/readmethods.avdl#L85).
444
+ # @param [Google::Apis::GenomicsV1::SearchReadsRequest] search_reads_request_object
368
445
  # @param [String] quota_user
369
446
  # Available to use for quota purposes for server-side applications. Can be any
370
447
  # arbitrary string assigned to a user, but should not exceed 40 characters.
448
+ # @param [String] fields
449
+ # Selector specifying which fields to include in a partial response.
371
450
  # @param [Google::Apis::RequestOptions] options
372
451
  # Request-specific options
373
452
  #
374
453
  # @yield [result, err] Result & error if block supplied
375
- # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
454
+ # @yieldparam result [Google::Apis::GenomicsV1::SearchReadsResponse] parsed result object
376
455
  # @yieldparam err [StandardError] error object if request failed
377
456
  #
378
- # @return [Google::Apis::GenomicsV1::Empty]
457
+ # @return [Google::Apis::GenomicsV1::SearchReadsResponse]
379
458
  #
380
459
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
381
460
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
382
461
  # @raise [Google::Apis::AuthorizationError] Authorization is required
383
- def delete_annotation(annotation_id, fields: nil, quota_user: nil, options: nil, &block)
384
- command = make_simple_command(:delete, 'v1/annotations/{annotationId}', options)
385
- command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
386
- command.response_class = Google::Apis::GenomicsV1::Empty
387
- command.params['annotationId'] = annotation_id unless annotation_id.nil?
388
- command.query['fields'] = fields unless fields.nil?
462
+ def search_reads(search_reads_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
463
+ command = make_simple_command(:post, 'v1/reads/search', options)
464
+ command.request_representation = Google::Apis::GenomicsV1::SearchReadsRequest::Representation
465
+ command.request_object = search_reads_request_object
466
+ command.response_representation = Google::Apis::GenomicsV1::SearchReadsResponse::Representation
467
+ command.response_class = Google::Apis::GenomicsV1::SearchReadsResponse
389
468
  command.query['quotaUser'] = quota_user unless quota_user.nil?
469
+ command.query['fields'] = fields unless fields.nil?
390
470
  execute_or_queue_command(command, &block)
391
471
  end
392
472
 
393
- # Searches for annotations that match the given criteria. Results are ordered by
394
- # genomic coordinate (by reference sequence, then position). Annotations with
395
- # equivalent genomic coordinates are returned in an unspecified order. This
396
- # order is consistent, such that two queries for the same content (regardless of
397
- # page size) yield annotations in the same order across their respective streams
398
- # of paginated responses. Caller must have READ permission for the queried
399
- # annotation sets.
400
- # @param [Google::Apis::GenomicsV1::SearchAnnotationsRequest] search_annotations_request_object
401
- # @param [String] fields
402
- # Selector specifying which fields to include in a partial response.
473
+ # Deletes a call set.
474
+ # For the definitions of call sets and other genomics resources, see
475
+ # [Fundamentals of Google
476
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
477
+ # @param [String] call_set_id
478
+ # The ID of the call set to be deleted.
403
479
  # @param [String] quota_user
404
480
  # Available to use for quota purposes for server-side applications. Can be any
405
481
  # arbitrary string assigned to a user, but should not exceed 40 characters.
482
+ # @param [String] fields
483
+ # Selector specifying which fields to include in a partial response.
406
484
  # @param [Google::Apis::RequestOptions] options
407
485
  # Request-specific options
408
486
  #
409
487
  # @yield [result, err] Result & error if block supplied
410
- # @yieldparam result [Google::Apis::GenomicsV1::SearchAnnotationsResponse] parsed result object
488
+ # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
411
489
  # @yieldparam err [StandardError] error object if request failed
412
490
  #
413
- # @return [Google::Apis::GenomicsV1::SearchAnnotationsResponse]
491
+ # @return [Google::Apis::GenomicsV1::Empty]
414
492
  #
415
493
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
416
494
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
417
495
  # @raise [Google::Apis::AuthorizationError] Authorization is required
418
- def search_annotations(search_annotations_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
419
- command = make_simple_command(:post, 'v1/annotations/search', options)
420
- command.request_representation = Google::Apis::GenomicsV1::SearchAnnotationsRequest::Representation
421
- command.request_object = search_annotations_request_object
422
- command.response_representation = Google::Apis::GenomicsV1::SearchAnnotationsResponse::Representation
423
- command.response_class = Google::Apis::GenomicsV1::SearchAnnotationsResponse
424
- command.query['fields'] = fields unless fields.nil?
496
+ def delete_call_set(call_set_id, quota_user: nil, fields: nil, options: nil, &block)
497
+ command = make_simple_command(:delete, 'v1/callsets/{callSetId}', options)
498
+ command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
499
+ command.response_class = Google::Apis::GenomicsV1::Empty
500
+ command.params['callSetId'] = call_set_id unless call_set_id.nil?
425
501
  command.query['quotaUser'] = quota_user unless quota_user.nil?
502
+ command.query['fields'] = fields unless fields.nil?
426
503
  execute_or_queue_command(command, &block)
427
504
  end
428
505
 
429
- # Lists datasets within a project. For the definitions of datasets and other
430
- # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
431
- # com/genomics/fundamentals-of-google-genomics)
432
- # @param [String] project_id
433
- # Required. The Google Cloud project ID to list datasets for.
434
- # @param [Fixnum] page_size
435
- # The maximum number of results to return in a single page. If unspecified,
436
- # defaults to 50. The maximum value is 1024.
437
- # @param [String] page_token
438
- # The continuation token, which is used to page through large result sets. To
439
- # get the next page of results, set this parameter to the value of `
440
- # nextPageToken` from the previous response.
441
- # @param [String] fields
442
- # Selector specifying which fields to include in a partial response.
506
+ # Gets a list of call sets matching the criteria.
507
+ # For the definitions of call sets and other genomics resources, see
508
+ # [Fundamentals of Google
509
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
510
+ # Implements
511
+ # [GlobalAllianceApi.searchCallSets](https://github.com/ga4gh/schemas/blob/v0.5.
512
+ # 1/src/main/resources/avro/variantmethods.avdl#L178).
513
+ # @param [Google::Apis::GenomicsV1::SearchCallSetsRequest] search_call_sets_request_object
443
514
  # @param [String] quota_user
444
515
  # Available to use for quota purposes for server-side applications. Can be any
445
516
  # arbitrary string assigned to a user, but should not exceed 40 characters.
517
+ # @param [String] fields
518
+ # Selector specifying which fields to include in a partial response.
446
519
  # @param [Google::Apis::RequestOptions] options
447
520
  # Request-specific options
448
521
  #
449
522
  # @yield [result, err] Result & error if block supplied
450
- # @yieldparam result [Google::Apis::GenomicsV1::ListDatasetsResponse] parsed result object
523
+ # @yieldparam result [Google::Apis::GenomicsV1::SearchCallSetsResponse] parsed result object
451
524
  # @yieldparam err [StandardError] error object if request failed
452
525
  #
453
- # @return [Google::Apis::GenomicsV1::ListDatasetsResponse]
526
+ # @return [Google::Apis::GenomicsV1::SearchCallSetsResponse]
454
527
  #
455
528
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
456
529
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
457
530
  # @raise [Google::Apis::AuthorizationError] Authorization is required
458
- def list_datasets(project_id: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
459
- command = make_simple_command(:get, 'v1/datasets', options)
460
- command.response_representation = Google::Apis::GenomicsV1::ListDatasetsResponse::Representation
461
- command.response_class = Google::Apis::GenomicsV1::ListDatasetsResponse
462
- command.query['projectId'] = project_id unless project_id.nil?
463
- command.query['pageSize'] = page_size unless page_size.nil?
464
- command.query['pageToken'] = page_token unless page_token.nil?
465
- command.query['fields'] = fields unless fields.nil?
531
+ def search_call_sets(search_call_sets_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
532
+ command = make_simple_command(:post, 'v1/callsets/search', options)
533
+ command.request_representation = Google::Apis::GenomicsV1::SearchCallSetsRequest::Representation
534
+ command.request_object = search_call_sets_request_object
535
+ command.response_representation = Google::Apis::GenomicsV1::SearchCallSetsResponse::Representation
536
+ command.response_class = Google::Apis::GenomicsV1::SearchCallSetsResponse
466
537
  command.query['quotaUser'] = quota_user unless quota_user.nil?
538
+ command.query['fields'] = fields unless fields.nil?
467
539
  execute_or_queue_command(command, &block)
468
540
  end
469
541
 
470
- # Creates a new dataset. For the definitions of datasets and other genomics
471
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
472
- # genomics/fundamentals-of-google-genomics)
473
- # @param [Google::Apis::GenomicsV1::Dataset] dataset_object
474
- # @param [String] fields
475
- # Selector specifying which fields to include in a partial response.
542
+ # Updates a call set.
543
+ # For the definitions of call sets and other genomics resources, see
544
+ # [Fundamentals of Google
545
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
546
+ # This method supports patch semantics.
547
+ # @param [String] call_set_id
548
+ # The ID of the call set to be updated.
549
+ # @param [Google::Apis::GenomicsV1::CallSet] call_set_object
550
+ # @param [String] update_mask
551
+ # An optional mask specifying which fields to update. At this time, the only
552
+ # mutable field is name. The only
553
+ # acceptable value is "name". If unspecified, all mutable fields will be
554
+ # updated.
476
555
  # @param [String] quota_user
477
556
  # Available to use for quota purposes for server-side applications. Can be any
478
557
  # arbitrary string assigned to a user, but should not exceed 40 characters.
558
+ # @param [String] fields
559
+ # Selector specifying which fields to include in a partial response.
479
560
  # @param [Google::Apis::RequestOptions] options
480
561
  # Request-specific options
481
562
  #
482
563
  # @yield [result, err] Result & error if block supplied
483
- # @yieldparam result [Google::Apis::GenomicsV1::Dataset] parsed result object
564
+ # @yieldparam result [Google::Apis::GenomicsV1::CallSet] parsed result object
484
565
  # @yieldparam err [StandardError] error object if request failed
485
566
  #
486
- # @return [Google::Apis::GenomicsV1::Dataset]
567
+ # @return [Google::Apis::GenomicsV1::CallSet]
487
568
  #
488
569
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
489
570
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
490
571
  # @raise [Google::Apis::AuthorizationError] Authorization is required
491
- def create_dataset(dataset_object = nil, fields: nil, quota_user: nil, options: nil, &block)
492
- command = make_simple_command(:post, 'v1/datasets', options)
493
- command.request_representation = Google::Apis::GenomicsV1::Dataset::Representation
494
- command.request_object = dataset_object
495
- command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
496
- command.response_class = Google::Apis::GenomicsV1::Dataset
497
- command.query['fields'] = fields unless fields.nil?
572
+ def patch_call_set(call_set_id, call_set_object = nil, update_mask: nil, quota_user: nil, fields: nil, options: nil, &block)
573
+ command = make_simple_command(:patch, 'v1/callsets/{callSetId}', options)
574
+ command.request_representation = Google::Apis::GenomicsV1::CallSet::Representation
575
+ command.request_object = call_set_object
576
+ command.response_representation = Google::Apis::GenomicsV1::CallSet::Representation
577
+ command.response_class = Google::Apis::GenomicsV1::CallSet
578
+ command.params['callSetId'] = call_set_id unless call_set_id.nil?
579
+ command.query['updateMask'] = update_mask unless update_mask.nil?
498
580
  command.query['quotaUser'] = quota_user unless quota_user.nil?
581
+ command.query['fields'] = fields unless fields.nil?
499
582
  execute_or_queue_command(command, &block)
500
583
  end
501
584
 
502
- # Gets a dataset by ID. For the definitions of datasets and other genomics
503
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
504
- # genomics/fundamentals-of-google-genomics)
505
- # @param [String] dataset_id
506
- # The ID of the dataset.
507
- # @param [String] fields
508
- # Selector specifying which fields to include in a partial response.
585
+ # Gets a call set by ID.
586
+ # For the definitions of call sets and other genomics resources, see
587
+ # [Fundamentals of Google
588
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
589
+ # @param [String] call_set_id
590
+ # The ID of the call set.
509
591
  # @param [String] quota_user
510
592
  # Available to use for quota purposes for server-side applications. Can be any
511
593
  # arbitrary string assigned to a user, but should not exceed 40 characters.
594
+ # @param [String] fields
595
+ # Selector specifying which fields to include in a partial response.
512
596
  # @param [Google::Apis::RequestOptions] options
513
597
  # Request-specific options
514
598
  #
515
599
  # @yield [result, err] Result & error if block supplied
516
- # @yieldparam result [Google::Apis::GenomicsV1::Dataset] parsed result object
600
+ # @yieldparam result [Google::Apis::GenomicsV1::CallSet] parsed result object
517
601
  # @yieldparam err [StandardError] error object if request failed
518
602
  #
519
- # @return [Google::Apis::GenomicsV1::Dataset]
603
+ # @return [Google::Apis::GenomicsV1::CallSet]
520
604
  #
521
605
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
522
606
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
523
607
  # @raise [Google::Apis::AuthorizationError] Authorization is required
524
- def get_dataset(dataset_id, fields: nil, quota_user: nil, options: nil, &block)
525
- command = make_simple_command(:get, 'v1/datasets/{datasetId}', options)
526
- command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
527
- command.response_class = Google::Apis::GenomicsV1::Dataset
528
- command.params['datasetId'] = dataset_id unless dataset_id.nil?
529
- command.query['fields'] = fields unless fields.nil?
608
+ def get_call_set(call_set_id, quota_user: nil, fields: nil, options: nil, &block)
609
+ command = make_simple_command(:get, 'v1/callsets/{callSetId}', options)
610
+ command.response_representation = Google::Apis::GenomicsV1::CallSet::Representation
611
+ command.response_class = Google::Apis::GenomicsV1::CallSet
612
+ command.params['callSetId'] = call_set_id unless call_set_id.nil?
530
613
  command.query['quotaUser'] = quota_user unless quota_user.nil?
614
+ command.query['fields'] = fields unless fields.nil?
531
615
  execute_or_queue_command(command, &block)
532
616
  end
533
617
 
534
- # Updates a dataset. For the definitions of datasets and other genomics
535
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
536
- # genomics/fundamentals-of-google-genomics) This method supports patch semantics.
537
- # @param [String] dataset_id
538
- # The ID of the dataset to be updated.
539
- # @param [Google::Apis::GenomicsV1::Dataset] dataset_object
540
- # @param [String] update_mask
541
- # An optional mask specifying which fields to update. At this time, the only
542
- # mutable field is name. The only acceptable value is "name". If unspecified,
543
- # all mutable fields will be updated.
544
- # @param [String] fields
545
- # Selector specifying which fields to include in a partial response.
618
+ # Creates a new call set.
619
+ # For the definitions of call sets and other genomics resources, see
620
+ # [Fundamentals of Google
621
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
622
+ # @param [Google::Apis::GenomicsV1::CallSet] call_set_object
546
623
  # @param [String] quota_user
547
624
  # Available to use for quota purposes for server-side applications. Can be any
548
625
  # arbitrary string assigned to a user, but should not exceed 40 characters.
626
+ # @param [String] fields
627
+ # Selector specifying which fields to include in a partial response.
549
628
  # @param [Google::Apis::RequestOptions] options
550
629
  # Request-specific options
551
630
  #
552
631
  # @yield [result, err] Result & error if block supplied
553
- # @yieldparam result [Google::Apis::GenomicsV1::Dataset] parsed result object
632
+ # @yieldparam result [Google::Apis::GenomicsV1::CallSet] parsed result object
554
633
  # @yieldparam err [StandardError] error object if request failed
555
634
  #
556
- # @return [Google::Apis::GenomicsV1::Dataset]
635
+ # @return [Google::Apis::GenomicsV1::CallSet]
557
636
  #
558
637
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
559
638
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
560
639
  # @raise [Google::Apis::AuthorizationError] Authorization is required
561
- def patch_dataset(dataset_id, dataset_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
562
- command = make_simple_command(:patch, 'v1/datasets/{datasetId}', options)
563
- command.request_representation = Google::Apis::GenomicsV1::Dataset::Representation
564
- command.request_object = dataset_object
565
- command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
566
- command.response_class = Google::Apis::GenomicsV1::Dataset
567
- command.params['datasetId'] = dataset_id unless dataset_id.nil?
568
- command.query['updateMask'] = update_mask unless update_mask.nil?
569
- command.query['fields'] = fields unless fields.nil?
640
+ def create_call_set(call_set_object = nil, quota_user: nil, fields: nil, options: nil, &block)
641
+ command = make_simple_command(:post, 'v1/callsets', options)
642
+ command.request_representation = Google::Apis::GenomicsV1::CallSet::Representation
643
+ command.request_object = call_set_object
644
+ command.response_representation = Google::Apis::GenomicsV1::CallSet::Representation
645
+ command.response_class = Google::Apis::GenomicsV1::CallSet
570
646
  command.query['quotaUser'] = quota_user unless quota_user.nil?
647
+ command.query['fields'] = fields unless fields.nil?
571
648
  execute_or_queue_command(command, &block)
572
649
  end
573
650
 
574
- # Deletes a dataset and all of its contents (all read group sets, reference sets,
575
- # variant sets, call sets, annotation sets, etc.) This is reversible (up to one
576
- # week after the deletion) via the datasets.undelete operation. For the
577
- # definitions of datasets and other genomics resources, see [Fundamentals of
578
- # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
579
- # genomics)
580
- # @param [String] dataset_id
581
- # The ID of the dataset to be deleted.
582
- # @param [String] fields
583
- # Selector specifying which fields to include in a partial response.
651
+ # Deletes an annotation set. Caller must have WRITE permission
652
+ # for the associated annotation set.
653
+ # @param [String] annotation_set_id
654
+ # The ID of the annotation set to be deleted.
584
655
  # @param [String] quota_user
585
656
  # Available to use for quota purposes for server-side applications. Can be any
586
657
  # arbitrary string assigned to a user, but should not exceed 40 characters.
658
+ # @param [String] fields
659
+ # Selector specifying which fields to include in a partial response.
587
660
  # @param [Google::Apis::RequestOptions] options
588
661
  # Request-specific options
589
662
  #
@@ -596,444 +669,470 @@ module Google
596
669
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
597
670
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
598
671
  # @raise [Google::Apis::AuthorizationError] Authorization is required
599
- def delete_dataset(dataset_id, fields: nil, quota_user: nil, options: nil, &block)
600
- command = make_simple_command(:delete, 'v1/datasets/{datasetId}', options)
672
+ def delete_annotationset(annotation_set_id, quota_user: nil, fields: nil, options: nil, &block)
673
+ command = make_simple_command(:delete, 'v1/annotationsets/{annotationSetId}', options)
601
674
  command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
602
675
  command.response_class = Google::Apis::GenomicsV1::Empty
603
- command.params['datasetId'] = dataset_id unless dataset_id.nil?
604
- command.query['fields'] = fields unless fields.nil?
676
+ command.params['annotationSetId'] = annotation_set_id unless annotation_set_id.nil?
605
677
  command.query['quotaUser'] = quota_user unless quota_user.nil?
678
+ command.query['fields'] = fields unless fields.nil?
606
679
  execute_or_queue_command(command, &block)
607
680
  end
608
681
 
609
- # Undeletes a dataset by restoring a dataset which was deleted via this API. For
610
- # the definitions of datasets and other genomics resources, see [Fundamentals of
611
- # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
612
- # genomics) This operation is only possible for a week after the deletion
613
- # occurred.
614
- # @param [String] dataset_id
615
- # The ID of the dataset to be undeleted.
616
- # @param [Google::Apis::GenomicsV1::UndeleteDatasetRequest] undelete_dataset_request_object
617
- # @param [String] fields
618
- # Selector specifying which fields to include in a partial response.
682
+ # Searches for annotation sets that match the given criteria. Annotation sets
683
+ # are returned in an unspecified order. This order is consistent, such that
684
+ # two queries for the same content (regardless of page size) yield annotation
685
+ # sets in the same order across their respective streams of paginated
686
+ # responses. Caller must have READ permission for the queried datasets.
687
+ # @param [Google::Apis::GenomicsV1::SearchAnnotationSetsRequest] search_annotation_sets_request_object
619
688
  # @param [String] quota_user
620
689
  # Available to use for quota purposes for server-side applications. Can be any
621
690
  # arbitrary string assigned to a user, but should not exceed 40 characters.
691
+ # @param [String] fields
692
+ # Selector specifying which fields to include in a partial response.
622
693
  # @param [Google::Apis::RequestOptions] options
623
694
  # Request-specific options
624
695
  #
625
696
  # @yield [result, err] Result & error if block supplied
626
- # @yieldparam result [Google::Apis::GenomicsV1::Dataset] parsed result object
697
+ # @yieldparam result [Google::Apis::GenomicsV1::SearchAnnotationSetsResponse] parsed result object
627
698
  # @yieldparam err [StandardError] error object if request failed
628
699
  #
629
- # @return [Google::Apis::GenomicsV1::Dataset]
700
+ # @return [Google::Apis::GenomicsV1::SearchAnnotationSetsResponse]
630
701
  #
631
702
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
632
703
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
633
704
  # @raise [Google::Apis::AuthorizationError] Authorization is required
634
- def undelete_dataset(dataset_id, undelete_dataset_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
635
- command = make_simple_command(:post, 'v1/datasets/{datasetId}:undelete', options)
636
- command.request_representation = Google::Apis::GenomicsV1::UndeleteDatasetRequest::Representation
637
- command.request_object = undelete_dataset_request_object
638
- command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
639
- command.response_class = Google::Apis::GenomicsV1::Dataset
640
- command.params['datasetId'] = dataset_id unless dataset_id.nil?
641
- command.query['fields'] = fields unless fields.nil?
705
+ def search_annotationset_annotation_sets(search_annotation_sets_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
706
+ command = make_simple_command(:post, 'v1/annotationsets/search', options)
707
+ command.request_representation = Google::Apis::GenomicsV1::SearchAnnotationSetsRequest::Representation
708
+ command.request_object = search_annotation_sets_request_object
709
+ command.response_representation = Google::Apis::GenomicsV1::SearchAnnotationSetsResponse::Representation
710
+ command.response_class = Google::Apis::GenomicsV1::SearchAnnotationSetsResponse
642
711
  command.query['quotaUser'] = quota_user unless quota_user.nil?
712
+ command.query['fields'] = fields unless fields.nil?
643
713
  execute_or_queue_command(command, &block)
644
714
  end
645
715
 
646
- # Sets the access control policy on the specified dataset. Replaces any existing
647
- # policy. For the definitions of datasets and other genomics resources, see [
648
- # Fundamentals of Google Genomics](https://cloud.google.com/genomics/
649
- # fundamentals-of-google-genomics) See Setting a Policy for more information.
650
- # @param [String] resource
651
- # REQUIRED: The resource for which policy is being specified. Format is `
652
- # datasets/`.
653
- # @param [Google::Apis::GenomicsV1::SetIamPolicyRequest] set_iam_policy_request_object
654
- # @param [String] fields
655
- # Selector specifying which fields to include in a partial response.
716
+ # Gets an annotation set. Caller must have READ permission for
717
+ # the associated dataset.
718
+ # @param [String] annotation_set_id
719
+ # The ID of the annotation set to be retrieved.
656
720
  # @param [String] quota_user
657
721
  # Available to use for quota purposes for server-side applications. Can be any
658
722
  # arbitrary string assigned to a user, but should not exceed 40 characters.
723
+ # @param [String] fields
724
+ # Selector specifying which fields to include in a partial response.
659
725
  # @param [Google::Apis::RequestOptions] options
660
726
  # Request-specific options
661
727
  #
662
728
  # @yield [result, err] Result & error if block supplied
663
- # @yieldparam result [Google::Apis::GenomicsV1::Policy] parsed result object
729
+ # @yieldparam result [Google::Apis::GenomicsV1::AnnotationSet] parsed result object
664
730
  # @yieldparam err [StandardError] error object if request failed
665
731
  #
666
- # @return [Google::Apis::GenomicsV1::Policy]
732
+ # @return [Google::Apis::GenomicsV1::AnnotationSet]
667
733
  #
668
734
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
669
735
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
670
736
  # @raise [Google::Apis::AuthorizationError] Authorization is required
671
- def set_dataset_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
672
- command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
673
- command.request_representation = Google::Apis::GenomicsV1::SetIamPolicyRequest::Representation
674
- command.request_object = set_iam_policy_request_object
675
- command.response_representation = Google::Apis::GenomicsV1::Policy::Representation
676
- command.response_class = Google::Apis::GenomicsV1::Policy
677
- command.params['resource'] = resource unless resource.nil?
678
- command.query['fields'] = fields unless fields.nil?
737
+ def get_annotation_set(annotation_set_id, quota_user: nil, fields: nil, options: nil, &block)
738
+ command = make_simple_command(:get, 'v1/annotationsets/{annotationSetId}', options)
739
+ command.response_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
740
+ command.response_class = Google::Apis::GenomicsV1::AnnotationSet
741
+ command.params['annotationSetId'] = annotation_set_id unless annotation_set_id.nil?
679
742
  command.query['quotaUser'] = quota_user unless quota_user.nil?
743
+ command.query['fields'] = fields unless fields.nil?
680
744
  execute_or_queue_command(command, &block)
681
745
  end
682
746
 
683
- # Gets the access control policy for the dataset. This is empty if the policy or
684
- # resource does not exist. See Getting a Policy for more information. For the
685
- # definitions of datasets and other genomics resources, see [Fundamentals of
686
- # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
687
- # genomics)
688
- # @param [String] resource
689
- # REQUIRED: The resource for which policy is being specified. Format is `
690
- # datasets/`.
691
- # @param [Google::Apis::GenomicsV1::GetIamPolicyRequest] get_iam_policy_request_object
692
- # @param [String] fields
693
- # Selector specifying which fields to include in a partial response.
747
+ # Updates an annotation set. The update must respect all mutability
748
+ # restrictions and other invariants described on the annotation set resource.
749
+ # Caller must have WRITE permission for the associated dataset.
750
+ # @param [String] annotation_set_id
751
+ # The ID of the annotation set to be updated.
752
+ # @param [Google::Apis::GenomicsV1::AnnotationSet] annotation_set_object
753
+ # @param [String] update_mask
754
+ # An optional mask specifying which fields to update. Mutable fields are
755
+ # name,
756
+ # source_uri, and
757
+ # info. If unspecified, all
758
+ # mutable fields will be updated.
694
759
  # @param [String] quota_user
695
760
  # Available to use for quota purposes for server-side applications. Can be any
696
761
  # arbitrary string assigned to a user, but should not exceed 40 characters.
762
+ # @param [String] fields
763
+ # Selector specifying which fields to include in a partial response.
697
764
  # @param [Google::Apis::RequestOptions] options
698
765
  # Request-specific options
699
766
  #
700
767
  # @yield [result, err] Result & error if block supplied
701
- # @yieldparam result [Google::Apis::GenomicsV1::Policy] parsed result object
768
+ # @yieldparam result [Google::Apis::GenomicsV1::AnnotationSet] parsed result object
702
769
  # @yieldparam err [StandardError] error object if request failed
703
770
  #
704
- # @return [Google::Apis::GenomicsV1::Policy]
771
+ # @return [Google::Apis::GenomicsV1::AnnotationSet]
705
772
  #
706
773
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
707
774
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
708
775
  # @raise [Google::Apis::AuthorizationError] Authorization is required
709
- def get_dataset_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
710
- command = make_simple_command(:post, 'v1/{+resource}:getIamPolicy', options)
711
- command.request_representation = Google::Apis::GenomicsV1::GetIamPolicyRequest::Representation
712
- command.request_object = get_iam_policy_request_object
713
- command.response_representation = Google::Apis::GenomicsV1::Policy::Representation
714
- command.response_class = Google::Apis::GenomicsV1::Policy
715
- command.params['resource'] = resource unless resource.nil?
716
- command.query['fields'] = fields unless fields.nil?
776
+ def update_annotationset(annotation_set_id, annotation_set_object = nil, update_mask: nil, quota_user: nil, fields: nil, options: nil, &block)
777
+ command = make_simple_command(:put, 'v1/annotationsets/{annotationSetId}', options)
778
+ command.request_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
779
+ command.request_object = annotation_set_object
780
+ command.response_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
781
+ command.response_class = Google::Apis::GenomicsV1::AnnotationSet
782
+ command.params['annotationSetId'] = annotation_set_id unless annotation_set_id.nil?
783
+ command.query['updateMask'] = update_mask unless update_mask.nil?
717
784
  command.query['quotaUser'] = quota_user unless quota_user.nil?
785
+ command.query['fields'] = fields unless fields.nil?
718
786
  execute_or_queue_command(command, &block)
719
787
  end
720
788
 
721
- # Returns permissions that a caller has on the specified resource. See Testing
722
- # Permissions for more information. For the definitions of datasets and other
723
- # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
724
- # com/genomics/fundamentals-of-google-genomics)
725
- # @param [String] resource
726
- # REQUIRED: The resource for which policy is being specified. Format is `
727
- # datasets/`.
728
- # @param [Google::Apis::GenomicsV1::TestIamPermissionsRequest] test_iam_permissions_request_object
729
- # @param [String] fields
730
- # Selector specifying which fields to include in a partial response.
789
+ # Creates a new annotation set. Caller must have WRITE permission for the
790
+ # associated dataset.
791
+ # The following fields are required:
792
+ # * datasetId
793
+ # * referenceSetId
794
+ # All other fields may be optionally specified, unless documented as being
795
+ # server-generated (for example, the `id` field).
796
+ # @param [Google::Apis::GenomicsV1::AnnotationSet] annotation_set_object
731
797
  # @param [String] quota_user
732
798
  # Available to use for quota purposes for server-side applications. Can be any
733
799
  # arbitrary string assigned to a user, but should not exceed 40 characters.
800
+ # @param [String] fields
801
+ # Selector specifying which fields to include in a partial response.
734
802
  # @param [Google::Apis::RequestOptions] options
735
803
  # Request-specific options
736
804
  #
737
805
  # @yield [result, err] Result & error if block supplied
738
- # @yieldparam result [Google::Apis::GenomicsV1::TestIamPermissionsResponse] parsed result object
806
+ # @yieldparam result [Google::Apis::GenomicsV1::AnnotationSet] parsed result object
739
807
  # @yieldparam err [StandardError] error object if request failed
740
808
  #
741
- # @return [Google::Apis::GenomicsV1::TestIamPermissionsResponse]
809
+ # @return [Google::Apis::GenomicsV1::AnnotationSet]
742
810
  #
743
811
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
744
812
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
745
813
  # @raise [Google::Apis::AuthorizationError] Authorization is required
746
- def test_dataset_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
747
- command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
748
- command.request_representation = Google::Apis::GenomicsV1::TestIamPermissionsRequest::Representation
749
- command.request_object = test_iam_permissions_request_object
750
- command.response_representation = Google::Apis::GenomicsV1::TestIamPermissionsResponse::Representation
751
- command.response_class = Google::Apis::GenomicsV1::TestIamPermissionsResponse
752
- command.params['resource'] = resource unless resource.nil?
753
- command.query['fields'] = fields unless fields.nil?
754
- command.query['quotaUser'] = quota_user unless quota_user.nil?
755
- execute_or_queue_command(command, &block)
756
- end
757
-
758
- # Lists operations that match the specified filter in the request.
759
- # @param [String] name
760
- # The name of the operation collection.
761
- # @param [String] filter
762
- # A string for filtering Operations. The following filter fields are supported: *
763
- # projectId: Required. Corresponds to OperationMetadata.projectId. * createTime:
764
- # The time this job was created, in seconds from the [epoch](http://en.
765
- # wikipedia.org/wiki/Unix_time). Can use `>=` and/or `= 1432140000` * `projectId
766
- # = my-project AND createTime >= 1432140000 AND createTime <= 1432150000 AND
767
- # status = RUNNING` * `projectId = my-project AND labels.color = *` * `projectId
768
- # = my-project AND labels.color = red`
769
- # @param [Fixnum] page_size
770
- # The maximum number of results to return. If unspecified, defaults to 256. The
771
- # maximum value is 2048.
772
- # @param [String] page_token
773
- # The standard list page token.
774
- # @param [String] fields
775
- # Selector specifying which fields to include in a partial response.
776
- # @param [String] quota_user
777
- # Available to use for quota purposes for server-side applications. Can be any
778
- # arbitrary string assigned to a user, but should not exceed 40 characters.
779
- # @param [Google::Apis::RequestOptions] options
780
- # Request-specific options
781
- #
782
- # @yield [result, err] Result & error if block supplied
783
- # @yieldparam result [Google::Apis::GenomicsV1::ListOperationsResponse] parsed result object
784
- # @yieldparam err [StandardError] error object if request failed
785
- #
786
- # @return [Google::Apis::GenomicsV1::ListOperationsResponse]
787
- #
788
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
789
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
790
- # @raise [Google::Apis::AuthorizationError] Authorization is required
791
- def list_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
792
- command = make_simple_command(:get, 'v1/{+name}', options)
793
- command.response_representation = Google::Apis::GenomicsV1::ListOperationsResponse::Representation
794
- command.response_class = Google::Apis::GenomicsV1::ListOperationsResponse
795
- command.params['name'] = name unless name.nil?
796
- command.query['filter'] = filter unless filter.nil?
797
- command.query['pageSize'] = page_size unless page_size.nil?
798
- command.query['pageToken'] = page_token unless page_token.nil?
799
- command.query['fields'] = fields unless fields.nil?
814
+ def create_annotation_set(annotation_set_object = nil, quota_user: nil, fields: nil, options: nil, &block)
815
+ command = make_simple_command(:post, 'v1/annotationsets', options)
816
+ command.request_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
817
+ command.request_object = annotation_set_object
818
+ command.response_representation = Google::Apis::GenomicsV1::AnnotationSet::Representation
819
+ command.response_class = Google::Apis::GenomicsV1::AnnotationSet
800
820
  command.query['quotaUser'] = quota_user unless quota_user.nil?
821
+ command.query['fields'] = fields unless fields.nil?
801
822
  execute_or_queue_command(command, &block)
802
823
  end
803
824
 
804
- # Gets the latest state of a long-running operation. Clients can use this method
805
- # to poll the operation result at intervals as recommended by the API service.
806
- # @param [String] name
807
- # The name of the operation resource.
808
- # @param [String] fields
809
- # Selector specifying which fields to include in a partial response.
825
+ # Creates a new variant.
826
+ # For the definitions of variants and other genomics resources, see
827
+ # [Fundamentals of Google
828
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
829
+ # @param [Google::Apis::GenomicsV1::Variant] variant_object
810
830
  # @param [String] quota_user
811
831
  # Available to use for quota purposes for server-side applications. Can be any
812
832
  # arbitrary string assigned to a user, but should not exceed 40 characters.
833
+ # @param [String] fields
834
+ # Selector specifying which fields to include in a partial response.
813
835
  # @param [Google::Apis::RequestOptions] options
814
836
  # Request-specific options
815
837
  #
816
838
  # @yield [result, err] Result & error if block supplied
817
- # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
839
+ # @yieldparam result [Google::Apis::GenomicsV1::Variant] parsed result object
818
840
  # @yieldparam err [StandardError] error object if request failed
819
841
  #
820
- # @return [Google::Apis::GenomicsV1::Operation]
842
+ # @return [Google::Apis::GenomicsV1::Variant]
821
843
  #
822
844
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
823
845
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
824
846
  # @raise [Google::Apis::AuthorizationError] Authorization is required
825
- def get_operation(name, fields: nil, quota_user: nil, options: nil, &block)
826
- command = make_simple_command(:get, 'v1/{+name}', options)
827
- command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
828
- command.response_class = Google::Apis::GenomicsV1::Operation
829
- command.params['name'] = name unless name.nil?
830
- command.query['fields'] = fields unless fields.nil?
847
+ def create_variant(variant_object = nil, quota_user: nil, fields: nil, options: nil, &block)
848
+ command = make_simple_command(:post, 'v1/variants', options)
849
+ command.request_representation = Google::Apis::GenomicsV1::Variant::Representation
850
+ command.request_object = variant_object
851
+ command.response_representation = Google::Apis::GenomicsV1::Variant::Representation
852
+ command.response_class = Google::Apis::GenomicsV1::Variant
831
853
  command.query['quotaUser'] = quota_user unless quota_user.nil?
854
+ command.query['fields'] = fields unless fields.nil?
832
855
  execute_or_queue_command(command, &block)
833
856
  end
834
857
 
835
- # Starts asynchronous cancellation on a long-running operation. The server makes
836
- # a best effort to cancel the operation, but success is not guaranteed. Clients
837
- # may use Operations.GetOperation or Operations.ListOperations to check whether
838
- # the cancellation succeeded or the operation completed despite cancellation.
839
- # @param [String] name
840
- # The name of the operation resource to be cancelled.
841
- # @param [Google::Apis::GenomicsV1::CancelOperationRequest] cancel_operation_request_object
842
- # @param [String] fields
843
- # Selector specifying which fields to include in a partial response.
858
+ # Gets a list of variants matching the criteria.
859
+ # For the definitions of variants and other genomics resources, see
860
+ # [Fundamentals of Google
861
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
862
+ # Implements
863
+ # [GlobalAllianceApi.searchVariants](https://github.com/ga4gh/schemas/blob/v0.5.
864
+ # 1/src/main/resources/avro/variantmethods.avdl#L126).
865
+ # @param [Google::Apis::GenomicsV1::SearchVariantsRequest] search_variants_request_object
844
866
  # @param [String] quota_user
845
867
  # Available to use for quota purposes for server-side applications. Can be any
846
868
  # arbitrary string assigned to a user, but should not exceed 40 characters.
869
+ # @param [String] fields
870
+ # Selector specifying which fields to include in a partial response.
847
871
  # @param [Google::Apis::RequestOptions] options
848
872
  # Request-specific options
849
873
  #
850
874
  # @yield [result, err] Result & error if block supplied
851
- # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
875
+ # @yieldparam result [Google::Apis::GenomicsV1::SearchVariantsResponse] parsed result object
852
876
  # @yieldparam err [StandardError] error object if request failed
853
877
  #
854
- # @return [Google::Apis::GenomicsV1::Empty]
878
+ # @return [Google::Apis::GenomicsV1::SearchVariantsResponse]
855
879
  #
856
880
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
857
881
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
858
882
  # @raise [Google::Apis::AuthorizationError] Authorization is required
859
- def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
860
- command = make_simple_command(:post, 'v1/{+name}:cancel', options)
861
- command.request_representation = Google::Apis::GenomicsV1::CancelOperationRequest::Representation
862
- command.request_object = cancel_operation_request_object
863
- command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
864
- command.response_class = Google::Apis::GenomicsV1::Empty
865
- command.params['name'] = name unless name.nil?
866
- command.query['fields'] = fields unless fields.nil?
883
+ def search_variants(search_variants_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
884
+ command = make_simple_command(:post, 'v1/variants/search', options)
885
+ command.request_representation = Google::Apis::GenomicsV1::SearchVariantsRequest::Representation
886
+ command.request_object = search_variants_request_object
887
+ command.response_representation = Google::Apis::GenomicsV1::SearchVariantsResponse::Representation
888
+ command.response_class = Google::Apis::GenomicsV1::SearchVariantsResponse
867
889
  command.query['quotaUser'] = quota_user unless quota_user.nil?
890
+ command.query['fields'] = fields unless fields.nil?
868
891
  execute_or_queue_command(command, &block)
869
892
  end
870
893
 
871
- # Creates read group sets by asynchronously importing the provided information.
872
- # For the definitions of read group sets and other genomics resources, see [
873
- # Fundamentals of Google Genomics](https://cloud.google.com/genomics/
874
- # fundamentals-of-google-genomics) The caller must have WRITE permissions to the
875
- # dataset. ## Notes on [BAM](https://samtools.github.io/hts-specs/SAMv1.pdf)
876
- # import - Tags will be converted to strings - tag types are not preserved -
877
- # Comments (`@CO`) in the input file header will not be preserved - Original
878
- # header order of references (`@SQ`) will not be preserved - Any reverse
879
- # stranded unmapped reads will be reverse complemented, and their qualities (
880
- # also the "BQ" and "OQ" tags, if any) will be reversed - Unmapped reads will be
881
- # stripped of positional information (reference name and position)
882
- # @param [Google::Apis::GenomicsV1::ImportReadGroupSetsRequest] import_read_group_sets_request_object
883
- # @param [String] fields
884
- # Selector specifying which fields to include in a partial response.
894
+ # Updates a variant.
895
+ # For the definitions of variants and other genomics resources, see
896
+ # [Fundamentals of Google
897
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
898
+ # This method supports patch semantics. Returns the modified variant without
899
+ # its calls.
900
+ # @param [String] variant_id
901
+ # The ID of the variant to be updated.
902
+ # @param [Google::Apis::GenomicsV1::Variant] variant_object
903
+ # @param [String] update_mask
904
+ # An optional mask specifying which fields to update. At this time, mutable
905
+ # fields are names and
906
+ # info. Acceptable values are "names" and
907
+ # "info". If unspecified, all mutable fields will be updated.
885
908
  # @param [String] quota_user
886
909
  # Available to use for quota purposes for server-side applications. Can be any
887
910
  # arbitrary string assigned to a user, but should not exceed 40 characters.
911
+ # @param [String] fields
912
+ # Selector specifying which fields to include in a partial response.
888
913
  # @param [Google::Apis::RequestOptions] options
889
914
  # Request-specific options
890
915
  #
891
916
  # @yield [result, err] Result & error if block supplied
892
- # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
917
+ # @yieldparam result [Google::Apis::GenomicsV1::Variant] parsed result object
893
918
  # @yieldparam err [StandardError] error object if request failed
894
919
  #
895
- # @return [Google::Apis::GenomicsV1::Operation]
920
+ # @return [Google::Apis::GenomicsV1::Variant]
896
921
  #
897
922
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
898
923
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
899
924
  # @raise [Google::Apis::AuthorizationError] Authorization is required
900
- def import_read_group_sets(import_read_group_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
901
- command = make_simple_command(:post, 'v1/readgroupsets:import', options)
902
- command.request_representation = Google::Apis::GenomicsV1::ImportReadGroupSetsRequest::Representation
903
- command.request_object = import_read_group_sets_request_object
904
- command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
905
- command.response_class = Google::Apis::GenomicsV1::Operation
906
- command.query['fields'] = fields unless fields.nil?
925
+ def patch_variant(variant_id, variant_object = nil, update_mask: nil, quota_user: nil, fields: nil, options: nil, &block)
926
+ command = make_simple_command(:patch, 'v1/variants/{variantId}', options)
927
+ command.request_representation = Google::Apis::GenomicsV1::Variant::Representation
928
+ command.request_object = variant_object
929
+ command.response_representation = Google::Apis::GenomicsV1::Variant::Representation
930
+ command.response_class = Google::Apis::GenomicsV1::Variant
931
+ command.params['variantId'] = variant_id unless variant_id.nil?
932
+ command.query['updateMask'] = update_mask unless update_mask.nil?
907
933
  command.query['quotaUser'] = quota_user unless quota_user.nil?
934
+ command.query['fields'] = fields unless fields.nil?
908
935
  execute_or_queue_command(command, &block)
909
936
  end
910
937
 
911
- # Exports a read group set to a BAM file in Google Cloud Storage. For the
912
- # definitions of read group sets and other genomics resources, see [Fundamentals
913
- # of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
914
- # genomics) Note that currently there may be some differences between exported
915
- # BAM files and the original BAM file at the time of import. See
916
- # ImportReadGroupSets for caveats.
917
- # @param [String] read_group_set_id
918
- # Required. The ID of the read group set to export. The caller must have READ
919
- # access to this read group set.
920
- # @param [Google::Apis::GenomicsV1::ExportReadGroupSetRequest] export_read_group_set_request_object
921
- # @param [String] fields
922
- # Selector specifying which fields to include in a partial response.
938
+ # Gets a variant by ID.
939
+ # For the definitions of variants and other genomics resources, see
940
+ # [Fundamentals of Google
941
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
942
+ # @param [String] variant_id
943
+ # The ID of the variant.
923
944
  # @param [String] quota_user
924
945
  # Available to use for quota purposes for server-side applications. Can be any
925
946
  # arbitrary string assigned to a user, but should not exceed 40 characters.
947
+ # @param [String] fields
948
+ # Selector specifying which fields to include in a partial response.
926
949
  # @param [Google::Apis::RequestOptions] options
927
950
  # Request-specific options
928
951
  #
929
952
  # @yield [result, err] Result & error if block supplied
930
- # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
953
+ # @yieldparam result [Google::Apis::GenomicsV1::Variant] parsed result object
931
954
  # @yieldparam err [StandardError] error object if request failed
932
955
  #
933
- # @return [Google::Apis::GenomicsV1::Operation]
956
+ # @return [Google::Apis::GenomicsV1::Variant]
934
957
  #
935
958
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
936
959
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
937
960
  # @raise [Google::Apis::AuthorizationError] Authorization is required
938
- def export_read_group_sets(read_group_set_id, export_read_group_set_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
939
- command = make_simple_command(:post, 'v1/readgroupsets/{readGroupSetId}:export', options)
940
- command.request_representation = Google::Apis::GenomicsV1::ExportReadGroupSetRequest::Representation
941
- command.request_object = export_read_group_set_request_object
942
- command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
943
- command.response_class = Google::Apis::GenomicsV1::Operation
944
- command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
945
- command.query['fields'] = fields unless fields.nil?
961
+ def get_variant(variant_id, quota_user: nil, fields: nil, options: nil, &block)
962
+ command = make_simple_command(:get, 'v1/variants/{variantId}', options)
963
+ command.response_representation = Google::Apis::GenomicsV1::Variant::Representation
964
+ command.response_class = Google::Apis::GenomicsV1::Variant
965
+ command.params['variantId'] = variant_id unless variant_id.nil?
946
966
  command.query['quotaUser'] = quota_user unless quota_user.nil?
967
+ command.query['fields'] = fields unless fields.nil?
947
968
  execute_or_queue_command(command, &block)
948
969
  end
949
970
 
950
- # Searches for read group sets matching the criteria. For the definitions of
951
- # read group sets and other genomics resources, see [Fundamentals of Google
971
+ # Deletes a variant.
972
+ # For the definitions of variants and other genomics resources, see
973
+ # [Fundamentals of Google
952
974
  # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
953
- # Implements [GlobalAllianceApi.searchReadGroupSets](https://github.com/ga4gh/
954
- # schemas/blob/v0.5.1/src/main/resources/avro/readmethods.avdl#L135).
955
- # @param [Google::Apis::GenomicsV1::SearchReadGroupSetsRequest] search_read_group_sets_request_object
956
- # @param [String] fields
957
- # Selector specifying which fields to include in a partial response.
975
+ # @param [String] variant_id
976
+ # The ID of the variant to be deleted.
958
977
  # @param [String] quota_user
959
978
  # Available to use for quota purposes for server-side applications. Can be any
960
979
  # arbitrary string assigned to a user, but should not exceed 40 characters.
980
+ # @param [String] fields
981
+ # Selector specifying which fields to include in a partial response.
961
982
  # @param [Google::Apis::RequestOptions] options
962
983
  # Request-specific options
963
984
  #
964
985
  # @yield [result, err] Result & error if block supplied
965
- # @yieldparam result [Google::Apis::GenomicsV1::SearchReadGroupSetsResponse] parsed result object
986
+ # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
966
987
  # @yieldparam err [StandardError] error object if request failed
967
988
  #
968
- # @return [Google::Apis::GenomicsV1::SearchReadGroupSetsResponse]
989
+ # @return [Google::Apis::GenomicsV1::Empty]
969
990
  #
970
991
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
971
992
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
972
993
  # @raise [Google::Apis::AuthorizationError] Authorization is required
973
- def search_read_group_sets(search_read_group_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
974
- command = make_simple_command(:post, 'v1/readgroupsets/search', options)
975
- command.request_representation = Google::Apis::GenomicsV1::SearchReadGroupSetsRequest::Representation
976
- command.request_object = search_read_group_sets_request_object
977
- command.response_representation = Google::Apis::GenomicsV1::SearchReadGroupSetsResponse::Representation
978
- command.response_class = Google::Apis::GenomicsV1::SearchReadGroupSetsResponse
979
- command.query['fields'] = fields unless fields.nil?
994
+ def delete_variant(variant_id, quota_user: nil, fields: nil, options: nil, &block)
995
+ command = make_simple_command(:delete, 'v1/variants/{variantId}', options)
996
+ command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
997
+ command.response_class = Google::Apis::GenomicsV1::Empty
998
+ command.params['variantId'] = variant_id unless variant_id.nil?
980
999
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1000
+ command.query['fields'] = fields unless fields.nil?
981
1001
  execute_or_queue_command(command, &block)
982
1002
  end
983
1003
 
984
- # Updates a read group set. For the definitions of read group sets and other
985
- # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
986
- # com/genomics/fundamentals-of-google-genomics) This method supports patch
987
- # semantics.
988
- # @param [String] read_group_set_id
989
- # The ID of the read group set to be updated. The caller must have WRITE
990
- # permissions to the dataset associated with this read group set.
991
- # @param [Google::Apis::GenomicsV1::ReadGroupSet] read_group_set_object
992
- # @param [String] update_mask
993
- # An optional mask specifying which fields to update. Supported fields: * name. *
994
- # referenceSetId. Leaving `updateMask` unset is equivalent to specifying all
995
- # mutable fields.
996
- # @param [String] fields
997
- # Selector specifying which fields to include in a partial response.
1004
+ # Creates variant data by asynchronously importing the provided information.
1005
+ # For the definitions of variant sets and other genomics resources, see
1006
+ # [Fundamentals of Google
1007
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1008
+ # The variants for import will be merged with any existing variant that
1009
+ # matches its reference sequence, start, end, reference bases, and
1010
+ # alternative bases. If no such variant exists, a new one will be created.
1011
+ # When variants are merged, the call information from the new variant
1012
+ # is added to the existing variant, and Variant info fields are merged
1013
+ # as specified in
1014
+ # infoMergeConfig.
1015
+ # As a special case, for single-sample VCF files, QUAL and FILTER fields will
1016
+ # be moved to the call level; these are sometimes interpreted in a
1017
+ # call-specific context.
1018
+ # Imported VCF headers are appended to the metadata already in a variant set.
1019
+ # @param [Google::Apis::GenomicsV1::ImportVariantsRequest] import_variants_request_object
998
1020
  # @param [String] quota_user
999
1021
  # Available to use for quota purposes for server-side applications. Can be any
1000
1022
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1023
+ # @param [String] fields
1024
+ # Selector specifying which fields to include in a partial response.
1001
1025
  # @param [Google::Apis::RequestOptions] options
1002
1026
  # Request-specific options
1003
1027
  #
1004
1028
  # @yield [result, err] Result & error if block supplied
1005
- # @yieldparam result [Google::Apis::GenomicsV1::ReadGroupSet] parsed result object
1029
+ # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
1006
1030
  # @yieldparam err [StandardError] error object if request failed
1007
1031
  #
1008
- # @return [Google::Apis::GenomicsV1::ReadGroupSet]
1032
+ # @return [Google::Apis::GenomicsV1::Operation]
1009
1033
  #
1010
1034
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1011
1035
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1012
1036
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1013
- 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)
1014
- command = make_simple_command(:patch, 'v1/readgroupsets/{readGroupSetId}', options)
1015
- command.request_representation = Google::Apis::GenomicsV1::ReadGroupSet::Representation
1016
- command.request_object = read_group_set_object
1017
- command.response_representation = Google::Apis::GenomicsV1::ReadGroupSet::Representation
1018
- command.response_class = Google::Apis::GenomicsV1::ReadGroupSet
1019
- command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
1020
- command.query['updateMask'] = update_mask unless update_mask.nil?
1021
- command.query['fields'] = fields unless fields.nil?
1037
+ def import_variants(import_variants_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1038
+ command = make_simple_command(:post, 'v1/variants:import', options)
1039
+ command.request_representation = Google::Apis::GenomicsV1::ImportVariantsRequest::Representation
1040
+ command.request_object = import_variants_request_object
1041
+ command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
1042
+ command.response_class = Google::Apis::GenomicsV1::Operation
1022
1043
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1044
+ command.query['fields'] = fields unless fields.nil?
1023
1045
  execute_or_queue_command(command, &block)
1024
1046
  end
1025
1047
 
1026
- # Deletes a read group set. For the definitions of read group sets and other
1027
- # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
1028
- # com/genomics/fundamentals-of-google-genomics)
1029
- # @param [String] read_group_set_id
1030
- # The ID of the read group set to be deleted. The caller must have WRITE
1031
- # permissions to the dataset associated with this read group set.
1032
- # @param [String] fields
1033
- # Selector specifying which fields to include in a partial response.
1048
+ # Merges the given variants with existing variants.
1049
+ # For the definitions of variants and other genomics resources, see
1050
+ # [Fundamentals of Google
1051
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1052
+ # Each variant will be
1053
+ # merged with an existing variant that matches its reference sequence,
1054
+ # start, end, reference bases, and alternative bases. If no such variant
1055
+ # exists, a new one will be created.
1056
+ # When variants are merged, the call information from the new variant
1057
+ # is added to the existing variant. Variant info fields are merged as
1058
+ # specified in the
1059
+ # infoMergeConfig
1060
+ # field of the MergeVariantsRequest.
1061
+ # Please exercise caution when using this method! It is easy to introduce
1062
+ # mistakes in existing variants and difficult to back out of them. For
1063
+ # example,
1064
+ # suppose you were trying to merge a new variant with an existing one and
1065
+ # both
1066
+ # variants contain calls that belong to callsets with the same callset ID.
1067
+ # // Existing variant - irrelevant fields trimmed for clarity
1068
+ # `
1069
+ # "variantSetId": "10473108253681171589",
1070
+ # "referenceName": "1",
1071
+ # "start": "10582",
1072
+ # "referenceBases": "G",
1073
+ # "alternateBases": [
1074
+ # "A"
1075
+ # ],
1076
+ # "calls": [
1077
+ # `
1078
+ # "callSetId": "10473108253681171589-0",
1079
+ # "callSetName": "CALLSET0",
1080
+ # "genotype": [
1081
+ # 0,
1082
+ # 1
1083
+ # ],
1084
+ # `
1085
+ # ]
1086
+ # `
1087
+ # // New variant with conflicting call information
1088
+ # `
1089
+ # "variantSetId": "10473108253681171589",
1090
+ # "referenceName": "1",
1091
+ # "start": "10582",
1092
+ # "referenceBases": "G",
1093
+ # "alternateBases": [
1094
+ # "A"
1095
+ # ],
1096
+ # "calls": [
1097
+ # `
1098
+ # "callSetId": "10473108253681171589-0",
1099
+ # "callSetName": "CALLSET0",
1100
+ # "genotype": [
1101
+ # 1,
1102
+ # 1
1103
+ # ],
1104
+ # `
1105
+ # ]
1106
+ # `
1107
+ # The resulting merged variant would overwrite the existing calls with those
1108
+ # from the new variant:
1109
+ # `
1110
+ # "variantSetId": "10473108253681171589",
1111
+ # "referenceName": "1",
1112
+ # "start": "10582",
1113
+ # "referenceBases": "G",
1114
+ # "alternateBases": [
1115
+ # "A"
1116
+ # ],
1117
+ # "calls": [
1118
+ # `
1119
+ # "callSetId": "10473108253681171589-0",
1120
+ # "callSetName": "CALLSET0",
1121
+ # "genotype": [
1122
+ # 1,
1123
+ # 1
1124
+ # ],
1125
+ # `
1126
+ # ]
1127
+ # `
1128
+ # This may be the desired outcome, but it is up to the user to determine if
1129
+ # if that is indeed the case.
1130
+ # @param [Google::Apis::GenomicsV1::MergeVariantsRequest] merge_variants_request_object
1034
1131
  # @param [String] quota_user
1035
1132
  # Available to use for quota purposes for server-side applications. Can be any
1036
1133
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1134
+ # @param [String] fields
1135
+ # Selector specifying which fields to include in a partial response.
1037
1136
  # @param [Google::Apis::RequestOptions] options
1038
1137
  # Request-specific options
1039
1138
  #
@@ -1046,538 +1145,499 @@ module Google
1046
1145
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1047
1146
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1048
1147
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1049
- def delete_read_group_set(read_group_set_id, fields: nil, quota_user: nil, options: nil, &block)
1050
- command = make_simple_command(:delete, 'v1/readgroupsets/{readGroupSetId}', options)
1148
+ def merge_variants(merge_variants_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1149
+ command = make_simple_command(:post, 'v1/variants:merge', options)
1150
+ command.request_representation = Google::Apis::GenomicsV1::MergeVariantsRequest::Representation
1151
+ command.request_object = merge_variants_request_object
1051
1152
  command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
1052
1153
  command.response_class = Google::Apis::GenomicsV1::Empty
1053
- command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
1054
- command.query['fields'] = fields unless fields.nil?
1055
1154
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1155
+ command.query['fields'] = fields unless fields.nil?
1056
1156
  execute_or_queue_command(command, &block)
1057
1157
  end
1058
1158
 
1059
- # Gets a read group set by ID. For the definitions of read group sets and other
1060
- # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
1061
- # com/genomics/fundamentals-of-google-genomics)
1062
- # @param [String] read_group_set_id
1063
- # The ID of the read group set.
1064
- # @param [String] fields
1065
- # Selector specifying which fields to include in a partial response.
1159
+ # Searches for references which match the given criteria.
1160
+ # For the definitions of references and other genomics resources, see
1161
+ # [Fundamentals of Google
1162
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1163
+ # Implements
1164
+ # [GlobalAllianceApi.searchReferences](https://github.com/ga4gh/schemas/blob/v0.
1165
+ # 5.1/src/main/resources/avro/referencemethods.avdl#L146).
1166
+ # @param [Google::Apis::GenomicsV1::SearchReferencesRequest] search_references_request_object
1066
1167
  # @param [String] quota_user
1067
1168
  # Available to use for quota purposes for server-side applications. Can be any
1068
1169
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1170
+ # @param [String] fields
1171
+ # Selector specifying which fields to include in a partial response.
1069
1172
  # @param [Google::Apis::RequestOptions] options
1070
1173
  # Request-specific options
1071
1174
  #
1072
1175
  # @yield [result, err] Result & error if block supplied
1073
- # @yieldparam result [Google::Apis::GenomicsV1::ReadGroupSet] parsed result object
1176
+ # @yieldparam result [Google::Apis::GenomicsV1::SearchReferencesResponse] parsed result object
1074
1177
  # @yieldparam err [StandardError] error object if request failed
1075
1178
  #
1076
- # @return [Google::Apis::GenomicsV1::ReadGroupSet]
1179
+ # @return [Google::Apis::GenomicsV1::SearchReferencesResponse]
1077
1180
  #
1078
1181
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1079
1182
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1080
1183
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1081
- def get_read_group_set(read_group_set_id, fields: nil, quota_user: nil, options: nil, &block)
1082
- command = make_simple_command(:get, 'v1/readgroupsets/{readGroupSetId}', options)
1083
- command.response_representation = Google::Apis::GenomicsV1::ReadGroupSet::Representation
1084
- command.response_class = Google::Apis::GenomicsV1::ReadGroupSet
1085
- command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
1086
- command.query['fields'] = fields unless fields.nil?
1184
+ def search_references(search_references_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1185
+ command = make_simple_command(:post, 'v1/references/search', options)
1186
+ command.request_representation = Google::Apis::GenomicsV1::SearchReferencesRequest::Representation
1187
+ command.request_object = search_references_request_object
1188
+ command.response_representation = Google::Apis::GenomicsV1::SearchReferencesResponse::Representation
1189
+ command.response_class = Google::Apis::GenomicsV1::SearchReferencesResponse
1087
1190
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1191
+ command.query['fields'] = fields unless fields.nil?
1088
1192
  execute_or_queue_command(command, &block)
1089
1193
  end
1090
1194
 
1091
- # Lists fixed width coverage buckets for a read group set, each of which
1092
- # correspond to a range of a reference sequence. Each bucket summarizes coverage
1093
- # information across its corresponding genomic range. For the definitions of
1094
- # read group sets and other genomics resources, see [Fundamentals of Google
1195
+ # Gets a reference.
1196
+ # For the definitions of references and other genomics resources, see
1197
+ # [Fundamentals of Google
1095
1198
  # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1096
- # Coverage is defined as the number of reads which are aligned to a given base
1097
- # in the reference sequence. Coverage buckets are available at several
1098
- # precomputed bucket widths, enabling retrieval of various coverage 'zoom levels'
1099
- # . The caller must have READ permissions for the target read group set.
1100
- # @param [String] read_group_set_id
1101
- # Required. The ID of the read group set over which coverage is requested.
1102
- # @param [String] reference_name
1103
- # The name of the reference to query, within the reference set associated with
1104
- # this query. Optional.
1105
- # @param [String] start
1106
- # The start position of the range on the reference, 0-based inclusive. If
1107
- # specified, `referenceName` must also be specified. Defaults to 0.
1108
- # @param [String] end_
1109
- # The end position of the range on the reference, 0-based exclusive. If
1110
- # specified, `referenceName` must also be specified. If unset or 0, defaults to
1111
- # the length of the reference.
1112
- # @param [String] target_bucket_width
1113
- # The desired width of each reported coverage bucket in base pairs. This will be
1114
- # rounded down to the nearest precomputed bucket width; the value of which is
1115
- # returned as `bucketWidth` in the response. Defaults to infinity (each bucket
1116
- # spans an entire reference sequence) or the length of the target range, if
1117
- # specified. The smallest precomputed `bucketWidth` is currently 2048 base pairs;
1118
- # this is subject to change.
1119
- # @param [String] page_token
1120
- # The continuation token, which is used to page through large result sets. To
1121
- # get the next page of results, set this parameter to the value of `
1122
- # nextPageToken` from the previous response.
1123
- # @param [Fixnum] page_size
1124
- # The maximum number of results to return in a single page. If unspecified,
1125
- # defaults to 1024. The maximum value is 2048.
1126
- # @param [String] fields
1127
- # Selector specifying which fields to include in a partial response.
1199
+ # Implements
1200
+ # [GlobalAllianceApi.getReference](https://github.com/ga4gh/schemas/blob/v0.5.1/
1201
+ # src/main/resources/avro/referencemethods.avdl#L158).
1202
+ # @param [String] reference_id
1203
+ # The ID of the reference.
1128
1204
  # @param [String] quota_user
1129
1205
  # Available to use for quota purposes for server-side applications. Can be any
1130
1206
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1207
+ # @param [String] fields
1208
+ # Selector specifying which fields to include in a partial response.
1131
1209
  # @param [Google::Apis::RequestOptions] options
1132
1210
  # Request-specific options
1133
1211
  #
1134
1212
  # @yield [result, err] Result & error if block supplied
1135
- # @yieldparam result [Google::Apis::GenomicsV1::ListCoverageBucketsResponse] parsed result object
1213
+ # @yieldparam result [Google::Apis::GenomicsV1::Reference] parsed result object
1136
1214
  # @yieldparam err [StandardError] error object if request failed
1137
1215
  #
1138
- # @return [Google::Apis::GenomicsV1::ListCoverageBucketsResponse]
1216
+ # @return [Google::Apis::GenomicsV1::Reference]
1139
1217
  #
1140
1218
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1141
1219
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1142
1220
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1143
- 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)
1144
- command = make_simple_command(:get, 'v1/readgroupsets/{readGroupSetId}/coveragebuckets', options)
1145
- command.response_representation = Google::Apis::GenomicsV1::ListCoverageBucketsResponse::Representation
1146
- command.response_class = Google::Apis::GenomicsV1::ListCoverageBucketsResponse
1147
- command.params['readGroupSetId'] = read_group_set_id unless read_group_set_id.nil?
1148
- command.query['referenceName'] = reference_name unless reference_name.nil?
1149
- command.query['start'] = start unless start.nil?
1150
- command.query['end'] = end_ unless end_.nil?
1151
- command.query['targetBucketWidth'] = target_bucket_width unless target_bucket_width.nil?
1152
- command.query['pageToken'] = page_token unless page_token.nil?
1153
- command.query['pageSize'] = page_size unless page_size.nil?
1154
- command.query['fields'] = fields unless fields.nil?
1221
+ def get_reference(reference_id, quota_user: nil, fields: nil, options: nil, &block)
1222
+ command = make_simple_command(:get, 'v1/references/{referenceId}', options)
1223
+ command.response_representation = Google::Apis::GenomicsV1::Reference::Representation
1224
+ command.response_class = Google::Apis::GenomicsV1::Reference
1225
+ command.params['referenceId'] = reference_id unless reference_id.nil?
1155
1226
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1227
+ command.query['fields'] = fields unless fields.nil?
1156
1228
  execute_or_queue_command(command, &block)
1157
1229
  end
1158
1230
 
1159
- # Gets a list of reads for one or more read group sets. For the definitions of
1160
- # read group sets and other genomics resources, see [Fundamentals of Google
1231
+ # Lists the bases in a reference, optionally restricted to a range.
1232
+ # For the definitions of references and other genomics resources, see
1233
+ # [Fundamentals of Google
1161
1234
  # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1162
- # Reads search operates over a genomic coordinate space of reference sequence &
1163
- # position defined over the reference sequences to which the requested read
1164
- # group sets are aligned. If a target positional range is specified, search
1165
- # returns all reads whose alignment to the reference genome overlap the range. A
1166
- # query which specifies only read group set IDs yields all reads in those read
1167
- # group sets, including unmapped reads. All reads returned (including reads on
1168
- # subsequent pages) are ordered by genomic coordinate (by reference sequence,
1169
- # then position). Reads with equivalent genomic coordinates are returned in an
1170
- # unspecified order. This order is consistent, such that two queries for the
1171
- # same content (regardless of page size) yield reads in the same order across
1172
- # their respective streams of paginated responses. Implements [GlobalAllianceApi.
1173
- # searchReads](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/
1174
- # avro/readmethods.avdl#L85).
1175
- # @param [Google::Apis::GenomicsV1::SearchReadsRequest] search_reads_request_object
1176
- # @param [String] fields
1177
- # Selector specifying which fields to include in a partial response.
1235
+ # Implements
1236
+ # [GlobalAllianceApi.getReferenceBases](https://github.com/ga4gh/schemas/blob/v0.
1237
+ # 5.1/src/main/resources/avro/referencemethods.avdl#L221).
1238
+ # @param [String] reference_id
1239
+ # The ID of the reference.
1240
+ # @param [String] start_position
1241
+ # The start position (0-based) of this query. Defaults to 0.
1242
+ # @param [String] end_position
1243
+ # The end position (0-based, exclusive) of this query. Defaults to the length
1244
+ # of this reference.
1245
+ # @param [String] page_token
1246
+ # The continuation token, which is used to page through large result sets.
1247
+ # To get the next page of results, set this parameter to the value of
1248
+ # `nextPageToken` from the previous response.
1249
+ # @param [Fixnum] page_size
1250
+ # The maximum number of bases to return in a single page. If unspecified,
1251
+ # defaults to 200Kbp (kilo base pairs). The maximum value is 10Mbp (mega base
1252
+ # pairs).
1178
1253
  # @param [String] quota_user
1179
1254
  # Available to use for quota purposes for server-side applications. Can be any
1180
1255
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1181
- # @param [Google::Apis::RequestOptions] options
1182
- # Request-specific options
1183
- #
1184
- # @yield [result, err] Result & error if block supplied
1185
- # @yieldparam result [Google::Apis::GenomicsV1::SearchReadsResponse] parsed result object
1186
- # @yieldparam err [StandardError] error object if request failed
1187
- #
1188
- # @return [Google::Apis::GenomicsV1::SearchReadsResponse]
1189
- #
1190
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1191
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1192
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1193
- def search_reads(search_reads_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1194
- command = make_simple_command(:post, 'v1/reads/search', options)
1195
- command.request_representation = Google::Apis::GenomicsV1::SearchReadsRequest::Representation
1196
- command.request_object = search_reads_request_object
1197
- command.response_representation = Google::Apis::GenomicsV1::SearchReadsResponse::Representation
1198
- command.response_class = Google::Apis::GenomicsV1::SearchReadsResponse
1199
- command.query['fields'] = fields unless fields.nil?
1200
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1201
- execute_or_queue_command(command, &block)
1202
- end
1203
-
1204
- # Returns a stream of all the reads matching the search request, ordered by
1205
- # reference name, position, and ID.
1206
- # @param [Google::Apis::GenomicsV1::StreamReadsRequest] stream_reads_request_object
1207
1256
  # @param [String] fields
1208
1257
  # Selector specifying which fields to include in a partial response.
1209
- # @param [String] quota_user
1210
- # Available to use for quota purposes for server-side applications. Can be any
1211
- # arbitrary string assigned to a user, but should not exceed 40 characters.
1212
1258
  # @param [Google::Apis::RequestOptions] options
1213
1259
  # Request-specific options
1214
1260
  #
1215
1261
  # @yield [result, err] Result & error if block supplied
1216
- # @yieldparam result [Google::Apis::GenomicsV1::StreamReadsResponse] parsed result object
1262
+ # @yieldparam result [Google::Apis::GenomicsV1::ListBasesResponse] parsed result object
1217
1263
  # @yieldparam err [StandardError] error object if request failed
1218
1264
  #
1219
- # @return [Google::Apis::GenomicsV1::StreamReadsResponse]
1265
+ # @return [Google::Apis::GenomicsV1::ListBasesResponse]
1220
1266
  #
1221
1267
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1222
1268
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1223
1269
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1224
- def stream_reads(stream_reads_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1225
- command = make_simple_command(:post, 'v1/reads:stream', options)
1226
- command.request_representation = Google::Apis::GenomicsV1::StreamReadsRequest::Representation
1227
- command.request_object = stream_reads_request_object
1228
- command.response_representation = Google::Apis::GenomicsV1::StreamReadsResponse::Representation
1229
- command.response_class = Google::Apis::GenomicsV1::StreamReadsResponse
1230
- command.query['fields'] = fields unless fields.nil?
1270
+ def list_reference_bases(reference_id, start_position: nil, end_position: nil, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
1271
+ command = make_simple_command(:get, 'v1/references/{referenceId}/bases', options)
1272
+ command.response_representation = Google::Apis::GenomicsV1::ListBasesResponse::Representation
1273
+ command.response_class = Google::Apis::GenomicsV1::ListBasesResponse
1274
+ command.params['referenceId'] = reference_id unless reference_id.nil?
1275
+ command.query['start'] = start_position unless start_position.nil?
1276
+ command.query['end'] = end_position unless end_position.nil?
1277
+ command.query['pageToken'] = page_token unless page_token.nil?
1278
+ command.query['pageSize'] = page_size unless page_size.nil?
1231
1279
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1280
+ command.query['fields'] = fields unless fields.nil?
1232
1281
  execute_or_queue_command(command, &block)
1233
1282
  end
1234
1283
 
1235
- # Searches for reference sets which match the given criteria. For the
1236
- # definitions of references and other genomics resources, see [Fundamentals of
1237
- # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
1238
- # genomics) Implements [GlobalAllianceApi.searchReferenceSets](https://github.
1239
- # com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/referencemethods.avdl#
1240
- # L71)
1241
- # @param [Google::Apis::GenomicsV1::SearchReferenceSetsRequest] search_reference_sets_request_object
1242
- # @param [String] fields
1243
- # Selector specifying which fields to include in a partial response.
1284
+ # Gets the access control policy for the dataset. This is empty if the
1285
+ # policy or resource does not exist.
1286
+ # See <a href="/iam/docs/managing-policies#getting_a_policy">Getting a
1287
+ # Policy</a> for more information.
1288
+ # For the definitions of datasets and other genomics resources, see
1289
+ # [Fundamentals of Google
1290
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1291
+ # @param [String] resource
1292
+ # REQUIRED: The resource for which policy is being specified. Format is
1293
+ # `datasets/<dataset ID>`.
1294
+ # @param [Google::Apis::GenomicsV1::GetIamPolicyRequest] get_iam_policy_request_object
1244
1295
  # @param [String] quota_user
1245
1296
  # Available to use for quota purposes for server-side applications. Can be any
1246
1297
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1298
+ # @param [String] fields
1299
+ # Selector specifying which fields to include in a partial response.
1247
1300
  # @param [Google::Apis::RequestOptions] options
1248
1301
  # Request-specific options
1249
1302
  #
1250
1303
  # @yield [result, err] Result & error if block supplied
1251
- # @yieldparam result [Google::Apis::GenomicsV1::SearchReferenceSetsResponse] parsed result object
1304
+ # @yieldparam result [Google::Apis::GenomicsV1::Policy] parsed result object
1252
1305
  # @yieldparam err [StandardError] error object if request failed
1253
1306
  #
1254
- # @return [Google::Apis::GenomicsV1::SearchReferenceSetsResponse]
1307
+ # @return [Google::Apis::GenomicsV1::Policy]
1255
1308
  #
1256
1309
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1257
1310
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1258
1311
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1259
- def search_reference_sets(search_reference_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1260
- command = make_simple_command(:post, 'v1/referencesets/search', options)
1261
- command.request_representation = Google::Apis::GenomicsV1::SearchReferenceSetsRequest::Representation
1262
- command.request_object = search_reference_sets_request_object
1263
- command.response_representation = Google::Apis::GenomicsV1::SearchReferenceSetsResponse::Representation
1264
- command.response_class = Google::Apis::GenomicsV1::SearchReferenceSetsResponse
1265
- command.query['fields'] = fields unless fields.nil?
1312
+ def get_dataset_iam_policy(resource, get_iam_policy_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1313
+ command = make_simple_command(:post, 'v1/{+resource}:getIamPolicy', options)
1314
+ command.request_representation = Google::Apis::GenomicsV1::GetIamPolicyRequest::Representation
1315
+ command.request_object = get_iam_policy_request_object
1316
+ command.response_representation = Google::Apis::GenomicsV1::Policy::Representation
1317
+ command.response_class = Google::Apis::GenomicsV1::Policy
1318
+ command.params['resource'] = resource unless resource.nil?
1266
1319
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1320
+ command.query['fields'] = fields unless fields.nil?
1267
1321
  execute_or_queue_command(command, &block)
1268
1322
  end
1269
1323
 
1270
- # Gets a reference set. For the definitions of references and other genomics
1271
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
1272
- # genomics/fundamentals-of-google-genomics) Implements [GlobalAllianceApi.
1273
- # getReferenceSet](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/
1274
- # resources/avro/referencemethods.avdl#L83).
1275
- # @param [String] reference_set_id
1276
- # The ID of the reference set.
1277
- # @param [String] fields
1278
- # Selector specifying which fields to include in a partial response.
1324
+ # Updates a dataset.
1325
+ # For the definitions of datasets and other genomics resources, see
1326
+ # [Fundamentals of Google
1327
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1328
+ # This method supports patch semantics.
1329
+ # @param [String] dataset_id
1330
+ # The ID of the dataset to be updated.
1331
+ # @param [Google::Apis::GenomicsV1::Dataset] dataset_object
1332
+ # @param [String] update_mask
1333
+ # An optional mask specifying which fields to update. At this time, the only
1334
+ # mutable field is name. The only
1335
+ # acceptable value is "name". If unspecified, all mutable fields will be
1336
+ # updated.
1279
1337
  # @param [String] quota_user
1280
1338
  # Available to use for quota purposes for server-side applications. Can be any
1281
1339
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1340
+ # @param [String] fields
1341
+ # Selector specifying which fields to include in a partial response.
1282
1342
  # @param [Google::Apis::RequestOptions] options
1283
1343
  # Request-specific options
1284
1344
  #
1285
1345
  # @yield [result, err] Result & error if block supplied
1286
- # @yieldparam result [Google::Apis::GenomicsV1::ReferenceSet] parsed result object
1346
+ # @yieldparam result [Google::Apis::GenomicsV1::Dataset] parsed result object
1287
1347
  # @yieldparam err [StandardError] error object if request failed
1288
1348
  #
1289
- # @return [Google::Apis::GenomicsV1::ReferenceSet]
1349
+ # @return [Google::Apis::GenomicsV1::Dataset]
1290
1350
  #
1291
1351
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1292
1352
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1293
1353
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1294
- def get_reference_set(reference_set_id, fields: nil, quota_user: nil, options: nil, &block)
1295
- command = make_simple_command(:get, 'v1/referencesets/{referenceSetId}', options)
1296
- command.response_representation = Google::Apis::GenomicsV1::ReferenceSet::Representation
1297
- command.response_class = Google::Apis::GenomicsV1::ReferenceSet
1298
- command.params['referenceSetId'] = reference_set_id unless reference_set_id.nil?
1299
- command.query['fields'] = fields unless fields.nil?
1354
+ def patch_dataset(dataset_id, dataset_object = nil, update_mask: nil, quota_user: nil, fields: nil, options: nil, &block)
1355
+ command = make_simple_command(:patch, 'v1/datasets/{datasetId}', options)
1356
+ command.request_representation = Google::Apis::GenomicsV1::Dataset::Representation
1357
+ command.request_object = dataset_object
1358
+ command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
1359
+ command.response_class = Google::Apis::GenomicsV1::Dataset
1360
+ command.params['datasetId'] = dataset_id unless dataset_id.nil?
1361
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1300
1362
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1363
+ command.query['fields'] = fields unless fields.nil?
1301
1364
  execute_or_queue_command(command, &block)
1302
1365
  end
1303
1366
 
1304
- # Searches for references which match the given criteria. For the definitions of
1305
- # references and other genomics resources, see [Fundamentals of Google Genomics](
1306
- # https://cloud.google.com/genomics/fundamentals-of-google-genomics) Implements [
1307
- # GlobalAllianceApi.searchReferences](https://github.com/ga4gh/schemas/blob/v0.5.
1308
- # 1/src/main/resources/avro/referencemethods.avdl#L146).
1309
- # @param [Google::Apis::GenomicsV1::SearchReferencesRequest] search_references_request_object
1310
- # @param [String] fields
1311
- # Selector specifying which fields to include in a partial response.
1367
+ # Gets a dataset by ID.
1368
+ # For the definitions of datasets and other genomics resources, see
1369
+ # [Fundamentals of Google
1370
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1371
+ # @param [String] dataset_id
1372
+ # The ID of the dataset.
1312
1373
  # @param [String] quota_user
1313
1374
  # Available to use for quota purposes for server-side applications. Can be any
1314
1375
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1376
+ # @param [String] fields
1377
+ # Selector specifying which fields to include in a partial response.
1315
1378
  # @param [Google::Apis::RequestOptions] options
1316
1379
  # Request-specific options
1317
1380
  #
1318
1381
  # @yield [result, err] Result & error if block supplied
1319
- # @yieldparam result [Google::Apis::GenomicsV1::SearchReferencesResponse] parsed result object
1382
+ # @yieldparam result [Google::Apis::GenomicsV1::Dataset] parsed result object
1320
1383
  # @yieldparam err [StandardError] error object if request failed
1321
1384
  #
1322
- # @return [Google::Apis::GenomicsV1::SearchReferencesResponse]
1385
+ # @return [Google::Apis::GenomicsV1::Dataset]
1323
1386
  #
1324
1387
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1325
1388
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1326
1389
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1327
- def search_references(search_references_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1328
- command = make_simple_command(:post, 'v1/references/search', options)
1329
- command.request_representation = Google::Apis::GenomicsV1::SearchReferencesRequest::Representation
1330
- command.request_object = search_references_request_object
1331
- command.response_representation = Google::Apis::GenomicsV1::SearchReferencesResponse::Representation
1332
- command.response_class = Google::Apis::GenomicsV1::SearchReferencesResponse
1333
- command.query['fields'] = fields unless fields.nil?
1390
+ def get_dataset(dataset_id, quota_user: nil, fields: nil, options: nil, &block)
1391
+ command = make_simple_command(:get, 'v1/datasets/{datasetId}', options)
1392
+ command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
1393
+ command.response_class = Google::Apis::GenomicsV1::Dataset
1394
+ command.params['datasetId'] = dataset_id unless dataset_id.nil?
1334
1395
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1396
+ command.query['fields'] = fields unless fields.nil?
1335
1397
  execute_or_queue_command(command, &block)
1336
1398
  end
1337
1399
 
1338
- # Gets a reference. For the definitions of references and other genomics
1339
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
1340
- # genomics/fundamentals-of-google-genomics) Implements [GlobalAllianceApi.
1341
- # getReference](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/
1342
- # avro/referencemethods.avdl#L158).
1343
- # @param [String] reference_id
1344
- # The ID of the reference.
1345
- # @param [String] fields
1346
- # Selector specifying which fields to include in a partial response.
1400
+ # Undeletes a dataset by restoring a dataset which was deleted via this API.
1401
+ # For the definitions of datasets and other genomics resources, see
1402
+ # [Fundamentals of Google
1403
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1404
+ # This operation is only possible for a week after the deletion occurred.
1405
+ # @param [String] dataset_id
1406
+ # The ID of the dataset to be undeleted.
1407
+ # @param [Google::Apis::GenomicsV1::UndeleteDatasetRequest] undelete_dataset_request_object
1347
1408
  # @param [String] quota_user
1348
1409
  # Available to use for quota purposes for server-side applications. Can be any
1349
1410
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1411
+ # @param [String] fields
1412
+ # Selector specifying which fields to include in a partial response.
1350
1413
  # @param [Google::Apis::RequestOptions] options
1351
1414
  # Request-specific options
1352
1415
  #
1353
1416
  # @yield [result, err] Result & error if block supplied
1354
- # @yieldparam result [Google::Apis::GenomicsV1::Reference] parsed result object
1417
+ # @yieldparam result [Google::Apis::GenomicsV1::Dataset] parsed result object
1355
1418
  # @yieldparam err [StandardError] error object if request failed
1356
1419
  #
1357
- # @return [Google::Apis::GenomicsV1::Reference]
1420
+ # @return [Google::Apis::GenomicsV1::Dataset]
1358
1421
  #
1359
1422
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1360
1423
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1361
1424
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1362
- def get_reference(reference_id, fields: nil, quota_user: nil, options: nil, &block)
1363
- command = make_simple_command(:get, 'v1/references/{referenceId}', options)
1364
- command.response_representation = Google::Apis::GenomicsV1::Reference::Representation
1365
- command.response_class = Google::Apis::GenomicsV1::Reference
1366
- command.params['referenceId'] = reference_id unless reference_id.nil?
1367
- command.query['fields'] = fields unless fields.nil?
1425
+ def undelete_dataset(dataset_id, undelete_dataset_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1426
+ command = make_simple_command(:post, 'v1/datasets/{datasetId}:undelete', options)
1427
+ command.request_representation = Google::Apis::GenomicsV1::UndeleteDatasetRequest::Representation
1428
+ command.request_object = undelete_dataset_request_object
1429
+ command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
1430
+ command.response_class = Google::Apis::GenomicsV1::Dataset
1431
+ command.params['datasetId'] = dataset_id unless dataset_id.nil?
1368
1432
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1433
+ command.query['fields'] = fields unless fields.nil?
1369
1434
  execute_or_queue_command(command, &block)
1370
1435
  end
1371
1436
 
1372
- # Lists the bases in a reference, optionally restricted to a range. For the
1373
- # definitions of references and other genomics resources, see [Fundamentals of
1374
- # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
1375
- # genomics) Implements [GlobalAllianceApi.getReferenceBases](https://github.com/
1376
- # ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/referencemethods.avdl#L221).
1377
- # @param [String] reference_id
1378
- # The ID of the reference.
1379
- # @param [String] start_position
1380
- # The start position (0-based) of this query. Defaults to 0.
1381
- # @param [String] end_position
1382
- # The end position (0-based, exclusive) of this query. Defaults to the length of
1383
- # this reference.
1384
- # @param [String] page_token
1385
- # The continuation token, which is used to page through large result sets. To
1386
- # get the next page of results, set this parameter to the value of `
1387
- # nextPageToken` from the previous response.
1388
- # @param [Fixnum] page_size
1389
- # The maximum number of bases to return in a single page. If unspecified,
1390
- # defaults to 200Kbp (kilo base pairs). The maximum value is 10Mbp (mega base
1391
- # pairs).
1392
- # @param [String] fields
1393
- # Selector specifying which fields to include in a partial response.
1437
+ # Returns permissions that a caller has on the specified resource.
1438
+ # See <a href="/iam/docs/managing-policies#testing_permissions">Testing
1439
+ # Permissions</a> for more information.
1440
+ # For the definitions of datasets and other genomics resources, see
1441
+ # [Fundamentals of Google
1442
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1443
+ # @param [String] resource
1444
+ # REQUIRED: The resource for which policy is being specified. Format is
1445
+ # `datasets/<dataset ID>`.
1446
+ # @param [Google::Apis::GenomicsV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1394
1447
  # @param [String] quota_user
1395
1448
  # Available to use for quota purposes for server-side applications. Can be any
1396
1449
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1450
+ # @param [String] fields
1451
+ # Selector specifying which fields to include in a partial response.
1397
1452
  # @param [Google::Apis::RequestOptions] options
1398
1453
  # Request-specific options
1399
1454
  #
1400
1455
  # @yield [result, err] Result & error if block supplied
1401
- # @yieldparam result [Google::Apis::GenomicsV1::ListBasesResponse] parsed result object
1456
+ # @yieldparam result [Google::Apis::GenomicsV1::TestIamPermissionsResponse] parsed result object
1402
1457
  # @yieldparam err [StandardError] error object if request failed
1403
1458
  #
1404
- # @return [Google::Apis::GenomicsV1::ListBasesResponse]
1459
+ # @return [Google::Apis::GenomicsV1::TestIamPermissionsResponse]
1405
1460
  #
1406
1461
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1407
1462
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1408
1463
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1409
- 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)
1410
- command = make_simple_command(:get, 'v1/references/{referenceId}/bases', options)
1411
- command.response_representation = Google::Apis::GenomicsV1::ListBasesResponse::Representation
1412
- command.response_class = Google::Apis::GenomicsV1::ListBasesResponse
1413
- command.params['referenceId'] = reference_id unless reference_id.nil?
1414
- command.query['start'] = start_position unless start_position.nil?
1415
- command.query['end'] = end_position unless end_position.nil?
1416
- command.query['pageToken'] = page_token unless page_token.nil?
1417
- command.query['pageSize'] = page_size unless page_size.nil?
1418
- command.query['fields'] = fields unless fields.nil?
1464
+ def test_dataset_iam_permissions(resource, test_iam_permissions_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1465
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1466
+ command.request_representation = Google::Apis::GenomicsV1::TestIamPermissionsRequest::Representation
1467
+ command.request_object = test_iam_permissions_request_object
1468
+ command.response_representation = Google::Apis::GenomicsV1::TestIamPermissionsResponse::Representation
1469
+ command.response_class = Google::Apis::GenomicsV1::TestIamPermissionsResponse
1470
+ command.params['resource'] = resource unless resource.nil?
1419
1471
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1472
+ command.query['fields'] = fields unless fields.nil?
1420
1473
  execute_or_queue_command(command, &block)
1421
1474
  end
1422
1475
 
1423
- # Creates variant data by asynchronously importing the provided information. For
1424
- # the definitions of variant sets and other genomics resources, see [
1425
- # Fundamentals of Google Genomics](https://cloud.google.com/genomics/
1426
- # fundamentals-of-google-genomics) The variants for import will be merged with
1427
- # any existing variant that matches its reference sequence, start, end,
1428
- # reference bases, and alternative bases. If no such variant exists, a new one
1429
- # will be created. When variants are merged, the call information from the new
1430
- # variant is added to the existing variant, and Variant info fields are merged
1431
- # as specified in infoMergeConfig. As a special case, for single-sample VCF
1432
- # files, QUAL and FILTER fields will be moved to the call level; these are
1433
- # sometimes interpreted in a call-specific context. Imported VCF headers are
1434
- # appended to the metadata already in a variant set.
1435
- # @param [Google::Apis::GenomicsV1::ImportVariantsRequest] import_variants_request_object
1436
- # @param [String] fields
1437
- # Selector specifying which fields to include in a partial response.
1476
+ # Deletes a dataset and all of its contents (all read group sets,
1477
+ # reference sets, variant sets, call sets, annotation sets, etc.)
1478
+ # This is reversible (up to one week after the deletion) via
1479
+ # the
1480
+ # datasets.undelete
1481
+ # operation.
1482
+ # For the definitions of datasets and other genomics resources, see
1483
+ # [Fundamentals of Google
1484
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1485
+ # @param [String] dataset_id
1486
+ # The ID of the dataset to be deleted.
1438
1487
  # @param [String] quota_user
1439
1488
  # Available to use for quota purposes for server-side applications. Can be any
1440
1489
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1490
+ # @param [String] fields
1491
+ # Selector specifying which fields to include in a partial response.
1441
1492
  # @param [Google::Apis::RequestOptions] options
1442
1493
  # Request-specific options
1443
1494
  #
1444
1495
  # @yield [result, err] Result & error if block supplied
1445
- # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
1496
+ # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
1446
1497
  # @yieldparam err [StandardError] error object if request failed
1447
1498
  #
1448
- # @return [Google::Apis::GenomicsV1::Operation]
1499
+ # @return [Google::Apis::GenomicsV1::Empty]
1449
1500
  #
1450
1501
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1451
1502
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1452
1503
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1453
- def import_variants(import_variants_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1454
- command = make_simple_command(:post, 'v1/variants:import', options)
1455
- command.request_representation = Google::Apis::GenomicsV1::ImportVariantsRequest::Representation
1456
- command.request_object = import_variants_request_object
1457
- command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
1458
- command.response_class = Google::Apis::GenomicsV1::Operation
1459
- command.query['fields'] = fields unless fields.nil?
1504
+ def delete_dataset(dataset_id, quota_user: nil, fields: nil, options: nil, &block)
1505
+ command = make_simple_command(:delete, 'v1/datasets/{datasetId}', options)
1506
+ command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
1507
+ command.response_class = Google::Apis::GenomicsV1::Empty
1508
+ command.params['datasetId'] = dataset_id unless dataset_id.nil?
1460
1509
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1510
+ command.query['fields'] = fields unless fields.nil?
1461
1511
  execute_or_queue_command(command, &block)
1462
1512
  end
1463
1513
 
1464
- # Gets a list of variants matching the criteria. For the definitions of variants
1465
- # and other genomics resources, see [Fundamentals of Google Genomics](https://
1466
- # cloud.google.com/genomics/fundamentals-of-google-genomics) Implements [
1467
- # GlobalAllianceApi.searchVariants](https://github.com/ga4gh/schemas/blob/v0.5.1/
1468
- # src/main/resources/avro/variantmethods.avdl#L126).
1469
- # @param [Google::Apis::GenomicsV1::SearchVariantsRequest] search_variants_request_object
1470
- # @param [String] fields
1471
- # Selector specifying which fields to include in a partial response.
1514
+ # Lists datasets within a project.
1515
+ # For the definitions of datasets and other genomics resources, see
1516
+ # [Fundamentals of Google
1517
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1518
+ # @param [String] page_token
1519
+ # The continuation token, which is used to page through large result sets.
1520
+ # To get the next page of results, set this parameter to the value of
1521
+ # `nextPageToken` from the previous response.
1522
+ # @param [Fixnum] page_size
1523
+ # The maximum number of results to return in a single page. If unspecified,
1524
+ # defaults to 50. The maximum value is 1024.
1525
+ # @param [String] project_id
1526
+ # Required. The Google Cloud project ID to list datasets for.
1472
1527
  # @param [String] quota_user
1473
1528
  # Available to use for quota purposes for server-side applications. Can be any
1474
1529
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1530
+ # @param [String] fields
1531
+ # Selector specifying which fields to include in a partial response.
1475
1532
  # @param [Google::Apis::RequestOptions] options
1476
1533
  # Request-specific options
1477
1534
  #
1478
1535
  # @yield [result, err] Result & error if block supplied
1479
- # @yieldparam result [Google::Apis::GenomicsV1::SearchVariantsResponse] parsed result object
1536
+ # @yieldparam result [Google::Apis::GenomicsV1::ListDatasetsResponse] parsed result object
1480
1537
  # @yieldparam err [StandardError] error object if request failed
1481
1538
  #
1482
- # @return [Google::Apis::GenomicsV1::SearchVariantsResponse]
1539
+ # @return [Google::Apis::GenomicsV1::ListDatasetsResponse]
1483
1540
  #
1484
1541
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1485
1542
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1486
1543
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1487
- def search_variants(search_variants_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1488
- command = make_simple_command(:post, 'v1/variants/search', options)
1489
- command.request_representation = Google::Apis::GenomicsV1::SearchVariantsRequest::Representation
1490
- command.request_object = search_variants_request_object
1491
- command.response_representation = Google::Apis::GenomicsV1::SearchVariantsResponse::Representation
1492
- command.response_class = Google::Apis::GenomicsV1::SearchVariantsResponse
1493
- command.query['fields'] = fields unless fields.nil?
1544
+ def list_datasets(page_token: nil, page_size: nil, project_id: nil, quota_user: nil, fields: nil, options: nil, &block)
1545
+ command = make_simple_command(:get, 'v1/datasets', options)
1546
+ command.response_representation = Google::Apis::GenomicsV1::ListDatasetsResponse::Representation
1547
+ command.response_class = Google::Apis::GenomicsV1::ListDatasetsResponse
1548
+ command.query['pageToken'] = page_token unless page_token.nil?
1549
+ command.query['pageSize'] = page_size unless page_size.nil?
1550
+ command.query['projectId'] = project_id unless project_id.nil?
1494
1551
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1552
+ command.query['fields'] = fields unless fields.nil?
1495
1553
  execute_or_queue_command(command, &block)
1496
1554
  end
1497
1555
 
1498
- # Creates a new variant. For the definitions of variants and other genomics
1499
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
1500
- # genomics/fundamentals-of-google-genomics)
1501
- # @param [Google::Apis::GenomicsV1::Variant] variant_object
1502
- # @param [String] fields
1503
- # Selector specifying which fields to include in a partial response.
1556
+ # Sets the access control policy on the specified dataset. Replaces any
1557
+ # existing policy.
1558
+ # For the definitions of datasets and other genomics resources, see
1559
+ # [Fundamentals of Google
1560
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1561
+ # See <a href="/iam/docs/managing-policies#setting_a_policy">Setting a
1562
+ # Policy</a> for more information.
1563
+ # @param [String] resource
1564
+ # REQUIRED: The resource for which policy is being specified. Format is
1565
+ # `datasets/<dataset ID>`.
1566
+ # @param [Google::Apis::GenomicsV1::SetIamPolicyRequest] set_iam_policy_request_object
1504
1567
  # @param [String] quota_user
1505
1568
  # Available to use for quota purposes for server-side applications. Can be any
1506
1569
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1570
+ # @param [String] fields
1571
+ # Selector specifying which fields to include in a partial response.
1507
1572
  # @param [Google::Apis::RequestOptions] options
1508
1573
  # Request-specific options
1509
1574
  #
1510
1575
  # @yield [result, err] Result & error if block supplied
1511
- # @yieldparam result [Google::Apis::GenomicsV1::Variant] parsed result object
1576
+ # @yieldparam result [Google::Apis::GenomicsV1::Policy] parsed result object
1512
1577
  # @yieldparam err [StandardError] error object if request failed
1513
1578
  #
1514
- # @return [Google::Apis::GenomicsV1::Variant]
1579
+ # @return [Google::Apis::GenomicsV1::Policy]
1515
1580
  #
1516
1581
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1517
1582
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1518
1583
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1519
- def create_variant(variant_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1520
- command = make_simple_command(:post, 'v1/variants', options)
1521
- command.request_representation = Google::Apis::GenomicsV1::Variant::Representation
1522
- command.request_object = variant_object
1523
- command.response_representation = Google::Apis::GenomicsV1::Variant::Representation
1524
- command.response_class = Google::Apis::GenomicsV1::Variant
1525
- command.query['fields'] = fields unless fields.nil?
1584
+ def set_dataset_iam_policy(resource, set_iam_policy_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1585
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1586
+ command.request_representation = Google::Apis::GenomicsV1::SetIamPolicyRequest::Representation
1587
+ command.request_object = set_iam_policy_request_object
1588
+ command.response_representation = Google::Apis::GenomicsV1::Policy::Representation
1589
+ command.response_class = Google::Apis::GenomicsV1::Policy
1590
+ command.params['resource'] = resource unless resource.nil?
1526
1591
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1592
+ command.query['fields'] = fields unless fields.nil?
1527
1593
  execute_or_queue_command(command, &block)
1528
1594
  end
1529
1595
 
1530
- # Updates a variant. For the definitions of variants and other genomics
1531
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
1532
- # genomics/fundamentals-of-google-genomics) This method supports patch semantics.
1533
- # Returns the modified variant without its calls.
1534
- # @param [String] variant_id
1535
- # The ID of the variant to be updated.
1536
- # @param [Google::Apis::GenomicsV1::Variant] variant_object
1537
- # @param [String] update_mask
1538
- # An optional mask specifying which fields to update. At this time, mutable
1539
- # fields are names and info. Acceptable values are "names" and "info". If
1540
- # unspecified, all mutable fields will be updated.
1541
- # @param [String] fields
1542
- # Selector specifying which fields to include in a partial response.
1596
+ # Creates a new dataset.
1597
+ # For the definitions of datasets and other genomics resources, see
1598
+ # [Fundamentals of Google
1599
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1600
+ # @param [Google::Apis::GenomicsV1::Dataset] dataset_object
1543
1601
  # @param [String] quota_user
1544
1602
  # Available to use for quota purposes for server-side applications. Can be any
1545
1603
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1604
+ # @param [String] fields
1605
+ # Selector specifying which fields to include in a partial response.
1546
1606
  # @param [Google::Apis::RequestOptions] options
1547
1607
  # Request-specific options
1548
1608
  #
1549
1609
  # @yield [result, err] Result & error if block supplied
1550
- # @yieldparam result [Google::Apis::GenomicsV1::Variant] parsed result object
1610
+ # @yieldparam result [Google::Apis::GenomicsV1::Dataset] parsed result object
1551
1611
  # @yieldparam err [StandardError] error object if request failed
1552
1612
  #
1553
- # @return [Google::Apis::GenomicsV1::Variant]
1613
+ # @return [Google::Apis::GenomicsV1::Dataset]
1554
1614
  #
1555
1615
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1556
1616
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1557
1617
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1558
- def patch_variant(variant_id, variant_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1559
- command = make_simple_command(:patch, 'v1/variants/{variantId}', options)
1560
- command.request_representation = Google::Apis::GenomicsV1::Variant::Representation
1561
- command.request_object = variant_object
1562
- command.response_representation = Google::Apis::GenomicsV1::Variant::Representation
1563
- command.response_class = Google::Apis::GenomicsV1::Variant
1564
- command.params['variantId'] = variant_id unless variant_id.nil?
1565
- command.query['updateMask'] = update_mask unless update_mask.nil?
1566
- command.query['fields'] = fields unless fields.nil?
1618
+ def create_dataset(dataset_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1619
+ command = make_simple_command(:post, 'v1/datasets', options)
1620
+ command.request_representation = Google::Apis::GenomicsV1::Dataset::Representation
1621
+ command.request_object = dataset_object
1622
+ command.response_representation = Google::Apis::GenomicsV1::Dataset::Representation
1623
+ command.response_class = Google::Apis::GenomicsV1::Dataset
1567
1624
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1625
+ command.query['fields'] = fields unless fields.nil?
1568
1626
  execute_or_queue_command(command, &block)
1569
1627
  end
1570
1628
 
1571
- # Deletes a variant. For the definitions of variants and other genomics
1572
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
1573
- # genomics/fundamentals-of-google-genomics)
1574
- # @param [String] variant_id
1575
- # The ID of the variant to be deleted.
1576
- # @param [String] fields
1577
- # Selector specifying which fields to include in a partial response.
1629
+ # Deletes a variant set including all variants, call sets, and calls within.
1630
+ # This is not reversible.
1631
+ # For the definitions of variant sets and other genomics resources, see
1632
+ # [Fundamentals of Google
1633
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1634
+ # @param [String] variant_set_id
1635
+ # The ID of the variant set to be deleted.
1578
1636
  # @param [String] quota_user
1579
1637
  # Available to use for quota purposes for server-side applications. Can be any
1580
1638
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1639
+ # @param [String] fields
1640
+ # Selector specifying which fields to include in a partial response.
1581
1641
  # @param [Google::Apis::RequestOptions] options
1582
1642
  # Request-specific options
1583
1643
  #
@@ -1590,145 +1650,136 @@ module Google
1590
1650
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1591
1651
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1592
1652
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1593
- def delete_variant(variant_id, fields: nil, quota_user: nil, options: nil, &block)
1594
- command = make_simple_command(:delete, 'v1/variants/{variantId}', options)
1653
+ def delete_variantset(variant_set_id, quota_user: nil, fields: nil, options: nil, &block)
1654
+ command = make_simple_command(:delete, 'v1/variantsets/{variantSetId}', options)
1595
1655
  command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
1596
1656
  command.response_class = Google::Apis::GenomicsV1::Empty
1597
- command.params['variantId'] = variant_id unless variant_id.nil?
1598
- command.query['fields'] = fields unless fields.nil?
1657
+ command.params['variantSetId'] = variant_set_id unless variant_set_id.nil?
1599
1658
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1659
+ command.query['fields'] = fields unless fields.nil?
1600
1660
  execute_or_queue_command(command, &block)
1601
1661
  end
1602
1662
 
1603
- # Gets a variant by ID. For the definitions of variants and other genomics
1604
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
1605
- # genomics/fundamentals-of-google-genomics)
1606
- # @param [String] variant_id
1607
- # The ID of the variant.
1608
- # @param [String] fields
1609
- # Selector specifying which fields to include in a partial response.
1663
+ # Creates a new variant set.
1664
+ # For the definitions of variant sets and other genomics resources, see
1665
+ # [Fundamentals of Google
1666
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1667
+ # The provided variant set must have a valid `datasetId` set - all other
1668
+ # fields are optional. Note that the `id` field will be ignored, as this is
1669
+ # assigned by the server.
1670
+ # @param [Google::Apis::GenomicsV1::VariantSet] variant_set_object
1610
1671
  # @param [String] quota_user
1611
1672
  # Available to use for quota purposes for server-side applications. Can be any
1612
1673
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1674
+ # @param [String] fields
1675
+ # Selector specifying which fields to include in a partial response.
1613
1676
  # @param [Google::Apis::RequestOptions] options
1614
1677
  # Request-specific options
1615
1678
  #
1616
1679
  # @yield [result, err] Result & error if block supplied
1617
- # @yieldparam result [Google::Apis::GenomicsV1::Variant] parsed result object
1680
+ # @yieldparam result [Google::Apis::GenomicsV1::VariantSet] parsed result object
1618
1681
  # @yieldparam err [StandardError] error object if request failed
1619
1682
  #
1620
- # @return [Google::Apis::GenomicsV1::Variant]
1683
+ # @return [Google::Apis::GenomicsV1::VariantSet]
1621
1684
  #
1622
1685
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1623
1686
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1624
1687
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1625
- def get_variant(variant_id, fields: nil, quota_user: nil, options: nil, &block)
1626
- command = make_simple_command(:get, 'v1/variants/{variantId}', options)
1627
- command.response_representation = Google::Apis::GenomicsV1::Variant::Representation
1628
- command.response_class = Google::Apis::GenomicsV1::Variant
1629
- command.params['variantId'] = variant_id unless variant_id.nil?
1630
- command.query['fields'] = fields unless fields.nil?
1688
+ def create_variantset(variant_set_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1689
+ command = make_simple_command(:post, 'v1/variantsets', options)
1690
+ command.request_representation = Google::Apis::GenomicsV1::VariantSet::Representation
1691
+ command.request_object = variant_set_object
1692
+ command.response_representation = Google::Apis::GenomicsV1::VariantSet::Representation
1693
+ command.response_class = Google::Apis::GenomicsV1::VariantSet
1631
1694
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1695
+ command.query['fields'] = fields unless fields.nil?
1632
1696
  execute_or_queue_command(command, &block)
1633
1697
  end
1634
1698
 
1635
- # Merges the given variants with existing variants. For the definitions of
1636
- # variants and other genomics resources, see [Fundamentals of Google Genomics](
1637
- # https://cloud.google.com/genomics/fundamentals-of-google-genomics) Each
1638
- # variant will be merged with an existing variant that matches its reference
1639
- # sequence, start, end, reference bases, and alternative bases. If no such
1640
- # variant exists, a new one will be created. When variants are merged, the call
1641
- # information from the new variant is added to the existing variant. Variant
1642
- # info fields are merged as specified in the infoMergeConfig field of the
1643
- # MergeVariantsRequest. Please exercise caution when using this method! It is
1644
- # easy to introduce mistakes in existing variants and difficult to back out of
1645
- # them. For example, suppose you were trying to merge a new variant with an
1646
- # existing one and both variants contain calls that belong to callsets with the
1647
- # same callset ID. // Existing variant - irrelevant fields trimmed for clarity `
1648
- # "variantSetId": "10473108253681171589", "referenceName": "1", "start": "10582",
1649
- # "referenceBases": "G", "alternateBases": [ "A" ], "calls": [ ` "callSetId": "
1650
- # 10473108253681171589-0", "callSetName": "CALLSET0", "genotype": [ 0, 1 ], ` ] `
1651
- # // New variant with conflicting call information ` "variantSetId": "
1652
- # 10473108253681171589", "referenceName": "1", "start": "10582", "referenceBases"
1653
- # : "G", "alternateBases": [ "A" ], "calls": [ ` "callSetId": "
1654
- # 10473108253681171589-0", "callSetName": "CALLSET0", "genotype": [ 1, 1 ], ` ] `
1655
- # The resulting merged variant would overwrite the existing calls with those
1656
- # from the new variant: ` "variantSetId": "10473108253681171589", "referenceName"
1657
- # : "1", "start": "10582", "referenceBases": "G", "alternateBases": [ "A" ], "
1658
- # calls": [ ` "callSetId": "10473108253681171589-0", "callSetName": "CALLSET0", "
1659
- # genotype": [ 1, 1 ], ` ] ` This may be the desired outcome, but it is up to
1660
- # the user to determine if if that is indeed the case.
1661
- # @param [Google::Apis::GenomicsV1::MergeVariantsRequest] merge_variants_request_object
1662
- # @param [String] fields
1663
- # Selector specifying which fields to include in a partial response.
1699
+ # Exports variant set data to an external destination.
1700
+ # For the definitions of variant sets and other genomics resources, see
1701
+ # [Fundamentals of Google
1702
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1703
+ # @param [String] variant_set_id
1704
+ # Required. The ID of the variant set that contains variant data which
1705
+ # should be exported. The caller must have READ access to this variant set.
1706
+ # @param [Google::Apis::GenomicsV1::ExportVariantSetRequest] export_variant_set_request_object
1664
1707
  # @param [String] quota_user
1665
1708
  # Available to use for quota purposes for server-side applications. Can be any
1666
1709
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1710
+ # @param [String] fields
1711
+ # Selector specifying which fields to include in a partial response.
1667
1712
  # @param [Google::Apis::RequestOptions] options
1668
1713
  # Request-specific options
1669
1714
  #
1670
1715
  # @yield [result, err] Result & error if block supplied
1671
- # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
1716
+ # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
1672
1717
  # @yieldparam err [StandardError] error object if request failed
1673
1718
  #
1674
- # @return [Google::Apis::GenomicsV1::Empty]
1719
+ # @return [Google::Apis::GenomicsV1::Operation]
1675
1720
  #
1676
1721
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1677
1722
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1678
1723
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1679
- def merge_variants(merge_variants_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1680
- command = make_simple_command(:post, 'v1/variants:merge', options)
1681
- command.request_representation = Google::Apis::GenomicsV1::MergeVariantsRequest::Representation
1682
- command.request_object = merge_variants_request_object
1683
- command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
1684
- command.response_class = Google::Apis::GenomicsV1::Empty
1685
- command.query['fields'] = fields unless fields.nil?
1724
+ def export_variant_set(variant_set_id, export_variant_set_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1725
+ command = make_simple_command(:post, 'v1/variantsets/{variantSetId}:export', options)
1726
+ command.request_representation = Google::Apis::GenomicsV1::ExportVariantSetRequest::Representation
1727
+ command.request_object = export_variant_set_request_object
1728
+ command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
1729
+ command.response_class = Google::Apis::GenomicsV1::Operation
1730
+ command.params['variantSetId'] = variant_set_id unless variant_set_id.nil?
1686
1731
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1732
+ command.query['fields'] = fields unless fields.nil?
1687
1733
  execute_or_queue_command(command, &block)
1688
1734
  end
1689
1735
 
1690
- # Returns a stream of all the variants matching the search request, ordered by
1691
- # reference name, position, and ID.
1692
- # @param [Google::Apis::GenomicsV1::StreamVariantsRequest] stream_variants_request_object
1693
- # @param [String] fields
1694
- # Selector specifying which fields to include in a partial response.
1736
+ # Returns a list of all variant sets matching search criteria.
1737
+ # For the definitions of variant sets and other genomics resources, see
1738
+ # [Fundamentals of Google
1739
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1740
+ # Implements
1741
+ # [GlobalAllianceApi.searchVariantSets](https://github.com/ga4gh/schemas/blob/v0.
1742
+ # 5.1/src/main/resources/avro/variantmethods.avdl#L49).
1743
+ # @param [Google::Apis::GenomicsV1::SearchVariantSetsRequest] search_variant_sets_request_object
1695
1744
  # @param [String] quota_user
1696
1745
  # Available to use for quota purposes for server-side applications. Can be any
1697
1746
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1747
+ # @param [String] fields
1748
+ # Selector specifying which fields to include in a partial response.
1698
1749
  # @param [Google::Apis::RequestOptions] options
1699
1750
  # Request-specific options
1700
1751
  #
1701
1752
  # @yield [result, err] Result & error if block supplied
1702
- # @yieldparam result [Google::Apis::GenomicsV1::StreamVariantsResponse] parsed result object
1753
+ # @yieldparam result [Google::Apis::GenomicsV1::SearchVariantSetsResponse] parsed result object
1703
1754
  # @yieldparam err [StandardError] error object if request failed
1704
1755
  #
1705
- # @return [Google::Apis::GenomicsV1::StreamVariantsResponse]
1756
+ # @return [Google::Apis::GenomicsV1::SearchVariantSetsResponse]
1706
1757
  #
1707
1758
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1708
1759
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1709
1760
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1710
- def stream_variants(stream_variants_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1711
- command = make_simple_command(:post, 'v1/variants:stream', options)
1712
- command.request_representation = Google::Apis::GenomicsV1::StreamVariantsRequest::Representation
1713
- command.request_object = stream_variants_request_object
1714
- command.response_representation = Google::Apis::GenomicsV1::StreamVariantsResponse::Representation
1715
- command.response_class = Google::Apis::GenomicsV1::StreamVariantsResponse
1716
- command.query['fields'] = fields unless fields.nil?
1761
+ def search_variant_sets(search_variant_sets_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1762
+ command = make_simple_command(:post, 'v1/variantsets/search', options)
1763
+ command.request_representation = Google::Apis::GenomicsV1::SearchVariantSetsRequest::Representation
1764
+ command.request_object = search_variant_sets_request_object
1765
+ command.response_representation = Google::Apis::GenomicsV1::SearchVariantSetsResponse::Representation
1766
+ command.response_class = Google::Apis::GenomicsV1::SearchVariantSetsResponse
1717
1767
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1768
+ command.query['fields'] = fields unless fields.nil?
1718
1769
  execute_or_queue_command(command, &block)
1719
1770
  end
1720
1771
 
1721
- # Creates a new variant set. For the definitions of variant sets and other
1722
- # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
1723
- # com/genomics/fundamentals-of-google-genomics) The provided variant set must
1724
- # have a valid `datasetId` set - all other fields are optional. Note that the `
1725
- # id` field will be ignored, as this is assigned by the server.
1726
- # @param [Google::Apis::GenomicsV1::VariantSet] variant_set_object
1727
- # @param [String] fields
1728
- # Selector specifying which fields to include in a partial response.
1772
+ # Gets a variant set by ID.
1773
+ # For the definitions of variant sets and other genomics resources, see
1774
+ # [Fundamentals of Google
1775
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1776
+ # @param [String] variant_set_id
1777
+ # Required. The ID of the variant set.
1729
1778
  # @param [String] quota_user
1730
1779
  # Available to use for quota purposes for server-side applications. Can be any
1731
1780
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1781
+ # @param [String] fields
1782
+ # Selector specifying which fields to include in a partial response.
1732
1783
  # @param [Google::Apis::RequestOptions] options
1733
1784
  # Request-specific options
1734
1785
  #
@@ -1741,359 +1792,406 @@ module Google
1741
1792
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1742
1793
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1743
1794
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1744
- def create_variantset(variant_set_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1745
- command = make_simple_command(:post, 'v1/variantsets', options)
1746
- command.request_representation = Google::Apis::GenomicsV1::VariantSet::Representation
1747
- command.request_object = variant_set_object
1795
+ def get_variantset(variant_set_id, quota_user: nil, fields: nil, options: nil, &block)
1796
+ command = make_simple_command(:get, 'v1/variantsets/{variantSetId}', options)
1748
1797
  command.response_representation = Google::Apis::GenomicsV1::VariantSet::Representation
1749
1798
  command.response_class = Google::Apis::GenomicsV1::VariantSet
1750
- command.query['fields'] = fields unless fields.nil?
1799
+ command.params['variantSetId'] = variant_set_id unless variant_set_id.nil?
1751
1800
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1801
+ command.query['fields'] = fields unless fields.nil?
1752
1802
  execute_or_queue_command(command, &block)
1753
1803
  end
1754
1804
 
1755
- # Exports variant set data to an external destination. For the definitions of
1756
- # variant sets and other genomics resources, see [Fundamentals of Google
1805
+ # Updates a variant set using patch semantics.
1806
+ # For the definitions of variant sets and other genomics resources, see
1807
+ # [Fundamentals of Google
1757
1808
  # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
1758
1809
  # @param [String] variant_set_id
1759
- # Required. The ID of the variant set that contains variant data which should be
1760
- # exported. The caller must have READ access to this variant set.
1761
- # @param [Google::Apis::GenomicsV1::ExportVariantSetRequest] export_variant_set_request_object
1762
- # @param [String] fields
1763
- # Selector specifying which fields to include in a partial response.
1810
+ # The ID of the variant to be updated (must already exist).
1811
+ # @param [Google::Apis::GenomicsV1::VariantSet] variant_set_object
1812
+ # @param [String] update_mask
1813
+ # An optional mask specifying which fields to update. Supported fields:
1814
+ # * metadata.
1815
+ # * name.
1816
+ # * description.
1817
+ # Leaving `updateMask` unset is equivalent to specifying all mutable
1818
+ # fields.
1764
1819
  # @param [String] quota_user
1765
1820
  # Available to use for quota purposes for server-side applications. Can be any
1766
1821
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1822
+ # @param [String] fields
1823
+ # Selector specifying which fields to include in a partial response.
1767
1824
  # @param [Google::Apis::RequestOptions] options
1768
1825
  # Request-specific options
1769
1826
  #
1770
1827
  # @yield [result, err] Result & error if block supplied
1771
- # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
1828
+ # @yieldparam result [Google::Apis::GenomicsV1::VariantSet] parsed result object
1772
1829
  # @yieldparam err [StandardError] error object if request failed
1773
1830
  #
1774
- # @return [Google::Apis::GenomicsV1::Operation]
1831
+ # @return [Google::Apis::GenomicsV1::VariantSet]
1775
1832
  #
1776
1833
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1777
1834
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1778
1835
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1779
- def export_variant_set(variant_set_id, export_variant_set_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1780
- command = make_simple_command(:post, 'v1/variantsets/{variantSetId}:export', options)
1781
- command.request_representation = Google::Apis::GenomicsV1::ExportVariantSetRequest::Representation
1782
- command.request_object = export_variant_set_request_object
1783
- command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
1784
- command.response_class = Google::Apis::GenomicsV1::Operation
1836
+ def patch_variantset(variant_set_id, variant_set_object = nil, update_mask: nil, quota_user: nil, fields: nil, options: nil, &block)
1837
+ command = make_simple_command(:patch, 'v1/variantsets/{variantSetId}', options)
1838
+ command.request_representation = Google::Apis::GenomicsV1::VariantSet::Representation
1839
+ command.request_object = variant_set_object
1840
+ command.response_representation = Google::Apis::GenomicsV1::VariantSet::Representation
1841
+ command.response_class = Google::Apis::GenomicsV1::VariantSet
1785
1842
  command.params['variantSetId'] = variant_set_id unless variant_set_id.nil?
1786
- command.query['fields'] = fields unless fields.nil?
1843
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1787
1844
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1845
+ command.query['fields'] = fields unless fields.nil?
1788
1846
  execute_or_queue_command(command, &block)
1789
1847
  end
1790
1848
 
1791
- # Gets a variant set by ID. For the definitions of variant sets and other
1792
- # genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.
1793
- # com/genomics/fundamentals-of-google-genomics)
1794
- # @param [String] variant_set_id
1795
- # Required. The ID of the variant set.
1796
- # @param [String] fields
1797
- # Selector specifying which fields to include in a partial response.
1849
+ # Creates one or more new annotations atomically. All annotations must
1850
+ # belong to the same annotation set. Caller must have WRITE
1851
+ # permission for this annotation set. For optimal performance, batch
1852
+ # positionally adjacent annotations together.
1853
+ # If the request has a systemic issue, such as an attempt to write to
1854
+ # an inaccessible annotation set, the entire RPC will fail accordingly. For
1855
+ # lesser data issues, when possible an error will be isolated to the
1856
+ # corresponding batch entry in the response; the remaining well formed
1857
+ # annotations will be created normally.
1858
+ # For details on the requirements for each individual annotation resource,
1859
+ # see
1860
+ # CreateAnnotation.
1861
+ # @param [Google::Apis::GenomicsV1::BatchCreateAnnotationsRequest] batch_create_annotations_request_object
1798
1862
  # @param [String] quota_user
1799
1863
  # Available to use for quota purposes for server-side applications. Can be any
1800
1864
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1865
+ # @param [String] fields
1866
+ # Selector specifying which fields to include in a partial response.
1801
1867
  # @param [Google::Apis::RequestOptions] options
1802
1868
  # Request-specific options
1803
1869
  #
1804
1870
  # @yield [result, err] Result & error if block supplied
1805
- # @yieldparam result [Google::Apis::GenomicsV1::VariantSet] parsed result object
1871
+ # @yieldparam result [Google::Apis::GenomicsV1::BatchCreateAnnotationsResponse] parsed result object
1806
1872
  # @yieldparam err [StandardError] error object if request failed
1807
1873
  #
1808
- # @return [Google::Apis::GenomicsV1::VariantSet]
1874
+ # @return [Google::Apis::GenomicsV1::BatchCreateAnnotationsResponse]
1809
1875
  #
1810
1876
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1811
1877
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1812
1878
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1813
- def get_variantset(variant_set_id, fields: nil, quota_user: nil, options: nil, &block)
1814
- command = make_simple_command(:get, 'v1/variantsets/{variantSetId}', options)
1815
- command.response_representation = Google::Apis::GenomicsV1::VariantSet::Representation
1816
- command.response_class = Google::Apis::GenomicsV1::VariantSet
1817
- command.params['variantSetId'] = variant_set_id unless variant_set_id.nil?
1818
- command.query['fields'] = fields unless fields.nil?
1879
+ def batch_create_annotations(batch_create_annotations_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1880
+ command = make_simple_command(:post, 'v1/annotations:batchCreate', options)
1881
+ command.request_representation = Google::Apis::GenomicsV1::BatchCreateAnnotationsRequest::Representation
1882
+ command.request_object = batch_create_annotations_request_object
1883
+ command.response_representation = Google::Apis::GenomicsV1::BatchCreateAnnotationsResponse::Representation
1884
+ command.response_class = Google::Apis::GenomicsV1::BatchCreateAnnotationsResponse
1819
1885
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1886
+ command.query['fields'] = fields unless fields.nil?
1820
1887
  execute_or_queue_command(command, &block)
1821
1888
  end
1822
1889
 
1823
- # Returns a list of all variant sets matching search criteria. For the
1824
- # definitions of variant sets and other genomics resources, see [Fundamentals of
1825
- # Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-
1826
- # genomics) Implements [GlobalAllianceApi.searchVariantSets](https://github.com/
1827
- # ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variantmethods.avdl#L49).
1828
- # @param [Google::Apis::GenomicsV1::SearchVariantSetsRequest] search_variant_sets_request_object
1829
- # @param [String] fields
1830
- # Selector specifying which fields to include in a partial response.
1890
+ # Searches for annotations that match the given criteria. Results are
1891
+ # ordered by genomic coordinate (by reference sequence, then position).
1892
+ # Annotations with equivalent genomic coordinates are returned in an
1893
+ # unspecified order. This order is consistent, such that two queries for the
1894
+ # same content (regardless of page size) yield annotations in the same order
1895
+ # across their respective streams of paginated responses. Caller must have
1896
+ # READ permission for the queried annotation sets.
1897
+ # @param [Google::Apis::GenomicsV1::SearchAnnotationsRequest] search_annotations_request_object
1831
1898
  # @param [String] quota_user
1832
1899
  # Available to use for quota purposes for server-side applications. Can be any
1833
1900
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1901
+ # @param [String] fields
1902
+ # Selector specifying which fields to include in a partial response.
1834
1903
  # @param [Google::Apis::RequestOptions] options
1835
1904
  # Request-specific options
1836
1905
  #
1837
1906
  # @yield [result, err] Result & error if block supplied
1838
- # @yieldparam result [Google::Apis::GenomicsV1::SearchVariantSetsResponse] parsed result object
1907
+ # @yieldparam result [Google::Apis::GenomicsV1::SearchAnnotationsResponse] parsed result object
1839
1908
  # @yieldparam err [StandardError] error object if request failed
1840
1909
  #
1841
- # @return [Google::Apis::GenomicsV1::SearchVariantSetsResponse]
1910
+ # @return [Google::Apis::GenomicsV1::SearchAnnotationsResponse]
1842
1911
  #
1843
1912
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1844
1913
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1845
1914
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1846
- def search_variant_sets(search_variant_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1847
- command = make_simple_command(:post, 'v1/variantsets/search', options)
1848
- command.request_representation = Google::Apis::GenomicsV1::SearchVariantSetsRequest::Representation
1849
- command.request_object = search_variant_sets_request_object
1850
- command.response_representation = Google::Apis::GenomicsV1::SearchVariantSetsResponse::Representation
1851
- command.response_class = Google::Apis::GenomicsV1::SearchVariantSetsResponse
1852
- command.query['fields'] = fields unless fields.nil?
1915
+ def search_annotations(search_annotations_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1916
+ command = make_simple_command(:post, 'v1/annotations/search', options)
1917
+ command.request_representation = Google::Apis::GenomicsV1::SearchAnnotationsRequest::Representation
1918
+ command.request_object = search_annotations_request_object
1919
+ command.response_representation = Google::Apis::GenomicsV1::SearchAnnotationsResponse::Representation
1920
+ command.response_class = Google::Apis::GenomicsV1::SearchAnnotationsResponse
1853
1921
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1922
+ command.query['fields'] = fields unless fields.nil?
1854
1923
  execute_or_queue_command(command, &block)
1855
1924
  end
1856
1925
 
1857
- # Deletes a variant set including all variants, call sets, and calls within.
1858
- # This is not reversible. For the definitions of variant sets and other genomics
1859
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
1860
- # genomics/fundamentals-of-google-genomics)
1861
- # @param [String] variant_set_id
1862
- # The ID of the variant set to be deleted.
1863
- # @param [String] fields
1864
- # Selector specifying which fields to include in a partial response.
1926
+ # Gets an annotation. Caller must have READ permission
1927
+ # for the associated annotation set.
1928
+ # @param [String] annotation_id
1929
+ # The ID of the annotation to be retrieved.
1865
1930
  # @param [String] quota_user
1866
1931
  # Available to use for quota purposes for server-side applications. Can be any
1867
1932
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1933
+ # @param [String] fields
1934
+ # Selector specifying which fields to include in a partial response.
1868
1935
  # @param [Google::Apis::RequestOptions] options
1869
1936
  # Request-specific options
1870
1937
  #
1871
1938
  # @yield [result, err] Result & error if block supplied
1872
- # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
1939
+ # @yieldparam result [Google::Apis::GenomicsV1::Annotation] parsed result object
1873
1940
  # @yieldparam err [StandardError] error object if request failed
1874
1941
  #
1875
- # @return [Google::Apis::GenomicsV1::Empty]
1942
+ # @return [Google::Apis::GenomicsV1::Annotation]
1876
1943
  #
1877
1944
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1878
1945
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1879
1946
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1880
- def delete_variantset(variant_set_id, fields: nil, quota_user: nil, options: nil, &block)
1881
- command = make_simple_command(:delete, 'v1/variantsets/{variantSetId}', options)
1882
- command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
1883
- command.response_class = Google::Apis::GenomicsV1::Empty
1884
- command.params['variantSetId'] = variant_set_id unless variant_set_id.nil?
1885
- command.query['fields'] = fields unless fields.nil?
1947
+ def get_annotation(annotation_id, quota_user: nil, fields: nil, options: nil, &block)
1948
+ command = make_simple_command(:get, 'v1/annotations/{annotationId}', options)
1949
+ command.response_representation = Google::Apis::GenomicsV1::Annotation::Representation
1950
+ command.response_class = Google::Apis::GenomicsV1::Annotation
1951
+ command.params['annotationId'] = annotation_id unless annotation_id.nil?
1886
1952
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1953
+ command.query['fields'] = fields unless fields.nil?
1887
1954
  execute_or_queue_command(command, &block)
1888
1955
  end
1889
1956
 
1890
- # Updates a variant set using patch semantics. For the definitions of variant
1891
- # sets and other genomics resources, see [Fundamentals of Google Genomics](https:
1892
- # //cloud.google.com/genomics/fundamentals-of-google-genomics)
1893
- # @param [String] variant_set_id
1894
- # The ID of the variant to be updated (must already exist).
1895
- # @param [Google::Apis::GenomicsV1::VariantSet] variant_set_object
1957
+ # Updates an annotation. Caller must have
1958
+ # WRITE permission for the associated dataset.
1959
+ # @param [String] annotation_id
1960
+ # The ID of the annotation to be updated.
1961
+ # @param [Google::Apis::GenomicsV1::Annotation] annotation_object
1896
1962
  # @param [String] update_mask
1897
- # An optional mask specifying which fields to update. Supported fields: *
1898
- # metadata. * name. * description. Leaving `updateMask` unset is equivalent to
1899
- # specifying all mutable fields.
1900
- # @param [String] fields
1901
- # Selector specifying which fields to include in a partial response.
1963
+ # An optional mask specifying which fields to update. Mutable fields are
1964
+ # name,
1965
+ # variant,
1966
+ # transcript, and
1967
+ # info. If unspecified, all mutable
1968
+ # fields will be updated.
1902
1969
  # @param [String] quota_user
1903
1970
  # Available to use for quota purposes for server-side applications. Can be any
1904
1971
  # arbitrary string assigned to a user, but should not exceed 40 characters.
1972
+ # @param [String] fields
1973
+ # Selector specifying which fields to include in a partial response.
1905
1974
  # @param [Google::Apis::RequestOptions] options
1906
1975
  # Request-specific options
1907
1976
  #
1908
1977
  # @yield [result, err] Result & error if block supplied
1909
- # @yieldparam result [Google::Apis::GenomicsV1::VariantSet] parsed result object
1978
+ # @yieldparam result [Google::Apis::GenomicsV1::Annotation] parsed result object
1910
1979
  # @yieldparam err [StandardError] error object if request failed
1911
1980
  #
1912
- # @return [Google::Apis::GenomicsV1::VariantSet]
1981
+ # @return [Google::Apis::GenomicsV1::Annotation]
1913
1982
  #
1914
1983
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1915
1984
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1916
1985
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1917
- def patch_variantset(variant_set_id, variant_set_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1918
- command = make_simple_command(:patch, 'v1/variantsets/{variantSetId}', options)
1919
- command.request_representation = Google::Apis::GenomicsV1::VariantSet::Representation
1920
- command.request_object = variant_set_object
1921
- command.response_representation = Google::Apis::GenomicsV1::VariantSet::Representation
1922
- command.response_class = Google::Apis::GenomicsV1::VariantSet
1923
- command.params['variantSetId'] = variant_set_id unless variant_set_id.nil?
1986
+ def update_annotation(annotation_id, annotation_object = nil, update_mask: nil, quota_user: nil, fields: nil, options: nil, &block)
1987
+ command = make_simple_command(:put, 'v1/annotations/{annotationId}', options)
1988
+ command.request_representation = Google::Apis::GenomicsV1::Annotation::Representation
1989
+ command.request_object = annotation_object
1990
+ command.response_representation = Google::Apis::GenomicsV1::Annotation::Representation
1991
+ command.response_class = Google::Apis::GenomicsV1::Annotation
1992
+ command.params['annotationId'] = annotation_id unless annotation_id.nil?
1924
1993
  command.query['updateMask'] = update_mask unless update_mask.nil?
1925
- command.query['fields'] = fields unless fields.nil?
1926
1994
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1995
+ command.query['fields'] = fields unless fields.nil?
1927
1996
  execute_or_queue_command(command, &block)
1928
1997
  end
1929
1998
 
1930
- # Gets a list of call sets matching the criteria. For the definitions of call
1931
- # sets and other genomics resources, see [Fundamentals of Google Genomics](https:
1932
- # //cloud.google.com/genomics/fundamentals-of-google-genomics) Implements [
1933
- # GlobalAllianceApi.searchCallSets](https://github.com/ga4gh/schemas/blob/v0.5.1/
1934
- # src/main/resources/avro/variantmethods.avdl#L178).
1935
- # @param [Google::Apis::GenomicsV1::SearchCallSetsRequest] search_call_sets_request_object
1936
- # @param [String] fields
1937
- # Selector specifying which fields to include in a partial response.
1999
+ # Deletes an annotation. Caller must have WRITE permission for
2000
+ # the associated annotation set.
2001
+ # @param [String] annotation_id
2002
+ # The ID of the annotation to be deleted.
1938
2003
  # @param [String] quota_user
1939
2004
  # Available to use for quota purposes for server-side applications. Can be any
1940
2005
  # arbitrary string assigned to a user, but should not exceed 40 characters.
2006
+ # @param [String] fields
2007
+ # Selector specifying which fields to include in a partial response.
1941
2008
  # @param [Google::Apis::RequestOptions] options
1942
2009
  # Request-specific options
1943
2010
  #
1944
2011
  # @yield [result, err] Result & error if block supplied
1945
- # @yieldparam result [Google::Apis::GenomicsV1::SearchCallSetsResponse] parsed result object
2012
+ # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
1946
2013
  # @yieldparam err [StandardError] error object if request failed
1947
2014
  #
1948
- # @return [Google::Apis::GenomicsV1::SearchCallSetsResponse]
2015
+ # @return [Google::Apis::GenomicsV1::Empty]
1949
2016
  #
1950
2017
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1951
2018
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1952
2019
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1953
- def search_call_sets(search_call_sets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1954
- command = make_simple_command(:post, 'v1/callsets/search', options)
1955
- command.request_representation = Google::Apis::GenomicsV1::SearchCallSetsRequest::Representation
1956
- command.request_object = search_call_sets_request_object
1957
- command.response_representation = Google::Apis::GenomicsV1::SearchCallSetsResponse::Representation
1958
- command.response_class = Google::Apis::GenomicsV1::SearchCallSetsResponse
1959
- command.query['fields'] = fields unless fields.nil?
2020
+ def delete_annotation(annotation_id, quota_user: nil, fields: nil, options: nil, &block)
2021
+ command = make_simple_command(:delete, 'v1/annotations/{annotationId}', options)
2022
+ command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
2023
+ command.response_class = Google::Apis::GenomicsV1::Empty
2024
+ command.params['annotationId'] = annotation_id unless annotation_id.nil?
1960
2025
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2026
+ command.query['fields'] = fields unless fields.nil?
1961
2027
  execute_or_queue_command(command, &block)
1962
2028
  end
1963
2029
 
1964
- # Creates a new call set. For the definitions of call sets and other genomics
1965
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
1966
- # genomics/fundamentals-of-google-genomics)
1967
- # @param [Google::Apis::GenomicsV1::CallSet] call_set_object
1968
- # @param [String] fields
1969
- # Selector specifying which fields to include in a partial response.
2030
+ # Creates a new annotation. Caller must have WRITE permission
2031
+ # for the associated annotation set.
2032
+ # The following fields are required:
2033
+ # * annotationSetId
2034
+ # * referenceName or
2035
+ # referenceId
2036
+ # ### Transcripts
2037
+ # For annotations of type TRANSCRIPT, the following fields of
2038
+ # transcript must be provided:
2039
+ # * exons.start
2040
+ # * exons.end
2041
+ # All other fields may be optionally specified, unless documented as being
2042
+ # server-generated (for example, the `id` field). The annotated
2043
+ # range must be no longer than 100Mbp (mega base pairs). See the
2044
+ # Annotation resource
2045
+ # for additional restrictions on each field.
2046
+ # @param [Google::Apis::GenomicsV1::Annotation] annotation_object
1970
2047
  # @param [String] quota_user
1971
2048
  # Available to use for quota purposes for server-side applications. Can be any
1972
2049
  # arbitrary string assigned to a user, but should not exceed 40 characters.
2050
+ # @param [String] fields
2051
+ # Selector specifying which fields to include in a partial response.
1973
2052
  # @param [Google::Apis::RequestOptions] options
1974
2053
  # Request-specific options
1975
2054
  #
1976
2055
  # @yield [result, err] Result & error if block supplied
1977
- # @yieldparam result [Google::Apis::GenomicsV1::CallSet] parsed result object
2056
+ # @yieldparam result [Google::Apis::GenomicsV1::Annotation] parsed result object
1978
2057
  # @yieldparam err [StandardError] error object if request failed
1979
2058
  #
1980
- # @return [Google::Apis::GenomicsV1::CallSet]
2059
+ # @return [Google::Apis::GenomicsV1::Annotation]
1981
2060
  #
1982
2061
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1983
2062
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1984
2063
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1985
- def create_call_set(call_set_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1986
- command = make_simple_command(:post, 'v1/callsets', options)
1987
- command.request_representation = Google::Apis::GenomicsV1::CallSet::Representation
1988
- command.request_object = call_set_object
1989
- command.response_representation = Google::Apis::GenomicsV1::CallSet::Representation
1990
- command.response_class = Google::Apis::GenomicsV1::CallSet
1991
- command.query['fields'] = fields unless fields.nil?
2064
+ def create_annotation(annotation_object = nil, quota_user: nil, fields: nil, options: nil, &block)
2065
+ command = make_simple_command(:post, 'v1/annotations', options)
2066
+ command.request_representation = Google::Apis::GenomicsV1::Annotation::Representation
2067
+ command.request_object = annotation_object
2068
+ command.response_representation = Google::Apis::GenomicsV1::Annotation::Representation
2069
+ command.response_class = Google::Apis::GenomicsV1::Annotation
1992
2070
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2071
+ command.query['fields'] = fields unless fields.nil?
1993
2072
  execute_or_queue_command(command, &block)
1994
2073
  end
1995
2074
 
1996
- # Updates a call set. For the definitions of call sets and other genomics
1997
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
1998
- # genomics/fundamentals-of-google-genomics) This method supports patch semantics.
1999
- # @param [String] call_set_id
2000
- # The ID of the call set to be updated.
2001
- # @param [Google::Apis::GenomicsV1::CallSet] call_set_object
2002
- # @param [String] update_mask
2003
- # An optional mask specifying which fields to update. At this time, the only
2004
- # mutable field is name. The only acceptable value is "name". If unspecified,
2005
- # all mutable fields will be updated.
2006
- # @param [String] fields
2007
- # Selector specifying which fields to include in a partial response.
2075
+ # Starts asynchronous cancellation on a long-running operation. The server makes
2076
+ # a best effort to cancel the operation, but success is not guaranteed. Clients
2077
+ # may use Operations.GetOperation or Operations.ListOperations to check whether
2078
+ # the cancellation succeeded or the operation completed despite cancellation.
2079
+ # @param [String] name
2080
+ # The name of the operation resource to be cancelled.
2081
+ # @param [Google::Apis::GenomicsV1::CancelOperationRequest] cancel_operation_request_object
2008
2082
  # @param [String] quota_user
2009
2083
  # Available to use for quota purposes for server-side applications. Can be any
2010
2084
  # arbitrary string assigned to a user, but should not exceed 40 characters.
2085
+ # @param [String] fields
2086
+ # Selector specifying which fields to include in a partial response.
2011
2087
  # @param [Google::Apis::RequestOptions] options
2012
2088
  # Request-specific options
2013
2089
  #
2014
2090
  # @yield [result, err] Result & error if block supplied
2015
- # @yieldparam result [Google::Apis::GenomicsV1::CallSet] parsed result object
2091
+ # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
2016
2092
  # @yieldparam err [StandardError] error object if request failed
2017
2093
  #
2018
- # @return [Google::Apis::GenomicsV1::CallSet]
2094
+ # @return [Google::Apis::GenomicsV1::Empty]
2019
2095
  #
2020
2096
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2021
2097
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2022
2098
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2023
- def patch_call_set(call_set_id, call_set_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2024
- command = make_simple_command(:patch, 'v1/callsets/{callSetId}', options)
2025
- command.request_representation = Google::Apis::GenomicsV1::CallSet::Representation
2026
- command.request_object = call_set_object
2027
- command.response_representation = Google::Apis::GenomicsV1::CallSet::Representation
2028
- command.response_class = Google::Apis::GenomicsV1::CallSet
2029
- command.params['callSetId'] = call_set_id unless call_set_id.nil?
2030
- command.query['updateMask'] = update_mask unless update_mask.nil?
2031
- command.query['fields'] = fields unless fields.nil?
2099
+ def cancel_operation(name, cancel_operation_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
2100
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
2101
+ command.request_representation = Google::Apis::GenomicsV1::CancelOperationRequest::Representation
2102
+ command.request_object = cancel_operation_request_object
2103
+ command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
2104
+ command.response_class = Google::Apis::GenomicsV1::Empty
2105
+ command.params['name'] = name unless name.nil?
2032
2106
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2107
+ command.query['fields'] = fields unless fields.nil?
2033
2108
  execute_or_queue_command(command, &block)
2034
2109
  end
2035
2110
 
2036
- # Deletes a call set. For the definitions of call sets and other genomics
2037
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
2038
- # genomics/fundamentals-of-google-genomics)
2039
- # @param [String] call_set_id
2040
- # The ID of the call set to be deleted.
2041
- # @param [String] fields
2042
- # Selector specifying which fields to include in a partial response.
2111
+ # Lists operations that match the specified filter in the request.
2112
+ # @param [String] name
2113
+ # The name of the operation collection.
2114
+ # @param [String] page_token
2115
+ # The standard list page token.
2116
+ # @param [Fixnum] page_size
2117
+ # The maximum number of results to return. If unspecified, defaults to
2118
+ # 256. The maximum value is 2048.
2119
+ # @param [String] filter
2120
+ # A string for filtering Operations.
2121
+ # The following filter fields are supported&#58;
2122
+ # * projectId&#58; Required. Corresponds to
2123
+ # OperationMetadata.projectId.
2124
+ # * createTime&#58; The time this job was created, in seconds from the
2125
+ # [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `<=`
2126
+ # operators.
2127
+ # * status&#58; Can be `RUNNING`, `SUCCESS`, `FAILURE`, or `CANCELED`. Only
2128
+ # one status may be specified.
2129
+ # * labels.key where key is a label key.
2130
+ # Examples&#58;
2131
+ # * `projectId = my-project AND createTime >= 1432140000`
2132
+ # * `projectId = my-project AND createTime >= 1432140000 AND createTime <=
2133
+ # 1432150000 AND status = RUNNING`
2134
+ # * `projectId = my-project AND labels.color = *`
2135
+ # * `projectId = my-project AND labels.color = red`
2043
2136
  # @param [String] quota_user
2044
2137
  # Available to use for quota purposes for server-side applications. Can be any
2045
2138
  # arbitrary string assigned to a user, but should not exceed 40 characters.
2139
+ # @param [String] fields
2140
+ # Selector specifying which fields to include in a partial response.
2046
2141
  # @param [Google::Apis::RequestOptions] options
2047
2142
  # Request-specific options
2048
2143
  #
2049
2144
  # @yield [result, err] Result & error if block supplied
2050
- # @yieldparam result [Google::Apis::GenomicsV1::Empty] parsed result object
2145
+ # @yieldparam result [Google::Apis::GenomicsV1::ListOperationsResponse] parsed result object
2051
2146
  # @yieldparam err [StandardError] error object if request failed
2052
2147
  #
2053
- # @return [Google::Apis::GenomicsV1::Empty]
2148
+ # @return [Google::Apis::GenomicsV1::ListOperationsResponse]
2054
2149
  #
2055
2150
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2056
2151
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2057
2152
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2058
- def delete_call_set(call_set_id, fields: nil, quota_user: nil, options: nil, &block)
2059
- command = make_simple_command(:delete, 'v1/callsets/{callSetId}', options)
2060
- command.response_representation = Google::Apis::GenomicsV1::Empty::Representation
2061
- command.response_class = Google::Apis::GenomicsV1::Empty
2062
- command.params['callSetId'] = call_set_id unless call_set_id.nil?
2063
- command.query['fields'] = fields unless fields.nil?
2153
+ def list_operations(name, page_token: nil, page_size: nil, filter: nil, quota_user: nil, fields: nil, options: nil, &block)
2154
+ command = make_simple_command(:get, 'v1/{+name}', options)
2155
+ command.response_representation = Google::Apis::GenomicsV1::ListOperationsResponse::Representation
2156
+ command.response_class = Google::Apis::GenomicsV1::ListOperationsResponse
2157
+ command.params['name'] = name unless name.nil?
2158
+ command.query['pageToken'] = page_token unless page_token.nil?
2159
+ command.query['pageSize'] = page_size unless page_size.nil?
2160
+ command.query['filter'] = filter unless filter.nil?
2064
2161
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2162
+ command.query['fields'] = fields unless fields.nil?
2065
2163
  execute_or_queue_command(command, &block)
2066
2164
  end
2067
2165
 
2068
- # Gets a call set by ID. For the definitions of call sets and other genomics
2069
- # resources, see [Fundamentals of Google Genomics](https://cloud.google.com/
2070
- # genomics/fundamentals-of-google-genomics)
2071
- # @param [String] call_set_id
2072
- # The ID of the call set.
2073
- # @param [String] fields
2074
- # Selector specifying which fields to include in a partial response.
2166
+ # Gets the latest state of a long-running operation. Clients can use this
2167
+ # method to poll the operation result at intervals as recommended by the API
2168
+ # service.
2169
+ # @param [String] name
2170
+ # The name of the operation resource.
2075
2171
  # @param [String] quota_user
2076
2172
  # Available to use for quota purposes for server-side applications. Can be any
2077
2173
  # arbitrary string assigned to a user, but should not exceed 40 characters.
2174
+ # @param [String] fields
2175
+ # Selector specifying which fields to include in a partial response.
2078
2176
  # @param [Google::Apis::RequestOptions] options
2079
2177
  # Request-specific options
2080
2178
  #
2081
2179
  # @yield [result, err] Result & error if block supplied
2082
- # @yieldparam result [Google::Apis::GenomicsV1::CallSet] parsed result object
2180
+ # @yieldparam result [Google::Apis::GenomicsV1::Operation] parsed result object
2083
2181
  # @yieldparam err [StandardError] error object if request failed
2084
2182
  #
2085
- # @return [Google::Apis::GenomicsV1::CallSet]
2183
+ # @return [Google::Apis::GenomicsV1::Operation]
2086
2184
  #
2087
2185
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2088
2186
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2089
2187
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2090
- def get_call_set(call_set_id, fields: nil, quota_user: nil, options: nil, &block)
2091
- command = make_simple_command(:get, 'v1/callsets/{callSetId}', options)
2092
- command.response_representation = Google::Apis::GenomicsV1::CallSet::Representation
2093
- command.response_class = Google::Apis::GenomicsV1::CallSet
2094
- command.params['callSetId'] = call_set_id unless call_set_id.nil?
2095
- command.query['fields'] = fields unless fields.nil?
2188
+ def get_operation(name, quota_user: nil, fields: nil, options: nil, &block)
2189
+ command = make_simple_command(:get, 'v1/{+name}', options)
2190
+ command.response_representation = Google::Apis::GenomicsV1::Operation::Representation
2191
+ command.response_class = Google::Apis::GenomicsV1::Operation
2192
+ command.params['name'] = name unless name.nil?
2096
2193
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2194
+ command.query['fields'] = fields unless fields.nil?
2097
2195
  execute_or_queue_command(command, &block)
2098
2196
  end
2099
2197