Api-roll 40: 2016-08-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.",
+                            "httpMethod": "POST",
+                            "id": "sheets.spreadsheets.values.append",
+                            "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": {
@@ skipping 218 matching lines @@
                             "scopes": [
                                 "https://www.googleapis.com/auth/drive",
                                 "https://www.googleapis.com/auth/spreadsheets"
                             ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20160708",
+    "revision": "20160804",
     "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."
                 }
             },
             "type": "object"
         },
         "UpdateProtectedRangeRequest": {
             "description": "Updates an existing protected range with the specified\nprotectedRangeId.",
             "id": "UpdateProtectedRangeRequest",
             "properties": {
                 "protectedRange": {
                     "$ref": "ProtectedRange",
-                    "description": "The protected range to update with the new properties. If a nonzero\nprotectedRangeId is\nspecified, the protected range will use that ID. (It is an error to\nspecify the ID of a protected range that already exists.)"
+                    "description": "The protected range to update with the new properties."
                 },
                 "fields": {
                     "description": "The fields that should be updated.  At least one field must be specified.\nThe root `protectedRange` 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"
         },
         "Padding": {
@@ skipping 1059 matching lines @@
                 }
             },
             "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 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.)"
+                    "description": "The properties the new sheet should have.\nAll properties are optional.\nThe sheetId field is optional; if one is not\nset, an id will be randomly generated. (It is an error to specify the ID\nof 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."
+                    "description": "The protected range to be added. The\nprotectedRangeId field is optional; if\none is not set, an id will be randomly generated. (It is an error to\nspecify the ID of a range that already exists.)"
                 }
             },
             "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 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.",
+                    "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.\nWhen appending values, this field represents the range to search for a\ntable, after which values will be appended.",
                     "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\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": [
@@ skipping 31 matching lines @@
                     "type": "integer"
                 },
                 "sheetsChanged": {
                     "description": "The number of sheets changed.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
+        "AppendValuesResponse": {
+            "description": "The response when updating a range of values in a spreadsheet.",
+            "id": "AppendValuesResponse",
+            "properties": {
+                "spreadsheetId": {
+                    "description": "The spreadsheet the updates were applied to.",
+                    "type": "string"
+                },
+                "tableRange": {
+                    "description": "The range (in A1 notation) of the table that values are being appended to\n(before the values were appended).\nEmpty if no table was found.",
+                    "type": "string"
+                },
+                "updates": {
+                    "$ref": "UpdateValuesResponse",
+                    "description": "Information about the updates that were applied."
+                }
+            },
+            "type": "object"
+        },
         "CellFormat": {
             "description": "The format of a cell.",
             "id": "CellFormat",
             "properties": {
                 "horizontalAlignment": {
                     "description": "The horizontal alignment of the value in the cell.",
                     "enum": [
                         "HORIZONTAL_ALIGN_UNSPECIFIED",
                         "LEFT",
                         "CENTER",
@@ skipping 950 matching lines @@
                 }
             },
             "type": "object"
         },
         "AddNamedRangeRequest": {
             "description": "Adds a named range to the spreadsheet.",
             "id": "AddNamedRangeRequest",
             "properties": {
                 "namedRange": {
                     "$ref": "NamedRange",
-                    "description": "The named range to add. If a non-empty\nnamedRangeId is specified, the named range\nwill use that ID. (It is an error to specify the ID of a named\nrange that already exists.)"
+                    "description": "The named range to add. The namedRangeId\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"
         },
         "AddChartResponse": {
             "description": "The result of adding a chart to a spreadsheet.",
             "id": "AddChartResponse",
             "properties": {
                 "chart": {
                     "$ref": "EmbeddedChart",
@@ skipping 745 matching lines @@
                 }
             },
             "type": "object"
         },
         "AddFilterViewRequest": {
             "description": "Adds a filter view.",
             "id": "AddFilterViewRequest",
             "properties": {
                 "filter": {
                     "$ref": "FilterView",
-                    "description": "The filter to add."
+                    "description": "The filter to add. The filterViewId\nfield is optional; if one is not set, an id will be randomly generated. (It\nis an error to specify the ID of a filter that already exists.)"
                 }
             },
             "type": "object"
         },
         "GridProperties": {
             "description": "Properties of a grid.",
             "id": "GridProperties",
             "properties": {
                 "rowCount": {
                     "description": "The number of rows in the grid.",
@@ skipping 32 matching lines @@
                 }
             },
             "type": "object"
         },
         "AddChartRequest": {
             "description": "Adds a chart to a sheet in the spreadsheet.",
             "id": "AddChartRequest",
             "properties": {
                 "chart": {
                     "$ref": "EmbeddedChart",
-                    "description": "The chart that should be added to the spreadsheet, including the position\nwhere it should be placed."
+                    "description": "The chart that should be added to the spreadsheet, including the position\nwhere it should be placed. The chartId\nfield is optional; if one is not set, an id will be randomly generated. (It\nis an error to specify the ID of a chart that already exists.)"
                 }
             },
             "type": "object"
         },
         "SetDataValidationRequest": {
             "description": "Sets a data validation rule to every cell in the range.\nTo clear validation in a range, call this with no rule specified.",
             "id": "SetDataValidationRequest",
             "properties": {
                 "rule": {
                     "$ref": "DataValidationRule",
@@ skipping 243 matching lines @@
                     "description": "The rule that was deleted."
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Sheets API",
     "version": "v4"
 }