Api-roll 42: 2016-11-08

discovery/googleapis/bigquery__v2.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/bigquery": {
                     "description": "View and manage your data in Google BigQuery"
                 },
                 "https://www.googleapis.com/auth/bigquery.insertdata": {
                     "description": "Insert data into Google BigQuery"
                 },
@@ skipping 14 matching lines @@
                 }
             }
         }
     },
     "basePath": "/bigquery/v2/",
     "baseUrl": "https://www.googleapis.com/bigquery/v2/",
     "batchPath": "batch",
     "description": "A data platform for customers to create, manage, share and query data.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/bigquery/",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/Ib6OxmyUT7luxrAe5VQ1tJgZykA\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/38ec4LBichi45rs7Z88p5kE7xpM\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/search-16.gif",
         "x32": "https://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "bigquery:v2",
     "kind": "discovery#restDescription",
     "name": "bigquery",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 144 matching lines @@
                     "parameterOrder": [
                         "projectId"
                     ],
                     "parameters": {
                         "all": {
                             "description": "Whether to list all datasets, including hidden ones",
                             "location": "query",
                             "type": "boolean"
                         },
                         "filter": {
-                            "description": "An expression for filtering the results of the request by label. The syntax is \"labels.[:]\". Multiple filters can be ANDed together by connecting with a space. Example: \"labels.department:receiving labels.active\". See https://cloud.google.com/bigquery/docs/labeling-datasets#filtering_datasets_using_labels for details.",
+                            "description": "An expression for filtering the results of the request by label. The syntax is \"labels.<name>[:<value>]\". Multiple filters can be ANDed together by connecting with a space. Example: \"labels.department:receiving labels.active\". See Filtering datasets using labels for details.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "description": "The maximum number of results to return",
                             "format": "uint32",
                             "location": "query",
                             "type": "integer"
                         },
                         "pageToken": {
@@ skipping 105 matching lines @@
                             "required": true,
                             "type": "string"
                         },
                         "projectId": {
                             "description": "[Required] Project ID of the job to cancel",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
-                    "path": "project/{projectId}/jobs/{jobId}/cancel",
+                    "path": "projects/{projectId}/jobs/{jobId}/cancel",
                     "response": {
                         "$ref": "JobCancelResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 },
                 "get": {
                     "description": "Returns information about a specific job. Job information is available for a six month period after creation. Requires that you're the person who ran the job, or have the Is Owner project role.",
@@ skipping 592 matching lines @@
                         "$ref": "Table"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 }
             }
         }
     },
-    "revision": "20160822",
+    "revision": "20161029",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "BigtableColumn": {
             "id": "BigtableColumn",
             "properties": {
                 "encoding": {
                     "description": "[Optional] The encoding of the values when the type is not STRING. Acceptable encoding values are: TEXT - indicates values are alphanumeric text strings. BINARY - indicates values are encoded using HBase Bytes.toBytes family of functions. 'encoding' can also be set at the column family level. However, the setting at this level takes precedence if 'encoding' is set at both levels.",
                     "type": "string"
                 },
                 "fieldName": {
@@ skipping 170 matching lines @@
                 },
                 "kind": {
                     "default": "bigquery#dataset",
                     "description": "[Output-only] The resource type.",
                     "type": "string"
                 },
                 "labels": {
                     "additionalProperties": {
                         "type": "string"
                     },
-                    "description": "[Experimental] The labels associated with this dataset. You can use these to organize and group your datasets. You can set this property when inserting or updating a dataset. Label keys and values can be no longer than 63 characters, can only contain letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and must be unique within a dataset. Both keys and values are additionally constrained to be <= 128 bytes in size.",
+                    "description": "[Experimental] The labels associated with this dataset. You can use these to organize and group your datasets. You can set this property when inserting or updating a dataset. See Labeling Datasets for more information.",
                     "type": "object"
                 },
                 "lastModifiedTime": {
                     "description": "[Output-only] The date when this dataset or any of its tables was last modified, in milliseconds since the epoch.",
                     "format": "int64",
                     "type": "string"
                 },
                 "location": {
                     "description": "[Experimental] The geographic location where the dataset should reside. Possible values include EU and US. The default value is US.",
                     "type": "string"
@@ skipping 383 matching lines @@
                     "description": "[Pick one] Copies a table."
                 },
                 "dryRun": {
                     "description": "[Optional] If set, don't actually run this job. A valid query will return a mostly empty response with some processing statistics, while an invalid query will return the same error it would if it wasn't a dry run. Behavior of non-query jobs is undefined.",
                     "type": "boolean"
                 },
                 "extract": {
                     "$ref": "JobConfigurationExtract",
                     "description": "[Pick one] Configures an extract job."
                 },
+                "labels": {
+                    "additionalProperties": {
+                        "type": "string"
+                    },
+                    "description": "[Experimental] The labels associated with this job. You can use these to organize and group your jobs. Label keys and values can be no longer than 63 characters, can only contain letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and must be unique within a dataset. Both keys and values are additionally constrained to be <= 128 bytes in size.",
+                    "type": "object"
+                },
                 "load": {
                     "$ref": "JobConfigurationLoad",
                     "description": "[Pick one] Configures a load job."
                 },
                 "query": {
                     "$ref": "JobConfigurationQuery",
                     "description": "[Pick one] Configures a query job."
                 }
             },
             "type": "object"
@@ skipping 176 matching lines @@
                 },
                 "priority": {
                     "description": "[Optional] Specifies a priority for the query. Possible values include INTERACTIVE and BATCH. The default value is INTERACTIVE.",
                     "type": "string"
                 },
                 "query": {
                     "description": "[Required] BigQuery SQL query to execute.",
                     "type": "string"
                 },
                 "queryParameters": {
-                    "description": "[Experimental] Query parameters for Standard SQL queries.",
+                    "description": "Query parameters for standard SQL queries.",
                     "items": {
                         "$ref": "QueryParameter"
                     },
                     "type": "array"
                 },
                 "schemaUpdateOptions": {
-                    "description": "[Experimental] Allows the schema of the desitination table to be updated as a side effect of the query job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.",
+                    "description": "[Experimental] Allows the schema of the destination table to be updated as a side effect of the query job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "tableDefinitions": {
                     "additionalProperties": {
                         "$ref": "ExternalDataConfiguration"
                     },
                     "description": "[Optional] If querying an external data source outside of BigQuery, describes the data format, location and other properties of the data source. By defining these properties, the data source can then be queried as if it were a standard BigQuery table.",
                     "type": "object"
                 },
                 "useLegacySql": {
-                    "description": "[Experimental] Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.",
+                    "description": "Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.",
                     "type": "boolean"
                 },
                 "useQueryCache": {
                     "default": "true",
                     "description": "[Optional] Whether to look for the result in the query cache. The query cache is a best-effort cache that will be flushed whenever tables in the query are modified. Moreover, the query cache is only available when a query does not have a destination table specified. The default value is true.",
                     "type": "boolean"
                 },
                 "userDefinedFunctionResources": {
                     "description": "[Experimental] Describes user-defined function resources used in the query.",
                     "items": {
@@ skipping 414 matching lines @@
             "id": "QueryParameterValue",
             "properties": {
                 "arrayValues": {
                     "description": "[Optional] The array values, if this is an array type.",
                     "items": {
                         "$ref": "QueryParameterValue"
                     },
                     "type": "array"
                 },
                 "structValues": {
-                    "description": "[Optional] The struct field values, in order of the struct type's declaration.",
-                    "items": {
+                    "additionalProperties": {
                         "$ref": "QueryParameterValue"
                     },
-                    "type": "array"
+                    "description": "[Optional] The struct field values, in order of the struct type's declaration.",
+                    "type": "object"
                 },
                 "value": {
                     "description": "[Optional] The value of this value, if a simple scalar type.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "QueryRequest": {
             "id": "QueryRequest",
@@ skipping 40 matching lines @@
                     },
                     "type": "array"
                 },
                 "timeoutMs": {
                     "description": "[Optional] How long to wait for the query to complete, in milliseconds, before the request times out and returns. Note that this is only a timeout for the request, not the query. If the query takes longer to run than the timeout value, the call returns without any results and with the 'jobComplete' flag set to false. You can call GetQueryResults() to wait for the query to complete and read the results. The default value is 10000 milliseconds (10 seconds).",
                     "format": "uint32",
                     "type": "integer"
                 },
                 "useLegacySql": {
                     "default": "true",
-                    "description": "[Experimental] Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.",
+                    "description": "Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.",
                     "type": "boolean"
                 },
                 "useQueryCache": {
                     "default": "true",
                     "description": "[Optional] Whether to look for the result in the query cache. The query cache is a best-effort cache that will be flushed whenever tables in the query are modified. The default value is true.",
                     "type": "boolean"
                 }
             },
             "type": "object"
         },
@@ skipping 299 matching lines @@
                 },
                 "mode": {
                     "description": "[Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.",
                     "type": "string"
                 },
                 "name": {
                     "description": "[Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.",
                     "type": "string"
                 },
                 "type": {
-                    "description": "[Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema).",
+                    "description": "[Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TableList": {
             "id": "TableList",
             "properties": {
                 "etag": {
                     "description": "A hash of this page of results.",
@@ skipping 135 matching lines @@
             "type": "object"
         },
         "ViewDefinition": {
             "id": "ViewDefinition",
             "properties": {
                 "query": {
                     "description": "[Required] A query that BigQuery executes when the view is referenced.",
                     "type": "string"
                 },
                 "useLegacySql": {
-                    "description": "[Experimental] Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.",
+                    "description": "Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.",
                     "type": "boolean"
                 },
                 "userDefinedFunctionResources": {
                     "description": "[Experimental] Describes user-defined function resources used in the query.",
                     "items": {
                         "$ref": "UserDefinedFunctionResource"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "bigquery/v2/",
     "title": "BigQuery API",
     "version": "v2"
 }