Api-roll 42: 2016-11-08

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": "Stores, processes, explores and shares genomic data.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/genomics/",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/-uskoNWve9HRJ6Bj84XG9zPKo3o\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/jo14IJ9oMjJmju16_ICU62ty30c\"",
     "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 330 matching lines @@
             }
         },
         "datasets": {
             "methods": {
                 "list": {
                     "description": "Lists datasets within a project. For the definitions of datasets and other genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
                     "httpMethod": "GET",
                     "id": "genomics.datasets.list",
                     "parameters": {
                         "projectId": {
-                            "description": "Required. The project to list datasets for.",
+                            "description": "Required. The Google Cloud project ID to list datasets for.",
                             "location": "query",
                             "type": "string"
                         },
                         "pageSize": {
                             "description": "The maximum number of results to return in a single page. If unspecified, defaults to 50. The maximum value is 1024.",
                             "format": "int32",
                             "location": "query",
                             "type": "integer"
                         },
                         "pageToken": {
@@ skipping 140 matching lines @@
                     "description": "Sets the access control policy on the specified dataset. Replaces any existing policy. For the definitions of datasets and other genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics) See Setting a Policy for more information.",
                     "httpMethod": "POST",
                     "id": "genomics.datasets.setIamPolicy",
                     "parameterOrder": [
                         "resource"
                     ],
                     "parameters": {
                         "resource": {
                             "description": "REQUIRED: The resource for which policy is being specified. Format is `datasets/`.",
                             "location": "path",
-                            "pattern": "^datasets/[^/]*$",
+                            "pattern": "^datasets/[^/]+$",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/{+resource}:setIamPolicy",
                     "request": {
                         "$ref": "SetIamPolicyRequest"
                     },
                     "response": {
                         "$ref": "Policy"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/genomics"
                     ]
                 },
                 "getIamPolicy": {
                     "description": "Gets the access control policy for the dataset. This is empty if the policy or resource does not exist. See Getting a Policy for more information. For the definitions of datasets and other genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
                     "httpMethod": "POST",
                     "id": "genomics.datasets.getIamPolicy",
                     "parameterOrder": [
                         "resource"
                     ],
                     "parameters": {
                         "resource": {
                             "description": "REQUIRED: The resource for which policy is being specified. Format is `datasets/`.",
                             "location": "path",
-                            "pattern": "^datasets/[^/]*$",
+                            "pattern": "^datasets/[^/]+$",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/{+resource}:getIamPolicy",
                     "request": {
                         "$ref": "GetIamPolicyRequest"
                     },
                     "response": {
                         "$ref": "Policy"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/genomics"
                     ]
                 },
                 "testIamPermissions": {
                     "description": "Returns permissions that a caller has on the specified resource. See Testing Permissions for more information. For the definitions of datasets and other genomics resources, see [Fundamentals of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
                     "httpMethod": "POST",
                     "id": "genomics.datasets.testIamPermissions",
                     "parameterOrder": [
                         "resource"
                     ],
                     "parameters": {
                         "resource": {
                             "description": "REQUIRED: The resource for which policy is being specified. Format is `datasets/`.",
                             "location": "path",
-                            "pattern": "^datasets/[^/]*$",
+                            "pattern": "^datasets/[^/]+$",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/{+resource}:testIamPermissions",
                     "request": {
                         "$ref": "TestIamPermissionsRequest"
                     },
                     "response": {
                         "$ref": "TestIamPermissionsResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/genomics"
                     ]
                 }
             }
         },
         "operations": {
             "methods": {
-                "get": {
-                    "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
-                    "httpMethod": "GET",
-                    "id": "genomics.operations.get",
-                    "parameterOrder": [
-                        "name"
-                    ],
-                    "parameters": {
-                        "name": {
-                            "description": "The name of the operation resource.",
-                            "location": "path",
-                            "pattern": "^operations/.*$",
-                            "required": true,
-                            "type": "string"
-                        }
-                    },
-                    "path": "v1/{+name}",
-                    "response": {
-                        "$ref": "Operation"
-                    },
-                    "scopes": [
-                        "https://www.googleapis.com/auth/cloud-platform",
-                        "https://www.googleapis.com/auth/genomics"
-                    ]
-                },
                 "list": {
                     "description": "Lists operations that match the specified filter in the request.",
                     "httpMethod": "GET",
                     "id": "genomics.operations.list",
                     "parameterOrder": [
                         "name"
                     ],
                     "parameters": {
                         "name": {
                             "description": "The name of the operation collection.",
                             "location": "path",
                             "pattern": "^operations$",
                             "required": true,
                             "type": "string"
                         },
                         "filter": {
-                            "description": "A string for filtering Operations. The following filter fields are supported: * projectId: Required. Corresponds to OperationMetadata.projectId. * createTime: The time this job was created, in seconds from the [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `= 1432140000` * `projectId = my-project AND createTime >= 1432140000 AND createTime <= 1432150000 AND status = RUNNING`",
+                            "description": "A string for filtering Operations. The following filter fields are supported: * projectId: Required. Corresponds to OperationMetadata.projectId. * createTime: The time this job was created, in seconds from the [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `= 1432140000` * `projectId = my-project AND createTime >= 1432140000 AND createTime <= 1432150000 AND status = RUNNING` * `projectId = my-project AND labels.color = *` * `projectId = my-project AND labels.color = red`",
                             "location": "query",
                             "type": "string"
                         },
                         "pageSize": {
                             "description": "The maximum number of results to return. If unspecified, defaults to 256. The maximum value is 2048.",
                             "format": "int32",
                             "location": "query",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "The standard list page token.",
                             "location": "query",
                             "type": "string"
                         }
                     },
                     "path": "v1/{+name}",
                     "response": {
                         "$ref": "ListOperationsResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/genomics"
                     ]
                 },
+                "get": {
+                    "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
+                    "httpMethod": "GET",
+                    "id": "genomics.operations.get",
+                    "parameterOrder": [
+                        "name"
+                    ],
+                    "parameters": {
+                        "name": {
+                            "description": "The name of the operation resource.",
+                            "location": "path",
+                            "pattern": "^operations/.+$",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "v1/{+name}",
+                    "response": {
+                        "$ref": "Operation"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/genomics"
+                    ]
+                },
                 "cancel": {
                     "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. Clients may use Operations.GetOperation or Operations.ListOperations to check whether the cancellation succeeded or the operation completed despite cancellation.",
                     "httpMethod": "POST",
                     "id": "genomics.operations.cancel",
                     "parameterOrder": [
                         "name"
                     ],
                     "parameters": {
                         "name": {
                             "description": "The name of the operation resource to be cancelled.",
                             "location": "path",
-                            "pattern": "^operations/.*$",
+                            "pattern": "^operations/.+$",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/{+name}:cancel",
                     "request": {
                         "$ref": "CancelOperationRequest"
                     },
                     "response": {
                         "$ref": "Empty"
@@ skipping 825 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/genomics",
                         "https://www.googleapis.com/auth/genomics.readonly"
                     ]
                 }
             }
         }
     },
-    "revision": "20160824",
+    "revision": "20160928",
     "rootUrl": "https://genomics.googleapis.com/",
     "schemas": {
         "AnnotationSet": {
             "description": "An annotation set is a logical grouping of annotations that share consistent type information and provenance. Examples of annotation sets include 'all genes from refseq', and 'all variant annotations from ClinVar'.",
             "id": "AnnotationSet",
             "properties": {
                 "id": {
                     "description": "The server-generated annotation set ID, unique across all annotation sets.",
                     "type": "string"
                 },
@@ skipping 506 matching lines @@
         },
         "Dataset": {
             "description": "A Dataset is a collection of genomic data. For more genomics resource definitions, see [Fundamentals of Google Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)",
             "id": "Dataset",
             "properties": {
                 "id": {
                     "description": "The server-generated dataset ID, unique across all datasets.",
                     "type": "string"
                 },
                 "projectId": {
-                    "description": "The Google Developers Console project ID that this dataset belongs to.",
+                    "description": "The Google Cloud project ID that this dataset belongs to.",
                     "type": "string"
                 },
                 "name": {
                     "description": "The dataset name.",
                     "type": "string"
                 },
                 "createTime": {
                     "description": "The time this dataset was created, in seconds from the epoch.",
                     "type": "string"
                 }
@@ skipping 83 matching lines @@
                 "permissions": {
                     "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
+        "ListOperationsResponse": {
+            "description": "The response message for Operations.ListOperations.",
+            "id": "ListOperationsResponse",
+            "properties": {
+                "operations": {
+                    "description": "A list of operations that matches the specified filter in the request.",
+                    "items": {
+                        "$ref": "Operation"
+                    },
+                    "type": "array"
+                },
+                "nextPageToken": {
+                    "description": "The standard List next-page token.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "Operation": {
             "description": "This resource represents a long-running operation that is the result of a network API call.",
             "id": "Operation",
             "properties": {
                 "name": {
                     "description": "The server-assigned name, which is only unique within the same service that originally returns it. For example: `operations/CJHU7Oi_ChDrveSpBRjfuL-qzoWAgEw`",
                     "type": "string"
                 },
                 "metadata": {
                     "additionalProperties": {
                         "description": "Properties of the object. Contains field @type with type URL.",
                         "type": "any"
                     },
                     "description": "An OperationMetadata object. This will always be returned with the Operation.",
                     "type": "object"
                 },
                 "done": {
                     "description": "If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.",
                     "type": "boolean"
                 },
                 "error": {
                     "$ref": "Status",
-                    "description": "The error result of the operation in case of failure."
+                    "description": "The error result of the operation in case of failure or cancellation."
                 },
                 "response": {
                     "additionalProperties": {
                         "description": "Properties of the object. Contains field @type with type URL.",
                         "type": "any"
                     },
                     "description": "If importing ReadGroupSets, an ImportReadGroupSetsResponse is returned. If importing Variants, an ImportVariantsResponse is returned. For exports, an empty response is returned.",
                     "type": "object"
                 }
             },
             "type": "object"
         },
-        "ListOperationsResponse": {
-            "description": "The response message for Operations.ListOperations.",
-            "id": "ListOperationsResponse",
-            "properties": {
-                "operations": {
-                    "description": "A list of operations that matches the specified filter in the request.",
-                    "items": {
-                        "$ref": "Operation"
-                    },
-                    "type": "array"
-                },
-                "nextPageToken": {
-                    "description": "The standard List next-page token.",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
         "CancelOperationRequest": {
             "description": "The request message for Operations.CancelOperation.",
             "id": "CancelOperationRequest",
             "type": "object"
         },
         "ImportReadGroupSetsRequest": {
             "description": "The read group set import request.",
             "id": "ImportReadGroupSetsRequest",
             "properties": {
                 "datasetId": {
@@ skipping 21 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ExportReadGroupSetRequest": {
             "description": "The read group set export request.",
             "id": "ExportReadGroupSetRequest",
             "properties": {
                 "projectId": {
-                    "description": "Required. The Google Developers Console project ID that owns this export. The caller must have WRITE access to this project.",
+                    "description": "Required. The Google Cloud project ID that owns this export. The caller must have WRITE access to this project.",
                     "type": "string"
                 },
                 "exportUri": {
                     "description": "Required. A Google Cloud Storage URI for the exported BAM file. The currently authenticated user must have write access to the new file. An error will be returned if the URI already contains data.",
                     "type": "string"
                 },
                 "referenceNames": {
                     "description": "The reference names to export. If this is not specified, all reference sequences, including unmapped reads, are exported. Use `*` to export only unmapped reads.",
                     "items": {
                         "type": "string"
@@ skipping 478 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "StreamReadsRequest": {
             "description": "The stream reads request.",
             "id": "StreamReadsRequest",
             "properties": {
                 "projectId": {
-                    "description": "The Google Developers Console project ID or number which will be billed for this access. The caller must have WRITE access to this project. Required.",
+                    "description": "The Google Cloud project ID which will be billed for this access. The caller must have WRITE access to this project. Required.",
                     "type": "string"
                 },
                 "readGroupSetId": {
                     "description": "The ID of the read group set from which to stream reads.",
                     "type": "string"
                 },
                 "referenceName": {
                     "description": "The reference sequence name, for example `chr1`, `1`, or `chrX`. If set to *, only unmapped reads are returned.",
                     "type": "string"
                 },
@@ skipping 771 matching lines @@
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "StreamVariantsRequest": {
             "description": "The stream variants request.",
             "id": "StreamVariantsRequest",
             "properties": {
                 "projectId": {
-                    "description": "The Google Developers Console project ID or number which will be billed for this access. The caller must have WRITE access to this project. Required.",
+                    "description": "The Google Cloud project ID which will be billed for this access. The caller must have WRITE access to this project. Required.",
                     "type": "string"
                 },
                 "variantSetId": {
                     "description": "The variant set ID from which to stream variants.",
                     "type": "string"
                 },
                 "callSetIds": {
                     "description": "Only return variant calls which belong to call sets with these IDs. Leaving this blank returns all variant calls.",
                     "items": {
                         "type": "string"
@@ skipping 86 matching lines @@
                     "type": "object"
                 },
                 "events": {
                     "description": "Optional event messages that were generated during the job's execution. This also contains any warnings that were generated during import or export.",
                     "items": {
                         "$ref": "OperationEvent"
                     },
                     "type": "array"
                 },
                 "clientId": {
-                    "description": "Optionally provided by the caller when submitting the request that creates the operation.",
+                    "description": "This field is deprecated. Use `labels` instead. Optionally provided by the caller when submitting the request that creates the operation.",
                     "type": "string"
                 },
                 "runtimeMetadata": {
                     "additionalProperties": {
                         "description": "Properties of the object. Contains field @type with type URL.",
                         "type": "any"
                     },
                     "description": "Runtime metadata on this Operation.",
                     "type": "object"
+                },
+                "labels": {
+                    "additionalProperties": {
+                        "type": "string"
+                    },
+                    "description": "Optionally provided by the caller when submitting the request that creates the operation.",
+                    "type": "object"
                 }
             },
             "type": "object"
         },
         "OperationEvent": {
             "description": "An event that occurred during an Operation.",
             "id": "OperationEvent",
             "properties": {
                 "startTime": {
                     "description": "Optional time of when event started.",
@@ skipping 45 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Genomics API",
     "version": "v1"
 }