Api-roll 37: 2016-06-06

discovery/googleapis/sheets__v4.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/drive.readonly": {
                     "description": "View the files in your Google Drive"
                 },
                 "https://www.googleapis.com/auth/spreadsheets.readonly": {
                     "description": "View your Google Spreadsheets"
                 },
                 "https://www.googleapis.com/auth/drive": {
                     "description": "View and manage the files in your Google Drive"
                 },
                 "https://www.googleapis.com/auth/spreadsheets": {
                     "description": "View and manage your spreadsheets in Google Drive"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://sheets.googleapis.com/",
     "batchPath": "batch",
     "canonicalName": "Sheets",
-    "description": "An API for reading and modifying Google Sheets.",
+    "description": "Reads and writes Google Sheets.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/sheets/",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "sheets:v4",
     "kind": "discovery#restDescription",
     "name": "sheets",
     "ownerDomain": "google.com",
@@ skipping 102 matching lines @@
                     },
                     "response": {
                         "$ref": "Spreadsheet"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/drive",
                         "https://www.googleapis.com/auth/spreadsheets"
                     ]
                 },
                 "get": {
-                    "description": "Returns the spreadsheet at the given id.\nThe caller must specify the spreadsheet ID.\n\nBy default, data within grids will not be returned.\nYou can include grid data one of two ways: specify a field mask listing\nyour desired fields (using the `fields` URL parameter in HTTP,\nor `FieldMaskContext.response_mask` in the request extensions in an RPC),\nor by setting the\nincludeGridData URL parameter\nto true.  If a field mask is set, the `includeGridData` parameter is\nignored.\n\nFor large spreadsheets, it is recommended to retrieve only the specific\nfields of the spreadsheet that you want.\n\nTo retrieve only subsets of the spreadsheet, use the\nranges URL parameter.\nMultiple ranges can be specified.  Limiting the range will\nreturn only the portions of the spreadsheet that intersect the requested\nranges. Ranges are specified using A1 notation.",
+                    "description": "Returns the spreadsheet at the given ID.\nThe caller must specify the spreadsheet ID.\n\nBy default, data within grids will not be returned.\nYou can include grid data one of two ways:\n\n* Specify a field mask listing your desired fields using the `fields` URL\nparameter in HTTP\n\n* Set the includeGridData\nURL parameter to true.  If a field mask is set, the `includeGridData`\nparameter is ignored\n\nFor large spreadsheets, it is recommended to retrieve only the specific\nfields of the spreadsheet that you want.\n\nTo retrieve only subsets of the spreadsheet, use the\nranges URL parameter.\nMultiple ranges can be specified.  Limiting the range will\nreturn only the portions of the spreadsheet that intersect the requested\nranges. Ranges are specified using A1 notation.",
                     "httpMethod": "GET",
                     "id": "sheets.spreadsheets.get",
                     "parameterOrder": [
                         "spreadsheetId"
                     ],
                     "parameters": {
                         "spreadsheetId": {
                             "description": "The spreadsheet to request.",
                             "location": "path",
                             "required": true,
@@ skipping 16 matching lines @@
                         "$ref": "Spreadsheet"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/drive",
                         "https://www.googleapis.com/auth/drive.readonly",
                         "https://www.googleapis.com/auth/spreadsheets",
                         "https://www.googleapis.com/auth/spreadsheets.readonly"
                     ]
                 },
                 "batchUpdate": {
-                    "description": "Applies one or more updates to the spreadsheet.\n\nEach request is validated before\nbeing applied. If any request is not valid then the entire request will\nfail and nothing will be applied.\n\nSome requests have replies to\ngive you some information about how\nthey applied. The replies will mirror the requests.  For example,\nif you applied 4 updates and the 3rd one had a reply, then the\nresponse will have 2 empty replies, the actual reply, and another empty\nreply, in that order.\n\nDue to the collaborative nature of spreadsheets, it is not guaranteed that\nthe spreadsheet will reflect exactly your changes after this completes,\nhowever it is guaranteed that all the updates in the request will be\napplied atomically. Your changes may be altered with respect to\ncollaborator changes. If there are no collaborators, the spreadsheet\nshould reflect your changes.",
+                    "description": "Applies one or more updates to the spreadsheet.\n\nEach request is validated before\nbeing applied. If any request is not valid then the entire request will\nfail and nothing will be applied.\n\nSome requests have replies to\ngive you some information about how\nthey are applied. The replies will mirror the requests.  For example,\nif you applied 4 updates and the 3rd one had a reply, then the\nresponse will have 2 empty replies, the actual reply, and another empty\nreply, in that order.\n\nDue to the collaborative nature of spreadsheets, it is not guaranteed that\nthe spreadsheet will reflect exactly your changes after this completes,\nhowever it is guaranteed that the updates in the request will be\napplied together atomically. Your changes may be altered with respect to\ncollaborator changes. If there are no collaborators, the spreadsheet\nshould reflect your changes.",
                     "httpMethod": "POST",
                     "id": "sheets.spreadsheets.batchUpdate",
                     "parameterOrder": [
                         "spreadsheetId"
                     ],
                     "parameters": {
                         "spreadsheetId": {
                             "description": "The spreadsheet to apply the updates to.",
                             "location": "path",
                             "required": true,
@@ skipping 29 matching lines @@
                                     "description": "How the input data should be interpreted.",
                                     "enum": [
                                         "INPUT_VALUE_OPTION_UNSPECIFIED",
                                         "RAW",
                                         "USER_ENTERED"
                                     ],
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "spreadsheetId": {
-                                    "description": "The id of the spreadsheet to update.",
+                                    "description": "The ID of the spreadsheet to update.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "range": {
                                     "description": "The A1 notation of the values to update.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
@@ skipping 13 matching lines @@
                         "get": {
                             "description": "Returns a range of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and a range.",
                             "httpMethod": "GET",
                             "id": "sheets.spreadsheets.values.get",
                             "parameterOrder": [
                                 "spreadsheetId",
                                 "range"
                             ],
                             "parameters": {
                                 "spreadsheetId": {
-                                    "description": "The id of the spreadsheet to retrieve data from.",
+                                    "description": "The ID of the spreadsheet to retrieve data from.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "valueRenderOption": {
                                     "description": "How values should be represented in the output.",
                                     "enum": [
                                         "FORMATTED_VALUE",
                                         "UNFORMATTED_VALUE",
                                         "FORMULA"
                                     ],
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "dateTimeRenderOption": {
-                                    "description": "How dates, times, and durations should be represented in the output.\nThis is ignored if the ValueRenderOption option is\nFORMATTED_VALUE.",
+                                    "description": "How dates, times, and durations should be represented in the output.\nThis is ignored if value_render_option is\nFORMATTED_VALUE.",
                                     "enum": [
                                         "SERIAL_NUMBER",
                                         "FORMATTED_STRING"
                                     ],
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "range": {
                                     "description": "The A1 notation of the values to retrieve.",
                                     "location": "path",
@@ skipping 24 matching lines @@
                         },
                         "batchGet": {
                             "description": "Returns one or more ranges of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and one or more ranges.",
                             "httpMethod": "GET",
                             "id": "sheets.spreadsheets.values.batchGet",
                             "parameterOrder": [
                                 "spreadsheetId"
                             ],
                             "parameters": {
                                 "spreadsheetId": {
-                                    "description": "The id of the spreadsheet to retrieve data from.",
+                                    "description": "The ID of the spreadsheet to retrieve data from.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "ranges": {
                                     "description": "The A1 notation of the values to retrieve.",
                                     "location": "query",
                                     "repeated": true,
                                     "type": "string"
                                 },
                                 "valueRenderOption": {
                                     "description": "How values should be represented in the output.",
                                     "enum": [
                                         "FORMATTED_VALUE",
                                         "UNFORMATTED_VALUE",
                                         "FORMULA"
                                     ],
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "dateTimeRenderOption": {
-                                    "description": "How dates, times, and durations should be represented in the output.\nThis is ignored if ValueRenderOption option is\nFORMATTED_VALUE.",
+                                    "description": "How dates, times, and durations should be represented in the output.\nThis is ignored if value_render_option is\nFORMATTED_VALUE.",
                                     "enum": [
                                         "SERIAL_NUMBER",
                                         "FORMATTED_STRING"
                                     ],
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "majorDimension": {
                                     "description": "The major dimension that results should use.\n\nFor example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,\nthen requesting `range=A1:B2,majorDimension=ROWS` will return\n`[[1,2],[3,4]]`,\nwhereas requesting `range=A1:B2,majorDimension=COLUMNS` will return\n`[[1,3],[2,4]]`.",
                                     "enum": [
@@ skipping 10 matching lines @@
                                 "$ref": "BatchGetValuesResponse"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/drive",
                                 "https://www.googleapis.com/auth/drive.readonly",
                                 "https://www.googleapis.com/auth/spreadsheets",
                                 "https://www.googleapis.com/auth/spreadsheets.readonly"
                             ]
                         },
                         "batchUpdate": {
-                            "description": "Sets values in a range of a spreadsheet.\nThe caller must specify the spreadsheet ID,\na valueInputOption, and one or more\nValueRanges.",
+                            "description": "Sets values in one or more ranges of a spreadsheet.\nThe caller must specify the spreadsheet ID,\na valueInputOption, and one or more\nValueRanges.",
                             "httpMethod": "POST",
                             "id": "sheets.spreadsheets.values.batchUpdate",
                             "parameterOrder": [
                                 "spreadsheetId"
                             ],
                             "parameters": {
                                 "spreadsheetId": {
-                                    "description": "The id of the spreadsheet to update.",
+                                    "description": "The ID of the spreadsheet to update.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v4/spreadsheets/{spreadsheetId}/values:batchUpdate",
                             "request": {
                                 "$ref": "BatchUpdateValuesRequest"
                             },
                             "response": {
@@ skipping 18 matching lines @@
                             ],
                             "parameters": {
                                 "sheetId": {
                                     "description": "The ID of the sheet to copy.",
                                     "format": "int32",
                                     "location": "path",
                                     "required": true,
                                     "type": "integer"
                                 },
                                 "spreadsheetId": {
-                                    "description": "The id of the spreadsheet containing the sheet to copy.",
+                                    "description": "The ID of the spreadsheet containing the sheet to copy.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo",
                             "request": {
                                 "$ref": "CopySheetToAnotherSpreadsheetRequest"
                             },
                             "response": {
                                 "$ref": "SheetProperties"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/drive",
                                 "https://www.googleapis.com/auth/spreadsheets"
                             ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20160511",
+    "revision": "20160525",
     "rootUrl": "https://sheets.googleapis.com/",
     "schemas": {
         "AddNamedRangeResponse": {
             "description": "The result of adding a named range.",
             "id": "AddNamedRangeResponse",
             "properties": {
                 "namedRange": {
                     "$ref": "NamedRange",
                     "description": "The named range to add."
                 }
@@ skipping 103 matching lines @@
                     "description": "The new position of the embedded object."
                 }
             },
             "type": "object"
         },
         "UpdateConditionalFormatRuleRequest": {
             "description": "Updates a conditional format rule at the given index,\nor moves a conditional format rule to another index.",
             "id": "UpdateConditionalFormatRuleRequest",
             "properties": {
                 "sheetId": {
-                    "description": "The sheet of the rule to move.  Required if newIndex is set,\nunused otherwise.",
+                    "description": "The sheet of the rule to move.  Required if new_index is set,\nunused otherwise.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "rule": {
                     "$ref": "ConditionalFormatRule",
                     "description": "The rule that should replace the rule at the given index."
                 },
                 "index": {
                     "description": "The zero-based index of the rule that should be replaced or moved.",
                     "format": "int32",
@@ skipping 125 matching lines @@
                 },
                 "totalUpdatedRows": {
                     "description": "The total number of rows where at least one cell in the row was updated.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "UpdateNamedRangeRequest": {
-            "description": "Updates properties of the named range with the specified\nnamedRangeId.\nIt is an error to specify read only fields in the field mask.",
+            "description": "Updates properties of the named range with the specified\nnamedRangeId.",
             "id": "UpdateNamedRangeRequest",
             "properties": {
                 "fields": {
                     "description": "The fields that should be updated.  At least one field must be specified.\nThe root `namedRange` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
                     "format": "google-fieldmask",
                     "type": "string"
                 },
                 "namedRange": {
                     "$ref": "NamedRange",
                     "description": "The named range to update with the new properties."
@@ skipping 49 matching lines @@
                     ],
                     "enumDescriptions": [
                         "Default value. This value must not be used.",
                         "Volatile functions are updated on every change.",
                         "Volatile functions are updated on every change and every minute.",
                         "Volatile functions are updated on every change and hourly."
                     ],
                     "type": "string"
                 },
                 "locale": {
-                    "description": "The locale of the spreadsheet in one of the following formats:\n* an ISO 639-1 language code such as `en`\n* an ISO 639-2 language code such as `fil`, if no 639-1 code exists\n* a combination of the ISO language code and country code, such as `en_US`\nNote: when updating this field, not all locales/languages are supported.",
+                    "description": "The locale of the spreadsheet in one of the following formats:\n\n* an ISO 639-1 language code such as `en`\n\n* an ISO 639-2 language code such as `fil`, if no 639-1 code exists\n\n* a combination of the ISO language code and country code, such as `en_US`\n\nNote: when updating this field, not all locales/languages are supported.",
                     "type": "string"
                 },
                 "title": {
                     "description": "The title of the spreadsheet.",
                     "type": "string"
                 },
                 "defaultFormat": {
                     "$ref": "CellFormat",
-                    "description": "The default format of all cells in the spreadsheet.\nCellData.effectiveFormat will not be set if the cell's format is equal\nto this default format.\nThis field is read-only."
+                    "description": "The default format of all cells in the spreadsheet.\nCellData.effectiveFormat will not be set if the\ncell's format is equal to this default format.\nThis field is read-only."
                 }
             },
             "type": "object"
         },
         "CellData": {
             "description": "Data about a specific cell.",
             "id": "CellData",
             "properties": {
                 "hyperlink": {
                     "description": "A hyperlink this cell points to, if any.\nThis field is read-only.  (To set it, use a `=HYPERLINK` formula.)",
@@ skipping 18 matching lines @@
                 "dataValidation": {
                     "$ref": "DataValidationRule",
                     "description": "A data validation rule on the cell, if any.\n\nWhen writing, the new data validation rule will overwrite any prior rule."
                 },
                 "userEnteredFormat": {
                     "$ref": "CellFormat",
                     "description": "The format the user entered for the cell.\n\nWhen writing, the new format will be merged with the existing format."
                 },
                 "pivotTable": {
                     "$ref": "PivotTable",
-                    "description": "A pivot table anchored at this cell. The size of pivot table itself\nis computed dynamically based on its data, grouping, filters, values,\netc... Only the top-left cell of the pivot table contains the pivot table\ndefinition. The other cells will contain the calculated values of the\nresults of the pivot in their effectiveValue fields."
+                    "description": "A pivot table anchored at this cell. The size of pivot table itself\nis computed dynamically based on its data, grouping, filters, values,\netc. Only the top-left cell of the pivot table contains the pivot table\ndefinition. The other cells will contain the calculated values of the\nresults of the pivot in their effective_value fields."
                 },
                 "textFormatRuns": {
-                    "description": "Runs of rich text applied to subsections of the cell.\nRuns start at specific indexes in the text and continue until the next\nrun. Properties of a run will continue unless explicitly changed\nin a subsequent run (and properties of the first run will continue\nthe properties of the cell unless explicitly changed).\n\nWhen writing, the new runs will overwrite any prior runs.",
+                    "description": "Runs of rich text applied to subsections of the cell.  Runs are only valid\non user entered strings, not formulas, bools, or numbers.\nRuns start at specific indexes in the text and continue until the next\nrun. Properties of a run will continue unless explicitly changed\nin a subsequent run (and properties of the first run will continue\nthe properties of the cell unless explicitly changed).\n\nWhen writing, the new runs will overwrite any prior runs.  When writing a\nnew user_entered_value, previous runs will be erased.",
                     "items": {
                         "$ref": "TextFormatRun"
                     },
                     "type": "array"
                 },
                 "effectiveValue": {
                     "$ref": "ExtendedValue",
                     "description": "The effective value of the cell. For cells with formulas, this will be\nthe calculated value.  For cells with literals, this will be\nthe same as the user_entered_value.\nThis field is read-only."
                 }
             },
@@ skipping 130 matching lines @@
                         "The cell's value must be empty.\nSupported by data validation, conditional formatting and filters.\nRequires no ConditionValues.",
                         "The cell's value must not be empty.\nSupported by data validation, conditional formatting and filters.\nRequires no ConditionValues.",
                         "The condition's formula must evaluate to true.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue."
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DeleteProtectedRangeRequest": {
-            "description": "Deletes the protected range with the given id.",
+            "description": "Deletes the protected range with the given ID.",
             "id": "DeleteProtectedRangeRequest",
             "properties": {
                 "protectedRangeId": {
                     "description": "The ID of the protected range to delete.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "BasicChartDomain": {
             "description": "The domain of a chart.\nFor example, if charting stock prices over time, this would be the date.",
             "id": "BasicChartDomain",
             "properties": {
                 "domain": {
                     "$ref": "ChartData",
-                    "description": "The data of the domain. For example, if charting stock prices over time,\nthis be the data representing the dates."
+                    "description": "The data of the domain. For example, if charting stock prices over time,\nthis is the data representing the dates."
                 }
             },
             "type": "object"
         },
         "DimensionRange": {
             "description": "A range along a single dimension on a sheet.\nAll indexes are zero-based.\nIndexes are half open: the start index is inclusive\nand the end index is exclusive.\nMissing indexes indicate the range is unbounded on that side.",
             "id": "DimensionRange",
             "properties": {
                 "sheetId": {
                     "description": "The sheet this span is on.",
@@ skipping 96 matching lines @@
         },
         "FilterView": {
             "description": "A filter view.",
             "id": "FilterView",
             "properties": {
                 "title": {
                     "description": "The name of the filter view.",
                     "type": "string"
                 },
                 "namedRangeId": {
-                    "description": "The named range this filter view is backed by, if any.\n\nWhen writing, only one of range or namedRangeId\nmay be set.",
+                    "description": "The named range this filter view is backed by, if any.\n\nWhen writing, only one of range or named_range_id\nmay be set.",
                     "type": "string"
                 },
                 "sortSpecs": {
                     "description": "The sort order per column. Later specifications are used when values\nare equal in the earlier specifications.",
                     "items": {
                         "$ref": "SortSpec"
                     },
                     "type": "array"
                 },
                 "range": {
                     "$ref": "GridRange",
-                    "description": "The range this filter view covers.\n\nWhen writing, only one of range or namedRangeId\nmay be set."
+                    "description": "The range this filter view covers.\n\nWhen writing, only one of range or named_range_id\nmay be set."
                 },
                 "criteria": {
                     "additionalProperties": {
                         "$ref": "FilterCriteria"
                     },
                     "description": "The criteria for showing/hiding values per column.\nThe map's key is the column index, and the value is the criteria for\nthat column.",
                     "type": "object"
                 },
                 "filterViewId": {
                     "description": "The ID of the filter view.",
@@ skipping 15 matching lines @@
                     "description": "The sort order per column. Later specifications are used when values\nare equal in the earlier specifications.",
                     "items": {
                         "$ref": "SortSpec"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "TextFormatRun": {
-            "description": "A run of a text format. The format of this run continues until explicitly\noverridden in the next run.\nWhen updating, all fields must be set.",
+            "description": "A run of a text format. The format of this run continues until the start\nindex of the next run.\nWhen updating, all fields must be set.",
             "id": "TextFormatRun",
             "properties": {
                 "startIndex": {
                     "description": "The character index where this run starts.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "format": {
                     "$ref": "TextFormat",
                     "description": "The format of this run.  Absent values inherit the cell's format."
@@ skipping 15 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "UpdateConditionalFormatRuleResponse": {
             "description": "The result of updating a conditional format rule.",
             "id": "UpdateConditionalFormatRuleResponse",
             "properties": {
                 "oldIndex": {
-                    "description": "The old index of the rule. Not set if a rule was replaced\n(because it is the same as newIndex).",
+                    "description": "The old index of the rule. Not set if a rule was replaced\n(because it is the same as new_index).",
                     "format": "int32",
                     "type": "integer"
                 },
                 "newRule": {
                     "$ref": "ConditionalFormatRule",
                     "description": "The new rule that replaced the old rule (if replacing),\nor the rule that was moved (if moved)"
                 },
                 "oldRule": {
                     "$ref": "ConditionalFormatRule",
-                    "description": "The old (deleted) rule. Not set if a rule was moved\n(because it is the same as newRule)."
+                    "description": "The old (deleted) rule. Not set if a rule was moved\n(because it is the same as new_rule)."
                 },
                 "newIndex": {
                     "description": "The index of the new rule.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "FilterCriteria": {
-            "description": "Criteria for showing/hiding rows in a filter, filter view.",
+            "description": "Criteria for showing/hiding rows in a filter or filter view.",
             "id": "FilterCriteria",
             "properties": {
                 "condition": {
                     "$ref": "BooleanCondition",
                     "description": "A condition that must be true for values to be shown.\n(This does not override hiddenValues -- if a value is listed there,\n it will still be hidden.)"
                 },
                 "hiddenValues": {
                     "description": "Values that should be hidden.",
                     "items": {
                         "type": "string"
@@ skipping 52 matching lines @@
                     "description": "A list of values to include in the pivot table.",
                     "items": {
                         "$ref": "PivotValue"
                     },
                     "type": "array"
                 },
                 "criteria": {
                     "additionalProperties": {
                         "$ref": "PivotFilterCriteria"
                     },
-                    "description": "An optional mapping of filters per source column offset.\n\nThe filters will be applied before aggregating data into the pivot table.\nThe map's key is the column offset of the source range that you want to\nfilter, and the value is the criteria for that column.\n\nFor example, if the source was `C10:E15', a key of `0` will have the filter\nfor column `C`, whereas the key `1` is for column `D`.",
+                    "description": "An optional mapping of filters per source column offset.\n\nThe filters will be applied before aggregating data into the pivot table.\nThe map's key is the column offset of the source range that you want to\nfilter, and the value is the criteria for that column.\n\nFor example, if the source was `C10:E15`, a key of `0` will have the filter\nfor column `C`, whereas the key `1` is for column `D`.",
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "DataValidationRule": {
             "description": "A data validation rule.",
             "id": "DataValidationRule",
             "properties": {
                 "condition": {
                     "$ref": "BooleanCondition",
                     "description": "The condition that data in the cell must match."
                 },
                 "inputMessage": {
                     "description": "A message to show the user when adding data to the cell.",
                     "type": "string"
                 },
                 "showCustomUi": {
                     "description": "True if the UI should be customized based on the kind of condition.\nIf true, \"List\" conditions will show a dropdown.",
                     "type": "boolean"
                 },
                 "strict": {
                     "description": "True if invalid data should be rejected.",
                     "type": "boolean"
                 }
             },
             "type": "object"
         },
         "UpdateSpreadsheetPropertiesRequest": {
-            "description": "Updates properties of a spreadsheet.\nIt is an error to specify read only fields in the field mask.",
+            "description": "Updates properties of a spreadsheet.",
             "id": "UpdateSpreadsheetPropertiesRequest",
             "properties": {
                 "fields": {
                     "description": "The fields that should be updated.  At least one field must be specified.\nThe root 'properties' is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
                     "format": "google-fieldmask",
                     "type": "string"
                 },
                 "properties": {
                     "$ref": "SpreadsheetProperties",
                     "description": "The properties to update."
@@ skipping 21 matching lines @@
             "properties": {
                 "valueInputOption": {
                     "description": "How the input data should be interpreted.",
                     "enum": [
                         "INPUT_VALUE_OPTION_UNSPECIFIED",
                         "RAW",
                         "USER_ENTERED"
                     ],
                     "enumDescriptions": [
                         "Default input value. This value must not be used.",
-                        "The values the user is entered will not be parsed and will be stored\nas-is.",
-                        "The values will be parsed as if the user typed them into the UI.\nNumbers will stay as numbers, but strings may be converted to numbers,\ndates, etc.. following the same rules that are applied when entering\ntext into a cell via the Google Sheets UI."
+                        "The values the user has entered will not be parsed and will be stored\nas-is.",
+                        "The values will be parsed as if the user typed them into the UI.\nNumbers will stay as numbers, but strings may be converted to numbers,\ndates, etc. following the same rules that are applied when entering\ntext into a cell via the Google Sheets UI."
                     ],
                     "type": "string"
                 },
                 "data": {
                     "description": "The new values to apply to the spreadsheet.",
                     "items": {
                         "$ref": "ValueRange"
                     },
                     "type": "array"
                 }
@@ skipping 147 matching lines @@
                 },
                 "alpha": {
                     "description": "The fraction of this color that should be applied to the pixel. That is,\nthe final pixel color is defined by the equation:\n\n  pixel color = alpha * (this color) + (1.0 - alpha) * (background color)\n\nThis means that a value of 1.0 corresponds to a solid color, whereas\na value of 0.0 corresponds to a completely transparent color. This\nuses a wrapper message rather than a simple float scalar so that it is\npossible to distinguish between a default value and the value being unset.\nIf omitted, this color object is to be rendered as a solid color\n(as if the alpha value had been explicitly given with a value of 1.0).",
                     "format": "float",
                     "type": "number"
                 }
             },
             "type": "object"
         },
         "AddSheetRequest": {
-            "description": "Adds a new sheet.\nWhen a sheet is added at a given index,\nall subsequent sheets' indexes are incremented.\nTo add an object sheet, use AddChartRequest instead.",
+            "description": "Adds a new sheet.\nWhen a sheet is added at a given index,\nall subsequent sheets' indexes are incremented.\nTo add an object sheet, use AddChartRequest instead and specify\nEmbeddedObjectPosition.sheetId or\nEmbeddedObjectPosition.newSheet.",
             "id": "AddSheetRequest",
             "properties": {
                 "properties": {
                     "$ref": "SheetProperties",
                     "description": "The properties the new sheet should have.\nAll properties are optional.\nIf a sheetId\nis specified, the sheet will use that ID.\n(It is an error to specify the ID of a sheet that already exists.)"
                 }
             },
             "type": "object"
         },
         "AddProtectedRangeRequest": {
             "description": "Adds a new protected range.",
             "id": "AddProtectedRangeRequest",
             "properties": {
                 "protectedRange": {
                     "$ref": "ProtectedRange",
                     "description": "The protected range to be added."
                 }
             },
             "type": "object"
         },
         "ValueRange": {
             "description": "Data within a range of the spreadsheet.",
             "id": "ValueRange",
             "properties": {
                 "values": {
-                    "description": "The data that was read or to be written.  This is an array of arrays,\nthe outer array representing all the data and each inner array\nrepresenting a major dimension. Each item in the inner array\ncorresponds with one cell.\n\nFor output, empty trailing rows and columns will not be included.\n\nFor input, supported value types are: bool, string, and double.\nNull and empty values will be skipped.\nTo set a cell to an empty value, set the string value to an empty string.",
+                    "description": "The data that was read or to be written.  This is an array of arrays,\nthe outer array representing all the data and each inner array\nrepresenting a major dimension. Each item in the inner array\ncorresponds with one cell.\n\nFor output, empty trailing rows and columns will not be included.\n\nFor input, supported value types are: bool, string, and double.\nNull values will be skipped.\nTo set a cell to an empty value, set the string value to an empty string.",
                     "items": {
                         "items": {
                             "type": "any"
                         },
                         "type": "array"
                     },
                     "type": "array"
                 },
                 "range": {
                     "description": "The range the values cover, in A1 notation.\nFor output, this range indicates the entire requested range,\neven though the values will exclude trailing rows and columns.",
                     "type": "string"
                 },
                 "majorDimension": {
-                    "description": "The major dimension of the values.\n\nFor output, if the spreadsheet data is: A1=1,B1=2,A2=3,B2=4,\nthen requesting range=A1:B2,majorDimension=ROWS will return [[1,2],[3,4]],\nwhereas requesting range=A1:B2,majorDimension=COLUMNS will return\n[[1,3],[2,4]].\n\nFor input, with range=A1:B2,majorDimension=ROWS then [[1,2],[3,4]]\nwill set A1=1,B1=2,A2=3,B2=4. With range=A1:B2,majorDimension=COLUMNS\nthen [[1,2],[3,4]] will set A1=1,B1=3,A2=2,B2=4.\n\nWhen writing, if this field is not set, it defaults to ROWS.",
+                    "description": "The major dimension of the values.\n\nFor output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,\nthen requesting `range=A1:B2,majorDimension=ROWS` will return\n`[[1,2],[3,4]]`,\nwhereas requesting `range=A1:B2,majorDimension=COLUMNS` will return\n`[[1,3],[2,4]]`.\n\nFor input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]`\nwill set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS`\nthen `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`.\n\nWhen writing, if this field is not set, it defaults to ROWS.",
                     "enum": [
                         "DIMENSION_UNSPECIFIED",
                         "ROWS",
                         "COLUMNS"
                     ],
                     "enumDescriptions": [
                         "The default value, do not use.",
                         "Operates on the rows of a sheet.",
                         "Operates on the columns of a sheet."
                     ],
@@ skipping 10 matching lines @@
                     "description": "The number of non-formula cells changed.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "rowsChanged": {
                     "description": "The number of rows changed.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "occurrencesChanged": {
-                    "description": "The number of occurrences (possibly multiple within a cell) changed.\nFor example, if replacing \"`e`\" with \"`o`\" in \"`Google Sheets`\", this would\nbe \"`3`\" because \"`Google Sheets`\" -> \"`Googlo Shoots`\".",
+                    "description": "The number of occurrences (possibly multiple within a cell) changed.\nFor example, if replacing `\"e\"` with `\"o\"` in `\"Google Sheets\"`, this would\nbe `\"3\"` because `\"Google Sheets\"` -> `\"Googlo Shoots\"`.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "formulasChanged": {
                     "description": "The number of formula cells changed.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "sheetsChanged": {
                     "description": "The number of sheets changed.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "CellFormat": {
             "description": "The format of a cell.",
             "id": "CellFormat",
             "properties": {
                 "horizontalAlignment": {
-                    "description": "The horizontal alignment of the value in cell.",
+                    "description": "The horizontal alignment of the value in the cell.",
                     "enum": [
                         "HORIZONTAL_ALIGN_UNSPECIFIED",
                         "LEFT",
                         "CENTER",
                         "RIGHT"
                     ],
                     "enumDescriptions": [
                         "The horizontal alignment is not specified. Do not use this.",
                         "The text is explicitly aligned to the left of the cell.",
                         "The text is explicitly aligned to the center of the cell.",
                         "The text is explicitly aligned to the right of the cell."
                     ],
                     "type": "string"
                 },
                 "hyperlinkDisplayType": {
                     "description": "How a hyperlink, if it exists, should be displayed in the cell.",
                     "enum": [
                         "HYPERLINK_DISPLAY_TYPE_UNSPECIFIED",
                         "LINKED",
                         "PLAIN_TEXT"
                     ],
                     "enumDescriptions": [
-                        "The default value: the hyperlink is clickable. Do not use this.",
+                        "The default value: the hyperlink is rendered. Do not use this.",
                         "A hyperlink should be explicitly rendered.",
                         "A hyperlink should not be rendered."
                     ],
                     "type": "string"
                 },
                 "borders": {
                     "$ref": "Borders",
                     "description": "The borders of the cell."
                 },
                 "textDirection": {
@@ skipping 27 matching lines @@
                     "enum": [
                         "WRAP_STRATEGY_UNSPECIFIED",
                         "OVERFLOW_CELL",
                         "LEGACY_WRAP",
                         "CLIP",
                         "WRAP"
                     ],
                     "enumDescriptions": [
                         "The default value, do not use.",
                         "Lines that are longer than the cell width will be written in the next\ncell over, so long as that cell is empty. If the next cell over is\nnon-empty, this behaves the same as CLIP. The text will never wrap\nto the next line unless the user manually inserts a new line.\nExample:\n\n    | First sentence. |\n    | Manual newline that is very long. <- Text continues into next cell\n    | Next newline.   |",
-                        "This wrap strategy represents the old Google Sheets wrap strategy where\nwords that are longer than a line are clipped rather than broken. This\nstrategy is not supported on all platforms and is being phased out.\nExample:\n\n    | Cell has a |\n    | loooooooooo|ong <- Word is clipped.\n    | word.      |",
+                        "This wrap strategy represents the old Google Sheets wrap strategy where\nwords that are longer than a line are clipped rather than broken. This\nstrategy is not supported on all platforms and is being phased out.\nExample:\n\n    | Cell has a |\n    | loooooooooo| <- Word is clipped.\n    | word.      |",
                         "Lines that are longer than the cell width will be clipped.\nThe text will never wrap to the next line unless the user manually\ninserts a new line.\nExample:\n\n    | First sentence. |\n    | Manual newline t| <- Text is clipped\n    | Next newline.   |",
                         "Words that are longer than a line are wrapped at the character level\nrather than clipped.\nExample:\n\n    | Cell has a |\n    | loooooooooo| <- Word is broken.\n    | ong word.  |"
                     ],
                     "type": "string"
                 },
                 "backgroundColor": {
                     "$ref": "Color",
                     "description": "The background color of the cell."
                 },
                 "verticalAlignment": {
-                    "description": "The vertical alignment of the value in cell.",
+                    "description": "The vertical alignment of the value in the cell.",
                     "enum": [
                         "VERTICAL_ALIGN_UNSPECIFIED",
                         "TOP",
                         "MIDDLE",
                         "BOTTOM"
                     ],
                     "enumDescriptions": [
                         "The vertical alignment is not specified.  Do not use this.",
                         "The text is explicitly aligned to the top of the cell.",
                         "The text is explicitly aligned to the middle of the cell.",
                         "The text is explicitly aligned to the bottom of the cell."
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "MoveDimensionRequest": {
             "description": "Moves one or more rows or columns.",
             "id": "MoveDimensionRequest",
             "properties": {
                 "source": {
                     "$ref": "DimensionRange",
                     "description": "The source dimensions to move."
                 },
                 "destinationIndex": {
-                    "description": "The zero-based start index of where to move the source data to,\nbased on the coordinates *before* the source data is removed\nfrom the grid.  Existing data will be shifted down or right\n(depending on the dimension) to make room for the moved dimensions.\nThe source dimensions are removed from the grid, so the\nthe data may end up in a different index than specified.\n\nFor example, given `A1..A5` of `0, 1, 2, 3, 4` and wanting to move\n\"`1`\" and \"`2`\" to between \"`3`\" and \"`4`\", the source would be\n`ROWS [1..3)`,and the destination index would be \"`4`\"\n(the zero-based index of row 5).\nThe end result would be `A1..A5` of `0, 3, 1, 2, 4`.",
+                    "description": "The zero-based start index of where to move the source data to,\nbased on the coordinates *before* the source data is removed\nfrom the grid.  Existing data will be shifted down or right\n(depending on the dimension) to make room for the moved dimensions.\nThe source dimensions are removed from the grid, so the\nthe data may end up in a different index than specified.\n\nFor example, given `A1..A5` of `0, 1, 2, 3, 4` and wanting to move\n`\"1\"` and `\"2\"` to between `\"3\"` and `\"4\"`, the source would be\n`ROWS [1..3)`,and the destination index would be `\"4\"`\n(the zero-based index of row 5).\nThe end result would be `A1..A5` of `0, 3, 1, 2, 4`.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "BasicChartAxis": {
             "description": "An axis of the chart.\nA chart may not have more than one axis per\naxis position.",
             "id": "BasicChartAxis",
             "properties": {
@@ skipping 29 matching lines @@
             "id": "PivotGroupSortValueBucket",
             "properties": {
                 "buckets": {
                     "description": "Determines the bucket from which values are chosen to sort.\n\nFor example, in a pivot table with one row group & two column groups,\nthe row group can list up to two values. The first value corresponds\nto a value within the first column group, and the second value\ncorresponds to a value in the second column group.  If no values\nare listed, this would indicate that the row should be sorted according\nto the \"Grand Total\" over the column groups. If a single value is listed,\nthis would correspond to using the \"Total\" of that bucket.",
                     "items": {
                         "$ref": "ExtendedValue"
                     },
                     "type": "array"
                 },
                 "valuesIndex": {
-                    "description": "The offset in the [PivotTable.values] list which the values in this\ngrouping should be sorted by.",
+                    "description": "The offset in the PivotTable.values list which the values in this\ngrouping should be sorted by.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "DimensionProperties": {
             "description": "Properties about a dimension.",
             "id": "DimensionProperties",
             "properties": {
@@ skipping 17 matching lines @@
             "description": "The position of an embedded object such as a chart.",
             "id": "EmbeddedObjectPosition",
             "properties": {
                 "sheetId": {
                     "description": "The sheet this is on. Set only if the embedded object\nis on its own sheet. Must be non-negative.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "overlayPosition": {
                     "$ref": "OverlayPosition",
-                    "description": "The position the object is overlaid on top of a grid."
+                    "description": "The position at which the object is overlaid on top of a grid."
                 },
                 "newSheet": {
                     "description": "If true, the embedded object will be put on a new sheet whose ID\nis chosen for you. Used only when writing.",
                     "type": "boolean"
                 }
             },
             "type": "object"
         },
         "InterpolationPoint": {
-            "description": "A single interpolation point a gradient conditional format.\nThese pin the gradient color scale according to the color,\ntype and value chosen.",
+            "description": "A single interpolation point on a gradient conditional format.\nThese pin the gradient color scale according to the color,\ntype and value chosen.",
             "id": "InterpolationPoint",
             "properties": {
                 "value": {
                     "description": "The value this interpolation point uses.  May be a formula.\nUnused if type is MIN or\nMAX.",
                     "type": "string"
                 },
                 "color": {
                     "$ref": "Color",
                     "description": "The color this interpolation point should use."
                 },
@@ skipping 145 matching lines @@
                     "items": {
                         "$ref": "GridRange"
                     },
                     "type": "array"
                 },
                 "description": {
                     "description": "The description of this protected range.",
                     "type": "string"
                 },
                 "namedRangeId": {
-                    "description": "The named range this protected range is backed by, if any.\n\nWhen writing, only one of range or namedRangeId\nmay be set.",
+                    "description": "The named range this protected range is backed by, if any.\n\nWhen writing, only one of range or named_range_id\nmay be set.",
                     "type": "string"
                 },
                 "requestingUserCanEdit": {
                     "description": "True if the user who requested this protected range can edit the\nprotected area.\nThis field is read-only.",
                     "type": "boolean"
                 },
                 "editors": {
                     "$ref": "Editors",
-                    "description": "The users and groups with edit access to the protected range.\nThis field is only visible to users with edit access to the protected\nrange and the document.\nEditors are not supported with warningOnly protection."
+                    "description": "The users and groups with edit access to the protected range.\nThis field is only visible to users with edit access to the protected\nrange and the document.\nEditors are not supported with warning_only protection."
                 },
                 "protectedRangeId": {
                     "description": "The ID of the protected range.\nThis field is read-only.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "warningOnly": {
-                    "description": "True if this this protected range will show a warning when editing.\nWarning-based protection means that every user can edit data in the\nprotected range, except editing will prompt a warning asking the user\nto confirm the edit.\n\nWhen warning: if this field is true, then editors is ignored.\nAdditionally, if this field is changed from true to false and the\n`editors` field is not set (nor included in the field mask), then\nthe editors will be set to all the editors in the document.",
+                    "description": "True if this protected range will show a warning when editing.\nWarning-based protection means that every user can edit data in the\nprotected range, except editing will prompt a warning asking the user\nto confirm the edit.\n\nWhen writing: if this field is true, then editors is ignored.\nAdditionally, if this field is changed from true to false and the\n`editors` field is not set (nor included in the field mask), then\nthe editors will be set to all the editors in the document.",
                     "type": "boolean"
                 },
                 "range": {
                     "$ref": "GridRange",
-                    "description": "The range that is being protected.\nThe range may be fully unbounded, in which case this is considered\na protected sheet.\n\nWhen writing, only one of range or namedRangeId\nmay be set."
+                    "description": "The range that is being protected.\nThe range may be fully unbounded, in which case this is considered\na protected sheet.\n\nWhen writing, only one of range or named_range_id\nmay be set."
                 }
             },
             "type": "object"
         },
         "DeleteConditionalFormatRuleRequest": {
             "description": "Deletes a conditional format rule at the given index.\nAll subsequent rules' indexes are decremented.",
             "id": "DeleteConditionalFormatRuleRequest",
             "properties": {
                 "sheetId": {
                     "description": "The sheet the rule is being deleted from.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "index": {
                     "description": "The zero-based index of the rule to be deleted.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "ChartSpec": {
             "description": "The specifications of a chart.",
             "id": "ChartSpec",
             "properties": {
                 "hiddenDimensionStrategy": {
-                    "description": "Determines how the charts will use hidden rows or columns.\nThis value is only meaningful if the\nChartData.sourceRange\nis used for a domain or series.",
+                    "description": "Determines how the charts will use hidden rows or columns.",
                     "enum": [
                         "CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED",
                         "SKIP_HIDDEN_ROWS_AND_COLUMNS",
                         "SKIP_HIDDEN_ROWS",
                         "SKIP_HIDDEN_COLUMNS",
                         "SHOW_ALL"
                     ],
                     "enumDescriptions": [
                         "Default value, do not use.",
                         "Charts will skip hidden rows and columns.",
                         "Charts will skip hidden rows only.",
                         "Charts will skip hidden columns only.",
                         "Charts will not skip any hidden rows or columns."
                     ],
                     "type": "string"
                 },
                 "basicChart": {
                     "$ref": "BasicChartSpec",
-                    "description": "A basic chart specification, can be one of many kinds of charts.\nSee BasicChartType for the list of all charts this supports."
+                    "description": "A basic chart specification, can be one of many kinds of charts.\nSee BasicChartType for the list of all\ncharts this supports."
                 },
                 "title": {
                     "description": "The title of the chart.",
                     "type": "string"
                 },
                 "pieChart": {
                     "$ref": "PieChartSpec",
                     "description": "A pie chart specification."
                 }
             },
@@ skipping 39 matching lines @@
                         "RELATIVE_DATE_UNSPECIFIED",
                         "PAST_YEAR",
                         "PAST_MONTH",
                         "PAST_WEEK",
                         "YESTERDAY",
                         "TODAY",
                         "TOMORROW"
                     ],
                     "enumDescriptions": [
                         "Default value, do not use.",
-                        "The value is the year before today.",
-                        "The value is the month before today.",
-                        "The value is the week before today.",
+                        "The value is one year before today.",
+                        "The value is one month before today.",
+                        "The value is one week before today.",
                         "The value is yesterday.",
                         "The value is today.",
                         "The value is tomorrow."
                     ],
                     "type": "string"
                 },
                 "userEnteredValue": {
                     "description": "A value the condition is based on.\nThe value will be parsed as if the user typed into a cell.\nFormulas are supported (and must begin with an `=`).",
                     "type": "string"
                 }
@@ skipping 27 matching lines @@
                         "PASTE_DATA_VALIDATION",
                         "PASTE_CONDITIONAL_FORMATTING"
                     ],
                     "enumDescriptions": [
                         "Paste values, formulas, formats, and merges.",
                         "Paste the values ONLY without formats, formulas, or merges.",
                         "Paste the format and data validation only.",
                         "Like PASTE_NORMAL but without borders.",
                         "Paste the formulas only.",
                         "Paste the data validation only.",
-                        "Paste the color rules only."
+                        "Paste the conditional formatting rules only."
                     ],
                     "type": "string"
                 },
                 "html": {
                     "description": "True if the data is HTML.",
                     "type": "boolean"
                 }
             },
             "type": "object"
         },
         "FindReplaceRequest": {
             "description": "Finds and replaces data in cells over a range, sheet, or all sheets.",
             "id": "FindReplaceRequest",
             "properties": {
                 "find": {
                     "description": "The value to search.",
                     "type": "string"
                 },
                 "replacement": {
                     "description": "The value to use as the replacement.",
                     "type": "string"
                 },
                 "searchByRegex": {
-                    "description": "True if the find value is a regex.\nThe regular expression and replacement should follow Java regex rules\nat https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html.\nThe replacement string is allowed to refer to capturing groups.\nFor example, if one cell has the contents \"`Google Sheets`\" and another\nhas \"`Google Docs`\", then searching for `\"o.* (.*)\"` with a replacement of\n`\"$1 Rocks`\"` would change the contents of the cells to\n\"`GSheets Rocks`\" and \"`GDocs Rocks`\" respectively.",
+                    "description": "True if the find value is a regex.\nThe regular expression and replacement should follow Java regex rules\nat https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html.\nThe replacement string is allowed to refer to capturing groups.\nFor example, if one cell has the contents `\"Google Sheets\"` and another\nhas `\"Google Docs\"`, then searching for `\"o.* (.*)\"` with a replacement of\n`\"$1 Rocks\"` would change the contents of the cells to\n`\"GSheets Rocks\"` and `\"GDocs Rocks\"` respectively.",
                     "type": "boolean"
                 },
                 "sheetId": {
                     "description": "The sheet to find/replace over.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "allSheets": {
                     "description": "True to find/replace over all sheets.",
                     "type": "boolean"
@@ skipping 48 matching lines @@
             "id": "CopySheetToAnotherSpreadsheetRequest",
             "properties": {
                 "destinationSpreadsheetId": {
                     "description": "The ID of the spreadsheet to copy the sheet to.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "NumberFormat": {
-            "description": "The number format of a cell.\nWhen updating, all fields must be set.",
+            "description": "The number format of a cell.",
             "id": "NumberFormat",
             "properties": {
                 "pattern": {
-                    "description": "Pattern string used for formatting.",
+                    "description": "Pattern string used for formatting.  If not set, a default pattern based on\nthe user's locale will be used if necessary for the given type.",
                     "type": "string"
                 },
                 "type": {
-                    "description": "The type of the number format.",
+                    "description": "The type of the number format.\nWhen writing, this field must be set.",
                     "enum": [
                         "NUMBER_FORMAT_TYPE_UNSPECIFIED",
                         "TEXT",
                         "NUMBER",
                         "PERCENT",
                         "CURRENCY",
                         "DATE",
                         "TIME",
                         "DATE_TIME",
                         "SCIENTIFIC"
                     ],
                     "enumDescriptions": [
                         "The number format is not specified\nand is based on the contents of the cell.\nDo not explicitly use this.",
                         "Text formatting, e.g `1000.12`",
                         "Number formatting, e.g, `1,000.12`",
                         "Percent formatting, e.g `10.12%`",
                         "Currency formatting, e.g `$1,000.12`",
                         "Date formatting, e.g `9/26/2008`",
                         "Time formatting, e.g `3:59:00 PM`",
                         "Date+Time formatting, e.g `9/26/08 15:59:00`",
                         "Scientific number formatting, e.g `1.01E+03`"
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "UpdateDimensionPropertiesRequest": {
-            "description": "Updates properties of dimensions within the specified range.\nIt is an error to specify read only fields in the field mask.",
+            "description": "Updates properties of dimensions within the specified range.",
             "id": "UpdateDimensionPropertiesRequest",
             "properties": {
                 "fields": {
                     "description": "The fields that should be updated.  At least one field must be specified.\nThe root `properties` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
                     "format": "google-fieldmask",
                     "type": "string"
                 },
                 "range": {
                     "$ref": "DimensionRange",
                     "description": "The rows or columns to update."
@@ skipping 57 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "GridData": {
             "description": "Data in the grid, as well as metadata about the dimensions.",
             "id": "GridData",
             "properties": {
                 "columnMetadata": {
-                    "description": "Metadata about the requested columns in the grid, starting with the column\nin startColumn.",
+                    "description": "Metadata about the requested columns in the grid, starting with the column\nin start_column.",
                     "items": {
                         "$ref": "DimensionProperties"
                     },
                     "type": "array"
                 },
                 "rowData": {
-                    "description": "The data in the grid, one entry per row,\nstarting with the row in startRow.\nThe values in RowData will correspond to columns starting\nat startColumn.",
+                    "description": "The data in the grid, one entry per row,\nstarting with the row in startRow.\nThe values in RowData will correspond to columns starting\nat start_column.",
                     "items": {
                         "$ref": "RowData"
                     },
                     "type": "array"
                 },
                 "startRow": {
                     "description": "The first row this GridData refers to, zero-based.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "rowMetadata": {
-                    "description": "Metadata about the requested rows in the grid, starting with the row\nin startRow.",
+                    "description": "Metadata about the requested rows in the grid, starting with the row\nin start_row.",
                     "items": {
                         "$ref": "DimensionProperties"
                     },
                     "type": "array"
                 },
                 "startColumn": {
                     "description": "The first column this GridData refers to, zero-based.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "PivotValue": {
             "description": "The definition of how a value in a pivot table should be calculated.",
             "id": "PivotValue",
             "properties": {
                 "formula": {
                     "description": "A custom formula to calculate the value.  The formula must start\nwith an `=` character.",
                     "type": "string"
                 },
                 "sourceColumnOffset": {
-                    "description": "The column offset of the source range that this value reads from.\n\nFor example, if the source was `C10:E15', a `sourceColumnOffset` of `0`\nmeans this value refers to column `C`, whereas the offset `1` would\nrefer to column `D`.",
+                    "description": "The column offset of the source range that this value reads from.\n\nFor example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`\nmeans this value refers to column `C`, whereas the offset `1` would\nrefer to column `D`.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "summarizeFunction": {
                     "description": "A function to summarize the value.\nIf formula is set, the only supported values are\nSUM and\nCUSTOM.\nIf sourceColumnOffset is set, then `CUSTOM`\nis not supported.",
                     "enum": [
                         "PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED",
                         "SUM",
                         "COUNTA",
                         "COUNT",
@@ skipping 17 matching lines @@
                         "Corresponds to the `COUNTUNIQUE` function.",
                         "Corresponds to the `AVERAGE` function.",
                         "Corresponds to the `MAX` function.",
                         "Corresponds to the `MIN` function.",
                         "Corresponds to the `MEDIAN` function.",
                         "Corresponds to the `PRODUCT` function.",
                         "Corresponds to the `STDEV` function.",
                         "Corresponds to the `STDEVP` function.",
                         "Corresponds to the `VAR` function.",
                         "Corresponds to the `VARP` function.",
-                        "Indicates the formula should be used as-is.\nOnly valid if [PivotValue.formula] was set."
+                        "Indicates the formula should be used as-is.\nOnly valid if PivotValue.formula was set."
                     ],
                     "type": "string"
                 },
                 "name": {
                     "description": "A name to use for the value. This is only used if formula was set.\nOtherwise, the column name is used.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
@@ skipping 82 matching lines @@
                         "DASHED",
                         "SOLID",
                         "NONE",
                         "DOUBLE"
                     ],
                     "enumDescriptions": [
                         "The style is not specified. Do not use this.",
                         "The border is dotted.",
                         "The border is dashed.",
                         "The border is a solid line.",
-                        "No border.\nUsed only when updating a border in order erase it.",
-                        "The border is double (two solid lines)."
+                        "No border.\nUsed only when updating a border in order to erase it.",
+                        "The border is two solid lines."
                     ],
                     "type": "string"
                 },
                 "width": {
-                    "description": "The width of the border, in pixels.\nBorder widths must be between 0 and 3 pixels.",
+                    "description": "The width of the border, in pixels.\nBorder widths must be between 0 and 3 pixels, inclusive.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "color": {
                     "$ref": "Color",
                     "description": "The color of the border."
                 }
             },
             "type": "object"
         },
@@ skipping 13 matching lines @@
             "id": "AddChartResponse",
             "properties": {
                 "chart": {
                     "$ref": "EmbeddedChart",
                     "description": "The newly added chart."
                 }
             },
             "type": "object"
         },
         "AppendCellsRequest": {
-            "description": "Adds new cells to the last row with data in a sheet,\ninserting new rows into the sheet if necessary.",
+            "description": "Adds new cells after the last row with data in a sheet,\ninserting new rows into the sheet if necessary.",
             "id": "AppendCellsRequest",
             "properties": {
                 "sheetId": {
                     "description": "The sheet ID to append the data to.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "rows": {
                     "description": "The data to append.",
                     "items": {
@@ skipping 66 matching lines @@
                         "A <a href=\"/chart/interactive/docs/gallery/columnchart\">column chart</a>.",
                         "A <a href=\"/chart/interactive/docs/gallery/scatterchart\">scatter chart</a>.",
                         "A <a href=\"/chart/interactive/docs/gallery/combochart\">combo chart</a>."
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "RepeatCellRequest": {
-            "description": "Updates all cells in the range to the values in the given Cell object.\nOnly the fields listed in the fields field are updated; others are\nunchanged.\n\nIf writing a cell with a formula, the formula's ranges will automatically\nincrement for each field in the range.\nFor example, if writing a cell with formula `=A1` into range B2:C4,\nB2 would be `=A1`, B3 would be `=A2`, B4 would be `=A3`,\nC2 would be `=B1`, C3 would be `=B2`, C4 would be `=B3`.\n\nTo keep the formula's ranges static, use the `$` indicator.\nFor example, using the formula was `=$A$1`, neither\nthe row nor column would increment.",
+            "description": "Updates all cells in the range to the values in the given Cell object.\nOnly the fields listed in the fields field are updated; others are\nunchanged.\n\nIf writing a cell with a formula, the formula's ranges will automatically\nincrement for each field in the range.\nFor example, if writing a cell with formula `=A1` into range B2:C4,\nB2 would be `=A1`, B3 would be `=A2`, B4 would be `=A3`,\nC2 would be `=B1`, C3 would be `=B2`, C4 would be `=B3`.\n\nTo keep the formula's ranges static, use the `$` indicator.\nFor example, use the formula `=$A$1` to prevent both the row and the\ncolumn from incrementing.",
             "id": "RepeatCellRequest",
             "properties": {
                 "cell": {
                     "$ref": "CellData",
                     "description": "The data to write."
                 },
                 "fields": {
                     "description": "The fields that should be updated.  At least one field must be specified.\nThe root `cell` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
                     "format": "google-fieldmask",
                     "type": "string"
@@ skipping 112 matching lines @@
         },
         "UpdateEmbeddedObjectPositionRequest": {
             "description": "Update an embedded object's position (such as a moving or resizing a\nchart or image).",
             "id": "UpdateEmbeddedObjectPositionRequest",
             "properties": {
                 "newPosition": {
                     "$ref": "EmbeddedObjectPosition",
                     "description": "An explicit position to move the embedded object to.\nIf newPosition.sheetId is set,\na new sheet with that ID will be created.\nIf newPosition.newSheet is set to true,\na new sheet will be created with an ID that will be chosen for you."
                 },
                 "objectId": {
-                    "description": "The id of the object to moved.",
+                    "description": "The ID of the object to moved.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "fields": {
-                    "description": "The fields of OverlayPosition that should be updated when\nsetting a new position. Used only if\nnewPosition.overlayPosition\nis set, in which case at least one field must\nbe specified.  The root `newPosition.overlayPosition` is implied and\nshould not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
+                    "description": "The fields of OverlayPosition\nthat should be updated when setting a new position. Used only if\nnewPosition.overlayPosition\nis set, in which case at least one field must\nbe specified.  The root `newPosition.overlayPosition` is implied and\nshould not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
                     "format": "google-fieldmask",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AutoResizeDimensionsRequest": {
             "description": "Automatically resizes one or more dimensions based on the contents\nof the cells in that dimension.",
             "id": "AutoResizeDimensionsRequest",
             "properties": {
@@ skipping 27 matching lines @@
                         "DESCENDING"
                     ],
                     "enumDescriptions": [
                         "Default value, do not use this.",
                         "Sort ascending.",
                         "Sort descending."
                     ],
                     "type": "string"
                 },
                 "sourceColumnOffset": {
-                    "description": "The column offset of the source range that this grouping is based on.\n\nFor example, if the source was `C10:E15', a `sourceColumnOffset` of `0`\nmeans this group refers to column `C`, whereas the offset `1` would refer\nto column `D`.",
+                    "description": "The column offset of the source range that this grouping is based on.\n\nFor example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`\nmeans this group refers to column `C`, whereas the offset `1` would refer\nto column `D`.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "showTotals": {
                     "description": "True if the pivot table should include the totals for this grouping.",
                     "type": "boolean"
                 },
                 "valueBucket": {
                     "$ref": "PivotGroupSortValueBucket",
                     "description": "The bucket of the opposite pivot group to sort by.\nIf not specified, sorting is alphabetical by this group's values."
                 },
                 "valueMetadata": {
                     "description": "Metadata about values in the grouping.",
                     "items": {
                         "$ref": "PivotGroupValueMetadata"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "GridRange": {
-            "description": "A range on a sheet.\nAll indexes are zero-based.\nIndexes are half open, e.g the start index is inclusive\nand the end index is exclusive -- [start_index, end_index).\nMissing indexes indicate the range is unbounded on that side.\n\nFor example, if \"Sheet1\" is grid ID 0, then:\n\n  Sheet1!A1:A1 == sheet_id: 0,\n                  start_row_index: 0, end_row_index: 1,\n                  start_column_index: 0, end_column_index: 1\n\n  Sheet1!A3:B4 == sheet_id: 0,\n                  start_row_index: 2, end_row_index: 4,\n                  start_column_index: 0, end_column_index: 2\n\n  Sheet1!A:B == sheet_id: 0,\n                start_column_index: 0, end_column_index: 2\n\n  Sheet1!A5:B == sheet_id: 0,\n                 start_row_index: 4,\n                 start_column_index: 0, end_column_index: 2\n\n  Sheet1 == sheet_id:0\n\nThe start index must always be less than or equal to the end index.\nIf the start index equals the end index, then the range is empty.\nEmpty ranges are typically not meaningful and are usually rendered in the\nUI as `#REF!`.",
+            "description": "A range on a sheet.\nAll indexes are zero-based.\nIndexes are half open, e.g the start index is inclusive\nand the end index is exclusive -- [start_index, end_index).\nMissing indexes indicate the range is unbounded on that side.\n\nFor example, if `\"Sheet1\"` is sheet ID 0, then:\n\n  `Sheet1!A1:A1 == sheet_id: 0,\n                  start_row_index: 0, end_row_index: 1,\n                  start_column_index: 0, end_column_index: 1`\n\n  `Sheet1!A3:B4 == sheet_id: 0,\n                  start_row_index: 2, end_row_index: 4,\n                  start_column_index: 0, end_column_index: 2`\n\n  `Sheet1!A:B == sheet_id: 0,\n                start_column_index: 0, end_column_index: 2`\n\n  `Sheet1!A5:B == sheet_id: 0,\n                 start_row_index: 4,\n                 start_column_index: 0, end_column_index: 2`\n\n  `Sheet1 == sheet_id:0`\n\nThe start index must always be less than or equal to the end index.\nIf the start index equals the end index, then the range is empty.\nEmpty ranges are typically not meaningful and are usually rendered in the\nUI as `#REF!`.",
             "id": "GridRange",
             "properties": {
                 "sheetId": {
                     "description": "The sheet this range is on.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "startColumnIndex": {
                     "description": "The start column (inclusive) of the range, or not set if unbounded.",
                     "format": "int32",
@@ skipping 112 matching lines @@
                         "PASTE_DATA_VALIDATION",
                         "PASTE_CONDITIONAL_FORMATTING"
                     ],
                     "enumDescriptions": [
                         "Paste values, formulas, formats, and merges.",
                         "Paste the values ONLY without formats, formulas, or merges.",
                         "Paste the format and data validation only.",
                         "Like PASTE_NORMAL but without borders.",
                         "Paste the formulas only.",
                         "Paste the data validation only.",
-                        "Paste the color rules only."
+                        "Paste the conditional formatting rules only."
                     ],
                     "type": "string"
                 },
                 "pasteOrientation": {
                     "description": "How that data should be oriented when pasting.",
                     "enum": [
                         "NORMAL",
                         "TRANSPOSE"
                     ],
                     "enumDescriptions": [
@@ skipping 120 matching lines @@
                         "PASTE_DATA_VALIDATION",
                         "PASTE_CONDITIONAL_FORMATTING"
                     ],
                     "enumDescriptions": [
                         "Paste values, formulas, formats, and merges.",
                         "Paste the values ONLY without formats, formulas, or merges.",
                         "Paste the format and data validation only.",
                         "Like PASTE_NORMAL but without borders.",
                         "Paste the formulas only.",
                         "Paste the data validation only.",
-                        "Paste the color rules only."
+                        "Paste the conditional formatting rules only."
                     ],
                     "type": "string"
                 },
                 "source": {
                     "$ref": "GridRange",
                     "description": "The source data to cut."
                 },
                 "destination": {
                     "$ref": "GridCoordinate",
                     "description": "The top-left coordinate where the data should be pasted."
@@ skipping 91 matching lines @@
                     "type": "boolean"
                 },
                 "domain": {
                     "$ref": "ChartData",
                     "description": "The data that covers the domain of the pie chart."
                 }
             },
             "type": "object"
         },
         "UpdateSheetPropertiesRequest": {
-            "description": "Updates properties of the sheet with the specified\nsheetId.\nIt is an error to specify read only fields in the field mask.",
+            "description": "Updates properties of the sheet with the specified\nsheetId.",
             "id": "UpdateSheetPropertiesRequest",
             "properties": {
                 "fields": {
                     "description": "The fields that should be updated.  At least one field must be specified.\nThe root `properties` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
                     "format": "google-fieldmask",
                     "type": "string"
                 },
                 "properties": {
                     "$ref": "SheetProperties",
                     "description": "The properties to update."
@@ skipping 201 matching lines @@
                 "updateDimensionProperties": {
                     "$ref": "UpdateDimensionPropertiesRequest",
                     "description": "Updates dimensions' properties."
                 },
                 "deleteSheet": {
                     "$ref": "DeleteSheetRequest",
                     "description": "Deletes a sheet."
                 },
                 "findReplace": {
                     "$ref": "FindReplaceRequest",
-                    "description": "Finds and replace occurrences of some text with other text."
+                    "description": "Finds and replaces occurrences of some text with other text."
                 },
                 "addProtectedRange": {
                     "$ref": "AddProtectedRangeRequest",
                     "description": "Adds a protected range."
                 },
                 "deleteProtectedRange": {
                     "$ref": "DeleteProtectedRangeRequest",
                     "description": "Deletes a protected range."
                 },
                 "updateConditionalFormatRule": {
@@ skipping 51 matching lines @@
                 "duplicateFilterView": {
                     "$ref": "DuplicateFilterViewRequest",
                     "description": "Duplicates a filter view."
                 },
                 "cutPaste": {
                     "$ref": "CutPasteRequest",
                     "description": "Cuts data from one area and pastes it to another."
                 },
                 "appendCells": {
                     "$ref": "AppendCellsRequest",
-                    "description": "Appends cells to the last row with data in a sheet."
+                    "description": "Appends cells after the last row with data in a sheet."
                 },
                 "addNamedRange": {
                     "$ref": "AddNamedRangeRequest",
                     "description": "Adds a named range."
                 },
                 "autoFill": {
                     "$ref": "AutoFillRequest",
                     "description": "Automatically fills in more data based on existing data."
                 },
                 "moveDimension": {
@@ skipping 20 matching lines @@
             "id": "BatchGetValuesResponse",
             "properties": {
                 "valueRanges": {
                     "description": "The requested values. The order of the ValueRanges is the same as the\norder of the requested ranges.",
                     "items": {
                         "$ref": "ValueRange"
                     },
                     "type": "array"
                 },
                 "spreadsheetId": {
-                    "description": "The id of the spreadsheet to retrieve data from.",
+                    "description": "The ID of the spreadsheet the data was retrieved from.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "InsertDimensionRequest": {
             "description": "Inserts rows or columns in a sheet at a particular index.",
             "id": "InsertDimensionRequest",
             "properties": {
                 "inheritFromBefore": {
-                    "description": "Whether dimension properties should be extended from the dimensions\nbefore or after the newly inserted dimensions.\nTrue to inherit from the dimensions before (in which case the start\nindex must be greater than 0), and false to inherit from the dimensions\nafter.\n\nFor example, if row index 0 has red background and row index 1\nhas a green background, then inserting 2 rows at index 1 can inherit\neither the green or red background.  If `inheritFromBefore` is true,\nthe two new rows will be red (because the row before the insertion point\nwas red), whereas if `inheritFromBefore` is false, the two new rows will\nbe green (because the rows after the insertion point were green).",
+                    "description": "Whether dimension properties should be extended from the dimensions\nbefore or after the newly inserted dimensions.\nTrue to inherit from the dimensions before (in which case the start\nindex must be greater than 0), and false to inherit from the dimensions\nafter.\n\nFor example, if row index 0 has red background and row index 1\nhas a green background, then inserting 2 rows at index 1 can inherit\neither the green or red background.  If `inheritFromBefore` is true,\nthe two new rows will be red (because the row before the insertion point\nwas red), whereas if `inheritFromBefore` is false, the two new rows will\nbe green (because the row after the insertion point was green).",
                     "type": "boolean"
                 },
                 "range": {
                     "$ref": "DimensionRange",
                     "description": "The dimensions to insert.  Both the start and end indexes must be bounded."
                 }
             },
             "type": "object"
         },
         "DeleteEmbeddedObjectRequest": {
@@ skipping 17 matching lines @@
                     "description": "The rule that was deleted."
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Sheets API",
     "version": "v4"
 }