Api-roll 48: 2017-04-18

generated/googleapis/lib/sheets/v4.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.sheets.v4;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 293 matching lines @@
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [spreadsheetId] - The ID of the spreadsheet to update.
    *
    * [range] - The A1 notation of a range to search for a logical table of data.
    * Values will be appended after the last row of the table.
    *
+   * [responseDateTimeRenderOption] - Determines how dates, times, and durations
+   * in the response should be
+   * rendered. This is ignored if response_value_render_option is
+   * FORMATTED_VALUE.
+   * The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].
+   * Possible string values are:
+   * - "SERIAL_NUMBER" : A SERIAL_NUMBER.
+   * - "FORMATTED_STRING" : A FORMATTED_STRING.
+   *
+   * [includeValuesInResponse] - Determines if the update response should
+   * include the values
+   * of the cells that were appended. By default, responses
+   * do not include the updated values.
+   *
    * [responseValueRenderOption] - Determines how values in the response should
    * be rendered.
    * The default render option is ValueRenderOption.FORMATTED_VALUE.
    * Possible string values are:
    * - "FORMATTED_VALUE" : A FORMATTED_VALUE.
    * - "UNFORMATTED_VALUE" : A UNFORMATTED_VALUE.
    * - "FORMULA" : A FORMULA.
    *
    * [insertDataOption] - How the input data should be inserted.
    * Possible string values are:
    * - "OVERWRITE" : A OVERWRITE.
    * - "INSERT_ROWS" : A INSERT_ROWS.
    *
    * [valueInputOption] - How the input data should be interpreted.
    * Possible string values are:
    * - "INPUT_VALUE_OPTION_UNSPECIFIED" : A INPUT_VALUE_OPTION_UNSPECIFIED.
    * - "RAW" : A RAW.
    * - "USER_ENTERED" : A USER_ENTERED.
    *
-   * [responseDateTimeRenderOption] - Determines how dates, times, and durations
-   * in the response should be
-   * rendered. This is ignored if response_value_render_option is
-   * FORMATTED_VALUE.
-   * The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].
-   * Possible string values are:
-   * - "SERIAL_NUMBER" : A SERIAL_NUMBER.
-   * - "FORMATTED_STRING" : A FORMATTED_STRING.
-   *
-   * [includeValuesInResponse] - Determines if the update response should
-   * include the values
-   * of the cells that were appended. By default, responses
-   * do not include the updated values.
-   *
    * Completes with a [AppendValuesResponse].
    *
    * 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<AppendValuesResponse> append(ValueRange request, core.String spreadsheetId, core.String range, {core.String responseValueRenderOption, core.String insertDataOption, core.String valueInputOption, core.String responseDateTimeRenderOption, core.bool includeValuesInResponse}) {
+  async.Future<AppendValuesResponse> append(ValueRange request, core.String spreadsheetId, core.String range, {core.String responseDateTimeRenderOption, core.bool includeValuesInResponse, core.String responseValueRenderOption, core.String insertDataOption, core.String valueInputOption}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (request != null) {
       _body = convert.JSON.encode((request).toJson());
     }
     if (spreadsheetId == null) {
       throw new core.ArgumentError("Parameter spreadsheetId is required.");
     }
     if (range == null) {
       throw new core.ArgumentError("Parameter range is required.");
     }
+    if (responseDateTimeRenderOption != null) {
+      _queryParams["responseDateTimeRenderOption"] = [responseDateTimeRenderOption];
+    }
+    if (includeValuesInResponse != null) {
+      _queryParams["includeValuesInResponse"] = ["${includeValuesInResponse}"];
+    }
     if (responseValueRenderOption != null) {
       _queryParams["responseValueRenderOption"] = [responseValueRenderOption];
     }
     if (insertDataOption != null) {
       _queryParams["insertDataOption"] = [insertDataOption];
     }
     if (valueInputOption != null) {
       _queryParams["valueInputOption"] = [valueInputOption];
     }
-    if (responseDateTimeRenderOption != null) {
-      _queryParams["responseDateTimeRenderOption"] = [responseDateTimeRenderOption];
-    }
-    if (includeValuesInResponse != null) {
-      _queryParams["includeValuesInResponse"] = ["${includeValuesInResponse}"];
-    }
 
     _url = 'v4/spreadsheets/' + commons.Escaper.ecapeVariable('$spreadsheetId') + '/values/' + commons.Escaper.ecapeVariable('$range') + ':append';
 
     var _response = _requester.request(_url,
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 1266 matching lines @@
    * - "COLUMN" : A <a href="/chart/interactive/docs/gallery/columnchart">column
    * chart</a>.
    * - "SCATTER" : A <a
    * href="/chart/interactive/docs/gallery/scatterchart">scatter chart</a>.
    * - "COMBO" : A <a href="/chart/interactive/docs/gallery/combochart">combo
    * chart</a>.
    */
   core.String chartType;
   /**
    * The domain of data this is charting.
-   * Only a single domain is currently supported.
+   * Only a single domain is supported.
    */
   core.List<BasicChartDomain> domains;
   /**
    * The number of rows or columns in the data that are "headers".
    * If not set, Google Sheets will guess how many rows are headers based
    * on the data.
    *
    * (Note that BasicChartAxis.title may override the axis title
    *  inferred from the header values.)
    */
@@ skipping 119 matching lines @@
 
   core.Map toJson() {
     var _json = new core.Map();
     if (ranges != null) {
       _json["ranges"] = ranges;
     }
     return _json;
   }
 }
 
-/** The response when updating a range of values in a spreadsheet. */
+/** The response when clearing a range of values in a spreadsheet. */
 class BatchClearValuesResponse {
   /**
    * The ranges that were cleared, in A1 notation.
    * (If the requests were for an unbounded range or a ranger larger
    *  than the bounds of the sheet, this will be the actual ranges
    *  that were cleared, bounded to the sheet's limits.)
    */
   core.List<core.String> clearedRanges;
   /** The spreadsheet the updates were applied to. */
   core.String spreadsheetId;
@@ skipping 56 matching lines @@
   }
 }
 
 /** The request for updating any aspect of a spreadsheet. */
 class BatchUpdateSpreadsheetRequest {
   /**
    * Determines if the update response should include the spreadsheet
    * resource.
    */
   core.bool includeSpreadsheetInResponse;
-  /** A list of updates to apply to the spreadsheet. */
+  /**
+   * A list of updates to apply to the spreadsheet.
+   * Requests will be applied in the order they are specified.
+   * If any request is not valid, no requests will be applied.
+   */
   core.List<Request> requests;
   /**
    * True if grid data should be returned. Meaningful only if
    * if include_spreadsheet_response is 'true'.
    * This parameter is ignored if a field mask was set in the request.
    */
   core.bool responseIncludeGridData;
   /**
    * Limits the ranges included in the response spreadsheet.
    * Meaningful only if include_spreadsheet_response is 'true'.
@@ skipping 5938 matching lines @@
     }
     if (range != null) {
       _json["range"] = range;
     }
     if (values != null) {
       _json["values"] = values;
     }
     return _json;
   }
 }