Api-roll 42: 2016-11-08

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"
                 },
@@ skipping 193 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/drive",
                         "https://www.googleapis.com/auth/spreadsheets"
                     ]
                 }
             },
             "resources": {
                 "values": {
                     "methods": {
-                        "append": {
-                            "description": "Appends values to a spreadsheet. The input range is used to search for\nexisting data and find a \"table\" within that range. Values will be\nappended to the next row of the table, starting with the first column of\nthe table. See the\n[guide](/sheets/guides/values#appending_values)\nand\n[sample code](/sheets/samples/writing#append_values)\nfor specific details of how tables are detected and data is appended.\n\nThe caller must specify the spreadsheet ID, range, and\na valueInputOption.  The `valueInputOption` only\ncontrols how the input data will be added to the sheet (column-wise or\nrow-wise), it does not influence what cell the data starts being written\nto.",
+                        "clear": {
+                            "description": "Clears values from a spreadsheet.\nThe caller must specify the spreadsheet ID and range.\nOnly values are cleared -- all other properties of the cell (such as\nformatting, data validation, etc..) are kept.",
                             "httpMethod": "POST",
-                            "id": "sheets.spreadsheets.values.append",
+                            "id": "sheets.spreadsheets.values.clear",
                             "parameterOrder": [
                                 "spreadsheetId",
                                 "range"
                             ],
                             "parameters": {
-                                "valueInputOption": {
-                                    "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.",
-                                    "location": "path",
-                                    "required": true,
-                                    "type": "string"
-                                },
-                                "insertDataOption": {
-                                    "description": "How the input data should be inserted.",
-                                    "enum": [
-                                        "OVERWRITE",
-                                        "INSERT_ROWS"
-                                    ],
-                                    "location": "query",
-                                    "type": "string"
-                                },
-                                "range": {
-                                    "description": "The A1 notation of a range to search for a logical table of data.\nValues will be appended after the last row of the table.",
-                                    "location": "path",
-                                    "required": true,
-                                    "type": "string"
-                                }
-                            },
-                            "path": "v4/spreadsheets/{spreadsheetId}/values/{range}:append",
-                            "request": {
-                                "$ref": "ValueRange"
-                            },
-                            "response": {
-                                "$ref": "AppendValuesResponse"
-                            },
-                            "scopes": [
-                                "https://www.googleapis.com/auth/drive",
-                                "https://www.googleapis.com/auth/spreadsheets"
-                            ]
-                        },
-                        "update": {
-                            "description": "Sets values in a range of a spreadsheet.\nThe caller must specify the spreadsheet ID, range, and\na valueInputOption.",
-                            "httpMethod": "PUT",
-                            "id": "sheets.spreadsheets.values.update",
-                            "parameterOrder": [
-                                "spreadsheetId",
-                                "range"
-                            ],
-                            "parameters": {
-                                "valueInputOption": {
-                                    "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.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "range": {
-                                    "description": "The A1 notation of the values to update.",
+                                    "description": "The A1 notation of the values to clear.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
-                            "path": "v4/spreadsheets/{spreadsheetId}/values/{range}",
+                            "path": "v4/spreadsheets/{spreadsheetId}/values/{range}:clear",
                             "request": {
-                                "$ref": "ValueRange"
+                                "$ref": "ClearValuesRequest"
                             },
                             "response": {
-                                "$ref": "UpdateValuesResponse"
+                                "$ref": "ClearValuesResponse"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/drive",
+                                "https://www.googleapis.com/auth/spreadsheets"
+                            ]
+                        },
+                        "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.",
+                                    "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 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": [
+                                        "DIMENSION_UNSPECIFIED",
+                                        "ROWS",
+                                        "COLUMNS"
+                                    ],
+                                    "location": "query",
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v4/spreadsheets/{spreadsheetId}/values:batchGet",
+                            "response": {
+                                "$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 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.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v4/spreadsheets/{spreadsheetId}/values:batchUpdate",
+                            "request": {
+                                "$ref": "BatchUpdateValuesRequest"
+                            },
+                            "response": {
+                                "$ref": "BatchUpdateValuesResponse"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/drive",
                                 "https://www.googleapis.com/auth/spreadsheets"
                             ]
                         },
                         "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"
@@ skipping 45 matching lines @@
                             "response": {
                                 "$ref": "ValueRange"
                             },
                             "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"
                             ]
                         },
-                        "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",
+                        "append": {
+                            "description": "Appends values to a spreadsheet. The input range is used to search for\nexisting data and find a \"table\" within that range. Values will be\nappended to the next row of the table, starting with the first column of\nthe table. See the\n[guide](/sheets/guides/values#appending_values)\nand\n[sample code](/sheets/samples/writing#append_values)\nfor specific details of how tables are detected and data is appended.\n\nThe caller must specify the spreadsheet ID, range, and\na valueInputOption.  The `valueInputOption` only\ncontrols how the input data will be added to the sheet (column-wise or\nrow-wise), it does not influence what cell the data starts being written\nto.",
+                            "httpMethod": "POST",
+                            "id": "sheets.spreadsheets.values.append",
                             "parameterOrder": [
-                                "spreadsheetId"
+                                "spreadsheetId",
+                                "range"
                             ],
                             "parameters": {
+                                "valueInputOption": {
+                                    "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 retrieve data from.",
+                                    "description": "The ID of the spreadsheet to update.",
                                     "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.",
+                                "insertDataOption": {
+                                    "description": "How the input data should be inserted.",
                                     "enum": [
-                                        "FORMATTED_VALUE",
-                                        "UNFORMATTED_VALUE",
-                                        "FORMULA"
+                                        "OVERWRITE",
+                                        "INSERT_ROWS"
                                     ],
                                     "location": "query",
                                     "type": "string"
                                 },
-                                "dateTimeRenderOption": {
-                                    "description": "How dates, times, and durations should be represented in the output.\nThis is ignored if value_render_option is\nFORMATTED_VALUE.",
+                                "range": {
+                                    "description": "The A1 notation of a range to search for a logical table of data.\nValues will be appended after the last row of the table.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v4/spreadsheets/{spreadsheetId}/values/{range}:append",
+                            "request": {
+                                "$ref": "ValueRange"
+                            },
+                            "response": {
+                                "$ref": "AppendValuesResponse"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/drive",
+                                "https://www.googleapis.com/auth/spreadsheets"
+                            ]
+                        },
+                        "update": {
+                            "description": "Sets values in a range of a spreadsheet.\nThe caller must specify the spreadsheet ID, range, and\na valueInputOption.",
+                            "httpMethod": "PUT",
+                            "id": "sheets.spreadsheets.values.update",
+                            "parameterOrder": [
+                                "spreadsheetId",
+                                "range"
+                            ],
+                            "parameters": {
+                                "valueInputOption": {
+                                    "description": "How the input data should be interpreted.",
                                     "enum": [
-                                        "SERIAL_NUMBER",
-                                        "FORMATTED_STRING"
+                                        "INPUT_VALUE_OPTION_UNSPECIFIED",
+                                        "RAW",
+                                        "USER_ENTERED"
                                     ],
                                     "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": [
-                                        "DIMENSION_UNSPECIFIED",
-                                        "ROWS",
-                                        "COLUMNS"
-                                    ],
-                                    "location": "query",
+                                "spreadsheetId": {
+                                    "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"
                                 }
                             },
-                            "path": "v4/spreadsheets/{spreadsheetId}/values:batchGet",
+                            "path": "v4/spreadsheets/{spreadsheetId}/values/{range}",
+                            "request": {
+                                "$ref": "ValueRange"
+                            },
                             "response": {
-                                "$ref": "BatchGetValuesResponse"
+                                "$ref": "UpdateValuesResponse"
                             },
                             "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"
+                                "https://www.googleapis.com/auth/spreadsheets"
                             ]
                         },
-                        "batchUpdate": {
-                            "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.",
+                        "batchClear": {
+                            "description": "Clears one or more ranges of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and one or more ranges.\nOnly values are cleared -- all other properties of the cell (such as\nformatting, data validation, etc..) are kept.",
                             "httpMethod": "POST",
-                            "id": "sheets.spreadsheets.values.batchUpdate",
+                            "id": "sheets.spreadsheets.values.batchClear",
                             "parameterOrder": [
                                 "spreadsheetId"
                             ],
                             "parameters": {
                                 "spreadsheetId": {
                                     "description": "The ID of the spreadsheet to update.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
-                            "path": "v4/spreadsheets/{spreadsheetId}/values:batchUpdate",
+                            "path": "v4/spreadsheets/{spreadsheetId}/values:batchClear",
                             "request": {
-                                "$ref": "BatchUpdateValuesRequest"
+                                "$ref": "BatchClearValuesRequest"
                             },
                             "response": {
-                                "$ref": "BatchUpdateValuesResponse"
+                                "$ref": "BatchClearValuesResponse"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/drive",
                                 "https://www.googleapis.com/auth/spreadsheets"
                             ]
                         }
                     }
                 },
                 "sheets": {
                     "methods": {
@@ skipping 30 matching lines @@
                             "scopes": [
                                 "https://www.googleapis.com/auth/drive",
                                 "https://www.googleapis.com/auth/spreadsheets"
                             ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20160822",
+    "revision": "20161021",
     "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 98 matching lines @@
             "description": "The result of updating an embedded object's position.",
             "id": "UpdateEmbeddedObjectPositionResponse",
             "properties": {
                 "position": {
                     "$ref": "EmbeddedObjectPosition",
                     "description": "The new position of the embedded object."
                 }
             },
             "type": "object"
         },
+        "ClearValuesResponse": {
+            "description": "The response when clearing a range of values in a spreadsheet.",
+            "id": "ClearValuesResponse",
+            "properties": {
+                "spreadsheetId": {
+                    "description": "The spreadsheet the updates were applied to.",
+                    "type": "string"
+                },
+                "clearedRange": {
+                    "description": "The range (in A1 notation) that was cleared.\n(If the request was for an unbounded range or a ranger larger\n than the bounds of the sheet, this will be the actual range\n that was cleared, bounded to the sheet's limits.)",
+                    "type": "string"
+                }
+            },
+            "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 new_index is set,\nunused otherwise.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "rule": {
@@ skipping 378 matching lines @@
                         "The cell's value must be greater than the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must be greater than or equal to the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must be less than the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must be less than or equal to the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must be equal to the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must be not equal to the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must be between the two condition values.\nSupported by data validation, conditional formatting and filters.\nRequires exactly two ConditionValues.",
                         "The cell's value must not be between the two condition values.\nSupported by data validation, conditional formatting and filters.\nRequires exactly two ConditionValues.",
                         "The cell's value must contain the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must not contain the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
-                        "The cell's value must start with the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
-                        "The cell's value must end with the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
+                        "The cell's value must start with the condition's value.\nSupported by conditional formatting and filters.\nRequires a single ConditionValue.",
+                        "The cell's value must end with the condition's value.\nSupported by conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must be exactly the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must be a valid email address.\nSupported by data validation.\nRequires no ConditionValues.",
                         "The cell's value must be a valid URL.\nSupported by data validation.\nRequires no ConditionValues.",
                         "The cell's value must be the same date as the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
                         "The cell's value must be before the date of the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue\nthat may be a relative date.",
                         "The cell's value must be after the date of the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue\nthat may be a relative date.",
-                        "The cell's value must be on or before the date of the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue\nthat may be a relative date.",
-                        "The cell's value must be on or after the date of the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue\nthat may be a relative date.",
+                        "The cell's value must be on or before the date of the condition's value.\nSupported by data validation.\nRequires a single ConditionValue\nthat may be a relative date.",
+                        "The cell's value must be on or after the date of the condition's value.\nSupported by data validation.\nRequires a single ConditionValue\nthat may be a relative date.",
                         "The cell's value must be between the dates of the two condition values.\nSupported by data validation.\nRequires exactly two ConditionValues.",
                         "The cell's value must be outside the dates of the two condition values.\nSupported by data validation.\nRequires exactly two ConditionValues.",
                         "The cell's value must be a date.\nSupported by data validation.\nRequires no ConditionValues.",
                         "The cell's value must be listed in the grid in condition value's range.\nSupported by data validation.\nRequires a single ConditionValue,\nand the value must be a valid range in A1 notation.",
                         "The cell's value must in the list of condition values.\nSupported by data validation.\nSupports any number of condition values,\none per item in the list.\nFormulas are not supported in the values.",
-                        "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 cell's value must be empty.\nSupported by conditional formatting and filters.\nRequires no ConditionValues.",
+                        "The cell's value must not be empty.\nSupported by 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.",
             "id": "DeleteProtectedRangeRequest",
@@ skipping 82 matching lines @@
                     "description": "A reply from updating a conditional format rule."
                 },
                 "addChart": {
                     "$ref": "AddChartResponse",
                     "description": "A reply from adding a chart."
                 },
                 "deleteConditionalFormatRule": {
                     "$ref": "DeleteConditionalFormatRuleResponse",
                     "description": "A reply from deleting a conditional format rule."
                 },
+                "addBanding": {
+                    "$ref": "AddBandingResponse",
+                    "description": "A reply from adding a banded range."
+                },
                 "duplicateSheet": {
                     "$ref": "DuplicateSheetResponse",
                     "description": "A reply from duplicating a sheet."
                 },
                 "duplicateFilterView": {
                     "$ref": "DuplicateFilterViewResponse",
                     "description": "A reply from duplicating a filter view."
                 },
                 "addNamedRange": {
                     "$ref": "AddNamedRangeResponse",
@@ skipping 67 matching lines @@
                 "sortSpecs": {
                     "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"
         },
+        "AddBandingResponse": {
+            "description": "The result of adding a banded range.",
+            "id": "AddBandingResponse",
+            "properties": {
+                "bandedRange": {
+                    "$ref": "BandedRange",
+                    "description": "The banded range that was added."
+                }
+            },
+            "type": "object"
+        },
         "TextFormatRun": {
             "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": {
@@ skipping 210 matching lines @@
             "id": "ClearBasicFilterRequest",
             "properties": {
                 "sheetId": {
                     "description": "The sheet ID on which the basic filter should be cleared.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
+        "BatchClearValuesResponse": {
+            "description": "The response when updating a range of values in a spreadsheet.",
+            "id": "BatchClearValuesResponse",
+            "properties": {
+                "spreadsheetId": {
+                    "description": "The spreadsheet the updates were applied to.",
+                    "type": "string"
+                },
+                "clearedRanges": {
+                    "description": "The ranges that were cleared, in A1 notation.\n(If the requests were for an unbounded range or a ranger larger\n than the bounds of the sheet, this will be the actual ranges\n that were cleared, bounded to the sheet's limits.)",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
         "ConditionalFormatRule": {
             "description": "A rule describing a conditional format.",
             "id": "ConditionalFormatRule",
             "properties": {
                 "gradientRule": {
                     "$ref": "GradientRule",
                     "description": "The formatting will vary based on the gradients in the rule."
                 },
                 "booleanRule": {
                     "$ref": "BooleanRule",
@@ skipping 591 matching lines @@
                     "enumDescriptions": [
                         "Default value, do not use.",
                         "The sheet is a grid.",
                         "The sheet has no grid and instead has an object like a chart or image."
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "ClearValuesRequest": {
+            "description": "The request for clearing a range of values in a spreadsheet.",
+            "id": "ClearValuesRequest",
+            "properties": {},
+            "type": "object"
+        },
         "ProtectedRange": {
             "description": "A protected range.",
             "id": "ProtectedRange",
             "properties": {
                 "unprotectedRanges": {
                     "description": "The list of unprotected ranges within a protected sheet.\nUnprotected ranges are only supported on protected sheets.",
                     "items": {
                         "$ref": "GridRange"
                     },
                     "type": "array"
@@ skipping 271 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "NumberFormat": {
             "description": "The number format of a cell.",
             "id": "NumberFormat",
             "properties": {
                 "pattern": {
-                    "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.",
+                    "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.\nSee the [Date and Number Formats guide](/sheets/guides/formats) for more\ninformation about the supported patterns.",
                     "type": "string"
                 },
                 "type": {
                     "description": "The type of the number format.\nWhen writing, this field must be set.",
                     "enum": [
                         "NUMBER_FORMAT_TYPE_UNSPECIFIED",
                         "TEXT",
                         "NUMBER",
                         "PERCENT",
                         "CURRENCY",
@@ skipping 11 matching lines @@
                         "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"
         },
+        "BatchClearValuesRequest": {
+            "description": "The request for clearing more than one range of values in a spreadsheet.",
+            "id": "BatchClearValuesRequest",
+            "properties": {
+                "ranges": {
+                    "description": "The ranges to clear, in A1 notation.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
         "UpdateDimensionPropertiesRequest": {
             "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": {
@@ skipping 150 matching lines @@
                     ],
                     "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"
         },
+        "DeleteBandingRequest": {
+            "description": "Removes the banded range with the given ID from the spreadsheet.",
+            "id": "DeleteBandingRequest",
+            "properties": {
+                "bandedRangeId": {
+                    "description": "The ID of the banded range to delete.",
+                    "format": "int32",
+                    "type": "integer"
+                }
+            },
+            "type": "object"
+        },
         "BasicFilter": {
             "description": "The default filter associated with a sheet.",
             "id": "BasicFilter",
             "properties": {
                 "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"
@@ skipping 64 matching lines @@
             "description": "A border along a cell.",
             "id": "Border",
             "properties": {
                 "style": {
                     "description": "The style of the border.",
                     "enum": [
                         "STYLE_UNSPECIFIED",
                         "DOTTED",
                         "DASHED",
                         "SOLID",
+                        "SOLID_MEDIUM",
+                        "SOLID_THICK",
                         "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.",
+                        "The border is a thin solid line.",
+                        "The border is a medium solid line.",
+                        "The border is a thick solid line.",
                         "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, inclusive.",
+                    "description": "The width of the border, in pixels.\nDeprecated; the width is determined by the \"style\" field.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "color": {
                     "$ref": "Color",
                     "description": "The color of the border."
                 }
             },
             "type": "object"
         },
@@ skipping 12 matching lines @@
             "description": "The result of adding a chart to a spreadsheet.",
             "id": "AddChartResponse",
             "properties": {
                 "chart": {
                     "$ref": "EmbeddedChart",
                     "description": "The newly added chart."
                 }
             },
             "type": "object"
         },
+        "AddBandingRequest": {
+            "description": "Adds a new banded range to the spreadsheet.",
+            "id": "AddBandingRequest",
+            "properties": {
+                "bandedRange": {
+                    "$ref": "BandedRange",
+                    "description": "The banded range to add. The bandedRangeId\nfield is optional; if one is not set, an id will be randomly generated. (It\nis an error to specify the ID of a range that already exists.)"
+                }
+            },
+            "type": "object"
+        },
         "AppendCellsRequest": {
             "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": {
@@ skipping 181 matching lines @@
                     "$ref": "GridRange",
                     "description": "The range this represents."
                 },
                 "name": {
                     "description": "The name of the named range.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
-        "SetBasicFilterRequest": {
-            "description": "Sets the basic filter associated with a sheet.",
-            "id": "SetBasicFilterRequest",
-            "properties": {
-                "filter": {
-                    "$ref": "BasicFilter",
-                    "description": "The filter to set."
-                }
-            },
-            "type": "object"
-        },
         "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.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "fields": {
                     "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"
         },
+        "SetBasicFilterRequest": {
+            "description": "Sets the basic filter associated with a sheet.",
+            "id": "SetBasicFilterRequest",
+            "properties": {
+                "filter": {
+                    "$ref": "BasicFilter",
+                    "description": "The filter to set."
+                }
+            },
+            "type": "object"
+        },
         "AutoResizeDimensionsRequest": {
             "description": "Automatically resizes one or more dimensions based on the contents\nof the cells in that dimension.",
             "id": "AutoResizeDimensionsRequest",
             "properties": {
                 "dimensions": {
                     "$ref": "DimensionRange",
                     "description": "The dimensions to automatically resize.\nOnly COLUMNS are supported."
                 }
             },
             "type": "object"
         },
         "DuplicateFilterViewResponse": {
             "description": "The result of a filter view being duplicated.",
             "id": "DuplicateFilterViewResponse",
             "properties": {
                 "filter": {
                     "$ref": "FilterView",
                     "description": "The newly created filter."
                 }
             },
             "type": "object"
         },
+        "BandingProperties": {
+            "description": "Properties referring a single dimension (either row or column). If both\nBandedRange.row_properties and BandedRange.column_properties are\nset, the fill colors are applied to cells according to the following rules:\n\n* header_color and footer_color take priority over band colors.\n* first_band_color takes priority over second_band_color.\n* row_properties takes priority over column_properties.\n\nFor example, the first row color takes priority over the first column\ncolor, but the first column color takes priority over the second row color.\nSimilarly, the row header takes priority over the column header in the\ntop left cell, but the column header takes priority over the first row\ncolor if the row header is not set.",
+            "id": "BandingProperties",
+            "properties": {
+                "footerColor": {
+                    "$ref": "Color",
+                    "description": "The color of the last row or column. If this field is not set, the last\nrow or column will be filled with either first_row_color or\nsecond_row_color, depending on the color of the previous row or\ncolumn."
+                },
+                "headerColor": {
+                    "$ref": "Color",
+                    "description": "The color of the first row or column. If this field is set, the first\nrow or column will be filled with this color and the colors will\nalternate between first_band_color and [second_band_color[] starting\nfrom the second row or column. Otherwise, the first row or column will be\nfilled with first_band_color and the colors will proceed to alternate\nas they normally would."
+                },
+                "secondBandColor": {
+                    "$ref": "Color",
+                    "description": "The second color that is alternating. (Required)"
+                },
+                "firstBandColor": {
+                    "$ref": "Color",
+                    "description": "The first color that is alternating. (Required)"
+                }
+            },
+            "type": "object"
+        },
         "PivotGroup": {
             "description": "A single grouping (either row or column) in a pivot table.",
             "id": "PivotGroup",
             "properties": {
                 "sortOrder": {
                     "description": "The order the values in this group should be sorted.",
                     "enum": [
                         "SORT_ORDER_UNSPECIFIED",
                         "ASCENDING",
                         "DESCENDING"
@@ skipping 65 matching lines @@
             "id": "DeleteSheetRequest",
             "properties": {
                 "sheetId": {
                     "description": "The ID of the sheet to delete.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
+        "UpdateBandingRequest": {
+            "description": "Updates properties of the supplied banded range.",
+            "id": "UpdateBandingRequest",
+            "properties": {
+                "bandedRange": {
+                    "$ref": "BandedRange",
+                    "description": "The banded range to update with the new properties."
+                },
+                "fields": {
+                    "description": "The fields that should be updated.  At least one field must be specified.\nThe root `bandedRange` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
+                    "format": "google-fieldmask",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "ChartData": {
             "description": "The data included in a domain or series.",
             "id": "ChartData",
             "properties": {
                 "sourceRange": {
                     "$ref": "ChartSourceRange",
                     "description": "The source ranges of the data."
                 }
             },
             "type": "object"
@@ skipping 44 matching lines @@
                         "$ref": "GridRange"
                     },
                     "type": "array"
                 },
                 "data": {
                     "description": "Data in the grid, if this is a grid sheet.\nThe number of GridData objects returned is dependent on the number of\nranges requested on this sheet. For example, if this is representing\n`Sheet1`, and the spreadsheet was requested with ranges\n`Sheet1!A1:C10` and `Sheet1!D15:E20`, then the first GridData will have a\nstartRow/startColumn of `0`,\nwhile the second one will have `startRow 14` (zero-based row 15),\nand `startColumn 3` (zero-based column D).",
                     "items": {
                         "$ref": "GridData"
                     },
                     "type": "array"
+                },
+                "bandedRanges": {
+                    "description": "The banded (i.e. alternating colors) ranges on this sheet.",
+                    "items": {
+                        "$ref": "BandedRange"
+                    },
+                    "type": "array"
                 }
             },
             "type": "object"
         },
         "CopyPasteRequest": {
             "description": "Copies data from the source to the destination.",
             "id": "CopyPasteRequest",
             "properties": {
                 "pasteType": {
                     "description": "What kind of data to paste.",
@@ skipping 503 matching lines @@
                     "description": "Updates an existing conditional format rule."
                 },
                 "setBasicFilter": {
                     "$ref": "SetBasicFilterRequest",
                     "description": "Sets the basic filter on a sheet."
                 },
                 "mergeCells": {
                     "$ref": "MergeCellsRequest",
                     "description": "Merges cells together."
                 },
+                "updateBanding": {
+                    "$ref": "UpdateBandingRequest",
+                    "description": "Updates a banded range"
+                },
                 "addChart": {
                     "$ref": "AddChartRequest",
                     "description": "Adds a chart."
                 },
                 "deleteConditionalFormatRule": {
                     "$ref": "DeleteConditionalFormatRuleRequest",
                     "description": "Deletes an existing conditional format rule."
                 },
+                "addBanding": {
+                    "$ref": "AddBandingRequest",
+                    "description": "Adds a new banded range"
+                },
+                "deleteBanding": {
+                    "$ref": "DeleteBandingRequest",
+                    "description": "Removes a banded range"
+                },
                 "updateChartSpec": {
                     "$ref": "UpdateChartSpecRequest",
                     "description": "Updates a chart's specifications."
                 },
                 "deleteDimension": {
                     "$ref": "DeleteDimensionRequest",
                     "description": "Deletes rows or columns in a sheet."
                 },
                 "deleteEmbeddedObject": {
                     "$ref": "DeleteEmbeddedObjectRequest",
@@ skipping 96 matching lines @@
             "id": "DeleteEmbeddedObjectRequest",
             "properties": {
                 "objectId": {
                     "description": "The ID of the embedded object to delete.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
+        "BandedRange": {
+            "description": "A banded (alternating colors) range in a sheet.",
+            "id": "BandedRange",
+            "properties": {
+                "bandedRangeId": {
+                    "description": "The id of the banded range.",
+                    "format": "int32",
+                    "type": "integer"
+                },
+                "rowProperties": {
+                    "$ref": "BandingProperties",
+                    "description": "Properties for row bands. These properties will be applied on a row-by-row\nbasis throughout all the rows in the range. At least one of\nrow_properties or column_properties must be specified."
+                },
+                "columnProperties": {
+                    "$ref": "BandingProperties",
+                    "description": "Properties for column bands. These properties will be applied on a column-\nby-column basis throughout all the columns in the range. At least one of\nrow_properties or column_properties must be specified."
+                },
+                "range": {
+                    "$ref": "GridRange",
+                    "description": "The range over which these properties are applied."
+                }
+            },
+            "type": "object"
+        },
         "DeleteConditionalFormatRuleResponse": {
             "description": "The result of deleting a conditional format rule.",
             "id": "DeleteConditionalFormatRuleResponse",
             "properties": {
                 "rule": {
                     "$ref": "ConditionalFormatRule",
                     "description": "The rule that was deleted."
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Sheets API",
     "version": "v4"
 }