Api-roll 33: 2016-03-14

discovery/googleapis/genomics__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/bigquery": {
                     "description": "View and manage your data in Google BigQuery"
                 },
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/devstorage.read_write": {
                     "description": "Manage your data in Google Cloud Storage"
                 },
                 "https://www.googleapis.com/auth/genomics": {
                     "description": "View and manage Genomics data"
                 },
                 "https://www.googleapis.com/auth/genomics.readonly": {
                     "description": "View Genomics data"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://genomics.googleapis.com/",
     "batchPath": "batch",
-    "description": "An API to store, process, explore, and share genomic data. It supports reference-based alignments, genetic variants, and reference genomes. This API provides an implementation of the Global Alliance for Genomics and Health (GA4GH) v0.5.1 API as well as several extensions.",
+    "description": "Stores, processes, explores and shares genomic data. This API implements the Global Alliance for Genomics and Health (GA4GH) v0.5.1 API as well as several extensions.",
     "discoveryVersion": "v1",
     "documentationLink": "",
-    "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/dKN-qLgalAAFQaYkGpbmBfZPnMw\"",
+    "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/qCQMvlo_ZXGIICMrFbqIqkBC444\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "genomics:v1",
     "kind": "discovery#restDescription",
     "name": "genomics",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 940 matching lines @@
                     "path": "v1/variants/{variantId}",
                     "response": {
                         "$ref": "Variant"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/genomics",
                         "https://www.googleapis.com/auth/genomics.readonly"
                     ]
                 },
+                "merge": {
+                    "description": "Merges the given variants with existing variants. For the definitions of variants and other genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) Each variant will be merged with an existing variant that matches its reference sequence, start, end, reference bases, and alternative bases. If no such variant exists, a new one will be created. When variants are merged, the call information from the new variant is added to the existing variant, and other fields (such as key/value pairs) are discarded.",
+                    "httpMethod": "POST",
+                    "id": "genomics.variants.merge",
+                    "path": "v1/variants:merge",
+                    "request": {
+                        "$ref": "MergeVariantsRequest"
+                    },
+                    "response": {
+                        "$ref": "Empty"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/genomics"
+                    ]
+                },
                 "stream": {
                     "description": "Returns a stream of all the variants matching the search request, ordered by reference name, position, and ID.",
                     "httpMethod": "POST",
                     "id": "genomics.variants.stream",
                     "path": "v1/variants:stream",
                     "request": {
                         "$ref": "StreamVariantsRequest"
                     },
                     "response": {
                         "$ref": "StreamVariantsResponse"
@@ skipping 87 matching lines @@
                     "response": {
                         "$ref": "SearchVariantSetsResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/genomics",
                         "https://www.googleapis.com/auth/genomics.readonly"
                     ]
                 },
                 "delete": {
-                    "description": "Deletes the contents of a variant set. The variant set object is not deleted. For the definitions of variant sets and other genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
+                    "description": "Deletes a variant set including all variants, call sets, and calls within. This is not reversible. For the definitions of variant sets and other genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
                     "httpMethod": "DELETE",
                     "id": "genomics.variantsets.delete",
                     "parameterOrder": [
                         "variantSetId"
                     ],
                     "parameters": {
                         "variantSetId": {
                             "description": "The ID of the variant set to be deleted.",
                             "location": "path",
                             "required": true,
@@ skipping 155 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/genomics",
                         "https://www.googleapis.com/auth/genomics.readonly"
                     ]
                 }
             }
         }
     },
-    "revision": "20160124",
+    "revision": "20160309",
     "rootUrl": "https://genomics.googleapis.com/",
     "schemas": {
         "ListDatasetsResponse": {
             "description": "The dataset list response.",
             "id": "ListDatasetsResponse",
             "properties": {
                 "datasets": {
                     "description": "The list of matching Datasets.",
                     "items": {
                         "$ref": "Dataset"
@@ skipping 44 matching lines @@
             "id": "SetIamPolicyRequest",
             "properties": {
                 "policy": {
                     "$ref": "Policy",
                     "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them."
                 }
             },
             "type": "object"
         },
         "Policy": {
-            "description": "Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { \"bindings\": [ { \"role\": \"roles/owner\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-other-app@appspot.gserviceaccount.com\"] }, { \"role\": \"roles/viewer\", \"members\": [\"user:sean@example.com\"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).",
+            "description": "Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { \"bindings\": [ { \"role\": \"roles/owner\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-other-app@appspot.gserviceaccount.com\", ] }, { \"role\": \"roles/viewer\", \"members\": [\"user:sean@example.com\"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).",
             "id": "Policy",
             "properties": {
                 "version": {
                     "description": "Version of the `Policy`. The default version is 0.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "bindings": {
                     "description": "Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.",
                     "items": {
@@ skipping 693 matching lines @@
                 },
                 "start": {
                     "description": "The start position of the range on the reference, 0-based inclusive. If specified, `referenceName` must also be specified.",
                     "format": "int64",
                     "type": "string"
                 },
                 "end": {
                     "description": "The end position of the range on the reference, 0-based exclusive. If specified, `referenceName` must also be specified.",
                     "format": "int64",
                     "type": "string"
+                },
+                "shard": {
+                    "description": "Restricts results to a shard containing approximately `1/totalShards` of the normal response payload for this query. Results from a sharded request are disjoint from those returned by all queries which differ only in their shard parameter. A shard may yield 0 results; this is especially likely for large values of `totalShards`. Valid values are `[0, totalShards)`.",
+                    "format": "int32",
+                    "type": "integer"
+                },
+                "totalShards": {
+                    "description": "Specifying `totalShards` causes a disjoint subset of the normal response payload to be returned for each query with a unique `shard` parameter specified. A best effort is made to yield equally sized shards. Sharding can be used to distribute processing amongst workers, where each worker is assigned a unique `shard` number and all workers specify the same `totalShards` number. The union of reads returned for all sharded queries `[0, totalShards)` is equal to those returned by a single unsharded query. Queries for different values of `totalShards` with common divisors will share shard boundaries. For example, streaming `shard` 2 of 5 `totalShards` yields the same results as streaming `shard`s 4 and 5 of 10 `totalShards`. This property can be leveraged for adaptive retries.",
+                    "format": "int32",
+                    "type": "integer"
                 }
             },
             "type": "object"
         },
         "StreamReadsResponse": {
             "id": "StreamReadsResponse",
             "properties": {
                 "alignments": {
                     "items": {
                         "$ref": "Read"
@@ skipping 270 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "ReferenceBound": {
             "description": "ReferenceBound records an upper bound for the starting coordinate of variants in a particular reference.",
             "id": "ReferenceBound",
             "properties": {
                 "referenceName": {
-                    "description": "The name of the reference associated with this ReferenceBound.",
+                    "description": "The name of the reference associated with this reference bound.",
                     "type": "string"
                 },
                 "upperBound": {
                     "description": "An upper bound (inclusive) on the starting coordinate of any variant in the reference sequence.",
                     "format": "int64",
                     "type": "string"
                 }
             },
             "type": "object"
         },
@@ skipping 160 matching lines @@
                 "pageToken": {
                     "description": "The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of `nextPageToken` from the previous response.",
                     "type": "string"
                 },
                 "pageSize": {
                     "description": "The maximum number of variants to return in a single page. If unspecified, defaults to 5000. The maximum value is 10000.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "maxCalls": {
-                    "description": "The maximum number of calls to return in a single page. Note that this limit may be exceeded; at least one variant is always returned per page, even if it has more calls than this limit. If unspecified, defaults to 5000. The maximum value is 10000.",
+                    "description": "The maximum number of calls to return in a single page. Note that this limit may be exceeded in the event that a matching variant contains more calls than the requested maximum. If unspecified, defaults to 5000. The maximum value is 10000.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "SearchVariantsResponse": {
             "description": "The variant search response.",
             "id": "SearchVariantsResponse",
             "properties": {
@@ skipping 130 matching lines @@
                             "type": "any"
                         },
                         "type": "array"
                     },
                     "description": "A map of additional variant call information. This must be of the form map (string key mapping to a list of string values).",
                     "type": "object"
                 }
             },
             "type": "object"
         },
+        "MergeVariantsRequest": {
+            "id": "MergeVariantsRequest",
+            "properties": {
+                "variantSetId": {
+                    "description": "The destination variant set.",
+                    "type": "string"
+                },
+                "variants": {
+                    "description": "The variants to be merged with existing variants.",
+                    "items": {
+                        "$ref": "Variant"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
         "SearchCallSetsRequest": {
             "description": "The call set search request.",
             "id": "SearchCallSetsRequest",
             "properties": {
                 "variantSetIds": {
                     "description": "Restrict the query to call sets within the given variant sets. At least one ID must be provided.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
@@ skipping 188 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Genomics API",
     "version": "v1"
 }