Api-roll 37: 2016-06-06

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;
 
 export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
     ApiRequestError, DetailedApiRequestError;
 
 const core.String USER_AGENT = 'dart-api-client sheets/v4';
 
-/** An API for reading and modifying Google Sheets. */
+/** Reads and writes Google Sheets. */
 class SheetsApi {
   /** View and manage the files in your Google Drive */
   static const DriveScope = "https://www.googleapis.com/auth/drive";
 
   /** View the files in your Google Drive */
   static const DriveReadonlyScope = "https://www.googleapis.com/auth/drive.readonly";
 
   /** View and manage your spreadsheets in Google Drive */
   static const SpreadsheetsScope = "https://www.googleapis.com/auth/spreadsheets";
 
@@ skipping 21 matching lines @@
 
   /**
    * Applies one or more updates to the spreadsheet.
    *
    * Each request is validated before
    * being applied. If any request is not valid then the entire request will
    * fail and nothing will be applied.
    *
    * Some requests have replies to
    * give you some information about how
-   * they applied. The replies will mirror the requests.  For example,
+   * they are applied. The replies will mirror the requests.  For example,
    * if you applied 4 updates and the 3rd one had a reply, then the
    * response will have 2 empty replies, the actual reply, and another empty
    * reply, in that order.
    *
    * Due to the collaborative nature of spreadsheets, it is not guaranteed that
    * the spreadsheet will reflect exactly your changes after this completes,
-   * however it is guaranteed that all the updates in the request will be
-   * applied atomically. Your changes may be altered with respect to
+   * however it is guaranteed that the updates in the request will be
+   * applied together atomically. Your changes may be altered with respect to
    * collaborator changes. If there are no collaborators, the spreadsheet
    * should reflect your changes.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [spreadsheetId] - The spreadsheet to apply the updates to.
    *
    * Completes with a [BatchUpdateSpreadsheetResponse].
@@ skipping 64 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Spreadsheet.fromJson(data));
   }
 
   /**
-   * Returns the spreadsheet at the given id.
+   * Returns the spreadsheet at the given ID.
    * The caller must specify the spreadsheet ID.
    *
    * By default, data within grids will not be returned.
-   * You can include grid data one of two ways: specify a field mask listing
-   * your desired fields (using the `fields` URL parameter in HTTP,
-   * or `FieldMaskContext.response_mask` in the request extensions in an RPC),
-   * or by setting the
-   * includeGridData URL parameter
-   * to true.  If a field mask is set, the `includeGridData` parameter is
-   * ignored.
+   * You can include grid data one of two ways:
+   *
+   * * Specify a field mask listing your desired fields using the `fields` URL
+   * parameter in HTTP
+   *
+   * * Set the includeGridData
+   * URL parameter to true.  If a field mask is set, the `includeGridData`
+   * parameter is ignored
    *
    * For large spreadsheets, it is recommended to retrieve only the specific
    * fields of the spreadsheet that you want.
    *
    * To retrieve only subsets of the spreadsheet, use the
    * ranges URL parameter.
    * Multiple ranges can be specified.  Limiting the range will
    * return only the portions of the spreadsheet that intersect the requested
    * ranges. Ranges are specified using A1 notation.
    *
@@ skipping 54 matching lines @@
       _requester = client;
 
   /**
    * Copies a single sheet from a spreadsheet to another spreadsheet.
    * Returns the properties of the newly created sheet.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [spreadsheetId] - The id of the spreadsheet containing the sheet to copy.
+   * [spreadsheetId] - The ID of the spreadsheet containing the sheet to copy.
    *
    * [sheetId] - The ID of the sheet to copy.
    *
    * Completes with a [SheetProperties].
    *
    * 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.
@@ skipping 36 matching lines @@
 
   SpreadsheetsValuesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Returns one or more ranges of values from a spreadsheet.
    * The caller must specify the spreadsheet ID and one or more ranges.
    *
    * Request parameters:
    *
-   * [spreadsheetId] - The id of the spreadsheet to retrieve data from.
+   * [spreadsheetId] - The ID of the spreadsheet to retrieve data from.
    *
    * [ranges] - The A1 notation of the values to retrieve.
    *
    * [valueRenderOption] - How values should be represented in the output.
    * Possible string values are:
    * - "FORMATTED_VALUE" : A FORMATTED_VALUE.
    * - "UNFORMATTED_VALUE" : A UNFORMATTED_VALUE.
    * - "FORMULA" : A FORMULA.
    *
    * [dateTimeRenderOption] - How dates, times, and durations should be
    * represented in the output.
-   * This is ignored if ValueRenderOption option is
+   * This is ignored if value_render_option is
    * FORMATTED_VALUE.
    * Possible string values are:
    * - "SERIAL_NUMBER" : A SERIAL_NUMBER.
    * - "FORMATTED_STRING" : A FORMATTED_STRING.
    *
    * [majorDimension] - The major dimension that results should use.
    *
    * For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,
    * then requesting `range=A1:B2,majorDimension=ROWS` will return
    * `[[1,2],[3,4]]`,
@@ skipping 42 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new BatchGetValuesResponse.fromJson(data));
   }
 
   /**
-   * Sets values in a range of a spreadsheet.
+   * Sets values in one or more ranges of a spreadsheet.
    * The caller must specify the spreadsheet ID,
    * a valueInputOption, and one or more
    * ValueRanges.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [spreadsheetId] - The id of the spreadsheet to update.
+   * [spreadsheetId] - The ID of the spreadsheet to update.
    *
    * Completes with a [BatchUpdateValuesResponse].
    *
    * 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<BatchUpdateValuesResponse> batchUpdate(BatchUpdateValuesRequest request, core.String spreadsheetId) {
@@ skipping 22 matching lines @@
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new BatchUpdateValuesResponse.fromJson(data));
   }
 
   /**
    * Returns a range of values from a spreadsheet.
    * The caller must specify the spreadsheet ID and a range.
    *
    * Request parameters:
    *
-   * [spreadsheetId] - The id of the spreadsheet to retrieve data from.
+   * [spreadsheetId] - The ID of the spreadsheet to retrieve data from.
    *
    * [range] - The A1 notation of the values to retrieve.
    *
    * [valueRenderOption] - How values should be represented in the output.
    * Possible string values are:
    * - "FORMATTED_VALUE" : A FORMATTED_VALUE.
    * - "UNFORMATTED_VALUE" : A UNFORMATTED_VALUE.
    * - "FORMULA" : A FORMULA.
    *
    * [dateTimeRenderOption] - How dates, times, and durations should be
    * represented in the output.
-   * This is ignored if the ValueRenderOption option is
+   * This is ignored if value_render_option is
    * FORMATTED_VALUE.
    * Possible string values are:
    * - "SERIAL_NUMBER" : A SERIAL_NUMBER.
    * - "FORMATTED_STRING" : A FORMATTED_STRING.
    *
    * [majorDimension] - The major dimension that results should use.
    *
    * For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,
    * then requesting `range=A1:B2,majorDimension=ROWS` will return
    * `[[1,2],[3,4]]`,
@@ skipping 50 matching lines @@
 
   /**
    * Sets values in a range of a spreadsheet.
    * The caller must specify the spreadsheet ID, range, and
    * a valueInputOption.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [spreadsheetId] - The id of the spreadsheet to update.
+   * [spreadsheetId] - The ID of the spreadsheet to update.
    *
    * [range] - The A1 notation of the values to update.
    *
    * [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.
    *
    * Completes with a [UpdateValuesResponse].
@@ skipping 255 matching lines @@
       _json["protectedRange"] = (protectedRange).toJson();
     }
     return _json;
   }
 }
 
 /**
  * Adds a new sheet.
  * When a sheet is added at a given index,
  * all subsequent sheets' indexes are incremented.
- * To add an object sheet, use AddChartRequest instead.
+ * To add an object sheet, use AddChartRequest instead and specify
+ * EmbeddedObjectPosition.sheetId or
+ * EmbeddedObjectPosition.newSheet.
  */
 class AddSheetRequest {
   /**
    * The properties the new sheet should have.
    * All properties are optional.
    * If a sheetId
    * is specified, the sheet will use that ID.
    * (It is an error to specify the ID of a sheet that already exists.)
    */
   SheetProperties properties;
@@ skipping 31 matching lines @@
   core.Map toJson() {
     var _json = new core.Map();
     if (properties != null) {
       _json["properties"] = (properties).toJson();
     }
     return _json;
   }
 }
 
 /**
- * Adds new cells to the last row with data in a sheet,
+ * Adds new cells after the last row with data in a sheet,
  * inserting new rows into the sheet if necessary.
  */
 class AppendCellsRequest {
   /**
    * The fields of CellData that should be updated.
    * At least one field must be specified.
    * The root is the CellData; 'row.values.' should not be specified.
    * A single `"*"` can be used as short-hand for listing every field.
    */
   core.String fields;
@@ skipping 213 matching lines @@
   }
 }
 
 /**
  * The domain of a chart.
  * For example, if charting stock prices over time, this would be the date.
  */
 class BasicChartDomain {
   /**
    * The data of the domain. For example, if charting stock prices over time,
-   * this be the data representing the dates.
+   * this is the data representing the dates.
    */
   ChartData domain;
 
   BasicChartDomain();
 
   BasicChartDomain.fromJson(core.Map _json) {
     if (_json.containsKey("domain")) {
       domain = new ChartData.fromJson(_json["domain"]);
     }
   }
@@ skipping 231 matching lines @@
       _json["sortSpecs"] = sortSpecs.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 /**
  * The response when retrieving more than one range of values in a spreadsheet.
  */
 class BatchGetValuesResponse {
-  /** The id of the spreadsheet to retrieve data from. */
+  /** The ID of the spreadsheet the data was retrieved from. */
   core.String spreadsheetId;
   /**
    * The requested values. The order of the ValueRanges is the same as the
    * order of the requested ranges.
    */
   core.List<ValueRange> valueRanges;
 
   BatchGetValuesResponse();
 
   BatchGetValuesResponse.fromJson(core.Map _json) {
@@ skipping 74 matching lines @@
 
 /** The request for updating more than one range of values in a spreadsheet. */
 class BatchUpdateValuesRequest {
   /** The new values to apply to the spreadsheet. */
   core.List<ValueRange> data;
   /**
    * How the input data should be interpreted.
    * Possible string values are:
    * - "INPUT_VALUE_OPTION_UNSPECIFIED" : Default input value. This value must
    * not be used.
-   * - "RAW" : The values the user is entered will not be parsed and will be
+   * - "RAW" : The values the user has entered will not be parsed and will be
    * stored
    * as-is.
    * - "USER_ENTERED" : The values will be parsed as if the user typed them into
    * the UI.
    * Numbers will stay as numbers, but strings may be converted to numbers,
-   * dates, etc.. following the same rules that are applied when entering
+   * dates, etc. following the same rules that are applied when entering
    * text into a cell via the Google Sheets UI.
    */
   core.String valueInputOption;
 
   BatchUpdateValuesRequest();
 
   BatchUpdateValuesRequest.fromJson(core.Map _json) {
     if (_json.containsKey("data")) {
       data = _json["data"].map((value) => new ValueRange.fromJson(value)).toList();
     }
@@ skipping 282 matching lines @@
   /** The color of the border. */
   Color color;
   /**
    * The style of the border.
    * Possible string values are:
    * - "STYLE_UNSPECIFIED" : The style is not specified. Do not use this.
    * - "DOTTED" : The border is dotted.
    * - "DASHED" : The border is dashed.
    * - "SOLID" : The border is a solid line.
    * - "NONE" : No border.
-   * Used only when updating a border in order erase it.
-   * - "DOUBLE" : The border is double (two solid lines).
+   * Used only when updating a border in order to erase it.
+   * - "DOUBLE" : The border is two solid lines.
    */
   core.String style;
   /**
    * The width of the border, in pixels.
-   * Border widths must be between 0 and 3 pixels.
+   * Border widths must be between 0 and 3 pixels, inclusive.
    */
   core.int width;
 
   Border();
 
   Border.fromJson(core.Map _json) {
     if (_json.containsKey("color")) {
       color = new Color.fromJson(_json["color"]);
     }
     if (_json.containsKey("style")) {
@@ skipping 98 matching lines @@
   /**
    * A hyperlink this cell points to, if any.
    * This field is read-only.  (To set it, use a `=HYPERLINK` formula.)
    */
   core.String hyperlink;
   /** Any note on the cell. */
   core.String note;
   /**
    * A pivot table anchored at this cell. The size of pivot table itself
    * is computed dynamically based on its data, grouping, filters, values,
-   * etc... Only the top-left cell of the pivot table contains the pivot table
+   * etc. Only the top-left cell of the pivot table contains the pivot table
    * definition. The other cells will contain the calculated values of the
-   * results of the pivot in their effectiveValue fields.
+   * results of the pivot in their effective_value fields.
    */
   PivotTable pivotTable;
   /**
-   * Runs of rich text applied to subsections of the cell.
+   * Runs of rich text applied to subsections of the cell.  Runs are only valid
+   * on user entered strings, not formulas, bools, or numbers.
    * Runs start at specific indexes in the text and continue until the next
    * run. Properties of a run will continue unless explicitly changed
    * in a subsequent run (and properties of the first run will continue
    * the properties of the cell unless explicitly changed).
    *
-   * When writing, the new runs will overwrite any prior runs.
+   * When writing, the new runs will overwrite any prior runs.  When writing a
+   * new user_entered_value, previous runs will be erased.
    */
   core.List<TextFormatRun> textFormatRuns;
   /**
    * The format the user entered for the cell.
    *
    * When writing, the new format will be merged with the existing format.
    */
   CellFormat userEnteredFormat;
   /**
    * The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`
@@ skipping 73 matching lines @@
   }
 }
 
 /** The format of a cell. */
 class CellFormat {
   /** The background color of the cell. */
   Color backgroundColor;
   /** The borders of the cell. */
   Borders borders;
   /**
-   * The horizontal alignment of the value in cell.
+   * The horizontal alignment of the value in the cell.
    * Possible string values are:
    * - "HORIZONTAL_ALIGN_UNSPECIFIED" : The horizontal alignment is not
    * specified. Do not use this.
    * - "LEFT" : The text is explicitly aligned to the left of the cell.
    * - "CENTER" : The text is explicitly aligned to the center of the cell.
    * - "RIGHT" : The text is explicitly aligned to the right of the cell.
    */
   core.String horizontalAlignment;
   /**
    * How a hyperlink, if it exists, should be displayed in the cell.
    * Possible string values are:
    * - "HYPERLINK_DISPLAY_TYPE_UNSPECIFIED" : The default value: the hyperlink
-   * is clickable. Do not use this.
+   * is rendered. Do not use this.
    * - "LINKED" : A hyperlink should be explicitly rendered.
    * - "PLAIN_TEXT" : A hyperlink should not be rendered.
    */
   core.String hyperlinkDisplayType;
   /**
    * A format describing how number values should be represented to the user.
    */
   NumberFormat numberFormat;
   /** The padding of the cell. */
   Padding padding;
   /**
    * The direction of the text in the cell.
    * Possible string values are:
    * - "TEXT_DIRECTION_UNSPECIFIED" : The text direction is not specified. Do
    * not use this.
    * - "LEFT_TO_RIGHT" : The text direction of left-to-right was set by the
    * user.
    * - "RIGHT_TO_LEFT" : The text direction of right-to-left was set by the
    * user.
    */
   core.String textDirection;
   /**
    * The format of the text in the cell (unless overridden by a format run).
    */
   TextFormat textFormat;
   /**
-   * The vertical alignment of the value in cell.
+   * The vertical alignment of the value in the cell.
    * Possible string values are:
    * - "VERTICAL_ALIGN_UNSPECIFIED" : The vertical alignment is not specified.
    * Do not use this.
    * - "TOP" : The text is explicitly aligned to the top of the cell.
    * - "MIDDLE" : The text is explicitly aligned to the middle of the cell.
    * - "BOTTOM" : The text is explicitly aligned to the bottom of the cell.
    */
   core.String verticalAlignment;
   /**
    * The wrap strategy for the value in the cell.
    * Possible string values are:
    * - "WRAP_STRATEGY_UNSPECIFIED" : The default value, do not use.
    * - "OVERFLOW_CELL" : Lines that are longer than the cell width will be
    * written in the next
    * cell over, so long as that cell is empty. If the next cell over is
    * non-empty, this behaves the same as CLIP. The text will never wrap
    * to the next line unless the user manually inserts a new line.
    * Example:
    *
    *     | First sentence. |
    *     | Manual newline that is very long. <- Text continues into next cell
    *     | Next newline.   |
    * - "LEGACY_WRAP" : This wrap strategy represents the old Google Sheets wrap
    * strategy where
    * words that are longer than a line are clipped rather than broken. This
    * strategy is not supported on all platforms and is being phased out.
    * Example:
    *
    *     | Cell has a |
-   *     | loooooooooo|ong <- Word is clipped.
+   *     | loooooooooo| <- Word is clipped.
    *     | word.      |
    * - "CLIP" : Lines that are longer than the cell width will be clipped.
    * The text will never wrap to the next line unless the user manually
    * inserts a new line.
    * Example:
    *
    *     | First sentence. |
    *     | Manual newline t| <- Text is clipped
    *     | Next newline.   |
    * - "WRAP" : Words that are longer than a line are wrapped at the character
@@ skipping 137 matching lines @@
       _json["sources"] = sources.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 /** The specifications of a chart. */
 class ChartSpec {
   /**
    * A basic chart specification, can be one of many kinds of charts.
-   * See BasicChartType for the list of all charts this supports.
+   * See BasicChartType for the list of all
+   * charts this supports.
    */
   BasicChartSpec basicChart;
   /**
    * Determines how the charts will use hidden rows or columns.
-   * This value is only meaningful if the
-   * ChartData.sourceRange
-   * is used for a domain or series.
    * Possible string values are:
    * - "CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED" : Default value, do not
    * use.
    * - "SKIP_HIDDEN_ROWS_AND_COLUMNS" : Charts will skip hidden rows and
    * columns.
    * - "SKIP_HIDDEN_ROWS" : Charts will skip hidden rows only.
    * - "SKIP_HIDDEN_COLUMNS" : Charts will skip hidden columns only.
    * - "SHOW_ALL" : Charts will not skip any hidden rows or columns.
    */
   core.String hiddenDimensionStrategy;
@@ skipping 240 matching lines @@
    * DATE_BEFORE,
    * DATE_AFTER,
    * DATE_ON_OR_BEFORE or
    * DATE_ON_OR_AFTER.
    *
    * Relative dates are not supported in data validation.
    * They are supported only in conditional formatting and
    * conditional filters.
    * Possible string values are:
    * - "RELATIVE_DATE_UNSPECIFIED" : Default value, do not use.
-   * - "PAST_YEAR" : The value is the year before today.
-   * - "PAST_MONTH" : The value is the month before today.
-   * - "PAST_WEEK" : The value is the week before today.
+   * - "PAST_YEAR" : The value is one year before today.
+   * - "PAST_MONTH" : The value is one month before today.
+   * - "PAST_WEEK" : The value is one week before today.
    * - "YESTERDAY" : The value is yesterday.
    * - "TODAY" : The value is today.
    * - "TOMORROW" : The value is tomorrow.
    */
   core.String relativeDate;
   /**
    * A value the condition is based on.
    * The value will be parsed as if the user typed into a cell.
    * Formulas are supported (and must begin with an `=`).
    */
@@ skipping 84 matching lines @@
   /**
    * What kind of data to paste.
    * Possible string values are:
    * - "PASTE_NORMAL" : Paste values, formulas, formats, and merges.
    * - "PASTE_VALUES" : Paste the values ONLY without formats, formulas, or
    * merges.
    * - "PASTE_FORMAT" : Paste the format and data validation only.
    * - "PASTE_NO_BORDERS" : Like PASTE_NORMAL but without borders.
    * - "PASTE_FORMULA" : Paste the formulas only.
    * - "PASTE_DATA_VALIDATION" : Paste the data validation only.
-   * - "PASTE_CONDITIONAL_FORMATTING" : Paste the color rules only.
+   * - "PASTE_CONDITIONAL_FORMATTING" : Paste the conditional formatting rules
+   * only.
    */
   core.String pasteType;
   /** The source range to copy. */
   GridRange source;
 
   CopyPasteRequest();
 
   CopyPasteRequest.fromJson(core.Map _json) {
     if (_json.containsKey("destination")) {
       destination = new GridRange.fromJson(_json["destination"]);
@@ skipping 57 matching lines @@
    * What kind of data to paste.  All the source data will be cut, regardless
    * of what is pasted.
    * Possible string values are:
    * - "PASTE_NORMAL" : Paste values, formulas, formats, and merges.
    * - "PASTE_VALUES" : Paste the values ONLY without formats, formulas, or
    * merges.
    * - "PASTE_FORMAT" : Paste the format and data validation only.
    * - "PASTE_NO_BORDERS" : Like PASTE_NORMAL but without borders.
    * - "PASTE_FORMULA" : Paste the formulas only.
    * - "PASTE_DATA_VALIDATION" : Paste the data validation only.
-   * - "PASTE_CONDITIONAL_FORMATTING" : Paste the color rules only.
+   * - "PASTE_CONDITIONAL_FORMATTING" : Paste the conditional formatting rules
+   * only.
    */
   core.String pasteType;
   /** The source data to cut. */
   GridRange source;
 
   CutPasteRequest();
 
   CutPasteRequest.fromJson(core.Map _json) {
     if (_json.containsKey("destination")) {
       destination = new GridCoordinate.fromJson(_json["destination"]);
@@ skipping 206 matching lines @@
 
   core.Map toJson() {
     var _json = new core.Map();
     if (namedRangeId != null) {
       _json["namedRangeId"] = namedRangeId;
     }
     return _json;
   }
 }
 
-/** Deletes the protected range with the given id. */
+/** Deletes the protected range with the given ID. */
 class DeleteProtectedRangeRequest {
   /** The ID of the protected range to delete. */
   core.int protectedRangeId;
 
   DeleteProtectedRangeRequest();
 
   DeleteProtectedRangeRequest.fromJson(core.Map _json) {
     if (_json.containsKey("protectedRangeId")) {
       protectedRangeId = _json["protectedRangeId"];
     }
@@ skipping 329 matching lines @@
   }
 }
 
 /** The position of an embedded object such as a chart. */
 class EmbeddedObjectPosition {
   /**
    * If true, the embedded object will be put on a new sheet whose ID
    * is chosen for you. Used only when writing.
    */
   core.bool newSheet;
-  /** The position the object is overlaid on top of a grid. */
+  /** The position at which the object is overlaid on top of a grid. */
   OverlayPosition overlayPosition;
   /**
    * The sheet this is on. Set only if the embedded object
    * is on its own sheet. Must be non-negative.
    */
   core.int sheetId;
 
   EmbeddedObjectPosition();
 
   EmbeddedObjectPosition.fromJson(core.Map _json) {
@@ skipping 128 matching lines @@
     if (numberValue != null) {
       _json["numberValue"] = numberValue;
     }
     if (stringValue != null) {
       _json["stringValue"] = stringValue;
     }
     return _json;
   }
 }
 
-/** Criteria for showing/hiding rows in a filter, filter view. */
+/** Criteria for showing/hiding rows in a filter or filter view. */
 class FilterCriteria {
   /**
    * A condition that must be true for values to be shown.
    * (This does not override hiddenValues -- if a value is listed there,
    *  it will still be hidden.)
    */
   BooleanCondition condition;
   /** Values that should be hidden. */
   core.List<core.String> hiddenValues;
 
@@ skipping 26 matching lines @@
    * The criteria for showing/hiding values per column.
    * The map's key is the column index, and the value is the criteria for
    * that column.
    */
   core.Map<core.String, FilterCriteria> criteria;
   /** The ID of the filter view. */
   core.int filterViewId;
   /**
    * The named range this filter view is backed by, if any.
    *
-   * When writing, only one of range or namedRangeId
+   * When writing, only one of range or named_range_id
    * may be set.
    */
   core.String namedRangeId;
   /**
    * The range this filter view covers.
    *
-   * When writing, only one of range or namedRangeId
+   * When writing, only one of range or named_range_id
    * may be set.
    */
   GridRange range;
   /**
    * The sort order per column. Later specifications are used when values
    * are equal in the earlier specifications.
    */
   core.List<SortSpec> sortSpecs;
   /** The name of the filter view. */
   core.String title;
@@ skipping 62 matching lines @@
   core.bool matchEntireCell;
   /** The range to find/replace over. */
   GridRange range;
   /** The value to use as the replacement. */
   core.String replacement;
   /**
    * True if the find value is a regex.
    * The regular expression and replacement should follow Java regex rules
    * at https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html.
    * The replacement string is allowed to refer to capturing groups.
-   * For example, if one cell has the contents "`Google Sheets`" and another
-   * has "`Google Docs`", then searching for `"o.* (.*)"` with a replacement of
-   * `"$1 Rocks`"` would change the contents of the cells to
-   * "`GSheets Rocks`" and "`GDocs Rocks`" respectively.
+   * For example, if one cell has the contents `"Google Sheets"` and another
+   * has `"Google Docs"`, then searching for `"o.* (.*)"` with a replacement of
+   * `"$1 Rocks"` would change the contents of the cells to
+   * `"GSheets Rocks"` and `"GDocs Rocks"` respectively.
    */
   core.bool searchByRegex;
   /** The sheet to find/replace over. */
   core.int sheetId;
 
   FindReplaceRequest();
 
   FindReplaceRequest.fromJson(core.Map _json) {
     if (_json.containsKey("allSheets")) {
       allSheets = _json["allSheets"];
@@ skipping 56 matching lines @@
     return _json;
   }
 }
 
 /** The result of the find/replace. */
 class FindReplaceResponse {
   /** The number of formula cells changed. */
   core.int formulasChanged;
   /**
    * The number of occurrences (possibly multiple within a cell) changed.
-   * For example, if replacing "`e`" with "`o`" in "`Google Sheets`", this would
-   * be "`3`" because "`Google Sheets`" -> "`Googlo Shoots`".
+   * For example, if replacing `"e"` with `"o"` in `"Google Sheets"`, this would
+   * be `"3"` because `"Google Sheets"` -> `"Googlo Shoots"`.
    */
   core.int occurrencesChanged;
   /** The number of rows changed. */
   core.int rowsChanged;
   /** The number of sheets changed. */
   core.int sheetsChanged;
   /** The number of non-formula cells changed. */
   core.int valuesChanged;
 
   FindReplaceResponse();
@@ skipping 118 matching lines @@
       _json["sheetId"] = sheetId;
     }
     return _json;
   }
 }
 
 /** Data in the grid, as well as metadata about the dimensions. */
 class GridData {
   /**
    * Metadata about the requested columns in the grid, starting with the column
-   * in startColumn.
+   * in start_column.
    */
   core.List<DimensionProperties> columnMetadata;
   /**
    * The data in the grid, one entry per row,
    * starting with the row in startRow.
    * The values in RowData will correspond to columns starting
-   * at startColumn.
+   * at start_column.
    */
   core.List<RowData> rowData;
   /**
    * Metadata about the requested rows in the grid, starting with the row
-   * in startRow.
+   * in start_row.
    */
   core.List<DimensionProperties> rowMetadata;
   /** The first column this GridData refers to, zero-based. */
   core.int startColumn;
   /** The first row this GridData refers to, zero-based. */
   core.int startRow;
 
   GridData();
 
   GridData.fromJson(core.Map _json) {
@@ skipping 89 matching lines @@
   }
 }
 
 /**
  * A range on a sheet.
  * All indexes are zero-based.
  * Indexes are half open, e.g the start index is inclusive
  * and the end index is exclusive -- [start_index, end_index).
  * Missing indexes indicate the range is unbounded on that side.
  *
- * For example, if "Sheet1" is grid ID 0, then:
+ * For example, if `"Sheet1"` is sheet ID 0, then:
  *
- *   Sheet1!A1:A1 == sheet_id: 0,
+ *   `Sheet1!A1:A1 == sheet_id: 0,
  *                   start_row_index: 0, end_row_index: 1,
- *                   start_column_index: 0, end_column_index: 1
+ *                   start_column_index: 0, end_column_index: 1`
  *
- *   Sheet1!A3:B4 == sheet_id: 0,
+ *   `Sheet1!A3:B4 == sheet_id: 0,
  *                   start_row_index: 2, end_row_index: 4,
- *                   start_column_index: 0, end_column_index: 2
+ *                   start_column_index: 0, end_column_index: 2`
  *
- *   Sheet1!A:B == sheet_id: 0,
- *                 start_column_index: 0, end_column_index: 2
+ *   `Sheet1!A:B == sheet_id: 0,
+ *                 start_column_index: 0, end_column_index: 2`
  *
- *   Sheet1!A5:B == sheet_id: 0,
+ *   `Sheet1!A5:B == sheet_id: 0,
  *                  start_row_index: 4,
- *                  start_column_index: 0, end_column_index: 2
+ *                  start_column_index: 0, end_column_index: 2`
  *
- *   Sheet1 == sheet_id:0
+ *   `Sheet1 == sheet_id:0`
  *
  * The start index must always be less than or equal to the end index.
  * If the start index equals the end index, then the range is empty.
  * Empty ranges are typically not meaningful and are usually rendered in the
  * UI as `#REF!`.
  */
 class GridRange {
   /** The end column (exclusive) of the range, or not set if unbounded. */
   core.int endColumnIndex;
   /** The end row (exclusive) of the range, or not set if unbounded. */
@@ skipping 53 matching lines @@
    * before or after the newly inserted dimensions.
    * True to inherit from the dimensions before (in which case the start
    * index must be greater than 0), and false to inherit from the dimensions
    * after.
    *
    * For example, if row index 0 has red background and row index 1
    * has a green background, then inserting 2 rows at index 1 can inherit
    * either the green or red background.  If `inheritFromBefore` is true,
    * the two new rows will be red (because the row before the insertion point
    * was red), whereas if `inheritFromBefore` is false, the two new rows will
-   * be green (because the rows after the insertion point were green).
+   * be green (because the row after the insertion point was green).
    */
   core.bool inheritFromBefore;
   /**
    * The dimensions to insert.  Both the start and end indexes must be bounded.
    */
   DimensionRange range;
 
   InsertDimensionRequest();
 
   InsertDimensionRequest.fromJson(core.Map _json) {
@@ skipping 11 matching lines @@
       _json["inheritFromBefore"] = inheritFromBefore;
     }
     if (range != null) {
       _json["range"] = (range).toJson();
     }
     return _json;
   }
 }
 
 /**
- * A single interpolation point a gradient conditional format.
+ * A single interpolation point on a gradient conditional format.
  * These pin the gradient color scale according to the color,
  * type and value chosen.
  */
 class InterpolationPoint {
   /** The color this interpolation point should use. */
   Color color;
   /**
    * How the value should be interpreted.
    * Possible string values are:
    * - "INTERPOLATION_POINT_TYPE_UNSPECIFIED" : The default value, do not use.
@@ skipping 92 matching lines @@
 class MoveDimensionRequest {
   /**
    * The zero-based start index of where to move the source data to,
    * based on the coordinates *before* the source data is removed
    * from the grid.  Existing data will be shifted down or right
    * (depending on the dimension) to make room for the moved dimensions.
    * The source dimensions are removed from the grid, so the
    * the data may end up in a different index than specified.
    *
    * For example, given `A1..A5` of `0, 1, 2, 3, 4` and wanting to move
-   * "`1`" and "`2`" to between "`3`" and "`4`", the source would be
-   * `ROWS [1..3)`,and the destination index would be "`4`"
+   * `"1"` and `"2"` to between `"3"` and `"4"`, the source would be
+   * `ROWS [1..3)`,and the destination index would be `"4"`
    * (the zero-based index of row 5).
    * The end result would be `A1..A5` of `0, 3, 1, 2, 4`.
    */
   core.int destinationIndex;
   /** The source dimensions to move. */
   DimensionRange source;
 
   MoveDimensionRequest();
 
   MoveDimensionRequest.fromJson(core.Map _json) {
@@ skipping 48 matching lines @@
     if (namedRangeId != null) {
       _json["namedRangeId"] = namedRangeId;
     }
     if (range != null) {
       _json["range"] = (range).toJson();
     }
     return _json;
   }
 }
 
-/**
- * The number format of a cell.
- * When updating, all fields must be set.
- */
+/** The number format of a cell. */
 class NumberFormat {
-  /** Pattern string used for formatting. */
+  /**
+   * Pattern string used for formatting.  If not set, a default pattern based on
+   * the user's locale will be used if necessary for the given type.
+   */
   core.String pattern;
   /**
    * The type of the number format.
+   * When writing, this field must be set.
    * Possible string values are:
    * - "NUMBER_FORMAT_TYPE_UNSPECIFIED" : The number format is not specified
    * and is based on the contents of the cell.
    * Do not explicitly use this.
    * - "TEXT" : Text formatting, e.g `1000.12`
    * - "NUMBER" : Number formatting, e.g, `1,000.12`
    * - "PERCENT" : Percent formatting, e.g `10.12%`
    * - "CURRENCY" : Currency formatting, e.g `$1,000.12`
    * - "DATE" : Date formatting, e.g `9/26/2008`
    * - "TIME" : Time formatting, e.g `3:59:00 PM`
@@ skipping 147 matching lines @@
   /**
    * How the data should be pasted.
    * Possible string values are:
    * - "PASTE_NORMAL" : Paste values, formulas, formats, and merges.
    * - "PASTE_VALUES" : Paste the values ONLY without formats, formulas, or
    * merges.
    * - "PASTE_FORMAT" : Paste the format and data validation only.
    * - "PASTE_NO_BORDERS" : Like PASTE_NORMAL but without borders.
    * - "PASTE_FORMULA" : Paste the formulas only.
    * - "PASTE_DATA_VALIDATION" : Paste the data validation only.
-   * - "PASTE_CONDITIONAL_FORMATTING" : Paste the color rules only.
+   * - "PASTE_CONDITIONAL_FORMATTING" : Paste the conditional formatting rules
+   * only.
    */
   core.String type;
 
   PasteDataRequest();
 
   PasteDataRequest.fromJson(core.Map _json) {
     if (_json.containsKey("coordinate")) {
       coordinate = new GridCoordinate.fromJson(_json["coordinate"]);
     }
     if (_json.containsKey("data")) {
@@ skipping 125 matching lines @@
    * The order the values in this group should be sorted.
    * Possible string values are:
    * - "SORT_ORDER_UNSPECIFIED" : Default value, do not use this.
    * - "ASCENDING" : Sort ascending.
    * - "DESCENDING" : Sort descending.
    */
   core.String sortOrder;
   /**
    * The column offset of the source range that this grouping is based on.
    *
-   * For example, if the source was `C10:E15', a `sourceColumnOffset` of `0`
+   * For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
    * means this group refers to column `C`, whereas the offset `1` would refer
    * to column `D`.
    */
   core.int sourceColumnOffset;
   /**
    * The bucket of the opposite pivot group to sort by.
    * If not specified, sorting is alphabetical by this group's values.
    */
   PivotGroupSortValueBucket valueBucket;
   /** Metadata about values in the grouping. */
@@ skipping 50 matching lines @@
    * For example, in a pivot table with one row group & two column groups,
    * the row group can list up to two values. The first value corresponds
    * to a value within the first column group, and the second value
    * corresponds to a value in the second column group.  If no values
    * are listed, this would indicate that the row should be sorted according
    * to the "Grand Total" over the column groups. If a single value is listed,
    * this would correspond to using the "Total" of that bucket.
    */
   core.List<ExtendedValue> buckets;
   /**
-   * The offset in the [PivotTable.values] list which the values in this
+   * The offset in the PivotTable.values list which the values in this
    * grouping should be sorted by.
    */
   core.int valuesIndex;
 
   PivotGroupSortValueBucket();
 
   PivotGroupSortValueBucket.fromJson(core.Map _json) {
     if (_json.containsKey("buckets")) {
       buckets = _json["buckets"].map((value) => new ExtendedValue.fromJson(value)).toList();
     }
@@ skipping 52 matching lines @@
 class PivotTable {
   /** Each column grouping in the pivot table. */
   core.List<PivotGroup> columns;
   /**
    * An optional mapping of filters per source column offset.
    *
    * The filters will be applied before aggregating data into the pivot table.
    * The map's key is the column offset of the source range that you want to
    * filter, and the value is the criteria for that column.
    *
-   * For example, if the source was `C10:E15', a key of `0` will have the filter
+   * For example, if the source was `C10:E15`, a key of `0` will have the filter
    * for column `C`, whereas the key `1` is for column `D`.
    */
   core.Map<core.String, PivotFilterCriteria> criteria;
   /** Each row grouping in the pivot table. */
   core.List<PivotGroup> rows;
   /** The range the pivot table is reading data from. */
   GridRange source;
   /**
    * Whether values should be listed horizontally (as columns)
    * or vertically (as rows).
@@ skipping 60 matching lines @@
    */
   core.String formula;
   /**
    * A name to use for the value. This is only used if formula was set.
    * Otherwise, the column name is used.
    */
   core.String name;
   /**
    * The column offset of the source range that this value reads from.
    *
-   * For example, if the source was `C10:E15', a `sourceColumnOffset` of `0`
+   * For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
    * means this value refers to column `C`, whereas the offset `1` would
    * refer to column `D`.
    */
   core.int sourceColumnOffset;
   /**
    * A function to summarize the value.
    * If formula is set, the only supported values are
    * SUM and
    * CUSTOM.
    * If sourceColumnOffset is set, then `CUSTOM`
    * is not supported.
    * Possible string values are:
    * - "PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED" : The default, do not use.
    * - "SUM" : Corresponds to the `SUM` function.
    * - "COUNTA" : Corresponds to the `COUNTA` function.
    * - "COUNT" : Corresponds to the `COUNT` function.
    * - "COUNTUNIQUE" : Corresponds to the `COUNTUNIQUE` function.
    * - "AVERAGE" : Corresponds to the `AVERAGE` function.
    * - "MAX" : Corresponds to the `MAX` function.
    * - "MIN" : Corresponds to the `MIN` function.
    * - "MEDIAN" : Corresponds to the `MEDIAN` function.
    * - "PRODUCT" : Corresponds to the `PRODUCT` function.
    * - "STDEV" : Corresponds to the `STDEV` function.
    * - "STDEVP" : Corresponds to the `STDEVP` function.
    * - "VAR" : Corresponds to the `VAR` function.
    * - "VARP" : Corresponds to the `VARP` function.
    * - "CUSTOM" : Indicates the formula should be used as-is.
-   * Only valid if [PivotValue.formula] was set.
+   * Only valid if PivotValue.formula was set.
    */
   core.String summarizeFunction;
 
   PivotValue();
 
   PivotValue.fromJson(core.Map _json) {
     if (_json.containsKey("formula")) {
       formula = _json["formula"];
     }
     if (_json.containsKey("name")) {
@@ skipping 26 matching lines @@
 }
 
 /** A protected range. */
 class ProtectedRange {
   /** The description of this protected range. */
   core.String description;
   /**
    * The users and groups with edit access to the protected range.
    * This field is only visible to users with edit access to the protected
    * range and the document.
-   * Editors are not supported with warningOnly protection.
+   * Editors are not supported with warning_only protection.
    */
   Editors editors;
   /**
    * The named range this protected range is backed by, if any.
    *
-   * When writing, only one of range or namedRangeId
+   * When writing, only one of range or named_range_id
    * may be set.
    */
   core.String namedRangeId;
   /**
    * The ID of the protected range.
    * This field is read-only.
    */
   core.int protectedRangeId;
   /**
    * The range that is being protected.
    * The range may be fully unbounded, in which case this is considered
    * a protected sheet.
    *
-   * When writing, only one of range or namedRangeId
+   * When writing, only one of range or named_range_id
    * may be set.
    */
   GridRange range;
   /**
    * True if the user who requested this protected range can edit the
    * protected area.
    * This field is read-only.
    */
   core.bool requestingUserCanEdit;
   /**
    * The list of unprotected ranges within a protected sheet.
    * Unprotected ranges are only supported on protected sheets.
    */
   core.List<GridRange> unprotectedRanges;
   /**
-   * True if this this protected range will show a warning when editing.
+   * True if this protected range will show a warning when editing.
    * Warning-based protection means that every user can edit data in the
    * protected range, except editing will prompt a warning asking the user
    * to confirm the edit.
    *
-   * When warning: if this field is true, then editors is ignored.
+   * When writing: if this field is true, then editors is ignored.
    * Additionally, if this field is changed from true to false and the
    * `editors` field is not set (nor included in the field mask), then
    * the editors will be set to all the editors in the document.
    */
   core.bool warningOnly;
 
   ProtectedRange();
 
   ProtectedRange.fromJson(core.Map _json) {
     if (_json.containsKey("description")) {
@@ skipping 57 matching lines @@
  * Only the fields listed in the fields field are updated; others are
  * unchanged.
  *
  * If writing a cell with a formula, the formula's ranges will automatically
  * increment for each field in the range.
  * For example, if writing a cell with formula `=A1` into range B2:C4,
  * B2 would be `=A1`, B3 would be `=A2`, B4 would be `=A3`,
  * C2 would be `=B1`, C3 would be `=B2`, C4 would be `=B3`.
  *
  * To keep the formula's ranges static, use the `$` indicator.
- * For example, using the formula was `=$A$1`, neither
- * the row nor column would increment.
+ * For example, use the formula `=$A$1` to prevent both the row and the
+ * column from incrementing.
  */
 class RepeatCellRequest {
   /** The data to write. */
   CellData cell;
   /**
    * The fields that should be updated.  At least one field must be specified.
    * The root `cell` is implied and should not be specified.
    * A single `"*"` can be used as short-hand for listing every field.
    */
   core.String fields;
@@ skipping 36 matching lines @@
   /** Adds a new conditional format rule. */
   AddConditionalFormatRuleRequest addConditionalFormatRule;
   /** Adds a filter view. */
   AddFilterViewRequest addFilterView;
   /** Adds a named range. */
   AddNamedRangeRequest addNamedRange;
   /** Adds a protected range. */
   AddProtectedRangeRequest addProtectedRange;
   /** Adds a sheet. */
   AddSheetRequest addSheet;
-  /** Appends cells to the last row with data in a sheet. */
+  /** Appends cells after the last row with data in a sheet. */
   AppendCellsRequest appendCells;
   /** Appends dimensions to the end of a sheet. */
   AppendDimensionRequest appendDimension;
   /** Automatically fills in more data based on existing data. */
   AutoFillRequest autoFill;
   /**
    * Automatically resizes one or more dimensions based on the contents
    * of the cells in that dimension.
    */
   AutoResizeDimensionsRequest autoResizeDimensions;
@@ skipping 14 matching lines @@
   /** Deletes a named range. */
   DeleteNamedRangeRequest deleteNamedRange;
   /** Deletes a protected range. */
   DeleteProtectedRangeRequest deleteProtectedRange;
   /** Deletes a sheet. */
   DeleteSheetRequest deleteSheet;
   /** Duplicates a filter view. */
   DuplicateFilterViewRequest duplicateFilterView;
   /** Duplicates a sheet. */
   DuplicateSheetRequest duplicateSheet;
-  /** Finds and replace occurrences of some text with other text. */
+  /** Finds and replaces occurrences of some text with other text. */
   FindReplaceRequest findReplace;
   /** Inserts new rows or columns in a sheet. */
   InsertDimensionRequest insertDimension;
   /** Merges cells together. */
   MergeCellsRequest mergeCells;
   /** Moves rows or columns to another location in a sheet. */
   MoveDimensionRequest moveDimension;
   /** Pastes data (HTML or delimited) into a sheet. */
   PasteDataRequest pasteData;
   /** Repeats a single cell across a range. */
@@ skipping 849 matching lines @@
    * - "RECALCULATION_INTERVAL_UNSPECIFIED" : Default value. This value must not
    * be used.
    * - "ON_CHANGE" : Volatile functions are updated on every change.
    * - "MINUTE" : Volatile functions are updated on every change and every
    * minute.
    * - "HOUR" : Volatile functions are updated on every change and hourly.
    */
   core.String autoRecalc;
   /**
    * The default format of all cells in the spreadsheet.
-   * CellData.effectiveFormat will not be set if the cell's format is equal
-   * to this default format.
+   * CellData.effectiveFormat will not be set if the
+   * cell's format is equal to this default format.
    * This field is read-only.
    */
   CellFormat defaultFormat;
   /**
    * The locale of the spreadsheet in one of the following formats:
+   *
    * * an ISO 639-1 language code such as `en`
+   *
    * * an ISO 639-2 language code such as `fil`, if no 639-1 code exists
+   *
    * * a combination of the ISO language code and country code, such as `en_US`
+   *
    * Note: when updating this field, not all locales/languages are supported.
    */
   core.String locale;
   /**
    * The time zone of the spreadsheet, in CLDR format such as
    * `America/New_York`. If the time zone isn't recognized, this may
    * be a custom time zone such as `GMT-07:00`.
    */
   core.String timeZone;
   /** The title of the spreadsheet. */
@@ skipping 107 matching lines @@
       _json["strikethrough"] = strikethrough;
     }
     if (underline != null) {
       _json["underline"] = underline;
     }
     return _json;
   }
 }
 
 /**
- * A run of a text format. The format of this run continues until explicitly
- * overridden in the next run.
+ * A run of a text format. The format of this run continues until the start
+ * index of the next run.
  * When updating, all fields must be set.
  */
 class TextFormatRun {
   /** The format of this run.  Absent values inherit the cell's format. */
   TextFormat format;
   /** The character index where this run starts. */
   core.int startIndex;
 
   TextFormatRun();
 
@@ skipping 279 matching lines @@
  * or moves a conditional format rule to another index.
  */
 class UpdateConditionalFormatRuleRequest {
   /** The zero-based index of the rule that should be replaced or moved. */
   core.int index;
   /** The zero-based new index the rule should end up at. */
   core.int newIndex;
   /** The rule that should replace the rule at the given index. */
   ConditionalFormatRule rule;
   /**
-   * The sheet of the rule to move.  Required if newIndex is set,
+   * The sheet of the rule to move.  Required if new_index is set,
    * unused otherwise.
    */
   core.int sheetId;
 
   UpdateConditionalFormatRuleRequest();
 
   UpdateConditionalFormatRuleRequest.fromJson(core.Map _json) {
     if (_json.containsKey("index")) {
       index = _json["index"];
     }
@@ skipping 30 matching lines @@
 class UpdateConditionalFormatRuleResponse {
   /** The index of the new rule. */
   core.int newIndex;
   /**
    * The new rule that replaced the old rule (if replacing),
    * or the rule that was moved (if moved)
    */
   ConditionalFormatRule newRule;
   /**
    * The old index of the rule. Not set if a rule was replaced
-   * (because it is the same as newIndex).
+   * (because it is the same as new_index).
    */
   core.int oldIndex;
   /**
    * The old (deleted) rule. Not set if a rule was moved
-   * (because it is the same as newRule).
+   * (because it is the same as new_rule).
    */
   ConditionalFormatRule oldRule;
 
   UpdateConditionalFormatRuleResponse();
 
   UpdateConditionalFormatRuleResponse.fromJson(core.Map _json) {
     if (_json.containsKey("newIndex")) {
       newIndex = _json["newIndex"];
     }
     if (_json.containsKey("newRule")) {
@@ skipping 18 matching lines @@
     if (oldIndex != null) {
       _json["oldIndex"] = oldIndex;
     }
     if (oldRule != null) {
       _json["oldRule"] = (oldRule).toJson();
     }
     return _json;
   }
 }
 
-/**
- * Updates properties of dimensions within the specified range.
- * It is an error to specify read only fields in the field mask.
- */
+/** Updates properties of dimensions within the specified range. */
 class UpdateDimensionPropertiesRequest {
   /**
    * The fields that should be updated.  At least one field must be specified.
    * The root `properties` is implied and should not be specified.
    * A single `"*"` can be used as short-hand for listing every field.
    */
   core.String fields;
   /** Properties to update. */
   DimensionProperties properties;
   /** The rows or columns to update. */
@@ skipping 27 matching lines @@
     return _json;
   }
 }
 
 /**
  * Update an embedded object's position (such as a moving or resizing a
  * chart or image).
  */
 class UpdateEmbeddedObjectPositionRequest {
   /**
-   * The fields of OverlayPosition that should be updated when
-   * setting a new position. Used only if
+   * The fields of OverlayPosition
+   * that should be updated when setting a new position. Used only if
    * newPosition.overlayPosition
    * is set, in which case at least one field must
    * be specified.  The root `newPosition.overlayPosition` is implied and
    * should not be specified.
    * A single `"*"` can be used as short-hand for listing every field.
    */
   core.String fields;
   /**
    * An explicit position to move the embedded object to.
    * If newPosition.sheetId is set,
    * a new sheet with that ID will be created.
    * If newPosition.newSheet is set to true,
    * a new sheet will be created with an ID that will be chosen for you.
    */
   EmbeddedObjectPosition newPosition;
-  /** The id of the object to moved. */
+  /** The ID of the object to moved. */
   core.int objectId;
 
   UpdateEmbeddedObjectPositionRequest();
 
   UpdateEmbeddedObjectPositionRequest.fromJson(core.Map _json) {
     if (_json.containsKey("fields")) {
       fields = _json["fields"];
     }
     if (_json.containsKey("newPosition")) {
       newPosition = new EmbeddedObjectPosition.fromJson(_json["newPosition"]);
@@ skipping 70 matching lines @@
     if (filter != null) {
       _json["filter"] = (filter).toJson();
     }
     return _json;
   }
 }
 
 /**
  * Updates properties of the named range with the specified
  * namedRangeId.
- * It is an error to specify read only fields in the field mask.
  */
 class UpdateNamedRangeRequest {
   /**
    * The fields that should be updated.  At least one field must be specified.
    * The root `namedRange` is implied and should not be specified.
    * A single `"*"` can be used as short-hand for listing every field.
    */
   core.String fields;
   /** The named range to update with the new properties. */
   NamedRange namedRange;
@@ skipping 59 matching lines @@
     if (protectedRange != null) {
       _json["protectedRange"] = (protectedRange).toJson();
     }
     return _json;
   }
 }
 
 /**
  * Updates properties of the sheet with the specified
  * sheetId.
- * It is an error to specify read only fields in the field mask.
  */
 class UpdateSheetPropertiesRequest {
   /**
    * The fields that should be updated.  At least one field must be specified.
    * The root `properties` is implied and should not be specified.
    * A single `"*"` can be used as short-hand for listing every field.
    */
   core.String fields;
   /** The properties to update. */
   SheetProperties properties;
@@ skipping 14 matching lines @@
     if (fields != null) {
       _json["fields"] = fields;
     }
     if (properties != null) {
       _json["properties"] = (properties).toJson();
     }
     return _json;
   }
 }
 
-/**
- * Updates properties of a spreadsheet.
- * It is an error to specify read only fields in the field mask.
- */
+/** Updates properties of a spreadsheet. */
 class UpdateSpreadsheetPropertiesRequest {
   /**
    * The fields that should be updated.  At least one field must be specified.
    * The root 'properties' is implied and should not be specified.
    * A single `"*"` can be used as short-hand for listing every field.
    */
   core.String fields;
   /** The properties to update. */
   SpreadsheetProperties properties;
 
@@ skipping 74 matching lines @@
     }
     return _json;
   }
 }
 
 /** Data within a range of the spreadsheet. */
 class ValueRange {
   /**
    * The major dimension of the values.
    *
-   * For output, if the spreadsheet data is: A1=1,B1=2,A2=3,B2=4,
-   * then requesting range=A1:B2,majorDimension=ROWS will return [[1,2],[3,4]],
-   * whereas requesting range=A1:B2,majorDimension=COLUMNS will return
-   * [[1,3],[2,4]].
+   * For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,
+   * then requesting `range=A1:B2,majorDimension=ROWS` will return
+   * `[[1,2],[3,4]]`,
+   * whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return
+   * `[[1,3],[2,4]]`.
    *
-   * For input, with range=A1:B2,majorDimension=ROWS then [[1,2],[3,4]]
-   * will set A1=1,B1=2,A2=3,B2=4. With range=A1:B2,majorDimension=COLUMNS
-   * then [[1,2],[3,4]] will set A1=1,B1=3,A2=2,B2=4.
+   * For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]`
+   * will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS`
+   * then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`.
    *
    * When writing, if this field is not set, it defaults to ROWS.
    * Possible string values are:
    * - "DIMENSION_UNSPECIFIED" : The default value, do not use.
    * - "ROWS" : Operates on the rows of a sheet.
    * - "COLUMNS" : Operates on the columns of a sheet.
    */
   core.String majorDimension;
   /**
    * The range the values cover, in A1 notation.
    * For output, this range indicates the entire requested range,
    * even though the values will exclude trailing rows and columns.
    */
   core.String range;
   /**
    * The data that was read or to be written.  This is an array of arrays,
    * the outer array representing all the data and each inner array
    * representing a major dimension. Each item in the inner array
    * corresponds with one cell.
    *
    * For output, empty trailing rows and columns will not be included.
    *
    * For input, supported value types are: bool, string, and double.
-   * Null and empty values will be skipped.
+   * Null values will be skipped.
    * To set a cell to an empty value, set the string value to an empty string.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
    */
   core.List<core.List<core.Object>> values;
 
   ValueRange();
 
   ValueRange.fromJson(core.Map _json) {
@@ skipping 15 matching lines @@
     }
     if (range != null) {
       _json["range"] = range;
     }
     if (values != null) {
       _json["values"] = values;
     }
     return _json;
   }
 }