Api-roll 41: 2016-08-26

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/8OSACAptUIIUJA3qAbwY7uhPqwg\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/Ib6OxmyUT7luxrAe5VQ1tJgZykA\"",
     "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 883 matching lines @@
                         "$ref": "Table"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 }
             }
         }
     },
-    "revision": "20160729",
+    "revision": "20160822",
     "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 688 matching lines @@
                     "description": "[Optional] The schema for the destination table. The schema can be omitted if the destination table already exists, or if you're loading data from Google Cloud Datastore."
                 },
                 "schemaInline": {
                     "description": "[Deprecated] The inline schema. For CSV schemas, specify as \"Field1:Type1[,Field2:Type2]*\". For example, \"foo:STRING, bar:INTEGER, baz:FLOAT\".",
                     "type": "string"
                 },
                 "schemaInlineFormat": {
                     "description": "[Deprecated] The format of the schemaInline property.",
                     "type": "string"
                 },
+                "schemaUpdateOptions": {
+                    "description": "[Experimental] Allows the schema of the desitination table to be updated as a side effect of the load 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"
+                },
                 "skipLeadingRows": {
                     "description": "[Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "sourceFormat": {
                     "description": "[Optional] The format of the data files. For CSV files, specify \"CSV\". For datastore backups, specify \"DATASTORE_BACKUP\". For newline-delimited JSON, specify \"NEWLINE_DELIMITED_JSON\". For Avro, specify \"AVRO\". The default value is CSV.",
                     "type": "string"
                 },
                 "sourceUris": {
@@ skipping 38 matching lines @@
                     "default": "1",
                     "description": "[Optional] Limits the billing tier for this job. Queries that have resource usage beyond this tier will fail (without incurring a charge). If unspecified, this will be set to your project default.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "maximumBytesBilled": {
                     "description": "[Optional] Limits the bytes billed for this job. Queries that will have bytes billed beyond this limit will fail (without incurring a charge). If unspecified, this will be set to your project default.",
                     "format": "int64",
                     "type": "string"
                 },
+                "parameterMode": {
+                    "description": "[Experimental] Standard SQL only. Whether to use positional (?) or named (@myparam) query parameters in this query.",
+                    "type": "string"
+                },
                 "preserveNulls": {
                     "description": "[Deprecated] This property is deprecated.",
                     "type": "boolean"
                 },
                 "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.",
+                    "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.",
+                    "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.",
                     "type": "boolean"
@@ skipping 210 matching lines @@
                 },
                 "totalBytesBilled": {
                     "description": "[Output-only] Total bytes billed for the job.",
                     "format": "int64",
                     "type": "string"
                 },
                 "totalBytesProcessed": {
                     "description": "[Output-only] Total bytes processed for the job.",
                     "format": "int64",
                     "type": "string"
+                },
+                "undeclaredQueryParameters": {
+                    "description": "[Output-only, Experimental] Standard SQL only: list of undeclared query parameters detected during a dry run validation.",
+                    "items": {
+                        "$ref": "QueryParameter"
+                    },
+                    "type": "array"
                 }
             },
             "type": "object"
         },
         "JobStatistics3": {
             "id": "JobStatistics3",
             "properties": {
                 "inputFileBytes": {
                     "description": "[Output-only] Number of bytes of source data in a load job.",
                     "format": "int64",
@@ skipping 122 matching lines @@
         "ProjectReference": {
             "id": "ProjectReference",
             "properties": {
                 "projectId": {
                     "description": "[Required] ID of the project. Can be either the numeric ID or the assigned ID of the project.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "QueryParameter": {
+            "id": "QueryParameter",
+            "properties": {
+                "name": {
+                    "description": "[Optional] If unset, this is a positional parameter. Otherwise, should be unique within a query.",
+                    "type": "string"
+                },
+                "parameterType": {
+                    "$ref": "QueryParameterType",
+                    "description": "[Required] The type of this parameter."
+                },
+                "parameterValue": {
+                    "$ref": "QueryParameterValue",
+                    "description": "[Required] The value of this parameter."
+                }
+            },
+            "type": "object"
+        },
+        "QueryParameterType": {
+            "id": "QueryParameterType",
+            "properties": {
+                "arrayType": {
+                    "$ref": "QueryParameterType",
+                    "description": "[Optional] The type of the array's elements, if this is an array."
+                },
+                "structTypes": {
+                    "description": "[Optional] The types of the fields of this struct, in order, if this is a struct.",
+                    "items": {
+                        "properties": {
+                            "description": {
+                                "description": "[Optional] Human-oriented description of the field.",
+                                "type": "string"
+                            },
+                            "name": {
+                                "description": "[Optional] The name of this field.",
+                                "type": "string"
+                            },
+                            "type": {
+                                "$ref": "QueryParameterType",
+                                "description": "[Required] The type of this field."
+                            }
+                        },
+                        "type": "object"
+                    },
+                    "type": "array"
+                },
+                "type": {
+                    "description": "[Required] The top level type of this field.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "QueryParameterValue": {
+            "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": {
+                        "$ref": "QueryParameterValue"
+                    },
+                    "type": "array"
+                },
+                "value": {
+                    "description": "[Optional] The value of this value, if a simple scalar type.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "QueryRequest": {
             "id": "QueryRequest",
             "properties": {
                 "defaultDataset": {
                     "$ref": "DatasetReference",
                     "description": "[Optional] Specifies the default datasetId and projectId to assume for any unqualified table names in the query. If not set, all table names in the query string must be qualified in the format 'datasetId.tableId'."
                 },
                 "dryRun": {
                     "description": "[Optional] If set to true, BigQuery doesn't run the job. Instead, if the query is valid, BigQuery returns statistics about the job such as how many bytes would be processed. If the query is invalid, an error returns. The default value is false.",
                     "type": "boolean"
                 },
                 "kind": {
                     "default": "bigquery#queryRequest",
                     "description": "The resource type of the request.",
                     "type": "string"
                 },
                 "maxResults": {
                     "description": "[Optional] The maximum number of rows of data to return per page of results. Setting this flag to a small value such as 1000 and then paging through results might improve reliability when the query result set is large. In addition to this limit, responses are also limited to 10 MB. By default, there is no maximum row count, and only the byte limit applies.",
                     "format": "uint32",
                     "type": "integer"
                 },
+                "parameterMode": {
+                    "description": "[Experimental] Standard SQL only. Whether to use positional (?) or named (@myparam) query parameters in this query.",
+                    "type": "string"
+                },
                 "preserveNulls": {
                     "description": "[Deprecated] This property is deprecated.",
                     "type": "boolean"
                 },
                 "query": {
                     "annotations": {
                         "required": [
                             "bigquery.jobs.query"
                         ]
                     },
                     "description": "[Required] A query string, following the BigQuery query syntax, of the query to execute. Example: \"SELECT count(f1) FROM [myProjectId:myDatasetId.myTableId]\".",
                     "type": "string"
                 },
+                "queryParameters": {
+                    "description": "[Experimental] Query parameters for Standard SQL queries.",
+                    "items": {
+                        "$ref": "QueryParameter"
+                    },
+                    "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.",
                     "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 474 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "bigquery/v2/",
     "title": "BigQuery API",
     "version": "v2"
 }