blob: f8e3a6979c13177ec4497e56ca4f4bc5c3fa9e73 [file] [log] [blame]
{
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/drive": {
"description": "See, edit, create, and delete all of your Google Drive files"
},
"https://www.googleapis.com/auth/drive.file": {
"description": "View and manage Google Drive files and folders that you have opened or created with this app"
},
"https://www.googleapis.com/auth/drive.readonly": {
"description": "See and download all your Google Drive files"
},
"https://www.googleapis.com/auth/spreadsheets": {
"description": "See, edit, create, and delete your spreadsheets in Google Drive"
},
"https://www.googleapis.com/auth/spreadsheets.readonly": {
"description": "View your Google Spreadsheets"
}
}
}
},
"basePath": "",
"baseUrl": "https://sheets.googleapis.com/",
"batchPath": "batch",
"canonicalName": "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",
"ownerName": "Google",
"parameters": {
"$.xgafv": {
"description": "V1 error format.",
"enum": [
"1",
"2"
],
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query",
"type": "string"
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
"alt": {
"default": "json",
"description": "Data format for response.",
"enum": [
"json",
"media",
"proto"
],
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query",
"type": "string"
},
"callback": {
"description": "JSONP",
"location": "query",
"type": "string"
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
"key": {
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"type": "string"
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"type": "string"
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
"resources": {
"spreadsheets": {
"methods": {
"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 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.",
"flatPath": "v4/spreadsheets/{spreadsheetId}:batchUpdate",
"httpMethod": "POST",
"id": "sheets.spreadsheets.batchUpdate",
"parameterOrder": [
"spreadsheetId"
],
"parameters": {
"spreadsheetId": {
"description": "The spreadsheet to apply the updates to.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}:batchUpdate",
"request": {
"$ref": "BatchUpdateSpreadsheetRequest"
},
"response": {
"$ref": "BatchUpdateSpreadsheetResponse"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
},
"create": {
"description": "Creates a spreadsheet, returning the newly created spreadsheet.",
"flatPath": "v4/spreadsheets",
"httpMethod": "POST",
"id": "sheets.spreadsheets.create",
"parameterOrder": [],
"parameters": {},
"path": "v4/spreadsheets",
"request": {
"$ref": "Spreadsheet"
},
"response": {
"$ref": "Spreadsheet"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"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:\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.",
"flatPath": "v4/spreadsheets/{spreadsheetId}",
"httpMethod": "GET",
"id": "sheets.spreadsheets.get",
"parameterOrder": [
"spreadsheetId"
],
"parameters": {
"includeGridData": {
"description": "True if grid data should be returned.\nThis parameter is ignored if a field mask was set in the request.",
"location": "query",
"type": "boolean"
},
"ranges": {
"description": "The ranges to retrieve from the spreadsheet.",
"location": "query",
"repeated": true,
"type": "string"
},
"spreadsheetId": {
"description": "The spreadsheet to request.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}",
"response": {
"$ref": "Spreadsheet"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/drive.readonly",
"https://www.googleapis.com/auth/spreadsheets",
"https://www.googleapis.com/auth/spreadsheets.readonly"
]
},
"getByDataFilter": {
"description": "Returns the spreadsheet at the given ID.\nThe caller must specify the spreadsheet ID.\n\nThis method differs from GetSpreadsheet in that it allows selecting\nwhich subsets of spreadsheet data to return by specifying a\ndataFilters parameter.\nMultiple DataFilters can be specified. Specifying one or\nmore data filters will return the portions of the spreadsheet that\nintersect ranges matched by any of the filters.\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\nparameter 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.",
"flatPath": "v4/spreadsheets/{spreadsheetId}:getByDataFilter",
"httpMethod": "POST",
"id": "sheets.spreadsheets.getByDataFilter",
"parameterOrder": [
"spreadsheetId"
],
"parameters": {
"spreadsheetId": {
"description": "The spreadsheet to request.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}:getByDataFilter",
"request": {
"$ref": "GetSpreadsheetByDataFilterRequest"
},
"response": {
"$ref": "Spreadsheet"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
}
},
"resources": {
"developerMetadata": {
"methods": {
"get": {
"description": "Returns the developer metadata with the specified ID.\nThe caller must specify the spreadsheet ID and the developer metadata's\nunique metadataId.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}",
"httpMethod": "GET",
"id": "sheets.spreadsheets.developerMetadata.get",
"parameterOrder": [
"spreadsheetId",
"metadataId"
],
"parameters": {
"metadataId": {
"description": "The ID of the developer metadata to retrieve.",
"format": "int32",
"location": "path",
"required": true,
"type": "integer"
},
"spreadsheetId": {
"description": "The ID of the spreadsheet to retrieve metadata from.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}",
"response": {
"$ref": "DeveloperMetadata"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
},
"search": {
"description": "Returns all developer metadata matching the specified DataFilter.\nIf the provided DataFilter represents a DeveloperMetadataLookup object,\nthis will return all DeveloperMetadata entries selected by it. If the\nDataFilter represents a location in a spreadsheet, this will return all\ndeveloper metadata associated with locations intersecting that region.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/developerMetadata:search",
"httpMethod": "POST",
"id": "sheets.spreadsheets.developerMetadata.search",
"parameterOrder": [
"spreadsheetId"
],
"parameters": {
"spreadsheetId": {
"description": "The ID of the spreadsheet to retrieve metadata from.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}/developerMetadata:search",
"request": {
"$ref": "SearchDeveloperMetadataRequest"
},
"response": {
"$ref": "SearchDeveloperMetadataResponse"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
}
}
},
"sheets": {
"methods": {
"copyTo": {
"description": "Copies a single sheet from a spreadsheet to another spreadsheet.\nReturns the properties of the newly created sheet.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo",
"httpMethod": "POST",
"id": "sheets.spreadsheets.sheets.copyTo",
"parameterOrder": [
"spreadsheetId",
"sheetId"
],
"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.",
"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/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
}
}
},
"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/api/guides/values#appending_values)\nand\n[sample code](/sheets/api/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.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}:append",
"httpMethod": "POST",
"id": "sheets.spreadsheets.values.append",
"parameterOrder": [
"spreadsheetId",
"range"
],
"parameters": {
"includeValuesInResponse": {
"description": "Determines if the update response should include the values\nof the cells that were appended. By default, responses\ndo not include the updated values.",
"location": "query",
"type": "boolean"
},
"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"
},
"responseDateTimeRenderOption": {
"description": "Determines how dates, times, and durations in the response should be\nrendered. This is ignored if response_value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"location": "query",
"type": "string"
},
"responseValueRenderOption": {
"description": "Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"enum": [
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"location": "query",
"type": "string"
},
"spreadsheetId": {
"description": "The ID of the spreadsheet to update.",
"location": "path",
"required": true,
"type": "string"
},
"valueInputOption": {
"description": "How the input data should be interpreted.",
"enum": [
"INPUT_VALUE_OPTION_UNSPECIFIED",
"RAW",
"USER_ENTERED"
],
"location": "query",
"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/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
},
"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.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchClear",
"httpMethod": "POST",
"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:batchClear",
"request": {
"$ref": "BatchClearValuesRequest"
},
"response": {
"$ref": "BatchClearValuesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
},
"batchClearByDataFilter": {
"description": "Clears one or more ranges of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and one or more\nDataFilters. Ranges matching any of the specified data\nfilters will be cleared. Only values are cleared -- all other properties\nof the cell (such as formatting, data validation, etc..) are kept.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter",
"httpMethod": "POST",
"id": "sheets.spreadsheets.values.batchClearByDataFilter",
"parameterOrder": [
"spreadsheetId"
],
"parameters": {
"spreadsheetId": {
"description": "The ID of the spreadsheet to update.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter",
"request": {
"$ref": "BatchClearValuesByDataFilterRequest"
},
"response": {
"$ref": "BatchClearValuesByDataFilterResponse"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"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.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchGet",
"httpMethod": "GET",
"id": "sheets.spreadsheets.values.batchGet",
"parameterOrder": [
"spreadsheetId"
],
"parameters": {
"dateTimeRenderOption": {
"description": "How dates, times, and durations should be represented in the output.\nThis is ignored if value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"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"
},
"ranges": {
"description": "The A1 notation of the values to retrieve.",
"location": "query",
"repeated": true,
"type": "string"
},
"spreadsheetId": {
"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.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"enum": [
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"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.file",
"https://www.googleapis.com/auth/drive.readonly",
"https://www.googleapis.com/auth/spreadsheets",
"https://www.googleapis.com/auth/spreadsheets.readonly"
]
},
"batchGetByDataFilter": {
"description": "Returns one or more ranges of values that match the specified data filters.\nThe caller must specify the spreadsheet ID and one or more\nDataFilters. Ranges that match any of the data filters in\nthe request will be returned.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter",
"httpMethod": "POST",
"id": "sheets.spreadsheets.values.batchGetByDataFilter",
"parameterOrder": [
"spreadsheetId"
],
"parameters": {
"spreadsheetId": {
"description": "The ID of the spreadsheet to retrieve data from.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter",
"request": {
"$ref": "BatchGetValuesByDataFilterRequest"
},
"response": {
"$ref": "BatchGetValuesByDataFilterResponse"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"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.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchUpdate",
"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/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
},
"batchUpdateByDataFilter": {
"description": "Sets values in one or more ranges of a spreadsheet.\nThe caller must specify the spreadsheet ID,\na valueInputOption, and one or more\nDataFilterValueRanges.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter",
"httpMethod": "POST",
"id": "sheets.spreadsheets.values.batchUpdateByDataFilter",
"parameterOrder": [
"spreadsheetId"
],
"parameters": {
"spreadsheetId": {
"description": "The ID of the spreadsheet to update.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter",
"request": {
"$ref": "BatchUpdateValuesByDataFilterRequest"
},
"response": {
"$ref": "BatchUpdateValuesByDataFilterResponse"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
},
"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.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}:clear",
"httpMethod": "POST",
"id": "sheets.spreadsheets.values.clear",
"parameterOrder": [
"spreadsheetId",
"range"
],
"parameters": {
"range": {
"description": "The A1 notation of the values to clear.",
"location": "path",
"required": true,
"type": "string"
},
"spreadsheetId": {
"description": "The ID of the spreadsheet to update.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}/values/{range}:clear",
"request": {
"$ref": "ClearValuesRequest"
},
"response": {
"$ref": "ClearValuesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"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.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}",
"httpMethod": "GET",
"id": "sheets.spreadsheets.values.get",
"parameterOrder": [
"spreadsheetId",
"range"
],
"parameters": {
"dateTimeRenderOption": {
"description": "How dates, times, and durations should be represented in the output.\nThis is ignored if value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"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"
},
"range": {
"description": "The A1 notation of the values to retrieve.",
"location": "path",
"required": true,
"type": "string"
},
"spreadsheetId": {
"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.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"enum": [
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"location": "query",
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}/values/{range}",
"response": {
"$ref": "ValueRange"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/drive.readonly",
"https://www.googleapis.com/auth/spreadsheets",
"https://www.googleapis.com/auth/spreadsheets.readonly"
]
},
"update": {
"description": "Sets values in a range of a spreadsheet.\nThe caller must specify the spreadsheet ID, range, and\na valueInputOption.",
"flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}",
"httpMethod": "PUT",
"id": "sheets.spreadsheets.values.update",
"parameterOrder": [
"spreadsheetId",
"range"
],
"parameters": {
"includeValuesInResponse": {
"description": "Determines if the update response should include the values\nof the cells that were updated. By default, responses\ndo not include the updated values.\nIf the range to write was larger than than the range actually written,\nthe response will include all values in the requested range (excluding\ntrailing empty rows and columns).",
"location": "query",
"type": "boolean"
},
"range": {
"description": "The A1 notation of the values to update.",
"location": "path",
"required": true,
"type": "string"
},
"responseDateTimeRenderOption": {
"description": "Determines how dates, times, and durations in the response should be\nrendered. This is ignored if response_value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is\nDateTimeRenderOption.SERIAL_NUMBER.",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"location": "query",
"type": "string"
},
"responseValueRenderOption": {
"description": "Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"enum": [
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"location": "query",
"type": "string"
},
"spreadsheetId": {
"description": "The ID of the spreadsheet to update.",
"location": "path",
"required": true,
"type": "string"
},
"valueInputOption": {
"description": "How the input data should be interpreted.",
"enum": [
"INPUT_VALUE_OPTION_UNSPECIFIED",
"RAW",
"USER_ENTERED"
],
"location": "query",
"type": "string"
}
},
"path": "v4/spreadsheets/{spreadsheetId}/values/{range}",
"request": {
"$ref": "ValueRange"
},
"response": {
"$ref": "UpdateValuesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
}
}
}
}
}
},
"revision": "20190109",
"rootUrl": "https://sheets.googleapis.com/",
"schemas": {
"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"
},
"AddBandingResponse": {
"description": "The result of adding a banded range.",
"id": "AddBandingResponse",
"properties": {
"bandedRange": {
"$ref": "BandedRange",
"description": "The banded range that was added."
}
},
"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. 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"
},
"AddChartResponse": {
"description": "The result of adding a chart to a spreadsheet.",
"id": "AddChartResponse",
"properties": {
"chart": {
"$ref": "EmbeddedChart",
"description": "The newly added chart."
}
},
"type": "object"
},
"AddConditionalFormatRuleRequest": {
"description": "Adds a new conditional format rule at the given index.\nAll subsequent rules' indexes are incremented.",
"id": "AddConditionalFormatRuleRequest",
"properties": {
"index": {
"description": "The zero-based index where the rule should be inserted.",
"format": "int32",
"type": "integer"
},
"rule": {
"$ref": "ConditionalFormatRule",
"description": "The rule to add."
}
},
"type": "object"
},
"AddDimensionGroupRequest": {
"description": "Creates a group over the specified range.\n\nIf the requested range is a superset of the range of an existing group G,\nthen the depth of G is incremented and this new group G' has the\ndepth of that group. For example, a group [C:D, depth 1] + [B:E] results in\ngroups [B:E, depth 1] and [C:D, depth 2].\nIf the requested range is a subset of the range of an existing group G,\nthen the depth of the new group G' becomes one greater than the depth of G.\nFor example, a group [B:E, depth 1] + [C:D] results in groups [B:E, depth 1]\nand [C:D, depth 2].\nIf the requested range starts before and ends within, or starts within and\nends after, the range of an existing group G, then the range of the existing\ngroup G becomes the union of the ranges, and the new group G' has\ndepth one greater than the depth of G and range as the intersection of the\nranges. For example, a group [B:D, depth 1] + [C:E] results in groups [B:E,\ndepth 1] and [C:D, depth 2].",
"id": "AddDimensionGroupRequest",
"properties": {
"range": {
"$ref": "DimensionRange",
"description": "The range over which to create a group."
}
},
"type": "object"
},
"AddDimensionGroupResponse": {
"description": "The result of adding a group.",
"id": "AddDimensionGroupResponse",
"properties": {
"dimensionGroups": {
"description": "All groups of a dimension after adding a group to that dimension.",
"items": {
"$ref": "DimensionGroup"
},
"type": "array"
}
},
"type": "object"
},
"AddFilterViewRequest": {
"description": "Adds a filter view.",
"id": "AddFilterViewRequest",
"properties": {
"filter": {
"$ref": "FilterView",
"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"
},
"AddFilterViewResponse": {
"description": "The result of adding a filter view.",
"id": "AddFilterViewResponse",
"properties": {
"filter": {
"$ref": "FilterView",
"description": "The newly added filter view."
}
},
"type": "object"
},
"AddNamedRangeRequest": {
"description": "Adds a named range to the spreadsheet.",
"id": "AddNamedRangeRequest",
"properties": {
"namedRange": {
"$ref": "NamedRange",
"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"
},
"AddNamedRangeResponse": {
"description": "The result of adding a named range.",
"id": "AddNamedRangeResponse",
"properties": {
"namedRange": {
"$ref": "NamedRange",
"description": "The named range to add."
}
},
"type": "object"
},
"AddProtectedRangeRequest": {
"description": "Adds a new protected range.",
"id": "AddProtectedRangeRequest",
"properties": {
"protectedRange": {
"$ref": "ProtectedRange",
"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"
},
"AddProtectedRangeResponse": {
"description": "The result of adding a new protected range.",
"id": "AddProtectedRangeResponse",
"properties": {
"protectedRange": {
"$ref": "ProtectedRange",
"description": "The newly added protected range."
}
},
"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.\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"
},
"AddSheetResponse": {
"description": "The result of adding a sheet.",
"id": "AddSheetResponse",
"properties": {
"properties": {
"$ref": "SheetProperties",
"description": "The properties of the newly added sheet."
}
},
"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": {
"fields": {
"description": "The fields of CellData that should be updated.\nAt least one field must be specified.\nThe root is the CellData; 'row.values.' should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"format": "google-fieldmask",
"type": "string"
},
"rows": {
"description": "The data to append.",
"items": {
"$ref": "RowData"
},
"type": "array"
},
"sheetId": {
"description": "The sheet ID to append the data to.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"AppendDimensionRequest": {
"description": "Appends rows or columns to the end of a sheet.",
"id": "AppendDimensionRequest",
"properties": {
"dimension": {
"description": "Whether rows or columns should be appended.",
"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."
],
"type": "string"
},
"length": {
"description": "The number of rows or columns to append.",
"format": "int32",
"type": "integer"
},
"sheetId": {
"description": "The sheet to append rows or columns to.",
"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"
},
"AutoFillRequest": {
"description": "Fills in more data based on existing data.",
"id": "AutoFillRequest",
"properties": {
"range": {
"$ref": "GridRange",
"description": "The range to autofill. This will examine the range and detect\nthe location that has data and automatically fill that data\nin to the rest of the range."
},
"sourceAndDestination": {
"$ref": "SourceAndDestination",
"description": "The source and destination areas to autofill.\nThis explicitly lists the source of the autofill and where to\nextend that data."
},
"useAlternateSeries": {
"description": "True if we should generate data with the \"alternate\" series.\nThis differs based on the type and amount of source data.",
"type": "boolean"
}
},
"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."
}
},
"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"
},
"columnProperties": {
"$ref": "BandingProperties",
"description": "Properties for column bands. These properties are 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."
},
"rowProperties": {
"$ref": "BandingProperties",
"description": "Properties for row bands. These properties are 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."
}
},
"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": {
"firstBandColor": {
"$ref": "Color",
"description": "The first color that is alternating. (Required)"
},
"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_band_color or\nsecond_band_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)"
}
},
"type": "object"
},
"BasicChartAxis": {
"description": "An axis of the chart.\nA chart may not have more than one axis per\naxis position.",
"id": "BasicChartAxis",
"properties": {
"format": {
"$ref": "TextFormat",
"description": "The format of the title.\nOnly valid if the axis is not associated with the domain."
},
"position": {
"description": "The position of this axis.",
"enum": [
"BASIC_CHART_AXIS_POSITION_UNSPECIFIED",
"BOTTOM_AXIS",
"LEFT_AXIS",
"RIGHT_AXIS"
],
"enumDescriptions": [
"Default value, do not use.",
"The axis rendered at the bottom of a chart.\nFor most charts, this is the standard major axis.\nFor bar charts, this is a minor axis.",
"The axis rendered at the left of a chart.\nFor most charts, this is a minor axis.\nFor bar charts, this is the standard major axis.",
"The axis rendered at the right of a chart.\nFor most charts, this is a minor axis.\nFor bar charts, this is an unusual major axis."
],
"type": "string"
},
"title": {
"description": "The title of this axis. If set, this overrides any title inferred\nfrom headers of the data.",
"type": "string"
},
"titleTextPosition": {
"$ref": "TextPosition",
"description": "The axis title text position."
}
},
"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 is the data representing the dates."
},
"reversed": {
"description": "True to reverse the order of the domain values (horizontal axis).",
"type": "boolean"
}
},
"type": "object"
},
"BasicChartSeries": {
"description": "A single series of data in a chart.\nFor example, if charting stock prices over time, multiple series may exist,\none for the \"Open Price\", \"High Price\", \"Low Price\" and \"Close Price\".",
"id": "BasicChartSeries",
"properties": {
"color": {
"$ref": "Color",
"description": "The color for elements (i.e. bars, lines, points) associated with this\nseries. If empty, a default color is used."
},
"lineStyle": {
"$ref": "LineStyle",
"description": "The line style of this series. Valid only if the\nchartType is AREA,\nLINE, or SCATTER.\nCOMBO charts are also supported if the\nseries chart type is\nAREA or LINE."
},
"series": {
"$ref": "ChartData",
"description": "The data being visualized in this chart series."
},
"targetAxis": {
"description": "The minor axis that will specify the range of values for this series.\nFor example, if charting stocks over time, the \"Volume\" series\nmay want to be pinned to the right with the prices pinned to the left,\nbecause the scale of trading volume is different than the scale of\nprices.\nIt is an error to specify an axis that isn't a valid minor axis\nfor the chart's type.",
"enum": [
"BASIC_CHART_AXIS_POSITION_UNSPECIFIED",
"BOTTOM_AXIS",
"LEFT_AXIS",
"RIGHT_AXIS"
],
"enumDescriptions": [
"Default value, do not use.",
"The axis rendered at the bottom of a chart.\nFor most charts, this is the standard major axis.\nFor bar charts, this is a minor axis.",
"The axis rendered at the left of a chart.\nFor most charts, this is a minor axis.\nFor bar charts, this is the standard major axis.",
"The axis rendered at the right of a chart.\nFor most charts, this is a minor axis.\nFor bar charts, this is an unusual major axis."
],
"type": "string"
},
"type": {
"description": "The type of this series. Valid only if the\nchartType is\nCOMBO.\nDifferent types will change the way the series is visualized.\nOnly LINE, AREA,\nand COLUMN are supported.",
"enum": [
"BASIC_CHART_TYPE_UNSPECIFIED",
"BAR",
"LINE",
"AREA",
"COLUMN",
"SCATTER",
"COMBO",
"STEPPED_AREA"
],
"enumDescriptions": [
"Default value, do not use.",
"A \u003ca href=\"/chart/interactive/docs/gallery/barchart\"\u003ebar chart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/linechart\"\u003eline chart\u003c/a\u003e.",
"An \u003ca href=\"/chart/interactive/docs/gallery/areachart\"\u003earea chart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/columnchart\"\u003ecolumn chart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/scatterchart\"\u003escatter\nchart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/combochart\"\u003ecombo chart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/steppedareachart\"\u003estepped area\nchart\u003c/a\u003e."
],
"type": "string"
}
},
"type": "object"
},
"BasicChartSpec": {
"description": "The specification for a basic chart. See BasicChartType for the list\nof charts this supports.",
"id": "BasicChartSpec",
"properties": {
"axis": {
"description": "The axis on the chart.",
"items": {
"$ref": "BasicChartAxis"
},
"type": "array"
},
"chartType": {
"description": "The type of the chart.",
"enum": [
"BASIC_CHART_TYPE_UNSPECIFIED",
"BAR",
"LINE",
"AREA",
"COLUMN",
"SCATTER",
"COMBO",
"STEPPED_AREA"
],
"enumDescriptions": [
"Default value, do not use.",
"A \u003ca href=\"/chart/interactive/docs/gallery/barchart\"\u003ebar chart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/linechart\"\u003eline chart\u003c/a\u003e.",
"An \u003ca href=\"/chart/interactive/docs/gallery/areachart\"\u003earea chart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/columnchart\"\u003ecolumn chart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/scatterchart\"\u003escatter\nchart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/combochart\"\u003ecombo chart\u003c/a\u003e.",
"A \u003ca href=\"/chart/interactive/docs/gallery/steppedareachart\"\u003estepped area\nchart\u003c/a\u003e."
],
"type": "string"
},
"compareMode": {
"description": "The behavior of tooltips and data highlighting when hovering on data and\nchart area.",
"enum": [
"BASIC_CHART_COMPARE_MODE_UNSPECIFIED",
"DATUM",
"CATEGORY"
],
"enumDescriptions": [
"Default value, do not use.",
"Only the focused data element is highlighted and shown in the tooltip.",
"All data elements with the same category (e.g., domain value) are\nhighlighted and shown in the tooltip."
],
"type": "string"
},
"domains": {
"description": "The domain of data this is charting.\nOnly a single domain is supported.",
"items": {
"$ref": "BasicChartDomain"
},
"type": "array"
},
"headerCount": {
"description": "The number of rows or columns in the data that are \"headers\".\nIf not set, Google Sheets will guess how many rows are headers based\non the data.\n\n(Note that BasicChartAxis.title may override the axis title\n inferred from the header values.)",
"format": "int32",
"type": "integer"
},
"interpolateNulls": {
"description": "If some values in a series are missing, gaps may appear in the chart (e.g,\nsegments of lines in a line chart will be missing). To eliminate these\ngaps set this to true.\nApplies to Line, Area, and Combo charts.",
"type": "boolean"
},
"legendPosition": {
"description": "The position of the chart legend.",
"enum": [
"BASIC_CHART_LEGEND_POSITION_UNSPECIFIED",
"BOTTOM_LEGEND",
"LEFT_LEGEND",
"RIGHT_LEGEND",
"TOP_LEGEND",
"NO_LEGEND"
],
"enumDescriptions": [
"Default value, do not use.",
"The legend is rendered on the bottom of the chart.",
"The legend is rendered on the left of the chart.",
"The legend is rendered on the right of the chart.",
"The legend is rendered on the top of the chart.",
"No legend is rendered."
],
"type": "string"
},
"lineSmoothing": {
"description": "Gets whether all lines should be rendered smooth or straight by default.\nApplies to Line charts.",
"type": "boolean"
},
"series": {
"description": "The data this chart is visualizing.",
"items": {
"$ref": "BasicChartSeries"
},
"type": "array"
},
"stackedType": {
"description": "The stacked type for charts that support vertical stacking.\nApplies to Area, Bar, Column, Combo, and Stepped Area charts.",
"enum": [
"BASIC_CHART_STACKED_TYPE_UNSPECIFIED",
"NOT_STACKED",
"STACKED",
"PERCENT_STACKED"
],
"enumDescriptions": [
"Default value, do not use.",
"Series are not stacked.",
"Series values are stacked, each value is rendered vertically beginning\nfrom the top of the value below it.",
"Vertical stacks are stretched to reach the top of the chart, with\nvalues laid out as percentages of each other."
],
"type": "string"
},
"threeDimensional": {
"description": "True to make the chart 3D.\nApplies to Bar and Column charts.",
"type": "boolean"
}
},
"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"
},
"range": {
"$ref": "GridRange",
"description": "The range the filter covers."
},
"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"
},
"BatchClearValuesByDataFilterRequest": {
"description": "The request for clearing more than one range selected by a\nDataFilter in a spreadsheet.",
"id": "BatchClearValuesByDataFilterRequest",
"properties": {
"dataFilters": {
"description": "The DataFilters used to determine which ranges to clear.",
"items": {
"$ref": "DataFilter"
},
"type": "array"
}
},
"type": "object"
},
"BatchClearValuesByDataFilterResponse": {
"description": "The response when clearing a range of values selected with\nDataFilters in a spreadsheet.",
"id": "BatchClearValuesByDataFilterResponse",
"properties": {
"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"
},
"spreadsheetId": {
"description": "The spreadsheet the updates were applied to.",
"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"
},
"BatchClearValuesResponse": {
"description": "The response when clearing a range of values in a spreadsheet.",
"id": "BatchClearValuesResponse",
"properties": {
"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"
},
"spreadsheetId": {
"description": "The spreadsheet the updates were applied to.",
"type": "string"
}
},
"type": "object"
},
"BatchGetValuesByDataFilterRequest": {
"description": "The request for retrieving a range of values in a spreadsheet selected by a\nset of DataFilters.",
"id": "BatchGetValuesByDataFilterRequest",
"properties": {
"dataFilters": {
"description": "The data filters used to match the ranges of values to retrieve. Ranges\nthat match any of the specified data filters will be included in the\nresponse.",
"items": {
"$ref": "DataFilter"
},
"type": "array"
},
"dateTimeRenderOption": {
"description": "How dates, times, and durations should be represented in the output.\nThis is ignored if value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output\nas doubles in \"serial number\" format, as popularized by Lotus 1-2-3.\nThe whole number portion of the value (left of the decimal) counts\nthe days since December 30th 1899. The fractional portion (right of\nthe decimal) counts the time as a fraction of the day. For example,\nJanuary 1st 1900 at noon would be 2.5, 2 because it's 2 days after\nDecember 30st 1899, and .5 because noon is half a day. February 1st\n1900 at 3pm would be 33.625. This correctly treats the year 1900 as\nnot a leap year.",
"Instructs date, time, datetime, and duration fields to be output\nas strings in their given number format (which is dependent\non the spreadsheet locale)."
],
"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 a request that selects that range and sets `majorDimension=ROWS` will\nreturn `[[1,2],[3,4]]`,\nwhereas a request that sets `majorDimension=COLUMNS` will return\n`[[1,3],[2,4]]`.",
"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."
],
"type": "string"
},
"valueRenderOption": {
"description": "How values should be represented in the output.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"enum": [
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"enumDescriptions": [
"Values will be calculated \u0026 formatted in the reply according to the\ncell's formatting. Formatting is based on the spreadsheet's locale,\nnot the requesting user's locale.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen A2 would return `\"=A1\"`."
],
"type": "string"
}
},
"type": "object"
},
"BatchGetValuesByDataFilterResponse": {
"description": "The response when retrieving more than one range of values in a spreadsheet\nselected by DataFilters.",
"id": "BatchGetValuesByDataFilterResponse",
"properties": {
"spreadsheetId": {
"description": "The ID of the spreadsheet the data was retrieved from.",
"type": "string"
},
"valueRanges": {
"description": "The requested values with the list of data filters that matched them.",
"items": {
"$ref": "MatchedValueRange"
},
"type": "array"
}
},
"type": "object"
},
"BatchGetValuesResponse": {
"description": "The response when retrieving more than one range of values in a spreadsheet.",
"id": "BatchGetValuesResponse",
"properties": {
"spreadsheetId": {
"description": "The ID of the spreadsheet the data was retrieved from.",
"type": "string"
},
"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"
}
},
"type": "object"
},
"BatchUpdateSpreadsheetRequest": {
"description": "The request for updating any aspect of a spreadsheet.",
"id": "BatchUpdateSpreadsheetRequest",
"properties": {
"includeSpreadsheetInResponse": {
"description": "Determines if the update response should include the spreadsheet\nresource.",
"type": "boolean"
},
"requests": {
"description": "A list of updates to apply to the spreadsheet.\nRequests will be applied in the order they are specified.\nIf any request is not valid, no requests will be applied.",
"items": {
"$ref": "Request"
},
"type": "array"
},
"responseIncludeGridData": {
"description": "True if grid data should be returned. Meaningful only if\nif include_spreadsheet_in_response is 'true'.\nThis parameter is ignored if a field mask was set in the request.",
"type": "boolean"
},
"responseRanges": {
"description": "Limits the ranges included in the response spreadsheet.\nMeaningful only if include_spreadsheet_response is 'true'.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"BatchUpdateSpreadsheetResponse": {
"description": "The reply for batch updating a spreadsheet.",
"id": "BatchUpdateSpreadsheetResponse",
"properties": {
"replies": {
"description": "The reply of the updates. This maps 1:1 with the updates, although\nreplies to some requests may be empty.",
"items": {
"$ref": "Response"
},
"type": "array"
},
"spreadsheetId": {
"description": "The spreadsheet the updates were applied to.",
"type": "string"
},
"updatedSpreadsheet": {
"$ref": "Spreadsheet",
"description": "The spreadsheet after updates were applied. This is only set if\n[BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response] is `true`."
}
},
"type": "object"
},
"BatchUpdateValuesByDataFilterRequest": {
"description": "The request for updating more than one range of values in a spreadsheet.",
"id": "BatchUpdateValuesByDataFilterRequest",
"properties": {
"data": {
"description": "The new values to apply to the spreadsheet. If more than one range is\nmatched by the specified DataFilter the specified values will be\napplied to all of those ranges.",
"items": {
"$ref": "DataFilterValueRange"
},
"type": "array"
},
"includeValuesInResponse": {
"description": "Determines if the update response should include the values\nof the cells that were updated. By default, responses\ndo not include the updated values. The `updatedData` field within\neach of the BatchUpdateValuesResponse.responses will contain\nthe updated values. If the range to write was larger than than the range\nactually written, the response will include all values in the requested\nrange (excluding trailing empty rows and columns).",
"type": "boolean"
},
"responseDateTimeRenderOption": {
"description": "Determines how dates, times, and durations in the response should be\nrendered. This is ignored if response_value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is\nDateTimeRenderOption.SERIAL_NUMBER.",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output\nas doubles in \"serial number\" format, as popularized by Lotus 1-2-3.\nThe whole number portion of the value (left of the decimal) counts\nthe days since December 30th 1899. The fractional portion (right of\nthe decimal) counts the time as a fraction of the day. For example,\nJanuary 1st 1900 at noon would be 2.5, 2 because it's 2 days after\nDecember 30st 1899, and .5 because noon is half a day. February 1st\n1900 at 3pm would be 33.625. This correctly treats the year 1900 as\nnot a leap year.",
"Instructs date, time, datetime, and duration fields to be output\nas strings in their given number format (which is dependent\non the spreadsheet locale)."
],
"type": "string"
},
"responseValueRenderOption": {
"description": "Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"enum": [
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"enumDescriptions": [
"Values will be calculated \u0026 formatted in the reply according to the\ncell's formatting. Formatting is based on the spreadsheet's locale,\nnot the requesting user's locale.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen A2 would return `\"=A1\"`."
],
"type": "string"
},
"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 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"
}
},
"type": "object"
},
"BatchUpdateValuesByDataFilterResponse": {
"description": "The response when updating a range of values in a spreadsheet.",
"id": "BatchUpdateValuesByDataFilterResponse",
"properties": {
"responses": {
"description": "The response for each range updated.",
"items": {
"$ref": "UpdateValuesByDataFilterResponse"
},
"type": "array"
},
"spreadsheetId": {
"description": "The spreadsheet the updates were applied to.",
"type": "string"
},
"totalUpdatedCells": {
"description": "The total number of cells updated.",
"format": "int32",
"type": "integer"
},
"totalUpdatedColumns": {
"description": "The total number of columns where at least one cell in the column was\nupdated.",
"format": "int32",
"type": "integer"
},
"totalUpdatedRows": {
"description": "The total number of rows where at least one cell in the row was updated.",
"format": "int32",
"type": "integer"
},
"totalUpdatedSheets": {
"description": "The total number of sheets where at least one cell in the sheet was\nupdated.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"BatchUpdateValuesRequest": {
"description": "The request for updating more than one range of values in a spreadsheet.",
"id": "BatchUpdateValuesRequest",
"properties": {
"data": {
"description": "The new values to apply to the spreadsheet.",
"items": {
"$ref": "ValueRange"
},
"type": "array"
},
"includeValuesInResponse": {
"description": "Determines if the update response should include the values\nof the cells that were updated. By default, responses\ndo not include the updated values. The `updatedData` field within\neach of the BatchUpdateValuesResponse.responses will contain\nthe updated values. If the range to write was larger than than the range\nactually written, the response will include all values in the requested\nrange (excluding trailing empty rows and columns).",
"type": "boolean"
},
"responseDateTimeRenderOption": {
"description": "Determines how dates, times, and durations in the response should be\nrendered. This is ignored if response_value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is\nDateTimeRenderOption.SERIAL_NUMBER.",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output\nas doubles in \"serial number\" format, as popularized by Lotus 1-2-3.\nThe whole number portion of the value (left of the decimal) counts\nthe days since December 30th 1899. The fractional portion (right of\nthe decimal) counts the time as a fraction of the day. For example,\nJanuary 1st 1900 at noon would be 2.5, 2 because it's 2 days after\nDecember 30st 1899, and .5 because noon is half a day. February 1st\n1900 at 3pm would be 33.625. This correctly treats the year 1900 as\nnot a leap year.",
"Instructs date, time, datetime, and duration fields to be output\nas strings in their given number format (which is dependent\non the spreadsheet locale)."
],
"type": "string"
},
"responseValueRenderOption": {
"description": "Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"enum": [
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"enumDescriptions": [
"Values will be calculated \u0026 formatted in the reply according to the\ncell's formatting. Formatting is based on the spreadsheet's locale,\nnot the requesting user's locale.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen A2 would return `\"=A1\"`."
],
"type": "string"
},
"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 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"
}
},
"type": "object"
},
"BatchUpdateValuesResponse": {
"description": "The response when updating a range of values in a spreadsheet.",
"id": "BatchUpdateValuesResponse",
"properties": {
"responses": {
"description": "One UpdateValuesResponse per requested range, in the same order as\nthe requests appeared.",
"items": {
"$ref": "UpdateValuesResponse"
},
"type": "array"
},
"spreadsheetId": {
"description": "The spreadsheet the updates were applied to.",
"type": "string"
},
"totalUpdatedCells": {
"description": "The total number of cells updated.",
"format": "int32",
"type": "integer"
},
"totalUpdatedColumns": {
"description": "The total number of columns where at least one cell in the column was\nupdated.",
"format": "int32",
"type": "integer"
},
"totalUpdatedRows": {
"description": "The total number of rows where at least one cell in the row was updated.",
"format": "int32",
"type": "integer"
},
"totalUpdatedSheets": {
"description": "The total number of sheets where at least one cell in the sheet was\nupdated.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"BooleanCondition": {
"description": "A condition that can evaluate to true or false.\nBooleanConditions are used by conditional formatting,\ndata validation, and the criteria in filters.",
"id": "BooleanCondition",
"properties": {
"type": {
"description": "The type of condition.",
"enum": [
"CONDITION_TYPE_UNSPECIFIED",
"NUMBER_GREATER",
"NUMBER_GREATER_THAN_EQ",
"NUMBER_LESS",
"NUMBER_LESS_THAN_EQ",
"NUMBER_EQ",
"NUMBER_NOT_EQ",
"NUMBER_BETWEEN",
"NUMBER_NOT_BETWEEN",
"TEXT_CONTAINS",
"TEXT_NOT_CONTAINS",
"TEXT_STARTS_WITH",
"TEXT_ENDS_WITH",
"TEXT_EQ",
"TEXT_IS_EMAIL",
"TEXT_IS_URL",
"DATE_EQ",
"DATE_BEFORE",
"DATE_AFTER",
"DATE_ON_OR_BEFORE",
"DATE_ON_OR_AFTER",
"DATE_BETWEEN",
"DATE_NOT_BETWEEN",
"DATE_IS_VALID",
"ONE_OF_RANGE",
"ONE_OF_LIST",
"BLANK",
"NOT_BLANK",
"CUSTOM_FORMULA",
"BOOLEAN"
],
"enumDescriptions": [
"The default value, do not use.",
"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 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.\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 be 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 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.",
"The cell's value must be TRUE/FALSE or in the list of condition values.\nSupported by data validation.\nRenders as a cell checkbox.\nSupports zero, one or two ConditionValues. No\nvalues indicates the cell must be TRUE or FALSE, where TRUE renders as\nchecked and FALSE renders as unchecked. One value indicates the cell\nwill render as checked when it contains that value and unchecked when it\nis blank. Two values indicate that the cell will render as checked when\nit contains the first value and unchecked when it contains the second\nvalue. For example, [\"Yes\",\"No\"] indicates that the cell will render a\nchecked box when it has the value \"Yes\" and an unchecked box when it has\nthe value \"No\"."
],
"type": "string"
},
"values": {
"description": "The values of the condition. The number of supported values depends\non the condition type. Some support zero values,\nothers one or two values,\nand ConditionType.ONE_OF_LIST supports an arbitrary number of values.",
"items": {
"$ref": "ConditionValue"
},
"type": "array"
}
},
"type": "object"
},
"BooleanRule": {
"description": "A rule that may or may not match, depending on the condition.",
"id": "BooleanRule",
"properties": {
"condition": {
"$ref": "BooleanCondition",
"description": "The condition of the rule. If the condition evaluates to true,\nthe format is applied."
},
"format": {
"$ref": "CellFormat",
"description": "The format to apply.\nConditional formatting can only apply a subset of formatting:\nbold, italic,\nstrikethrough,\nforeground color \u0026\nbackground color."
}
},
"type": "object"
},
"Border": {
"description": "A border along a cell.",
"id": "Border",
"properties": {
"color": {
"$ref": "Color",
"description": "The color of the border."
},
"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 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.\nDeprecated; the width is determined by the \"style\" field.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"Borders": {
"description": "The borders of the cell.",
"id": "Borders",
"properties": {
"bottom": {
"$ref": "Border",
"description": "The bottom border of the cell."
},
"left": {
"$ref": "Border",
"description": "The left border of the cell."
},
"right": {
"$ref": "Border",
"description": "The right border of the cell."
},
"top": {
"$ref": "Border",
"description": "The top border of the cell."
}
},
"type": "object"
},
"BubbleChartSpec": {
"description": "A \u003ca href=\"/chart/interactive/docs/gallery/bubblechart\"\u003ebubble chart\u003c/a\u003e.",
"id": "BubbleChartSpec",
"properties": {
"bubbleBorderColor": {
"$ref": "Color",
"description": "The bubble border color."
},
"bubbleLabels": {
"$ref": "ChartData",
"description": "The data containing the bubble labels. These do not need to be unique."
},
"bubbleMaxRadiusSize": {
"description": "The max radius size of the bubbles, in pixels.\nIf specified, the field must be a positive value.",
"format": "int32",
"type": "integer"
},
"bubbleMinRadiusSize": {
"description": "The minimum radius size of the bubbles, in pixels.\nIf specific, the field must be a positive value.",
"format": "int32",
"type": "integer"
},
"bubbleOpacity": {
"description": "The opacity of the bubbles between 0 and 1.0.\n0 is fully transparent and 1 is fully opaque.",
"format": "float",
"type": "number"
},
"bubbleSizes": {
"$ref": "ChartData",
"description": "The data contianing the bubble sizes. Bubble sizes are used to draw\nthe bubbles at different sizes relative to each other.\nIf specified, group_ids must also be specified. This field is\noptional."
},
"bubbleTextStyle": {
"$ref": "TextFormat",
"description": "The format of the text inside the bubbles.\nUnderline and Strikethrough are not supported."
},
"domain": {
"$ref": "ChartData",
"description": "The data containing the bubble x-values. These values locate the bubbles\nin the chart horizontally."
},
"groupIds": {
"$ref": "ChartData",
"description": "The data containing the bubble group IDs. All bubbles with the same group\nID are drawn in the same color. If bubble_sizes is specified then\nthis field must also be specified but may contain blank values.\nThis field is optional."
},
"legendPosition": {
"description": "Where the legend of the chart should be drawn.",
"enum": [
"BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED",
"BOTTOM_LEGEND",
"LEFT_LEGEND",
"RIGHT_LEGEND",
"TOP_LEGEND",
"NO_LEGEND",
"INSIDE_LEGEND"
],
"enumDescriptions": [
"Default value, do not use.",
"The legend is rendered on the bottom of the chart.",
"The legend is rendered on the left of the chart.",
"The legend is rendered on the right of the chart.",
"The legend is rendered on the top of the chart.",
"No legend is rendered.",
"The legend is rendered inside the chart area."
],
"type": "string"
},
"series": {
"$ref": "ChartData",
"description": "The data contianing the bubble y-values. These values locate the bubbles\nin the chart vertically."
}
},
"type": "object"
},
"CandlestickChartSpec": {
"description": "A \u003ca href=\"/chart/interactive/docs/gallery/candlestickchart\"\u003ecandlestick\nchart\u003c/a\u003e.",
"id": "CandlestickChartSpec",
"properties": {
"data": {
"description": "The Candlestick chart data.\nOnly one CandlestickData is supported.",
"items": {
"$ref": "CandlestickData"
},
"type": "array"
},
"domain": {
"$ref": "CandlestickDomain",
"description": "The domain data (horizontal axis) for the candlestick chart. String data\nwill be treated as discrete labels, other data will be treated as\ncontinuous values."
}
},
"type": "object"
},
"CandlestickData": {
"description": "The Candlestick chart data, each containing the low, open, close, and high\nvalues for a series.",
"id": "CandlestickData",
"properties": {
"closeSeries": {
"$ref": "CandlestickSeries",
"description": "The range data (vertical axis) for the close/final value for each candle.\nThis is the top of the candle body. If greater than the open value the\ncandle will be filled. Otherwise the candle will be hollow."
},
"highSeries": {
"$ref": "CandlestickSeries",
"description": "The range data (vertical axis) for the high/maximum value for each\ncandle. This is the top of the candle's center line."
},
"lowSeries": {
"$ref": "CandlestickSeries",
"description": "The range data (vertical axis) for the low/minimum value for each candle.\nThis is the bottom of the candle's center line."
},
"openSeries": {
"$ref": "CandlestickSeries",
"description": "The range data (vertical axis) for the open/initial value for each\ncandle. This is the bottom of the candle body. If less than the close\nvalue the candle will be filled. Otherwise the candle will be hollow."
}
},
"type": "object"
},
"CandlestickDomain": {
"description": "The domain of a CandlestickChart.",
"id": "CandlestickDomain",
"properties": {
"data": {
"$ref": "ChartData",
"description": "The data of the CandlestickDomain."
},
"reversed": {
"description": "True to reverse the order of the domain values (horizontal axis).",
"type": "boolean"
}
},
"type": "object"
},
"CandlestickSeries": {
"description": "The series of a CandlestickData.",
"id": "CandlestickSeries",
"properties": {
"data": {
"$ref": "ChartData",
"description": "The data of the CandlestickSeries."
}
},
"type": "object"
},
"CellData": {
"description": "Data about a specific cell.",
"id": "CellData",
"properties": {
"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."
},
"effectiveFormat": {
"$ref": "CellFormat",
"description": "The effective format being used by the cell.\nThis includes the results of applying any conditional formatting and,\nif the cell contains a formula, the computed number format.\nIf the effective format is the default format, effective format will\nnot be written.\nThis field is read-only."
},
"effectiveValue": {
"$ref": "ExtendedValue",
"description": "The effective value of the cell. For cells with formulas, this is\nthe calculated value. For cells with literals, this is\nthe same as the user_entered_value.\nThis field is read-only."
},
"formattedValue": {
"description": "The formatted value of the cell.\nThis is the value as it's shown to the user.\nThis field is read-only.",
"type": "string"
},
"hyperlink": {
"description": "A hyperlink this cell points to, if any.\nThis field is read-only. (To set it, use a `=HYPERLINK` formula\nin the userEnteredValue.formulaValue\nfield.)",
"type": "string"
},
"note": {
"description": "Any note on the cell.",
"type": "string"
},
"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 effective_value fields."
},
"textFormatRuns": {
"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 are erased.",
"items": {
"$ref": "TextFormatRun"
},
"type": "array"
},
"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."
},
"userEnteredValue": {
"$ref": "ExtendedValue",
"description": "The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`\nNote: Dates, Times and DateTimes are represented as doubles in\nserial number format."
}
},
"type": "object"
},
"CellFormat": {
"description": "The format of a cell.",
"id": "CellFormat",
"properties": {
"backgroundColor": {
"$ref": "Color",
"description": "The background color of the cell."
},
"borders": {
"$ref": "Borders",
"description": "The borders of the cell."
},
"horizontalAlignment": {
"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 rendered. Do not use this.",
"A hyperlink should be explicitly rendered.",
"A hyperlink should not be rendered."
],
"type": "string"
},
"numberFormat": {
"$ref": "NumberFormat",
"description": "A format describing how number values should be represented to the user."
},
"padding": {
"$ref": "Padding",
"description": "The padding of the cell."
},
"textDirection": {
"description": "The direction of the text in the cell.",
"enum": [
"TEXT_DIRECTION_UNSPECIFIED",
"LEFT_TO_RIGHT",
"RIGHT_TO_LEFT"
],
"enumDescriptions": [
"The text direction is not specified. Do not use this.",
"The text direction of left-to-right was set by the user.",
"The text direction of right-to-left was set by the user."
],
"type": "string"
},
"textFormat": {
"$ref": "TextFormat",
"description": "The format of the text in the cell (unless overridden by a format run)."
},
"textRotation": {
"$ref": "TextRotation",
"description": "The rotation applied to text in a cell"
},
"verticalAlignment": {
"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"
},
"wrapStrategy": {
"description": "The wrap strategy for the value in the cell.",
"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. \u003c- 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| \u003c- 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| \u003c- 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| \u003c- Word is broken.\n | ong word. |"
],
"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"
},
"ChartSourceRange": {
"description": "Source ranges for a chart.",
"id": "ChartSourceRange",
"properties": {
"sources": {
"description": "The ranges of data for a series or domain.\nExactly one dimension must have a length of 1,\nand all sources in the list must have the same dimension\nwith length 1.\nThe domain (if it exists) \u0026 all series must have the same number\nof source ranges. If using more than one source range, then the source\nrange at a given offset must be in order and contiguous across the domain\nand series.\n\nFor example, these are valid configurations:\n\n domain sources: A1:A5\n series1 sources: B1:B5\n series2 sources: D6:D10\n\n domain sources: A1:A5, C10:C12\n series1 sources: B1:B5, D10:D12\n series2 sources: C1:C5, E10:E12",
"items": {
"$ref": "GridRange"
},
"type": "array"
}
},
"type": "object"
},
"ChartSpec": {
"description": "The specifications of a chart.",
"id": "ChartSpec",
"properties": {
"altText": {
"description": "The alternative text that describes the chart. This is often used\nfor accessibility.",
"type": "string"
},
"backgroundColor": {
"$ref": "Color",
"description": "The background color of the entire chart.\nNot applicable to Org charts."
},
"basicChart": {
"$ref": "BasicChartSpec",
"description": "A basic chart specification, can be one of many kinds of charts.\nSee BasicChartType for the list of all\ncharts this supports."
},
"bubbleChart": {
"$ref": "BubbleChartSpec",
"description": "A bubble chart specification."
},
"candlestickChart": {
"$ref": "CandlestickChartSpec",
"description": "A candlestick chart specification."
},
"fontName": {
"description": "The name of the font to use by default for all chart text (e.g. title,\naxis labels, legend). If a font is specified for a specific part of the\nchart it will override this font name.",
"type": "string"
},
"hiddenDimensionStrategy": {
"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"
},
"histogramChart": {
"$ref": "HistogramChartSpec",
"description": "A histogram chart specification."
},
"maximized": {
"description": "True to make a chart fill the entire space in which it's rendered with\nminimum padding. False to use the default padding.\n(Not applicable to Geo and Org charts.)",
"type": "boolean"
},
"orgChart": {
"$ref": "OrgChartSpec",
"description": "An org chart specification."
},
"pieChart": {
"$ref": "PieChartSpec",
"description": "A pie chart specification."
},
"subtitle": {
"description": "The subtitle of the chart.",
"type": "string"
},
"subtitleTextFormat": {
"$ref": "TextFormat",
"description": "The subtitle text format.\nStrikethrough and underline are not supported."
},
"subtitleTextPosition": {
"$ref": "TextPosition",
"description": "The subtitle text position.\nThis field is optional."
},
"title": {
"description": "The title of the chart.",
"type": "string"
},
"titleTextFormat": {
"$ref": "TextFormat",
"description": "The title text format.\nStrikethrough and underline are not supported."
},
"titleTextPosition": {
"$ref": "TextPosition",
"description": "The title text position.\nThis field is optional."
},
"treemapChart": {
"$ref": "TreemapChartSpec",
"description": "A treemap chart specification."
},
"waterfallChart": {
"$ref": "WaterfallChartSpec",
"description": "A waterfall chart specification."
}
},
"type": "object"
},
"ClearBasicFilterRequest": {
"description": "Clears the basic filter, if any exists on the sheet.",
"id": "ClearBasicFilterRequest",
"properties": {
"sheetId": {
"description": "The sheet ID on which the basic filter should be cleared.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"ClearValuesRequest": {
"description": "The request for clearing a range of values in a spreadsheet.",
"id": "ClearValuesRequest",
"properties": {},
"type": "object"
},
"ClearValuesResponse": {
"description": "The response when clearing a range of values in a spreadsheet.",
"id": "ClearValuesResponse",
"properties": {
"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"
},
"spreadsheetId": {
"description": "The spreadsheet the updates were applied to.",
"type": "string"
}
},
"type": "object"
},
"Color": {
"description": "Represents a color in the RGBA color space. This representation is designed\nfor simplicity of conversion to/from color representations in various\nlanguages over compactness; for example, the fields of this representation\ncan be trivially provided to the constructor of \"java.awt.Color\" in Java; it\ncan also be trivially provided to UIColor's \"+colorWithRed:green:blue:alpha\"\nmethod in iOS; and, with just a little work, it can be easily formatted into\na CSS \"rgba()\" string in JavaScript, as well. Here are some examples:\n\nExample (Java):\n\n import com.google.type.Color;\n\n // ...\n public static java.awt.Color fromProto(Color protocolor) {\n float alpha = protocolor.hasAlpha()\n ? protocolor.getAlpha().getValue()\n : 1.0;\n\n return new java.awt.Color(\n protocolor.getRed(),\n protocolor.getGreen(),\n protocolor.getBlue(),\n alpha);\n }\n\n public static Color toProto(java.awt.Color color) {\n float red = (float) color.getRed();\n float green = (float) color.getGreen();\n float blue = (float) color.getBlue();\n float denominator = 255.0;\n Color.Builder resultBuilder =\n Color\n .newBuilder()\n .setRed(red / denominator)\n .setGreen(green / denominator)\n .setBlue(blue / denominator);\n int alpha = color.getAlpha();\n if (alpha != 255) {\n result.setAlpha(\n FloatValue\n .newBuilder()\n .setValue(((float) alpha) / denominator)\n .build());\n }\n return resultBuilder.build();\n }\n // ...\n\nExample (iOS / Obj-C):\n\n // ...\n static UIColor* fromProto(Color* protocolor) {\n float red = [protocolor red];\n float green = [protocolor green];\n float blue = [protocolor blue];\n FloatValue* alpha_wrapper = [protocolor alpha];\n float alpha = 1.0;\n if (alpha_wrapper != nil) {\n alpha = [alpha_wrapper value];\n }\n return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];\n }\n\n static Color* toProto(UIColor* color) {\n CGFloat red, green, blue, alpha;\n if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) {\n return nil;\n }\n Color* result = [[Color alloc] init];\n [result setRed:red];\n [result setGreen:green];\n [result setBlue:blue];\n if (alpha \u003c= 0.9999) {\n [result setAlpha:floatWrapperWithValue(alpha)];\n }\n [result autorelease];\n return result;\n }\n // ...\n\n Example (JavaScript):\n\n // ...\n\n var protoToCssColor = function(rgb_color) {\n var redFrac = rgb_color.red || 0.0;\n var greenFrac = rgb_color.green || 0.0;\n var blueFrac = rgb_color.blue || 0.0;\n var red = Math.floor(redFrac * 255);\n var green = Math.floor(greenFrac * 255);\n var blue = Math.floor(blueFrac * 255);\n\n if (!('alpha' in rgb_color)) {\n return rgbToCssColor_(red, green, blue);\n }\n\n var alphaFrac = rgb_color.alpha.value || 0.0;\n var rgbParams = [red, green, blue].join(',');\n return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');\n };\n\n var rgbToCssColor_ = function(red, green, blue) {\n var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue);\n var hexString = rgbNumber.toString(16);\n var missingZeros = 6 - hexString.length;\n var resultBuilder = ['#'];\n for (var i = 0; i \u003c missingZeros; i++) {\n resultBuilder.push('0');\n }\n resultBuilder.push(hexString);\n return resultBuilder.join('');\n };\n\n // ...",
"id": "Color",
"properties": {
"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"
},
"blue": {
"description": "The amount of blue in the color as a value in the interval [0, 1].",
"format": "float",
"type": "number"
},
"green": {
"description": "The amount of green in the color as a value in the interval [0, 1].",
"format": "float",
"type": "number"
},
"red": {
"description": "The amount of red in the color as a value in the interval [0, 1].",
"format": "float",
"type": "number"
}
},
"type": "object"
},
"ConditionValue": {
"description": "The value of the condition.",
"id": "ConditionValue",
"properties": {
"relativeDate": {
"description": "A relative date (based on the current date).\nValid only if the type is\nDATE_BEFORE,\nDATE_AFTER,\nDATE_ON_OR_BEFORE or\nDATE_ON_OR_AFTER.\n\nRelative dates are not supported in data validation.\nThey are supported only in conditional formatting and\nconditional filters.",
"enum": [
"RELATIVE_DATE_UNSPECIFIED",
"PAST_YEAR",
"PAST_MONTH",
"PAST_WEEK",
"YESTERDAY",
"TODAY",
"TOMORROW"
],
"enumDescriptions": [
"Default value, do not use.",
"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 is parsed as if the user typed into a cell.\nFormulas are supported (and must begin with an `=` or a '+').",
"type": "string"
}
},
"type": "object"
},
"ConditionalFormatRule": {
"description": "A rule describing a conditional format.",
"id": "ConditionalFormatRule",
"properties": {
"booleanRule": {
"$ref": "BooleanRule",
"description": "The formatting is either \"on\" or \"off\" according to the rule."
},
"gradientRule": {
"$ref": "GradientRule",
"description": "The formatting will vary based on the gradients in the rule."
},
"ranges": {
"description": "The ranges that are formatted if the condition is true.\nAll the ranges must be on the same grid.",
"items": {
"$ref": "GridRange"
},
"type": "array"
}
},
"type": "object"
},
"CopyPasteRequest": {
"description": "Copies data from the source to the destination.",
"id": "CopyPasteRequest",
"properties": {
"destination": {
"$ref": "GridRange",
"description": "The location to paste to. If the range covers a span that's\na multiple of the source's height or width, then the\ndata will be repeated to fill in the destination range.\nIf the range is smaller than the source range, the entire\nsource data will still be copied (beyond the end of the destination range)."
},
"pasteOrientation": {
"description": "How that data should be oriented when pasting.",
"enum": [
"NORMAL",
"TRANSPOSE"
],
"enumDescriptions": [
"Paste normally.",
"Paste transposed, where all rows become columns and vice versa."
],
"type": "string"
},
"pasteType": {
"description": "What kind of data to paste.",
"enum": [
"PASTE_NORMAL",
"PASTE_VALUES",
"PASTE_FORMAT",
"PASTE_NO_BORDERS",
"PASTE_FORMULA",
"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 conditional formatting rules only."
],
"type": "string"
},
"source": {
"$ref": "GridRange",
"description": "The source range to copy."
}
},
"type": "object"
},
"CopySheetToAnotherSpreadsheetRequest": {
"description": "The request to copy a sheet across spreadsheets.",
"id": "CopySheetToAnotherSpreadsheetRequest",
"properties": {
"destinationSpreadsheetId": {
"description": "The ID of the spreadsheet to copy the sheet to.",
"type": "string"
}
},
"type": "object"
},
"CreateDeveloperMetadataRequest": {
"description": "A request to create developer metadata.",
"id": "CreateDeveloperMetadataRequest",
"properties": {
"developerMetadata": {
"$ref": "DeveloperMetadata",
"description": "The developer metadata to create."
}
},
"type": "object"
},
"CreateDeveloperMetadataResponse": {
"description": "The response from creating developer metadata.",
"id": "CreateDeveloperMetadataResponse",
"properties": {
"developerMetadata": {
"$ref": "DeveloperMetadata",
"description": "The developer metadata that was created."
}
},
"type": "object"
},
"CutPasteRequest": {
"description": "Moves data from the source to the destination.",
"id": "CutPasteRequest",
"properties": {
"destination": {
"$ref": "GridCoordinate",
"description": "The top-left coordinate where the data should be pasted."
},
"pasteType": {
"description": "What kind of data to paste. All the source data will be cut, regardless\nof what is pasted.",
"enum": [
"PASTE_NORMAL",
"PASTE_VALUES",
"PASTE_FORMAT",
"PASTE_NO_BORDERS",
"PASTE_FORMULA",
"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 conditional formatting rules only."
],
"type": "string"
},
"source": {
"$ref": "GridRange",
"description": "The source data to cut."
}
},
"type": "object"
},
"DataFilter": {
"description": "Filter that describes what data should be selected or returned from a\nrequest.",
"id": "DataFilter",
"properties": {
"a1Range": {
"description": "Selects data that matches the specified A1 range.",
"type": "string"
},
"developerMetadataLookup": {
"$ref": "DeveloperMetadataLookup",
"description": "Selects data associated with the developer metadata matching the criteria\ndescribed by this DeveloperMetadataLookup."
},
"gridRange": {
"$ref": "GridRange",
"description": "Selects data that matches the range described by the GridRange."
}
},
"type": "object"
},
"DataFilterValueRange": {
"description": "A range of values whose location is specified by a DataFilter.",
"id": "DataFilterValueRange",
"properties": {
"dataFilter": {
"$ref": "DataFilter",
"description": "The data filter describing the location of the values in the spreadsheet."
},
"majorDimension": {
"description": "The major dimension of the values.",
"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."
],
"type": "string"
},
"values": {
"description": "The data to be written. If the provided values exceed any of the ranges\nmatched by the data filter then the request will fail. If the provided\nvalues are less than the matched ranges only the specified values will be\nwritten, existing values in the matched ranges will remain unaffected.",
"items": {
"items": {
"type": "any"
},
"type": "array"
},
"type": "array"
}
},
"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"
},
"DateTimeRule": {
"description": "Allows you to organize the date-time values in a source data column into\nbuckets based on selected parts of their date or time values. For example,\nconsider a pivot table showing sales transactions by date:\n\n +----------+--------------+\n | Date | SUM of Sales |\n +----------+--------------+\n | 1/1/2017 | $621.14 |\n | 2/3/2017 | $708.84 |\n | 5/8/2017 | $326.84 |\n ...\n +----------+--------------+\nApplying a date-time group rule with a DateTimeRuleType of YEAR_MONTH\nresults in the following pivot table.\n\n +--------------+--------------+\n | Grouped Date | SUM of Sales |\n +--------------+--------------+\n | 2017-Jan | $53,731.78 |\n | 2017-Feb | $83,475.32 |\n | 2017-Mar | $94,385.05 |\n ...\n +--------------+--------------+",
"id": "DateTimeRule",
"properties": {
"type": {
"description": "The type of date-time grouping to apply.",
"enum": [
"DATE_TIME_RULE_TYPE_UNSPECIFIED",
"SECOND",
"MINUTE",
"HOUR",
"HOUR_MINUTE",
"HOUR_MINUTE_AMPM",
"DAY_OF_WEEK",
"DAY_OF_YEAR",
"DAY_OF_MONTH",
"DAY_MONTH",
"MONTH",
"QUARTER",
"YEAR",
"YEAR_MONTH",
"YEAR_QUARTER",
"YEAR_MONTH_DAY"
],
"enumDescriptions": [
"The default type, do not use.",
"Group dates by second, from 0 to 59.",
"Group dates by minute, from 0 to 59.",
"Group dates by hour using a 24-hour system, from 0 to 23.",
"Group dates by hour and minute using a 24-hour system, for example 19:45.",
"Group dates by hour and minute using a 12-hour system, for example 7:45\nPM. The AM/PM designation is translated based on the spreadsheet\nlocale.",
"Group dates by day of week, for example Sunday. The days of the week will\nbe translated based on the spreadsheet locale.",
"Group dates by day of year, from 1 to 366. Note that dates after Feb. 29\nfall in different buckets in leap years than in non-leap years.",
"Group dates by day of month, from 1 to 31.",
"Group dates by day and month, for example 22-Nov. The month is\ntranslated based on the spreadsheet locale.",
"Group dates by month, for example Nov. The month is translated based\non the spreadsheet locale.",
"Group dates by quarter, for example Q1 (which represents Jan-Mar).",
"Group dates by year, for example 2008.",
"Group dates by year and month, for example 2008-Nov. The month is\ntranslated based on the spreadsheet locale.",
"Group dates by year and quarter, for example 2008 Q4.",
"Group dates by year, month, and day, for example 2008-11-22."
],
"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"
},
"DeleteConditionalFormatRuleRequest": {
"description": "Deletes a conditional format rule at the given index.\nAll subsequent rules' indexes are decremented.",
"id": "DeleteConditionalFormatRuleRequest",
"properties": {
"index": {
"description": "The zero-based index of the rule to be deleted.",
"format": "int32",
"type": "integer"
},
"sheetId": {
"description": "The sheet the rule is being deleted from.",
"format": "int32",
"type": "integer"
}
},
"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"
},
"DeleteDeveloperMetadataRequest": {
"description": "A request to delete developer metadata.",
"id": "DeleteDeveloperMetadataRequest",
"properties": {
"dataFilter": {
"$ref": "DataFilter",
"description": "The data filter describing the criteria used to select which developer\nmetadata entry to delete."
}
},
"type": "object"
},
"DeleteDeveloperMetadataResponse": {
"description": "The response from deleting developer metadata.",
"id": "DeleteDeveloperMetadataResponse",
"properties": {
"deletedDeveloperMetadata": {
"description": "The metadata that was deleted.",
"items": {
"$ref": "DeveloperMetadata"
},
"type": "array"
}
},
"type": "object"
},
"DeleteDimensionGroupRequest": {
"description": "Deletes a group over the specified range by decrementing the depth of the\ndimensions in the range.\n\nFor example, assume the sheet has a depth-1 group over B:E and a depth-2\ngroup over C:D. Deleting a group over D:E leaves the sheet with a\ndepth-1 group over B:D and a depth-2 group over C:C.",
"id": "DeleteDimensionGroupRequest",
"properties": {
"range": {
"$ref": "DimensionRange",
"description": "The range of the group to be deleted."
}
},
"type": "object"
},
"DeleteDimensionGroupResponse": {
"description": "The result of deleting a group.",
"id": "DeleteDimensionGroupResponse",
"properties": {
"dimensionGroups": {
"description": "All groups of a dimension after deleting a group from that dimension.",
"items": {
"$ref": "DimensionGroup"
},
"type": "array"
}
},
"type": "object"
},
"DeleteDimensionRequest": {
"description": "Deletes the dimensions from the sheet.",
"id": "DeleteDimensionRequest",
"properties": {
"range": {
"$ref": "DimensionRange",
"description": "The dimensions to delete from the sheet."
}
},
"type": "object"
},
"DeleteEmbeddedObjectRequest": {
"description": "Deletes the embedded object with the given ID.",
"id": "DeleteEmbeddedObjectRequest",
"properties": {
"objectId": {
"description": "The ID of the embedded object to delete.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"DeleteFilterViewRequest": {
"description": "Deletes a particular filter view.",
"id": "DeleteFilterViewRequest",
"properties": {
"filterId": {
"description": "The ID of the filter to delete.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"DeleteNamedRangeRequest": {
"description": "Removes the named range with the given ID from the spreadsheet.",
"id": "DeleteNamedRangeRequest",
"properties": {
"namedRangeId": {
"description": "The ID of the named range to delete.",
"type": "string"
}
},
"type": "object"
},
"DeleteProtectedRangeRequest": {
"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"
},
"DeleteRangeRequest": {
"description": "Deletes a range of cells, shifting other cells into the deleted area.",
"id": "DeleteRangeRequest",
"properties": {
"range": {
"$ref": "GridRange",
"description": "The range of cells to delete."
},
"shiftDimension": {
"description": "The dimension from which deleted cells will be replaced with.\nIf ROWS, existing cells will be shifted upward to\nreplace the deleted cells. If COLUMNS, existing cells\nwill be shifted left to replace the deleted cells.",
"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."
],
"type": "string"
}
},
"type": "object"
},
"DeleteSheetRequest": {
"description": "Deletes the requested sheet.",
"id": "DeleteSheetRequest",
"properties": {
"sheetId": {
"description": "The ID of the sheet to delete.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"DeveloperMetadata": {
"description": "Developer metadata associated with a location or object in a spreadsheet.\nDeveloper metadata may be used to associate arbitrary data with various\nparts of a spreadsheet and will remain associated at those locations as they\nmove around and the spreadsheet is edited. For example, if developer\nmetadata is associated with row 5 and another row is then subsequently\ninserted above row 5, that original metadata will still be associated with\nthe row it was first associated with (what is now row 6). If the associated\nobject is deleted its metadata is deleted too.",
"id": "DeveloperMetadata",
"properties": {
"location": {
"$ref": "DeveloperMetadataLocation",
"description": "The location where the metadata is associated."
},
"metadataId": {
"description": "The spreadsheet-scoped unique ID that identifies the metadata. IDs may be\nspecified when metadata is created, otherwise one will be randomly\ngenerated and assigned. Must be positive.",
"format": "int32",
"type": "integer"
},
"metadataKey": {
"description": "The metadata key. There may be multiple metadata in a spreadsheet with the\nsame key. Developer metadata must always have a key specified.",
"type": "string"
},
"metadataValue": {
"description": "Data associated with the metadata's key.",
"type": "string"
},
"visibility": {
"description": "The metadata visibility. Developer metadata must always have a visibility\nspecified.",
"enum": [
"DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED",
"DOCUMENT",
"PROJECT"
],
"enumDescriptions": [
"Default value.",
"Document-visible metadata is accessible from any developer project with\naccess to the document.",
"Project-visible metadata is only visible to and accessible by the developer\nproject that created the metadata."
],
"type": "string"
}
},
"type": "object"
},
"DeveloperMetadataLocation": {
"description": "A location where metadata may be associated in a spreadsheet.",
"id": "DeveloperMetadataLocation",
"properties": {
"dimensionRange": {
"$ref": "DimensionRange",
"description": "Represents the row or column when metadata is associated with\na dimension. The specified DimensionRange must represent a single row\nor column; it cannot be unbounded or span multiple rows or columns."
},
"locationType": {
"description": "The type of location this object represents. This field is read-only.",
"enum": [
"DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED",
"ROW",
"COLUMN",
"SHEET",
"SPREADSHEET"
],
"enumDescriptions": [
"Default value.",
"Developer metadata associated on an entire row dimension.",
"Developer metadata associated on an entire column dimension.",
"Developer metadata associated on an entire sheet.",
"Developer metadata associated on the entire spreadsheet."
],
"type": "string"
},
"sheetId": {
"description": "The ID of the sheet when metadata is associated with an entire sheet.",
"format": "int32",
"type": "integer"
},
"spreadsheet": {
"description": "True when metadata is associated with an entire spreadsheet.",
"type": "boolean"
}
},
"type": "object"
},
"DeveloperMetadataLookup": {
"description": "Selects DeveloperMetadata that matches all of the specified fields. For\nexample, if only a metadata ID is specified this considers the\nDeveloperMetadata with that particular unique ID. If a metadata key is\nspecified, this considers all developer metadata with that key. If a\nkey, visibility, and location type are all specified, this considers all\ndeveloper metadata with that key and visibility that are associated with a\nlocation of that type. In general, this\nselects all DeveloperMetadata that matches the intersection of all the\nspecified fields; any field or combination of fields may be specified.",
"id": "DeveloperMetadataLookup",
"properties": {
"locationMatchingStrategy": {
"description": "Determines how this lookup matches the location. If this field is\nspecified as EXACT, only developer metadata associated on the exact\nlocation specified is matched. If this field is specified to INTERSECTING,\ndeveloper metadata associated on intersecting locations is also\nmatched. If left unspecified, this field assumes a default value of\nINTERSECTING.\nIf this field is specified, a metadataLocation\nmust also be specified.",
"enum": [
"DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED",
"EXACT_LOCATION",
"INTERSECTING_LOCATION"
],
"enumDescriptions": [
"Default value. This value must not be used.",
"Indicates that a specified location should be matched exactly. For\nexample, if row three were specified as a location this matching strategy\nwould only match developer metadata also associated on row three. Metadata\nassociated on other locations would not be considered.",
"Indicates that a specified location should match that exact location as\nwell as any intersecting locations. For example, if row three were\nspecified as a location this matching strategy would match developer\nmetadata associated on row three as well as metadata associated on\nlocations that intersect row three. If, for instance, there was developer\nmetadata associated on column B, this matching strategy would also match\nthat location because column B intersects row three."
],
"type": "string"
},
"locationType": {
"description": "Limits the selected developer metadata to those entries which are\nassociated with locations of the specified type. For example, when this\nfield is specified as ROW this lookup\nonly considers developer metadata associated on rows. If the field is left\nunspecified, all location types are considered. This field cannot be\nspecified as SPREADSHEET when\nthe locationMatchingStrategy\nis specified as INTERSECTING or when the\nmetadataLocation is specified as a\nnon-spreadsheet location: spreadsheet metadata cannot intersect any other\ndeveloper metadata location. This field also must be left unspecified when\nthe locationMatchingStrategy\nis specified as EXACT.",
"enum": [
"DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED",
"ROW",
"COLUMN",
"SHEET",
"SPREADSHEET"
],
"enumDescriptions": [
"Default value.",
"Developer metadata associated on an entire row dimension.",
"Developer metadata associated on an entire column dimension.",
"Developer metadata associated on an entire sheet.",
"Developer metadata associated on the entire spreadsheet."
],
"type": "string"
},
"metadataId": {
"description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.metadata_id.",
"format": "int32",
"type": "integer"
},
"metadataKey": {
"description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.metadata_key.",
"type": "string"
},
"metadataLocation": {
"$ref": "DeveloperMetadataLocation",
"description": "Limits the selected developer metadata to those entries associated with\nthe specified location. This field either matches exact locations or all\nintersecting locations according the specified\nlocationMatchingStrategy."
},
"metadataValue": {
"description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.metadata_value.",
"type": "string"
},
"visibility": {
"description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.visibility. If left unspecified, all developer\nmetadata visibile to the requesting project is considered.",
"enum": [
"DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED",
"DOCUMENT",
"PROJECT"
],
"enumDescriptions": [
"Default value.",
"Document-visible metadata is accessible from any developer project with\naccess to the document.",
"Project-visible metadata is only visible to and accessible by the developer\nproject that created the metadata."
],
"type": "string"
}
},
"type": "object"
},
"DimensionGroup": {
"description": "A group over an interval of rows or columns on a sheet, which can contain or\nbe contained within other groups. A group can be collapsed or expanded as a\nunit on the sheet.",
"id": "DimensionGroup",
"properties": {
"collapsed": {
"description": "This field is true if this group is collapsed. A collapsed group remains\ncollapsed if an overlapping group at a shallower depth is expanded.\n\nA true value does not imply that all dimensions within the group are\nhidden, since a dimension's visibility can change independently from this\ngroup property. However, when this property is updated, all dimensions\nwithin it are set to hidden if this field is true, or set to visible if\nthis field is false.",
"type": "boolean"
},
"depth": {
"description": "The depth of the group, representing how many groups have a range that\nwholly contains the range of this group.",
"format": "int32",
"type": "integer"
},
"range": {
"$ref": "DimensionRange",
"description": "The range over which this group exists."
}
},
"type": "object"
},
"DimensionProperties": {
"description": "Properties about a dimension.",
"id": "DimensionProperties",
"properties": {
"developerMetadata": {
"description": "The developer metadata associated with a single row or column.",
"items": {
"$ref": "DeveloperMetadata"
},
"type": "array"
},
"hiddenByFilter": {
"description": "True if this dimension is being filtered.\nThis field is read-only.",
"type": "boolean"
},
"hiddenByUser": {
"description": "True if this dimension is explicitly hidden.",
"type": "boolean"
},
"pixelSize": {
"description": "The height (if a row) or width (if a column) of the dimension in pixels.",
"format": "int32",
"type": "integer"
}
},
"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": {
"dimension": {
"description": "The dimension of the span.",
"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."
],
"type": "string"
},
"endIndex": {
"description": "The end (exclusive) of the span, or not set if unbounded.",
"format": "int32",
"type": "integer"
},
"sheetId": {
"description": "The sheet this span is on.",
"format": "int32",
"type": "integer"
},
"startIndex": {
"description": "The start (inclusive) of the span, or not set if unbounded.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"DuplicateFilterViewRequest": {
"description": "Duplicates a particular filter view.",
"id": "DuplicateFilterViewRequest",
"properties": {
"filterId": {
"description": "The ID of the filter being duplicated.",
"format": "int32",
"type": "integer"
}
},
"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"
},
"DuplicateSheetRequest": {
"description": "Duplicates the contents of a sheet.",
"id": "DuplicateSheetRequest",
"properties": {
"insertSheetIndex": {
"description": "The zero-based index where the new sheet should be inserted.\nThe index of all sheets after this are incremented.",
"format": "int32",
"type": "integer"
},
"newSheetId": {
"description": "If set, the ID of the new sheet. If not set, an ID is chosen.\nIf set, the ID must not conflict with any existing sheet ID.\nIf set, it must be non-negative.",
"format": "int32",
"type": "integer"
},
"newSheetName": {
"description": "The name of the new sheet. If empty, a new name is chosen for you.",
"type": "string"
},
"sourceSheetId": {
"description": "The sheet to duplicate.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"DuplicateSheetResponse": {
"description": "The result of duplicating a sheet.",
"id": "DuplicateSheetResponse",
"properties": {
"properties": {
"$ref": "SheetProperties",
"description": "The properties of the duplicate sheet."
}
},
"type": "object"
},
"Editors": {
"description": "The editors of a protected range.",
"id": "Editors",
"properties": {
"domainUsersCanEdit": {
"description": "True if anyone in the document's domain has edit access to the protected\nrange. Domain protection is only supported on documents within a domain.",
"type": "boolean"
},
"groups": {
"description": "The email addresses of groups with edit access to the protected range.",
"items": {
"type": "string"
},
"type": "array"
},
"users": {
"description": "The email addresses of users with edit access to the protected range.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"EmbeddedChart": {
"description": "A chart embedded in a sheet.",
"id": "EmbeddedChart",
"properties": {
"chartId": {
"description": "The ID of the chart.",
"format": "int32",
"type": "integer"
},
"position": {
"$ref": "EmbeddedObjectPosition",
"description": "The position of the chart."
},
"spec": {
"$ref": "ChartSpec",
"description": "The specification of the chart."
}
},
"type": "object"
},
"EmbeddedObjectPosition": {
"description": "The position of an embedded object such as a chart.",
"id": "EmbeddedObjectPosition",
"properties": {
"newSheet": {
"description": "If true, the embedded object is put on a new sheet whose ID\nis chosen for you. Used only when writing.",
"type": "boolean"
},
"overlayPosition": {
"$ref": "OverlayPosition",
"description": "The position at which the object is overlaid on top of a grid."
},
"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"
}
},
"type": "object"
},
"ErrorValue": {
"description": "An error in a cell.",
"id": "ErrorValue",
"properties": {
"message": {
"description": "A message with more information about the error\n(in the spreadsheet's locale).",
"type": "string"
},
"type": {
"description": "The type of error.",
"enum": [
"ERROR_TYPE_UNSPECIFIED",
"ERROR",
"NULL_VALUE",
"DIVIDE_BY_ZERO",
"VALUE",
"REF",
"NAME",
"NUM",
"N_A",
"LOADING"
],
"enumDescriptions": [
"The default error type, do not use this.",
"Corresponds to the `#ERROR!` error.",
"Corresponds to the `#NULL!` error.",
"Corresponds to the `#DIV/0` error.",
"Corresponds to the `#VALUE!` error.",
"Corresponds to the `#REF!` error.",
"Corresponds to the `#NAME?` error.",
"Corresponds to the `#NUM`! error.",
"Corresponds to the `#N/A` error.",
"Corresponds to the `Loading...` state."
],
"type": "string"
}
},
"type": "object"
},
"ExtendedValue": {
"description": "The kinds of value that a cell in a spreadsheet can have.",
"id": "ExtendedValue",
"properties": {
"boolValue": {
"description": "Represents a boolean value.",
"type": "boolean"
},
"errorValue": {
"$ref": "ErrorValue",
"description": "Represents an error.\nThis field is read-only."
},
"formulaValue": {
"description": "Represents a formula.",
"type": "string"
},
"numberValue": {
"description": "Represents a double value.\nNote: Dates, Times and DateTimes are represented as doubles in\n\"serial number\" format.",
"format": "double",
"type": "number"
},
"stringValue": {
"description": "Represents a string value.\nLeading single quotes are not included. For example, if the user typed\n`'123` into the UI, this would be represented as a `stringValue` of\n`\"123\"`.",
"type": "string"
}
},
"type": "object"
},
"FilterCriteria": {
"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"
},
"type": "array"
}
},
"type": "object"
},
"FilterView": {
"description": "A filter view.",
"id": "FilterView",
"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"
},
"filterViewId": {
"description": "The ID of the filter view.",
"format": "int32",
"type": "integer"
},
"namedRangeId": {
"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"
},
"range": {
"$ref": "GridRange",
"description": "The range this filter view covers.\n\nWhen writing, only one of range or named_range_id\nmay be set."
},
"sortSpecs": {
"description": "The sort order per column. Later specifications are used when values\nare equal in the earlier specifications.",
"items": {
"$ref": "SortSpec"
},
"type": "array"
},
"title": {
"description": "The name of the filter view.",