google-api-client 0.11.1 → 0.11.2

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