google-api-client 0.11.1 → 0.11.2

Sign up to get free protection for your applications and to get access to all the features.
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)