google-api-client 0.9.28 → 0.10.0

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