Api-roll 47: 2017-03-27

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": "\"tbys6C40o18GZwyMen5GMkdK-3s/2pbHVnKgRBtlI769YwDOp1uiQ0w\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/Hw3ocLnACFZ8pfeMZhrBTel37_8\"",
     "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 620 matching lines @@
                             "description": "Page token, returned by a previous call, identifying the result set",
                             "location": "query",
                             "type": "string"
                         },
                         "projectId": {
                             "description": "Project ID of the table to read",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
+                        "selectedFields": {
+                            "description": "List of fields to return (comma-separated). If unspecified, all fields are returned",
+                            "location": "query",
+                            "type": "string"
+                        },
                         "startIndex": {
                             "description": "Zero-based index of the starting row to read",
                             "format": "uint64",
                             "location": "query",
                             "type": "string"
                         },
                         "tableId": {
                             "description": "Table ID of the table to read",
                             "location": "path",
                             "required": true,
@@ skipping 64 matching lines @@
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
                         "projectId": {
                             "description": "Project ID of the requested table",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
+                        "selectedFields": {
+                            "description": "List of fields to return (comma-separated). If unspecified, all fields are returned",
+                            "location": "query",
+                            "type": "string"
+                        },
                         "tableId": {
                             "description": "Table ID of the requested table",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "projects/{projectId}/datasets/{datasetId}/tables/{tableId}",
                     "response": {
                         "$ref": "Table"
@@ skipping 159 matching lines @@
                         "$ref": "Table"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 }
             }
         }
     },
-    "revision": "20170224",
+    "revision": "20170319",
     "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. See Labeling Datasets for more information.",
+                    "description": "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.",
+                    "description": "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 17 matching lines @@
                             },
                             "kind": {
                                 "default": "bigquery#dataset",
                                 "description": "The resource type. This property always returns the value \"bigquery#dataset\".",
                                 "type": "string"
                             },
                             "labels": {
                                 "additionalProperties": {
                                     "type": "string"
                                 },
-                                "description": "[Experimental] The labels associated with this dataset. You can use these to organize and group your datasets.",
+                                "description": "The labels associated with this dataset. You can use these to organize and group your datasets.",
                                 "type": "object"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 },
                 "etag": {
                     "description": "A hash value of the results page. You can use this property to determine if the page has changed since the last request.",
                     "type": "string"
@@ skipping 146 matching lines @@
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "ExternalDataConfiguration": {
             "id": "ExternalDataConfiguration",
             "properties": {
                 "autodetect": {
-                    "description": "[Experimental] Try to detect schema and format options automatically. Any option specified explicitly will be honored.",
+                    "description": "Try to detect schema and format options automatically. Any option specified explicitly will be honored.",
                     "type": "boolean"
                 },
                 "bigtableOptions": {
                     "$ref": "BigtableOptions",
                     "description": "[Optional] Additional options if sourceFormat is set to BIGTABLE."
                 },
                 "compression": {
                     "description": "[Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. This setting is ignored for Google Cloud Bigtable, Google Cloud Datastore backups and Avro formats.",
                     "type": "string"
                 },
@@ skipping 12 matching lines @@
                 "maxBadRecords": {
                     "description": "[Optional] The maximum number of bad records that BigQuery can ignore when reading data. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid. This setting is ignored for Google Cloud Bigtable, Google Cloud Datastore backups and Avro formats.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "schema": {
                     "$ref": "TableSchema",
                     "description": "[Optional] The schema for the data. Schema is required for CSV and JSON formats. Schema is disallowed for Google Cloud Bigtable, Cloud Datastore backups, and Avro formats."
                 },
                 "sourceFormat": {
-                    "description": "[Required] The data format. For CSV files, specify \"CSV\". For Google sheets, specify \"GOOGLE_SHEETS\". For newline-delimited JSON, specify \"NEWLINE_DELIMITED_JSON\". For Avro files, specify \"AVRO\". For Google Cloud Datastore backups, specify \"DATASTORE_BACKUP\". [Experimental] For Google Cloud Bigtable, specify \"BIGTABLE\". Please note that reading from Google Cloud Bigtable is experimental and has to be enabled for your project. Please contact Google Cloud Support to enable this for your project.",
+                    "description": "[Required] The data format. For CSV files, specify \"CSV\". For Google sheets, specify \"GOOGLE_SHEETS\". For newline-delimited JSON, specify \"NEWLINE_DELIMITED_JSON\". For Avro files, specify \"AVRO\". For Google Cloud Datastore backups, specify \"DATASTORE_BACKUP\". [Beta] For Google Cloud Bigtable, specify \"BIGTABLE\".",
                     "type": "string"
                 },
                 "sourceUris": {
                     "description": "[Required] The fully-qualified URIs that point to your data in Google Cloud. For Google Cloud Storage URIs: Each URI can contain one '*' wildcard character and it must come after the 'bucket' name. Size limits related to load jobs apply to external data sources. For Google Cloud Bigtable URIs: Exactly one URI can be specified and it has be a fully specified and valid HTTPS URL for a Google Cloud Bigtable table. For Google Cloud Datastore backups, exactly one URI can be specified, and it must end with '.backup_info'. Also, the '*' wildcard character is not allowed.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
@@ skipping 24 matching lines @@
                 "jobReference": {
                     "$ref": "JobReference",
                     "description": "Reference to the BigQuery Job that was created to run the query. This field will be present even if the original request timed out, in which case GetQueryResults can be used to read the results once the query has completed. Since this API only returns the first page of results, subsequent pages can be fetched via the same mechanism (GetQueryResults)."
                 },
                 "kind": {
                     "default": "bigquery#getQueryResultsResponse",
                     "description": "The resource type of the response.",
                     "type": "string"
                 },
                 "numDmlAffectedRows": {
-                    "description": "[Output-only, Experimental] The number of rows affected by a DML statement. Present only for DML statements INSERT, UPDATE or DELETE.",
+                    "description": "[Output-only] The number of rows affected by a DML statement. Present only for DML statements INSERT, UPDATE or DELETE.",
                     "format": "int64",
                     "type": "string"
                 },
                 "pageToken": {
                     "description": "A token used for paging results.",
                     "type": "string"
                 },
                 "rows": {
                     "description": "An object with as many results as can be contained within the maximum permitted reply size. To get any additional rows, you can call GetQueryResults and specify the jobReference returned above. Present only when the query completes successfully.",
                     "items": {
@@ skipping 163 matching lines @@
             "properties": {
                 "allowJaggedRows": {
                     "description": "[Optional] Accept rows that are missing trailing optional columns. The missing values are treated as nulls. 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. Only applicable to CSV, ignored for other formats.",
                     "type": "boolean"
                 },
                 "allowQuotedNewlines": {
                     "description": "Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false.",
                     "type": "boolean"
                 },
                 "autodetect": {
-                    "description": "[Experimental] Indicates if we should automatically infer the options and schema for CSV and JSON sources.",
+                    "description": "Indicates if we should automatically infer the options and schema for CSV and JSON sources.",
                     "type": "boolean"
                 },
                 "createDisposition": {
                     "description": "[Optional] Specifies whether the job is allowed to create new tables. The following values are supported: CREATE_IF_NEEDED: If the table does not exist, BigQuery creates the table. CREATE_NEVER: The table must already exist. If it does not, a 'notFound' error is returned in the job result. The default value is CREATE_IF_NEEDED. Creation, truncation and append actions occur as one atomic update upon job completion.",
                     "type": "string"
                 },
                 "destinationTable": {
                     "$ref": "TableReference",
                     "description": "[Required] The destination table to load the data into."
                 },
@@ skipping 12 matching lines @@
                 "maxBadRecords": {
                     "description": "[Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "nullMarker": {
                     "description": "[Optional] Specifies a string that represents a null value in a CSV file. For example, if you specify \"\\N\", BigQuery interprets \"\\N\" as a null value when loading a CSV file. The default value is the empty string. If you set this property to a custom value, BigQuery still interprets the empty string as a null value for all data types except for STRING and BYTE. For STRING and BYTE columns, BigQuery interprets the empty string as an empty value.",
                     "type": "string"
                 },
                 "projectionFields": {
-                    "description": "[Experimental] If sourceFormat is set to \"DATASTORE_BACKUP\", indicates which entity properties to load into BigQuery from a Cloud Datastore backup. Property names are case sensitive and must be top-level properties. If no properties are specified, BigQuery loads all properties. If any named property isn't found in the Cloud Datastore backup, an invalid error is returned in the job result.",
+                    "description": "If sourceFormat is set to \"DATASTORE_BACKUP\", indicates which entity properties to load into BigQuery from a Cloud Datastore backup. Property names are case sensitive and must be top-level properties. If no properties are specified, BigQuery loads all properties. If any named property isn't found in the Cloud Datastore backup, an invalid error is returned in the job result.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "quote": {
                     "default": "\"",
                     "description": "[Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('\"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true.",
                     "pattern": ".?",
                     "type": "string"
@@ skipping 69 matching lines @@
                     "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. Set to POSITIONAL to use positional (?) query parameters or to NAMED to use named (@myparam) query parameters in this query.",
+                    "description": "Standard SQL only. Set to POSITIONAL to use positional (?) query parameters or to NAMED to use 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"
                 },
@@ skipping 25 matching lines @@
                 "useLegacySql": {
                     "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.",
+                    "description": "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"
                 }
             },
@@ skipping 161 matching lines @@
                 "billingTier": {
                     "description": "[Output-only] Billing tier for the job.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "cacheHit": {
                     "description": "[Output-only] Whether the query result was fetched from the query cache.",
                     "type": "boolean"
                 },
                 "numDmlAffectedRows": {
-                    "description": "[Output-only, Experimental] The number of rows affected by a DML statement. Present only for DML statements INSERT, UPDATE or DELETE.",
+                    "description": "[Output-only] The number of rows affected by a DML statement. Present only for DML statements INSERT, UPDATE or DELETE.",
                     "format": "int64",
                     "type": "string"
                 },
                 "queryPlan": {
-                    "description": "[Output-only, Experimental] Describes execution plan for the query.",
+                    "description": "[Output-only] Describes execution plan for the query.",
                     "items": {
                         "$ref": "ExplainQueryStage"
                     },
                     "type": "array"
                 },
                 "referencedTables": {
                     "description": "[Output-only, Experimental] Referenced tables for the job. Queries that reference more than 50 tables will not have a complete list.",
                     "items": {
                         "$ref": "TableReference"
                     },
@@ skipping 257 matching lines @@
                     "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. Set to POSITIONAL to use positional (?) query parameters or to NAMED to use named (@myparam) query parameters in this query.",
+                    "description": "Standard SQL only. Set to POSITIONAL to use positional (?) query parameters or to NAMED to use 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.",
+                    "description": "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"
                 },
@@ skipping 31 matching lines @@
                 "jobReference": {
                     "$ref": "JobReference",
                     "description": "Reference to the Job that was created to run the query. This field will be present even if the original request timed out, in which case GetQueryResults can be used to read the results once the query has completed. Since this API only returns the first page of results, subsequent pages can be fetched via the same mechanism (GetQueryResults)."
                 },
                 "kind": {
                     "default": "bigquery#queryResponse",
                     "description": "The resource type.",
                     "type": "string"
                 },
                 "numDmlAffectedRows": {
-                    "description": "[Output-only, Experimental] The number of rows affected by a DML statement. Present only for DML statements INSERT, UPDATE or DELETE.",
+                    "description": "[Output-only] The number of rows affected by a DML statement. Present only for DML statements INSERT, UPDATE or DELETE.",
                     "format": "int64",
                     "type": "string"
                 },
                 "pageToken": {
                     "description": "A token used for paging results.",
                     "type": "string"
                 },
                 "rows": {
                     "description": "An object with as many results as can be contained within the maximum permitted reply size. To get any additional rows, you can call GetQueryResults and specify the jobReference returned above.",
                     "items": {
@@ skipping 444 matching lines @@
             "properties": {
                 "query": {
                     "description": "[Required] A query that BigQuery executes when the view is referenced.",
                     "type": "string"
                 },
                 "useLegacySql": {
                     "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.",
+                    "description": "Describes user-defined function resources used in the query.",
                     "items": {
                         "$ref": "UserDefinedFunctionResource"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "bigquery/v2/",
     "title": "BigQuery API",
     "version": "v2"
 }