blob: 87093c04ca8a678eedd99d7f2ea9db1d3f6b5852 [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/",
"fullyEncodeReservedExpansion": true,
"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",
"mtlsRootUrl": "https://sheets.mtls.googleapis.com/",
"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. Each request is validated before being applied. If any request is not valid then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. The replies will mirror the requests. For example, if you applied 4 updates and the 3rd one had a reply, then the response will have 2 empty replies, the actual reply, and another empty reply, in that order. Due to the collaborative nature of spreadsheets, it is not guaranteed that the spreadsheet will reflect exactly your changes after this completes, however it is guaranteed that the updates in the request will be applied together atomically. Your changes may be altered with respect to collaborator changes. If there are no collaborators, the spreadsheet should reflect your changes.",
"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. The caller must specify the spreadsheet ID. By default, data within grids will not be returned. You can include grid data one of two ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData URL parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, it is recommended to retrieve only the specific fields of the spreadsheet that you want. To retrieve only subsets of the spreadsheet, use the ranges URL parameter. Multiple ranges can be specified. Limiting the range will return only the portions of the spreadsheet that intersect the requested ranges. Ranges are specified using A1 notation.",
"flatPath": "v4/spreadsheets/{spreadsheetId}",
"httpMethod": "GET",
"id": "sheets.spreadsheets.get",
"parameterOrder": [
"spreadsheetId"
],
"parameters": {
"includeGridData": {
"description": "True if grid data should be returned. This 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. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters will return the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids will not be returned. You can include grid data one of two ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, it is recommended to retrieve only the specific fields of the spreadsheet that you want.",
"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. The caller must specify the spreadsheet ID and the developer metadata's unique 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. If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer 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. Returns 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 existing data and find a \"table\" within that range. Values will be appended to the next row of the table, starting with the first column of the table. See the [guide](/sheets/api/guides/values#appending_values) and [sample code](/sheets/api/samples/writing#append_values) for specific details of how tables are detected and data is appended. The caller must specify the spreadsheet ID, range, and a valueInputOption. The `valueInputOption` only controls how the input data will be added to the sheet (column-wise or row-wise), it does not influence what cell the data starts being written to.",
"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 of the cells that were appended. By default, responses do not include the updated values.",
"location": "query",
"type": "boolean"
},
"insertDataOption": {
"description": "How the input data should be inserted.",
"enum": [
"OVERWRITE",
"INSERT_ROWS"
],
"enumDescriptions": [
"The new data overwrites existing data in the areas it is written. (Note: adding data to the end of the sheet will still insert new rows or columns so the data can be written.)",
"Rows are inserted for the new data."
],
"location": "query",
"type": "string"
},
"range": {
"description": "The A1 notation of a range to search for a logical table of data. Values are 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 rendered. This is ignored if response_value_render_option is FORMATTED_VALUE. The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output as doubles in \"serial number\" format, as popularized by Lotus 1-2-3. The whole number portion of the value (left of the decimal) counts the days since December 30th 1899. The fractional portion (right of the decimal) counts the time as a fraction of the day. For example, January 1st 1900 at noon would be 2.5, 2 because it's 2 days after December 30st 1899, and .5 because noon is half a day. February 1st 1900 at 3pm would be 33.625. This correctly treats the year 1900 as not a leap year.",
"Instructs date, time, datetime, and duration fields to be output as strings in their given number format (which is dependent on the spreadsheet locale)."
],
"location": "query",
"type": "string"
},
"responseValueRenderOption": {
"description": "Determines how values in the response should be rendered. The 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 cell's formatting. Formatting is based on the spreadsheet's locale, not the requesting user's locale. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then A2 would return `\"=A1\"`."
],
"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"
],
"enumDescriptions": [
"Default input value. This value must not be used.",
"The values the user has entered will not be parsed and will be stored as-is.",
"The values will be parsed as if the user typed them into the UI. Numbers will stay as numbers, but strings may be converted to numbers, dates, etc. following the same rules that are applied when entering text into a cell via the Google Sheets UI."
],
"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. The caller must specify the spreadsheet ID and one or more ranges. Only values are cleared -- all other properties of the cell (such as formatting, 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. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of 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. The 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. This is ignored if value_render_option is FORMATTED_VALUE. The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output as doubles in \"serial number\" format, as popularized by Lotus 1-2-3. The whole number portion of the value (left of the decimal) counts the days since December 30th 1899. The fractional portion (right of the decimal) counts the time as a fraction of the day. For example, January 1st 1900 at noon would be 2.5, 2 because it's 2 days after December 30st 1899, and .5 because noon is half a day. February 1st 1900 at 3pm would be 33.625. This correctly treats the year 1900 as not a leap year.",
"Instructs date, time, datetime, and duration fields to be output as strings in their given number format (which is dependent on the spreadsheet locale)."
],
"location": "query",
"type": "string"
},
"majorDimension": {
"description": "The major dimension that results should use. For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` returns `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` returns `[[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."
],
"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. The 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 cell's formatting. Formatting is based on the spreadsheet's locale, not the requesting user's locale. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then A2 would return `\"=A1\"`."
],
"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. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the 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. The caller must specify the spreadsheet ID, a valueInputOption, and one or more ValueRanges.",
"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. The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.",
"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. The caller must specify the spreadsheet ID and range. Only values are cleared -- all other properties of the cell (such as formatting, 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. The 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. This is ignored if value_render_option is FORMATTED_VALUE. The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output as doubles in \"serial number\" format, as popularized by Lotus 1-2-3. The whole number portion of the value (left of the decimal) counts the days since December 30th 1899. The fractional portion (right of the decimal) counts the time as a fraction of the day. For example, January 1st 1900 at noon would be 2.5, 2 because it's 2 days after December 30st 1899, and .5 because noon is half a day. February 1st 1900 at 3pm would be 33.625. This correctly treats the year 1900 as not a leap year.",
"Instructs date, time, datetime, and duration fields to be output as strings in their given number format (which is dependent on the spreadsheet locale)."
],
"location": "query",
"type": "string"
},
"majorDimension": {
"description": "The major dimension that results should use. For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` returns `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` returns `[[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."
],
"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. The 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 cell's formatting. Formatting is based on the spreadsheet's locale, not the requesting user's locale. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then A2 would return `\"=A1\"`."
],
"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. The caller must specify the spreadsheet ID, range, and a 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 of the cells that were updated. By default, responses do not include the updated values. If the range to write was larger than the range actually written, the response includes all values in the requested range (excluding trailing 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 rendered. This is ignored if response_value_render_option is FORMATTED_VALUE. The default dateTime render option is DateTimeRenderOption.SERIAL_NUMBER.",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output as doubles in \"serial number\" format, as popularized by Lotus 1-2-3. The whole number portion of the value (left of the decimal) counts the days since December 30th 1899. The fractional portion (right of the decimal) counts the time as a fraction of the day. For example, January 1st 1900 at noon would be 2.5, 2 because it's 2 days after December 30st 1899, and .5 because noon is half a day. February 1st 1900 at 3pm would be 33.625. This correctly treats the year 1900 as not a leap year.",
"Instructs date, time, datetime, and duration fields to be output as strings in their given number format (which is dependent on the spreadsheet locale)."
],
"location": "query",
"type": "string"
},
"responseValueRenderOption": {
"description": "Determines how values in the response should be rendered. The 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 cell's formatting. Formatting is based on the spreadsheet's locale, not the requesting user's locale. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then A2 would return `\"=A1\"`."
],
"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"
],
"enumDescriptions": [
"Default input value. This value must not be used.",
"The values the user has entered will not be parsed and will be stored as-is.",
"The values will be parsed as if the user typed them into the UI. Numbers will stay as numbers, but strings may be converted to numbers, dates, etc. following the same rules that are applied when entering text into a cell via the Google Sheets UI."
],
"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": "20200922",
"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 field is optional; if one is not set, an id will be randomly generated. (It is 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 where it should be placed. The chartId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of an embedded object 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. All 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"
},
"AddDataSourceRequest": {
"description": "Adds a data source. After the data source is added successfully, an associated DATA_SOURCE sheet is created and an execution is triggered to refresh the sheet to read data from the data source. The request requires an additional `bigquery.readonly` OAuth scope.",
"id": "AddDataSourceRequest",
"properties": {
"dataSource": {
"$ref": "DataSource",
"description": "The data source to add."
}
},
"type": "object"
},
"AddDataSourceResponse": {
"description": "The result of adding a data source.",
"id": "AddDataSourceResponse",
"properties": {
"dataExecutionStatus": {
"$ref": "DataExecutionStatus",
"description": "The data execution status."
},
"dataSource": {
"$ref": "DataSource",
"description": "The data source that was created."
}
},
"type": "object"
},
"AddDimensionGroupRequest": {
"description": "Creates a group over the specified range. If the requested range is a superset of the range of an existing group G, then the depth of G is incremented and this new group G' has the depth of that group. For example, a group [C:D, depth 1] + [B:E] results in groups [B:E, depth 1] and [C:D, depth 2]. If the requested range is a subset of the range of an existing group G, then the depth of the new group G' becomes one greater than the depth of G. For example, a group [B:E, depth 1] + [C:D] results in groups [B:E, depth 1] and [C:D, depth 2]. If the requested range starts before and ends within, or starts within and ends after, the range of an existing group G, then the range of the existing group G becomes the union of the ranges, and the new group G' has depth one greater than the depth of G and range as the intersection of the ranges. For example, a group [B:D, depth 1] + [C:E] results in groups [B:E, depth 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 field is optional; if one is not set, an id will be randomly generated. (It is 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 field is optional; if one is not set, an id will be randomly generated. (It is 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 protectedRangeId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify 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. When a sheet is added at a given index, all subsequent sheets' indexes are incremented. To add an object sheet, use AddChartRequest instead and specify EmbeddedObjectPosition.sheetId or EmbeddedObjectPosition.newSheet.",
"id": "AddSheetRequest",
"properties": {
"properties": {
"$ref": "SheetProperties",
"description": "The properties the new sheet should have. All properties are optional. The sheetId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of 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"
},
"AddSlicerRequest": {
"description": "Adds a slicer to a sheet in the spreadsheet.",
"id": "AddSlicerRequest",
"properties": {
"slicer": {
"$ref": "Slicer",
"description": "The slicer that should be added to the spreadsheet, including the position where it should be placed. The slicerId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of a slicer that already exists.)"
}
},
"type": "object"
},
"AddSlicerResponse": {
"description": "The result of adding a slicer to a spreadsheet.",
"id": "AddSlicerResponse",
"properties": {
"slicer": {
"$ref": "Slicer",
"description": "The newly added slicer."
}
},
"type": "object"
},
"AppendCellsRequest": {
"description": "Adds new cells after the last row with data in a sheet, inserting new rows into the sheet if necessary.",
"id": "AppendCellsRequest",
"properties": {
"fields": {
"description": "The fields of CellData that should be updated. At least one field must be specified. The root is the CellData; 'row.values.' should not be specified. A single `\"*\"` can be used as short-hand for listing every field.",
"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 (before the values were appended). Empty 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 the location that has data and automatically fill that data in to the rest of the range."
},
"sourceAndDestination": {
"$ref": "SourceAndDestination",
"description": "The source and destination areas to autofill. This explicitly lists the source of the autofill and where to extend that data."
},
"useAlternateSeries": {
"description": "True if we should generate data with the \"alternate\" series. This 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 of the cells in that dimension.",
"id": "AutoResizeDimensionsRequest",
"properties": {
"dataSourceSheetDimensions": {
"$ref": "DataSourceSheetDimensionRange",
"description": "The dimensions on a data source sheet to automatically resize."
},
"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- by-column basis throughout all the columns in the range. At least one of row_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 basis throughout all the rows in the range. At least one of row_properties or column_properties must be specified."
}
},
"type": "object"
},
"BandingProperties": {
"description": "Properties referring a single dimension (either row or column). If both BandedRange.row_properties and BandedRange.column_properties are set, the fill colors are applied to cells according to the following rules: * header_color and footer_color take priority over band colors. * first_band_color takes priority over second_band_color. * row_properties takes priority over column_properties. For example, the first row color takes priority over the first column color, but the first column color takes priority over the second row color. Similarly, the row header takes priority over the column header in the top left cell, but the column header takes priority over the first row color if the row header is not set.",
"id": "BandingProperties",
"properties": {
"firstBandColor": {
"$ref": "Color",
"description": "The first color that is alternating. (Required)"
},
"firstBandColorStyle": {
"$ref": "ColorStyle",
"description": "The first color that is alternating. (Required) If first_band_color is also set, this field takes precedence."
},
"footerColor": {
"$ref": "Color",
"description": "The color of the last row or column. If this field is not set, the last row or column is filled with either first_band_color or second_band_color, depending on the color of the previous row or column."
},
"footerColorStyle": {
"$ref": "ColorStyle",
"description": "The color of the last row or column. If this field is not set, the last row or column is filled with either first_band_color or second_band_color, depending on the color of the previous row or column. If footer_color is also set, this field takes precedence."
},
"headerColor": {
"$ref": "Color",
"description": "The color of the first row or column. If this field is set, the first row or column is filled with this color and the colors alternate between first_band_color and second_band_color starting from the second row or column. Otherwise, the first row or column is filled with first_band_color and the colors proceed to alternate as they normally would."
},
"headerColorStyle": {
"$ref": "ColorStyle",
"description": "The color of the first row or column. If this field is set, the first row or column is filled with this color and the colors alternate between first_band_color and second_band_color starting from the second row or column. Otherwise, the first row or column is filled with first_band_color and the colors proceed to alternate as they normally would. If header_color is also set, this field takes precedence."
},
"secondBandColor": {
"$ref": "Color",
"description": "The second color that is alternating. (Required)"
},
"secondBandColorStyle": {
"$ref": "ColorStyle",
"description": "The second color that is alternating. (Required) If second_band_color is also set, this field takes precedence."
}
},
"type": "object"
},
"BaselineValueFormat": {
"description": "Formatting options for baseline value.",
"id": "BaselineValueFormat",
"properties": {
"comparisonType": {
"description": "The comparison type of key value with baseline value.",
"enum": [
"COMPARISON_TYPE_UNDEFINED",
"ABSOLUTE_DIFFERENCE",
"PERCENTAGE_DIFFERENCE"
],
"enumDescriptions": [
"Default value, do not use.",
"Use absolute difference between key and baseline value.",
"Use percentage difference between key and baseline value."
],
"type": "string"
},
"description": {
"description": "Description which is appended after the baseline value. This field is optional.",
"type": "string"
},
"negativeColor": {
"$ref": "Color",
"description": "Color to be used, in case baseline value represents a negative change for key value. This field is optional."
},
"negativeColorStyle": {
"$ref": "ColorStyle",
"description": "Color to be used, in case baseline value represents a negative change for key value. This field is optional. If negative_color is also set, this field takes precedence."
},
"position": {
"$ref": "TextPosition",
"description": "Specifies the horizontal text positioning of baseline value. This field is optional. If not specified, default positioning is used."
},
"positiveColor": {
"$ref": "Color",
"description": "Color to be used, in case baseline value represents a positive change for key value. This field is optional."
},
"positiveColorStyle": {
"$ref": "ColorStyle",
"description": "Color to be used, in case baseline value represents a positive change for key value. This field is optional. If positive_color is also set, this field takes precedence."
},
"textFormat": {
"$ref": "TextFormat",
"description": "Text formatting options for baseline value."
}
},
"type": "object"
},
"BasicChartAxis": {
"description": "An axis of the chart. A chart may not have more than one axis per axis position.",
"id": "BasicChartAxis",
"properties": {
"format": {
"$ref": "TextFormat",
"description": "The format of the title. Only 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. For most charts, this is the standard major axis. For bar charts, this is a minor axis.",
"The axis rendered at the left of a chart. For most charts, this is a minor axis. For bar charts, this is the standard major axis.",
"The axis rendered at the right of a chart. For most charts, this is a minor axis. For bar charts, this is an unusual major axis."
],
"type": "string"
},
"title": {
"description": "The title of this axis. If set, this overrides any title inferred from headers of the data.",
"type": "string"
},
"titleTextPosition": {
"$ref": "TextPosition",
"description": "The axis title text position."
},
"viewWindowOptions": {
"$ref": "ChartAxisViewWindowOptions",
"description": "The view window options for this axis."
}
},
"type": "object"
},
"BasicChartDomain": {
"description": "The domain of a chart. For 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, this 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. For example, if charting stock prices over time, multiple series may exist, one for the \"Open Price\", \"High Price\", \"Low Price\" and \"Close Price\".",
"id": "BasicChartSeries",
"properties": {
"color": {
"$ref": "Color",
"description": "The color for elements (such as bars, lines, and points) associated with this series. If empty, a default color is used."
},
"colorStyle": {
"$ref": "ColorStyle",
"description": "The color for elements (such as bars, lines, and points) associated with this series. If empty, a default color is used. If color is also set, this field takes precedence."
},
"lineStyle": {
"$ref": "LineStyle",
"description": "The line style of this series. Valid only if the chartType is AREA, LINE, or SCATTER. COMBO charts are also supported if the series chart type is AREA 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. For example, if charting stocks over time, the \"Volume\" series may want to be pinned to the right with the prices pinned to the left, because the scale of trading volume is different than the scale of prices. It is an error to specify an axis that isn't a valid minor axis for 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. For most charts, this is the standard major axis. For bar charts, this is a minor axis.",
"The axis rendered at the left of a chart. For most charts, this is a minor axis. For bar charts, this is the standard major axis.",
"The axis rendered at the right of a chart. For most charts, this is a minor axis. For bar charts, this is an unusual major axis."
],
"type": "string"
},
"type": {
"description": "The type of this series. Valid only if the chartType is COMBO. Different types will change the way the series is visualized. Only LINE, AREA, and COLUMN are supported.",
"enum": [
"BASIC_CHART_TYPE_UNSPECIFIED",
"BAR",
"LINE",
"AREA",
"COLUMN",
"SCATTER",
"COMBO",
"STEPPED_AREA"
],
"enumDescriptions": [
"Default value, do not use.",
"A bar chart.",
"A line chart.",
"An area chart.",
"A column chart.",
"A scatter chart.",
"A combo chart.",
"A stepped area chart."
],
"type": "string"
}
},
"type": "object"
},
"BasicChartSpec": {
"description": "The specification for a basic chart. See BasicChartType for the list of 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 bar chart.",
"A line chart.",
"An area chart.",
"A column chart.",
"A scatter chart.",
"A combo chart.",
"A stepped area chart."
],
"type": "string"
},
"compareMode": {
"description": "The behavior of tooltips and data highlighting when hovering on data and chart 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 highlighted and shown in the tooltip."
],
"type": "string"
},
"domains": {
"description": "The domain of data this is charting. Only a single domain is supported.",
"items": {
"$ref": "BasicChartDomain"
},
"type": "array"
},
"headerCount": {
"description": "The number of rows or columns in the data that are \"headers\". If not set, Google Sheets will guess how many rows are headers based on the data. (Note that BasicChartAxis.title may override the axis title 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, segments of lines in a line chart will be missing). To eliminate these gaps set this to true. Applies 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. Applies 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. Applies 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 from the top of the value below it.",
"Vertical stacks are stretched to reach the top of the chart, with values laid out as percentages of each other."
],
"type": "string"
},
"threeDimensional": {
"description": "True to make the chart 3D. Applies 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. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs.",
"type": "object"
},
"filterSpecs": {
"description": "The filter criteria per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence.",
"items": {
"$ref": "FilterSpec"
},
"type": "array"
},
"range": {
"$ref": "GridRange",
"description": "The range the filter covers."
},
"sortSpecs": {
"description": "The sort order per column. Later specifications are used when values are 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 DataFilter 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 DataFilters in a spreadsheet.",
"id": "BatchClearValuesByDataFilterResponse",
"properties": {
"clearedRanges": {
"description": "The ranges that were cleared, in A1 notation. If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges 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. If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges 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 set of DataFilters.",
"id": "BatchGetValuesByDataFilterRequest",
"properties": {
"dataFilters": {
"description": "The data filters used to match the ranges of values to retrieve. Ranges that match any of the specified data filters are included in the response.",
"items": {
"$ref": "DataFilter"
},
"type": "array"
},
"dateTimeRenderOption": {
"description": "How dates, times, and durations should be represented in the output. This is ignored if value_render_option is FORMATTED_VALUE. The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output as doubles in \"serial number\" format, as popularized by Lotus 1-2-3. The whole number portion of the value (left of the decimal) counts the days since December 30th 1899. The fractional portion (right of the decimal) counts the time as a fraction of the day. For example, January 1st 1900 at noon would be 2.5, 2 because it's 2 days after December 30st 1899, and .5 because noon is half a day. February 1st 1900 at 3pm would be 33.625. This correctly treats the year 1900 as not a leap year.",
"Instructs date, time, datetime, and duration fields to be output as strings in their given number format (which is dependent on the spreadsheet locale)."
],
"type": "string"
},
"majorDimension": {
"description": "The major dimension that results should use. For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then a request that selects that range and sets `majorDimension=ROWS` returns `[[1,2],[3,4]]`, whereas a request that sets `majorDimension=COLUMNS` returns `[[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. The 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 cell's formatting. Formatting is based on the spreadsheet's locale, not the requesting user's locale. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then A2 would return `\"=A1\"`."
],
"type": "string"
}
},
"type": "object"
},
"BatchGetValuesByDataFilterResponse": {
"description": "The response when retrieving more than one range of values in a spreadsheet selected 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 order 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 resource.",
"type": "boolean"
},
"requests": {
"description": "A list of updates to apply to the spreadsheet. Requests will be applied in the order they are specified. If 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 include_spreadsheet_in_response is 'true'. This parameter is ignored if a field mask was set in the request.",
"type": "boolean"
},
"responseRanges": {
"description": "Limits the ranges included in the response spreadsheet. Meaningful only if include_spreadsheet_in_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 replies 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 [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 matched by the specified DataFilter the specified values are applied to all of those ranges.",
"items": {
"$ref": "DataFilterValueRange"
},
"type": "array"
},
"includeValuesInResponse": {
"description": "Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values. The `updatedData` field within each of the BatchUpdateValuesResponse.responses contains the updated values. If the range to write was larger than the range actually written, the response includes all values in the requested range (excluding trailing empty rows and columns).",
"type": "boolean"
},
"responseDateTimeRenderOption": {
"description": "Determines how dates, times, and durations in the response should be rendered. This is ignored if response_value_render_option is FORMATTED_VALUE. The default dateTime render option is DateTimeRenderOption.SERIAL_NUMBER.",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output as doubles in \"serial number\" format, as popularized by Lotus 1-2-3. The whole number portion of the value (left of the decimal) counts the days since December 30th 1899. The fractional portion (right of the decimal) counts the time as a fraction of the day. For example, January 1st 1900 at noon would be 2.5, 2 because it's 2 days after December 30st 1899, and .5 because noon is half a day. February 1st 1900 at 3pm would be 33.625. This correctly treats the year 1900 as not a leap year.",
"Instructs date, time, datetime, and duration fields to be output as strings in their given number format (which is dependent on the spreadsheet locale)."
],
"type": "string"
},
"responseValueRenderOption": {
"description": "Determines how values in the response should be rendered. The 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 cell's formatting. Formatting is based on the spreadsheet's locale, not the requesting user's locale. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then 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 as-is.",
"The values will be parsed as if the user typed them into the UI. Numbers will stay as numbers, but strings may be converted to numbers, dates, etc. following the same rules that are applied when entering text 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 updated.",
"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 updated.",
"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 of the cells that were updated. By default, responses do not include the updated values. The `updatedData` field within each of the BatchUpdateValuesResponse.responses contains the updated values. If the range to write was larger than the range actually written, the response includes all values in the requested range (excluding trailing empty rows and columns).",
"type": "boolean"
},
"responseDateTimeRenderOption": {
"description": "Determines how dates, times, and durations in the response should be rendered. This is ignored if response_value_render_option is FORMATTED_VALUE. The default dateTime render option is DateTimeRenderOption.SERIAL_NUMBER.",
"enum": [
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"enumDescriptions": [
"Instructs date, time, datetime, and duration fields to be output as doubles in \"serial number\" format, as popularized by Lotus 1-2-3. The whole number portion of the value (left of the decimal) counts the days since December 30th 1899. The fractional portion (right of the decimal) counts the time as a fraction of the day. For example, January 1st 1900 at noon would be 2.5, 2 because it's 2 days after December 30st 1899, and .5 because noon is half a day. February 1st 1900 at 3pm would be 33.625. This correctly treats the year 1900 as not a leap year.",
"Instructs date, time, datetime, and duration fields to be output as strings in their given number format (which is dependent on the spreadsheet locale)."
],
"type": "string"
},
"responseValueRenderOption": {
"description": "Determines how values in the response should be rendered. The 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 cell's formatting. Formatting is based on the spreadsheet's locale, not the requesting user's locale. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then 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 as-is.",
"The values will be parsed as if the user typed them into the UI. Numbers will stay as numbers, but strings may be converted to numbers, dates, etc. following the same rules that are applied when entering text 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 the 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 updated.",
"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 updated.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"BigQueryDataSourceSpec": {
"description": "The specification of a BigQuery data source that's connected to a sheet.",
"id": "BigQueryDataSourceSpec",
"properties": {
"projectId": {
"description": "The ID of a BigQuery enabled GCP project with a billing account attached. For any queries executed against the data source, the project is charged.",
"type": "string"
},
"querySpec": {
"$ref": "BigQueryQuerySpec",
"description": "A BigQueryQuerySpec."
},
"tableSpec": {
"$ref": "BigQueryTableSpec",
"description": "A BigQueryTableSpec."
}
},
"type": "object"
},
"BigQueryQuerySpec": {
"description": "Specifies a custom BigQuery query.",
"id": "BigQueryQuerySpec",
"properties": {
"rawQuery": {
"description": "The raw query string.",
"type": "string"
}
},
"type": "object"
},
"BigQueryTableSpec": {
"description": "Specifies a BigQuery table definition. Only [native tables](https://cloud.google.com/bigquery/docs/tables-intro) is allowed.",
"id": "BigQueryTableSpec",
"properties": {
"datasetId": {
"description": "The BigQuery dataset id.",
"type": "string"
},
"tableId": {
"description": "The BigQuery table id.",
"type": "string"
},
"tableProjectId": {
"description": "The ID of a BigQuery project the table belongs to. If not specified, the project_id is assumed.",
"type": "string"
}
},
"type": "object"
},
"BooleanCondition": {
"description": "A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data 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",
"TEXT_NOT_EQ",
"DATE_NOT_EQ"
],
"enumDescriptions": [
"The default value, do not use.",
"The cell's value must be greater than the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue.",
"The cell's value must be greater than or equal to the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue.",
"The cell's value must be less than the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue.",
"The cell's value must be less than or equal to the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue.",
"The cell's value must be equal to the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue for data validation, conditional formatting, and filters on non-data source objects and at least one ConditionValue for filters on data source objects.",
"The cell's value must be not equal to the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue for data validation, conditional formatting, and filters on non-data source objects and at least one ConditionValue for filters on data source objects.",
"The cell's value must be between the two condition values. Supported by data validation, conditional formatting and filters. Requires exactly two ConditionValues.",
"The cell's value must not be between the two condition values. Supported by data validation, conditional formatting and filters. Requires exactly two ConditionValues.",
"The cell's value must contain the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue.",
"The cell's value must not contain the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue.",
"The cell's value must start with the condition's value. Supported by conditional formatting and filters. Requires a single ConditionValue.",
"The cell's value must end with the condition's value. Supported by conditional formatting and filters. Requires a single ConditionValue.",
"The cell's value must be exactly the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue for data validation, conditional formatting, and filters on non-data source objects and at least one ConditionValue for filters on data source objects.",
"The cell's value must be a valid email address. Supported by data validation. Requires no ConditionValues.",
"The cell's value must be a valid URL. Supported by data validation. Requires no ConditionValues.",
"The cell's value must be the same date as the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue for data validation, conditional formatting, and filters on non-data source objects and at least one ConditionValue for filters on data source objects.",
"The cell's value must be before the date of the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue that may be a relative date.",
"The cell's value must be after the date of the condition's value. Supported by data validation, conditional formatting and filters. Requires a single ConditionValue that may be a relative date.",
"The cell's value must be on or before the date of the condition's value. Supported by data validation. Requires a single ConditionValue that may be a relative date.",
"The cell's value must be on or after the date of the condition's value. Supported by data validation. Requires a single ConditionValue that may be a relative date.",
"The cell's value must be between the dates of the two condition values. Supported by data validation. Requires exactly two ConditionValues.",
"The cell's value must be outside the dates of the two condition values. Supported by data validation. Requires exactly two ConditionValues.",
"The cell's value must be a date. Supported by data validation. Requires no ConditionValues.",
"The cell's value must be listed in the grid in condition value's range. Supported by data validation. Requires a single ConditionValue, and the value must be a valid range in A1 notation.",
"The cell's value must be in the list of condition values. Supported by data validation. Supports any number of condition values, one per item in the list. Formulas are not supported in the values.",
"The cell's value must be empty. Supported by conditional formatting and filters. Requires no ConditionValues.",
"The cell's value must not be empty. Supported by conditional formatting and filters. Requires no ConditionValues.",
"The condition's formula must evaluate to true. Supported by data validation, conditional formatting and filters. Not supported by data source sheet filters. Requires a single ConditionValue.",
"The cell's value must be TRUE/FALSE or in the list of condition values. Supported by data validation. Renders as a cell checkbox. Supports zero, one or two ConditionValues. No values indicates the cell must be TRUE or FALSE, where TRUE renders as checked and FALSE renders as unchecked. One value indicates the cell will render as checked when it contains that value and unchecked when it is blank. Two values indicate that the cell will render as checked when it contains the first value and unchecked when it contains the second value. For example, [\"Yes\",\"No\"] indicates that the cell will render a checked box when it has the value \"Yes\" and an unchecked box when it has the value \"No\".",
"The cell's value must be exactly not the condition's value. Supported by filters on data source objects. Requires at least one ConditionValue.",
"The cell's value must be exactly not the condition's value. Supported by filters on data source objects. Requires at least one ConditionValue."
],
"type": "string"
},
"values": {
"description": "The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and 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, the format is applied."
},
"format": {
"$ref": "CellFormat",
"description": "The format to apply. Conditional formatting can only apply a subset of formatting: bold, italic, strikethrough, foreground color \u0026 background color."
}
},
"type": "object"
},
"Border": {
"description": "A border along a cell.",
"id": "Border",
"properties": {
"color": {
"$ref": "Color",
"description": "The color of the border."
},
"colorStyle": {
"$ref": "ColorStyle",
"description": "The color of the border. If color is also set, this field takes precedence."
},
"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. Used 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. Deprecated; 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 bubble chart.",
"id": "BubbleChartSpec",
"properties": {
"bubbleBorderColor": {
"$ref": "Color",
"description": "The bubble border color."
},
"bubbleBorderColorStyle": {
"$ref": "ColorStyle",
"description": "The bubble border color. If bubble_border_color is also set, this field takes precedence."
},
"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. If specified, the field must be a positive value.",
"format": "int32",
"type": "integer"
},
"bubbleMinRadiusSize": {
"description": "The minimum radius size of the bubbles, in pixels. If specific, the field must be a positive value.",
"format": "int32",
"type": "integer"
},
"bubbleOpacity": {
"description": "The opacity of the bubbles between 0 and 1.0. 0 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 the bubbles at different sizes relative to each other. If specified, group_ids must also be specified. This field is optional."
},
"bubbleTextStyle": {
"$ref": "TextFormat",
"description": "The format of the text inside the bubbles. Underline and Strikethrough are not supported."
},
"domain": {
"$ref": "ChartData",
"description": "The data containing the bubble x-values. These values locate the bubbles in the chart horizontally."
},
"groupIds": {
"$ref": "ChartData",
"description": "The data containing the bubble group IDs. All bubbles with the same group ID are drawn in the same color. If bubble_sizes is specified then this field must also be specified but may contain blank values. This 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 in the chart vertically."
}
},
"type": "object"
},
"CandlestickChartSpec": {
"description": "A candlestick chart.",
"id": "CandlestickChartSpec",
"properties": {
"data": {
"description": "The Candlestick chart data. Only one CandlestickData is supported.",
"items": {
"$ref": "CandlestickData"
},
"type": "array"
},
"domain": {
"$ref": "CandlestickDomain",
"description": "The domain data (horizontal axis) for the candlestick chart. String data will be treated as discrete labels, other data will be treated as continuous values."
}
},
"type": "object"
},
"CandlestickData": {
"description": "The Candlestick chart data, each containing the low, open, close, and high values for a series.",
"id": "CandlestickData",
"properties": {
"closeSeries": {
"$ref": "CandlestickSeries",
"description": "The range data (vertical axis) for the close/final value for each candle. This is the top of the candle body. If greater than the open value the candle 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 candle. 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. This 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 candle. This is the bottom of the candle body. If less than the close value 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": {
"dataSourceFormula": {
"$ref": "DataSourceFormula",
"description": "Output only. Information about a data source formula on the cell. The field is set if user_entered_value is a formula referencing some DATA_SOURCE sheet, e.g `=SUM(DataSheet!Column)`.",
"readOnly": true
},
"dataSourceTable": {
"$ref": "DataSourceTable",
"description": "A data source table anchored at this cell. The size of data source table itself is computed dynamically based on its configuration. Only the first cell of the data source table contains the data source table definition. The other cells will contain the display values of the data source table result in their effective_value fields."
},
"dataValidation": {
"$ref": "DataValidationRule",
"description": "A data validation rule on the cell, if any. When writing, the new data validation rule will overwrite any prior rule."
},
"effectiveFormat": {
"$ref": "CellFormat",
"description": "The effective format being used by the cell. This includes the results of applying any conditional formatting and, if the cell contains a formula, the computed number format. If the effective format is the default format, effective format will not be written. This field is read-only."
},
"effectiveValue": {
"$ref": "ExtendedValue",
"description": "The effective value of the cell. For cells with formulas, this is the calculated value. For cells with literals, this is the same as the user_entered_value. This field is read-only."
},
"formattedValue": {
"description": "The formatted value of the cell. This is the value as it's shown to the user. This field is read-only.",
"type": "string"
},
"hyperlink": {
"description": "A hyperlink this cell points to, if any. This field is read-only. (To set it, use a `=HYPERLINK` formula in the userEnteredValue.formulaValue field.)",
"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 is computed dynamically based on its data, grouping, filters, values, etc. Only the top-left cell of the pivot table contains the pivot table definition. The other cells will contain the calculated values of the results of the pivot in their effective_value fields."
},
"textFormatRuns": {
"description": "Runs of rich text applied to subsections of the cell. Runs are only valid on user entered strings, not formulas, bools, or numbers. Runs start at specific indexes in the text and continue until the next run. Properties of a run will continue unless explicitly changed in a subsequent run (and properties of the first run will continue the properties of the cell unless explicitly changed). When writing, the new runs will overwrite any prior runs. When writing a new user_entered_value, previous runs are erased.",
"items": {
"$ref": "TextFormatRun"
},
"type": "array"
},
"userEnteredFormat": {
"$ref": "CellFormat",
"description": "The format the user entered for the cell. When 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()` Note: Dates, Times and DateTimes are represented as doubles in serial number format."
}
},
"type": "object"
},
"CellFormat": {
"description": "The format of a cell.",
"id": "CellFormat",
"properties": {
"backgroundColor": {
"$ref": "Color",
"description": "The background color of the cell."
},
"backgroundColorStyle": {
"$ref": "ColorStyle",
"description": "The background color of the cell. If background_color is also set, this field takes precedence."
},
"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 cell over, so long as that cell is empty. If the next cell over is non-empty, this behaves the same as CLIP. The text will never wrap to the next line unless the user manually inserts a new line. Example: | First sentence. | | Manual newline that is very long. \u003c- Text continues into next cell | Next newline. |",
"This wrap strategy represents the old Google Sheets wrap strategy where words that are longer than a line are clipped rather than broken. This strategy is not supported on all platforms and is being phased out. Example: | Cell has a | | loooooooooo| \u003c- Word is clipped. | word. |",
"Lines that are longer than the cell width will be clipped. The text will never wrap to the next line unless the user manually inserts a new line. Example: | First sentence. | | Manual newline t| \u003c- Text is clipped | Next newline. |",
"Words that are longer than a line are wrapped at the character level rather than clipped. Example: | Cell has a | | loooooooooo| \u003c- Word is broken. | ong word. |"
],
"type": "string"
}
},
"type": "object"
},
"ChartAxisViewWindowOptions": {
"description": "The options that define a \"view window\" for a chart (such as the visible values in an axis).",
"id": "ChartAxisViewWindowOptions",
"properties": {
"viewWindowMax": {
"description": "The maximum numeric value to be shown in this view window. If unset, will automatically determine a maximum value that looks good for the data.",
"format": "double",
"type": "number"
},
"viewWindowMin": {
"description": "The minimum numeric value to be shown in this view window. If unset, will automatically determine a minimum value that looks good for the data.",
"format": "double",
"type": "number"
},
"viewWindowMode": {
"description": "The view window's mode.",
"enum": [
"DEFAULT_VIEW_WINDOW_MODE",
"VIEW_WINDOW_MODE_UNSUPPORTED",
"EXPLICIT",
"PRETTY"
],
"enumDescriptions": [
"The default view window mode used in the Sheets editor for this chart type. In most cases, if set, the default mode is equivalent to `PRETTY`.",
"Do not use. Represents that the currently set mode is not supported by the API.",
"Follows the min and max exactly if specified. If a value is unspecified, it will fall back to the `PRETTY` value.",
"Chooses a min and max that make the chart look good. Both min and max are ignored in this mode."
],
"type": "string"
}
},
"type": "object"
},
"ChartCustomNumberFormatOptions": {
"description": "Custom number formatting options for chart attributes.",
"id": "ChartCustomNumberFormatOptions",
"properties": {
"prefix": {
"description": "Custom prefix to be prepended to the chart attribute. This field is optional.",
"type": "string"
},
"suffix": {
"description": "Custom suffix to be appended to the chart attribute. This field is optional.",
"type": "string"
}
},
"type": "object"
},
"ChartData": {
"description": "The data included in a domain or series.",
"id": "ChartData",
"properties": {
"aggregateType": {
"description": "The aggregation type for the series of a data source chart. Not supported for regular charts.",
"enum": [
"CHART_AGGREGATE_TYPE_UNSPECIFIED",
"AVERAGE",
"COUNT",
"MAX",
"MEDIAN",
"MIN",
"SUM"
],
"enumDescriptions": [
"Default value, do not use.",
"Average aggregate function.",
"Count aggregate function.",
"Maximum aggregate function.",
"Median aggregate function.",
"Minimum aggregate function.",
"Sum aggregate function."
],
"type": "string"
},
"columnReference": {
"$ref": "DataSourceColumnReference",
"description": "The reference to the data source column that the data reads from."
},
"groupRule": {
"$ref": "ChartGroupRule",
"description": "The rule to group the data by if the ChartData backs the domain of a data source chart. Not supported for regular charts."
},
"sourceRange": {
"$ref": "ChartSourceRange",
"description": "The source ranges of the data."
}
},
"type": "object"
},
"ChartDateTimeRule": {
"description": "Allows you to organize the date-time values in a source data column into buckets based on selected parts of their date or time values.",
"id": "ChartDateTimeRule",
"properties": {
"type": {
"description": "The type of date-time grouping to apply.",
"enum": [
"CHART_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 PM. The AM/PM designation is translated based on the spreadsheet locale.",
"Group dates by day of week, for example Sunday. The days of the week will be translated based on the spreadsheet locale.",
"Group dates by day of year, from 1 to 366. Note that dates after Feb. 29 fall 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 translated based on the spreadsheet locale.",
"Group dates by month, for example Nov. The month is translated based on 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 translated 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"
},
"ChartGroupRule": {
"description": "An optional setting on the ChartData of the domain of a data source chart that defines buckets for the values in the domain rather than breaking out each individual value. For example, when plotting a data source chart, you can specify a histogram rule on the domain (it should only contain numeric values), grouping its values into buckets. Any values of a chart series that fall into the same bucket are aggregated based on the aggregate_type.",
"id": "ChartGroupRule",
"properties": {
"dateTimeRule": {
"$ref": "ChartDateTimeRule",
"description": "A ChartDateTimeRule."
},
"histogramRule": {
"$ref": "ChartHistogramRule",
"description": "A ChartHistogramRule"
}
},
"type": "object"
},
"ChartHistogramRule": {
"description": "Allows you to organize numeric values in a source data column into buckets of constant size.",
"id": "ChartHistogramRule",
"properties": {
"intervalSize": {
"description": "The size of the buckets that are created. Must be positive.",
"format": "double",
"type": "number"
},
"maxValue": {
"description": "The maximum value at which items are placed into buckets. Values greater than the maximum are grouped into a single bucket. If omitted, it is determined by the maximum item value.",
"format": "double",
"type": "number"
},
"minValue": {
"description": "The minimum value at which items are placed into buckets. Values that are less than the minimum are grouped into a single bucket. If omitted, it is determined by the minimum item value.",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"ChartSourceRange": {
"description": "Source ranges for a chart.",
"id": "ChartSourceRange",
"properties": {
"sources": {
"description": "The ranges of data for a series or domain. Exactly one dimension must have a length of 1, and all sources in the list must have the same dimension with length 1. The domain (if it exists) \u0026 all series must have the same number of source ranges. If using more than one source range, then the source range at a given offset must be in order and contiguous across the domain and series. For example, these are valid configurations: domain sources: A1:A5 series1 sources: B1:B5 series2 sources: D6:D10 domain sources: A1:A5, C10:C12 series1 sources: B1:B5, D10:D12 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 for accessibility.",
"type": "string"
},
"backgroundColor": {
"$ref": "Color",
"description": "The background color of the entire chart. Not applicable to Org charts."
},
"backgroundColorStyle": {
"$ref": "ColorStyle",
"description": "The background color of the entire chart. Not applicable to Org charts. If background_color is also set, this field takes precedence."
},
"basicChart": {
"$ref": "BasicChartSpec",
"description": "A basic chart specification, can be one of many kinds of charts. See BasicChartType for the list of all charts this supports."
},
"bubbleChart": {
"$ref": "BubbleChartSpec",
"description": "A bubble chart specification."
},
"candlestickChart": {
"$ref": "CandlestickChartSpec",
"description": "A candlestick chart specification."
},
"dataSourceChartProperties": {
"$ref": "DataSourceChartProperties",
"description": "If present, the field contains data source chart specific properties."
},
"filterSpecs": {
"description": "The filters applied to the source data of the chart. Only supported for data source charts.",
"items": {
"$ref": "FilterSpec"
},
"type": "array"
},
"fontName": {
"description": "The name of the font to use by default for all chart text (e.g. title, axis labels, legend). If a font is specified for a specific part of the chart 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 minimum padding. False to use the default padding. (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."
},
"scorecardChart": {
"$ref": "ScorecardChartSpec",
"description": "A scorecard chart specification."
},
"sortSpecs": {
"description": "The order to sort the chart data by. Only a single sort spec is supported. Only supported for data source charts.",
"items": {
"$ref": "SortSpec"
},
"type": "array"
},
"subtitle": {
"description": "The subtitle of the chart.",
"type": "string"
},
"subtitleTextFormat": {
"$ref": "TextFormat",
"description": "The subtitle text format. Strikethrough and underline are not supported."
},
"subtitleTextPosition": {
"$ref": "TextPosition",
"description": "The subtitle text position. This field is optional."
},
"title": {
"description": "The title of the chart.",
"type": "string"
},
"titleTextFormat": {
"$ref": "TextFormat",
"description": "The title text format. Strikethrough and underline are not supported."
},
"titleTextPosition": {
"$ref": "TextPosition",
"description": "The title text position. This 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. (If the request was for an unbounded range or a ranger larger than the bounds of the sheet, this will be the actual range 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 for simplicity of conversion to/from color representations in various languages over compactness; for example, the fields of this representation can be trivially provided to the constructor of \"java.awt.Color\" in Java; it can also be trivially provided to UIColor's \"+colorWithRed:green:blue:alpha\" method in iOS; and, with just a little work, it can be easily formatted into a CSS \"rgba()\" string in JavaScript, as well. Note: this proto does not carry information about the absolute color space that should be used to interpret the RGB value (e.g. sRGB, Adobe RGB, DCI-P3, BT.2020, etc.). By default, applications SHOULD assume the sRGB color space. Note: when color equality needs to be decided, implementations, unless documented otherwise, will treat two colors to be equal if all their red, green, blue and alpha values each differ by at most 1e-5. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor_(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor_ = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...",
"id": "Color",
"properties": {
"alpha": {
"description": "The fraction of this color that should be applied to the pixel. That is, the final pixel color is defined by the equation: pixel color = alpha * (this color) + (1.0 - alpha) * (background color) This means that a value of 1.0 corresponds to a solid color, whereas a value of 0.0 corresponds to a completely transparent color. This uses a wrapper message rather than a simple float scalar so that it is possible to distinguish between a default value and the value being unset. If omitted, this color object is to be rendered as a solid color (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"
},
"ColorStyle": {
"description": "A color value.",
"id": "ColorStyle",
"properties": {
"rgbColor": {
"$ref": "Color",
"description": "RGB color."
},
"themeColor": {
"description": "Theme color.",
"enum": [
"THEME_COLOR_TYPE_UNSPECIFIED",
"TEXT",
"BACKGROUND",
"ACCENT1",
"ACCENT2",
"ACCENT3",
"ACCENT4",
"ACCENT5",
"ACCENT6",
"LINK"
],
"enumDescriptions": [
"Unspecified theme color",
"Represents the primary text color",
"Represents the primary background color",
"Represents the first accent color",
"Represents the second accent color",
"Represents the third accent color",
"Represents the fourth accent color",
"Represents the fifth accent color",
"Represents the sixth accent color",
"Represents the color to use for hyperlinks"
],
"type": "string"
}
},
"type": "object"
},
"ConditionValue": {
"description": "The value of the condition.",
"id": "ConditionValue",
"properties": {
"relativeDate": {
"description": "A relative date (based on the current date). Valid only if the type is DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE or DATE_ON_OR_AFTER. Relative dates are not supported in data validation. They are supported only in conditional formatting and conditional filters.",
"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. The value is parsed as if the user typed into a cell. Formulas 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. All 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 a multiple of the source's height or width, then the data will be repeated to fill in the destination range. If the range is smaller than the source range, the entire source 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 of 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"
},
"DataExecutionStatus": {
"description": "The data execution status. A data execution is created to sync a data source object with the latest data from a DataSource. It is usually scheduled to run at background, you can check its state to tell if an execution completes There are several scenarios where a data execution is triggered to run: * Adding a data source creates an associated data source sheet as well as a data execution to sync the data from the data source to the sheet. * Updating a data source creates a data execution to refresh the associated data source sheet similarly. * You can send refresh request to explicitly refresh one or multiple data source objects.",
"id": "DataExecutionStatus",
"properties": {
"errorCode": {
"description": "The error code.",
"enum": [
"DATA_EXECUTION_ERROR_CODE_UNSPECIFIED",
"TIMED_OUT",
"TOO_MANY_ROWS",
"TOO_MANY_CELLS",
"ENGINE",
"PARAMETER_INVALID",
"UNSUPPORTED_DATA_TYPE",
"DUPLICATE_COLUMN_NAMES",
"INTERRUPTED",
"CONCURRENT_QUERY",
"OTHER",
"TOO_MANY_CHARS_PER_CELL",
"DATA_NOT_FOUND",
"PERMISSION_DENIED",
"MISSING_COLUMN_ALIAS",
"OBJECT_NOT_FOUND",
"OBJECT_IN_ERROR_STATE",
"OBJECT_SPEC_INVALID"
],
"enumDescriptions": [
"Default value, do not use.",
"The data execution timed out.",
"The data execution returns more rows than the limit.",
"The data execution returns more cells than the limit.",
"Error is received from the backend data execution engine (e.g. BigQuery). Check error_message for details.",
"One or some of the provided data source parameters are invalid.",
"The data execution returns an unsupported data type.",
"The data execution returns duplicate column names or aliases.",
"The data execution is interrupted. Please refresh later.",
"The data execution is currently in progress, can not be refreshed until it completes.",
"Other errors.",
"The data execution returns values that exceed the maximum characters allowed in a single cell.",
"The database referenced by the data source is not found. */",
"The user does not have access to the database referenced by the data source.",
"The data execution returns columns with missing aliases.",
"The data source object does not exist.",
"The data source object is currently in error state. To force refresh, set force in RefreshDataSourceRequest.",
"The data source object specification is invalid."
],
"type": "string"
},
"errorMessage": {
"description": "The error message, which may be empty.",
"type": "string"
},
"lastRefreshTime": {
"description": "Gets the time the data last successfully refreshed.",
"format": "google-datetime",
"type": "string"
},
"state": {
"description": "The state of the data execution.",
"enum": [
"DATA_EXECUTION_STATE_UNSPECIFIED",
"NOT_STARTED",
"RUNNING",
"SUCCEEDED",
"FAILED"
],
"enumDescriptions": [
"Default value, do not use.",
"The data execution has not started.",
"The data execution has started and is running.",
"The data execution has completed successfully.",
"The data execution has completed with errors."
],
"type": "string"
}
},
"type": "object"
},
"DataFilter": {
"description": "Filter that describes what data should be selected or returned from a request.",
"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 described 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 matched by the data filter then the request fails. If the provided values are less than the matched ranges only the specified values are written, existing values in the matched ranges remain unaffected.",
"items": {
"items": {
"type": "any"
},
"type": "array"
},
"type": "array"
}
},
"type": "object"
},
"DataSource": {
"description": "Information about an external data source in the spreadsheet.",
"id": "DataSource",
"properties": {
"calculatedColumns": {
"description": "All calculated columns in the data source.",
"items": {
"$ref": "DataSourceColumn"
},
"type": "array"
},
"dataSourceId": {
"description": "The spreadsheet-scoped unique ID that identifies the data source. Example: 1080547365.",
"type": "string"
},
"sheetId": {
"description": "The ID of the Sheet connected with the data source. The field cannot be changed once set. When creating a data source, an associated DATA_SOURCE sheet is also created, if the field is not specified, the ID of the created sheet will be randomly generated.",
"format": "int32",
"type": "integer"
},
"spec": {
"$ref": "DataSourceSpec",
"description": "The DataSourceSpec for the data source connected with this spreadsheet."
}
},
"type": "object"
},
"DataSourceChartProperties": {
"description": "Properties of a data source chart.",
"id": "DataSourceChartProperties",
"properties": {
"dataExecutionStatus": {
"$ref": "DataExecutionStatus",
"description": "Output only. The data execution status.",
"readOnly": true
},
"dataSourceId": {
"description": "ID of the data source that the chart is associated with.",
"type": "string"
}
},
"type": "object"
},
"DataSourceColumn": {
"description": "A column in a data source.",
"id": "DataSourceColumn",
"properties": {
"formula": {
"description": "The formula of the calculated column.",
"type": "string"
},
"reference": {
"$ref": "DataSourceColumnReference",
"description": "The column reference."
}
},
"type": "object"
},
"DataSourceColumnReference": {
"description": "An unique identifier that references a data source column.",
"id": "DataSourceColumnReference",
"properties": {
"name": {
"description": "The display name of the column. It should be unique within a data source.",
"type": "string"
}
},
"type": "object"
},
"DataSourceFormula": {
"description": "A data source formula.",
"id": "DataSourceFormula",
"properties": {
"dataExecutionStatus": {
"$ref": "DataExecutionStatus",
"description": "Output only. The data execution status.",
"readOnly": true
},
"dataSourceId": {
"description": "The ID of the data source the formula is associated with.",
"type": "string"
}
},
"type": "object"
},
"DataSourceObjectReference": {
"description": "Reference to a data source object.",
"id": "DataSourceObjectReference",
"properties": {
"chartId": {
"description": "References to a data source chart.",
"format": "int32",
"type": "integer"
},
"dataSourceFormulaCell": {
"$ref": "GridCoordinate",
"description": "References to a cell containing DataSourceFormula."
},
"dataSourcePivotTableAnchorCell": {
"$ref": "GridCoordinate",
"description": "References to a data source PivotTable anchored at the cell."
},
"dataSourceTableAnchorCell": {
"$ref": "GridCoordinate",
"description": "References to a DataSourceTable anchored at the cell."
},
"sheetId": {
"description": "References to a DATA_SOURCE sheet.",
"type": "string"
}
},
"type": "object"
},
"DataSourceObjectReferences": {
"description": "A list of references to data source objects.",
"id": "DataSourceObjectReferences",
"properties": {
"references": {
"description": "The references.",
"items": {
"$ref": "DataSourceObjectReference"
},
"type": "array"
}
},
"type": "object"
},
"DataSourceParameter": {
"description": "A parameter in a data source's query. The parameter allows the user to pass in values from the spreadsheet into a query.",
"id": "DataSourceParameter",
"properties": {
"name": {
"description": "Named parameter. Must be a legitimate identifier for the DataSource that supports it. For example, [BigQuery identifier](https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#identifiers).",
"type": "string"
},
"namedRangeId": {
"description": "ID of a NamedRange. Its size must be 1x1.",
"type": "string"
},
"range": {
"$ref": "GridRange",
"de