Api-roll 21: 2015-08-04

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"
                 },
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 },
+                "https://www.googleapis.com/auth/cloud-platform.read-only": {
+                    "description": "MESSAGE UNDER CONSTRUCTION View your data across Google Cloud Platform services"
+                },
                 "https://www.googleapis.com/auth/devstorage.full_control": {
                     "description": "Manage your data and permissions in Google Cloud Storage"
                 },
                 "https://www.googleapis.com/auth/devstorage.read_only": {
                     "description": "View your data in Google Cloud Storage"
                 },
                 "https://www.googleapis.com/auth/devstorage.read_write": {
                     "description": "Manage your data in Google Cloud Storage"
                 }
             }
         }
     },
     "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": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/6_j3-L3xDTpJRP-qmfT7ZpU_5Bg\"",
+    "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/r06f0hHpX4mVebOueiwIFm0vurA\"",
     "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 101 matching lines @@
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "projects/{projectId}/datasets/{datasetId}",
                     "response": {
                         "$ref": "Dataset"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "insert": {
                     "description": "Creates a new empty dataset.",
                     "httpMethod": "POST",
                     "id": "bigquery.datasets.insert",
                     "parameterOrder": [
                         "projectId"
                     ],
                     "parameters": {
@@ skipping 46 matching lines @@
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "projects/{projectId}/datasets",
                     "response": {
                         "$ref": "DatasetList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "patch": {
                     "description": "Updates information in an existing dataset. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "bigquery.datasets.patch",
                     "parameterOrder": [
                         "projectId",
                         "datasetId"
                     ],
@@ skipping 113 matching lines @@
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "projects/{projectId}/jobs/{jobId}",
                     "response": {
                         "$ref": "Job"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "getQueryResults": {
                     "description": "Retrieves the results of a query job.",
                     "httpMethod": "GET",
                     "id": "bigquery.jobs.getQueryResults",
                     "parameterOrder": [
                         "projectId",
                         "jobId"
                     ],
@@ skipping 21 matching lines @@
                             "required": true,
                             "type": "string"
                         },
                         "startIndex": {
                             "description": "Zero-based index of the starting row",
                             "format": "uint64",
                             "location": "query",
                             "type": "string"
                         },
                         "timeoutMs": {
-                            "description": "How long to wait for the query to complete, in milliseconds, before returning. Default is to return immediately. If the timeout passes before the job completes, the request will fail with a TIMEOUT error",
+                            "description": "How long to wait for the query to complete, in milliseconds, before returning. Default is 10 seconds. If the timeout passes before the job completes, the 'jobComplete' field in the response will be false",
                             "format": "uint32",
                             "location": "query",
                             "type": "integer"
                         }
                     },
                     "path": "projects/{projectId}/queries/{jobId}",
                     "response": {
                         "$ref": "GetQueryResultsResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "insert": {
                     "description": "Starts a new asynchronous job. Requires the Can View project role.",
                     "httpMethod": "POST",
                     "id": "bigquery.jobs.insert",
                     "mediaUpload": {
                         "accept": [
                             "*/*"
                         ],
@@ skipping 29 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/devstorage.full_control",
                         "https://www.googleapis.com/auth/devstorage.read_only",
                         "https://www.googleapis.com/auth/devstorage.read_write"
                     ],
                     "supportsMediaUpload": true
                 },
                 "list": {
-                    "description": "Lists all jobs that you started in the specified project. The job list returns in reverse chronological order of when the jobs were created, starting with the most recent job created. Requires the Can View project role, or the Is Owner project role if you set the allUsers property.",
+                    "description": "Lists all jobs that you started in the specified project. Job information is available for a six month period after creation. The job list is sorted in reverse chronological order, by job creation time. Requires the Can View project role, or the Is Owner project role if you set the allUsers property.",
                     "httpMethod": "GET",
                     "id": "bigquery.jobs.list",
                     "parameterOrder": [
                         "projectId"
                     ],
                     "parameters": {
                         "allUsers": {
                             "description": "Whether to display jobs owned by all users in the project. Default false",
                             "location": "query",
                             "type": "boolean"
@@ skipping 44 matching lines @@
                             "repeated": true,
                             "type": "string"
                         }
                     },
                     "path": "projects/{projectId}/jobs",
                     "response": {
                         "$ref": "JobList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "query": {
                     "description": "Runs a BigQuery SQL query synchronously and returns query results if the query completes within a specified timeout.",
                     "httpMethod": "POST",
                     "id": "bigquery.jobs.query",
                     "parameterOrder": [
                         "projectId"
                     ],
                     "parameters": {
                         "projectId": {
                             "description": "Project ID of the project billed for the query",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "projects/{projectId}/queries",
                     "request": {
                         "$ref": "QueryRequest"
                     },
                     "response": {
                         "$ref": "QueryResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 }
             }
         },
         "projects": {
             "methods": {
                 "list": {
                     "description": "Lists all projects to which you have been granted any project role.",
                     "httpMethod": "GET",
                     "id": "bigquery.projects.list",
                     "parameters": {
                         "maxResults": {
                             "description": "Maximum number of results to return",
                             "format": "uint32",
                             "location": "query",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Page token, returned by a previous call, to request the next page of results",
                             "location": "query",
                             "type": "string"
                         }
                     },
                     "path": "projects",
                     "response": {
                         "$ref": "ProjectList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 }
             }
         },
         "tabledata": {
             "methods": {
                 "insertAll": {
                     "description": "Streams data into BigQuery one record at a time without needing to run a load job. Requires the WRITER dataset role.",
                     "httpMethod": "POST",
                     "id": "bigquery.tabledata.insertAll",
@@ skipping 80 matching lines @@
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "projects/{projectId}/datasets/{datasetId}/tables/{tableId}/data",
                     "response": {
                         "$ref": "TableDataList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 }
             }
         },
         "tables": {
             "methods": {
                 "delete": {
                     "description": "Deletes the table specified by tableId from the dataset. If the table contains data, all the data will be deleted.",
                     "httpMethod": "DELETE",
                     "id": "bigquery.tables.delete",
@@ skipping 56 matching lines @@
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "projects/{projectId}/datasets/{datasetId}/tables/{tableId}",
                     "response": {
                         "$ref": "Table"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "insert": {
                     "description": "Creates a new, empty table in the dataset.",
                     "httpMethod": "POST",
                     "id": "bigquery.tables.insert",
                     "parameterOrder": [
                         "projectId",
                         "datasetId"
                     ],
@@ skipping 55 matching lines @@
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "projects/{projectId}/datasets/{datasetId}/tables",
                     "response": {
                         "$ref": "TableList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
-                        "https://www.googleapis.com/auth/cloud-platform"
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "patch": {
                     "description": "Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "bigquery.tables.patch",
                     "parameterOrder": [
                         "projectId",
                         "datasetId",
                         "tableId"
@@ skipping 67 matching lines @@
                         "$ref": "Table"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 }
             }
         }
     },
-    "revision": "20150626",
+    "revision": "20150723",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "CsvOptions": {
             "id": "CsvOptions",
             "properties": {
                 "allowJaggedRows": {
                     "description": "[Optional] Indicates if BigQuery should accept rows that are missing trailing optional columns. If true, BigQuery treats missing trailing columns as null values. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false.",
                     "type": "boolean"
                 },
                 "allowQuotedNewlines": {
@@ skipping 92 matching lines @@
                     "default": "bigquery#dataset",
                     "description": "[Output-only] The resource type.",
                     "type": "string"
                 },
                 "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 location where the data resides. If not present, the data will be stored in the US.",
+                    "description": "[Experimental] The geographic location where the dataset should reside. Possible values include EU and US. The default value is US.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output-only] A URL that can be used to access the resource again. You can use this URL in Get or Update requests to the resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DatasetList": {
@@ skipping 453 matching lines @@
                         "$ref": "ExternalDataConfiguration"
                     },
                     "description": "[Experimental] 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"
                 },
                 "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": {
+                        "$ref": "UserDefinedFunctionResource"
+                    },
+                    "type": "array"
+                },
                 "writeDisposition": {
                     "description": "[Optional] Specifies the action that occurs if the destination table already exists. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table data. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists and contains data, a 'duplicate' error is returned in the job result. The default value is WRITE_EMPTY. Each action is atomic and only occurs if BigQuery is able to complete the job successfully. Creation, truncation and append actions occur as one atomic update upon job completion.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "JobConfigurationTableCopy": {
             "id": "JobConfigurationTableCopy",
             "properties": {
@@ skipping 304 matching lines @@
             "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, 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.",
+                    "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",
@@ skipping 87 matching lines @@
                 },
                 "etag": {
                     "description": "[Output-only] A hash of this resource.",
                     "type": "string"
                 },
                 "expirationTime": {
                     "description": "[Optional] The time when this table expires, in milliseconds since the epoch. If not present, the table will persist indefinitely. Expired tables will be deleted and their storage reclaimed.",
                     "format": "int64",
                     "type": "string"
                 },
+                "externalDataConfiguration": {
+                    "$ref": "ExternalDataConfiguration",
+                    "description": "[Experimental] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table."
+                },
                 "friendlyName": {
                     "description": "[Optional] A descriptive name for this table.",
                     "type": "string"
                 },
                 "id": {
                     "description": "[Output-only] An opaque ID uniquely identifying the table.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "bigquery#table",
                     "description": "[Output-only] The type of the resource.",
                     "type": "string"
                 },
                 "lastModifiedTime": {
                     "description": "[Output-only] The time when this table was last modified, in milliseconds since the epoch.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "location": {
-                    "description": "[Optional] The backing storage location.",
+                    "description": "[Output-only] The geographic location where the table resides. This value is inherited from the dataset.",
                     "type": "string"
                 },
                 "numBytes": {
                     "description": "[Output-only] The size of the table in bytes. This property is unavailable for tables that are actively receiving streaming inserts.",
                     "format": "int64",
                     "type": "string"
                 },
                 "numRows": {
                     "description": "[Output-only] The number of rows of data in this table. This property is unavailable for tables that are actively receiving streaming inserts.",
                     "format": "uint64",
@@ skipping 265 matching lines @@
                 "fields": {
                     "description": "Describes the fields in a table.",
                     "items": {
                         "$ref": "TableFieldSchema"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
+        "UserDefinedFunctionResource": {
+            "id": "UserDefinedFunctionResource",
+            "properties": {
+                "inlineCode": {
+                    "description": "[Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.",
+                    "type": "string"
+                },
+                "resourceUri": {
+                    "description": "[Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "ViewDefinition": {
             "id": "ViewDefinition",
             "properties": {
                 "query": {
                     "description": "[Required] A query that BigQuery executes when the view is referenced.",
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "bigquery/v2/",
     "title": "BigQuery API",
     "version": "v2"
 }