Api-roll 47: 2017-03-27

generated/googleapis/lib/bigquery/v2.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.bigquery.v2;
 
 import 'dart:core' as core;
 import 'dart:collection' as collection;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
@@ skipping 830 matching lines @@
    *
    * [datasetId] - Dataset ID of the table to read
    *
    * [tableId] - Table ID of the table to read
    *
    * [maxResults] - Maximum number of results to return
    *
    * [pageToken] - Page token, returned by a previous call, identifying the
    * result set
    *
+   * [selectedFields] - List of fields to return (comma-separated). If
+   * unspecified, all fields are returned
+   *
    * [startIndex] - Zero-based index of the starting row to read
    *
    * Completes with a [TableDataList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<TableDataList> list(core.String projectId, core.String datasetId, core.String tableId, {core.int maxResults, core.String pageToken, core.String startIndex}) {
+  async.Future<TableDataList> list(core.String projectId, core.String datasetId, core.String tableId, {core.int maxResults, core.String pageToken, core.String selectedFields, core.String startIndex}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (projectId == null) {
       throw new core.ArgumentError("Parameter projectId is required.");
     }
     if (datasetId == null) {
       throw new core.ArgumentError("Parameter datasetId is required.");
     }
     if (tableId == null) {
       throw new core.ArgumentError("Parameter tableId is required.");
     }
     if (maxResults != null) {
       _queryParams["maxResults"] = ["${maxResults}"];
     }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
+    if (selectedFields != null) {
+      _queryParams["selectedFields"] = [selectedFields];
+    }
     if (startIndex != null) {
       _queryParams["startIndex"] = [startIndex];
     }
 
     _url = 'projects/' + commons.Escaper.ecapeVariable('$projectId') + '/datasets/' + commons.Escaper.ecapeVariable('$datasetId') + '/tables/' + commons.Escaper.ecapeVariable('$tableId') + '/data';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
@@ skipping 68 matching lines @@
    * the structure of this table.
    *
    * Request parameters:
    *
    * [projectId] - Project ID of the requested table
    *
    * [datasetId] - Dataset ID of the requested table
    *
    * [tableId] - Table ID of the requested table
    *
+   * [selectedFields] - List of fields to return (comma-separated). If
+   * unspecified, all fields are returned
+   *
    * Completes with a [Table].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<Table> get(core.String projectId, core.String datasetId, core.String tableId) {
+  async.Future<Table> get(core.String projectId, core.String datasetId, core.String tableId, {core.String selectedFields}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (projectId == null) {
       throw new core.ArgumentError("Parameter projectId is required.");
     }
     if (datasetId == null) {
       throw new core.ArgumentError("Parameter datasetId is required.");
     }
     if (tableId == null) {
       throw new core.ArgumentError("Parameter tableId is required.");
     }
+    if (selectedFields != null) {
+      _queryParams["selectedFields"] = [selectedFields];
+    }
 
     _url = 'projects/' + commons.Escaper.ecapeVariable('$projectId') + '/datasets/' + commons.Escaper.ecapeVariable('$datasetId') + '/tables/' + commons.Escaper.ecapeVariable('$tableId');
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 668 matching lines @@
   /**
    * [Output-only] The fully-qualified unique name of the dataset in the format
    * projectId:datasetId. The dataset name without the project name is given in
    * the datasetId field. When creating a new dataset, leave this field blank,
    * and instead specify the datasetId field.
    */
   core.String id;
   /** [Output-only] The resource type. */
   core.String kind;
   /**
-   * [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.
+   * 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.
    */
   core.Map<core.String, core.String> labels;
   /**
    * [Output-only] The date when this dataset or any of its tables was last
    * modified, in milliseconds since the epoch.
    */
   core.String lastModifiedTime;
   /**
-   * [Experimental] The geographic location where the dataset should reside.
-   * Possible values include EU and US. The default value is US.
+   * The geographic location where the dataset should reside. Possible values
+   * include EU and US. The default value is US.
    */
   core.String location;
   /**
    * [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.
    */
   core.String selfLink;
 
   Dataset();
 
@@ skipping 93 matching lines @@
   /** A descriptive name for the dataset, if one exists. */
   core.String friendlyName;
   /** The fully-qualified, unique, opaque ID of the dataset. */
   core.String id;
   /**
    * The resource type. This property always returns the value
    * "bigquery#dataset".
    */
   core.String kind;
   /**
-   * [Experimental] The labels associated with this dataset. You can use these
-   * to organize and group your datasets.
+   * The labels associated with this dataset. You can use these to organize and
+   * group your datasets.
    */
   core.Map<core.String, core.String> labels;
 
   DatasetListDatasets();
 
   DatasetListDatasets.fromJson(core.Map _json) {
     if (_json.containsKey("datasetReference")) {
       datasetReference = new DatasetReference.fromJson(_json["datasetReference"]);
     }
     if (_json.containsKey("friendlyName")) {
@@ skipping 327 matching lines @@
     }
     if (substeps != null) {
       _json["substeps"] = substeps;
     }
     return _json;
   }
 }
 
 class ExternalDataConfiguration {
   /**
-   * [Experimental] Try to detect schema and format options automatically. Any
-   * option specified explicitly will be honored.
+   * Try to detect schema and format options automatically. Any option specified
+   * explicitly will be honored.
    */
   core.bool autodetect;
   /** [Optional] Additional options if sourceFormat is set to BIGTABLE. */
   BigtableOptions bigtableOptions;
   /**
    * [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.
    */
   core.String compression;
@@ skipping 24 matching lines @@
   /**
    * [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.
    */
   TableSchema schema;
   /**
    * [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.
+   * Datastore backups, specify "DATASTORE_BACKUP". [Beta] For Google Cloud
+   * Bigtable, specify "BIGTABLE".
    */
   core.String sourceFormat;
   /**
    * [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
@@ skipping 93 matching lines @@
    * 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).
    */
   JobReference jobReference;
   /** The resource type of the response. */
   core.String kind;
   /**
-   * [Output-only, Experimental] The number of rows affected by a DML statement.
-   * Present only for DML statements INSERT, UPDATE or DELETE.
+   * [Output-only] The number of rows affected by a DML statement. Present only
+   * for DML statements INSERT, UPDATE or DELETE.
    */
   core.String numDmlAffectedRows;
   /** A token used for paging results. */
   core.String pageToken;
   /**
    * 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.
    */
@@ skipping 418 matching lines @@
    * records, an invalid error is returned in the job result. The default value
    * is false. Only applicable to CSV, ignored for other formats.
    */
   core.bool allowJaggedRows;
   /**
    * Indicates if BigQuery should allow quoted data sections that contain
    * newline characters in a CSV file. The default value is false.
    */
   core.bool allowQuotedNewlines;
   /**
-   * [Experimental] Indicates if we should automatically infer the options and
-   * schema for CSV and JSON sources.
+   * Indicates if we should automatically infer the options and schema for CSV
+   * and JSON sources.
    */
   core.bool autodetect;
   /**
    * [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.
    */
@@ skipping 37 matching lines @@
   /**
    * [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.
    */
   core.String nullMarker;
   /**
-   * [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.
+   * 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.
    */
   core.List<core.String> projectionFields;
   /**
    * [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.
@@ skipping 225 matching lines @@
    * unspecified, this will be set to your project default.
    */
   core.int maximumBillingTier;
   /**
    * [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.
    */
   core.String maximumBytesBilled;
   /**
-   * [Experimental] Standard SQL only. Set to POSITIONAL to use positional (?)
-   * query parameters or to NAMED to use named (@myparam) query parameters in
-   * this query.
+   * Standard SQL only. Set to POSITIONAL to use positional (?) query parameters
+   * or to NAMED to use named (@myparam) query parameters in this query.
    */
   core.String parameterMode;
   /** [Deprecated] This property is deprecated. */
   core.bool preserveNulls;
   /**
    * [Optional] Specifies a priority for the query. Possible values include
    * INTERACTIVE and BATCH. The default value is INTERACTIVE.
    */
   core.String priority;
   /** [Required] BigQuery SQL query to execute. */
@@ skipping 29 matching lines @@
    */
   core.bool useLegacySql;
   /**
    * [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.
    */
   core.bool useQueryCache;
-  /**
-   * [Experimental] Describes user-defined function resources used in the query.
-   */
+  /** Describes user-defined function resources used in the query. */
   core.List<UserDefinedFunctionResource> userDefinedFunctionResources;
   /**
    * [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
@@ skipping 442 matching lines @@
 }
 
 class JobStatistics2 {
   /** [Output-only] Billing tier for the job. */
   core.int billingTier;
   /**
    * [Output-only] Whether the query result was fetched from the query cache.
    */
   core.bool cacheHit;
   /**
-   * [Output-only, Experimental] The number of rows affected by a DML statement.
-   * Present only for DML statements INSERT, UPDATE or DELETE.
+   * [Output-only] The number of rows affected by a DML statement. Present only
+   * for DML statements INSERT, UPDATE or DELETE.
    */
   core.String numDmlAffectedRows;
-  /** [Output-only, Experimental] Describes execution plan for the query. */
+  /** [Output-only] Describes execution plan for the query. */
   core.List<ExplainQueryStage> queryPlan;
   /**
    * [Output-only, Experimental] Referenced tables for the job. Queries that
    * reference more than 50 tables will not have a complete list.
    */
   core.List<TableReference> referencedTables;
   /**
    * [Output-only, Experimental] The schema of the results. Present only for
    * successful dry run of non-legacy SQL queries.
    */
@@ skipping 543 matching lines @@
   core.String kind;
   /**
    * [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.
    */
   core.int maxResults;
   /**
-   * [Experimental] Standard SQL only. Set to POSITIONAL to use positional (?)
-   * query parameters or to NAMED to use named (@myparam) query parameters in
-   * this query.
+   * Standard SQL only. Set to POSITIONAL to use positional (?) query parameters
+   * or to NAMED to use named (@myparam) query parameters in this query.
    */
   core.String parameterMode;
   /** [Deprecated] This property is deprecated. */
   core.bool preserveNulls;
   /**
    * [Required] A query string, following the BigQuery query syntax, of the
    * query to execute. Example: "SELECT count(f1) FROM
    * [myProjectId:myDatasetId.myTableId]".
    */
   core.String query;
-  /** [Experimental] Query parameters for Standard SQL queries. */
+  /** Query parameters for Standard SQL queries. */
   core.List<QueryParameter> queryParameters;
   /**
    * [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).
    */
@@ skipping 110 matching lines @@
    * 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).
    */
   JobReference jobReference;
   /** The resource type. */
   core.String kind;
   /**
-   * [Output-only, Experimental] The number of rows affected by a DML statement.
-   * Present only for DML statements INSERT, UPDATE or DELETE.
+   * [Output-only] The number of rows affected by a DML statement. Present only
+   * for DML statements INSERT, UPDATE or DELETE.
    */
   core.String numDmlAffectedRows;
   /** A token used for paging results. */
   core.String pageToken;
   /**
    * 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.
    */
   core.List<TableRow> rows;
@@ skipping 988 matching lines @@
 class ViewDefinition {
   /** [Required] A query that BigQuery executes when the view is referenced. */
   core.String query;
   /**
    * 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.
    */
   core.bool useLegacySql;
-  /**
-   * [Experimental] Describes user-defined function resources used in the query.
-   */
+  /** Describes user-defined function resources used in the query. */
   core.List<UserDefinedFunctionResource> userDefinedFunctionResources;
 
   ViewDefinition();
 
   ViewDefinition.fromJson(core.Map _json) {
     if (_json.containsKey("query")) {
       query = _json["query"];
     }
     if (_json.containsKey("useLegacySql")) {
       useLegacySql = _json["useLegacySql"];
@@ skipping 10 matching lines @@
     }
     if (useLegacySql != null) {
       _json["useLegacySql"] = useLegacySql;
     }
     if (userDefinedFunctionResources != null) {
       _json["userDefinedFunctionResources"] = userDefinedFunctionResources.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }