Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(542)

Side by Side Diff: discovery/googleapis/genomics__v1.json

Issue 3006323002: Api-Roll 54: 2017-09-11 (Closed)
Patch Set: use 2.0.0-dev.infinity sdk constraint in pubspecs Created 3 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « discovery/googleapis/games__v1.json ('k') | discovery/googleapis/gmail__v1.json » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 { 1 {
2 "auth": { 2 "auth": {
3 "oauth2": { 3 "oauth2": {
4 "scopes": { 4 "scopes": {
5 "https://www.googleapis.com/auth/genomics.readonly": { 5 "https://www.googleapis.com/auth/genomics.readonly": {
6 "description": "View Genomics data" 6 "description": "View Genomics data"
7 }, 7 },
8 "https://www.googleapis.com/auth/cloud-platform": { 8 "https://www.googleapis.com/auth/cloud-platform": {
9 "description": "View and manage your data across Google Clou d Platform services" 9 "description": "View and manage your data across Google Clou d Platform services"
10 }, 10 },
(...skipping 18 matching lines...) Expand all
29 "icons": { 29 "icons": {
30 "x16": "http://www.google.com/images/icons/product/search-16.gif", 30 "x16": "http://www.google.com/images/icons/product/search-16.gif",
31 "x32": "http://www.google.com/images/icons/product/search-32.gif" 31 "x32": "http://www.google.com/images/icons/product/search-32.gif"
32 }, 32 },
33 "id": "genomics:v1", 33 "id": "genomics:v1",
34 "kind": "discovery#restDescription", 34 "kind": "discovery#restDescription",
35 "name": "genomics", 35 "name": "genomics",
36 "ownerDomain": "google.com", 36 "ownerDomain": "google.com",
37 "ownerName": "Google", 37 "ownerName": "Google",
38 "parameters": { 38 "parameters": {
39 "alt": {
40 "default": "json",
41 "description": "Data format for response.",
42 "enum": [
43 "json",
44 "media",
45 "proto"
46 ],
47 "enumDescriptions": [
48 "Responses with Content-Type of application/json",
49 "Media download with context-dependent Content-Type",
50 "Responses with Content-Type of application/x-protobuf"
51 ],
52 "location": "query",
53 "type": "string"
54 },
39 "access_token": { 55 "access_token": {
40 "description": "OAuth access token.", 56 "description": "OAuth access token.",
41 "location": "query", 57 "location": "query",
42 "type": "string" 58 "type": "string"
43 }, 59 },
44 "key": { 60 "key": {
45 "description": "API key. Your API key identifies your project and pr ovides you with API access, quota, and reports. Required unless you provide an O Auth 2.0 token.", 61 "description": "API key. Your API key identifies your project and pr ovides you with API access, quota, and reports. Required unless you provide an O Auth 2.0 token.",
46 "location": "query", 62 "location": "query",
47 "type": "string" 63 "type": "string"
48 }, 64 },
(...skipping 22 matching lines...) Expand all
71 "description": "Upload protocol for media (e.g. \"raw\", \"multipart \").", 87 "description": "Upload protocol for media (e.g. \"raw\", \"multipart \").",
72 "location": "query", 88 "location": "query",
73 "type": "string" 89 "type": "string"
74 }, 90 },
75 "prettyPrint": { 91 "prettyPrint": {
76 "default": "true", 92 "default": "true",
77 "description": "Returns response with indentations and line breaks." , 93 "description": "Returns response with indentations and line breaks." ,
78 "location": "query", 94 "location": "query",
79 "type": "boolean" 95 "type": "boolean"
80 }, 96 },
97 "fields": {
98 "description": "Selector specifying which fields to include in a par tial response.",
99 "location": "query",
100 "type": "string"
101 },
81 "uploadType": { 102 "uploadType": {
82 "description": "Legacy upload protocol for media (e.g. \"media\", \" multipart\").", 103 "description": "Legacy upload protocol for media (e.g. \"media\", \" multipart\").",
83 "location": "query", 104 "location": "query",
84 "type": "string" 105 "type": "string"
85 }, 106 },
86 "fields": {
87 "description": "Selector specifying which fields to include in a par tial response.",
88 "location": "query",
89 "type": "string"
90 },
91 "$.xgafv": { 107 "$.xgafv": {
92 "description": "V1 error format.", 108 "description": "V1 error format.",
93 "enum": [ 109 "enum": [
94 "1", 110 "1",
95 "2" 111 "2"
96 ], 112 ],
97 "enumDescriptions": [ 113 "enumDescriptions": [
98 "v1 error format", 114 "v1 error format",
99 "v2 error format" 115 "v2 error format"
100 ], 116 ],
101 "location": "query", 117 "location": "query",
102 "type": "string" 118 "type": "string"
103 }, 119 },
104 "callback": { 120 "callback": {
105 "description": "JSONP", 121 "description": "JSONP",
106 "location": "query", 122 "location": "query",
107 "type": "string" 123 "type": "string"
108 },
109 "alt": {
110 "default": "json",
111 "description": "Data format for response.",
112 "enum": [
113 "json",
114 "media",
115 "proto"
116 ],
117 "enumDescriptions": [
118 "Responses with Content-Type of application/json",
119 "Media download with context-dependent Content-Type",
120 "Responses with Content-Type of application/x-protobuf"
121 ],
122 "location": "query",
123 "type": "string"
124 } 124 }
125 }, 125 },
126 "protocol": "rest", 126 "protocol": "rest",
127 "resources": { 127 "resources": {
128 "annotationsets": { 128 "referencesets": {
129 "methods": { 129 "methods": {
130 "delete": { 130 "search": {
131 "description": "Deletes an annotation set. Caller must have WRITE permission\nfor the associated annotation set.", 131 "description": "Searches for reference sets which match the given criteria.\n\nFor the definitions of references and other genomics resource s, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fun damentals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.searchReferenceS ets](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/refere ncemethods.avdl#L71)",
132 "httpMethod": "DELETE", 132 "httpMethod": "POST",
133 "id": "genomics.annotationsets.delete", 133 "id": "genomics.referencesets.search",
134 "parameterOrder": [ 134 "parameterOrder": [],
135 "annotationSetId" 135 "parameters": {},
136 ], 136 "path": "v1/referencesets/search",
137 "parameters": { 137 "request": {
138 "annotationSetId": { 138 "$ref": "SearchReferenceSetsRequest"
139 "description": "The ID of the annotation set to be d eleted.",
140 "location": "path",
141 "required": true,
142 "type": "string"
143 }
144 }, 139 },
145 "path": "v1/annotationsets/{annotationSetId}",
146 "response": { 140 "response": {
147 "$ref": "Empty" 141 "$ref": "SearchReferenceSetsResponse"
148 }, 142 },
149 "scopes": [ 143 "scopes": [
150 "https://www.googleapis.com/auth/cloud-platform", 144 "https://www.googleapis.com/auth/cloud-platform",
151 "https://www.googleapis.com/auth/genomics"
152 ]
153 },
154 "search": {
155 "description": "Searches for annotation sets that match the given criteria. Annotation sets\nare returned in an unspecified order. This orde r is consistent, such that\ntwo queries for the same content (regardless of page size) yield annotation\nsets in the same order across their respective streams of paginated\nresponses. Caller must have READ permission for the queried datase ts.",
156 "httpMethod": "POST",
157 "id": "genomics.annotationsets.search",
158 "parameterOrder": [],
159 "parameters": {},
160 "path": "v1/annotationsets/search",
161 "request": {
162 "$ref": "SearchAnnotationSetsRequest"
163 },
164 "response": {
165 "$ref": "SearchAnnotationSetsResponse"
166 },
167 "scopes": [
168 "https://www.googleapis.com/auth/cloud-platform",
169 "https://www.googleapis.com/auth/genomics", 145 "https://www.googleapis.com/auth/genomics",
170 "https://www.googleapis.com/auth/genomics.readonly" 146 "https://www.googleapis.com/auth/genomics.readonly"
171 ] 147 ]
172 }, 148 },
173 "get": { 149 "get": {
174 "description": "Gets an annotation set. Caller must have REA D permission for\nthe associated dataset.", 150 "description": "Gets a reference set.\n\nFor the definitions of references and other genomics resources, see\n[Fundamentals of Google\nGenom ics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nImple ments\n[GlobalAllianceApi.getReferenceSet](https://github.com/ga4gh/schemas/blob /v0.5.1/src/main/resources/avro/referencemethods.avdl#L83).",
175 "httpMethod": "GET", 151 "httpMethod": "GET",
176 "id": "genomics.annotationsets.get", 152 "id": "genomics.referencesets.get",
177 "parameterOrder": [ 153 "parameterOrder": [
178 "annotationSetId" 154 "referenceSetId"
179 ], 155 ],
180 "parameters": { 156 "parameters": {
181 "annotationSetId": { 157 "referenceSetId": {
182 "description": "The ID of the annotation set to be r etrieved.", 158 "description": "The ID of the reference set.",
183 "location": "path", 159 "location": "path",
184 "required": true, 160 "required": true,
185 "type": "string" 161 "type": "string"
186 } 162 }
187 }, 163 },
188 "path": "v1/annotationsets/{annotationSetId}", 164 "path": "v1/referencesets/{referenceSetId}",
189 "response": { 165 "response": {
190 "$ref": "AnnotationSet" 166 "$ref": "ReferenceSet"
191 }, 167 },
192 "scopes": [ 168 "scopes": [
193 "https://www.googleapis.com/auth/cloud-platform", 169 "https://www.googleapis.com/auth/cloud-platform",
194 "https://www.googleapis.com/auth/genomics", 170 "https://www.googleapis.com/auth/genomics",
195 "https://www.googleapis.com/auth/genomics.readonly" 171 "https://www.googleapis.com/auth/genomics.readonly"
196 ] 172 ]
197 }, 173 }
198 "update": { 174 }
199 "description": "Updates an annotation set. The update must r espect all mutability\nrestrictions and other invariants described on the annota tion set resource.\nCaller must have WRITE permission for the associated dataset .", 175 },
200 "httpMethod": "PUT", 176 "readgroupsets": {
201 "id": "genomics.annotationsets.update", 177 "methods": {
178 "delete": {
179 "description": "Deletes a read group set.\n\nFor the definit ions of read group sets and other genomics resources, see\n[Fundamentals of Goog le\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) ",
180 "httpMethod": "DELETE",
181 "id": "genomics.readgroupsets.delete",
202 "parameterOrder": [ 182 "parameterOrder": [
203 "annotationSetId" 183 "readGroupSetId"
204 ], 184 ],
205 "parameters": { 185 "parameters": {
206 "updateMask": { 186 "readGroupSetId": {
207 "description": "An optional mask specifying which fi elds to update. Mutable fields are\nname,\nsource_uri, and\ninfo. If unspecified , all\nmutable fields will be updated.", 187 "description": "The ID of the read group set to be d eleted. The caller must have WRITE\npermissions to the dataset associated with t his read group set.",
208 "format": "google-fieldmask",
209 "location": "query",
210 "type": "string"
211 },
212 "annotationSetId": {
213 "description": "The ID of the annotation set to be u pdated.",
214 "location": "path", 188 "location": "path",
215 "required": true, 189 "required": true,
216 "type": "string" 190 "type": "string"
217 } 191 }
218 }, 192 },
219 "path": "v1/annotationsets/{annotationSetId}", 193 "path": "v1/readgroupsets/{readGroupSetId}",
220 "request": {
221 "$ref": "AnnotationSet"
222 },
223 "response": { 194 "response": {
224 "$ref": "AnnotationSet" 195 "$ref": "Empty"
225 }, 196 },
226 "scopes": [ 197 "scopes": [
227 "https://www.googleapis.com/auth/cloud-platform", 198 "https://www.googleapis.com/auth/cloud-platform",
228 "https://www.googleapis.com/auth/genomics" 199 "https://www.googleapis.com/auth/genomics"
229 ] 200 ]
230 }, 201 },
231 "create": { 202 "import": {
232 "description": "Creates a new annotation set. Caller must ha ve WRITE permission for the\nassociated dataset.\n\nThe following fields are req uired:\n\n * datasetId\n * referenceSetId\n\nAll other fields may be optionall y specified, unless documented as being\nserver-generated (for example, the `id` field).", 203 "description": "Creates read group sets by asynchronously im porting the provided\ninformation.\n\nFor the definitions of read group sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud .google.com/genomics/fundamentals-of-google-genomics)\n\nThe caller must have WR ITE permissions to the dataset.\n\n## Notes on [BAM](https://samtools.github.io/ hts-specs/SAMv1.pdf) import\n\n- Tags will be converted to strings - tag types a re not preserved\n- Comments (`@CO`) in the input file header will not be preser ved\n- Original header order of references (`@SQ`) will not be preserved\n- Any reverse stranded unmapped reads will be reverse complemented, and\ntheir qualiti es (also the \"BQ\" and \"OQ\" tags, if any) will be reversed\n- Unmapped reads will be stripped of positional information (reference name\nand position)",
233 "httpMethod": "POST", 204 "httpMethod": "POST",
234 "id": "genomics.annotationsets.create", 205 "id": "genomics.readgroupsets.import",
235 "parameterOrder": [], 206 "parameterOrder": [],
236 "parameters": {}, 207 "parameters": {},
237 "path": "v1/annotationsets", 208 "path": "v1/readgroupsets:import",
238 "request": { 209 "request": {
239 "$ref": "AnnotationSet" 210 "$ref": "ImportReadGroupSetsRequest"
240 }, 211 },
241 "response": { 212 "response": {
242 "$ref": "AnnotationSet" 213 "$ref": "Operation"
243 }, 214 },
244 "scopes": [ 215 "scopes": [
245 "https://www.googleapis.com/auth/cloud-platform", 216 "https://www.googleapis.com/auth/cloud-platform",
217 "https://www.googleapis.com/auth/devstorage.read_write",
246 "https://www.googleapis.com/auth/genomics" 218 "https://www.googleapis.com/auth/genomics"
247 ] 219 ]
248 } 220 },
249 } 221 "export": {
250 }, 222 "description": "Exports a read group set to a BAM file in Go ogle Cloud Storage.\n\nFor the definitions of read group sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/gen omics/fundamentals-of-google-genomics)\n\nNote that currently there may be some differences between exported BAM\nfiles and the original BAM file at the time of import. See\nImportReadGroupSets\nfor caveats.",
251 "variants": {
252 "methods": {
253 "create": {
254 "description": "Creates a new variant.\n\nFor the definition s of variants and other genomics resources, see\n[Fundamentals of Google\nGenomi cs](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
255 "httpMethod": "POST", 223 "httpMethod": "POST",
256 "id": "genomics.variants.create", 224 "id": "genomics.readgroupsets.export",
257 "parameterOrder": [], 225 "parameterOrder": [
258 "parameters": {}, 226 "readGroupSetId"
259 "path": "v1/variants", 227 ],
228 "parameters": {
229 "readGroupSetId": {
230 "description": "Required. The ID of the read group s et to export. The caller must have\nREAD access to this read group set.",
231 "location": "path",
232 "required": true,
233 "type": "string"
234 }
235 },
236 "path": "v1/readgroupsets/{readGroupSetId}:export",
260 "request": { 237 "request": {
261 "$ref": "Variant" 238 "$ref": "ExportReadGroupSetRequest"
262 }, 239 },
263 "response": { 240 "response": {
264 "$ref": "Variant" 241 "$ref": "Operation"
265 }, 242 },
266 "scopes": [ 243 "scopes": [
267 "https://www.googleapis.com/auth/cloud-platform", 244 "https://www.googleapis.com/auth/cloud-platform",
245 "https://www.googleapis.com/auth/devstorage.read_write",
268 "https://www.googleapis.com/auth/genomics" 246 "https://www.googleapis.com/auth/genomics"
269 ] 247 ]
270 }, 248 },
271 "search": { 249 "search": {
272 "description": "Gets a list of variants matching the criteri a.\n\nFor the definitions of variants and other genomics resources, see\n[Fundam entals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of-go ogle-genomics)\n\nImplements\n[GlobalAllianceApi.searchVariants](https://github. com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variantmethods.avdl#L126). ", 250 "description": "Searches for read group sets matching the cr iteria.\n\nFor the definitions of read group sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundam entals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.searchReadGroupSets ](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/readmetho ds.avdl#L135).",
273 "httpMethod": "POST", 251 "httpMethod": "POST",
274 "id": "genomics.variants.search", 252 "id": "genomics.readgroupsets.search",
275 "parameterOrder": [], 253 "parameterOrder": [],
276 "parameters": {}, 254 "parameters": {},
277 "path": "v1/variants/search", 255 "path": "v1/readgroupsets/search",
278 "request": { 256 "request": {
279 "$ref": "SearchVariantsRequest" 257 "$ref": "SearchReadGroupSetsRequest"
280 }, 258 },
281 "response": { 259 "response": {
282 "$ref": "SearchVariantsResponse" 260 "$ref": "SearchReadGroupSetsResponse"
283 }, 261 },
284 "scopes": [ 262 "scopes": [
285 "https://www.googleapis.com/auth/cloud-platform", 263 "https://www.googleapis.com/auth/cloud-platform",
286 "https://www.googleapis.com/auth/genomics", 264 "https://www.googleapis.com/auth/genomics",
287 "https://www.googleapis.com/auth/genomics.readonly" 265 "https://www.googleapis.com/auth/genomics.readonly"
288 ] 266 ]
289 }, 267 },
290 "get": { 268 "get": {
291 "description": "Gets a variant by ID.\n\nFor the definitions of variants and other genomics resources, see\n[Fundamentals of Google\nGenomic s](https://cloud.google.com/genomics/fundamentals-of-google-genomics)", 269 "description": "Gets a read group set by ID.\n\nFor the defi nitions of read group sets and other genomics resources, see\n[Fundamentals of G oogle\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomi cs)",
292 "httpMethod": "GET", 270 "httpMethod": "GET",
293 "id": "genomics.variants.get", 271 "id": "genomics.readgroupsets.get",
294 "parameterOrder": [ 272 "parameterOrder": [
295 "variantId" 273 "readGroupSetId"
296 ], 274 ],
297 "parameters": { 275 "parameters": {
298 "variantId": { 276 "readGroupSetId": {
299 "description": "The ID of the variant.", 277 "description": "The ID of the read group set.",
300 "location": "path", 278 "location": "path",
301 "required": true, 279 "required": true,
302 "type": "string" 280 "type": "string"
303 } 281 }
304 }, 282 },
305 "path": "v1/variants/{variantId}", 283 "path": "v1/readgroupsets/{readGroupSetId}",
306 "response": { 284 "response": {
307 "$ref": "Variant" 285 "$ref": "ReadGroupSet"
308 }, 286 },
309 "scopes": [ 287 "scopes": [
310 "https://www.googleapis.com/auth/cloud-platform", 288 "https://www.googleapis.com/auth/cloud-platform",
311 "https://www.googleapis.com/auth/genomics", 289 "https://www.googleapis.com/auth/genomics",
312 "https://www.googleapis.com/auth/genomics.readonly" 290 "https://www.googleapis.com/auth/genomics.readonly"
313 ] 291 ]
314 }, 292 },
315 "patch": { 293 "patch": {
316 "description": "Updates a variant.\n\nFor the definitions of variants and other genomics resources, see\n[Fundamentals of Google\nGenomics]( https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nThis metho d supports patch semantics. Returns the modified variant without\nits calls.", 294 "description": "Updates a read group set.\n\nFor the definit ions of read group sets and other genomics resources, see\n[Fundamentals of Goog le\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) \n\nThis method supports patch semantics.",
317 "httpMethod": "PATCH", 295 "httpMethod": "PATCH",
318 "id": "genomics.variants.patch", 296 "id": "genomics.readgroupsets.patch",
319 "parameterOrder": [ 297 "parameterOrder": [
320 "variantId" 298 "readGroupSetId"
321 ], 299 ],
322 "parameters": { 300 "parameters": {
301 "readGroupSetId": {
302 "description": "The ID of the read group set to be u pdated. The caller must have WRITE\npermissions to the dataset associated with t his read group set.",
303 "location": "path",
304 "required": true,
305 "type": "string"
306 },
323 "updateMask": { 307 "updateMask": {
324 "description": "An optional mask specifying which fi elds to update. At this time, mutable\nfields are names and\ninfo. Acceptable va lues are \"names\" and\n\"info\". If unspecified, all mutable fields will be upd ated.", 308 "description": "An optional mask specifying which fi elds to update. Supported fields:\n\n* name.\n* referenceSetId.\n\nLeaving `upda teMask` unset is equivalent to specifying all mutable\nfields.",
325 "format": "google-fieldmask", 309 "format": "google-fieldmask",
326 "location": "query", 310 "location": "query",
327 "type": "string" 311 "type": "string"
328 },
329 "variantId": {
330 "description": "The ID of the variant to be updated. ",
331 "location": "path",
332 "required": true,
333 "type": "string"
334 } 312 }
335 }, 313 },
336 "path": "v1/variants/{variantId}", 314 "path": "v1/readgroupsets/{readGroupSetId}",
337 "request": { 315 "request": {
338 "$ref": "Variant" 316 "$ref": "ReadGroupSet"
339 }, 317 },
340 "response": { 318 "response": {
341 "$ref": "Variant" 319 "$ref": "ReadGroupSet"
342 },
343 "scopes": [
344 "https://www.googleapis.com/auth/cloud-platform",
345 "https://www.googleapis.com/auth/genomics"
346 ]
347 },
348 "merge": {
349 "description": "Merges the given variants with existing vari ants.\n\nFor the definitions of variants and other genomics resources, see\n[Fun damentals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of -google-genomics)\n\nEach variant will be\nmerged with an existing variant that matches its reference sequence,\nstart, end, reference bases, and alternative ba ses. If no such variant\nexists, a new one will be created.\n\nWhen variants are merged, the call information from the new variant\nis added to the existing var iant. Variant info fields are merged as\nspecified in the\ninfoMergeConfig\nfiel d of the MergeVariantsRequest.\n\nPlease exercise caution when using this method ! It is easy to introduce\nmistakes in existing variants and difficult to back out of them. For\nexample,\nsuppose you were trying to merge a new variant with an existing one and\nboth\nvariants contain calls that belong to callsets with the same callset ID.\n\n // Existing variant - irrelevant fields trimmed for clarity\n {\n \"variantSetId\": \"10473108253681171589\",\n \"r eferenceName\": \"1\",\n \"start\": \"10582\",\n \"referenceBases\ ": \"G\",\n \"alternateBases\": [\n \"A\"\n ],\n \"calls\": [\n {\n \"callSetId\": \"10473108253681171 589-0\",\n \"callSetName\": \"CALLSET0\",\n \"geno type\": [\n 0,\n 1\n ],\n }\n ]\n }\n\n // New variant with conflicting call inform ation\n {\n \"variantSetId\": \"10473108253681171589\",\n \"ref erenceName\": \"1\",\n \"start\": \"10582\",\n \"referenceBases\": \"G\",\n \"alternateBases\": [\n \"A\"\n ],\n \ "calls\": [\n {\n \"callSetId\": \"1047310825368117158 9-0\",\n \"callSetName\": \"CALLSET0\",\n \"genoty pe\": [\n 1,\n 1\n ],\n }\n ]\n }\n\nThe resulting merged variant would overwrite the existing calls with those\nfrom the new variant:\n\n {\n \"variantSetI d\": \"10473108253681171589\",\n \"referenceName\": \"1\",\n \"sta rt\": \"10582\",\n \"referenceBases\": \"G\",\n \"alternateBases\" : [\n \"A\"\n ],\n \"calls\": [\n {\n \"callSetId\": \"10473108253681171589-0\",\n \"callSetNa me\": \"CALLSET0\",\n \"genotype\": [\n 1,\n 1\n ],\n }\n ]\n }\n\nThis may be the desired outcome, but it is up to the user to determine if\nif that i s indeed the case.",
350 "httpMethod": "POST",
351 "id": "genomics.variants.merge",
352 "parameterOrder": [],
353 "parameters": {},
354 "path": "v1/variants:merge",
355 "request": {
356 "$ref": "MergeVariantsRequest"
357 },
358 "response": {
359 "$ref": "Empty"
360 },
361 "scopes": [
362 "https://www.googleapis.com/auth/cloud-platform",
363 "https://www.googleapis.com/auth/genomics"
364 ]
365 },
366 "import": {
367 "description": "Creates variant data by asynchronously impor ting the provided information.\n\nFor the definitions of variant sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google .com/genomics/fundamentals-of-google-genomics)\n\nThe variants for import will b e merged with any existing variant that\nmatches its reference sequence, start, end, reference bases, and\nalternative bases. If no such variant exists, a new o ne will be created.\n\nWhen variants are merged, the call information from the n ew variant\nis added to the existing variant, and Variant info fields are merged \nas specified in\ninfoMergeConfig.\nAs a special case, for single-sample VCF fi les, QUAL and FILTER fields will\nbe moved to the call level; these are sometime s interpreted in a\ncall-specific context.\nImported VCF headers are appended to the metadata already in a variant set.",
368 "httpMethod": "POST",
369 "id": "genomics.variants.import",
370 "parameterOrder": [],
371 "parameters": {},
372 "path": "v1/variants:import",
373 "request": {
374 "$ref": "ImportVariantsRequest"
375 },
376 "response": {
377 "$ref": "Operation"
378 },
379 "scopes": [
380 "https://www.googleapis.com/auth/cloud-platform",
381 "https://www.googleapis.com/auth/devstorage.read_write",
382 "https://www.googleapis.com/auth/genomics"
383 ]
384 },
385 "delete": {
386 "description": "Deletes a variant.\n\nFor the definitions of variants and other genomics resources, see\n[Fundamentals of Google\nGenomics]( https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
387 "httpMethod": "DELETE",
388 "id": "genomics.variants.delete",
389 "parameterOrder": [
390 "variantId"
391 ],
392 "parameters": {
393 "variantId": {
394 "description": "The ID of the variant to be deleted. ",
395 "location": "path",
396 "required": true,
397 "type": "string"
398 }
399 },
400 "path": "v1/variants/{variantId}",
401 "response": {
402 "$ref": "Empty"
403 }, 320 },
404 "scopes": [ 321 "scopes": [
405 "https://www.googleapis.com/auth/cloud-platform", 322 "https://www.googleapis.com/auth/cloud-platform",
406 "https://www.googleapis.com/auth/genomics" 323 "https://www.googleapis.com/auth/genomics"
407 ] 324 ]
408 } 325 }
409 }
410 },
411 "references": {
412 "methods": {
413 "search": {
414 "description": "Searches for references which match the give n criteria.\n\nFor the definitions of references and other genomics resources, s ee\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundame ntals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.searchReferences](ht tps://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/referencemeth ods.avdl#L146).",
415 "httpMethod": "POST",
416 "id": "genomics.references.search",
417 "parameterOrder": [],
418 "parameters": {},
419 "path": "v1/references/search",
420 "request": {
421 "$ref": "SearchReferencesRequest"
422 },
423 "response": {
424 "$ref": "SearchReferencesResponse"
425 },
426 "scopes": [
427 "https://www.googleapis.com/auth/cloud-platform",
428 "https://www.googleapis.com/auth/genomics",
429 "https://www.googleapis.com/auth/genomics.readonly"
430 ]
431 },
432 "get": {
433 "description": "Gets a reference.\n\nFor the definitions of references and other genomics resources, see\n[Fundamentals of Google\nGenomics] (https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nImplement s\n[GlobalAllianceApi.getReference](https://github.com/ga4gh/schemas/blob/v0.5.1 /src/main/resources/avro/referencemethods.avdl#L158).",
434 "httpMethod": "GET",
435 "id": "genomics.references.get",
436 "parameterOrder": [
437 "referenceId"
438 ],
439 "parameters": {
440 "referenceId": {
441 "description": "The ID of the reference.",
442 "location": "path",
443 "required": true,
444 "type": "string"
445 }
446 },
447 "path": "v1/references/{referenceId}",
448 "response": {
449 "$ref": "Reference"
450 },
451 "scopes": [
452 "https://www.googleapis.com/auth/cloud-platform",
453 "https://www.googleapis.com/auth/genomics",
454 "https://www.googleapis.com/auth/genomics.readonly"
455 ]
456 }
457 }, 326 },
458 "resources": { 327 "resources": {
459 "bases": { 328 "coveragebuckets": {
460 "methods": { 329 "methods": {
461 "list": { 330 "list": {
462 "description": "Lists the bases in a reference, opti onally restricted to a range.\n\nFor the definitions of references and other gen omics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.co m/genomics/fundamentals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.ge tReferenceBases](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources /avro/referencemethods.avdl#L221).", 331 "description": "Lists fixed width coverage buckets f or a read group set, each of which\ncorrespond to a range of a reference sequenc e. Each bucket summarizes\ncoverage information across its corresponding genomic range.\n\nFor the definitions of read group sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundam entals-of-google-genomics)\n\nCoverage is defined as the number of reads which a re aligned to a given\nbase in the reference sequence. Coverage buckets are avai lable at several\nprecomputed bucket widths, enabling retrieval of various cover age 'zoom\nlevels'. The caller must have READ permissions for the target read gr oup\nset.",
463 "httpMethod": "GET", 332 "httpMethod": "GET",
464 "id": "genomics.references.bases.list", 333 "id": "genomics.readgroupsets.coveragebuckets.list",
465 "parameterOrder": [ 334 "parameterOrder": [
466 "referenceId" 335 "readGroupSetId"
467 ], 336 ],
468 "parameters": { 337 "parameters": {
469 "pageSize": {
470 "description": "The maximum number of bases to return in a single page. If unspecified,\ndefaults to 200Kbp (kilo base pairs ). The maximum value is 10Mbp (mega base\npairs).",
471 "format": "int32",
472 "location": "query",
473 "type": "integer"
474 },
475 "start": { 338 "start": {
476 "description": "The start position (0-based) of this query. Defaults to 0.", 339 "description": "The start position of the ra nge on the reference, 0-based inclusive. If\nspecified, `referenceName` must als o be specified. Defaults to 0.",
477 "format": "int64", 340 "format": "int64",
478 "location": "query", 341 "location": "query",
479 "type": "string" 342 "type": "string"
480 }, 343 },
481 "referenceId": { 344 "readGroupSetId": {
482 "description": "The ID of the reference.", 345 "description": "Required. The ID of the read group set over which coverage is requested.",
483 "location": "path", 346 "location": "path",
484 "required": true, 347 "required": true,
485 "type": "string" 348 "type": "string"
486 }, 349 },
487 "end": { 350 "targetBucketWidth": {
488 "description": "The end position (0-based, e xclusive) of this query. Defaults to the length\nof this reference.", 351 "description": "The desired width of each re ported coverage bucket in base pairs. This\nwill be rounded down to the nearest precomputed bucket width; the value\nof which is returned as `bucketWidth` in th e response. Defaults\nto infinity (each bucket spans an entire reference sequenc e) or the length\nof the target range, if specified. The smallest precomputed\n` bucketWidth` is currently 2048 base pairs; this is subject to\nchange.",
489 "format": "int64", 352 "format": "int64",
490 "location": "query", 353 "location": "query",
491 "type": "string" 354 "type": "string"
355 },
356 "referenceName": {
357 "description": "The name of the reference to query, within the reference set associated\nwith this query. Optional.",
358 "location": "query",
359 "type": "string"
360 },
361 "end": {
362 "description": "The end position of the rang e on the reference, 0-based exclusive. If\nspecified, `referenceName` must also be specified. If unset or 0, defaults\nto the length of the reference.",
363 "format": "int64",
364 "location": "query",
365 "type": "string"
492 }, 366 },
493 "pageToken": { 367 "pageToken": {
494 "description": "The continuation token, whic h is used to page through large result sets.\nTo get the next page of results, s et this parameter to the value of\n`nextPageToken` from the previous response.", 368 "description": "The continuation token, whic h is used to page through large result sets.\nTo get the next page of results, s et this parameter to the value of\n`nextPageToken` from the previous response.",
495 "location": "query", 369 "location": "query",
496 "type": "string" 370 "type": "string"
371 },
372 "pageSize": {
373 "description": "The maximum number of result s to return in a single page. If unspecified,\ndefaults to 1024. The maximum val ue is 2048.",
374 "format": "int32",
375 "location": "query",
376 "type": "integer"
497 } 377 }
498 }, 378 },
499 "path": "v1/references/{referenceId}/bases", 379 "path": "v1/readgroupsets/{readGroupSetId}/coverageb uckets",
500 "response": { 380 "response": {
501 "$ref": "ListBasesResponse" 381 "$ref": "ListCoverageBucketsResponse"
502 }, 382 },
503 "scopes": [ 383 "scopes": [
504 "https://www.googleapis.com/auth/cloud-platform" , 384 "https://www.googleapis.com/auth/cloud-platform" ,
505 "https://www.googleapis.com/auth/genomics", 385 "https://www.googleapis.com/auth/genomics",
506 "https://www.googleapis.com/auth/genomics.readon ly" 386 "https://www.googleapis.com/auth/genomics.readon ly"
507 ] 387 ]
508 } 388 }
509 } 389 }
510 } 390 }
511 } 391 }
512 }, 392 },
513 "datasets": { 393 "reads": {
514 "methods": { 394 "methods": {
515 "patch": { 395 "search": {
516 "description": "Updates a dataset.\n\nFor the definitions of datasets and other genomics resources, see\n[Fundamentals of Google\nGenomics]( https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nThis metho d supports patch semantics.", 396 "description": "Gets a list of reads for one or more read gr oup sets.\n\nFor the definitions of read group sets and other genomics resources , see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fund amentals-of-google-genomics)\n\nReads search operates over a genomic coordinate space of reference sequence\n& position defined over the reference sequences to which the requested\nread group sets are aligned.\n\nIf a target positional rang e is specified, search returns all reads whose\nalignment to the reference genom e overlap the range. A query which\nspecifies only read group set IDs yields all reads in those read group\nsets, including unmapped reads.\n\nAll reads returne d (including reads on subsequent pages) are ordered by\ngenomic coordinate (by r eference sequence, then position). Reads with\nequivalent genomic coordinates ar e returned in an unspecified order. This\norder is consistent, such that two que ries for the same content (regardless\nof page size) yield reads in the same ord er across their respective streams\nof paginated responses.\n\nImplements\n[Glob alAllianceApi.searchReads](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main /resources/avro/readmethods.avdl#L85).",
517 "httpMethod": "PATCH", 397 "httpMethod": "POST",
518 "id": "genomics.datasets.patch", 398 "id": "genomics.reads.search",
519 "parameterOrder": [ 399 "parameterOrder": [],
520 "datasetId" 400 "parameters": {},
521 ], 401 "path": "v1/reads/search",
522 "parameters": {
523 "datasetId": {
524 "description": "The ID of the dataset to be updated. ",
525 "location": "path",
526 "required": true,
527 "type": "string"
528 },
529 "updateMask": {
530 "description": "An optional mask specifying which fi elds to update. At this time, the only\nmutable field is name. The only\naccepta ble value is \"name\". If unspecified, all mutable fields will be\nupdated.",
531 "format": "google-fieldmask",
532 "location": "query",
533 "type": "string"
534 }
535 },
536 "path": "v1/datasets/{datasetId}",
537 "request": { 402 "request": {
538 "$ref": "Dataset" 403 "$ref": "SearchReadsRequest"
539 }, 404 },
540 "response": { 405 "response": {
541 "$ref": "Dataset" 406 "$ref": "SearchReadsResponse"
407 },
408 "scopes": [
409 "https://www.googleapis.com/auth/cloud-platform",
410 "https://www.googleapis.com/auth/genomics",
411 "https://www.googleapis.com/auth/genomics.readonly"
412 ]
413 }
414 }
415 },
416 "callsets": {
417 "methods": {
418 "create": {
419 "description": "Creates a new call set.\n\nFor the definitio ns of call sets and other genomics resources, see\n[Fundamentals of Google\nGeno mics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
420 "httpMethod": "POST",
421 "id": "genomics.callsets.create",
422 "parameterOrder": [],
423 "parameters": {},
424 "path": "v1/callsets",
425 "request": {
426 "$ref": "CallSet"
427 },
428 "response": {
429 "$ref": "CallSet"
542 }, 430 },
543 "scopes": [ 431 "scopes": [
544 "https://www.googleapis.com/auth/cloud-platform", 432 "https://www.googleapis.com/auth/cloud-platform",
545 "https://www.googleapis.com/auth/genomics" 433 "https://www.googleapis.com/auth/genomics"
546 ] 434 ]
547 }, 435 },
548 "get": { 436 "delete": {
549 "description": "Gets a dataset by ID.\n\nFor the definitions of datasets and other genomics resources, see\n[Fundamentals of Google\nGenomic s](https://cloud.google.com/genomics/fundamentals-of-google-genomics)", 437 "description": "Deletes a call set.\n\nFor the definitions o f call sets and other genomics resources, see\n[Fundamentals of Google\nGenomics ](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
550 "httpMethod": "GET", 438 "httpMethod": "DELETE",
551 "id": "genomics.datasets.get", 439 "id": "genomics.callsets.delete",
552 "parameterOrder": [ 440 "parameterOrder": [
553 "datasetId" 441 "callSetId"
554 ], 442 ],
555 "parameters": { 443 "parameters": {
556 "datasetId": { 444 "callSetId": {
557 "description": "The ID of the dataset.", 445 "description": "The ID of the call set to be deleted .",
558 "location": "path", 446 "location": "path",
559 "required": true, 447 "required": true,
560 "type": "string" 448 "type": "string"
561 } 449 }
562 }, 450 },
563 "path": "v1/datasets/{datasetId}", 451 "path": "v1/callsets/{callSetId}",
564 "response": { 452 "response": {
565 "$ref": "Dataset" 453 "$ref": "Empty"
566 }, 454 },
567 "scopes": [ 455 "scopes": [
568 "https://www.googleapis.com/auth/cloud-platform", 456 "https://www.googleapis.com/auth/cloud-platform",
457 "https://www.googleapis.com/auth/genomics"
458 ]
459 },
460 "search": {
461 "description": "Gets a list of call sets matching the criter ia.\n\nFor the definitions of call sets and other genomics resources, see\n[Fund amentals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of- google-genomics)\n\nImplements\n[GlobalAllianceApi.searchCallSets](https://githu b.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variantmethods.avdl#L178 ).",
462 "httpMethod": "POST",
463 "id": "genomics.callsets.search",
464 "parameterOrder": [],
465 "parameters": {},
466 "path": "v1/callsets/search",
467 "request": {
468 "$ref": "SearchCallSetsRequest"
469 },
470 "response": {
471 "$ref": "SearchCallSetsResponse"
472 },
473 "scopes": [
474 "https://www.googleapis.com/auth/cloud-platform",
569 "https://www.googleapis.com/auth/genomics", 475 "https://www.googleapis.com/auth/genomics",
570 "https://www.googleapis.com/auth/genomics.readonly" 476 "https://www.googleapis.com/auth/genomics.readonly"
571 ] 477 ]
572 }, 478 },
573 "undelete": { 479 "get": {
574 "description": "Undeletes a dataset by restoring a dataset w hich was deleted via this API.\n\nFor the definitions of datasets and other geno mics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com /genomics/fundamentals-of-google-genomics)\n\nThis operation is only possible fo r a week after the deletion occurred.", 480 "description": "Gets a call set by ID.\n\nFor the definition s of call sets and other genomics resources, see\n[Fundamentals of Google\nGenom ics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
575 "httpMethod": "POST", 481 "httpMethod": "GET",
576 "id": "genomics.datasets.undelete", 482 "id": "genomics.callsets.get",
577 "parameterOrder": [ 483 "parameterOrder": [
578 "datasetId" 484 "callSetId"
579 ], 485 ],
580 "parameters": { 486 "parameters": {
581 "datasetId": { 487 "callSetId": {
582 "description": "The ID of the dataset to be undelete d.", 488 "description": "The ID of the call set.",
583 "location": "path", 489 "location": "path",
584 "required": true, 490 "required": true,
585 "type": "string" 491 "type": "string"
586 } 492 }
587 }, 493 },
588 "path": "v1/datasets/{datasetId}:undelete", 494 "path": "v1/callsets/{callSetId}",
495 "response": {
496 "$ref": "CallSet"
497 },
498 "scopes": [
499 "https://www.googleapis.com/auth/cloud-platform",
500 "https://www.googleapis.com/auth/genomics",
501 "https://www.googleapis.com/auth/genomics.readonly"
502 ]
503 },
504 "patch": {
505 "description": "Updates a call set.\n\nFor the definitions o f call sets and other genomics resources, see\n[Fundamentals of Google\nGenomics ](https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nThis met hod supports patch semantics.",
506 "httpMethod": "PATCH",
507 "id": "genomics.callsets.patch",
508 "parameterOrder": [
509 "callSetId"
510 ],
511 "parameters": {
512 "callSetId": {
513 "description": "The ID of the call set to be updated .",
514 "location": "path",
515 "required": true,
516 "type": "string"
517 },
518 "updateMask": {
519 "description": "An optional mask specifying which fi elds to update. At this time, the only\nmutable field is name. The only\naccepta ble value is \"name\". If unspecified, all mutable fields will be\nupdated.",
520 "format": "google-fieldmask",
521 "location": "query",
522 "type": "string"
523 }
524 },
525 "path": "v1/callsets/{callSetId}",
589 "request": { 526 "request": {
590 "$ref": "UndeleteDatasetRequest" 527 "$ref": "CallSet"
591 }, 528 },
592 "response": { 529 "response": {
593 "$ref": "Dataset" 530 "$ref": "CallSet"
594 }, 531 },
595 "scopes": [ 532 "scopes": [
596 "https://www.googleapis.com/auth/cloud-platform", 533 "https://www.googleapis.com/auth/cloud-platform",
597 "https://www.googleapis.com/auth/genomics" 534 "https://www.googleapis.com/auth/genomics"
598 ] 535 ]
599 }, 536 }
600 "testIamPermissions": { 537 }
601 "description": "Returns permissions that a caller has on the specified resource.\nSee <a href=\"/iam/docs/managing-policies#testing_permissi ons\">Testing\nPermissions</a> for more information.\n\nFor the definitions of d atasets and other genomics resources, see\n[Fundamentals of Google\nGenomics](ht tps://cloud.google.com/genomics/fundamentals-of-google-genomics)", 538 },
539 "variants": {
540 "methods": {
541 "merge": {
542 "description": "Merges the given variants with existing vari ants.\n\nFor the definitions of variants and other genomics resources, see\n[Fun damentals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of -google-genomics)\n\nEach variant will be\nmerged with an existing variant that matches its reference sequence,\nstart, end, reference bases, and alternative ba ses. If no such variant\nexists, a new one will be created.\n\nWhen variants are merged, the call information from the new variant\nis added to the existing var iant. Variant info fields are merged as\nspecified in the\ninfoMergeConfig\nfiel d of the MergeVariantsRequest.\n\nPlease exercise caution when using this method ! It is easy to introduce\nmistakes in existing variants and difficult to back out of them. For\nexample,\nsuppose you were trying to merge a new variant with an existing one and\nboth\nvariants contain calls that belong to callsets with the same callset ID.\n\n // Existing variant - irrelevant fields trimmed for clarity\n {\n \"variantSetId\": \"10473108253681171589\",\n \"r eferenceName\": \"1\",\n \"start\": \"10582\",\n \"referenceBases\ ": \"G\",\n \"alternateBases\": [\n \"A\"\n ],\n \"calls\": [\n {\n \"callSetId\": \"10473108253681171 589-0\",\n \"callSetName\": \"CALLSET0\",\n \"geno type\": [\n 0,\n 1\n ],\n }\n ]\n }\n\n // New variant with conflicting call inform ation\n {\n \"variantSetId\": \"10473108253681171589\",\n \"ref erenceName\": \"1\",\n \"start\": \"10582\",\n \"referenceBases\": \"G\",\n \"alternateBases\": [\n \"A\"\n ],\n \ "calls\": [\n {\n \"callSetId\": \"1047310825368117158 9-0\",\n \"callSetName\": \"CALLSET0\",\n \"genoty pe\": [\n 1,\n 1\n ],\n }\n ]\n }\n\nThe resulting merged variant would overwrite the existing calls with those\nfrom the new variant:\n\n {\n \"variantSetI d\": \"10473108253681171589\",\n \"referenceName\": \"1\",\n \"sta rt\": \"10582\",\n \"referenceBases\": \"G\",\n \"alternateBases\" : [\n \"A\"\n ],\n \"calls\": [\n {\n \"callSetId\": \"10473108253681171589-0\",\n \"callSetNa me\": \"CALLSET0\",\n \"genotype\": [\n 1,\n 1\n ],\n }\n ]\n }\n\nThis may be the desired outcome, but it is up to the user to determine if\nif that i s indeed the case.",
602 "httpMethod": "POST", 543 "httpMethod": "POST",
603 "id": "genomics.datasets.testIamPermissions", 544 "id": "genomics.variants.merge",
604 "parameterOrder": [ 545 "parameterOrder": [],
605 "resource" 546 "parameters": {},
606 ], 547 "path": "v1/variants:merge",
607 "parameters": { 548 "request": {
608 "resource": { 549 "$ref": "MergeVariantsRequest"
609 "description": "REQUIRED: The resource for which pol icy is being specified. Format is\n`datasets/<dataset ID>`.",
610 "location": "path",
611 "pattern": "^datasets/[^/]+$",
612 "required": true,
613 "type": "string"
614 }
615 }, 550 },
616 "path": "v1/{+resource}:testIamPermissions",
617 "request": {
618 "$ref": "TestIamPermissionsRequest"
619 },
620 "response": {
621 "$ref": "TestIamPermissionsResponse"
622 },
623 "scopes": [
624 "https://www.googleapis.com/auth/cloud-platform",
625 "https://www.googleapis.com/auth/genomics"
626 ]
627 },
628 "delete": {
629 "description": "Deletes a dataset and all of its contents (a ll read group sets,\nreference sets, variant sets, call sets, annotation sets, e tc.)\nThis is reversible (up to one week after the deletion) via\nthe\ndatasets. undelete\noperation.\n\nFor the definitions of datasets and other genomics resou rces, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/ fundamentals-of-google-genomics)",
630 "httpMethod": "DELETE",
631 "id": "genomics.datasets.delete",
632 "parameterOrder": [
633 "datasetId"
634 ],
635 "parameters": {
636 "datasetId": {
637 "description": "The ID of the dataset to be deleted. ",
638 "location": "path",
639 "required": true,
640 "type": "string"
641 }
642 },
643 "path": "v1/datasets/{datasetId}",
644 "response": { 551 "response": {
645 "$ref": "Empty" 552 "$ref": "Empty"
646 }, 553 },
647 "scopes": [ 554 "scopes": [
648 "https://www.googleapis.com/auth/cloud-platform", 555 "https://www.googleapis.com/auth/cloud-platform",
649 "https://www.googleapis.com/auth/genomics" 556 "https://www.googleapis.com/auth/genomics"
650 ] 557 ]
651 }, 558 },
652 "list": { 559 "delete": {
653 "description": "Lists datasets within a project.\n\nFor the definitions of datasets and other genomics resources, see\n[Fundamentals of Goog le\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) ", 560 "description": "Deletes a variant.\n\nFor the definitions of variants and other genomics resources, see\n[Fundamentals of Google\nGenomics]( https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
654 "httpMethod": "GET", 561 "httpMethod": "DELETE",
655 "id": "genomics.datasets.list", 562 "id": "genomics.variants.delete",
656 "parameterOrder": [], 563 "parameterOrder": [
564 "variantId"
565 ],
657 "parameters": { 566 "parameters": {
658 "projectId": { 567 "variantId": {
659 "description": "Required. The Google Cloud project I D to list datasets for.", 568 "description": "The ID of the variant to be deleted. ",
660 "location": "query", 569 "location": "path",
570 "required": true,
661 "type": "string" 571 "type": "string"
662 },
663 "pageToken": {
664 "description": "The continuation token, which is use d to page through large result sets.\nTo get the next page of results, set this parameter to the value of\n`nextPageToken` from the previous response.",
665 "location": "query",
666 "type": "string"
667 },
668 "pageSize": {
669 "description": "The maximum number of results to ret urn in a single page. If unspecified,\ndefaults to 50. The maximum value is 1024 .",
670 "format": "int32",
671 "location": "query",
672 "type": "integer"
673 } 572 }
674 }, 573 },
675 "path": "v1/datasets", 574 "path": "v1/variants/{variantId}",
676 "response": { 575 "response": {
677 "$ref": "ListDatasetsResponse" 576 "$ref": "Empty"
678 },
679 "scopes": [
680 "https://www.googleapis.com/auth/cloud-platform",
681 "https://www.googleapis.com/auth/genomics",
682 "https://www.googleapis.com/auth/genomics.readonly"
683 ]
684 },
685 "create": {
686 "description": "Creates a new dataset.\n\nFor the definition s of datasets and other genomics resources, see\n[Fundamentals of Google\nGenomi cs](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
687 "httpMethod": "POST",
688 "id": "genomics.datasets.create",
689 "parameterOrder": [],
690 "parameters": {},
691 "path": "v1/datasets",
692 "request": {
693 "$ref": "Dataset"
694 },
695 "response": {
696 "$ref": "Dataset"
697 }, 577 },
698 "scopes": [ 578 "scopes": [
699 "https://www.googleapis.com/auth/cloud-platform", 579 "https://www.googleapis.com/auth/cloud-platform",
700 "https://www.googleapis.com/auth/genomics" 580 "https://www.googleapis.com/auth/genomics"
701 ] 581 ]
702 }, 582 },
703 "setIamPolicy": { 583 "import": {
704 "description": "Sets the access control policy on the specif ied dataset. Replaces any\nexisting policy.\n\nFor the definitions of datasets a nd other genomics resources, see\n[Fundamentals of Google\nGenomics](https://clo ud.google.com/genomics/fundamentals-of-google-genomics)\n\nSee <a href=\"/iam/do cs/managing-policies#setting_a_policy\">Setting a\nPolicy</a> for more informati on.", 584 "description": "Creates variant data by asynchronously impor ting the provided information.\n\nFor the definitions of variant sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google .com/genomics/fundamentals-of-google-genomics)\n\nThe variants for import will b e merged with any existing variant that\nmatches its reference sequence, start, end, reference bases, and\nalternative bases. If no such variant exists, a new o ne will be created.\n\nWhen variants are merged, the call information from the n ew variant\nis added to the existing variant, and Variant info fields are merged \nas specified in\ninfoMergeConfig.\nAs a special case, for single-sample VCF fi les, QUAL and FILTER fields will\nbe moved to the call level; these are sometime s interpreted in a\ncall-specific context.\nImported VCF headers are appended to the metadata already in a variant set.",
705 "httpMethod": "POST", 585 "httpMethod": "POST",
706 "id": "genomics.datasets.setIamPolicy", 586 "id": "genomics.variants.import",
707 "parameterOrder": [ 587 "parameterOrder": [],
708 "resource" 588 "parameters": {},
709 ], 589 "path": "v1/variants:import",
710 "parameters": {
711 "resource": {
712 "description": "REQUIRED: The resource for which pol icy is being specified. Format is\n`datasets/<dataset ID>`.",
713 "location": "path",
714 "pattern": "^datasets/[^/]+$",
715 "required": true,
716 "type": "string"
717 }
718 },
719 "path": "v1/{+resource}:setIamPolicy",
720 "request": { 590 "request": {
721 "$ref": "SetIamPolicyRequest" 591 "$ref": "ImportVariantsRequest"
722 }, 592 },
723 "response": { 593 "response": {
724 "$ref": "Policy" 594 "$ref": "Operation"
725 }, 595 },
726 "scopes": [ 596 "scopes": [
727 "https://www.googleapis.com/auth/cloud-platform", 597 "https://www.googleapis.com/auth/cloud-platform",
598 "https://www.googleapis.com/auth/devstorage.read_write",
728 "https://www.googleapis.com/auth/genomics" 599 "https://www.googleapis.com/auth/genomics"
729 ] 600 ]
730 }, 601 },
731 "getIamPolicy": { 602 "create": {
732 "description": "Gets the access control policy for the datas et. This is empty if the\npolicy or resource does not exist.\n\nSee <a href=\"/i am/docs/managing-policies#getting_a_policy\">Getting a\nPolicy</a> for more info rmation.\n\nFor the definitions of datasets and other genomics resources, see\n[ Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals -of-google-genomics)", 603 "description": "Creates a new variant.\n\nFor the definition s of variants and other genomics resources, see\n[Fundamentals of Google\nGenomi cs](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
733 "httpMethod": "POST", 604 "httpMethod": "POST",
734 "id": "genomics.datasets.getIamPolicy", 605 "id": "genomics.variants.create",
735 "parameterOrder": [ 606 "parameterOrder": [],
736 "resource" 607 "parameters": {},
737 ], 608 "path": "v1/variants",
738 "parameters": {
739 "resource": {
740 "description": "REQUIRED: The resource for which pol icy is being specified. Format is\n`datasets/<dataset ID>`.",
741 "location": "path",
742 "pattern": "^datasets/[^/]+$",
743 "required": true,
744 "type": "string"
745 }
746 },
747 "path": "v1/{+resource}:getIamPolicy",
748 "request": { 609 "request": {
749 "$ref": "GetIamPolicyRequest" 610 "$ref": "Variant"
750 }, 611 },
751 "response": { 612 "response": {
752 "$ref": "Policy" 613 "$ref": "Variant"
753 }, 614 },
754 "scopes": [ 615 "scopes": [
755 "https://www.googleapis.com/auth/cloud-platform", 616 "https://www.googleapis.com/auth/cloud-platform",
756 "https://www.googleapis.com/auth/genomics"
757 ]
758 }
759 }
760 },
761 "annotations": {
762 "methods": {
763 "create": {
764 "description": "Creates a new annotation. Caller must have W RITE permission\nfor the associated annotation set.\n\nThe following fields are required:\n\n* annotationSetId\n* referenceName or\n referenceId\n\n### Transcr ipts\n\nFor annotations of type TRANSCRIPT, the following fields of\ntranscript must be provided:\n\n* exons.start\n* exons.end\n\nAll other fields may be optio nally specified, unless documented as being\nserver-generated (for example, the `id` field). The annotated\nrange must be no longer than 100Mbp (mega base pairs ). See the\nAnnotation resource\nfor additional restrictions on each field.",
765 "httpMethod": "POST",
766 "id": "genomics.annotations.create",
767 "parameterOrder": [],
768 "parameters": {},
769 "path": "v1/annotations",
770 "request": {
771 "$ref": "Annotation"
772 },
773 "response": {
774 "$ref": "Annotation"
775 },
776 "scopes": [
777 "https://www.googleapis.com/auth/cloud-platform",
778 "https://www.googleapis.com/auth/genomics"
779 ]
780 },
781 "batchCreate": {
782 "description": "Creates one or more new annotations atomical ly. All annotations must\nbelong to the same annotation set. Caller must have WR ITE\npermission for this annotation set. For optimal performance, batch\npositio nally adjacent annotations together.\n\nIf the request has a systemic issue, suc h as an attempt to write to\nan inaccessible annotation set, the entire RPC will fail accordingly. For\nlesser data issues, when possible an error will be isola ted to the\ncorresponding batch entry in the response; the remaining well formed \nannotations will be created normally.\n\nFor details on the requirements for e ach individual annotation resource,\nsee\nCreateAnnotation.",
783 "httpMethod": "POST",
784 "id": "genomics.annotations.batchCreate",
785 "parameterOrder": [],
786 "parameters": {},
787 "path": "v1/annotations:batchCreate",
788 "request": {
789 "$ref": "BatchCreateAnnotationsRequest"
790 },
791 "response": {
792 "$ref": "BatchCreateAnnotationsResponse"
793 },
794 "scopes": [
795 "https://www.googleapis.com/auth/cloud-platform",
796 "https://www.googleapis.com/auth/genomics" 617 "https://www.googleapis.com/auth/genomics"
797 ] 618 ]
798 }, 619 },
799 "search": { 620 "search": {
800 "description": "Searches for annotations that match the give n criteria. Results are\nordered by genomic coordinate (by reference sequence, t hen position).\nAnnotations with equivalent genomic coordinates are returned in an\nunspecified order. This order is consistent, such that two queries for the\n same content (regardless of page size) yield annotations in the same order\nacro ss their respective streams of paginated responses. Caller must have\nREAD permi ssion for the queried annotation sets.", 621 "description": "Gets a list of variants matching the criteri a.\n\nFor the definitions of variants and other genomics resources, see\n[Fundam entals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of-go ogle-genomics)\n\nImplements\n[GlobalAllianceApi.searchVariants](https://github. com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variantmethods.avdl#L126). ",
801 "httpMethod": "POST", 622 "httpMethod": "POST",
802 "id": "genomics.annotations.search", 623 "id": "genomics.variants.search",
803 "parameterOrder": [], 624 "parameterOrder": [],
804 "parameters": {}, 625 "parameters": {},
805 "path": "v1/annotations/search", 626 "path": "v1/variants/search",
806 "request": { 627 "request": {
807 "$ref": "SearchAnnotationsRequest" 628 "$ref": "SearchVariantsRequest"
808 }, 629 },
809 "response": { 630 "response": {
810 "$ref": "SearchAnnotationsResponse" 631 "$ref": "SearchVariantsResponse"
811 }, 632 },
812 "scopes": [ 633 "scopes": [
813 "https://www.googleapis.com/auth/cloud-platform", 634 "https://www.googleapis.com/auth/cloud-platform",
814 "https://www.googleapis.com/auth/genomics", 635 "https://www.googleapis.com/auth/genomics",
815 "https://www.googleapis.com/auth/genomics.readonly" 636 "https://www.googleapis.com/auth/genomics.readonly"
816 ] 637 ]
817 }, 638 },
818 "get": { 639 "get": {
819 "description": "Gets an annotation. Caller must have READ pe rmission\nfor the associated annotation set.", 640 "description": "Gets a variant by ID.\n\nFor the definitions of variants and other genomics resources, see\n[Fundamentals of Google\nGenomic s](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
820 "httpMethod": "GET", 641 "httpMethod": "GET",
821 "id": "genomics.annotations.get", 642 "id": "genomics.variants.get",
822 "parameterOrder": [ 643 "parameterOrder": [
823 "annotationId" 644 "variantId"
824 ], 645 ],
825 "parameters": { 646 "parameters": {
826 "annotationId": { 647 "variantId": {
827 "description": "The ID of the annotation to be retri eved.", 648 "description": "The ID of the variant.",
828 "location": "path", 649 "location": "path",
829 "required": true, 650 "required": true,
830 "type": "string" 651 "type": "string"
831 } 652 }
832 }, 653 },
833 "path": "v1/annotations/{annotationId}", 654 "path": "v1/variants/{variantId}",
834 "response": { 655 "response": {
835 "$ref": "Annotation" 656 "$ref": "Variant"
836 }, 657 },
837 "scopes": [ 658 "scopes": [
838 "https://www.googleapis.com/auth/cloud-platform", 659 "https://www.googleapis.com/auth/cloud-platform",
839 "https://www.googleapis.com/auth/genomics", 660 "https://www.googleapis.com/auth/genomics",
840 "https://www.googleapis.com/auth/genomics.readonly" 661 "https://www.googleapis.com/auth/genomics.readonly"
841 ] 662 ]
842 }, 663 },
843 "update": { 664 "patch": {
844 "description": "Updates an annotation. Caller must have\nWRI TE permission for the associated dataset.", 665 "description": "Updates a variant.\n\nFor the definitions of variants and other genomics resources, see\n[Fundamentals of Google\nGenomics]( https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nThis metho d supports patch semantics. Returns the modified variant without\nits calls.",
845 "httpMethod": "PUT", 666 "httpMethod": "PATCH",
846 "id": "genomics.annotations.update", 667 "id": "genomics.variants.patch",
847 "parameterOrder": [ 668 "parameterOrder": [
848 "annotationId" 669 "variantId"
849 ], 670 ],
850 "parameters": { 671 "parameters": {
851 "updateMask": { 672 "updateMask": {
852 "description": "An optional mask specifying which fi elds to update. Mutable fields are\nname,\nvariant,\ntranscript, and\ninfo. If u nspecified, all mutable\nfields will be updated.", 673 "description": "An optional mask specifying which fi elds to update. At this time, mutable\nfields are names and\ninfo. Acceptable va lues are \"names\" and\n\"info\". If unspecified, all mutable fields will be upd ated.",
853 "format": "google-fieldmask", 674 "format": "google-fieldmask",
854 "location": "query", 675 "location": "query",
855 "type": "string" 676 "type": "string"
856 }, 677 },
857 "annotationId": { 678 "variantId": {
858 "description": "The ID of the annotation to be updat ed.", 679 "description": "The ID of the variant to be updated. ",
859 "location": "path", 680 "location": "path",
860 "required": true, 681 "required": true,
861 "type": "string" 682 "type": "string"
862 } 683 }
863 }, 684 },
864 "path": "v1/annotations/{annotationId}", 685 "path": "v1/variants/{variantId}",
865 "request": { 686 "request": {
866 "$ref": "Annotation" 687 "$ref": "Variant"
867 }, 688 },
868 "response": { 689 "response": {
869 "$ref": "Annotation" 690 "$ref": "Variant"
870 }, 691 },
871 "scopes": [ 692 "scopes": [
872 "https://www.googleapis.com/auth/cloud-platform", 693 "https://www.googleapis.com/auth/cloud-platform",
873 "https://www.googleapis.com/auth/genomics" 694 "https://www.googleapis.com/auth/genomics"
874 ] 695 ]
875 }, 696 }
697 }
698 },
699 "annotationsets": {
700 "methods": {
876 "delete": { 701 "delete": {
877 "description": "Deletes an annotation. Caller must have WRIT E permission for\nthe associated annotation set.", 702 "description": "Deletes an annotation set. Caller must have WRITE permission\nfor the associated annotation set.",
878 "httpMethod": "DELETE", 703 "httpMethod": "DELETE",
879 "id": "genomics.annotations.delete", 704 "id": "genomics.annotationsets.delete",
880 "parameterOrder": [ 705 "parameterOrder": [
881 "annotationId" 706 "annotationSetId"
882 ], 707 ],
883 "parameters": { 708 "parameters": {
884 "annotationId": { 709 "annotationSetId": {
885 "description": "The ID of the annotation to be delet ed.", 710 "description": "The ID of the annotation set to be d eleted.",
886 "location": "path", 711 "location": "path",
887 "required": true, 712 "required": true,
888 "type": "string" 713 "type": "string"
889 } 714 }
890 }, 715 },
891 "path": "v1/annotations/{annotationId}", 716 "path": "v1/annotationsets/{annotationSetId}",
892 "response": { 717 "response": {
893 "$ref": "Empty" 718 "$ref": "Empty"
894 }, 719 },
895 "scopes": [ 720 "scopes": [
896 "https://www.googleapis.com/auth/cloud-platform", 721 "https://www.googleapis.com/auth/cloud-platform",
897 "https://www.googleapis.com/auth/genomics" 722 "https://www.googleapis.com/auth/genomics"
898 ] 723 ]
724 },
725 "search": {
726 "description": "Searches for annotation sets that match the given criteria. Annotation sets\nare returned in an unspecified order. This orde r is consistent, such that\ntwo queries for the same content (regardless of page size) yield annotation\nsets in the same order across their respective streams of paginated\nresponses. Caller must have READ permission for the queried datase ts.",
727 "httpMethod": "POST",
728 "id": "genomics.annotationsets.search",
729 "parameterOrder": [],
730 "parameters": {},
731 "path": "v1/annotationsets/search",
732 "request": {
733 "$ref": "SearchAnnotationSetsRequest"
734 },
735 "response": {
736 "$ref": "SearchAnnotationSetsResponse"
737 },
738 "scopes": [
739 "https://www.googleapis.com/auth/cloud-platform",
740 "https://www.googleapis.com/auth/genomics",
741 "https://www.googleapis.com/auth/genomics.readonly"
742 ]
743 },
744 "get": {
745 "description": "Gets an annotation set. Caller must have REA D permission for\nthe associated dataset.",
746 "httpMethod": "GET",
747 "id": "genomics.annotationsets.get",
748 "parameterOrder": [
749 "annotationSetId"
750 ],
751 "parameters": {
752 "annotationSetId": {
753 "description": "The ID of the annotation set to be r etrieved.",
754 "location": "path",
755 "required": true,
756 "type": "string"
757 }
758 },
759 "path": "v1/annotationsets/{annotationSetId}",
760 "response": {
761 "$ref": "AnnotationSet"
762 },
763 "scopes": [
764 "https://www.googleapis.com/auth/cloud-platform",
765 "https://www.googleapis.com/auth/genomics",
766 "https://www.googleapis.com/auth/genomics.readonly"
767 ]
768 },
769 "update": {
770 "description": "Updates an annotation set. The update must r espect all mutability\nrestrictions and other invariants described on the annota tion set resource.\nCaller must have WRITE permission for the associated dataset .",
771 "httpMethod": "PUT",
772 "id": "genomics.annotationsets.update",
773 "parameterOrder": [
774 "annotationSetId"
775 ],
776 "parameters": {
777 "updateMask": {
778 "description": "An optional mask specifying which fi elds to update. Mutable fields are\nname,\nsource_uri, and\ninfo. If unspecified , all\nmutable fields will be updated.",
779 "format": "google-fieldmask",
780 "location": "query",
781 "type": "string"
782 },
783 "annotationSetId": {
784 "description": "The ID of the annotation set to be u pdated.",
785 "location": "path",
786 "required": true,
787 "type": "string"
788 }
789 },
790 "path": "v1/annotationsets/{annotationSetId}",
791 "request": {
792 "$ref": "AnnotationSet"
793 },
794 "response": {
795 "$ref": "AnnotationSet"
796 },
797 "scopes": [
798 "https://www.googleapis.com/auth/cloud-platform",
799 "https://www.googleapis.com/auth/genomics"
800 ]
801 },
802 "create": {
803 "description": "Creates a new annotation set. Caller must ha ve WRITE permission for the\nassociated dataset.\n\nThe following fields are req uired:\n\n * datasetId\n * referenceSetId\n\nAll other fields may be optionall y specified, unless documented as being\nserver-generated (for example, the `id` field).",
804 "httpMethod": "POST",
805 "id": "genomics.annotationsets.create",
806 "parameterOrder": [],
807 "parameters": {},
808 "path": "v1/annotationsets",
809 "request": {
810 "$ref": "AnnotationSet"
811 },
812 "response": {
813 "$ref": "AnnotationSet"
814 },
815 "scopes": [
816 "https://www.googleapis.com/auth/cloud-platform",
817 "https://www.googleapis.com/auth/genomics"
818 ]
899 } 819 }
900 } 820 }
901 }, 821 },
902 "variantsets": { 822 "references": {
903 "methods": { 823 "methods": {
904 "create": { 824 "search": {
905 "description": "Creates a new variant set.\n\nFor the defini tions of variant sets and other genomics resources, see\n[Fundamentals of Google \nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n \nThe provided variant set must have a valid `datasetId` set - all other\nfields are optional. Note that the `id` field will be ignored, as this is\nassigned by the server.", 825 "description": "Searches for references which match the give n criteria.\n\nFor the definitions of references and other genomics resources, s ee\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundame ntals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.searchReferences](ht tps://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/referencemeth ods.avdl#L146).",
906 "httpMethod": "POST", 826 "httpMethod": "POST",
907 "id": "genomics.variantsets.create", 827 "id": "genomics.references.search",
908 "parameterOrder": [], 828 "parameterOrder": [],
909 "parameters": {}, 829 "parameters": {},
910 "path": "v1/variantsets", 830 "path": "v1/references/search",
911 "request": { 831 "request": {
912 "$ref": "VariantSet" 832 "$ref": "SearchReferencesRequest"
913 }, 833 },
914 "response": { 834 "response": {
915 "$ref": "VariantSet" 835 "$ref": "SearchReferencesResponse"
916 }, 836 },
917 "scopes": [ 837 "scopes": [
918 "https://www.googleapis.com/auth/cloud-platform", 838 "https://www.googleapis.com/auth/cloud-platform",
919 "https://www.googleapis.com/auth/genomics"
920 ]
921 },
922 "export": {
923 "description": "Exports variant set data to an external dest ination.\n\nFor the definitions of variant sets and other genomics resources, se e\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundamen tals-of-google-genomics)",
924 "httpMethod": "POST",
925 "id": "genomics.variantsets.export",
926 "parameterOrder": [
927 "variantSetId"
928 ],
929 "parameters": {
930 "variantSetId": {
931 "description": "Required. The ID of the variant set that contains variant data which\nshould be exported. The caller must have READ access to this variant set.",
932 "location": "path",
933 "required": true,
934 "type": "string"
935 }
936 },
937 "path": "v1/variantsets/{variantSetId}:export",
938 "request": {
939 "$ref": "ExportVariantSetRequest"
940 },
941 "response": {
942 "$ref": "Operation"
943 },
944 "scopes": [
945 "https://www.googleapis.com/auth/bigquery",
946 "https://www.googleapis.com/auth/cloud-platform",
947 "https://www.googleapis.com/auth/genomics"
948 ]
949 },
950 "search": {
951 "description": "Returns a list of all variant sets matching search criteria.\n\nFor the definitions of variant sets and other genomics resou rces, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/ fundamentals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.searchVariant Sets](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/varia ntmethods.avdl#L49).",
952 "httpMethod": "POST",
953 "id": "genomics.variantsets.search",
954 "parameterOrder": [],
955 "parameters": {},
956 "path": "v1/variantsets/search",
957 "request": {
958 "$ref": "SearchVariantSetsRequest"
959 },
960 "response": {
961 "$ref": "SearchVariantSetsResponse"
962 },
963 "scopes": [
964 "https://www.googleapis.com/auth/cloud-platform",
965 "https://www.googleapis.com/auth/genomics", 839 "https://www.googleapis.com/auth/genomics",
966 "https://www.googleapis.com/auth/genomics.readonly" 840 "https://www.googleapis.com/auth/genomics.readonly"
967 ] 841 ]
968 }, 842 },
969 "get": { 843 "get": {
970 "description": "Gets a variant set by ID.\n\nFor the definit ions of variant sets and other genomics resources, see\n[Fundamentals of Google\ nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)", 844 "description": "Gets a reference.\n\nFor the definitions of references and other genomics resources, see\n[Fundamentals of Google\nGenomics] (https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nImplement s\n[GlobalAllianceApi.getReference](https://github.com/ga4gh/schemas/blob/v0.5.1 /src/main/resources/avro/referencemethods.avdl#L158).",
971 "httpMethod": "GET", 845 "httpMethod": "GET",
972 "id": "genomics.variantsets.get", 846 "id": "genomics.references.get",
973 "parameterOrder": [ 847 "parameterOrder": [
974 "variantSetId" 848 "referenceId"
975 ], 849 ],
976 "parameters": { 850 "parameters": {
977 "variantSetId": { 851 "referenceId": {
978 "description": "Required. The ID of the variant set. ", 852 "description": "The ID of the reference.",
979 "location": "path", 853 "location": "path",
980 "required": true, 854 "required": true,
981 "type": "string" 855 "type": "string"
982 } 856 }
983 }, 857 },
984 "path": "v1/variantsets/{variantSetId}", 858 "path": "v1/references/{referenceId}",
985 "response": { 859 "response": {
986 "$ref": "VariantSet" 860 "$ref": "Reference"
987 }, 861 },
988 "scopes": [ 862 "scopes": [
989 "https://www.googleapis.com/auth/cloud-platform", 863 "https://www.googleapis.com/auth/cloud-platform",
990 "https://www.googleapis.com/auth/genomics", 864 "https://www.googleapis.com/auth/genomics",
991 "https://www.googleapis.com/auth/genomics.readonly" 865 "https://www.googleapis.com/auth/genomics.readonly"
992 ] 866 ]
993 }, 867 }
994 "patch": { 868 },
995 "description": "Updates a variant set using patch semantics. \n\nFor the definitions of variant sets and other genomics resources, see\n[Fund amentals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of- google-genomics)", 869 "resources": {
996 "httpMethod": "PATCH", 870 "bases": {
997 "id": "genomics.variantsets.patch", 871 "methods": {
998 "parameterOrder": [ 872 "list": {
999 "variantSetId" 873 "description": "Lists the bases in a reference, opti onally restricted to a range.\n\nFor the definitions of references and other gen omics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.co m/genomics/fundamentals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.ge tReferenceBases](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources /avro/referencemethods.avdl#L221).",
1000 ], 874 "httpMethod": "GET",
1001 "parameters": { 875 "id": "genomics.references.bases.list",
1002 "updateMask": { 876 "parameterOrder": [
1003 "description": "An optional mask specifying which fi elds to update. Supported fields:\n\n* metadata.\n* name.\n* description.\n\nLea ving `updateMask` unset is equivalent to specifying all mutable\nfields.", 877 "referenceId"
1004 "format": "google-fieldmask", 878 ],
1005 "location": "query", 879 "parameters": {
1006 "type": "string" 880 "start": {
1007 }, 881 "description": "The start position (0-based) of this query. Defaults to 0.",
1008 "variantSetId": { 882 "format": "int64",
1009 "description": "The ID of the variant to be updated (must already exist).", 883 "location": "query",
1010 "location": "path", 884 "type": "string"
1011 "required": true, 885 },
1012 "type": "string" 886 "referenceId": {
1013 } 887 "description": "The ID of the reference.",
1014 }, 888 "location": "path",
1015 "path": "v1/variantsets/{variantSetId}", 889 "required": true,
1016 "request": { 890 "type": "string"
1017 "$ref": "VariantSet" 891 },
1018 }, 892 "end": {
1019 "response": { 893 "description": "The end position (0-based, e xclusive) of this query. Defaults to the length\nof this reference.",
1020 "$ref": "VariantSet" 894 "format": "int64",
1021 }, 895 "location": "query",
1022 "scopes": [ 896 "type": "string"
1023 "https://www.googleapis.com/auth/cloud-platform", 897 },
1024 "https://www.googleapis.com/auth/genomics" 898 "pageToken": {
1025 ] 899 "description": "The continuation token, whic h is used to page through large result sets.\nTo get the next page of results, s et this parameter to the value of\n`nextPageToken` from the previous response.",
1026 }, 900 "location": "query",
1027 "delete": { 901 "type": "string"
1028 "description": "Deletes a variant set including all variants , call sets, and calls within.\nThis is not reversible.\n\nFor the definitions o f variant sets and other genomics resources, see\n[Fundamentals of Google\nGenom ics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)", 902 },
1029 "httpMethod": "DELETE", 903 "pageSize": {
1030 "id": "genomics.variantsets.delete", 904 "description": "The maximum number of bases to return in a single page. If unspecified,\ndefaults to 200Kbp (kilo base pairs ). The maximum value is 10Mbp (mega base\npairs).",
1031 "parameterOrder": [ 905 "format": "int32",
1032 "variantSetId" 906 "location": "query",
1033 ], 907 "type": "integer"
1034 "parameters": { 908 }
1035 "variantSetId": { 909 },
1036 "description": "The ID of the variant set to be dele ted.", 910 "path": "v1/references/{referenceId}/bases",
1037 "location": "path", 911 "response": {
1038 "required": true, 912 "$ref": "ListBasesResponse"
1039 "type": "string" 913 },
1040 } 914 "scopes": [
1041 }, 915 "https://www.googleapis.com/auth/cloud-platform" ,
1042 "path": "v1/variantsets/{variantSetId}", 916 "https://www.googleapis.com/auth/genomics",
1043 "response": { 917 "https://www.googleapis.com/auth/genomics.readon ly"
1044 "$ref": "Empty" 918 ]
1045 }, 919 }
1046 "scopes": [ 920 }
1047 "https://www.googleapis.com/auth/cloud-platform",
1048 "https://www.googleapis.com/auth/genomics"
1049 ]
1050 } 921 }
1051 } 922 }
1052 }, 923 },
1053 "operations": { 924 "datasets": {
1054 "methods": { 925 "methods": {
1055 "cancel": { 926 "setIamPolicy": {
1056 "description": "Starts asynchronous cancellation on a long-r unning operation. The server makes a best effort to cancel the operation, but su ccess is not guaranteed. Clients may use Operations.GetOperation or Operations.L istOperations to check whether the cancellation succeeded or the operation compl eted despite cancellation.", 927 "description": "Sets the access control policy on the specif ied dataset. Replaces any\nexisting policy.\n\nFor the definitions of datasets a nd other genomics resources, see\n[Fundamentals of Google\nGenomics](https://clo ud.google.com/genomics/fundamentals-of-google-genomics)\n\nSee <a href=\"/iam/do cs/managing-policies#setting_a_policy\">Setting a\nPolicy</a> for more informati on.",
1057 "httpMethod": "POST", 928 "httpMethod": "POST",
1058 "id": "genomics.operations.cancel", 929 "id": "genomics.datasets.setIamPolicy",
1059 "parameterOrder": [ 930 "parameterOrder": [
1060 "name" 931 "resource"
1061 ], 932 ],
1062 "parameters": { 933 "parameters": {
1063 "name": { 934 "resource": {
1064 "description": "The name of the operation resource t o be cancelled.", 935 "description": "REQUIRED: The resource for which pol icy is being specified. Format is\n`datasets/<dataset ID>`.",
1065 "location": "path", 936 "location": "path",
1066 "pattern": "^operations/.+$", 937 "pattern": "^datasets/[^/]+$",
1067 "required": true, 938 "required": true,
1068 "type": "string" 939 "type": "string"
1069 } 940 }
1070 }, 941 },
1071 "path": "v1/{+name}:cancel", 942 "path": "v1/{+resource}:setIamPolicy",
1072 "request": { 943 "request": {
1073 "$ref": "CancelOperationRequest" 944 "$ref": "SetIamPolicyRequest"
1074 }, 945 },
1075 "response": { 946 "response": {
1076 "$ref": "Empty" 947 "$ref": "Policy"
1077 }, 948 },
1078 "scopes": [ 949 "scopes": [
1079 "https://www.googleapis.com/auth/cloud-platform", 950 "https://www.googleapis.com/auth/cloud-platform",
1080 "https://www.googleapis.com/auth/genomics" 951 "https://www.googleapis.com/auth/genomics"
1081 ] 952 ]
1082 }, 953 },
1083 "get": { 954 "create": {
1084 "description": "Gets the latest state of a long-running oper ation. Clients can use this\nmethod to poll the operation result at intervals a s recommended by the API\nservice.", 955 "description": "Creates a new dataset.\n\nFor the definition s of datasets and other genomics resources, see\n[Fundamentals of Google\nGenomi cs](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
1085 "httpMethod": "GET", 956 "httpMethod": "POST",
1086 "id": "genomics.operations.get", 957 "id": "genomics.datasets.create",
1087 "parameterOrder": [
1088 "name"
1089 ],
1090 "parameters": {
1091 "name": {
1092 "description": "The name of the operation resource." ,
1093 "location": "path",
1094 "pattern": "^operations/.+$",
1095 "required": true,
1096 "type": "string"
1097 }
1098 },
1099 "path": "v1/{+name}",
1100 "response": {
1101 "$ref": "Operation"
1102 },
1103 "scopes": [
1104 "https://www.googleapis.com/auth/cloud-platform",
1105 "https://www.googleapis.com/auth/genomics"
1106 ]
1107 },
1108 "list": {
1109 "description": "Lists operations that match the specified fi lter in the request.",
1110 "httpMethod": "GET",
1111 "id": "genomics.operations.list",
1112 "parameterOrder": [
1113 "name"
1114 ],
1115 "parameters": {
1116 "pageToken": {
1117 "description": "The standard list page token.",
1118 "location": "query",
1119 "type": "string"
1120 },
1121 "name": {
1122 "description": "The name of the operation's parent r esource.",
1123 "location": "path",
1124 "pattern": "^operations$",
1125 "required": true,
1126 "type": "string"
1127 },
1128 "pageSize": {
1129 "description": "The maximum number of results to ret urn. If unspecified, defaults to\n256. The maximum value is 2048.",
1130 "format": "int32",
1131 "location": "query",
1132 "type": "integer"
1133 },
1134 "filter": {
1135 "description": "A string for filtering Operations.\n The following filter fields are supported&#58;\n\n* projectId&#58; Required. Cor responds to\n OperationMetadata.projectId.\n* createTime&#58; The time this job was created, in seconds from the\n [epoch](http://en.wikipedia.org/wiki/Unix_t ime). Can use `>=` and/or `<=`\n operators.\n* status&#58; Can be `RUNNING`, `S UCCESS`, `FAILURE`, or `CANCELED`. Only\n one status may be specified.\n* label s.key where key is a label key.\n\nExamples&#58;\n\n* `projectId = my-project AN D createTime >= 1432140000`\n* `projectId = my-project AND createTime >= 1432140 000 AND createTime <= 1432150000 AND status = RUNNING`\n* `projectId = my-projec t AND labels.color = *`\n* `projectId = my-project AND labels.color = red`",
1136 "location": "query",
1137 "type": "string"
1138 }
1139 },
1140 "path": "v1/{+name}",
1141 "response": {
1142 "$ref": "ListOperationsResponse"
1143 },
1144 "scopes": [
1145 "https://www.googleapis.com/auth/cloud-platform",
1146 "https://www.googleapis.com/auth/genomics"
1147 ]
1148 }
1149 }
1150 },
1151 "referencesets": {
1152 "methods": {
1153 "search": {
1154 "description": "Searches for reference sets which match the given criteria.\n\nFor the definitions of references and other genomics resource s, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fun damentals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.searchReferenceS ets](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/refere ncemethods.avdl#L71)",
1155 "httpMethod": "POST",
1156 "id": "genomics.referencesets.search",
1157 "parameterOrder": [], 958 "parameterOrder": [],
1158 "parameters": {}, 959 "parameters": {},
1159 "path": "v1/referencesets/search", 960 "path": "v1/datasets",
1160 "request": { 961 "request": {
1161 "$ref": "SearchReferenceSetsRequest" 962 "$ref": "Dataset"
1162 }, 963 },
1163 "response": { 964 "response": {
1164 "$ref": "SearchReferenceSetsResponse" 965 "$ref": "Dataset"
1165 }, 966 },
1166 "scopes": [ 967 "scopes": [
1167 "https://www.googleapis.com/auth/cloud-platform", 968 "https://www.googleapis.com/auth/cloud-platform",
969 "https://www.googleapis.com/auth/genomics"
970 ]
971 },
972 "getIamPolicy": {
973 "description": "Gets the access control policy for the datas et. This is empty if the\npolicy or resource does not exist.\n\nSee <a href=\"/i am/docs/managing-policies#getting_a_policy\">Getting a\nPolicy</a> for more info rmation.\n\nFor the definitions of datasets and other genomics resources, see\n[ Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals -of-google-genomics)",
974 "httpMethod": "POST",
975 "id": "genomics.datasets.getIamPolicy",
976 "parameterOrder": [
977 "resource"
978 ],
979 "parameters": {
980 "resource": {
981 "description": "REQUIRED: The resource for which pol icy is being specified. Format is\n`datasets/<dataset ID>`.",
982 "location": "path",
983 "pattern": "^datasets/[^/]+$",
984 "required": true,
985 "type": "string"
986 }
987 },
988 "path": "v1/{+resource}:getIamPolicy",
989 "request": {
990 "$ref": "GetIamPolicyRequest"
991 },
992 "response": {
993 "$ref": "Policy"
994 },
995 "scopes": [
996 "https://www.googleapis.com/auth/cloud-platform",
997 "https://www.googleapis.com/auth/genomics"
998 ]
999 },
1000 "undelete": {
1001 "description": "Undeletes a dataset by restoring a dataset w hich was deleted via this API.\n\nFor the definitions of datasets and other geno mics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com /genomics/fundamentals-of-google-genomics)\n\nThis operation is only possible fo r a week after the deletion occurred.",
1002 "httpMethod": "POST",
1003 "id": "genomics.datasets.undelete",
1004 "parameterOrder": [
1005 "datasetId"
1006 ],
1007 "parameters": {
1008 "datasetId": {
1009 "description": "The ID of the dataset to be undelete d.",
1010 "location": "path",
1011 "required": true,
1012 "type": "string"
1013 }
1014 },
1015 "path": "v1/datasets/{datasetId}:undelete",
1016 "request": {
1017 "$ref": "UndeleteDatasetRequest"
1018 },
1019 "response": {
1020 "$ref": "Dataset"
1021 },
1022 "scopes": [
1023 "https://www.googleapis.com/auth/cloud-platform",
1024 "https://www.googleapis.com/auth/genomics"
1025 ]
1026 },
1027 "patch": {
1028 "description": "Updates a dataset.\n\nFor the definitions of datasets and other genomics resources, see\n[Fundamentals of Google\nGenomics]( https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nThis metho d supports patch semantics.",
1029 "httpMethod": "PATCH",
1030 "id": "genomics.datasets.patch",
1031 "parameterOrder": [
1032 "datasetId"
1033 ],
1034 "parameters": {
1035 "datasetId": {
1036 "description": "The ID of the dataset to be updated. ",
1037 "location": "path",
1038 "required": true,
1039 "type": "string"
1040 },
1041 "updateMask": {
1042 "description": "An optional mask specifying which fi elds to update. At this time, the only\nmutable field is name. The only\naccepta ble value is \"name\". If unspecified, all mutable fields will be\nupdated.",
1043 "format": "google-fieldmask",
1044 "location": "query",
1045 "type": "string"
1046 }
1047 },
1048 "path": "v1/datasets/{datasetId}",
1049 "request": {
1050 "$ref": "Dataset"
1051 },
1052 "response": {
1053 "$ref": "Dataset"
1054 },
1055 "scopes": [
1056 "https://www.googleapis.com/auth/cloud-platform",
1057 "https://www.googleapis.com/auth/genomics"
1058 ]
1059 },
1060 "get": {
1061 "description": "Gets a dataset by ID.\n\nFor the definitions of datasets and other genomics resources, see\n[Fundamentals of Google\nGenomic s](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
1062 "httpMethod": "GET",
1063 "id": "genomics.datasets.get",
1064 "parameterOrder": [
1065 "datasetId"
1066 ],
1067 "parameters": {
1068 "datasetId": {
1069 "description": "The ID of the dataset.",
1070 "location": "path",
1071 "required": true,
1072 "type": "string"
1073 }
1074 },
1075 "path": "v1/datasets/{datasetId}",
1076 "response": {
1077 "$ref": "Dataset"
1078 },
1079 "scopes": [
1080 "https://www.googleapis.com/auth/cloud-platform",
1168 "https://www.googleapis.com/auth/genomics", 1081 "https://www.googleapis.com/auth/genomics",
1169 "https://www.googleapis.com/auth/genomics.readonly" 1082 "https://www.googleapis.com/auth/genomics.readonly"
1170 ] 1083 ]
1171 }, 1084 },
1172 "get": { 1085 "testIamPermissions": {
1173 "description": "Gets a reference set.\n\nFor the definitions of references and other genomics resources, see\n[Fundamentals of Google\nGenom ics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nImple ments\n[GlobalAllianceApi.getReferenceSet](https://github.com/ga4gh/schemas/blob /v0.5.1/src/main/resources/avro/referencemethods.avdl#L83).", 1086 "description": "Returns permissions that a caller has on the specified resource.\nSee <a href=\"/iam/docs/managing-policies#testing_permissi ons\">Testing\nPermissions</a> for more information.\n\nFor the definitions of d atasets and other genomics resources, see\n[Fundamentals of Google\nGenomics](ht tps://cloud.google.com/genomics/fundamentals-of-google-genomics)",
1174 "httpMethod": "GET", 1087 "httpMethod": "POST",
1175 "id": "genomics.referencesets.get", 1088 "id": "genomics.datasets.testIamPermissions",
1176 "parameterOrder": [ 1089 "parameterOrder": [
1177 "referenceSetId" 1090 "resource"
1178 ], 1091 ],
1179 "parameters": { 1092 "parameters": {
1180 "referenceSetId": { 1093 "resource": {
1181 "description": "The ID of the reference set.", 1094 "description": "REQUIRED: The resource for which pol icy is being specified. Format is\n`datasets/<dataset ID>`.",
1095 "location": "path",
1096 "pattern": "^datasets/[^/]+$",
1097 "required": true,
1098 "type": "string"
1099 }
1100 },
1101 "path": "v1/{+resource}:testIamPermissions",
1102 "request": {
1103 "$ref": "TestIamPermissionsRequest"
1104 },
1105 "response": {
1106 "$ref": "TestIamPermissionsResponse"
1107 },
1108 "scopes": [
1109 "https://www.googleapis.com/auth/cloud-platform",
1110 "https://www.googleapis.com/auth/genomics"
1111 ]
1112 },
1113 "delete": {
1114 "description": "Deletes a dataset and all of its contents (a ll read group sets,\nreference sets, variant sets, call sets, annotation sets, e tc.)\nThis is reversible (up to one week after the deletion) via\nthe\ndatasets. undelete\noperation.\n\nFor the definitions of datasets and other genomics resou rces, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/ fundamentals-of-google-genomics)",
1115 "httpMethod": "DELETE",
1116 "id": "genomics.datasets.delete",
1117 "parameterOrder": [
1118 "datasetId"
1119 ],
1120 "parameters": {
1121 "datasetId": {
1122 "description": "The ID of the dataset to be deleted. ",
1182 "location": "path", 1123 "location": "path",
1183 "required": true, 1124 "required": true,
1184 "type": "string" 1125 "type": "string"
1185 } 1126 }
1186 }, 1127 },
1187 "path": "v1/referencesets/{referenceSetId}", 1128 "path": "v1/datasets/{datasetId}",
1188 "response": { 1129 "response": {
1189 "$ref": "ReferenceSet" 1130 "$ref": "Empty"
1190 }, 1131 },
1191 "scopes": [ 1132 "scopes": [
1192 "https://www.googleapis.com/auth/cloud-platform", 1133 "https://www.googleapis.com/auth/cloud-platform",
1134 "https://www.googleapis.com/auth/genomics"
1135 ]
1136 },
1137 "list": {
1138 "description": "Lists datasets within a project.\n\nFor the definitions of datasets and other genomics resources, see\n[Fundamentals of Goog le\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) ",
1139 "httpMethod": "GET",
1140 "id": "genomics.datasets.list",
1141 "parameterOrder": [],
1142 "parameters": {
1143 "pageToken": {
1144 "description": "The continuation token, which is use d to page through large result sets.\nTo get the next page of results, set this parameter to the value of\n`nextPageToken` from the previous response.",
1145 "location": "query",
1146 "type": "string"
1147 },
1148 "pageSize": {
1149 "description": "The maximum number of results to ret urn in a single page. If unspecified,\ndefaults to 50. The maximum value is 1024 .",
1150 "format": "int32",
1151 "location": "query",
1152 "type": "integer"
1153 },
1154 "projectId": {
1155 "description": "Required. The Google Cloud project I D to list datasets for.",
1156 "location": "query",
1157 "type": "string"
1158 }
1159 },
1160 "path": "v1/datasets",
1161 "response": {
1162 "$ref": "ListDatasetsResponse"
1163 },
1164 "scopes": [
1165 "https://www.googleapis.com/auth/cloud-platform",
1193 "https://www.googleapis.com/auth/genomics", 1166 "https://www.googleapis.com/auth/genomics",
1194 "https://www.googleapis.com/auth/genomics.readonly" 1167 "https://www.googleapis.com/auth/genomics.readonly"
1195 ] 1168 ]
1196 } 1169 }
1197 } 1170 }
1198 }, 1171 },
1199 "readgroupsets": { 1172 "annotations": {
1200 "methods": { 1173 "methods": {
1201 "import": { 1174 "update": {
1202 "description": "Creates read group sets by asynchronously im porting the provided\ninformation.\n\nFor the definitions of read group sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud .google.com/genomics/fundamentals-of-google-genomics)\n\nThe caller must have WR ITE permissions to the dataset.\n\n## Notes on [BAM](https://samtools.github.io/ hts-specs/SAMv1.pdf) import\n\n- Tags will be converted to strings - tag types a re not preserved\n- Comments (`@CO`) in the input file header will not be preser ved\n- Original header order of references (`@SQ`) will not be preserved\n- Any reverse stranded unmapped reads will be reverse complemented, and\ntheir qualiti es (also the \"BQ\" and \"OQ\" tags, if any) will be reversed\n- Unmapped reads will be stripped of positional information (reference name\nand position)", 1175 "description": "Updates an annotation. Caller must have\nWRI TE permission for the associated dataset.",
1203 "httpMethod": "POST", 1176 "httpMethod": "PUT",
1204 "id": "genomics.readgroupsets.import", 1177 "id": "genomics.annotations.update",
1205 "parameterOrder": [],
1206 "parameters": {},
1207 "path": "v1/readgroupsets:import",
1208 "request": {
1209 "$ref": "ImportReadGroupSetsRequest"
1210 },
1211 "response": {
1212 "$ref": "Operation"
1213 },
1214 "scopes": [
1215 "https://www.googleapis.com/auth/cloud-platform",
1216 "https://www.googleapis.com/auth/devstorage.read_write",
1217 "https://www.googleapis.com/auth/genomics"
1218 ]
1219 },
1220 "delete": {
1221 "description": "Deletes a read group set.\n\nFor the definit ions of read group sets and other genomics resources, see\n[Fundamentals of Goog le\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) ",
1222 "httpMethod": "DELETE",
1223 "id": "genomics.readgroupsets.delete",
1224 "parameterOrder": [ 1178 "parameterOrder": [
1225 "readGroupSetId" 1179 "annotationId"
1226 ], 1180 ],
1227 "parameters": { 1181 "parameters": {
1228 "readGroupSetId": { 1182 "updateMask": {
1229 "description": "The ID of the read group set to be d eleted. The caller must have WRITE\npermissions to the dataset associated with t his read group set.", 1183 "description": "An optional mask specifying which fi elds to update. Mutable fields are\nname,\nvariant,\ntranscript, and\ninfo. If u nspecified, all mutable\nfields will be updated.",
1184 "format": "google-fieldmask",
1185 "location": "query",
1186 "type": "string"
1187 },
1188 "annotationId": {
1189 "description": "The ID of the annotation to be updat ed.",
1230 "location": "path", 1190 "location": "path",
1231 "required": true, 1191 "required": true,
1232 "type": "string" 1192 "type": "string"
1233 } 1193 }
1234 }, 1194 },
1235 "path": "v1/readgroupsets/{readGroupSetId}", 1195 "path": "v1/annotations/{annotationId}",
1196 "request": {
1197 "$ref": "Annotation"
1198 },
1199 "response": {
1200 "$ref": "Annotation"
1201 },
1202 "scopes": [
1203 "https://www.googleapis.com/auth/cloud-platform",
1204 "https://www.googleapis.com/auth/genomics"
1205 ]
1206 },
1207 "delete": {
1208 "description": "Deletes an annotation. Caller must have WRIT E permission for\nthe associated annotation set.",
1209 "httpMethod": "DELETE",
1210 "id": "genomics.annotations.delete",
1211 "parameterOrder": [
1212 "annotationId"
1213 ],
1214 "parameters": {
1215 "annotationId": {
1216 "description": "The ID of the annotation to be delet ed.",
1217 "location": "path",
1218 "required": true,
1219 "type": "string"
1220 }
1221 },
1222 "path": "v1/annotations/{annotationId}",
1236 "response": { 1223 "response": {
1237 "$ref": "Empty" 1224 "$ref": "Empty"
1238 }, 1225 },
1239 "scopes": [ 1226 "scopes": [
1240 "https://www.googleapis.com/auth/cloud-platform", 1227 "https://www.googleapis.com/auth/cloud-platform",
1241 "https://www.googleapis.com/auth/genomics" 1228 "https://www.googleapis.com/auth/genomics"
1242 ] 1229 ]
1243 }, 1230 },
1244 "export": { 1231 "create": {
1245 "description": "Exports a read group set to a BAM file in Go ogle Cloud Storage.\n\nFor the definitions of read group sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/gen omics/fundamentals-of-google-genomics)\n\nNote that currently there may be some differences between exported BAM\nfiles and the original BAM file at the time of import. See\nImportReadGroupSets\nfor caveats.", 1232 "description": "Creates a new annotation. Caller must have W RITE permission\nfor the associated annotation set.\n\nThe following fields are required:\n\n* annotationSetId\n* referenceName or\n referenceId\n\n### Transcr ipts\n\nFor annotations of type TRANSCRIPT, the following fields of\ntranscript must be provided:\n\n* exons.start\n* exons.end\n\nAll other fields may be optio nally specified, unless documented as being\nserver-generated (for example, the `id` field). The annotated\nrange must be no longer than 100Mbp (mega base pairs ). See the\nAnnotation resource\nfor additional restrictions on each field.",
1246 "httpMethod": "POST", 1233 "httpMethod": "POST",
1247 "id": "genomics.readgroupsets.export", 1234 "id": "genomics.annotations.create",
1248 "parameterOrder": [ 1235 "parameterOrder": [],
1249 "readGroupSetId" 1236 "parameters": {},
1250 ], 1237 "path": "v1/annotations",
1251 "parameters": {
1252 "readGroupSetId": {
1253 "description": "Required. The ID of the read group s et to export. The caller must have\nREAD access to this read group set.",
1254 "location": "path",
1255 "required": true,
1256 "type": "string"
1257 }
1258 },
1259 "path": "v1/readgroupsets/{readGroupSetId}:export",
1260 "request": { 1238 "request": {
1261 "$ref": "ExportReadGroupSetRequest" 1239 "$ref": "Annotation"
1262 }, 1240 },
1263 "response": { 1241 "response": {
1264 "$ref": "Operation" 1242 "$ref": "Annotation"
1265 }, 1243 },
1266 "scopes": [ 1244 "scopes": [
1267 "https://www.googleapis.com/auth/cloud-platform", 1245 "https://www.googleapis.com/auth/cloud-platform",
1268 "https://www.googleapis.com/auth/devstorage.read_write", 1246 "https://www.googleapis.com/auth/genomics"
1247 ]
1248 },
1249 "batchCreate": {
1250 "description": "Creates one or more new annotations atomical ly. All annotations must\nbelong to the same annotation set. Caller must have WR ITE\npermission for this annotation set. For optimal performance, batch\npositio nally adjacent annotations together.\n\nIf the request has a systemic issue, suc h as an attempt to write to\nan inaccessible annotation set, the entire RPC will fail accordingly. For\nlesser data issues, when possible an error will be isola ted to the\ncorresponding batch entry in the response; the remaining well formed \nannotations will be created normally.\n\nFor details on the requirements for e ach individual annotation resource,\nsee\nCreateAnnotation.",
1251 "httpMethod": "POST",
1252 "id": "genomics.annotations.batchCreate",
1253 "parameterOrder": [],
1254 "parameters": {},
1255 "path": "v1/annotations:batchCreate",
1256 "request": {
1257 "$ref": "BatchCreateAnnotationsRequest"
1258 },
1259 "response": {
1260 "$ref": "BatchCreateAnnotationsResponse"
1261 },
1262 "scopes": [
1263 "https://www.googleapis.com/auth/cloud-platform",
1269 "https://www.googleapis.com/auth/genomics" 1264 "https://www.googleapis.com/auth/genomics"
1270 ] 1265 ]
1271 }, 1266 },
1272 "search": { 1267 "search": {
1273 "description": "Searches for read group sets matching the cr iteria.\n\nFor the definitions of read group sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundam entals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.searchReadGroupSets ](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/readmetho ds.avdl#L135).", 1268 "description": "Searches for annotations that match the give n criteria. Results are\nordered by genomic coordinate (by reference sequence, t hen position).\nAnnotations with equivalent genomic coordinates are returned in an\nunspecified order. This order is consistent, such that two queries for the\n same content (regardless of page size) yield annotations in the same order\nacro ss their respective streams of paginated responses. Caller must have\nREAD permi ssion for the queried annotation sets.",
1274 "httpMethod": "POST", 1269 "httpMethod": "POST",
1275 "id": "genomics.readgroupsets.search", 1270 "id": "genomics.annotations.search",
1276 "parameterOrder": [], 1271 "parameterOrder": [],
1277 "parameters": {}, 1272 "parameters": {},
1278 "path": "v1/readgroupsets/search", 1273 "path": "v1/annotations/search",
1279 "request": { 1274 "request": {
1280 "$ref": "SearchReadGroupSetsRequest" 1275 "$ref": "SearchAnnotationsRequest"
1281 }, 1276 },
1282 "response": { 1277 "response": {
1283 "$ref": "SearchReadGroupSetsResponse" 1278 "$ref": "SearchAnnotationsResponse"
1284 }, 1279 },
1285 "scopes": [ 1280 "scopes": [
1286 "https://www.googleapis.com/auth/cloud-platform", 1281 "https://www.googleapis.com/auth/cloud-platform",
1287 "https://www.googleapis.com/auth/genomics", 1282 "https://www.googleapis.com/auth/genomics",
1288 "https://www.googleapis.com/auth/genomics.readonly" 1283 "https://www.googleapis.com/auth/genomics.readonly"
1289 ] 1284 ]
1290 }, 1285 },
1291 "get": { 1286 "get": {
1292 "description": "Gets a read group set by ID.\n\nFor the defi nitions of read group sets and other genomics resources, see\n[Fundamentals of G oogle\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomi cs)", 1287 "description": "Gets an annotation. Caller must have READ pe rmission\nfor the associated annotation set.",
1293 "httpMethod": "GET", 1288 "httpMethod": "GET",
1294 "id": "genomics.readgroupsets.get", 1289 "id": "genomics.annotations.get",
1295 "parameterOrder": [ 1290 "parameterOrder": [
1296 "readGroupSetId" 1291 "annotationId"
1297 ], 1292 ],
1298 "parameters": { 1293 "parameters": {
1299 "readGroupSetId": { 1294 "annotationId": {
1300 "description": "The ID of the read group set.", 1295 "description": "The ID of the annotation to be retri eved.",
1301 "location": "path", 1296 "location": "path",
1302 "required": true, 1297 "required": true,
1303 "type": "string" 1298 "type": "string"
1304 } 1299 }
1305 }, 1300 },
1306 "path": "v1/readgroupsets/{readGroupSetId}", 1301 "path": "v1/annotations/{annotationId}",
1307 "response": { 1302 "response": {
1308 "$ref": "ReadGroupSet" 1303 "$ref": "Annotation"
1309 },
1310 "scopes": [
1311 "https://www.googleapis.com/auth/cloud-platform",
1312 "https://www.googleapis.com/auth/genomics",
1313 "https://www.googleapis.com/auth/genomics.readonly"
1314 ]
1315 },
1316 "patch": {
1317 "description": "Updates a read group set.\n\nFor the definit ions of read group sets and other genomics resources, see\n[Fundamentals of Goog le\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) \n\nThis method supports patch semantics.",
1318 "httpMethod": "PATCH",
1319 "id": "genomics.readgroupsets.patch",
1320 "parameterOrder": [
1321 "readGroupSetId"
1322 ],
1323 "parameters": {
1324 "readGroupSetId": {
1325 "description": "The ID of the read group set to be u pdated. The caller must have WRITE\npermissions to the dataset associated with t his read group set.",
1326 "location": "path",
1327 "required": true,
1328 "type": "string"
1329 },
1330 "updateMask": {
1331 "description": "An optional mask specifying which fi elds to update. Supported fields:\n\n* name.\n* referenceSetId.\n\nLeaving `upda teMask` unset is equivalent to specifying all mutable\nfields.",
1332 "format": "google-fieldmask",
1333 "location": "query",
1334 "type": "string"
1335 }
1336 },
1337 "path": "v1/readgroupsets/{readGroupSetId}",
1338 "request": {
1339 "$ref": "ReadGroupSet"
1340 },
1341 "response": {
1342 "$ref": "ReadGroupSet"
1343 },
1344 "scopes": [
1345 "https://www.googleapis.com/auth/cloud-platform",
1346 "https://www.googleapis.com/auth/genomics"
1347 ]
1348 }
1349 },
1350 "resources": {
1351 "coveragebuckets": {
1352 "methods": {
1353 "list": {
1354 "description": "Lists fixed width coverage buckets f or a read group set, each of which\ncorrespond to a range of a reference sequenc e. Each bucket summarizes\ncoverage information across its corresponding genomic range.\n\nFor the definitions of read group sets and other genomics resources, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundam entals-of-google-genomics)\n\nCoverage is defined as the number of reads which a re aligned to a given\nbase in the reference sequence. Coverage buckets are avai lable at several\nprecomputed bucket widths, enabling retrieval of various cover age 'zoom\nlevels'. The caller must have READ permissions for the target read gr oup\nset.",
1355 "httpMethod": "GET",
1356 "id": "genomics.readgroupsets.coveragebuckets.list",
1357 "parameterOrder": [
1358 "readGroupSetId"
1359 ],
1360 "parameters": {
1361 "end": {
1362 "description": "The end position of the rang e on the reference, 0-based exclusive. If\nspecified, `referenceName` must also be specified. If unset or 0, defaults\nto the length of the reference.",
1363 "format": "int64",
1364 "location": "query",
1365 "type": "string"
1366 },
1367 "pageToken": {
1368 "description": "The continuation token, whic h is used to page through large result sets.\nTo get the next page of results, s et this parameter to the value of\n`nextPageToken` from the previous response.",
1369 "location": "query",
1370 "type": "string"
1371 },
1372 "pageSize": {
1373 "description": "The maximum number of result s to return in a single page. If unspecified,\ndefaults to 1024. The maximum val ue is 2048.",
1374 "format": "int32",
1375 "location": "query",
1376 "type": "integer"
1377 },
1378 "start": {
1379 "description": "The start position of the ra nge on the reference, 0-based inclusive. If\nspecified, `referenceName` must als o be specified. Defaults to 0.",
1380 "format": "int64",
1381 "location": "query",
1382 "type": "string"
1383 },
1384 "readGroupSetId": {
1385 "description": "Required. The ID of the read group set over which coverage is requested.",
1386 "location": "path",
1387 "required": true,
1388 "type": "string"
1389 },
1390 "targetBucketWidth": {
1391 "description": "The desired width of each re ported coverage bucket in base pairs. This\nwill be rounded down to the nearest precomputed bucket width; the value\nof which is returned as `bucketWidth` in th e response. Defaults\nto infinity (each bucket spans an entire reference sequenc e) or the length\nof the target range, if specified. The smallest precomputed\n` bucketWidth` is currently 2048 base pairs; this is subject to\nchange.",
1392 "format": "int64",
1393 "location": "query",
1394 "type": "string"
1395 },
1396 "referenceName": {
1397 "description": "The name of the reference to query, within the reference set associated\nwith this query. Optional.",
1398 "location": "query",
1399 "type": "string"
1400 }
1401 },
1402 "path": "v1/readgroupsets/{readGroupSetId}/coverageb uckets",
1403 "response": {
1404 "$ref": "ListCoverageBucketsResponse"
1405 },
1406 "scopes": [
1407 "https://www.googleapis.com/auth/cloud-platform" ,
1408 "https://www.googleapis.com/auth/genomics",
1409 "https://www.googleapis.com/auth/genomics.readon ly"
1410 ]
1411 }
1412 }
1413 }
1414 }
1415 },
1416 "reads": {
1417 "methods": {
1418 "search": {
1419 "description": "Gets a list of reads for one or more read gr oup sets.\n\nFor the definitions of read group sets and other genomics resources , see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fund amentals-of-google-genomics)\n\nReads search operates over a genomic coordinate space of reference sequence\n& position defined over the reference sequences to which the requested\nread group sets are aligned.\n\nIf a target positional rang e is specified, search returns all reads whose\nalignment to the reference genom e overlap the range. A query which\nspecifies only read group set IDs yields all reads in those read group\nsets, including unmapped reads.\n\nAll reads returne d (including reads on subsequent pages) are ordered by\ngenomic coordinate (by r eference sequence, then position). Reads with\nequivalent genomic coordinates ar e returned in an unspecified order. This\norder is consistent, such that two que ries for the same content (regardless\nof page size) yield reads in the same ord er across their respective streams\nof paginated responses.\n\nImplements\n[Glob alAllianceApi.searchReads](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main /resources/avro/readmethods.avdl#L85).",
1420 "httpMethod": "POST",
1421 "id": "genomics.reads.search",
1422 "parameterOrder": [],
1423 "parameters": {},
1424 "path": "v1/reads/search",
1425 "request": {
1426 "$ref": "SearchReadsRequest"
1427 },
1428 "response": {
1429 "$ref": "SearchReadsResponse"
1430 }, 1304 },
1431 "scopes": [ 1305 "scopes": [
1432 "https://www.googleapis.com/auth/cloud-platform", 1306 "https://www.googleapis.com/auth/cloud-platform",
1433 "https://www.googleapis.com/auth/genomics", 1307 "https://www.googleapis.com/auth/genomics",
1434 "https://www.googleapis.com/auth/genomics.readonly" 1308 "https://www.googleapis.com/auth/genomics.readonly"
1435 ] 1309 ]
1436 } 1310 }
1437 } 1311 }
1438 }, 1312 },
1439 "callsets": { 1313 "variantsets": {
1440 "methods": { 1314 "methods": {
1441 "delete": { 1315 "create": {
1442 "description": "Deletes a call set.\n\nFor the definitions o f call sets and other genomics resources, see\n[Fundamentals of Google\nGenomics ](https://cloud.google.com/genomics/fundamentals-of-google-genomics)", 1316 "description": "Creates a new variant set.\n\nFor the defini tions of variant sets and other genomics resources, see\n[Fundamentals of Google \nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n \nThe provided variant set must have a valid `datasetId` set - all other\nfields are optional. Note that the `id` field will be ignored, as this is\nassigned by the server.",
1443 "httpMethod": "DELETE", 1317 "httpMethod": "POST",
1444 "id": "genomics.callsets.delete", 1318 "id": "genomics.variantsets.create",
1445 "parameterOrder": [ 1319 "parameterOrder": [],
1446 "callSetId" 1320 "parameters": {},
1447 ], 1321 "path": "v1/variantsets",
1448 "parameters": { 1322 "request": {
1449 "callSetId": { 1323 "$ref": "VariantSet"
1450 "description": "The ID of the call set to be deleted .",
1451 "location": "path",
1452 "required": true,
1453 "type": "string"
1454 }
1455 }, 1324 },
1456 "path": "v1/callsets/{callSetId}",
1457 "response": { 1325 "response": {
1458 "$ref": "Empty" 1326 "$ref": "VariantSet"
1459 }, 1327 },
1460 "scopes": [ 1328 "scopes": [
1461 "https://www.googleapis.com/auth/cloud-platform", 1329 "https://www.googleapis.com/auth/cloud-platform",
1462 "https://www.googleapis.com/auth/genomics" 1330 "https://www.googleapis.com/auth/genomics"
1463 ] 1331 ]
1464 }, 1332 },
1333 "export": {
1334 "description": "Exports variant set data to an external dest ination.\n\nFor the definitions of variant sets and other genomics resources, se e\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/fundamen tals-of-google-genomics)",
1335 "httpMethod": "POST",
1336 "id": "genomics.variantsets.export",
1337 "parameterOrder": [
1338 "variantSetId"
1339 ],
1340 "parameters": {
1341 "variantSetId": {
1342 "description": "Required. The ID of the variant set that contains variant data which\nshould be exported. The caller must have READ access to this variant set.",
1343 "location": "path",
1344 "required": true,
1345 "type": "string"
1346 }
1347 },
1348 "path": "v1/variantsets/{variantSetId}:export",
1349 "request": {
1350 "$ref": "ExportVariantSetRequest"
1351 },
1352 "response": {
1353 "$ref": "Operation"
1354 },
1355 "scopes": [
1356 "https://www.googleapis.com/auth/bigquery",
1357 "https://www.googleapis.com/auth/cloud-platform",
1358 "https://www.googleapis.com/auth/genomics"
1359 ]
1360 },
1465 "search": { 1361 "search": {
1466 "description": "Gets a list of call sets matching the criter ia.\n\nFor the definitions of call sets and other genomics resources, see\n[Fund amentals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of- google-genomics)\n\nImplements\n[GlobalAllianceApi.searchCallSets](https://githu b.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variantmethods.avdl#L178 ).", 1362 "description": "Returns a list of all variant sets matching search criteria.\n\nFor the definitions of variant sets and other genomics resou rces, see\n[Fundamentals of Google\nGenomics](https://cloud.google.com/genomics/ fundamentals-of-google-genomics)\n\nImplements\n[GlobalAllianceApi.searchVariant Sets](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/varia ntmethods.avdl#L49).",
1467 "httpMethod": "POST", 1363 "httpMethod": "POST",
1468 "id": "genomics.callsets.search", 1364 "id": "genomics.variantsets.search",
1469 "parameterOrder": [], 1365 "parameterOrder": [],
1470 "parameters": {}, 1366 "parameters": {},
1471 "path": "v1/callsets/search", 1367 "path": "v1/variantsets/search",
1472 "request": { 1368 "request": {
1473 "$ref": "SearchCallSetsRequest" 1369 "$ref": "SearchVariantSetsRequest"
1474 }, 1370 },
1475 "response": { 1371 "response": {
1476 "$ref": "SearchCallSetsResponse" 1372 "$ref": "SearchVariantSetsResponse"
1477 }, 1373 },
1478 "scopes": [ 1374 "scopes": [
1479 "https://www.googleapis.com/auth/cloud-platform", 1375 "https://www.googleapis.com/auth/cloud-platform",
1480 "https://www.googleapis.com/auth/genomics", 1376 "https://www.googleapis.com/auth/genomics",
1481 "https://www.googleapis.com/auth/genomics.readonly" 1377 "https://www.googleapis.com/auth/genomics.readonly"
1482 ] 1378 ]
1483 }, 1379 },
1484 "get": { 1380 "patch": {
1485 "description": "Gets a call set by ID.\n\nFor the definition s of call sets and other genomics resources, see\n[Fundamentals of Google\nGenom ics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)", 1381 "description": "Updates a variant set using patch semantics. \n\nFor the definitions of variant sets and other genomics resources, see\n[Fund amentals of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of- google-genomics)",
1486 "httpMethod": "GET", 1382 "httpMethod": "PATCH",
1487 "id": "genomics.callsets.get", 1383 "id": "genomics.variantsets.patch",
1488 "parameterOrder": [ 1384 "parameterOrder": [
1489 "callSetId" 1385 "variantSetId"
1490 ], 1386 ],
1491 "parameters": { 1387 "parameters": {
1492 "callSetId": { 1388 "updateMask": {
1493 "description": "The ID of the call set.", 1389 "description": "An optional mask specifying which fi elds to update. Supported fields:\n\n* metadata.\n* name.\n* description.\n\nLea ving `updateMask` unset is equivalent to specifying all mutable\nfields.",
1390 "format": "google-fieldmask",
1391 "location": "query",
1392 "type": "string"
1393 },
1394 "variantSetId": {
1395 "description": "The ID of the variant to be updated (must already exist).",
1494 "location": "path", 1396 "location": "path",
1495 "required": true, 1397 "required": true,
1496 "type": "string" 1398 "type": "string"
1497 } 1399 }
1498 }, 1400 },
1499 "path": "v1/callsets/{callSetId}", 1401 "path": "v1/variantsets/{variantSetId}",
1402 "request": {
1403 "$ref": "VariantSet"
1404 },
1500 "response": { 1405 "response": {
1501 "$ref": "CallSet" 1406 "$ref": "VariantSet"
1502 }, 1407 },
1503 "scopes": [ 1408 "scopes": [
1504 "https://www.googleapis.com/auth/cloud-platform", 1409 "https://www.googleapis.com/auth/cloud-platform",
1410 "https://www.googleapis.com/auth/genomics"
1411 ]
1412 },
1413 "get": {
1414 "description": "Gets a variant set by ID.\n\nFor the definit ions of variant sets and other genomics resources, see\n[Fundamentals of Google\ nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
1415 "httpMethod": "GET",
1416 "id": "genomics.variantsets.get",
1417 "parameterOrder": [
1418 "variantSetId"
1419 ],
1420 "parameters": {
1421 "variantSetId": {
1422 "description": "Required. The ID of the variant set. ",
1423 "location": "path",
1424 "required": true,
1425 "type": "string"
1426 }
1427 },
1428 "path": "v1/variantsets/{variantSetId}",
1429 "response": {
1430 "$ref": "VariantSet"
1431 },
1432 "scopes": [
1433 "https://www.googleapis.com/auth/cloud-platform",
1505 "https://www.googleapis.com/auth/genomics", 1434 "https://www.googleapis.com/auth/genomics",
1506 "https://www.googleapis.com/auth/genomics.readonly" 1435 "https://www.googleapis.com/auth/genomics.readonly"
1507 ] 1436 ]
1508 }, 1437 },
1509 "patch": { 1438 "delete": {
1510 "description": "Updates a call set.\n\nFor the definitions o f call sets and other genomics resources, see\n[Fundamentals of Google\nGenomics ](https://cloud.google.com/genomics/fundamentals-of-google-genomics)\n\nThis met hod supports patch semantics.", 1439 "description": "Deletes a variant set including all variants , call sets, and calls within.\nThis is not reversible.\n\nFor the definitions o f variant sets and other genomics resources, see\n[Fundamentals of Google\nGenom ics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
1511 "httpMethod": "PATCH", 1440 "httpMethod": "DELETE",
1512 "id": "genomics.callsets.patch", 1441 "id": "genomics.variantsets.delete",
1513 "parameterOrder": [ 1442 "parameterOrder": [
1514 "callSetId" 1443 "variantSetId"
1515 ], 1444 ],
1516 "parameters": { 1445 "parameters": {
1517 "callSetId": { 1446 "variantSetId": {
1518 "description": "The ID of the call set to be updated .", 1447 "description": "The ID of the variant set to be dele ted.",
1519 "location": "path", 1448 "location": "path",
1520 "required": true, 1449 "required": true,
1521 "type": "string" 1450 "type": "string"
1522 },
1523 "updateMask": {
1524 "description": "An optional mask specifying which fi elds to update. At this time, the only\nmutable field is name. The only\naccepta ble value is \"name\". If unspecified, all mutable fields will be\nupdated.",
1525 "format": "google-fieldmask",
1526 "location": "query",
1527 "type": "string"
1528 } 1451 }
1529 }, 1452 },
1530 "path": "v1/callsets/{callSetId}", 1453 "path": "v1/variantsets/{variantSetId}",
1531 "request": {
1532 "$ref": "CallSet"
1533 },
1534 "response": { 1454 "response": {
1535 "$ref": "CallSet" 1455 "$ref": "Empty"
1536 }, 1456 },
1537 "scopes": [ 1457 "scopes": [
1538 "https://www.googleapis.com/auth/cloud-platform", 1458 "https://www.googleapis.com/auth/cloud-platform",
1539 "https://www.googleapis.com/auth/genomics" 1459 "https://www.googleapis.com/auth/genomics"
1540 ] 1460 ]
1541 }, 1461 }
1542 "create": { 1462 }
1543 "description": "Creates a new call set.\n\nFor the definitio ns of call sets and other genomics resources, see\n[Fundamentals of Google\nGeno mics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)", 1463 },
1464 "operations": {
1465 "methods": {
1466 "cancel": {
1467 "description": "Starts asynchronous cancellation on a long-r unning operation. The server makes a best effort to cancel the operation, but su ccess is not guaranteed. Clients may use Operations.GetOperation or Operations.L istOperations to check whether the cancellation succeeded or the operation compl eted despite cancellation.",
1544 "httpMethod": "POST", 1468 "httpMethod": "POST",
1545 "id": "genomics.callsets.create", 1469 "id": "genomics.operations.cancel",
1546 "parameterOrder": [], 1470 "parameterOrder": [
1547 "parameters": {}, 1471 "name"
1548 "path": "v1/callsets", 1472 ],
1473 "parameters": {
1474 "name": {
1475 "description": "The name of the operation resource t o be cancelled.",
1476 "location": "path",
1477 "pattern": "^operations/.+$",
1478 "required": true,
1479 "type": "string"
1480 }
1481 },
1482 "path": "v1/{+name}:cancel",
1549 "request": { 1483 "request": {
1550 "$ref": "CallSet" 1484 "$ref": "CancelOperationRequest"
1551 }, 1485 },
1552 "response": { 1486 "response": {
1553 "$ref": "CallSet" 1487 "$ref": "Empty"
1554 }, 1488 },
1555 "scopes": [ 1489 "scopes": [
1556 "https://www.googleapis.com/auth/cloud-platform", 1490 "https://www.googleapis.com/auth/cloud-platform",
1557 "https://www.googleapis.com/auth/genomics" 1491 "https://www.googleapis.com/auth/genomics"
1558 ] 1492 ]
1493 },
1494 "get": {
1495 "description": "Gets the latest state of a long-running oper ation. Clients can use this\nmethod to poll the operation result at intervals a s recommended by the API\nservice.",
1496 "httpMethod": "GET",
1497 "id": "genomics.operations.get",
1498 "parameterOrder": [
1499 "name"
1500 ],
1501 "parameters": {
1502 "name": {
1503 "description": "The name of the operation resource." ,
1504 "location": "path",
1505 "pattern": "^operations/.+$",
1506 "required": true,
1507 "type": "string"
1508 }
1509 },
1510 "path": "v1/{+name}",
1511 "response": {
1512 "$ref": "Operation"
1513 },
1514 "scopes": [
1515 "https://www.googleapis.com/auth/cloud-platform",
1516 "https://www.googleapis.com/auth/genomics"
1517 ]
1518 },
1519 "list": {
1520 "description": "Lists operations that match the specified fi lter in the request.",
1521 "httpMethod": "GET",
1522 "id": "genomics.operations.list",
1523 "parameterOrder": [
1524 "name"
1525 ],
1526 "parameters": {
1527 "pageToken": {
1528 "description": "The standard list page token.",
1529 "location": "query",
1530 "type": "string"
1531 },
1532 "name": {
1533 "description": "The name of the operation's parent r esource.",
1534 "location": "path",
1535 "pattern": "^operations$",
1536 "required": true,
1537 "type": "string"
1538 },
1539 "pageSize": {
1540 "description": "The maximum number of results to ret urn. If unspecified, defaults to\n256. The maximum value is 2048.",
1541 "format": "int32",
1542 "location": "query",
1543 "type": "integer"
1544 },
1545 "filter": {
1546 "description": "A string for filtering Operations.\n The following filter fields are supported&#58;\n\n* projectId&#58; Required. Cor responds to\n OperationMetadata.projectId.\n* createTime&#58; The time this job was created, in seconds from the\n [epoch](http://en.wikipedia.org/wiki/Unix_t ime). Can use `>=` and/or `<=`\n operators.\n* status&#58; Can be `RUNNING`, `S UCCESS`, `FAILURE`, or `CANCELED`. Only\n one status may be specified.\n* label s.key where key is a label key.\n\nExamples&#58;\n\n* `projectId = my-project AN D createTime >= 1432140000`\n* `projectId = my-project AND createTime >= 1432140 000 AND createTime <= 1432150000 AND status = RUNNING`\n* `projectId = my-projec t AND labels.color = *`\n* `projectId = my-project AND labels.color = red`",
1547 "location": "query",
1548 "type": "string"
1549 }
1550 },
1551 "path": "v1/{+name}",
1552 "response": {
1553 "$ref": "ListOperationsResponse"
1554 },
1555 "scopes": [
1556 "https://www.googleapis.com/auth/cloud-platform",
1557 "https://www.googleapis.com/auth/genomics"
1558 ]
1559 } 1559 }
1560 } 1560 }
1561 } 1561 }
1562 }, 1562 },
1563 "revision": "20170817", 1563 "revision": "20170907",
1564 "rootUrl": "https://genomics.googleapis.com/", 1564 "rootUrl": "https://genomics.googleapis.com/",
1565 "schemas": { 1565 "schemas": {
1566 "Range": { 1566 "ImportVariantsResponse": {
1567 "description": "A 0-based half-open genomic coordinate range for sea rch requests.", 1567 "description": "The variant data import response.",
1568 "id": "Range", 1568 "id": "ImportVariantsResponse",
1569 "properties": { 1569 "properties": {
1570 "referenceName": { 1570 "callSetIds": {
1571 "description": "The reference sequence name, for example `ch r1`,\n`1`, or `chrX`.", 1571 "description": "IDs of the call sets created during the impo rt.",
1572 "type": "string" 1572 "items": {
1573 }, 1573 "type": "string"
1574 "start": { 1574 },
1575 "description": "The start position of the range on the refer ence, 0-based inclusive.", 1575 "type": "array"
1576 "format": "int64", 1576 }
1577 "type": "string" 1577 },
1578 }, 1578 "type": "object"
1579 "end": { 1579 },
1580 "description": "The end position of the range on the referen ce, 0-based exclusive.", 1580 "ReadGroup": {
1581 "format": "int64", 1581 "description": "A read group is all the data that's processed the sa me way by the sequencer.",
1582 "type": "string" 1582 "id": "ReadGroup",
1583 } 1583 "properties": {
1584 }, 1584 "programs": {
1585 "type": "object" 1585 "description": "The programs used to generate this read grou p. Programs are always\nidentical for all read groups within a read group set. F or this reason,\nonly the first read group in a returned set will have this fiel d\npopulated.",
1586 }, 1586 "items": {
1587 "VariantSet": { 1587 "$ref": "Program"
1588 "description": "A variant set is a collection of call sets and varia nts. It contains summary\nstatistics of those contents. A variant set belongs to a dataset.\n\nFor more genomics resource definitions, see [Fundamentals of Goog le\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) ", 1588 },
1589 "id": "VariantSet", 1589 "type": "array"
1590 "properties": { 1590 },
1591 "predictedInsertSize": {
1592 "description": "The predicted insert size of this read group . The insert size is the length\nthe sequenced DNA fragment from end-to-end, not including the adapters.",
1593 "format": "int32",
1594 "type": "integer"
1595 },
1591 "description": { 1596 "description": {
1592 "description": "A textual description of this variant set.", 1597 "description": "A free-form text description of this read gr oup.",
1598 "type": "string"
1599 },
1600 "sampleId": {
1601 "description": "A client-supplied sample identifier for the reads in this read group.",
1593 "type": "string" 1602 "type": "string"
1594 }, 1603 },
1595 "datasetId": { 1604 "datasetId": {
1596 "description": "The dataset to which this variant set belong s.", 1605 "description": "The dataset to which this read group belongs .",
1597 "type": "string" 1606 "type": "string"
1607 },
1608 "experiment": {
1609 "$ref": "Experiment",
1610 "description": "The experiment used to generate this read gr oup."
1598 }, 1611 },
1599 "name": { 1612 "name": {
1600 "description": "User-specified, mutable name.", 1613 "description": "The read group name. This corresponds to the @RG ID field in the SAM spec.",
1601 "type": "string" 1614 "type": "string"
1602 }, 1615 },
1603 "referenceSetId": { 1616 "referenceSetId": {
1604 "description": "The reference set to which the variant set i s mapped. The reference set\ndescribes the alignment provenance of the variant s et, while the\n`referenceBounds` describe the shape of the actual variant data. The\nreference set's reference names are a superset of those found in the\n`refe renceBounds`.\n\nFor example, given a variant set that is mapped to the GRCh38 r eference set\nand contains a single variant on reference 'X', `referenceBounds` would\ncontain only an entry for 'X', while the associated reference set\nenumer ates all possible references: '1', '2', 'X', 'Y', 'MT', etc.", 1617 "description": "The reference set the reads in this read gro up are aligned to.",
1605 "type": "string"
1606 },
1607 "metadata": {
1608 "description": "The metadata associated with this variant se t.",
1609 "items": {
1610 "$ref": "VariantSetMetadata"
1611 },
1612 "type": "array"
1613 },
1614 "referenceBounds": {
1615 "description": "A list of all references used by the variant s in a variant set\nwith associated coordinate upper bounds for each one.",
1616 "items": {
1617 "$ref": "ReferenceBound"
1618 },
1619 "type": "array"
1620 },
1621 "id": {
1622 "description": "The server-generated variant set ID, unique across all variant sets.",
1623 "type": "string"
1624 }
1625 },
1626 "type": "object"
1627 },
1628 "ReferenceBound": {
1629 "description": "ReferenceBound records an upper bound for the starti ng coordinate of\nvariants in a particular reference.",
1630 "id": "ReferenceBound",
1631 "properties": {
1632 "referenceName": {
1633 "description": "The name of the reference associated with th is reference bound.",
1634 "type": "string"
1635 },
1636 "upperBound": {
1637 "description": "An upper bound (inclusive) on the starting c oordinate of any\nvariant in the reference sequence.",
1638 "format": "int64",
1639 "type": "string"
1640 }
1641 },
1642 "type": "object"
1643 },
1644 "BatchCreateAnnotationsResponse": {
1645 "id": "BatchCreateAnnotationsResponse",
1646 "properties": {
1647 "entries": {
1648 "description": "The resulting per-annotation entries, ordere d consistently with the\noriginal request.",
1649 "items": {
1650 "$ref": "Entry"
1651 },
1652 "type": "array"
1653 }
1654 },
1655 "type": "object"
1656 },
1657 "SearchCallSetsResponse": {
1658 "description": "The call set search response.",
1659 "id": "SearchCallSetsResponse",
1660 "properties": {
1661 "nextPageToken": {
1662 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
1663 "type": "string"
1664 },
1665 "callSets": {
1666 "description": "The list of matching call sets.",
1667 "items": {
1668 "$ref": "CallSet"
1669 },
1670 "type": "array"
1671 }
1672 },
1673 "type": "object"
1674 },
1675 "Variant": {
1676 "description": "A variant represents a change in DNA sequence relati ve to a reference\nsequence. For example, a variant could represent a SNP or an insertion.\nVariants belong to a variant set.\n\nFor more genomics resource defi nitions, see [Fundamentals of Google\nGenomics](https://cloud.google.com/genomic s/fundamentals-of-google-genomics)\n\nEach of the calls on a variant represent a determination of genotype with\nrespect to that variant. For example, a call mi ght assign probability of 0.32\nto the occurrence of a SNP named rs1234 in a sam ple named NA12345. A call\nbelongs to a call set, which contains related calls t ypically from one\nsample.",
1677 "id": "Variant",
1678 "properties": {
1679 "id": {
1680 "description": "The server-generated variant ID, unique acro ss all variants.",
1681 "type": "string"
1682 },
1683 "variantSetId": {
1684 "description": "The ID of the variant set this variant belon gs to.",
1685 "type": "string"
1686 },
1687 "referenceName": {
1688 "description": "The reference on which this variant occurs.\ n(such as `chr20` or `X`)",
1689 "type": "string" 1618 "type": "string"
1690 }, 1619 },
1691 "info": { 1620 "info": {
1692 "additionalProperties": { 1621 "additionalProperties": {
1693 "items": { 1622 "items": {
1694 "type": "any" 1623 "type": "any"
1695 }, 1624 },
1696 "type": "array" 1625 "type": "array"
1697 }, 1626 },
1698 "description": "A map of additional variant information. Thi s must be of the form\nmap<string, string[]> (string key mapping to a list of st ring values).", 1627 "description": "A map of additional read group information. This must be of the form\nmap<string, string[]> (string key mapping to a list of string values).",
1699 "type": "object" 1628 "type": "object"
1700 }, 1629 },
1701 "referenceBases": { 1630 "id": {
1702 "description": "The reference bases for this variant. They s tart at the given\nposition.", 1631 "description": "The server-generated read group ID, unique f or all read groups.\nNote: This is different than the @RG ID field in the SAM sp ec. For that\nvalue, see name.",
1703 "type": "string" 1632 "type": "string"
1704 }, 1633 }
1705 "names": { 1634 },
1706 "description": "Names for the variant, for example a RefSNP ID.", 1635 "type": "object"
1636 },
1637 "ReadGroupSet": {
1638 "description": "A read group set is a logical collection of read gro ups, which are\ncollections of reads produced by a sequencer. A read group set t ypically\nmodels reads corresponding to one sample, sequenced one way, and align ed one\nway.\n\n* A read group set belongs to one dataset.\n* A read group belon gs to one read group set.\n* A read belongs to one read group.\n\nFor more genom ics resource definitions, see [Fundamentals of Google\nGenomics](https://cloud.g oogle.com/genomics/fundamentals-of-google-genomics)",
1639 "id": "ReadGroupSet",
1640 "properties": {
1641 "id": {
1642 "description": "The server-generated read group set ID, uniq ue for all read group sets.",
1643 "type": "string"
1644 },
1645 "datasetId": {
1646 "description": "The dataset to which this read group set bel ongs.",
1647 "type": "string"
1648 },
1649 "readGroups": {
1650 "description": "The read groups in this set. There are typic ally 1-10 read groups in a read\ngroup set.",
1651 "items": {
1652 "$ref": "ReadGroup"
1653 },
1654 "type": "array"
1655 },
1656 "filename": {
1657 "description": "The filename of the original source file for this read group set, if any.",
1658 "type": "string"
1659 },
1660 "name": {
1661 "description": "The read group set name. By default this wil l be initialized to the sample\nname of the sequenced data contained in this set .",
1662 "type": "string"
1663 },
1664 "referenceSetId": {
1665 "description": "The reference set to which the reads in this read group set are aligned.",
1666 "type": "string"
1667 },
1668 "info": {
1669 "additionalProperties": {
1670 "items": {
1671 "type": "any"
1672 },
1673 "type": "array"
1674 },
1675 "description": "A map of additional read group set informati on.",
1676 "type": "object"
1677 }
1678 },
1679 "type": "object"
1680 },
1681 "SearchVariantSetsResponse": {
1682 "description": "The search variant sets response.",
1683 "id": "SearchVariantSetsResponse",
1684 "properties": {
1685 "variantSets": {
1686 "description": "The variant sets belonging to the requested dataset.",
1687 "items": {
1688 "$ref": "VariantSet"
1689 },
1690 "type": "array"
1691 },
1692 "nextPageToken": {
1693 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
1694 "type": "string"
1695 }
1696 },
1697 "type": "object"
1698 },
1699 "Empty": {
1700 "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use i t as the request\nor the response type of an API method. For instance:\n\n se rvice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty );\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
1701 "id": "Empty",
1702 "properties": {},
1703 "type": "object"
1704 },
1705 "Entry": {
1706 "id": "Entry",
1707 "properties": {
1708 "annotation": {
1709 "$ref": "Annotation",
1710 "description": "The created annotation, if creation was succ essful."
1711 },
1712 "status": {
1713 "$ref": "Status",
1714 "description": "The creation status."
1715 }
1716 },
1717 "type": "object"
1718 },
1719 "Position": {
1720 "description": "An abstraction for referring to a genomic position, in relation to some\nalready known reference. For now, represents a genomic posi tion as a\nreference name, a base number on that reference (0-based), and a\ndet ermination of forward or reverse strand.",
1721 "id": "Position",
1722 "properties": {
1723 "position": {
1724 "description": "The 0-based offset from the start of the for ward strand for that reference.",
1725 "format": "int64",
1726 "type": "string"
1727 },
1728 "referenceName": {
1729 "description": "The name of the reference in whatever refere nce set is being used.",
1730 "type": "string"
1731 },
1732 "reverseStrand": {
1733 "description": "Whether this position is on the reverse stra nd, as opposed to the forward\nstrand.",
1734 "type": "boolean"
1735 }
1736 },
1737 "type": "object"
1738 },
1739 "SearchReferenceSetsResponse": {
1740 "id": "SearchReferenceSetsResponse",
1741 "properties": {
1742 "referenceSets": {
1743 "description": "The matching references sets.",
1744 "items": {
1745 "$ref": "ReferenceSet"
1746 },
1747 "type": "array"
1748 },
1749 "nextPageToken": {
1750 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
1751 "type": "string"
1752 }
1753 },
1754 "type": "object"
1755 },
1756 "SearchCallSetsRequest": {
1757 "description": "The call set search request.",
1758 "id": "SearchCallSetsRequest",
1759 "properties": {
1760 "variantSetIds": {
1761 "description": "Restrict the query to call sets within the g iven variant sets. At least one\nID must be provided.",
1707 "items": { 1762 "items": {
1708 "type": "string" 1763 "type": "string"
1709 }, 1764 },
1710 "type": "array" 1765 "type": "array"
1711 }, 1766 },
1712 "alternateBases": {
1713 "description": "The bases that appear instead of the referen ce bases.",
1714 "items": {
1715 "type": "string"
1716 },
1717 "type": "array"
1718 },
1719 "end": {
1720 "description": "The end position (0-based) of this variant. This corresponds to the first\nbase after the last base in the reference allele. So, the length of\nthe reference allele is (end - start). This is useful for va riants\nthat don't explicitly give alternate bases, for example large deletions. ",
1721 "format": "int64",
1722 "type": "string"
1723 },
1724 "filter": {
1725 "description": "A list of filters (normally quality filters) this variant has failed.\n`PASS` indicates this variant has passed all filters. ",
1726 "items": {
1727 "type": "string"
1728 },
1729 "type": "array"
1730 },
1731 "calls": {
1732 "description": "The variant calls for this particular varian t. Each one represents the\ndetermination of genotype with respect to this varia nt.",
1733 "items": {
1734 "$ref": "VariantCall"
1735 },
1736 "type": "array"
1737 },
1738 "created": {
1739 "description": "The date this variant was created, in millis econds from the epoch.",
1740 "format": "int64",
1741 "type": "string"
1742 },
1743 "start": {
1744 "description": "The position at which this variant occurs (0 -based).\nThis corresponds to the first base of the string of reference bases.",
1745 "format": "int64",
1746 "type": "string"
1747 },
1748 "quality": {
1749 "description": "A measure of how likely this variant is to b e real.\nA higher value is better.",
1750 "format": "double",
1751 "type": "number"
1752 }
1753 },
1754 "type": "object"
1755 },
1756 "ListOperationsResponse": {
1757 "description": "The response message for Operations.ListOperations." ,
1758 "id": "ListOperationsResponse",
1759 "properties": {
1760 "nextPageToken": {
1761 "description": "The standard List next-page token.",
1762 "type": "string"
1763 },
1764 "operations": {
1765 "description": "A list of operations that matches the specif ied filter in the request.",
1766 "items": {
1767 "$ref": "Operation"
1768 },
1769 "type": "array"
1770 }
1771 },
1772 "type": "object"
1773 },
1774 "OperationMetadata": {
1775 "description": "Metadata describing an Operation.",
1776 "id": "OperationMetadata",
1777 "properties": {
1778 "startTime": {
1779 "description": "The time at which the job began to run.",
1780 "format": "google-datetime",
1781 "type": "string"
1782 },
1783 "request": {
1784 "additionalProperties": {
1785 "description": "Properties of the object. Contains field @type with type URL.",
1786 "type": "any"
1787 },
1788 "description": "The original request that started the operat ion. Note that this will be in\ncurrent version of the API. If the operation was started with v1beta2 API\nand a GetOperation is performed on v1 API, a v1 reque st will be returned.",
1789 "type": "object"
1790 },
1791 "runtimeMetadata": {
1792 "additionalProperties": {
1793 "description": "Properties of the object. Contains field @type with type URL.",
1794 "type": "any"
1795 },
1796 "description": "Runtime metadata on this Operation.",
1797 "type": "object"
1798 },
1799 "createTime": {
1800 "description": "The time at which the job was submitted to t he Genomics service.",
1801 "format": "google-datetime",
1802 "type": "string"
1803 },
1804 "labels": {
1805 "additionalProperties": {
1806 "type": "string"
1807 },
1808 "description": "Optionally provided by the caller when submi tting the request that creates\nthe operation.",
1809 "type": "object"
1810 },
1811 "projectId": {
1812 "description": "The Google Cloud Project in which the job is scoped.",
1813 "type": "string"
1814 },
1815 "clientId": {
1816 "description": "This field is deprecated. Use `labels` inste ad. Optionally provided by the\ncaller when submitting the request that creates the operation.",
1817 "type": "string"
1818 },
1819 "endTime": {
1820 "description": "The time at which the job stopped running.",
1821 "format": "google-datetime",
1822 "type": "string"
1823 },
1824 "events": {
1825 "description": "Optional event messages that were generated during the job's execution.\nThis also contains any warnings that were generated during import\nor export.",
1826 "items": {
1827 "$ref": "OperationEvent"
1828 },
1829 "type": "array"
1830 }
1831 },
1832 "type": "object"
1833 },
1834 "SearchVariantsRequest": {
1835 "description": "The variant search request.",
1836 "id": "SearchVariantsRequest",
1837 "properties": {
1838 "maxCalls": {
1839 "description": "The maximum number of calls to return in a s ingle page. Note that this\nlimit may be exceeded in the event that a matching v ariant contains more\ncalls than the requested maximum. If unspecified, defaults to 5000. The\nmaximum value is 10000.",
1840 "format": "int32",
1841 "type": "integer"
1842 },
1843 "pageToken": { 1767 "pageToken": {
1844 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.", 1768 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
1845 "type": "string" 1769 "type": "string"
1846 }, 1770 },
1847 "pageSize": {
1848 "description": "The maximum number of variants to return in a single page. If unspecified,\ndefaults to 5000. The maximum value is 10000.",
1849 "format": "int32",
1850 "type": "integer"
1851 },
1852 "callSetIds": {
1853 "description": "Only return variant calls which belong to ca ll sets with these ids.\nLeaving this blank returns all variant calls. If a vari ant has no\ncalls belonging to any of these call sets, it won't be returned at a ll.",
1854 "items": {
1855 "type": "string"
1856 },
1857 "type": "array"
1858 },
1859 "variantName": {
1860 "description": "Only return variants which have exactly this name.",
1861 "type": "string"
1862 },
1863 "start": {
1864 "description": "The beginning of the window (0-based, inclus ive) for which\noverlapping variants should be returned. If unspecified, default s to 0.",
1865 "format": "int64",
1866 "type": "string"
1867 },
1868 "referenceName": {
1869 "description": "Required. Only return variants in this refer ence sequence.",
1870 "type": "string"
1871 },
1872 "variantSetIds": {
1873 "description": "At most one variant set ID must be provided. Only variants from this\nvariant set will be returned. If omitted, a call set i d must be included in\nthe request.",
1874 "items": {
1875 "type": "string"
1876 },
1877 "type": "array"
1878 },
1879 "end": {
1880 "description": "The end of the window, 0-based exclusive. If unspecified or 0, defaults to\nthe length of the reference.",
1881 "format": "int64",
1882 "type": "string"
1883 }
1884 },
1885 "type": "object"
1886 },
1887 "SearchReadGroupSetsRequest": {
1888 "description": "The read group set search request.",
1889 "id": "SearchReadGroupSetsRequest",
1890 "properties": {
1891 "datasetIds": {
1892 "description": "Restricts this query to read group sets with in the given datasets. At least\none ID must be provided.",
1893 "items": {
1894 "type": "string"
1895 },
1896 "type": "array"
1897 },
1898 "pageToken": {
1899 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
1900 "type": "string"
1901 },
1902 "name": { 1771 "name": {
1903 "description": "Only return read group sets for which a subs tring of the name matches this\nstring.", 1772 "description": "Only return call sets for which a substring of the name matches this\nstring.",
1904 "type": "string"
1905 },
1906 "pageSize": {
1907 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 256. The maximum value is 1024.",
1908 "format": "int32",
1909 "type": "integer"
1910 }
1911 },
1912 "type": "object"
1913 },
1914 "SearchAnnotationsResponse": {
1915 "id": "SearchAnnotationsResponse",
1916 "properties": {
1917 "nextPageToken": {
1918 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
1919 "type": "string"
1920 },
1921 "annotations": {
1922 "description": "The matching annotations.",
1923 "items": {
1924 "$ref": "Annotation"
1925 },
1926 "type": "array"
1927 }
1928 },
1929 "type": "object"
1930 },
1931 "ClinicalCondition": {
1932 "id": "ClinicalCondition",
1933 "properties": {
1934 "names": {
1935 "description": "A set of names for the condition.",
1936 "items": {
1937 "type": "string"
1938 },
1939 "type": "array"
1940 },
1941 "omimId": {
1942 "description": "The OMIM id for this condition.\nSearch for these IDs at http://omim.org/",
1943 "type": "string"
1944 },
1945 "externalIds": {
1946 "description": "The set of external IDs for this condition." ,
1947 "items": {
1948 "$ref": "ExternalId"
1949 },
1950 "type": "array"
1951 },
1952 "conceptId": {
1953 "description": "The MedGen concept id associated with this g ene.\nSearch for these IDs at http://www.ncbi.nlm.nih.gov/medgen/",
1954 "type": "string"
1955 }
1956 },
1957 "type": "object"
1958 },
1959 "SearchReadsResponse": {
1960 "description": "The read search response.",
1961 "id": "SearchReadsResponse",
1962 "properties": {
1963 "nextPageToken": {
1964 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
1965 "type": "string"
1966 },
1967 "alignments": {
1968 "description": "The list of matching alignments sorted by ma pped genomic coordinate,\nif any, ascending in position within the same referenc e. Unmapped reads,\nwhich have no position, are returned contiguously and are so rted in\nascending lexicographic order by fragment name.",
1969 "items": {
1970 "$ref": "Read"
1971 },
1972 "type": "array"
1973 }
1974 },
1975 "type": "object"
1976 },
1977 "Program": {
1978 "id": "Program",
1979 "properties": {
1980 "name": {
1981 "description": "The display name of the program. This is typ ically the colloquial name of\nthe tool used, for example 'bwa' or 'picard'.",
1982 "type": "string"
1983 },
1984 "prevProgramId": {
1985 "description": "The ID of the program run before this one.",
1986 "type": "string"
1987 },
1988 "commandLine": {
1989 "description": "The command line used to run this program.",
1990 "type": "string"
1991 },
1992 "version": {
1993 "description": "The version of the program run.",
1994 "type": "string"
1995 },
1996 "id": {
1997 "description": "The user specified locally unique ID of the program. Used along with\n`prevProgramId` to define an ordering between programs .",
1998 "type": "string"
1999 }
2000 },
2001 "type": "object"
2002 },
2003 "ComputeEngine": {
2004 "description": "Describes a Compute Engine resource that is being ma naged by a running\npipeline.",
2005 "id": "ComputeEngine",
2006 "properties": {
2007 "diskNames": {
2008 "description": "The names of the disks that were created for this pipeline.",
2009 "items": {
2010 "type": "string"
2011 },
2012 "type": "array"
2013 },
2014 "machineType": {
2015 "description": "The machine type of the instance.",
2016 "type": "string"
2017 },
2018 "instanceName": {
2019 "description": "The instance on which the operation is runni ng.",
2020 "type": "string"
2021 },
2022 "zone": {
2023 "description": "The availability zone in which the instance resides.",
2024 "type": "string"
2025 }
2026 },
2027 "type": "object"
2028 },
2029 "CoverageBucket": {
2030 "description": "A bucket over which read coverage has been precomput ed. A bucket corresponds\nto a specific range of the reference sequence.",
2031 "id": "CoverageBucket",
2032 "properties": {
2033 "range": {
2034 "$ref": "Range",
2035 "description": "The genomic coordinate range spanned by this bucket."
2036 },
2037 "meanCoverage": {
2038 "description": "The average number of reads which are aligne d to each individual\nreference base in this bucket.",
2039 "format": "float",
2040 "type": "number"
2041 }
2042 },
2043 "type": "object"
2044 },
2045 "ExternalId": {
2046 "id": "ExternalId",
2047 "properties": {
2048 "id": {
2049 "description": "The id used by the source of this data.",
2050 "type": "string"
2051 },
2052 "sourceName": {
2053 "description": "The name of the source of this data.",
2054 "type": "string"
2055 }
2056 },
2057 "type": "object"
2058 },
2059 "SearchVariantSetsRequest": {
2060 "description": "The search variant sets request.",
2061 "id": "SearchVariantSetsRequest",
2062 "properties": {
2063 "pageToken": {
2064 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
2065 "type": "string" 1773 "type": "string"
2066 }, 1774 },
2067 "pageSize": { 1775 "pageSize": {
2068 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 1024.", 1776 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 1024.",
2069 "format": "int32", 1777 "format": "int32",
2070 "type": "integer" 1778 "type": "integer"
2071 }, 1779 }
2072 "datasetIds": { 1780 },
2073 "description": "Exactly one dataset ID must be provided here . Only variant sets which\nbelong to this dataset will be returned.", 1781 "type": "object"
2074 "items": { 1782 },
2075 "type": "string" 1783 "ImportReadGroupSetsRequest": {
2076 }, 1784 "description": "The read group set import request.",
2077 "type": "array" 1785 "id": "ImportReadGroupSetsRequest",
2078 } 1786 "properties": {
2079 }, 1787 "referenceSetId": {
2080 "type": "object" 1788 "description": "The reference set to which the imported read group sets are aligned to, if\nany. The reference names of this reference set m ust be a superset of those\nfound in the imported file headers. If no reference set id is provided, a\nbest effort is made to associate with a matching referenc e set.",
2081 }, 1789 "type": "string"
2082 "VariantSetMetadata": { 1790 },
2083 "description": "Metadata describes a single piece of variant call me tadata.\nThese data include a top level key and either a single value string (va lue)\nor a list of key-value pairs (info.)\nValue and info are mutually exclusiv e.", 1791 "partitionStrategy": {
2084 "id": "VariantSetMetadata", 1792 "description": "The partition strategy describes how read gr oups are partitioned into read\ngroup sets.",
2085 "properties": {
2086 "type": {
2087 "description": "The type of data. Possible types include: In teger, Float,\nFlag, Character, and String.",
2088 "enum": [ 1793 "enum": [
2089 "TYPE_UNSPECIFIED", 1794 "PARTITION_STRATEGY_UNSPECIFIED",
2090 "INTEGER", 1795 "PER_FILE_PER_SAMPLE",
2091 "FLOAT", 1796 "MERGE_ALL"
2092 "FLAG",
2093 "CHARACTER",
2094 "STRING"
2095 ], 1797 ],
2096 "enumDescriptions": [ 1798 "enumDescriptions": [
2097 "", 1799 "",
1800 "In most cases, this strategy yields one read group set per file. This is\nthe default behavior.\n\nAllocate one read group set per file per sample. For BAM files, read\ngroups are considered to share a sample if the y have identical sample\nnames. Furthermore, all reads for each file which do no t belong to a read\ngroup, if any, will be grouped into a single read group set per-file.",
1801 "Includes all read groups in all imported files into a s ingle read group\nset. Requires that the headers for all imported files are equi valent. All\nreads which do not belong to a read group, if any, will be grouped into a\nseparate read group set."
1802 ],
1803 "type": "string"
1804 },
1805 "datasetId": {
1806 "description": "Required. The ID of the dataset these read g roup sets will belong to. The\ncaller must have WRITE permissions to this datase t.",
1807 "type": "string"
1808 },
1809 "sourceUris": {
1810 "description": "A list of URIs pointing at [BAM\nfiles](http s://samtools.github.io/hts-specs/SAMv1.pdf)\nin Google Cloud Storage.\nThose URI s can include wildcards (*), but do not add or remove\nmatching files before imp ort has completed.\n\nNote that Google Cloud Storage object listing is only even tually\nconsistent: files added may be not be immediately visible to\neveryone. Thus, if using a wildcard it is preferable not to start\nthe import immediately after the files are created.",
1811 "items": {
1812 "type": "string"
1813 },
1814 "type": "array"
1815 }
1816 },
1817 "type": "object"
1818 },
1819 "Policy": {
1820 "description": "Defines an Identity and Access Management (IAM) poli cy. It is used to\nspecify access control policies for Cloud Platform resources. \n\n\nA `Policy` consists of a list of `bindings`. A `Binding` binds a list of\n `members` to a `role`, where the members can be user accounts, Google groups,\nG oogle domains, and service accounts. A `role` is a named list of permissions\nde fined by IAM.\n\n**Example**\n\n {\n \"bindings\": [\n {\n \"role\": \"roles/owner\",\n \"members\": [\n \"user:mike @example.com\",\n \"group:admins@example.com\",\n \"domain :google.com\",\n \"serviceAccount:my-other-app@appspot.gserviceaccoun t.com\",\n ]\n },\n {\n \"role\": \"roles/viewer \",\n \"members\": [\"user:sean@example.com\"]\n }\n ]\n }\n\nFor a description of IAM and its features, see the\n[IAM developer's guide ](https://cloud.google.com/iam).",
1821 "id": "Policy",
1822 "properties": {
1823 "etag": {
1824 "description": "`etag` is used for optimistic concurrency co ntrol as a way to help\nprevent simultaneous updates of a policy from overwritin g each other.\nIt is strongly suggested that systems make use of the `etag` in t he\nread-modify-write cycle to perform policy updates in order to avoid race\nco nditions: An `etag` is returned in the response to `getIamPolicy`, and\nsystems are expected to put that etag in the request to `setIamPolicy` to\nensure that t heir change will be applied to the same version of the policy.\n\nIf no `etag` i s provided in the call to `setIamPolicy`, then the existing\npolicy is overwritt en blindly.",
1825 "format": "byte",
1826 "type": "string"
1827 },
1828 "version": {
1829 "description": "Version of the `Policy`. The default version is 0.",
1830 "format": "int32",
1831 "type": "integer"
1832 },
1833 "bindings": {
1834 "description": "Associates a list of `members` to a `role`.\ n`bindings` with no members will result in an error.",
1835 "items": {
1836 "$ref": "Binding"
1837 },
1838 "type": "array"
1839 }
1840 },
1841 "type": "object"
1842 },
1843 "SearchReadsRequest": {
1844 "description": "The read search request.",
1845 "id": "SearchReadsRequest",
1846 "properties": {
1847 "start": {
1848 "description": "The start position of the range on the refer ence, 0-based inclusive. If\nspecified, `referenceName` must also be specified." ,
1849 "format": "int64",
1850 "type": "string"
1851 },
1852 "referenceName": {
1853 "description": "The reference sequence name, for example `ch r1`, `1`, or `chrX`. If set to\n`*`, only unmapped reads are returned. If unspec ified, all reads (mapped\nand unmapped) are returned.",
1854 "type": "string"
1855 },
1856 "readGroupSetIds": {
1857 "description": "The IDs of the read groups sets within which to search for reads. All\nspecified read group sets must be aligned against a c ommon set of reference\nsequences; this defines the genomic coordinates for the query. Must specify\none of `readGroupSetIds` or `readGroupIds`.",
1858 "items": {
1859 "type": "string"
1860 },
1861 "type": "array"
1862 },
1863 "readGroupIds": {
1864 "description": "The IDs of the read groups within which to s earch for reads. All specified\nread groups must belong to the same read group s ets. Must specify one of\n`readGroupSetIds` or `readGroupIds`.",
1865 "items": {
1866 "type": "string"
1867 },
1868 "type": "array"
1869 },
1870 "end": {
1871 "description": "The end position of the range on the referen ce, 0-based exclusive. If\nspecified, `referenceName` must also be specified.",
1872 "format": "int64",
1873 "type": "string"
1874 },
1875 "pageToken": {
1876 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
1877 "type": "string"
1878 },
1879 "pageSize": {
1880 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 256. The maximum value is 2048.",
1881 "format": "int32",
1882 "type": "integer"
1883 }
1884 },
1885 "type": "object"
1886 },
1887 "CancelOperationRequest": {
1888 "description": "The request message for Operations.CancelOperation." ,
1889 "id": "CancelOperationRequest",
1890 "properties": {},
1891 "type": "object"
1892 },
1893 "Annotation": {
1894 "description": "An annotation describes a region of reference genome . The value of an\nannotation may be one of several canonical types, supplemente d by arbitrary\ninfo tags. An annotation is not inherently associated with a spe cific\nsample or individual (though a client could choose to use annotations in\ nthis way). Example canonical annotation types are `GENE` and\n`VARIANT`.",
1895 "id": "Annotation",
1896 "properties": {
1897 "annotationSetId": {
1898 "description": "The annotation set to which this annotation belongs.",
1899 "type": "string"
1900 },
1901 "name": {
1902 "description": "The display name of this annotation.",
1903 "type": "string"
1904 },
1905 "variant": {
1906 "$ref": "VariantAnnotation",
1907 "description": "A variant annotation, which describes the ef fect of a variant on the\ngenome, the coding sequence, and/or higher level conse quences at the\norganism level e.g. pathogenicity. This field is only set for an notations\nof type `VARIANT`."
1908 },
1909 "id": {
1910 "description": "The server-generated annotation ID, unique a cross all annotations.",
1911 "type": "string"
1912 },
1913 "referenceId": {
1914 "description": "The ID of the Google Genomics reference asso ciated with this range.",
1915 "type": "string"
1916 },
1917 "reverseStrand": {
1918 "description": "Whether this range refers to the reverse str and, as opposed to the forward\nstrand. Note that regardless of this field, the start/end position of the\nrange always refer to the forward strand.",
1919 "type": "boolean"
1920 },
1921 "referenceName": {
1922 "description": "The display name corresponding to the refere nce specified by\n`referenceId`, for example `chr1`, `1`, or `chrX`.",
1923 "type": "string"
1924 },
1925 "type": {
1926 "description": "The data type for this annotation. Must matc h the containing annotation\nset's type.",
1927 "enum": [
1928 "ANNOTATION_TYPE_UNSPECIFIED",
1929 "GENERIC",
1930 "VARIANT",
1931 "GENE",
1932 "TRANSCRIPT"
1933 ],
1934 "enumDescriptions": [
2098 "", 1935 "",
2099 "", 1936 "A `GENERIC` annotation type should be used when no othe r annotation\ntype will suffice. This represents an untyped annotation of the re ference\ngenome.",
2100 "", 1937 "A `VARIANT` annotation type.",
2101 "", 1938 "A `GENE` annotation type represents the existence of a gene at the\nassociated reference coordinates. The start coordinate is typically the\ngene's transcription start site and the end is typically the end of the\ng ene's last exon.",
2102 "" 1939 "A `TRANSCRIPT` annotation type represents the assertion that a\nparticular region of the reference genome may be transcribed as RNA."
2103 ], 1940 ],
2104 "type": "string" 1941 "type": "string"
2105 }, 1942 },
2106 "info": { 1943 "info": {
1944 "additionalProperties": {
1945 "items": {
1946 "type": "any"
1947 },
1948 "type": "array"
1949 },
1950 "description": "A map of additional read alignment informati on. This must be of the form\nmap<string, string[]> (string key mapping to a lis t of string values).",
1951 "type": "object"
1952 },
1953 "end": {
1954 "description": "The end position of the range on the referen ce, 0-based exclusive.",
1955 "format": "int64",
1956 "type": "string"
1957 },
1958 "transcript": {
1959 "$ref": "Transcript",
1960 "description": "A transcript value represents the assertion that a particular region of\nthe reference genome may be transcribed as RNA. An alternative splicing\npattern would be represented as a separate transcript obje ct. This field\nis only set for annotations of type `TRANSCRIPT`."
1961 },
1962 "start": {
1963 "description": "The start position of the range on the refer ence, 0-based inclusive.",
1964 "format": "int64",
1965 "type": "string"
1966 }
1967 },
1968 "type": "object"
1969 },
1970 "Operation": {
1971 "description": "This resource represents a long-running operation th at is the result of a\nnetwork API call.",
1972 "id": "Operation",
1973 "properties": {
1974 "response": {
1975 "additionalProperties": {
1976 "description": "Properties of the object. Contains field @type with type URL.",
1977 "type": "any"
1978 },
1979 "description": "If importing ReadGroupSets, an ImportReadGro upSetsResponse is returned. If importing Variants, an ImportVariantsResponse is returned. For pipelines and exports, an empty response is returned.",
1980 "type": "object"
1981 },
1982 "name": {
1983 "description": "The server-assigned name, which is only uniq ue within the same service that originally returns it. For example&#58; `operati ons/CJHU7Oi_ChDrveSpBRjfuL-qzoWAgEw`",
1984 "type": "string"
1985 },
1986 "error": {
1987 "$ref": "Status",
1988 "description": "The error result of the operation in case of failure or cancellation."
1989 },
1990 "metadata": {
1991 "additionalProperties": {
1992 "description": "Properties of the object. Contains field @type with type URL.",
1993 "type": "any"
1994 },
1995 "description": "An OperationMetadata object. This will alway s be returned with the Operation.",
1996 "type": "object"
1997 },
1998 "done": {
1999 "description": "If the value is `false`, it means the operat ion is still in progress.\nIf `true`, the operation is completed, and either `er ror` or `response` is\navailable.",
2000 "type": "boolean"
2001 }
2002 },
2003 "type": "object"
2004 },
2005 "RuntimeMetadata": {
2006 "description": "Runtime metadata that will be populated in the\nrunt imeMetadata\nfield of the Operation associated with a RunPipeline execution.",
2007 "id": "RuntimeMetadata",
2008 "properties": {
2009 "computeEngine": {
2010 "$ref": "ComputeEngine",
2011 "description": "Execution information specific to Google Com pute Engine."
2012 }
2013 },
2014 "type": "object"
2015 },
2016 "ImportReadGroupSetsResponse": {
2017 "description": "The read group set import response.",
2018 "id": "ImportReadGroupSetsResponse",
2019 "properties": {
2020 "readGroupSetIds": {
2021 "description": "IDs of the read group sets that were created .",
2022 "items": {
2023 "type": "string"
2024 },
2025 "type": "array"
2026 }
2027 },
2028 "type": "object"
2029 },
2030 "VariantCall": {
2031 "description": "A call represents the determination of genotype with respect to a particular\nvariant. It may include associated information such as quality and phasing.\nFor example, a call might assign a probability of 0.32 to the occurrence of\na SNP named rs1234 in a call set with the name NA12345.",
2032 "id": "VariantCall",
2033 "properties": {
2034 "phaseset": {
2035 "description": "If this field is present, this variant call' s genotype ordering implies\nthe phase of the bases and is consistent with any o ther variant calls in\nthe same reference sequence which have the same phaseset value.\nWhen importing data from VCF, if the genotype data was phased but no\nph ase set was specified this field will be set to `*`.",
2036 "type": "string"
2037 },
2038 "info": {
2039 "additionalProperties": {
2040 "items": {
2041 "type": "any"
2042 },
2043 "type": "array"
2044 },
2045 "description": "A map of additional variant call information . This must be of the form\nmap<string, string[]> (string key mapping to a list of string values).",
2046 "type": "object"
2047 },
2048 "callSetName": {
2049 "description": "The name of the call set this variant call b elongs to.",
2050 "type": "string"
2051 },
2052 "genotypeLikelihood": {
2053 "description": "The genotype likelihoods for this variant ca ll. Each array entry\nrepresents how likely a specific genotype is for this call . The value\nordering is defined by the GL tag in the VCF spec.\nIf Phred-scaled genotype likelihood scores (PL) are available and\nlog10(P) genotype likelihood scores (GL) are not, PL scores are converted\nto GL scores. If both are availa ble, PL scores are stored in `info`.",
2054 "items": {
2055 "format": "double",
2056 "type": "number"
2057 },
2058 "type": "array"
2059 },
2060 "callSetId": {
2061 "description": "The ID of the call set this variant call bel ongs to.",
2062 "type": "string"
2063 },
2064 "genotype": {
2065 "description": "The genotype of this variant call. Each valu e represents either the value\nof the `referenceBases` field or a 1-based index into\n`alternateBases`. If a variant had a `referenceBases`\nvalue of `T` and an `alternateBases`\nvalue of `[\"A\", \"C\"]`, and the `genotype` was\n`[2, 1]`, that would mean the call\nrepresented the heterozygous value `CA` for this varia nt.\nIf the `genotype` was instead `[0, 1]`, the\nrepresented value would be `TA `. Ordering of the\ngenotype values is important if the `phaseset` is present.\n If a genotype is not called (that is, a `.` is present in the\nGT string) -1 is returned.",
2066 "items": {
2067 "format": "int32",
2068 "type": "integer"
2069 },
2070 "type": "array"
2071 }
2072 },
2073 "type": "object"
2074 },
2075 "SearchVariantsResponse": {
2076 "description": "The variant search response.",
2077 "id": "SearchVariantsResponse",
2078 "properties": {
2079 "nextPageToken": {
2080 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
2081 "type": "string"
2082 },
2083 "variants": {
2084 "description": "The list of matching Variants.",
2085 "items": {
2086 "$ref": "Variant"
2087 },
2088 "type": "array"
2089 }
2090 },
2091 "type": "object"
2092 },
2093 "ListBasesResponse": {
2094 "id": "ListBasesResponse",
2095 "properties": {
2096 "nextPageToken": {
2097 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
2098 "type": "string"
2099 },
2100 "sequence": {
2101 "description": "A substring of the bases that make up this r eference.",
2102 "type": "string"
2103 },
2104 "offset": {
2105 "description": "The offset position (0-based) of the given ` sequence` from the\nstart of this `Reference`. This value will differ for each p age\nin a paginated request.",
2106 "format": "int64",
2107 "type": "string"
2108 }
2109 },
2110 "type": "object"
2111 },
2112 "Status": {
2113 "description": "The `Status` type defines a logical error model that is suitable for different\nprogramming environments, including REST APIs and RP C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie ces of data: error code, error message,\nand error details. The error code shoul d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed. The\nerror message should be a developer-facing English message tha t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa cing\nerror message is needed, put the localized message in the error details or \nlocalize it in the client. The optional error details may contain arbitrary\ni nformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` that can be used for common error conditions.\n\n# Lang uage mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` mess age is\nexposed in different client libraries and different wire protocols, it c an be\nmapped differently. For example, it will likely be mapped to some excepti ons\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n \nThe error model and the `Status` message can be used in a variety of\nenvironm ents, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n - Partial errors. If a service needs to return partial errors to the client,\n it may embed the `Status` in the normal response to indicate the partial\n errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step m ay\n have a `Status` message for error reporting.\n\n- Batch operations. If a client uses batch request and batch response, the\n `Status` message should be used directly inside batch response, one for\n each error sub-response.\n\ n- Asynchronous operations. If an API call embeds asynchronous operation\n re sults in its response, the status of those operations should be\n represented directly using the `Status` message.\n\n- Logging. If some API errors are store d in logs, the message `Status` could\n be used directly after any stripping needed for security/privacy reasons.",
2114 "id": "Status",
2115 "properties": {
2116 "details": {
2117 "description": "A list of messages that carry the error deta ils. There is a common set of\nmessage types for APIs to use.",
2118 "items": {
2119 "additionalProperties": {
2120 "description": "Properties of the object. Contains f ield @type with type URL.",
2121 "type": "any"
2122 },
2123 "type": "object"
2124 },
2125 "type": "array"
2126 },
2127 "code": {
2128 "description": "The status code, which should be an enum val ue of google.rpc.Code.",
2129 "format": "int32",
2130 "type": "integer"
2131 },
2132 "message": {
2133 "description": "A developer-facing error message, which shou ld be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.",
2134 "type": "string"
2135 }
2136 },
2137 "type": "object"
2138 },
2139 "Binding": {
2140 "description": "Associates `members` with a `role`.",
2141 "id": "Binding",
2142 "properties": {
2143 "members": {
2144 "description": "Specifies the identities requesting access f or a Cloud Platform resource.\n`members` can have the following values:\n\n* `al lUsers`: A special identifier that represents anyone who is\n on the internet; with or without a Google account.\n\n* `allAuthenticatedUsers`: A special ident ifier that represents anyone\n who is authenticated with a Google account or a service account.\n\n* `user:{emailid}`: An email address that represents a spec ific Google\n account. For example, `alice@gmail.com` or `joe@example.com`.\n\ n\n* `serviceAccount:{emailid}`: An email address that represents a service\n account. For example, `my-other-app@appspot.gserviceaccount.com`.\n\n* `group:{e mailid}`: An email address that represents a Google group.\n For example, `adm ins@example.com`.\n\n\n* `domain:{domain}`: A Google Apps domain name that repre sents all the\n users of that domain. For example, `google.com` or `example.co m`.\n\n",
2145 "items": {
2146 "type": "string"
2147 },
2148 "type": "array"
2149 },
2150 "role": {
2151 "description": "Role that is assigned to `members`.\nFor exa mple, `roles/viewer`, `roles/editor`, or `roles/owner`.\nRequired",
2152 "type": "string"
2153 }
2154 },
2155 "type": "object"
2156 },
2157 "UndeleteDatasetRequest": {
2158 "id": "UndeleteDatasetRequest",
2159 "properties": {},
2160 "type": "object"
2161 },
2162 "Range": {
2163 "description": "A 0-based half-open genomic coordinate range for sea rch requests.",
2164 "id": "Range",
2165 "properties": {
2166 "referenceName": {
2167 "description": "The reference sequence name, for example `ch r1`,\n`1`, or `chrX`.",
2168 "type": "string"
2169 },
2170 "start": {
2171 "description": "The start position of the range on the refer ence, 0-based inclusive.",
2172 "format": "int64",
2173 "type": "string"
2174 },
2175 "end": {
2176 "description": "The end position of the range on the referen ce, 0-based exclusive.",
2177 "format": "int64",
2178 "type": "string"
2179 }
2180 },
2181 "type": "object"
2182 },
2183 "VariantSet": {
2184 "description": "A variant set is a collection of call sets and varia nts. It contains summary\nstatistics of those contents. A variant set belongs to a dataset.\n\nFor more genomics resource definitions, see [Fundamentals of Goog le\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) ",
2185 "id": "VariantSet",
2186 "properties": {
2187 "referenceBounds": {
2188 "description": "A list of all references used by the variant s in a variant set\nwith associated coordinate upper bounds for each one.",
2189 "items": {
2190 "$ref": "ReferenceBound"
2191 },
2192 "type": "array"
2193 },
2194 "id": {
2195 "description": "The server-generated variant set ID, unique across all variant sets.",
2196 "type": "string"
2197 },
2198 "description": {
2199 "description": "A textual description of this variant set.",
2200 "type": "string"
2201 },
2202 "datasetId": {
2203 "description": "The dataset to which this variant set belong s.",
2204 "type": "string"
2205 },
2206 "name": {
2207 "description": "User-specified, mutable name.",
2208 "type": "string"
2209 },
2210 "referenceSetId": {
2211 "description": "The reference set to which the variant set i s mapped. The reference set\ndescribes the alignment provenance of the variant s et, while the\n`referenceBounds` describe the shape of the actual variant data. The\nreference set's reference names are a superset of those found in the\n`refe renceBounds`.\n\nFor example, given a variant set that is mapped to the GRCh38 r eference set\nand contains a single variant on reference 'X', `referenceBounds` would\ncontain only an entry for 'X', while the associated reference set\nenumer ates all possible references: '1', '2', 'X', 'Y', 'MT', etc.",
2212 "type": "string"
2213 },
2214 "metadata": {
2215 "description": "The metadata associated with this variant se t.",
2216 "items": {
2217 "$ref": "VariantSetMetadata"
2218 },
2219 "type": "array"
2220 }
2221 },
2222 "type": "object"
2223 },
2224 "BatchCreateAnnotationsResponse": {
2225 "id": "BatchCreateAnnotationsResponse",
2226 "properties": {
2227 "entries": {
2228 "description": "The resulting per-annotation entries, ordere d consistently with the\noriginal request.",
2229 "items": {
2230 "$ref": "Entry"
2231 },
2232 "type": "array"
2233 }
2234 },
2235 "type": "object"
2236 },
2237 "ReferenceBound": {
2238 "description": "ReferenceBound records an upper bound for the starti ng coordinate of\nvariants in a particular reference.",
2239 "id": "ReferenceBound",
2240 "properties": {
2241 "upperBound": {
2242 "description": "An upper bound (inclusive) on the starting c oordinate of any\nvariant in the reference sequence.",
2243 "format": "int64",
2244 "type": "string"
2245 },
2246 "referenceName": {
2247 "description": "The name of the reference associated with th is reference bound.",
2248 "type": "string"
2249 }
2250 },
2251 "type": "object"
2252 },
2253 "Variant": {
2254 "description": "A variant represents a change in DNA sequence relati ve to a reference\nsequence. For example, a variant could represent a SNP or an insertion.\nVariants belong to a variant set.\n\nFor more genomics resource defi nitions, see [Fundamentals of Google\nGenomics](https://cloud.google.com/genomic s/fundamentals-of-google-genomics)\n\nEach of the calls on a variant represent a determination of genotype with\nrespect to that variant. For example, a call mi ght assign probability of 0.32\nto the occurrence of a SNP named rs1234 in a sam ple named NA12345. A call\nbelongs to a call set, which contains related calls t ypically from one\nsample.",
2255 "id": "Variant",
2256 "properties": {
2257 "variantSetId": {
2258 "description": "The ID of the variant set this variant belon gs to.",
2259 "type": "string"
2260 },
2261 "referenceName": {
2262 "description": "The reference on which this variant occurs.\ n(such as `chr20` or `X`)",
2263 "type": "string"
2264 },
2265 "info": {
2107 "additionalProperties": { 2266 "additionalProperties": {
2108 "items": { 2267 "items": {
2109 "type": "any" 2268 "type": "any"
2110 }, 2269 },
2111 "type": "array" 2270 "type": "array"
2112 }, 2271 },
2113 "description": "Remaining structured metadata key-value pair s. This must be of the form\nmap<string, string[]> (string key mapping to a list of string values).", 2272 "description": "A map of additional variant information. Thi s must be of the form\nmap<string, string[]> (string key mapping to a list of st ring values).",
2114 "type": "object" 2273 "type": "object"
2115 }, 2274 },
2116 "value": { 2275 "referenceBases": {
2117 "description": "The value field for simple metadata", 2276 "description": "The reference bases for this variant. They s tart at the given\nposition.",
2118 "type": "string" 2277 "type": "string"
2278 },
2279 "names": {
2280 "description": "Names for the variant, for example a RefSNP ID.",
2281 "items": {
2282 "type": "string"
2283 },
2284 "type": "array"
2285 },
2286 "alternateBases": {
2287 "description": "The bases that appear instead of the referen ce bases.",
2288 "items": {
2289 "type": "string"
2290 },
2291 "type": "array"
2292 },
2293 "end": {
2294 "description": "The end position (0-based) of this variant. This corresponds to the first\nbase after the last base in the reference allele. So, the length of\nthe reference allele is (end - start). This is useful for va riants\nthat don't explicitly give alternate bases, for example large deletions. ",
2295 "format": "int64",
2296 "type": "string"
2297 },
2298 "filter": {
2299 "description": "A list of filters (normally quality filters) this variant has failed.\n`PASS` indicates this variant has passed all filters. ",
2300 "items": {
2301 "type": "string"
2302 },
2303 "type": "array"
2304 },
2305 "calls": {
2306 "description": "The variant calls for this particular varian t. Each one represents the\ndetermination of genotype with respect to this varia nt.",
2307 "items": {
2308 "$ref": "VariantCall"
2309 },
2310 "type": "array"
2311 },
2312 "created": {
2313 "description": "The date this variant was created, in millis econds from the epoch.",
2314 "format": "int64",
2315 "type": "string"
2316 },
2317 "start": {
2318 "description": "The position at which this variant occurs (0 -based).\nThis corresponds to the first base of the string of reference bases.",
2319 "format": "int64",
2320 "type": "string"
2321 },
2322 "quality": {
2323 "description": "A measure of how likely this variant is to b e real.\nA higher value is better.",
2324 "format": "double",
2325 "type": "number"
2119 }, 2326 },
2120 "id": { 2327 "id": {
2121 "description": "User-provided ID field, not enforced by this API.\nTwo or more pieces of structured metadata with identical\nid and key fiel ds are considered equivalent.", 2328 "description": "The server-generated variant ID, unique acro ss all variants.",
2122 "type": "string" 2329 "type": "string"
2123 }, 2330 }
2124 "number": { 2331 },
2125 "description": "The number of values that can be included in a field described by this\nmetadata.", 2332 "type": "object"
2126 "type": "string" 2333 },
2127 }, 2334 "SearchCallSetsResponse": {
2128 "key": { 2335 "description": "The call set search response.",
2129 "description": "The top-level key.", 2336 "id": "SearchCallSetsResponse",
2130 "type": "string" 2337 "properties": {
2131 }, 2338 "nextPageToken": {
2132 "description": { 2339 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
2133 "description": "A textual description of this metadata.", 2340 "type": "string"
2134 "type": "string" 2341 },
2135 } 2342 "callSets": {
2136 }, 2343 "description": "The list of matching call sets.",
2137 "type": "object" 2344 "items": {
2138 }, 2345 "$ref": "CallSet"
2139 "Reference": { 2346 },
2140 "description": "A reference is a canonical assembled DNA sequence, i ntended to act as a\nreference coordinate space for other genomic annotations. A single reference\nmight represent the human chromosome 1 or mitochandrial DNA, for instance. A\nreference belongs to one or more reference sets.\n\nFor more ge nomics resource definitions, see [Fundamentals of Google\nGenomics](https://clou d.google.com/genomics/fundamentals-of-google-genomics)", 2347 "type": "array"
2141 "id": "Reference", 2348 }
2142 "properties": { 2349 },
2143 "sourceAccessions": { 2350 "type": "object"
2144 "description": "All known corresponding accession IDs in INS DC (GenBank/ENA/DDBJ) ideally\nwith a version number, for example `GCF_000001405 .26`.", 2351 },
2145 "items": { 2352 "ListOperationsResponse": {
2146 "type": "string" 2353 "description": "The response message for Operations.ListOperations." ,
2147 }, 2354 "id": "ListOperationsResponse",
2148 "type": "array" 2355 "properties": {
2149 }, 2356 "nextPageToken": {
2150 "ncbiTaxonId": { 2357 "description": "The standard List next-page token.",
2151 "description": "ID from http://www.ncbi.nlm.nih.gov/taxonomy . For example, 9606 for human.", 2358 "type": "string"
2359 },
2360 "operations": {
2361 "description": "A list of operations that matches the specif ied filter in the request.",
2362 "items": {
2363 "$ref": "Operation"
2364 },
2365 "type": "array"
2366 }
2367 },
2368 "type": "object"
2369 },
2370 "OperationMetadata": {
2371 "description": "Metadata describing an Operation.",
2372 "id": "OperationMetadata",
2373 "properties": {
2374 "projectId": {
2375 "description": "The Google Cloud Project in which the job is scoped.",
2376 "type": "string"
2377 },
2378 "clientId": {
2379 "description": "This field is deprecated. Use `labels` inste ad. Optionally provided by the\ncaller when submitting the request that creates the operation.",
2380 "type": "string"
2381 },
2382 "events": {
2383 "description": "Optional event messages that were generated during the job's execution.\nThis also contains any warnings that were generated during import\nor export.",
2384 "items": {
2385 "$ref": "OperationEvent"
2386 },
2387 "type": "array"
2388 },
2389 "endTime": {
2390 "description": "The time at which the job stopped running.",
2391 "format": "google-datetime",
2392 "type": "string"
2393 },
2394 "startTime": {
2395 "description": "The time at which the job began to run.",
2396 "format": "google-datetime",
2397 "type": "string"
2398 },
2399 "request": {
2400 "additionalProperties": {
2401 "description": "Properties of the object. Contains field @type with type URL.",
2402 "type": "any"
2403 },
2404 "description": "The original request that started the operat ion. Note that this will be in\ncurrent version of the API. If the operation was started with v1beta2 API\nand a GetOperation is performed on v1 API, a v1 reque st will be returned.",
2405 "type": "object"
2406 },
2407 "runtimeMetadata": {
2408 "additionalProperties": {
2409 "description": "Properties of the object. Contains field @type with type URL.",
2410 "type": "any"
2411 },
2412 "description": "Runtime metadata on this Operation.",
2413 "type": "object"
2414 },
2415 "labels": {
2416 "additionalProperties": {
2417 "type": "string"
2418 },
2419 "description": "Optionally provided by the caller when submi tting the request that creates\nthe operation.",
2420 "type": "object"
2421 },
2422 "createTime": {
2423 "description": "The time at which the job was submitted to t he Genomics service.",
2424 "format": "google-datetime",
2425 "type": "string"
2426 }
2427 },
2428 "type": "object"
2429 },
2430 "SearchVariantsRequest": {
2431 "description": "The variant search request.",
2432 "id": "SearchVariantsRequest",
2433 "properties": {
2434 "variantSetIds": {
2435 "description": "At most one variant set ID must be provided. Only variants from this\nvariant set will be returned. If omitted, a call set i d must be included in\nthe request.",
2436 "items": {
2437 "type": "string"
2438 },
2439 "type": "array"
2440 },
2441 "end": {
2442 "description": "The end of the window, 0-based exclusive. If unspecified or 0, defaults to\nthe length of the reference.",
2443 "format": "int64",
2444 "type": "string"
2445 },
2446 "maxCalls": {
2447 "description": "The maximum number of calls to return in a s ingle page. Note that this\nlimit may be exceeded in the event that a matching v ariant contains more\ncalls than the requested maximum. If unspecified, defaults to 5000. The\nmaximum value is 10000.",
2152 "format": "int32", 2448 "format": "int32",
2153 "type": "integer" 2449 "type": "integer"
2154 }, 2450 },
2155 "sourceUri": {
2156 "description": "The URI from which the sequence was obtained . Typically specifies a FASTA\nformat file.",
2157 "type": "string"
2158 },
2159 "name": {
2160 "description": "The name of this reference, for example `22` .",
2161 "type": "string"
2162 },
2163 "md5checksum": {
2164 "description": "MD5 of the upper-case sequence excluding all whitespace characters (this\nis equivalent to SQ:M5 in SAM). This value is repr esented in lower case\nhexadecimal format.",
2165 "type": "string"
2166 },
2167 "id": {
2168 "description": "The server-generated reference ID, unique ac ross all references.",
2169 "type": "string"
2170 },
2171 "length": {
2172 "description": "The length of this reference's sequence.",
2173 "format": "int64",
2174 "type": "string"
2175 }
2176 },
2177 "type": "object"
2178 },
2179 "SearchReferenceSetsRequest": {
2180 "id": "SearchReferenceSetsRequest",
2181 "properties": {
2182 "pageToken": { 2451 "pageToken": {
2183 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.", 2452 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
2184 "type": "string" 2453 "type": "string"
2185 }, 2454 },
2186 "accessions": {
2187 "description": "If present, return reference sets for which a prefix of any of\nsourceAccessions\nmatch any of these strings. Accession numb ers typically have a main number\nand a version, for example `NC_000001.11`.",
2188 "items": {
2189 "type": "string"
2190 },
2191 "type": "array"
2192 },
2193 "pageSize": { 2455 "pageSize": {
2194 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 1024. The maximum value is 4096.", 2456 "description": "The maximum number of variants to return in a single page. If unspecified,\ndefaults to 5000. The maximum value is 10000.",
2195 "format": "int32", 2457 "format": "int32",
2196 "type": "integer" 2458 "type": "integer"
2197 }, 2459 },
2198 "assemblyId": { 2460 "callSetIds": {
2199 "description": "If present, return reference sets for which a substring of their\n`assemblyId` matches this string (case insensitive).", 2461 "description": "Only return variant calls which belong to ca ll sets with these ids.\nLeaving this blank returns all variant calls. If a vari ant has no\ncalls belonging to any of these call sets, it won't be returned at a ll.",
2200 "type": "string" 2462 "items": {
2201 }, 2463 "type": "string"
2202 "md5checksums": { 2464 },
2203 "description": "If present, return reference sets for which the\nmd5checksum matches exactly.", 2465 "type": "array"
2204 "items": { 2466 },
2205 "type": "string" 2467 "variantName": {
2206 }, 2468 "description": "Only return variants which have exactly this name.",
2207 "type": "array" 2469 "type": "string"
2208 } 2470 },
2209 }, 2471 "start": {
2210 "type": "object" 2472 "description": "The beginning of the window (0-based, inclus ive) for which\noverlapping variants should be returned. If unspecified, default s to 0.",
2211 }, 2473 "format": "int64",
2212 "SetIamPolicyRequest": { 2474 "type": "string"
2213 "description": "Request message for `SetIamPolicy` method.", 2475 },
2214 "id": "SetIamPolicyRequest", 2476 "referenceName": {
2215 "properties": { 2477 "description": "Required. Only return variants in this refer ence sequence.",
2216 "policy": { 2478 "type": "string"
2217 "$ref": "Policy", 2479 }
2218 "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of\nthe policy is limited to a few 10s of KB. An emp ty policy is a\nvalid policy but certain Cloud Platform services (such as Projec ts)\nmight reject them." 2480 },
2219 } 2481 "type": "object"
2220 }, 2482 },
2221 "type": "object" 2483 "SearchReadGroupSetsRequest": {
2222 }, 2484 "description": "The read group set search request.",
2223 "MergeVariantsRequest": { 2485 "id": "SearchReadGroupSetsRequest",
2224 "id": "MergeVariantsRequest", 2486 "properties": {
2225 "properties": { 2487 "datasetIds": {
2226 "variants": { 2488 "description": "Restricts this query to read group sets with in the given datasets. At least\none ID must be provided.",
2227 "description": "The variants to be merged with existing vari ants.", 2489 "items": {
2228 "items": { 2490 "type": "string"
2229 "$ref": "Variant" 2491 },
2230 }, 2492 "type": "array"
2231 "type": "array" 2493 },
2232 }, 2494 "pageToken": {
2233 "infoMergeConfig": { 2495 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
2234 "additionalProperties": { 2496 "type": "string"
2235 "enum": [ 2497 },
2236 "INFO_MERGE_OPERATION_UNSPECIFIED", 2498 "name": {
2237 "IGNORE_NEW", 2499 "description": "Only return read group sets for which a subs tring of the name matches this\nstring.",
2238 "MOVE_TO_CALLS" 2500 "type": "string"
2239 ], 2501 },
2240 "type": "string" 2502 "pageSize": {
2241 }, 2503 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 256. The maximum value is 1024.",
2242 "description": "A mapping between info field keys and the In foMergeOperations to\nbe performed on them.",
2243 "type": "object"
2244 },
2245 "variantSetId": {
2246 "description": "The destination variant set.",
2247 "type": "string"
2248 }
2249 },
2250 "type": "object"
2251 },
2252 "BatchCreateAnnotationsRequest": {
2253 "id": "BatchCreateAnnotationsRequest",
2254 "properties": {
2255 "annotations": {
2256 "description": "The annotations to be created. At most 4096 can be specified in a single\nrequest.",
2257 "items": {
2258 "$ref": "Annotation"
2259 },
2260 "type": "array"
2261 },
2262 "requestId": {
2263 "description": "A unique request ID which enables the server to detect duplicated requests.\nIf provided, duplicated requests will result in the same response; if not\nprovided, duplicated requests may result in duplicat ed data. For a given\nannotation set, callers should not reuse `request_id`s whe n writing\ndifferent batches of annotations - behavior in this case is undefined .\nA common approach is to use a UUID. For batch jobs where worker crashes are\n a possibility, consider using some unique variant of a worker or run ID.",
2264 "type": "string"
2265 }
2266 },
2267 "type": "object"
2268 },
2269 "Read": {
2270 "description": "A read alignment describes a linear alignment of a s tring of DNA to a\nreference sequence, in addition to metadata\nabout the fragme nt (the molecule of DNA sequenced) and the read (the bases\nwhich were read by t he sequencer). A read is equivalent to a line in a SAM\nfile. A read belongs to exactly one read group and exactly one\nread group set.\n\nFor more genomics res ource definitions, see [Fundamentals of Google\nGenomics](https://cloud.google.c om/genomics/fundamentals-of-google-genomics)\n\n### Reverse-stranded reads\n\nMa pped reads (reads having a non-null `alignment`) can be aligned to either\nthe f orward or the reverse strand of their associated reference. Strandedness\nof a m apped read is encoded by `alignment.position.reverseStrand`.\n\nIf we consider t he reference to be a forward-stranded coordinate space of\n`[0, reference.length )` with `0` as the left-most position and\n`reference.length` as the right-most position, reads are always aligned left\nto right. That is, `alignment.position. position` always refers to the\nleft-most reference coordinate and `alignment.ci gar` describes the alignment\nof this read to the reference from left to right. All per-base fields such as\n`alignedSequence` and `alignedQuality` share this s ame left-to-right\norientation; this is true of reads which are aligned to eithe r strand. For\nreverse-stranded reads, this means that `alignedSequence` is the reverse\ncomplement of the bases that were originally reported by the sequencing \nmachine.\n\n### Generating a reference-aligned sequence string\n\nWhen interac ting with mapped reads, it's often useful to produce a string\nrepresenting the local alignment of the read to reference. The following\npseudocode demonstrates one way of doing this:\n\n out = \"\"\n offset = 0\n for c in read.ali gnment.cigar {\n switch c.operation {\n case \"ALIGNMENT_MATCH\", \"SE QUENCE_MATCH\", \"SEQUENCE_MISMATCH\":\n out += read.alignedSequence[offs et:offset+c.operationLength]\n offset += c.operationLength\n break \n case \"CLIP_SOFT\", \"INSERT\":\n offset += c.operationLength\n break\n case \"PAD\":\n out += repeat(\"*\", c.operationLength )\n break\n case \"DELETE\":\n out += repeat(\"-\", c.operati onLength)\n break\n case \"SKIP\":\n out += repeat(\" \", c.o perationLength)\n break\n case \"CLIP_HARD\":\n break\n }\n }\n return out\n\n### Converting to SAM's CIGAR string\n\nThe followin g pseudocode generates a SAM CIGAR string from the\n`cigar` field. Note that thi s is a lossy conversion\n(`cigar.referenceSequence` is lost).\n\n cigarMap = {\n \"ALIGNMENT_MATCH\": \"M\",\n \"INSERT\": \"I\",\n \"DELETE\" : \"D\",\n \"SKIP\": \"N\",\n \"CLIP_SOFT\": \"S\",\n \"CLIP_HARD \": \"H\",\n \"PAD\": \"P\",\n \"SEQUENCE_MATCH\": \"=\",\n \"SEQ UENCE_MISMATCH\": \"X\",\n }\n cigarStr = \"\"\n for c in read.alignmen t.cigar {\n cigarStr += c.operationLength + cigarMap[c.operation]\n }\n return cigarStr",
2271 "id": "Read",
2272 "properties": {
2273 "failedVendorQualityChecks": {
2274 "description": "Whether this read did not pass filters, such as platform or vendor quality\ncontrols (SAM flag 0x200).",
2275 "type": "boolean"
2276 },
2277 "alignedQuality": {
2278 "description": "The quality of the read sequence contained i n this alignment record\n(equivalent to QUAL in SAM).\n`alignedSequence` and `al ignedQuality` may be shorter than the full read\nsequence and quality. This will occur if the alignment is part of a\nchimeric alignment, or if the read was tri mmed. When this occurs, the CIGAR\nfor this read will begin/end with a hard clip operator that will indicate\nthe length of the excised sequence.",
2279 "items": {
2280 "format": "int32",
2281 "type": "integer"
2282 },
2283 "type": "array"
2284 },
2285 "alignment": {
2286 "$ref": "LinearAlignment",
2287 "description": "The linear alignment for this alignment reco rd. This field is null for\nunmapped reads."
2288 },
2289 "id": {
2290 "description": "The server-generated read ID, unique across all reads. This is different\nfrom the `fragmentName`.",
2291 "type": "string"
2292 },
2293 "numberReads": {
2294 "description": "The number of reads in the fragment (extensi on to SAM flag 0x1).",
2295 "format": "int32", 2504 "format": "int32",
2296 "type": "integer" 2505 "type": "integer"
2297 }, 2506 }
2298 "secondaryAlignment": { 2507 },
2299 "description": "Whether this alignment is secondary. Equival ent to SAM flag 0x100.\nA secondary alignment represents an alternative to the p rimary alignment\nfor this read. Aligners may return secondary alignments if a r ead can map\nambiguously to multiple coordinates in the genome. By convention, e ach read\nhas one and only one alignment where both `secondaryAlignment`\nand `s upplementaryAlignment` are false.", 2508 "type": "object"
2300 "type": "boolean" 2509 },
2301 }, 2510 "SearchAnnotationsResponse": {
2302 "fragmentName": { 2511 "id": "SearchAnnotationsResponse",
2303 "description": "The fragment name. Equivalent to QNAME (quer y template name) in SAM.", 2512 "properties": {
2304 "type": "string" 2513 "nextPageToken": {
2305 }, 2514 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
2306 "readGroupSetId": { 2515 "type": "string"
2307 "description": "The ID of the read group set this read belon gs to. A read belongs to\nexactly one read group set.", 2516 },
2308 "type": "string" 2517 "annotations": {
2309 }, 2518 "description": "The matching annotations.",
2310 "duplicateFragment": { 2519 "items": {
2311 "description": "The fragment is a PCR or optical duplicate ( SAM flag 0x400).", 2520 "$ref": "Annotation"
2312 "type": "boolean" 2521 },
2313 }, 2522 "type": "array"
2314 "readNumber": { 2523 }
2315 "description": "The read number in sequencing. 0-based and l ess than numberReads. This\nfield replaces SAM flag 0x40 and 0x80.", 2524 },
2525 "type": "object"
2526 },
2527 "ClinicalCondition": {
2528 "id": "ClinicalCondition",
2529 "properties": {
2530 "conceptId": {
2531 "description": "The MedGen concept id associated with this g ene.\nSearch for these IDs at http://www.ncbi.nlm.nih.gov/medgen/",
2532 "type": "string"
2533 },
2534 "names": {
2535 "description": "A set of names for the condition.",
2536 "items": {
2537 "type": "string"
2538 },
2539 "type": "array"
2540 },
2541 "omimId": {
2542 "description": "The OMIM id for this condition.\nSearch for these IDs at http://omim.org/",
2543 "type": "string"
2544 },
2545 "externalIds": {
2546 "description": "The set of external IDs for this condition." ,
2547 "items": {
2548 "$ref": "ExternalId"
2549 },
2550 "type": "array"
2551 }
2552 },
2553 "type": "object"
2554 },
2555 "SearchReadsResponse": {
2556 "description": "The read search response.",
2557 "id": "SearchReadsResponse",
2558 "properties": {
2559 "nextPageToken": {
2560 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
2561 "type": "string"
2562 },
2563 "alignments": {
2564 "description": "The list of matching alignments sorted by ma pped genomic coordinate,\nif any, ascending in position within the same referenc e. Unmapped reads,\nwhich have no position, are returned contiguously and are so rted in\nascending lexicographic order by fragment name.",
2565 "items": {
2566 "$ref": "Read"
2567 },
2568 "type": "array"
2569 }
2570 },
2571 "type": "object"
2572 },
2573 "Program": {
2574 "id": "Program",
2575 "properties": {
2576 "prevProgramId": {
2577 "description": "The ID of the program run before this one.",
2578 "type": "string"
2579 },
2580 "commandLine": {
2581 "description": "The command line used to run this program.",
2582 "type": "string"
2583 },
2584 "version": {
2585 "description": "The version of the program run.",
2586 "type": "string"
2587 },
2588 "id": {
2589 "description": "The user specified locally unique ID of the program. Used along with\n`prevProgramId` to define an ordering between programs .",
2590 "type": "string"
2591 },
2592 "name": {
2593 "description": "The display name of the program. This is typ ically the colloquial name of\nthe tool used, for example 'bwa' or 'picard'.",
2594 "type": "string"
2595 }
2596 },
2597 "type": "object"
2598 },
2599 "ComputeEngine": {
2600 "description": "Describes a Compute Engine resource that is being ma naged by a running\npipeline.",
2601 "id": "ComputeEngine",
2602 "properties": {
2603 "diskNames": {
2604 "description": "The names of the disks that were created for this pipeline.",
2605 "items": {
2606 "type": "string"
2607 },
2608 "type": "array"
2609 },
2610 "machineType": {
2611 "description": "The machine type of the instance.",
2612 "type": "string"
2613 },
2614 "instanceName": {
2615 "description": "The instance on which the operation is runni ng.",
2616 "type": "string"
2617 },
2618 "zone": {
2619 "description": "The availability zone in which the instance resides.",
2620 "type": "string"
2621 }
2622 },
2623 "type": "object"
2624 },
2625 "CoverageBucket": {
2626 "description": "A bucket over which read coverage has been precomput ed. A bucket corresponds\nto a specific range of the reference sequence.",
2627 "id": "CoverageBucket",
2628 "properties": {
2629 "meanCoverage": {
2630 "description": "The average number of reads which are aligne d to each individual\nreference base in this bucket.",
2631 "format": "float",
2632 "type": "number"
2633 },
2634 "range": {
2635 "$ref": "Range",
2636 "description": "The genomic coordinate range spanned by this bucket."
2637 }
2638 },
2639 "type": "object"
2640 },
2641 "ExternalId": {
2642 "id": "ExternalId",
2643 "properties": {
2644 "id": {
2645 "description": "The id used by the source of this data.",
2646 "type": "string"
2647 },
2648 "sourceName": {
2649 "description": "The name of the source of this data.",
2650 "type": "string"
2651 }
2652 },
2653 "type": "object"
2654 },
2655 "SearchVariantSetsRequest": {
2656 "description": "The search variant sets request.",
2657 "id": "SearchVariantSetsRequest",
2658 "properties": {
2659 "pageToken": {
2660 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
2661 "type": "string"
2662 },
2663 "pageSize": {
2664 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 1024.",
2316 "format": "int32", 2665 "format": "int32",
2317 "type": "integer" 2666 "type": "integer"
2318 }, 2667 },
2319 "alignedSequence": { 2668 "datasetIds": {
2320 "description": "The bases of the read sequence contained in this alignment record,\n**without CIGAR operations applied** (equivalent to SEQ in SAM).\n`alignedSequence` and `alignedQuality` may be\nshorter than the full r ead sequence and quality. This will occur if the\nalignment is part of a chimeri c alignment, or if the read was trimmed. When\nthis occurs, the CIGAR for this r ead will begin/end with a hard clip\noperator that will indicate the length of t he excised sequence.", 2669 "description": "Exactly one dataset ID must be provided here . Only variant sets which\nbelong to this dataset will be returned.",
2321 "type": "string" 2670 "items": {
2322 }, 2671 "type": "string"
2323 "readGroupId": { 2672 },
2324 "description": "The ID of the read group this read belongs t o. A read belongs to exactly\none read group. This is a server-generated ID whic h is distinct from SAM's\nRG tag (for that value, see\nReadGroup.name).", 2673 "type": "array"
2325 "type": "string" 2674 }
2326 }, 2675 },
2327 "nextMatePosition": { 2676 "type": "object"
2328 "$ref": "Position", 2677 },
2329 "description": "The mapping of the primary alignment of the\ n`(readNumber+1)%numberReads` read in the fragment. It replaces\nmate position a nd mate strand in SAM." 2678 "VariantSetMetadata": {
2330 }, 2679 "description": "Metadata describes a single piece of variant call me tadata.\nThese data include a top level key and either a single value string (va lue)\nor a list of key-value pairs (info.)\nValue and info are mutually exclusiv e.",
2680 "id": "VariantSetMetadata",
2681 "properties": {
2331 "info": { 2682 "info": {
2332 "additionalProperties": { 2683 "additionalProperties": {
2333 "items": { 2684 "items": {
2334 "type": "any"
2335 },
2336 "type": "array"
2337 },
2338 "description": "A map of additional read alignment informati on. This must be of the form\nmap<string, string[]> (string key mapping to a lis t of string values).",
2339 "type": "object"
2340 },
2341 "supplementaryAlignment": {
2342 "description": "Whether this alignment is supplementary. Equ ivalent to SAM flag 0x800.\nSupplementary alignments are used in the representat ion of a chimeric\nalignment. In a chimeric alignment, a read is split into mult iple\nlinear alignments that map to different reference contigs. The first\nline ar alignment in the read will be designated as the representative\nalignment; th e remaining linear alignments will be designated as\nsupplementary alignments. T hese alignments may have different mapping\nquality scores. In each linear align ment in a chimeric alignment, the read\nwill be hard clipped. The `alignedSequen ce` and\n`alignedQuality` fields in the alignment record will only\nrepresent th e bases for its respective linear alignment.",
2343 "type": "boolean"
2344 },
2345 "properPlacement": {
2346 "description": "The orientation and the distance between rea ds from the fragment are\nconsistent with the sequencing protocol (SAM flag 0x2) .",
2347 "type": "boolean"
2348 },
2349 "fragmentLength": {
2350 "description": "The observed length of the fragment, equival ent to TLEN in SAM.",
2351 "format": "int32",
2352 "type": "integer"
2353 }
2354 },
2355 "type": "object"
2356 },
2357 "ReferenceSet": {
2358 "description": "A reference set is a set of references which typical ly comprise a reference\nassembly for a species, such as `GRCh38` which is repre sentative\nof the human genome. A reference set defines a common coordinate spac e for\ncomparing reference-aligned experimental data. A reference set contains 1 or\nmore references.\n\nFor more genomics resource definitions, see [Fundamenta ls of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google -genomics)",
2359 "id": "ReferenceSet",
2360 "properties": {
2361 "sourceAccessions": {
2362 "description": "All known corresponding accession IDs in INS DC (GenBank/ENA/DDBJ) ideally\nwith a version number, for example `NC_000001.11` .",
2363 "items": {
2364 "type": "string"
2365 },
2366 "type": "array"
2367 },
2368 "description": {
2369 "description": "Free text description of this reference set. ",
2370 "type": "string"
2371 },
2372 "sourceUri": {
2373 "description": "The URI from which the references were obtai ned.",
2374 "type": "string"
2375 },
2376 "ncbiTaxonId": {
2377 "description": "ID from http://www.ncbi.nlm.nih.gov/taxonomy (for example, 9606 for human)\nindicating the species which this reference set is intended to model. Note\nthat contained references may specify a different `n cbiTaxonId`, as\nassemblies may contain reference sequences which do not belong to the\nmodeled species, for example EBV in a human reference genome.",
2378 "format": "int32",
2379 "type": "integer"
2380 },
2381 "referenceIds": {
2382 "description": "The IDs of the reference objects that are pa rt of this set.\n`Reference.md5checksum` must be unique within this set.",
2383 "items": {
2384 "type": "string"
2385 },
2386 "type": "array"
2387 },
2388 "assemblyId": {
2389 "description": "Public id of this reference set, such as `GR Ch37`.",
2390 "type": "string"
2391 },
2392 "md5checksum": {
2393 "description": "Order-independent MD5 checksum which identif ies this reference set. The\nchecksum is computed by sorting all lower case hexi decimal string\n`reference.md5checksum` (for all reference in this set) in\nasce nding lexicographic order, concatenating, and taking the MD5 of that\nvalue. The resulting value is represented in lower case hexadecimal format.",
2394 "type": "string"
2395 },
2396 "id": {
2397 "description": "The server-generated reference set ID, uniqu e across all reference sets.",
2398 "type": "string"
2399 }
2400 },
2401 "type": "object"
2402 },
2403 "CigarUnit": {
2404 "description": "A single CIGAR operation.",
2405 "id": "CigarUnit",
2406 "properties": {
2407 "operationLength": {
2408 "description": "The number of genomic bases that the operati on runs for. Required.",
2409 "format": "int64",
2410 "type": "string"
2411 },
2412 "operation": {
2413 "enum": [
2414 "OPERATION_UNSPECIFIED",
2415 "ALIGNMENT_MATCH",
2416 "INSERT",
2417 "DELETE",
2418 "SKIP",
2419 "CLIP_SOFT",
2420 "CLIP_HARD",
2421 "PAD",
2422 "SEQUENCE_MATCH",
2423 "SEQUENCE_MISMATCH"
2424 ],
2425 "enumDescriptions": [
2426 "",
2427 "An alignment match indicates that a sequence can be ali gned to the\nreference without evidence of an INDEL. Unlike the\n`SEQUENCE_MATCH ` and `SEQUENCE_MISMATCH` operators,\nthe `ALIGNMENT_MATCH` operator does not in dicate whether the\nreference and read sequences are an exact match. This operat or is\nequivalent to SAM's `M`.",
2428 "The insert operator indicates that the read contains ev idence of bases\nbeing inserted into the reference. This operator is equivalent to SAM's\n`I`.",
2429 "The delete operator indicates that the read contains ev idence of bases\nbeing deleted from the reference. This operator is equivalent t o SAM's\n`D`.",
2430 "The skip operator indicates that this read skips a long segment of the\nreference, but the bases have not been deleted. This operator i s commonly\nused when working with RNA-seq data, where reads may skip long segme nts\nof the reference between exons. This operator is equivalent to SAM's\n`N`." ,
2431 "The soft clip operator indicates that bases at the star t/end of a read\nhave not been considered during alignment. This may occur if th e majority\nof a read maps, except for low quality bases at the start/end of a r ead.\nThis operator is equivalent to SAM's `S`. Bases that are soft\nclipped wil l still be stored in the read.",
2432 "The hard clip operator indicates that bases at the star t/end of a read\nhave been omitted from this alignment. This may occur if this l inear\nalignment is part of a chimeric alignment, or if the read has been\ntrimm ed (for example, during error correction or to trim poly-A tails for\nRNA-seq). This operator is equivalent to SAM's `H`.",
2433 "The pad operator indicates that there is padding in an alignment. This\noperator is equivalent to SAM's `P`.",
2434 "This operator indicates that this portion of the aligne d sequence exactly\nmatches the reference. This operator is equivalent to SAM's `=`.",
2435 "This operator indicates that this portion of the aligne d sequence is an\nalignment match to the reference, but a sequence mismatch. Thi s can\nindicate a SNP or a read error. This operator is equivalent to SAM's\n`X` ."
2436 ],
2437 "type": "string"
2438 },
2439 "referenceSequence": {
2440 "description": "`referenceSequence` is only used at mismatch es\n(`SEQUENCE_MISMATCH`) and deletions (`DELETE`).\nFilling this field replaces SAM's MD tag. If the relevant information is\nnot available, this field is unse t.",
2441 "type": "string"
2442 }
2443 },
2444 "type": "object"
2445 },
2446 "AnnotationSet": {
2447 "description": "An annotation set is a logical grouping of annotatio ns that share consistent\ntype information and provenance. Examples of annotatio n sets include 'all\ngenes from refseq', and 'all variant annotations from ClinV ar'.",
2448 "id": "AnnotationSet",
2449 "properties": {
2450 "name": {
2451 "description": "The display name for this annotation set.",
2452 "type": "string"
2453 },
2454 "referenceSetId": {
2455 "description": "The ID of the reference set that defines the coordinate space for this\nset's annotations.",
2456 "type": "string"
2457 },
2458 "type": {
2459 "description": "The type of annotations contained within thi s set.",
2460 "enum": [
2461 "ANNOTATION_TYPE_UNSPECIFIED",
2462 "GENERIC",
2463 "VARIANT",
2464 "GENE",
2465 "TRANSCRIPT"
2466 ],
2467 "enumDescriptions": [
2468 "",
2469 "A `GENERIC` annotation type should be used when no othe r annotation\ntype will suffice. This represents an untyped annotation of the re ference\ngenome.",
2470 "A `VARIANT` annotation type.",
2471 "A `GENE` annotation type represents the existence of a gene at the\nassociated reference coordinates. The start coordinate is typically the\ngene's transcription start site and the end is typically the end of the\ng ene's last exon.",
2472 "A `TRANSCRIPT` annotation type represents the assertion that a\nparticular region of the reference genome may be transcribed as RNA."
2473 ],
2474 "type": "string"
2475 },
2476 "info": {
2477 "additionalProperties": {
2478 "items": {
2479 "type": "any"
2480 },
2481 "type": "array"
2482 },
2483 "description": "A map of additional read alignment informati on. This must be of the form\nmap<string, string[]> (string key mapping to a lis t of string values).",
2484 "type": "object"
2485 },
2486 "id": {
2487 "description": "The server-generated annotation set ID, uniq ue across all annotation sets.",
2488 "type": "string"
2489 },
2490 "datasetId": {
2491 "description": "The dataset to which this annotation set bel ongs.",
2492 "type": "string"
2493 },
2494 "sourceUri": {
2495 "description": "The source URI describing the file from whic h this annotation set was\ngenerated, if any.",
2496 "type": "string"
2497 }
2498 },
2499 "type": "object"
2500 },
2501 "Transcript": {
2502 "description": "A transcript represents the assertion that a particu lar region of the\nreference genome may be transcribed as RNA.",
2503 "id": "Transcript",
2504 "properties": {
2505 "exons": {
2506 "description": "The <a href=\"http://en.wikipedia.org/wiki/E xon\">exons</a> that compose\nthis transcript. This field should be unset for ge nomes where transcript\nsplicing does not occur, for example prokaryotes.\n\nInt rons are regions of the transcript that are not included in the\nspliced RNA pro duct. Though not explicitly modeled here, intron ranges can\nbe deduced; all reg ions of this transcript that are not exons are introns.\n\nExonic sequences do n ot necessarily code for a translational product\n(amino acids). Only the regions of exons bounded by the\ncodingSequence correspond\nto coding DNA sequence.\n\n Exons are ordered by start position and may not overlap.",
2507 "items": {
2508 "$ref": "Exon"
2509 },
2510 "type": "array"
2511 },
2512 "codingSequence": {
2513 "$ref": "CodingSequence",
2514 "description": "The range of the coding sequence for this tr anscript, if any. To determine\nthe exact ranges of coding sequence, intersect t his range with those of the\nexons, if any. If there are any\nexons, the\ncoding Sequence must start\nand end within them.\n\nNote that in some cases, the refere nce genome will not exactly match the\nobserved mRNA transcript e.g. due to vari ance in the source genome from\nreference. In these cases,\nexon.frame will not necessarily\nmatch the expected reference reading frame and coding exon referenc e bases\ncannot necessarily be concatenated to produce the original transcript m RNA."
2515 },
2516 "geneId": {
2517 "description": "The annotation ID of the gene from which thi s transcript is transcribed.",
2518 "type": "string"
2519 }
2520 },
2521 "type": "object"
2522 },
2523 "Experiment": {
2524 "id": "Experiment",
2525 "properties": {
2526 "platformUnit": {
2527 "description": "The platform unit used as part of this exper iment, for example\nflowcell-barcode.lane for Illumina or slide for SOLiD. Corre sponds to the\n@RG PU field in the SAM spec.",
2528 "type": "string"
2529 },
2530 "instrumentModel": {
2531 "description": "The instrument model used as part of this ex periment. This maps to\nsequencing technology in the SAM spec.",
2532 "type": "string"
2533 },
2534 "libraryId": {
2535 "description": "A client-supplied library identifier; a libr ary is a collection of DNA\nfragments which have been prepared for sequencing fr om a sample. This\nfield is important for quality control as error or bias can b e introduced\nduring sample preparation.",
2536 "type": "string"
2537 },
2538 "sequencingCenter": {
2539 "description": "The sequencing center used as part of this e xperiment.",
2540 "type": "string"
2541 }
2542 },
2543 "type": "object"
2544 },
2545 "ListDatasetsResponse": {
2546 "description": "The dataset list response.",
2547 "id": "ListDatasetsResponse",
2548 "properties": {
2549 "nextPageToken": {
2550 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
2551 "type": "string"
2552 },
2553 "datasets": {
2554 "description": "The list of matching Datasets.",
2555 "items": {
2556 "$ref": "Dataset"
2557 },
2558 "type": "array"
2559 }
2560 },
2561 "type": "object"
2562 },
2563 "TestIamPermissionsRequest": {
2564 "description": "Request message for `TestIamPermissions` method.",
2565 "id": "TestIamPermissionsRequest",
2566 "properties": {
2567 "permissions": {
2568 "description": "REQUIRED: The set of permissions to check fo r the 'resource'.\nPermissions with wildcards (such as '*' or 'storage.*') are n ot allowed.\nAllowed permissions are&#58;\n\n* `genomics.datasets.create`\n* `ge nomics.datasets.delete`\n* `genomics.datasets.get`\n* `genomics.datasets.list`\n * `genomics.datasets.update`\n* `genomics.datasets.getIamPolicy`\n* `genomics.da tasets.setIamPolicy`",
2569 "items": {
2570 "type": "string"
2571 },
2572 "type": "array"
2573 }
2574 },
2575 "type": "object"
2576 },
2577 "ExportReadGroupSetRequest": {
2578 "description": "The read group set export request.",
2579 "id": "ExportReadGroupSetRequest",
2580 "properties": {
2581 "referenceNames": {
2582 "description": "The reference names to export. If this is no t specified, all reference\nsequences, including unmapped reads, are exported.\n Use `*` to export only unmapped reads.",
2583 "items": {
2584 "type": "string"
2585 },
2586 "type": "array"
2587 },
2588 "exportUri": {
2589 "description": "Required. A Google Cloud Storage URI for the exported BAM file.\nThe currently authenticated user must have write access to the new file.\nAn error will be returned if the URI already contains data.",
2590 "type": "string"
2591 },
2592 "projectId": {
2593 "description": "Required. The Google Cloud project ID that o wns this\nexport. The caller must have WRITE access to this project.",
2594 "type": "string"
2595 }
2596 },
2597 "type": "object"
2598 },
2599 "Exon": {
2600 "id": "Exon",
2601 "properties": {
2602 "start": {
2603 "description": "The start position of the exon on this annot ation's reference sequence,\n0-based inclusive. Note that this is relative to th e reference start, and\n**not** the containing annotation start.",
2604 "format": "int64",
2605 "type": "string"
2606 },
2607 "frame": {
2608 "description": "The frame of this exon. Contains a value of 0, 1, or 2, which indicates\nthe offset of the first coding base of the exon wit hin the reading frame\nof the coding DNA sequence, if any. This field is depende nt on the\nstrandedness of this annotation (see\nAnnotation.reverse_strand).\nFo r forward stranded annotations, this offset is relative to the\nexon.start. For reverse\nstrand annotations, this offset is relative to the\nexon.end `- 1`.\n\n Unset if this exon does not intersect the coding sequence. Upon creation\nof a t ranscript, the frame must be populated for all or none of the\ncoding exons.",
2609 "format": "int32",
2610 "type": "integer"
2611 },
2612 "end": {
2613 "description": "The end position of the exon on this annotat ion's reference sequence,\n0-based exclusive. Note that this is relative to the reference start, and\n*not* the containing annotation start.",
2614 "format": "int64",
2615 "type": "string"
2616 }
2617 },
2618 "type": "object"
2619 },
2620 "CallSet": {
2621 "description": "A call set is a collection of variant calls, typical ly for one sample. It\nbelongs to a variant set.\n\nFor more genomics resource d efinitions, see [Fundamentals of Google\nGenomics](https://cloud.google.com/geno mics/fundamentals-of-google-genomics)",
2622 "id": "CallSet",
2623 "properties": {
2624 "created": {
2625 "description": "The date this call set was created in millis econds from the epoch.",
2626 "format": "int64",
2627 "type": "string"
2628 },
2629 "sampleId": {
2630 "description": "The sample ID this call set corresponds to." ,
2631 "type": "string"
2632 },
2633 "name": {
2634 "description": "The call set name.",
2635 "type": "string"
2636 },
2637 "info": {
2638 "additionalProperties": {
2639 "items": {
2640 "type": "any" 2685 "type": "any"
2641 }, 2686 },
2642 "type": "array" 2687 "type": "array"
2643 }, 2688 },
2644 "description": "A map of additional call set information. Th is must be of the form\nmap<string, string[]> (string key mapping to a list of s tring values).", 2689 "description": "Remaining structured metadata key-value pair s. This must be of the form\nmap<string, string[]> (string key mapping to a list of string values).",
2645 "type": "object" 2690 "type": "object"
2646 }, 2691 },
2647 "variantSetIds": { 2692 "type": {
2648 "description": "The IDs of the variant sets this call set be longs to. This field must\nhave exactly length one, as a call set belongs to a s ingle variant set.\nThis field is repeated for compatibility with the\n[GA4GH 0. 5.1\nAPI](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/v ariants.avdl#L76).", 2693 "description": "The type of data. Possible types include: In teger, Float,\nFlag, Character, and String.",
2649 "items": { 2694 "enum": [
2650 "type": "string" 2695 "TYPE_UNSPECIFIED",
2651 }, 2696 "INTEGER",
2652 "type": "array" 2697 "FLOAT",
2698 "FLAG",
2699 "CHARACTER",
2700 "STRING"
2701 ],
2702 "enumDescriptions": [
2703 "",
2704 "",
2705 "",
2706 "",
2707 "",
2708 ""
2709 ],
2710 "type": "string"
2711 },
2712 "number": {
2713 "description": "The number of values that can be included in a field described by this\nmetadata.",
2714 "type": "string"
2653 }, 2715 },
2654 "id": { 2716 "id": {
2655 "description": "The server-generated call set ID, unique acr oss all call sets.", 2717 "description": "User-provided ID field, not enforced by this API.\nTwo or more pieces of structured metadata with identical\nid and key fiel ds are considered equivalent.",
2656 "type": "string" 2718 "type": "string"
2657 } 2719 },
2658 }, 2720 "value": {
2659 "type": "object" 2721 "description": "The value field for simple metadata",
2660 }, 2722 "type": "string"
2661 "SearchAnnotationSetsResponse": { 2723 },
2662 "id": "SearchAnnotationSetsResponse", 2724 "key": {
2663 "properties": { 2725 "description": "The top-level key.",
2664 "nextPageToken": { 2726 "type": "string"
2665 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.", 2727 },
2666 "type": "string" 2728 "description": {
2667 }, 2729 "description": "A textual description of this metadata.",
2668 "annotationSets": { 2730 "type": "string"
2669 "description": "The matching annotation sets.", 2731 }
2670 "items": { 2732 },
2671 "$ref": "AnnotationSet" 2733 "type": "object"
2672 }, 2734 },
2673 "type": "array" 2735 "Reference": {
2674 } 2736 "description": "A reference is a canonical assembled DNA sequence, i ntended to act as a\nreference coordinate space for other genomic annotations. A single reference\nmight represent the human chromosome 1 or mitochandrial DNA, for instance. A\nreference belongs to one or more reference sets.\n\nFor more ge nomics resource definitions, see [Fundamentals of Google\nGenomics](https://clou d.google.com/genomics/fundamentals-of-google-genomics)",
2675 }, 2737 "id": "Reference",
2676 "type": "object" 2738 "properties": {
2677 }, 2739 "sourceAccessions": {
2678 "ImportVariantsRequest": { 2740 "description": "All known corresponding accession IDs in INS DC (GenBank/ENA/DDBJ) ideally\nwith a version number, for example `GCF_000001405 .26`.",
2679 "description": "The variant data import request.", 2741 "items": {
2680 "id": "ImportVariantsRequest", 2742 "type": "string"
2681 "properties": { 2743 },
2744 "type": "array"
2745 },
2746 "ncbiTaxonId": {
2747 "description": "ID from http://www.ncbi.nlm.nih.gov/taxonomy . For example, 9606 for human.",
2748 "format": "int32",
2749 "type": "integer"
2750 },
2751 "sourceUri": {
2752 "description": "The URI from which the sequence was obtained . Typically specifies a FASTA\nformat file.",
2753 "type": "string"
2754 },
2755 "name": {
2756 "description": "The name of this reference, for example `22` .",
2757 "type": "string"
2758 },
2759 "md5checksum": {
2760 "description": "MD5 of the upper-case sequence excluding all whitespace characters (this\nis equivalent to SQ:M5 in SAM). This value is repr esented in lower case\nhexadecimal format.",
2761 "type": "string"
2762 },
2763 "id": {
2764 "description": "The server-generated reference ID, unique ac ross all references.",
2765 "type": "string"
2766 },
2767 "length": {
2768 "description": "The length of this reference's sequence.",
2769 "format": "int64",
2770 "type": "string"
2771 }
2772 },
2773 "type": "object"
2774 },
2775 "SearchReferenceSetsRequest": {
2776 "id": "SearchReferenceSetsRequest",
2777 "properties": {
2778 "md5checksums": {
2779 "description": "If present, return reference sets for which the\nmd5checksum matches exactly.",
2780 "items": {
2781 "type": "string"
2782 },
2783 "type": "array"
2784 },
2785 "pageToken": {
2786 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
2787 "type": "string"
2788 },
2789 "accessions": {
2790 "description": "If present, return reference sets for which a prefix of any of\nsourceAccessions\nmatch any of these strings. Accession numb ers typically have a main number\nand a version, for example `NC_000001.11`.",
2791 "items": {
2792 "type": "string"
2793 },
2794 "type": "array"
2795 },
2796 "pageSize": {
2797 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 1024. The maximum value is 4096.",
2798 "format": "int32",
2799 "type": "integer"
2800 },
2801 "assemblyId": {
2802 "description": "If present, return reference sets for which a substring of their\n`assemblyId` matches this string (case insensitive).",
2803 "type": "string"
2804 }
2805 },
2806 "type": "object"
2807 },
2808 "SetIamPolicyRequest": {
2809 "description": "Request message for `SetIamPolicy` method.",
2810 "id": "SetIamPolicyRequest",
2811 "properties": {
2812 "policy": {
2813 "$ref": "Policy",
2814 "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of\nthe policy is limited to a few 10s of KB. An emp ty policy is a\nvalid policy but certain Cloud Platform services (such as Projec ts)\nmight reject them."
2815 }
2816 },
2817 "type": "object"
2818 },
2819 "MergeVariantsRequest": {
2820 "id": "MergeVariantsRequest",
2821 "properties": {
2822 "variants": {
2823 "description": "The variants to be merged with existing vari ants.",
2824 "items": {
2825 "$ref": "Variant"
2826 },
2827 "type": "array"
2828 },
2682 "infoMergeConfig": { 2829 "infoMergeConfig": {
2683 "additionalProperties": { 2830 "additionalProperties": {
2684 "enum": [ 2831 "enum": [
2685 "INFO_MERGE_OPERATION_UNSPECIFIED", 2832 "INFO_MERGE_OPERATION_UNSPECIFIED",
2686 "IGNORE_NEW", 2833 "IGNORE_NEW",
2687 "MOVE_TO_CALLS" 2834 "MOVE_TO_CALLS"
2688 ], 2835 ],
2689 "type": "string" 2836 "type": "string"
2690 }, 2837 },
2691 "description": "A mapping between info field keys and the In foMergeOperations to\nbe performed on them. This is plumbed down to the MergeVar iantRequests\ngenerated by the resulting import job.", 2838 "description": "A mapping between info field keys and the In foMergeOperations to\nbe performed on them.",
2692 "type": "object" 2839 "type": "object"
2693 }, 2840 },
2694 "sourceUris": {
2695 "description": "A list of URIs referencing variant files in Google Cloud Storage. URIs can\ninclude wildcards [as described\nhere](https://c loud.google.com/storage/docs/gsutil/addlhelp/WildcardNames).\nNote that recursiv e wildcards ('**') are not supported.",
2696 "items": {
2697 "type": "string"
2698 },
2699 "type": "array"
2700 },
2701 "variantSetId": { 2841 "variantSetId": {
2702 "description": "Required. The variant set to which variant d ata should be imported.", 2842 "description": "The destination variant set.",
2703 "type": "string" 2843 "type": "string"
2704 }, 2844 }
2705 "normalizeReferenceNames": { 2845 },
2706 "description": "Convert reference names to the canonical rep resentation.\nhg19 haploytypes (those reference names containing \"_hap\")\nare not modified in any way.\nAll other reference names are modified according to th e following rules:\nThe reference name is capitalized.\nThe \"chr\" prefix is dr opped for all autosomes and sex chromsomes.\nFor example \"chr17\" becomes \"17\ " and \"chrX\" becomes \"X\".\nAll mitochondrial chromosomes (\"chrM\", \"chrMT\ ", etc) become \"MT\".", 2846 "type": "object"
2847 },
2848 "BatchCreateAnnotationsRequest": {
2849 "id": "BatchCreateAnnotationsRequest",
2850 "properties": {
2851 "annotations": {
2852 "description": "The annotations to be created. At most 4096 can be specified in a single\nrequest.",
2853 "items": {
2854 "$ref": "Annotation"
2855 },
2856 "type": "array"
2857 },
2858 "requestId": {
2859 "description": "A unique request ID which enables the server to detect duplicated requests.\nIf provided, duplicated requests will result in the same response; if not\nprovided, duplicated requests may result in duplicat ed data. For a given\nannotation set, callers should not reuse `request_id`s whe n writing\ndifferent batches of annotations - behavior in this case is undefined .\nA common approach is to use a UUID. For batch jobs where worker crashes are\n a possibility, consider using some unique variant of a worker or run ID.",
2860 "type": "string"
2861 }
2862 },
2863 "type": "object"
2864 },
2865 "Read": {
2866 "description": "A read alignment describes a linear alignment of a s tring of DNA to a\nreference sequence, in addition to metadata\nabout the fragme nt (the molecule of DNA sequenced) and the read (the bases\nwhich were read by t he sequencer). A read is equivalent to a line in a SAM\nfile. A read belongs to exactly one read group and exactly one\nread group set.\n\nFor more genomics res ource definitions, see [Fundamentals of Google\nGenomics](https://cloud.google.c om/genomics/fundamentals-of-google-genomics)\n\n### Reverse-stranded reads\n\nMa pped reads (reads having a non-null `alignment`) can be aligned to either\nthe f orward or the reverse strand of their associated reference. Strandedness\nof a m apped read is encoded by `alignment.position.reverseStrand`.\n\nIf we consider t he reference to be a forward-stranded coordinate space of\n`[0, reference.length )` with `0` as the left-most position and\n`reference.length` as the right-most position, reads are always aligned left\nto right. That is, `alignment.position. position` always refers to the\nleft-most reference coordinate and `alignment.ci gar` describes the alignment\nof this read to the reference from left to right. All per-base fields such as\n`alignedSequence` and `alignedQuality` share this s ame left-to-right\norientation; this is true of reads which are aligned to eithe r strand. For\nreverse-stranded reads, this means that `alignedSequence` is the reverse\ncomplement of the bases that were originally reported by the sequencing \nmachine.\n\n### Generating a reference-aligned sequence string\n\nWhen interac ting with mapped reads, it's often useful to produce a string\nrepresenting the local alignment of the read to reference. The following\npseudocode demonstrates one way of doing this:\n\n out = \"\"\n offset = 0\n for c in read.ali gnment.cigar {\n switch c.operation {\n case \"ALIGNMENT_MATCH\", \"SE QUENCE_MATCH\", \"SEQUENCE_MISMATCH\":\n out += read.alignedSequence[offs et:offset+c.operationLength]\n offset += c.operationLength\n break \n case \"CLIP_SOFT\", \"INSERT\":\n offset += c.operationLength\n break\n case \"PAD\":\n out += repeat(\"*\", c.operationLength )\n break\n case \"DELETE\":\n out += repeat(\"-\", c.operati onLength)\n break\n case \"SKIP\":\n out += repeat(\" \", c.o perationLength)\n break\n case \"CLIP_HARD\":\n break\n }\n }\n return out\n\n### Converting to SAM's CIGAR string\n\nThe followin g pseudocode generates a SAM CIGAR string from the\n`cigar` field. Note that thi s is a lossy conversion\n(`cigar.referenceSequence` is lost).\n\n cigarMap = {\n \"ALIGNMENT_MATCH\": \"M\",\n \"INSERT\": \"I\",\n \"DELETE\" : \"D\",\n \"SKIP\": \"N\",\n \"CLIP_SOFT\": \"S\",\n \"CLIP_HARD \": \"H\",\n \"PAD\": \"P\",\n \"SEQUENCE_MATCH\": \"=\",\n \"SEQ UENCE_MISMATCH\": \"X\",\n }\n cigarStr = \"\"\n for c in read.alignmen t.cigar {\n cigarStr += c.operationLength + cigarMap[c.operation]\n }\n return cigarStr",
2867 "id": "Read",
2868 "properties": {
2869 "readNumber": {
2870 "description": "The read number in sequencing. 0-based and l ess than numberReads. This\nfield replaces SAM flag 0x40 and 0x80.",
2871 "format": "int32",
2872 "type": "integer"
2873 },
2874 "readGroupId": {
2875 "description": "The ID of the read group this read belongs t o. A read belongs to exactly\none read group. This is a server-generated ID whic h is distinct from SAM's\nRG tag (for that value, see\nReadGroup.name).",
2876 "type": "string"
2877 },
2878 "alignedSequence": {
2879 "description": "The bases of the read sequence contained in this alignment record,\n**without CIGAR operations applied** (equivalent to SEQ in SAM).\n`alignedSequence` and `alignedQuality` may be\nshorter than the full r ead sequence and quality. This will occur if the\nalignment is part of a chimeri c alignment, or if the read was trimmed. When\nthis occurs, the CIGAR for this r ead will begin/end with a hard clip\noperator that will indicate the length of t he excised sequence.",
2880 "type": "string"
2881 },
2882 "info": {
2883 "additionalProperties": {
2884 "items": {
2885 "type": "any"
2886 },
2887 "type": "array"
2888 },
2889 "description": "A map of additional read alignment informati on. This must be of the form\nmap<string, string[]> (string key mapping to a lis t of string values).",
2890 "type": "object"
2891 },
2892 "nextMatePosition": {
2893 "$ref": "Position",
2894 "description": "The mapping of the primary alignment of the\ n`(readNumber+1)%numberReads` read in the fragment. It replaces\nmate position a nd mate strand in SAM."
2895 },
2896 "supplementaryAlignment": {
2897 "description": "Whether this alignment is supplementary. Equ ivalent to SAM flag 0x800.\nSupplementary alignments are used in the representat ion of a chimeric\nalignment. In a chimeric alignment, a read is split into mult iple\nlinear alignments that map to different reference contigs. The first\nline ar alignment in the read will be designated as the representative\nalignment; th e remaining linear alignments will be designated as\nsupplementary alignments. T hese alignments may have different mapping\nquality scores. In each linear align ment in a chimeric alignment, the read\nwill be hard clipped. The `alignedSequen ce` and\n`alignedQuality` fields in the alignment record will only\nrepresent th e bases for its respective linear alignment.",
2707 "type": "boolean" 2898 "type": "boolean"
2708 }, 2899 },
2709 "format": { 2900 "properPlacement": {
2710 "description": "The format of the variant data being importe d. If unspecified, defaults to\nto `VCF`.", 2901 "description": "The orientation and the distance between rea ds from the fragment are\nconsistent with the sequencing protocol (SAM flag 0x2) .",
2902 "type": "boolean"
2903 },
2904 "fragmentLength": {
2905 "description": "The observed length of the fragment, equival ent to TLEN in SAM.",
2906 "format": "int32",
2907 "type": "integer"
2908 },
2909 "failedVendorQualityChecks": {
2910 "description": "Whether this read did not pass filters, such as platform or vendor quality\ncontrols (SAM flag 0x200).",
2911 "type": "boolean"
2912 },
2913 "alignedQuality": {
2914 "description": "The quality of the read sequence contained i n this alignment record\n(equivalent to QUAL in SAM).\n`alignedSequence` and `al ignedQuality` may be shorter than the full read\nsequence and quality. This will occur if the alignment is part of a\nchimeric alignment, or if the read was tri mmed. When this occurs, the CIGAR\nfor this read will begin/end with a hard clip operator that will indicate\nthe length of the excised sequence.",
2915 "items": {
2916 "format": "int32",
2917 "type": "integer"
2918 },
2919 "type": "array"
2920 },
2921 "alignment": {
2922 "$ref": "LinearAlignment",
2923 "description": "The linear alignment for this alignment reco rd. This field is null for\nunmapped reads."
2924 },
2925 "numberReads": {
2926 "description": "The number of reads in the fragment (extensi on to SAM flag 0x1).",
2927 "format": "int32",
2928 "type": "integer"
2929 },
2930 "id": {
2931 "description": "The server-generated read ID, unique across all reads. This is different\nfrom the `fragmentName`.",
2932 "type": "string"
2933 },
2934 "secondaryAlignment": {
2935 "description": "Whether this alignment is secondary. Equival ent to SAM flag 0x100.\nA secondary alignment represents an alternative to the p rimary alignment\nfor this read. Aligners may return secondary alignments if a r ead can map\nambiguously to multiple coordinates in the genome. By convention, e ach read\nhas one and only one alignment where both `secondaryAlignment`\nand `s upplementaryAlignment` are false.",
2936 "type": "boolean"
2937 },
2938 "fragmentName": {
2939 "description": "The fragment name. Equivalent to QNAME (quer y template name) in SAM.",
2940 "type": "string"
2941 },
2942 "readGroupSetId": {
2943 "description": "The ID of the read group set this read belon gs to. A read belongs to\nexactly one read group set.",
2944 "type": "string"
2945 },
2946 "duplicateFragment": {
2947 "description": "The fragment is a PCR or optical duplicate ( SAM flag 0x400).",
2948 "type": "boolean"
2949 }
2950 },
2951 "type": "object"
2952 },
2953 "CigarUnit": {
2954 "description": "A single CIGAR operation.",
2955 "id": "CigarUnit",
2956 "properties": {
2957 "operation": {
2711 "enum": [ 2958 "enum": [
2712 "FORMAT_UNSPECIFIED", 2959 "OPERATION_UNSPECIFIED",
2713 "FORMAT_VCF", 2960 "ALIGNMENT_MATCH",
2714 "FORMAT_COMPLETE_GENOMICS" 2961 "INSERT",
2962 "DELETE",
2963 "SKIP",
2964 "CLIP_SOFT",
2965 "CLIP_HARD",
2966 "PAD",
2967 "SEQUENCE_MATCH",
2968 "SEQUENCE_MISMATCH"
2715 ], 2969 ],
2716 "enumDescriptions": [ 2970 "enumDescriptions": [
2717 "", 2971 "",
2718 "VCF (Variant Call Format). The VCF files may be gzip co mpressed. gVCF is\nalso supported. Disclaimer: gzip VCF imports are currently mu ch slower\nthan equivalent uncompressed VCF imports. For this reason, uncompress ed\nVCF is currently recommended for imports with more than 1GB combined\nuncomp ressed size, or for time sensitive imports.", 2972 "An alignment match indicates that a sequence can be ali gned to the\nreference without evidence of an INDEL. Unlike the\n`SEQUENCE_MATCH ` and `SEQUENCE_MISMATCH` operators,\nthe `ALIGNMENT_MATCH` operator does not in dicate whether the\nreference and read sequences are an exact match. This operat or is\nequivalent to SAM's `M`.",
2719 "Complete Genomics masterVarBeta format. The masterVarBe ta files may\nbe bzip2 compressed." 2973 "The insert operator indicates that the read contains ev idence of bases\nbeing inserted into the reference. This operator is equivalent to SAM's\n`I`.",
2974 "The delete operator indicates that the read contains ev idence of bases\nbeing deleted from the reference. This operator is equivalent t o SAM's\n`D`.",
2975 "The skip operator indicates that this read skips a long segment of the\nreference, but the bases have not been deleted. This operator i s commonly\nused when working with RNA-seq data, where reads may skip long segme nts\nof the reference between exons. This operator is equivalent to SAM's\n`N`." ,
2976 "The soft clip operator indicates that bases at the star t/end of a read\nhave not been considered during alignment. This may occur if th e majority\nof a read maps, except for low quality bases at the start/end of a r ead.\nThis operator is equivalent to SAM's `S`. Bases that are soft\nclipped wil l still be stored in the read.",
2977 "The hard clip operator indicates that bases at the star t/end of a read\nhave been omitted from this alignment. This may occur if this l inear\nalignment is part of a chimeric alignment, or if the read has been\ntrimm ed (for example, during error correction or to trim poly-A tails for\nRNA-seq). This operator is equivalent to SAM's `H`.",
2978 "The pad operator indicates that there is padding in an alignment. This\noperator is equivalent to SAM's `P`.",
2979 "This operator indicates that this portion of the aligne d sequence exactly\nmatches the reference. This operator is equivalent to SAM's `=`.",
2980 "This operator indicates that this portion of the aligne d sequence is an\nalignment match to the reference, but a sequence mismatch. Thi s can\nindicate a SNP or a read error. This operator is equivalent to SAM's\n`X` ."
2720 ], 2981 ],
2721 "type": "string" 2982 "type": "string"
2722 } 2983 },
2723 }, 2984 "referenceSequence": {
2724 "type": "object" 2985 "description": "`referenceSequence` is only used at mismatch es\n(`SEQUENCE_MISMATCH`) and deletions (`DELETE`).\nFilling this field replaces SAM's MD tag. If the relevant information is\nnot available, this field is unse t.",
2725 }, 2986 "type": "string"
2726 "VariantAnnotation": { 2987 },
2727 "id": "VariantAnnotation", 2988 "operationLength": {
2728 "properties": { 2989 "description": "The number of genomic bases that the operati on runs for. Required.",
2729 "effect": { 2990 "format": "int64",
2730 "description": "Effect of the variant on the coding sequence .", 2991 "type": "string"
2992 }
2993 },
2994 "type": "object"
2995 },
2996 "ReferenceSet": {
2997 "description": "A reference set is a set of references which typical ly comprise a reference\nassembly for a species, such as `GRCh38` which is repre sentative\nof the human genome. A reference set defines a common coordinate spac e for\ncomparing reference-aligned experimental data. A reference set contains 1 or\nmore references.\n\nFor more genomics resource definitions, see [Fundamenta ls of Google\nGenomics](https://cloud.google.com/genomics/fundamentals-of-google -genomics)",
2998 "id": "ReferenceSet",
2999 "properties": {
3000 "description": {
3001 "description": "Free text description of this reference set. ",
3002 "type": "string"
3003 },
3004 "sourceAccessions": {
3005 "description": "All known corresponding accession IDs in INS DC (GenBank/ENA/DDBJ) ideally\nwith a version number, for example `NC_000001.11` .",
3006 "items": {
3007 "type": "string"
3008 },
3009 "type": "array"
3010 },
3011 "ncbiTaxonId": {
3012 "description": "ID from http://www.ncbi.nlm.nih.gov/taxonomy (for example, 9606 for human)\nindicating the species which this reference set is intended to model. Note\nthat contained references may specify a different `n cbiTaxonId`, as\nassemblies may contain reference sequences which do not belong to the\nmodeled species, for example EBV in a human reference genome.",
3013 "format": "int32",
3014 "type": "integer"
3015 },
3016 "sourceUri": {
3017 "description": "The URI from which the references were obtai ned.",
3018 "type": "string"
3019 },
3020 "referenceIds": {
3021 "description": "The IDs of the reference objects that are pa rt of this set.\n`Reference.md5checksum` must be unique within this set.",
3022 "items": {
3023 "type": "string"
3024 },
3025 "type": "array"
3026 },
3027 "assemblyId": {
3028 "description": "Public id of this reference set, such as `GR Ch37`.",
3029 "type": "string"
3030 },
3031 "md5checksum": {
3032 "description": "Order-independent MD5 checksum which identif ies this reference set. The\nchecksum is computed by sorting all lower case hexi decimal string\n`reference.md5checksum` (for all reference in this set) in\nasce nding lexicographic order, concatenating, and taking the MD5 of that\nvalue. The resulting value is represented in lower case hexadecimal format.",
3033 "type": "string"
3034 },
3035 "id": {
3036 "description": "The server-generated reference set ID, uniqu e across all reference sets.",
3037 "type": "string"
3038 }
3039 },
3040 "type": "object"
3041 },
3042 "Transcript": {
3043 "description": "A transcript represents the assertion that a particu lar region of the\nreference genome may be transcribed as RNA.",
3044 "id": "Transcript",
3045 "properties": {
3046 "codingSequence": {
3047 "$ref": "CodingSequence",
3048 "description": "The range of the coding sequence for this tr anscript, if any. To determine\nthe exact ranges of coding sequence, intersect t his range with those of the\nexons, if any. If there are any\nexons, the\ncoding Sequence must start\nand end within them.\n\nNote that in some cases, the refere nce genome will not exactly match the\nobserved mRNA transcript e.g. due to vari ance in the source genome from\nreference. In these cases,\nexon.frame will not necessarily\nmatch the expected reference reading frame and coding exon referenc e bases\ncannot necessarily be concatenated to produce the original transcript m RNA."
3049 },
3050 "geneId": {
3051 "description": "The annotation ID of the gene from which thi s transcript is transcribed.",
3052 "type": "string"
3053 },
3054 "exons": {
3055 "description": "The <a href=\"http://en.wikipedia.org/wiki/E xon\">exons</a> that compose\nthis transcript. This field should be unset for ge nomes where transcript\nsplicing does not occur, for example prokaryotes.\n\nInt rons are regions of the transcript that are not included in the\nspliced RNA pro duct. Though not explicitly modeled here, intron ranges can\nbe deduced; all reg ions of this transcript that are not exons are introns.\n\nExonic sequences do n ot necessarily code for a translational product\n(amino acids). Only the regions of exons bounded by the\ncodingSequence correspond\nto coding DNA sequence.\n\n Exons are ordered by start position and may not overlap.",
3056 "items": {
3057 "$ref": "Exon"
3058 },
3059 "type": "array"
3060 }
3061 },
3062 "type": "object"
3063 },
3064 "AnnotationSet": {
3065 "description": "An annotation set is a logical grouping of annotatio ns that share consistent\ntype information and provenance. Examples of annotatio n sets include 'all\ngenes from refseq', and 'all variant annotations from ClinV ar'.",
3066 "id": "AnnotationSet",
3067 "properties": {
3068 "name": {
3069 "description": "The display name for this annotation set.",
3070 "type": "string"
3071 },
3072 "referenceSetId": {
3073 "description": "The ID of the reference set that defines the coordinate space for this\nset's annotations.",
3074 "type": "string"
3075 },
3076 "info": {
3077 "additionalProperties": {
3078 "items": {
3079 "type": "any"
3080 },
3081 "type": "array"
3082 },
3083 "description": "A map of additional read alignment informati on. This must be of the form\nmap<string, string[]> (string key mapping to a lis t of string values).",
3084 "type": "object"
3085 },
3086 "type": {
3087 "description": "The type of annotations contained within thi s set.",
2731 "enum": [ 3088 "enum": [
2732 "EFFECT_UNSPECIFIED", 3089 "ANNOTATION_TYPE_UNSPECIFIED",
2733 "EFFECT_OTHER", 3090 "GENERIC",
2734 "FRAMESHIFT", 3091 "VARIANT",
2735 "FRAME_PRESERVING_INDEL", 3092 "GENE",
2736 "SYNONYMOUS_SNP", 3093 "TRANSCRIPT"
2737 "NONSYNONYMOUS_SNP",
2738 "STOP_GAIN",
2739 "STOP_LOSS",
2740 "SPLICE_SITE_DISRUPTION"
2741 ], 3094 ],
2742 "enumDescriptions": [ 3095 "enumDescriptions": [
2743 "", 3096 "",
2744 "`EFFECT_OTHER` should be used when no other Effect\nwil l suffice.",
2745 "`FRAMESHIFT` indicates a mutation in which the insertio n or\ndeletion of nucleotides resulted in a frameshift change.",
2746 "`FRAME_PRESERVING_INDEL` indicates a mutation in which a\nmultiple of three nucleotides has been inserted or deleted, resulting\nin no change to the reading frame of the coding sequence.",
2747 "`SYNONYMOUS_SNP` indicates a single nucleotide polymorp hism\nmutation that results in no amino acid change.",
2748 "`NONSYNONYMOUS_SNP` indicates a single nucleotide\npoly morphism mutation that results in an amino acid change.",
2749 "`STOP_GAIN` indicates a mutation that leads to the crea tion\nof a stop codon at the variant site. Frameshift mutations creating\ndownst ream stop codons do not count as `STOP_GAIN`.",
2750 "`STOP_LOSS` indicates a mutation that eliminates a\nsto p codon at the variant site.",
2751 "`SPLICE_SITE_DISRUPTION` indicates that this variant is \nfound in a splice site for the associated transcript, and alters the\nnormal s plicing pattern."
2752 ],
2753 "type": "string"
2754 },
2755 "transcriptIds": {
2756 "description": "Google annotation IDs of the transcripts aff ected by this variant. These\nshould be provided when the variant is created.",
2757 "items": {
2758 "type": "string"
2759 },
2760 "type": "array"
2761 },
2762 "type": {
2763 "description": "Type has been adapted from ClinVar's list of variant types.",
2764 "enum": [
2765 "TYPE_UNSPECIFIED",
2766 "TYPE_OTHER",
2767 "INSERTION",
2768 "DELETION",
2769 "SUBSTITUTION",
2770 "SNP",
2771 "STRUCTURAL",
2772 "CNV"
2773 ],
2774 "enumDescriptions": [
2775 "",
2776 "`TYPE_OTHER` should be used when no other Type will suf fice.\nFurther explanation of the variant type may be included in the\ninfo fiel d.",
2777 "`INSERTION` indicates an insertion.",
2778 "`DELETION` indicates a deletion.",
2779 "`SUBSTITUTION` indicates a block substitution of\ntwo o r more nucleotides.",
2780 "`SNP` indicates a single nucleotide polymorphism.",
2781 "`STRUCTURAL` indicates a large structural variant,\ninc luding chromosomal fusions, inversions, etc.",
2782 "`CNV` indicates a variation in copy number."
2783 ],
2784 "type": "string"
2785 },
2786 "alternateBases": {
2787 "description": "The alternate allele for this variant. If mu ltiple alternate alleles\nexist at this location, create a separate variant for each one, as they\nmay represent distinct conditions.",
2788 "type": "string"
2789 },
2790 "geneId": {
2791 "description": "Google annotation ID of the gene affected by this variant. This should\nbe provided when the variant is created.",
2792 "type": "string"
2793 },
2794 "clinicalSignificance": {
2795 "description": "Describes the clinical significance of a var iant.\nIt is adapted from the ClinVar controlled vocabulary for clinical\nsignif icance described at:\nhttp://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/",
2796 "enum": [
2797 "CLINICAL_SIGNIFICANCE_UNSPECIFIED",
2798 "CLINICAL_SIGNIFICANCE_OTHER",
2799 "UNCERTAIN",
2800 "BENIGN",
2801 "LIKELY_BENIGN",
2802 "LIKELY_PATHOGENIC",
2803 "PATHOGENIC",
2804 "DRUG_RESPONSE",
2805 "HISTOCOMPATIBILITY",
2806 "CONFERS_SENSITIVITY",
2807 "RISK_FACTOR",
2808 "ASSOCIATION",
2809 "PROTECTIVE",
2810 "MULTIPLE_REPORTED"
2811 ],
2812 "enumDescriptions": [
2813 "",
2814 "`OTHER` should be used when no other clinical significa nce\nvalue will suffice.",
2815 "",
2816 "",
2817 "",
2818 "",
2819 "",
2820 "",
2821 "",
2822 "",
2823 "",
2824 "",
2825 "",
2826 "`MULTIPLE_REPORTED` should be used when multiple clinic al\nsignficances are reported for a variant. The original clinical\nsignificance values may be provided in the `info` field."
2827 ],
2828 "type": "string"
2829 },
2830 "conditions": {
2831 "description": "The set of conditions associated with this v ariant.\nA condition describes the way a variant influences human health.",
2832 "items": {
2833 "$ref": "ClinicalCondition"
2834 },
2835 "type": "array"
2836 }
2837 },
2838 "type": "object"
2839 },
2840 "ListCoverageBucketsResponse": {
2841 "id": "ListCoverageBucketsResponse",
2842 "properties": {
2843 "coverageBuckets": {
2844 "description": "The coverage buckets. The list of buckets is sparse; a bucket with 0\noverlapping reads is not returned. A bucket never cros ses more than one\nreference sequence. Each bucket has width `bucketWidth`, unle ss\nits end is the end of the reference sequence.",
2845 "items": {
2846 "$ref": "CoverageBucket"
2847 },
2848 "type": "array"
2849 },
2850 "nextPageToken": {
2851 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
2852 "type": "string"
2853 },
2854 "bucketWidth": {
2855 "description": "The length of each coverage bucket in base p airs. Note that buckets at the\nend of a reference sequence may be shorter. This value is omitted if the\nbucket width is infinity (the default behaviour, with no range or\n`targetBucketWidth`).",
2856 "format": "int64",
2857 "type": "string"
2858 }
2859 },
2860 "type": "object"
2861 },
2862 "ExportVariantSetRequest": {
2863 "description": "The variant data export request.",
2864 "id": "ExportVariantSetRequest",
2865 "properties": {
2866 "bigqueryTable": {
2867 "description": "Required. The BigQuery table to export data to.\nIf the table doesn't exist, it will be created. If it already exists, it\nw ill be overwritten.",
2868 "type": "string"
2869 },
2870 "bigqueryDataset": {
2871 "description": "Required. The BigQuery dataset to export dat a to. This dataset must already\nexist. Note that this is distinct from the Geno mics concept of \"dataset\".",
2872 "type": "string"
2873 },
2874 "format": {
2875 "description": "The format for the exported data.",
2876 "enum": [
2877 "FORMAT_UNSPECIFIED",
2878 "FORMAT_BIGQUERY"
2879 ],
2880 "enumDescriptions": [
2881 "",
2882 "Export the data to Google BigQuery."
2883 ],
2884 "type": "string"
2885 },
2886 "projectId": {
2887 "description": "Required. The Google Cloud project ID that o wns the destination\nBigQuery dataset. The caller must have WRITE access to this project. This\nproject will also own the resulting export job.",
2888 "type": "string"
2889 },
2890 "callSetIds": {
2891 "description": "If provided, only variant call information f rom the specified call sets\nwill be exported. By default all variant calls are exported.",
2892 "items": {
2893 "type": "string"
2894 },
2895 "type": "array"
2896 }
2897 },
2898 "type": "object"
2899 },
2900 "SearchAnnotationsRequest": {
2901 "id": "SearchAnnotationsRequest",
2902 "properties": {
2903 "pageToken": {
2904 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
2905 "type": "string"
2906 },
2907 "pageSize": {
2908 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 256. The maximum value is 2048.",
2909 "format": "int32",
2910 "type": "integer"
2911 },
2912 "start": {
2913 "description": "The start position of the range on the refer ence, 0-based inclusive. If\nspecified,\nreferenceId or\nreferenceName\nmust be specified. Defaults to 0.",
2914 "format": "int64",
2915 "type": "string"
2916 },
2917 "annotationSetIds": {
2918 "description": "Required. The annotation sets to search with in. The caller must have\n`READ` access to these annotation sets.\nAll queried a nnotation sets must have the same type.",
2919 "items": {
2920 "type": "string"
2921 },
2922 "type": "array"
2923 },
2924 "referenceName": {
2925 "description": "The name of the reference to query, within t he reference set associated\nwith this query.",
2926 "type": "string"
2927 },
2928 "referenceId": {
2929 "description": "The ID of the reference to query.",
2930 "type": "string"
2931 },
2932 "end": {
2933 "description": "The end position of the range on the referen ce, 0-based exclusive. If\nreferenceId or\nreferenceName\nmust be specified, Def aults to the length of the reference.",
2934 "format": "int64",
2935 "type": "string"
2936 }
2937 },
2938 "type": "object"
2939 },
2940 "OperationEvent": {
2941 "description": "An event that occurred during an Operation.",
2942 "id": "OperationEvent",
2943 "properties": {
2944 "description": {
2945 "description": "Required description of event.",
2946 "type": "string"
2947 },
2948 "endTime": {
2949 "description": "Optional time of when event finished. An eve nt can have a start time and no\nfinish time. If an event has a finish time, the re must be a start time.",
2950 "format": "google-datetime",
2951 "type": "string"
2952 },
2953 "startTime": {
2954 "description": "Optional time of when event started.",
2955 "format": "google-datetime",
2956 "type": "string"
2957 }
2958 },
2959 "type": "object"
2960 },
2961 "CodingSequence": {
2962 "id": "CodingSequence",
2963 "properties": {
2964 "end": {
2965 "description": "The end of the coding sequence on this annot ation's reference sequence,\n0-based exclusive. Note that this position is relat ive to the reference\nstart, and *not* the containing annotation start.",
2966 "format": "int64",
2967 "type": "string"
2968 },
2969 "start": {
2970 "description": "The start of the coding sequence on this ann otation's reference sequence,\n0-based inclusive. Note that this position is rel ative to the reference\nstart, and *not* the containing annotation start.",
2971 "format": "int64",
2972 "type": "string"
2973 }
2974 },
2975 "type": "object"
2976 },
2977 "SearchReferencesResponse": {
2978 "id": "SearchReferencesResponse",
2979 "properties": {
2980 "references": {
2981 "description": "The matching references.",
2982 "items": {
2983 "$ref": "Reference"
2984 },
2985 "type": "array"
2986 },
2987 "nextPageToken": {
2988 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
2989 "type": "string"
2990 }
2991 },
2992 "type": "object"
2993 },
2994 "GetIamPolicyRequest": {
2995 "description": "Request message for `GetIamPolicy` method.",
2996 "id": "GetIamPolicyRequest",
2997 "properties": {},
2998 "type": "object"
2999 },
3000 "TestIamPermissionsResponse": {
3001 "description": "Response message for `TestIamPermissions` method.",
3002 "id": "TestIamPermissionsResponse",
3003 "properties": {
3004 "permissions": {
3005 "description": "A subset of `TestPermissionsRequest.permissi ons` that the caller is\nallowed.",
3006 "items": {
3007 "type": "string"
3008 },
3009 "type": "array"
3010 }
3011 },
3012 "type": "object"
3013 },
3014 "SearchAnnotationSetsRequest": {
3015 "id": "SearchAnnotationSetsRequest",
3016 "properties": {
3017 "pageToken": {
3018 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
3019 "type": "string"
3020 },
3021 "pageSize": {
3022 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 128. The maximum value is 1024.",
3023 "format": "int32",
3024 "type": "integer"
3025 },
3026 "datasetIds": {
3027 "description": "Required. The dataset IDs to search within. Caller must have `READ` access\nto these datasets.",
3028 "items": {
3029 "type": "string"
3030 },
3031 "type": "array"
3032 },
3033 "types": {
3034 "description": "If specified, only annotation sets that have any of these types are\nreturned.",
3035 "enumDescriptions": [
3036 "",
3037 "A `GENERIC` annotation type should be used when no othe r annotation\ntype will suffice. This represents an untyped annotation of the re ference\ngenome.", 3097 "A `GENERIC` annotation type should be used when no othe r annotation\ntype will suffice. This represents an untyped annotation of the re ference\ngenome.",
3038 "A `VARIANT` annotation type.", 3098 "A `VARIANT` annotation type.",
3039 "A `GENE` annotation type represents the existence of a gene at the\nassociated reference coordinates. The start coordinate is typically the\ngene's transcription start site and the end is typically the end of the\ng ene's last exon.", 3099 "A `GENE` annotation type represents the existence of a gene at the\nassociated reference coordinates. The start coordinate is typically the\ngene's transcription start site and the end is typically the end of the\ng ene's last exon.",
3040 "A `TRANSCRIPT` annotation type represents the assertion that a\nparticular region of the reference genome may be transcribed as RNA." 3100 "A `TRANSCRIPT` annotation type represents the assertion that a\nparticular region of the reference genome may be transcribed as RNA."
3041 ], 3101 ],
3042 "items": {
3043 "enum": [
3044 "ANNOTATION_TYPE_UNSPECIFIED",
3045 "GENERIC",
3046 "VARIANT",
3047 "GENE",
3048 "TRANSCRIPT"
3049 ],
3050 "type": "string"
3051 },
3052 "type": "array"
3053 },
3054 "name": {
3055 "description": "Only return annotations sets for which a sub string of the name matches this\nstring (case insensitive).",
3056 "type": "string" 3102 "type": "string"
3057 }, 3103 },
3058 "referenceSetId": { 3104 "id": {
3059 "description": "If specified, only annotation sets associate d with the given reference set\nare returned.", 3105 "description": "The server-generated annotation set ID, uniq ue across all annotation sets.",
3106 "type": "string"
3107 },
3108 "datasetId": {
3109 "description": "The dataset to which this annotation set bel ongs.",
3110 "type": "string"
3111 },
3112 "sourceUri": {
3113 "description": "The source URI describing the file from whic h this annotation set was\ngenerated, if any.",
3060 "type": "string" 3114 "type": "string"
3061 } 3115 }
3062 }, 3116 },
3063 "type": "object" 3117 "type": "object"
3064 }, 3118 },
3065 "SearchReadGroupSetsResponse": { 3119 "Experiment": {
3066 "description": "The read group set search response.", 3120 "id": "Experiment",
3067 "id": "SearchReadGroupSetsResponse",
3068 "properties": { 3121 "properties": {
3069 "readGroupSets": { 3122 "sequencingCenter": {
3070 "description": "The list of matching read group sets.", 3123 "description": "The sequencing center used as part of this e xperiment.",
3071 "items": { 3124 "type": "string"
3072 "$ref": "ReadGroupSet"
3073 },
3074 "type": "array"
3075 }, 3125 },
3076 "nextPageToken": { 3126 "platformUnit": {
3077 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.", 3127 "description": "The platform unit used as part of this exper iment, for example\nflowcell-barcode.lane for Illumina or slide for SOLiD. Corre sponds to the\n@RG PU field in the SAM spec.",
3128 "type": "string"
3129 },
3130 "instrumentModel": {
3131 "description": "The instrument model used as part of this ex periment. This maps to\nsequencing technology in the SAM spec.",
3132 "type": "string"
3133 },
3134 "libraryId": {
3135 "description": "A client-supplied library identifier; a libr ary is a collection of DNA\nfragments which have been prepared for sequencing fr om a sample. This\nfield is important for quality control as error or bias can b e introduced\nduring sample preparation.",
3078 "type": "string" 3136 "type": "string"
3079 } 3137 }
3080 }, 3138 },
3081 "type": "object" 3139 "type": "object"
3082 }, 3140 },
3083 "SearchReferencesRequest": { 3141 "ListDatasetsResponse": {
3084 "id": "SearchReferencesRequest", 3142 "description": "The dataset list response.",
3143 "id": "ListDatasetsResponse",
3085 "properties": { 3144 "properties": {
3086 "pageToken": { 3145 "nextPageToken": {
3087 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.", 3146 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
3088 "type": "string" 3147 "type": "string"
3089 }, 3148 },
3090 "accessions": { 3149 "datasets": {
3091 "description": "If present, return references for which a pr efix of any of\nsourceAccessions match\nany of these strings. Accession numbers typically have a main number and a\nversion, for example `GCF_000001405.26`.", 3150 "description": "The list of matching Datasets.",
3092 "items": { 3151 "items": {
3093 "type": "string" 3152 "$ref": "Dataset"
3094 },
3095 "type": "array"
3096 },
3097 "pageSize": {
3098 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 1024. The maximum value is 4096.",
3099 "format": "int32",
3100 "type": "integer"
3101 },
3102 "referenceSetId": {
3103 "description": "If present, return only references which bel ong to this reference set.",
3104 "type": "string"
3105 },
3106 "md5checksums": {
3107 "description": "If present, return references for which the\ nmd5checksum matches exactly.",
3108 "items": {
3109 "type": "string"
3110 }, 3153 },
3111 "type": "array" 3154 "type": "array"
3112 } 3155 }
3113 }, 3156 },
3114 "type": "object" 3157 "type": "object"
3115 }, 3158 },
3116 "LinearAlignment": { 3159 "TestIamPermissionsRequest": {
3117 "description": "A linear alignment can be represented by one CIGAR s tring. Describes the\nmapped position and local alignment of the read to the ref erence.", 3160 "description": "Request message for `TestIamPermissions` method.",
3118 "id": "LinearAlignment", 3161 "id": "TestIamPermissionsRequest",
3119 "properties": { 3162 "properties": {
3120 "mappingQuality": { 3163 "permissions": {
3121 "description": "The mapping quality of this alignment. Repre sents how likely\nthe read maps to this position as opposed to other locations.\ n\nSpecifically, this is -10 log10 Pr(mapping position is wrong), rounded to\nth e nearest integer.", 3164 "description": "REQUIRED: The set of permissions to check fo r the 'resource'.\nPermissions with wildcards (such as '*' or 'storage.*') are n ot allowed.\nAllowed permissions are&#58;\n\n* `genomics.datasets.create`\n* `ge nomics.datasets.delete`\n* `genomics.datasets.get`\n* `genomics.datasets.list`\n * `genomics.datasets.update`\n* `genomics.datasets.getIamPolicy`\n* `genomics.da tasets.setIamPolicy`",
3122 "format": "int32",
3123 "type": "integer"
3124 },
3125 "cigar": {
3126 "description": "Represents the local alignment of this seque nce (alignment matches, indels,\netc) against the reference.",
3127 "items": {
3128 "$ref": "CigarUnit"
3129 },
3130 "type": "array"
3131 },
3132 "position": {
3133 "$ref": "Position",
3134 "description": "The position of this alignment."
3135 }
3136 },
3137 "type": "object"
3138 },
3139 "Dataset": {
3140 "description": "A Dataset is a collection of genomic data.\n\nFor mo re genomics resource definitions, see [Fundamentals of Google\nGenomics](https:/ /cloud.google.com/genomics/fundamentals-of-google-genomics)",
3141 "id": "Dataset",
3142 "properties": {
3143 "name": {
3144 "description": "The dataset name.",
3145 "type": "string"
3146 },
3147 "projectId": {
3148 "description": "The Google Cloud project ID that this datase t belongs to.",
3149 "type": "string"
3150 },
3151 "id": {
3152 "description": "The server-generated dataset ID, unique acro ss all datasets.",
3153 "type": "string"
3154 },
3155 "createTime": {
3156 "description": "The time this dataset was created, in second s from the epoch.",
3157 "format": "google-datetime",
3158 "type": "string"
3159 }
3160 },
3161 "type": "object"
3162 },
3163 "ImportVariantsResponse": {
3164 "description": "The variant data import response.",
3165 "id": "ImportVariantsResponse",
3166 "properties": {
3167 "callSetIds": {
3168 "description": "IDs of the call sets created during the impo rt.",
3169 "items": { 3165 "items": {
3170 "type": "string" 3166 "type": "string"
3171 }, 3167 },
3172 "type": "array" 3168 "type": "array"
3173 } 3169 }
3174 }, 3170 },
3175 "type": "object" 3171 "type": "object"
3176 }, 3172 },
3177 "ReadGroup": { 3173 "Exon": {
3178 "description": "A read group is all the data that's processed the sa me way by the sequencer.", 3174 "id": "Exon",
3179 "id": "ReadGroup",
3180 "properties": { 3175 "properties": {
3181 "info": { 3176 "start": {
3182 "additionalProperties": { 3177 "description": "The start position of the exon on this annot ation's reference sequence,\n0-based inclusive. Note that this is relative to th e reference start, and\n**not** the containing annotation start.",
3183 "items": { 3178 "format": "int64",
3184 "type": "any"
3185 },
3186 "type": "array"
3187 },
3188 "description": "A map of additional read group information. This must be of the form\nmap<string, string[]> (string key mapping to a list of string values).",
3189 "type": "object"
3190 },
3191 "id": {
3192 "description": "The server-generated read group ID, unique f or all read groups.\nNote: This is different than the @RG ID field in the SAM sp ec. For that\nvalue, see name.",
3193 "type": "string" 3179 "type": "string"
3194 }, 3180 },
3195 "programs": { 3181 "frame": {
3196 "description": "The programs used to generate this read grou p. Programs are always\nidentical for all read groups within a read group set. F or this reason,\nonly the first read group in a returned set will have this fiel d\npopulated.", 3182 "description": "The frame of this exon. Contains a value of 0, 1, or 2, which indicates\nthe offset of the first coding base of the exon wit hin the reading frame\nof the coding DNA sequence, if any. This field is depende nt on the\nstrandedness of this annotation (see\nAnnotation.reverse_strand).\nFo r forward stranded annotations, this offset is relative to the\nexon.start. For reverse\nstrand annotations, this offset is relative to the\nexon.end `- 1`.\n\n Unset if this exon does not intersect the coding sequence. Upon creation\nof a t ranscript, the frame must be populated for all or none of the\ncoding exons.",
3197 "items": {
3198 "$ref": "Program"
3199 },
3200 "type": "array"
3201 },
3202 "predictedInsertSize": {
3203 "description": "The predicted insert size of this read group . The insert size is the length\nthe sequenced DNA fragment from end-to-end, not including the adapters.",
3204 "format": "int32", 3183 "format": "int32",
3205 "type": "integer" 3184 "type": "integer"
3206 }, 3185 },
3207 "description": { 3186 "end": {
3208 "description": "A free-form text description of this read gr oup.", 3187 "description": "The end position of the exon on this annotat ion's reference sequence,\n0-based exclusive. Note that this is relative to the reference start, and\n*not* the containing annotation start.",
3209 "type": "string" 3188 "format": "int64",
3210 },
3211 "sampleId": {
3212 "description": "A client-supplied sample identifier for the reads in this read group.",
3213 "type": "string"
3214 },
3215 "datasetId": {
3216 "description": "The dataset to which this read group belongs .",
3217 "type": "string"
3218 },
3219 "experiment": {
3220 "$ref": "Experiment",
3221 "description": "The experiment used to generate this read gr oup."
3222 },
3223 "name": {
3224 "description": "The read group name. This corresponds to the @RG ID field in the SAM spec.",
3225 "type": "string"
3226 },
3227 "referenceSetId": {
3228 "description": "The reference set the reads in this read gro up are aligned to.",
3229 "type": "string" 3189 "type": "string"
3230 } 3190 }
3231 }, 3191 },
3232 "type": "object" 3192 "type": "object"
3233 }, 3193 },
3234 "ReadGroupSet": { 3194 "ExportReadGroupSetRequest": {
3235 "description": "A read group set is a logical collection of read gro ups, which are\ncollections of reads produced by a sequencer. A read group set t ypically\nmodels reads corresponding to one sample, sequenced one way, and align ed one\nway.\n\n* A read group set belongs to one dataset.\n* A read group belon gs to one read group set.\n* A read belongs to one read group.\n\nFor more genom ics resource definitions, see [Fundamentals of Google\nGenomics](https://cloud.g oogle.com/genomics/fundamentals-of-google-genomics)", 3195 "description": "The read group set export request.",
3236 "id": "ReadGroupSet", 3196 "id": "ExportReadGroupSetRequest",
3237 "properties": { 3197 "properties": {
3238 "datasetId": { 3198 "referenceNames": {
3239 "description": "The dataset to which this read group set bel ongs.", 3199 "description": "The reference names to export. If this is no t specified, all reference\nsequences, including unmapped reads, are exported.\n Use `*` to export only unmapped reads.",
3240 "type": "string"
3241 },
3242 "readGroups": {
3243 "description": "The read groups in this set. There are typic ally 1-10 read groups in a read\ngroup set.",
3244 "items": { 3200 "items": {
3245 "$ref": "ReadGroup" 3201 "type": "string"
3246 }, 3202 },
3247 "type": "array" 3203 "type": "array"
3248 }, 3204 },
3249 "filename": { 3205 "exportUri": {
3250 "description": "The filename of the original source file for this read group set, if any.", 3206 "description": "Required. A Google Cloud Storage URI for the exported BAM file.\nThe currently authenticated user must have write access to the new file.\nAn error will be returned if the URI already contains data.",
3207 "type": "string"
3208 },
3209 "projectId": {
3210 "description": "Required. The Google Cloud project ID that o wns this\nexport. The caller must have WRITE access to this project.",
3211 "type": "string"
3212 }
3213 },
3214 "type": "object"
3215 },
3216 "CallSet": {
3217 "description": "A call set is a collection of variant calls, typical ly for one sample. It\nbelongs to a variant set.\n\nFor more genomics resource d efinitions, see [Fundamentals of Google\nGenomics](https://cloud.google.com/geno mics/fundamentals-of-google-genomics)",
3218 "id": "CallSet",
3219 "properties": {
3220 "created": {
3221 "description": "The date this call set was created in millis econds from the epoch.",
3222 "format": "int64",
3223 "type": "string"
3224 },
3225 "sampleId": {
3226 "description": "The sample ID this call set corresponds to." ,
3251 "type": "string" 3227 "type": "string"
3252 }, 3228 },
3253 "name": { 3229 "name": {
3254 "description": "The read group set name. By default this wil l be initialized to the sample\nname of the sequenced data contained in this set .", 3230 "description": "The call set name.",
3255 "type": "string"
3256 },
3257 "referenceSetId": {
3258 "description": "The reference set to which the reads in this read group set are aligned.",
3259 "type": "string" 3231 "type": "string"
3260 }, 3232 },
3261 "info": { 3233 "info": {
3262 "additionalProperties": { 3234 "additionalProperties": {
3263 "items": { 3235 "items": {
3264 "type": "any" 3236 "type": "any"
3265 }, 3237 },
3266 "type": "array" 3238 "type": "array"
3267 }, 3239 },
3268 "description": "A map of additional read group set informati on.", 3240 "description": "A map of additional call set information. Th is must be of the form\nmap<string, string[]> (string key mapping to a list of s tring values).",
3269 "type": "object" 3241 "type": "object"
3270 }, 3242 },
3243 "variantSetIds": {
3244 "description": "The IDs of the variant sets this call set be longs to. This field must\nhave exactly length one, as a call set belongs to a s ingle variant set.\nThis field is repeated for compatibility with the\n[GA4GH 0. 5.1\nAPI](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/v ariants.avdl#L76).",
3245 "items": {
3246 "type": "string"
3247 },
3248 "type": "array"
3249 },
3271 "id": { 3250 "id": {
3272 "description": "The server-generated read group set ID, uniq ue for all read group sets.", 3251 "description": "The server-generated call set ID, unique acr oss all call sets.",
3273 "type": "string" 3252 "type": "string"
3274 } 3253 }
3275 }, 3254 },
3276 "type": "object" 3255 "type": "object"
3277 }, 3256 },
3278 "SearchVariantSetsResponse": { 3257 "SearchAnnotationSetsResponse": {
3279 "description": "The search variant sets response.", 3258 "id": "SearchAnnotationSetsResponse",
3280 "id": "SearchVariantSetsResponse", 3259 "properties": {
3281 "properties": {
3282 "variantSets": {
3283 "description": "The variant sets belonging to the requested dataset.",
3284 "items": {
3285 "$ref": "VariantSet"
3286 },
3287 "type": "array"
3288 },
3289 "nextPageToken": { 3260 "nextPageToken": {
3290 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.", 3261 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
3291 "type": "string" 3262 "type": "string"
3292 } 3263 },
3293 }, 3264 "annotationSets": {
3294 "type": "object" 3265 "description": "The matching annotation sets.",
3295 }, 3266 "items": {
3296 "Empty": { 3267 "$ref": "AnnotationSet"
3297 "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use i t as the request\nor the response type of an API method. For instance:\n\n se rvice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty );\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", 3268 },
3298 "id": "Empty", 3269 "type": "array"
3299 "properties": {}, 3270 }
3300 "type": "object" 3271 },
3301 }, 3272 "type": "object"
3302 "Entry": { 3273 },
3303 "id": "Entry", 3274 "ImportVariantsRequest": {
3304 "properties": { 3275 "description": "The variant data import request.",
3305 "annotation": { 3276 "id": "ImportVariantsRequest",
3306 "$ref": "Annotation", 3277 "properties": {
3307 "description": "The created annotation, if creation was succ essful." 3278 "infoMergeConfig": {
3308 }, 3279 "additionalProperties": {
3309 "status": { 3280 "enum": [
3310 "$ref": "Status", 3281 "INFO_MERGE_OPERATION_UNSPECIFIED",
3311 "description": "The creation status." 3282 "IGNORE_NEW",
3312 } 3283 "MOVE_TO_CALLS"
3313 }, 3284 ],
3314 "type": "object" 3285 "type": "string"
3315 }, 3286 },
3316 "Position": { 3287 "description": "A mapping between info field keys and the In foMergeOperations to\nbe performed on them. This is plumbed down to the MergeVar iantRequests\ngenerated by the resulting import job.",
3317 "description": "An abstraction for referring to a genomic position, in relation to some\nalready known reference. For now, represents a genomic posi tion as a\nreference name, a base number on that reference (0-based), and a\ndet ermination of forward or reverse strand.", 3288 "type": "object"
3318 "id": "Position", 3289 },
3319 "properties": { 3290 "sourceUris": {
3320 "reverseStrand": { 3291 "description": "A list of URIs referencing variant files in Google Cloud Storage. URIs can\ninclude wildcards [as described\nhere](https://c loud.google.com/storage/docs/gsutil/addlhelp/WildcardNames).\nNote that recursiv e wildcards ('**') are not supported.",
3321 "description": "Whether this position is on the reverse stra nd, as opposed to the forward\nstrand.", 3292 "items": {
3293 "type": "string"
3294 },
3295 "type": "array"
3296 },
3297 "variantSetId": {
3298 "description": "Required. The variant set to which variant d ata should be imported.",
3299 "type": "string"
3300 },
3301 "normalizeReferenceNames": {
3302 "description": "Convert reference names to the canonical rep resentation.\nhg19 haploytypes (those reference names containing \"_hap\")\nare not modified in any way.\nAll other reference names are modified according to th e following rules:\nThe reference name is capitalized.\nThe \"chr\" prefix is dr opped for all autosomes and sex chromsomes.\nFor example \"chr17\" becomes \"17\ " and \"chrX\" becomes \"X\".\nAll mitochondrial chromosomes (\"chrM\", \"chrMT\ ", etc) become \"MT\".",
3322 "type": "boolean" 3303 "type": "boolean"
3323 }, 3304 },
3324 "position": { 3305 "format": {
3325 "description": "The 0-based offset from the start of the for ward strand for that reference.", 3306 "description": "The format of the variant data being importe d. If unspecified, defaults to\nto `VCF`.",
3326 "format": "int64", 3307 "enum": [
3327 "type": "string" 3308 "FORMAT_UNSPECIFIED",
3328 }, 3309 "FORMAT_VCF",
3329 "referenceName": { 3310 "FORMAT_COMPLETE_GENOMICS"
3330 "description": "The name of the reference in whatever refere nce set is being used.", 3311 ],
3331 "type": "string" 3312 "enumDescriptions": [
3332 } 3313 "",
3333 }, 3314 "VCF (Variant Call Format). The VCF files may be gzip co mpressed. gVCF is\nalso supported. Disclaimer: gzip VCF imports are currently mu ch slower\nthan equivalent uncompressed VCF imports. For this reason, uncompress ed\nVCF is currently recommended for imports with more than 1GB combined\nuncomp ressed size, or for time sensitive imports.",
3334 "type": "object" 3315 "Complete Genomics masterVarBeta format. The masterVarBe ta files may\nbe bzip2 compressed."
3335 }, 3316 ],
3336 "SearchReferenceSetsResponse": { 3317 "type": "string"
3337 "id": "SearchReferenceSetsResponse", 3318 }
3338 "properties": { 3319 },
3339 "referenceSets": { 3320 "type": "object"
3340 "description": "The matching references sets.", 3321 },
3341 "items": { 3322 "VariantAnnotation": {
3342 "$ref": "ReferenceSet" 3323 "id": "VariantAnnotation",
3343 }, 3324 "properties": {
3344 "type": "array" 3325 "transcriptIds": {
3345 }, 3326 "description": "Google annotation IDs of the transcripts aff ected by this variant. These\nshould be provided when the variant is created.",
3327 "items": {
3328 "type": "string"
3329 },
3330 "type": "array"
3331 },
3332 "type": {
3333 "description": "Type has been adapted from ClinVar's list of variant types.",
3334 "enum": [
3335 "TYPE_UNSPECIFIED",
3336 "TYPE_OTHER",
3337 "INSERTION",
3338 "DELETION",
3339 "SUBSTITUTION",
3340 "SNP",
3341 "STRUCTURAL",
3342 "CNV"
3343 ],
3344 "enumDescriptions": [
3345 "",
3346 "`TYPE_OTHER` should be used when no other Type will suf fice.\nFurther explanation of the variant type may be included in the\ninfo fiel d.",
3347 "`INSERTION` indicates an insertion.",
3348 "`DELETION` indicates a deletion.",
3349 "`SUBSTITUTION` indicates a block substitution of\ntwo o r more nucleotides.",
3350 "`SNP` indicates a single nucleotide polymorphism.",
3351 "`STRUCTURAL` indicates a large structural variant,\ninc luding chromosomal fusions, inversions, etc.",
3352 "`CNV` indicates a variation in copy number."
3353 ],
3354 "type": "string"
3355 },
3356 "alternateBases": {
3357 "description": "The alternate allele for this variant. If mu ltiple alternate alleles\nexist at this location, create a separate variant for each one, as they\nmay represent distinct conditions.",
3358 "type": "string"
3359 },
3360 "geneId": {
3361 "description": "Google annotation ID of the gene affected by this variant. This should\nbe provided when the variant is created.",
3362 "type": "string"
3363 },
3364 "clinicalSignificance": {
3365 "description": "Describes the clinical significance of a var iant.\nIt is adapted from the ClinVar controlled vocabulary for clinical\nsignif icance described at:\nhttp://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/",
3366 "enum": [
3367 "CLINICAL_SIGNIFICANCE_UNSPECIFIED",
3368 "CLINICAL_SIGNIFICANCE_OTHER",
3369 "UNCERTAIN",
3370 "BENIGN",
3371 "LIKELY_BENIGN",
3372 "LIKELY_PATHOGENIC",
3373 "PATHOGENIC",
3374 "DRUG_RESPONSE",
3375 "HISTOCOMPATIBILITY",
3376 "CONFERS_SENSITIVITY",
3377 "RISK_FACTOR",
3378 "ASSOCIATION",
3379 "PROTECTIVE",
3380 "MULTIPLE_REPORTED"
3381 ],
3382 "enumDescriptions": [
3383 "",
3384 "`OTHER` should be used when no other clinical significa nce\nvalue will suffice.",
3385 "",
3386 "",
3387 "",
3388 "",
3389 "",
3390 "",
3391 "",
3392 "",
3393 "",
3394 "",
3395 "",
3396 "`MULTIPLE_REPORTED` should be used when multiple clinic al\nsignficances are reported for a variant. The original clinical\nsignificance values may be provided in the `info` field."
3397 ],
3398 "type": "string"
3399 },
3400 "conditions": {
3401 "description": "The set of conditions associated with this v ariant.\nA condition describes the way a variant influences human health.",
3402 "items": {
3403 "$ref": "ClinicalCondition"
3404 },
3405 "type": "array"
3406 },
3407 "effect": {
3408 "description": "Effect of the variant on the coding sequence .",
3409 "enum": [
3410 "EFFECT_UNSPECIFIED",
3411 "EFFECT_OTHER",
3412 "FRAMESHIFT",
3413 "FRAME_PRESERVING_INDEL",
3414 "SYNONYMOUS_SNP",
3415 "NONSYNONYMOUS_SNP",
3416 "STOP_GAIN",
3417 "STOP_LOSS",
3418 "SPLICE_SITE_DISRUPTION"
3419 ],
3420 "enumDescriptions": [
3421 "",
3422 "`EFFECT_OTHER` should be used when no other Effect\nwil l suffice.",
3423 "`FRAMESHIFT` indicates a mutation in which the insertio n or\ndeletion of nucleotides resulted in a frameshift change.",
3424 "`FRAME_PRESERVING_INDEL` indicates a mutation in which a\nmultiple of three nucleotides has been inserted or deleted, resulting\nin no change to the reading frame of the coding sequence.",
3425 "`SYNONYMOUS_SNP` indicates a single nucleotide polymorp hism\nmutation that results in no amino acid change.",
3426 "`NONSYNONYMOUS_SNP` indicates a single nucleotide\npoly morphism mutation that results in an amino acid change.",
3427 "`STOP_GAIN` indicates a mutation that leads to the crea tion\nof a stop codon at the variant site. Frameshift mutations creating\ndownst ream stop codons do not count as `STOP_GAIN`.",
3428 "`STOP_LOSS` indicates a mutation that eliminates a\nsto p codon at the variant site.",
3429 "`SPLICE_SITE_DISRUPTION` indicates that this variant is \nfound in a splice site for the associated transcript, and alters the\nnormal s plicing pattern."
3430 ],
3431 "type": "string"
3432 }
3433 },
3434 "type": "object"
3435 },
3436 "ListCoverageBucketsResponse": {
3437 "id": "ListCoverageBucketsResponse",
3438 "properties": {
3346 "nextPageToken": { 3439 "nextPageToken": {
3347 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.", 3440 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
3348 "type": "string" 3441 "type": "string"
3349 } 3442 },
3350 }, 3443 "bucketWidth": {
3351 "type": "object" 3444 "description": "The length of each coverage bucket in base p airs. Note that buckets at the\nend of a reference sequence may be shorter. This value is omitted if the\nbucket width is infinity (the default behaviour, with no range or\n`targetBucketWidth`).",
3352 }, 3445 "format": "int64",
3353 "SearchCallSetsRequest": { 3446 "type": "string"
3354 "description": "The call set search request.", 3447 },
3355 "id": "SearchCallSetsRequest", 3448 "coverageBuckets": {
3356 "properties": { 3449 "description": "The coverage buckets. The list of buckets is sparse; a bucket with 0\noverlapping reads is not returned. A bucket never cros ses more than one\nreference sequence. Each bucket has width `bucketWidth`, unle ss\nits end is the end of the reference sequence.",
3357 "pageToken": { 3450 "items": {
3358 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.", 3451 "$ref": "CoverageBucket"
3359 "type": "string" 3452 },
3360 }, 3453 "type": "array"
3361 "name": { 3454 }
3362 "description": "Only return call sets for which a substring of the name matches this\nstring.", 3455 },
3363 "type": "string" 3456 "type": "object"
3364 }, 3457 },
3365 "pageSize": { 3458 "ExportVariantSetRequest": {
3366 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 1024.", 3459 "description": "The variant data export request.",
3367 "format": "int32", 3460 "id": "ExportVariantSetRequest",
3368 "type": "integer" 3461 "properties": {
3369 }, 3462 "bigqueryTable": {
3370 "variantSetIds": { 3463 "description": "Required. The BigQuery table to export data to.\nIf the table doesn't exist, it will be created. If it already exists, it\nw ill be overwritten.",
3371 "description": "Restrict the query to call sets within the g iven variant sets. At least one\nID must be provided.", 3464 "type": "string"
3372 "items": { 3465 },
3373 "type": "string" 3466 "bigqueryDataset": {
3374 }, 3467 "description": "Required. The BigQuery dataset to export dat a to. This dataset must already\nexist. Note that this is distinct from the Geno mics concept of \"dataset\".",
3375 "type": "array" 3468 "type": "string"
3376 } 3469 },
3377 }, 3470 "format": {
3378 "type": "object" 3471 "description": "The format for the exported data.",
3379 }, 3472 "enum": [
3380 "ImportReadGroupSetsRequest": { 3473 "FORMAT_UNSPECIFIED",
3381 "description": "The read group set import request.", 3474 "FORMAT_BIGQUERY"
3382 "id": "ImportReadGroupSetsRequest", 3475 ],
3383 "properties": { 3476 "enumDescriptions": [
3384 "sourceUris": { 3477 "",
3385 "description": "A list of URIs pointing at [BAM\nfiles](http s://samtools.github.io/hts-specs/SAMv1.pdf)\nin Google Cloud Storage.\nThose URI s can include wildcards (*), but do not add or remove\nmatching files before imp ort has completed.\n\nNote that Google Cloud Storage object listing is only even tually\nconsistent: files added may be not be immediately visible to\neveryone. Thus, if using a wildcard it is preferable not to start\nthe import immediately after the files are created.", 3478 "Export the data to Google BigQuery."
3386 "items": { 3479 ],
3387 "type": "string" 3480 "type": "string"
3388 }, 3481 },
3389 "type": "array" 3482 "projectId": {
3390 }, 3483 "description": "Required. The Google Cloud project ID that o wns the destination\nBigQuery dataset. The caller must have WRITE access to this project. This\nproject will also own the resulting export job.",
3391 "referenceSetId": { 3484 "type": "string"
3392 "description": "The reference set to which the imported read group sets are aligned to, if\nany. The reference names of this reference set m ust be a superset of those\nfound in the imported file headers. If no reference set id is provided, a\nbest effort is made to associate with a matching referenc e set.", 3485 },
3393 "type": "string" 3486 "callSetIds": {
3394 }, 3487 "description": "If provided, only variant call information f rom the specified call sets\nwill be exported. By default all variant calls are exported.",
3395 "partitionStrategy": { 3488 "items": {
3396 "description": "The partition strategy describes how read gr oups are partitioned into read\ngroup sets.", 3489 "type": "string"
3397 "enum": [ 3490 },
3398 "PARTITION_STRATEGY_UNSPECIFIED", 3491 "type": "array"
3399 "PER_FILE_PER_SAMPLE", 3492 }
3400 "MERGE_ALL" 3493 },
3401 ], 3494 "type": "object"
3402 "enumDescriptions": [ 3495 },
3403 "", 3496 "SearchAnnotationsRequest": {
3404 "In most cases, this strategy yields one read group set per file. This is\nthe default behavior.\n\nAllocate one read group set per file per sample. For BAM files, read\ngroups are considered to share a sample if the y have identical sample\nnames. Furthermore, all reads for each file which do no t belong to a read\ngroup, if any, will be grouped into a single read group set per-file.", 3497 "id": "SearchAnnotationsRequest",
3405 "Includes all read groups in all imported files into a s ingle read group\nset. Requires that the headers for all imported files are equi valent. All\nreads which do not belong to a read group, if any, will be grouped into a\nseparate read group set." 3498 "properties": {
3406 ], 3499 "referenceName": {
3407 "type": "string" 3500 "description": "The name of the reference to query, within t he reference set associated\nwith this query.",
3408 }, 3501 "type": "string"
3409 "datasetId": { 3502 },
3410 "description": "Required. The ID of the dataset these read g roup sets will belong to. The\ncaller must have WRITE permissions to this datase t.", 3503 "referenceId": {
3411 "type": "string" 3504 "description": "The ID of the reference to query.",
3412 } 3505 "type": "string"
3413 }, 3506 },
3414 "type": "object"
3415 },
3416 "Policy": {
3417 "description": "Defines an Identity and Access Management (IAM) poli cy. It is used to\nspecify access control policies for Cloud Platform resources. \n\n\nA `Policy` consists of a list of `bindings`. A `Binding` binds a list of\n `members` to a `role`, where the members can be user accounts, Google groups,\nG oogle domains, and service accounts. A `role` is a named list of permissions\nde fined by IAM.\n\n**Example**\n\n {\n \"bindings\": [\n {\n \"role\": \"roles/owner\",\n \"members\": [\n \"user:mike @example.com\",\n \"group:admins@example.com\",\n \"domain :google.com\",\n \"serviceAccount:my-other-app@appspot.gserviceaccoun t.com\",\n ]\n },\n {\n \"role\": \"roles/viewer \",\n \"members\": [\"user:sean@example.com\"]\n }\n ]\n }\n\nFor a description of IAM and its features, see the\n[IAM developer's guide ](https://cloud.google.com/iam).",
3418 "id": "Policy",
3419 "properties": {
3420 "etag": {
3421 "description": "`etag` is used for optimistic concurrency co ntrol as a way to help\nprevent simultaneous updates of a policy from overwritin g each other.\nIt is strongly suggested that systems make use of the `etag` in t he\nread-modify-write cycle to perform policy updates in order to avoid race\nco nditions: An `etag` is returned in the response to `getIamPolicy`, and\nsystems are expected to put that etag in the request to `setIamPolicy` to\nensure that t heir change will be applied to the same version of the policy.\n\nIf no `etag` i s provided in the call to `setIamPolicy`, then the existing\npolicy is overwritt en blindly.",
3422 "format": "byte",
3423 "type": "string"
3424 },
3425 "version": {
3426 "description": "Version of the `Policy`. The default version is 0.",
3427 "format": "int32",
3428 "type": "integer"
3429 },
3430 "bindings": {
3431 "description": "Associates a list of `members` to a `role`.\ n`bindings` with no members will result in an error.",
3432 "items": {
3433 "$ref": "Binding"
3434 },
3435 "type": "array"
3436 }
3437 },
3438 "type": "object"
3439 },
3440 "Annotation": {
3441 "description": "An annotation describes a region of reference genome . The value of an\nannotation may be one of several canonical types, supplemente d by arbitrary\ninfo tags. An annotation is not inherently associated with a spe cific\nsample or individual (though a client could choose to use annotations in\ nthis way). Example canonical annotation types are `GENE` and\n`VARIANT`.",
3442 "id": "Annotation",
3443 "properties": {
3444 "end": { 3507 "end": {
3445 "description": "The end position of the range on the referen ce, 0-based exclusive.", 3508 "description": "The end position of the range on the referen ce, 0-based exclusive. If\nreferenceId or\nreferenceName\nmust be specified, Def aults to the length of the reference.",
3446 "format": "int64", 3509 "format": "int64",
3447 "type": "string" 3510 "type": "string"
3448 }, 3511 },
3449 "transcript": {
3450 "$ref": "Transcript",
3451 "description": "A transcript value represents the assertion that a particular region of\nthe reference genome may be transcribed as RNA. An alternative splicing\npattern would be represented as a separate transcript obje ct. This field\nis only set for annotations of type `TRANSCRIPT`."
3452 },
3453 "start": {
3454 "description": "The start position of the range on the refer ence, 0-based inclusive.",
3455 "format": "int64",
3456 "type": "string"
3457 },
3458 "annotationSetId": {
3459 "description": "The annotation set to which this annotation belongs.",
3460 "type": "string"
3461 },
3462 "name": {
3463 "description": "The display name of this annotation.",
3464 "type": "string"
3465 },
3466 "variant": {
3467 "$ref": "VariantAnnotation",
3468 "description": "A variant annotation, which describes the ef fect of a variant on the\ngenome, the coding sequence, and/or higher level conse quences at the\norganism level e.g. pathogenicity. This field is only set for an notations\nof type `VARIANT`."
3469 },
3470 "id": {
3471 "description": "The server-generated annotation ID, unique a cross all annotations.",
3472 "type": "string"
3473 },
3474 "referenceId": {
3475 "description": "The ID of the Google Genomics reference asso ciated with this range.",
3476 "type": "string"
3477 },
3478 "reverseStrand": {
3479 "description": "Whether this range refers to the reverse str and, as opposed to the forward\nstrand. Note that regardless of this field, the start/end position of the\nrange always refer to the forward strand.",
3480 "type": "boolean"
3481 },
3482 "referenceName": {
3483 "description": "The display name corresponding to the refere nce specified by\n`referenceId`, for example `chr1`, `1`, or `chrX`.",
3484 "type": "string"
3485 },
3486 "type": {
3487 "description": "The data type for this annotation. Must matc h the containing annotation\nset's type.",
3488 "enum": [
3489 "ANNOTATION_TYPE_UNSPECIFIED",
3490 "GENERIC",
3491 "VARIANT",
3492 "GENE",
3493 "TRANSCRIPT"
3494 ],
3495 "enumDescriptions": [
3496 "",
3497 "A `GENERIC` annotation type should be used when no othe r annotation\ntype will suffice. This represents an untyped annotation of the re ference\ngenome.",
3498 "A `VARIANT` annotation type.",
3499 "A `GENE` annotation type represents the existence of a gene at the\nassociated reference coordinates. The start coordinate is typically the\ngene's transcription start site and the end is typically the end of the\ng ene's last exon.",
3500 "A `TRANSCRIPT` annotation type represents the assertion that a\nparticular region of the reference genome may be transcribed as RNA."
3501 ],
3502 "type": "string"
3503 },
3504 "info": {
3505 "additionalProperties": {
3506 "items": {
3507 "type": "any"
3508 },
3509 "type": "array"
3510 },
3511 "description": "A map of additional read alignment informati on. This must be of the form\nmap<string, string[]> (string key mapping to a lis t of string values).",
3512 "type": "object"
3513 }
3514 },
3515 "type": "object"
3516 },
3517 "CancelOperationRequest": {
3518 "description": "The request message for Operations.CancelOperation." ,
3519 "id": "CancelOperationRequest",
3520 "properties": {},
3521 "type": "object"
3522 },
3523 "SearchReadsRequest": {
3524 "description": "The read search request.",
3525 "id": "SearchReadsRequest",
3526 "properties": {
3527 "end": {
3528 "description": "The end position of the range on the referen ce, 0-based exclusive. If\nspecified, `referenceName` must also be specified.",
3529 "format": "int64",
3530 "type": "string"
3531 },
3532 "pageToken": { 3512 "pageToken": {
3533 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.", 3513 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
3534 "type": "string" 3514 "type": "string"
3535 }, 3515 },
3536 "pageSize": { 3516 "pageSize": {
3537 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 256. The maximum value is 2048.", 3517 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 256. The maximum value is 2048.",
3538 "format": "int32", 3518 "format": "int32",
3539 "type": "integer" 3519 "type": "integer"
3540 }, 3520 },
3541 "start": { 3521 "start": {
3542 "description": "The start position of the range on the refer ence, 0-based inclusive. If\nspecified, `referenceName` must also be specified." , 3522 "description": "The start position of the range on the refer ence, 0-based inclusive. If\nspecified,\nreferenceId or\nreferenceName\nmust be specified. Defaults to 0.",
3543 "format": "int64", 3523 "format": "int64",
3544 "type": "string" 3524 "type": "string"
3545 }, 3525 },
3546 "referenceName": { 3526 "annotationSetIds": {
3547 "description": "The reference sequence name, for example `ch r1`, `1`, or `chrX`. If set to\n`*`, only unmapped reads are returned. If unspec ified, all reads (mapped\nand unmapped) are returned.", 3527 "description": "Required. The annotation sets to search with in. The caller must have\n`READ` access to these annotation sets.\nAll queried a nnotation sets must have the same type.",
3548 "type": "string"
3549 },
3550 "readGroupSetIds": {
3551 "description": "The IDs of the read groups sets within which to search for reads. All\nspecified read group sets must be aligned against a c ommon set of reference\nsequences; this defines the genomic coordinates for the query. Must specify\none of `readGroupSetIds` or `readGroupIds`.",
3552 "items": {
3553 "type": "string"
3554 },
3555 "type": "array"
3556 },
3557 "readGroupIds": {
3558 "description": "The IDs of the read groups within which to s earch for reads. All specified\nread groups must belong to the same read group s ets. Must specify one of\n`readGroupSetIds` or `readGroupIds`.",
3559 "items": { 3528 "items": {
3560 "type": "string" 3529 "type": "string"
3561 }, 3530 },
3562 "type": "array" 3531 "type": "array"
3563 } 3532 }
3564 }, 3533 },
3565 "type": "object" 3534 "type": "object"
3566 }, 3535 },
3567 "RuntimeMetadata": { 3536 "OperationEvent": {
3568 "description": "Runtime metadata that will be populated in the\nrunt imeMetadata\nfield of the Operation associated with a RunPipeline execution.", 3537 "description": "An event that occurred during an Operation.",
3569 "id": "RuntimeMetadata", 3538 "id": "OperationEvent",
3570 "properties": { 3539 "properties": {
3571 "computeEngine": { 3540 "endTime": {
3572 "$ref": "ComputeEngine", 3541 "description": "Optional time of when event finished. An eve nt can have a start time and no\nfinish time. If an event has a finish time, the re must be a start time.",
3573 "description": "Execution information specific to Google Com pute Engine." 3542 "format": "google-datetime",
3543 "type": "string"
3544 },
3545 "startTime": {
3546 "description": "Optional time of when event started.",
3547 "format": "google-datetime",
3548 "type": "string"
3549 },
3550 "description": {
3551 "description": "Required description of event.",
3552 "type": "string"
3574 } 3553 }
3575 }, 3554 },
3576 "type": "object" 3555 "type": "object"
3577 }, 3556 },
3578 "Operation": { 3557 "CodingSequence": {
3579 "description": "This resource represents a long-running operation th at is the result of a\nnetwork API call.", 3558 "id": "CodingSequence",
3580 "id": "Operation",
3581 "properties": { 3559 "properties": {
3582 "done": { 3560 "start": {
3583 "description": "If the value is `false`, it means the operat ion is still in progress.\nIf true, the operation is completed, and either `erro r` or `response` is\navailable.", 3561 "description": "The start of the coding sequence on this ann otation's reference sequence,\n0-based inclusive. Note that this position is rel ative to the reference\nstart, and *not* the containing annotation start.",
3584 "type": "boolean" 3562 "format": "int64",
3585 },
3586 "response": {
3587 "additionalProperties": {
3588 "description": "Properties of the object. Contains field @type with type URL.",
3589 "type": "any"
3590 },
3591 "description": "If importing ReadGroupSets, an ImportReadGro upSetsResponse is returned. If importing Variants, an ImportVariantsResponse is returned. For pipelines and exports, an empty response is returned.",
3592 "type": "object"
3593 },
3594 "name": {
3595 "description": "The server-assigned name, which is only uniq ue within the same service that originally returns it. For example&#58; `operati ons/CJHU7Oi_ChDrveSpBRjfuL-qzoWAgEw`",
3596 "type": "string" 3563 "type": "string"
3597 }, 3564 },
3598 "error": { 3565 "end": {
3599 "$ref": "Status", 3566 "description": "The end of the coding sequence on this annot ation's reference sequence,\n0-based exclusive. Note that this position is relat ive to the reference\nstart, and *not* the containing annotation start.",
3600 "description": "The error result of the operation in case of failure or cancellation." 3567 "format": "int64",
3601 }, 3568 "type": "string"
3602 "metadata": {
3603 "additionalProperties": {
3604 "description": "Properties of the object. Contains field @type with type URL.",
3605 "type": "any"
3606 },
3607 "description": "An OperationMetadata object. This will alway s be returned with the Operation.",
3608 "type": "object"
3609 } 3569 }
3610 }, 3570 },
3611 "type": "object" 3571 "type": "object"
3612 }, 3572 },
3613 "ImportReadGroupSetsResponse": { 3573 "SearchReferencesResponse": {
3614 "description": "The read group set import response.", 3574 "id": "SearchReferencesResponse",
3615 "id": "ImportReadGroupSetsResponse",
3616 "properties": { 3575 "properties": {
3617 "readGroupSetIds": { 3576 "nextPageToken": {
3618 "description": "IDs of the read group sets that were created .", 3577 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
3578 "type": "string"
3579 },
3580 "references": {
3581 "description": "The matching references.",
3582 "items": {
3583 "$ref": "Reference"
3584 },
3585 "type": "array"
3586 }
3587 },
3588 "type": "object"
3589 },
3590 "GetIamPolicyRequest": {
3591 "description": "Request message for `GetIamPolicy` method.",
3592 "id": "GetIamPolicyRequest",
3593 "properties": {},
3594 "type": "object"
3595 },
3596 "TestIamPermissionsResponse": {
3597 "description": "Response message for `TestIamPermissions` method.",
3598 "id": "TestIamPermissionsResponse",
3599 "properties": {
3600 "permissions": {
3601 "description": "A subset of `TestPermissionsRequest.permissi ons` that the caller is\nallowed.",
3619 "items": { 3602 "items": {
3620 "type": "string" 3603 "type": "string"
3621 }, 3604 },
3622 "type": "array" 3605 "type": "array"
3623 } 3606 }
3624 }, 3607 },
3625 "type": "object" 3608 "type": "object"
3626 }, 3609 },
3627 "VariantCall": { 3610 "SearchAnnotationSetsRequest": {
3628 "description": "A call represents the determination of genotype with respect to a particular\nvariant. It may include associated information such as quality and phasing.\nFor example, a call might assign a probability of 0.32 to the occurrence of\na SNP named rs1234 in a call set with the name NA12345.", 3611 "id": "SearchAnnotationSetsRequest",
3629 "id": "VariantCall",
3630 "properties": { 3612 "properties": {
3631 "genotypeLikelihood": { 3613 "pageToken": {
3632 "description": "The genotype likelihoods for this variant ca ll. Each array entry\nrepresents how likely a specific genotype is for this call . The value\nordering is defined by the GL tag in the VCF spec.\nIf Phred-scaled genotype likelihood scores (PL) are available and\nlog10(P) genotype likelihood scores (GL) are not, PL scores are converted\nto GL scores. If both are availa ble, PL scores are stored in `info`.", 3614 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
3615 "type": "string"
3616 },
3617 "pageSize": {
3618 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 128. The maximum value is 1024.",
3619 "format": "int32",
3620 "type": "integer"
3621 },
3622 "datasetIds": {
3623 "description": "Required. The dataset IDs to search within. Caller must have `READ` access\nto these datasets.",
3633 "items": { 3624 "items": {
3634 "format": "double", 3625 "type": "string"
3635 "type": "number"
3636 }, 3626 },
3637 "type": "array" 3627 "type": "array"
3638 }, 3628 },
3639 "callSetId": { 3629 "types": {
3640 "description": "The ID of the call set this variant call bel ongs to.", 3630 "description": "If specified, only annotation sets that have any of these types are\nreturned.",
3641 "type": "string" 3631 "enumDescriptions": [
3642 }, 3632 "",
3643 "genotype": { 3633 "A `GENERIC` annotation type should be used when no othe r annotation\ntype will suffice. This represents an untyped annotation of the re ference\ngenome.",
3644 "description": "The genotype of this variant call. Each valu e represents either the value\nof the `referenceBases` field or a 1-based index into\n`alternateBases`. If a variant had a `referenceBases`\nvalue of `T` and an `alternateBases`\nvalue of `[\"A\", \"C\"]`, and the `genotype` was\n`[2, 1]`, that would mean the call\nrepresented the heterozygous value `CA` for this varia nt.\nIf the `genotype` was instead `[0, 1]`, the\nrepresented value would be `TA `. Ordering of the\ngenotype values is important if the `phaseset` is present.\n If a genotype is not called (that is, a `.` is present in the\nGT string) -1 is returned.", 3634 "A `VARIANT` annotation type.",
3635 "A `GENE` annotation type represents the existence of a gene at the\nassociated reference coordinates. The start coordinate is typically the\ngene's transcription start site and the end is typically the end of the\ng ene's last exon.",
3636 "A `TRANSCRIPT` annotation type represents the assertion that a\nparticular region of the reference genome may be transcribed as RNA."
3637 ],
3645 "items": { 3638 "items": {
3646 "format": "int32", 3639 "enum": [
3647 "type": "integer" 3640 "ANNOTATION_TYPE_UNSPECIFIED",
3641 "GENERIC",
3642 "VARIANT",
3643 "GENE",
3644 "TRANSCRIPT"
3645 ],
3646 "type": "string"
3648 }, 3647 },
3649 "type": "array" 3648 "type": "array"
3650 }, 3649 },
3651 "phaseset": { 3650 "name": {
3652 "description": "If this field is present, this variant call' s genotype ordering implies\nthe phase of the bases and is consistent with any o ther variant calls in\nthe same reference sequence which have the same phaseset value.\nWhen importing data from VCF, if the genotype data was phased but no\nph ase set was specified this field will be set to `*`.", 3651 "description": "Only return annotations sets for which a sub string of the name matches this\nstring (case insensitive).",
3653 "type": "string" 3652 "type": "string"
3654 }, 3653 },
3655 "info": { 3654 "referenceSetId": {
3656 "additionalProperties": { 3655 "description": "If specified, only annotation sets associate d with the given reference set\nare returned.",
3657 "items": {
3658 "type": "any"
3659 },
3660 "type": "array"
3661 },
3662 "description": "A map of additional variant call information . This must be of the form\nmap<string, string[]> (string key mapping to a list of string values).",
3663 "type": "object"
3664 },
3665 "callSetName": {
3666 "description": "The name of the call set this variant call b elongs to.",
3667 "type": "string" 3656 "type": "string"
3668 } 3657 }
3669 }, 3658 },
3670 "type": "object" 3659 "type": "object"
3671 }, 3660 },
3672 "SearchVariantsResponse": { 3661 "SearchReadGroupSetsResponse": {
3673 "description": "The variant search response.", 3662 "description": "The read group set search response.",
3674 "id": "SearchVariantsResponse", 3663 "id": "SearchReadGroupSetsResponse",
3675 "properties": { 3664 "properties": {
3676 "variants": { 3665 "readGroupSets": {
3677 "description": "The list of matching Variants.", 3666 "description": "The list of matching read group sets.",
3678 "items": { 3667 "items": {
3679 "$ref": "Variant" 3668 "$ref": "ReadGroupSet"
3680 }, 3669 },
3681 "type": "array" 3670 "type": "array"
3682 }, 3671 },
3683 "nextPageToken": { 3672 "nextPageToken": {
3684 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.", 3673 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.",
3685 "type": "string" 3674 "type": "string"
3686 } 3675 }
3687 }, 3676 },
3688 "type": "object" 3677 "type": "object"
3689 }, 3678 },
3690 "ListBasesResponse": { 3679 "SearchReferencesRequest": {
3691 "id": "ListBasesResponse", 3680 "id": "SearchReferencesRequest",
3692 "properties": { 3681 "properties": {
3693 "sequence": { 3682 "md5checksums": {
3694 "description": "A substring of the bases that make up this r eference.", 3683 "description": "If present, return references for which the\ nmd5checksum matches exactly.",
3684 "items": {
3685 "type": "string"
3686 },
3687 "type": "array"
3688 },
3689 "pageToken": {
3690 "description": "The continuation token, which is used to pag e through large result sets.\nTo get the next page of results, set this paramete r to the value of\n`nextPageToken` from the previous response.",
3695 "type": "string" 3691 "type": "string"
3696 }, 3692 },
3697 "offset": { 3693 "accessions": {
3698 "description": "The offset position (0-based) of the given ` sequence` from the\nstart of this `Reference`. This value will differ for each p age\nin a paginated request.", 3694 "description": "If present, return references for which a pr efix of any of\nsourceAccessions match\nany of these strings. Accession numbers typically have a main number and a\nversion, for example `GCF_000001405.26`.",
3699 "format": "int64", 3695 "items": {
3700 "type": "string" 3696 "type": "string"
3697 },
3698 "type": "array"
3701 }, 3699 },
3702 "nextPageToken": { 3700 "pageSize": {
3703 "description": "The continuation token, which is used to pag e through large result sets.\nProvide this value in a subsequent request to retu rn the next page of\nresults. This field will be empty if there aren't any addit ional results.", 3701 "description": "The maximum number of results to return in a single page. If unspecified,\ndefaults to 1024. The maximum value is 4096.",
3702 "format": "int32",
3703 "type": "integer"
3704 },
3705 "referenceSetId": {
3706 "description": "If present, return only references which bel ong to this reference set.",
3704 "type": "string" 3707 "type": "string"
3705 } 3708 }
3706 }, 3709 },
3707 "type": "object" 3710 "type": "object"
3708 }, 3711 },
3709 "Status": { 3712 "LinearAlignment": {
3710 "description": "The `Status` type defines a logical error model that is suitable for different\nprogramming environments, including REST APIs and RP C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie ces of data: error code, error message,\nand error details. The error code shoul d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed. The\nerror message should be a developer-facing English message tha t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa cing\nerror message is needed, put the localized message in the error details or \nlocalize it in the client. The optional error details may contain arbitrary\ni nformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` that can be used for common error conditions.\n\n# Lang uage mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` mess age is\nexposed in different client libraries and different wire protocols, it c an be\nmapped differently. For example, it will likely be mapped to some excepti ons\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n \nThe error model and the `Status` message can be used in a variety of\nenvironm ents, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n - Partial errors. If a service needs to return partial errors to the client,\n it may embed the `Status` in the normal response to indicate the partial\n errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step m ay\n have a `Status` message for error reporting.\n\n- Batch operations. If a client uses batch request and batch response, the\n `Status` message should be used directly inside batch response, one for\n each error sub-response.\n\ n- Asynchronous operations. If an API call embeds asynchronous operation\n re sults in its response, the status of those operations should be\n represented directly using the `Status` message.\n\n- Logging. If some API errors are store d in logs, the message `Status` could\n be used directly after any stripping needed for security/privacy reasons.", 3713 "description": "A linear alignment can be represented by one CIGAR s tring. Describes the\nmapped position and local alignment of the read to the ref erence.",
3711 "id": "Status", 3714 "id": "LinearAlignment",
3712 "properties": { 3715 "properties": {
3713 "code": { 3716 "cigar": {
3714 "description": "The status code, which should be an enum val ue of google.rpc.Code.", 3717 "description": "Represents the local alignment of this seque nce (alignment matches, indels,\netc) against the reference.",
3718 "items": {
3719 "$ref": "CigarUnit"
3720 },
3721 "type": "array"
3722 },
3723 "position": {
3724 "$ref": "Position",
3725 "description": "The position of this alignment."
3726 },
3727 "mappingQuality": {
3728 "description": "The mapping quality of this alignment. Repre sents how likely\nthe read maps to this position as opposed to other locations.\ n\nSpecifically, this is -10 log10 Pr(mapping position is wrong), rounded to\nth e nearest integer.",
3715 "format": "int32", 3729 "format": "int32",
3716 "type": "integer" 3730 "type": "integer"
3717 },
3718 "message": {
3719 "description": "A developer-facing error message, which shou ld be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.",
3720 "type": "string"
3721 },
3722 "details": {
3723 "description": "A list of messages that carry the error deta ils. There is a common set of\nmessage types for APIs to use.",
3724 "items": {
3725 "additionalProperties": {
3726 "description": "Properties of the object. Contains f ield @type with type URL.",
3727 "type": "any"
3728 },
3729 "type": "object"
3730 },
3731 "type": "array"
3732 } 3731 }
3733 }, 3732 },
3734 "type": "object" 3733 "type": "object"
3735 }, 3734 },
3736 "Binding": { 3735 "Dataset": {
3737 "description": "Associates `members` with a `role`.", 3736 "description": "A Dataset is a collection of genomic data.\n\nFor mo re genomics resource definitions, see [Fundamentals of Google\nGenomics](https:/ /cloud.google.com/genomics/fundamentals-of-google-genomics)",
3738 "id": "Binding", 3737 "id": "Dataset",
3739 "properties": { 3738 "properties": {
3740 "members": { 3739 "id": {
3741 "description": "Specifies the identities requesting access f or a Cloud Platform resource.\n`members` can have the following values:\n\n* `al lUsers`: A special identifier that represents anyone who is\n on the internet; with or without a Google account.\n\n* `allAuthenticatedUsers`: A special ident ifier that represents anyone\n who is authenticated with a Google account or a service account.\n\n* `user:{emailid}`: An email address that represents a spec ific Google\n account. For example, `alice@gmail.com` or `joe@example.com`.\n\ n\n* `serviceAccount:{emailid}`: An email address that represents a service\n account. For example, `my-other-app@appspot.gserviceaccount.com`.\n\n* `group:{e mailid}`: An email address that represents a Google group.\n For example, `adm ins@example.com`.\n\n\n* `domain:{domain}`: A Google Apps domain name that repre sents all the\n users of that domain. For example, `google.com` or `example.co m`.\n\n", 3740 "description": "The server-generated dataset ID, unique acro ss all datasets.",
3742 "items": { 3741 "type": "string"
3743 "type": "string"
3744 },
3745 "type": "array"
3746 }, 3742 },
3747 "role": { 3743 "createTime": {
3748 "description": "Role that is assigned to `members`.\nFor exa mple, `roles/viewer`, `roles/editor`, or `roles/owner`.\nRequired", 3744 "description": "The time this dataset was created, in second s from the epoch.",
3745 "format": "google-datetime",
3746 "type": "string"
3747 },
3748 "name": {
3749 "description": "The dataset name.",
3750 "type": "string"
3751 },
3752 "projectId": {
3753 "description": "The Google Cloud project ID that this datase t belongs to.",
3749 "type": "string" 3754 "type": "string"
3750 } 3755 }
3751 }, 3756 },
3752 "type": "object" 3757 "type": "object"
3753 },
3754 "UndeleteDatasetRequest": {
3755 "id": "UndeleteDatasetRequest",
3756 "properties": {},
3757 "type": "object"
3758 } 3758 }
3759 }, 3759 },
3760 "servicePath": "", 3760 "servicePath": "",
3761 "title": "Genomics API", 3761 "title": "Genomics API",
3762 "version": "v1" 3762 "version": "v1"
3763 } 3763 }
OLDNEW
« no previous file with comments | « discovery/googleapis/games__v1.json ('k') | discovery/googleapis/gmail__v1.json » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698