@datafire/google_sheets v6.0.0
@datafire/google_sheets
Client library for Google Sheets API
Installation and Usage
npm install --save @datafire/google_sheets
let google_sheets = require('@datafire/google_sheets').create({
access_token: "",
refresh_token: "",
client_id: "",
client_secret: "",
redirect_uri: ""
});
.then(data => {
console.log(data);
});
Description
Reads and writes Google Sheets.
Actions
oauthCallback
Exchange the code passed to your redirect URI for an access_token
google_sheets.oauthCallback({
"code": ""
}, context)
Input
- input
object
- code required
string
- code required
Output
- output
object
- access_token
string
- refresh_token
string
- token_type
string
- scope
string
- expiration
string
- access_token
oauthRefresh
Exchange a refresh_token for an access_token
google_sheets.oauthRefresh(null, context)
Input
This action has no parameters
Output
- output
object
- access_token
string
- refresh_token
string
- token_type
string
- scope
string
- expiration
string
- access_token
sheets.spreadsheets.create
Creates a spreadsheet, returning the newly created spreadsheet.
google_sheets.sheets.spreadsheets.create({}, context)
Input
- input
object
- body Spreadsheet
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
Output
- output Spreadsheet
sheets.spreadsheets.get
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.
google_sheets.sheets.spreadsheets.get({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The spreadsheet to request. - includeGridData
boolean
: True if grid data should be returned. This parameter is ignored if a field mask was set in the request. - ranges
array
: The ranges to retrieve from the spreadsheet. - $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output Spreadsheet
sheets.spreadsheets.developerMetadata.get
Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId.
google_sheets.sheets.spreadsheets.developerMetadata.get({
"spreadsheetId": "",
"metadataId": 0
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to retrieve metadata from. - metadataId required
integer
: The ID of the developer metadata to retrieve. - $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output DeveloperMetadata
sheets.spreadsheets.developerMetadata.search
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.
google_sheets.sheets.spreadsheets.developerMetadata.search({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to retrieve metadata from. - body SearchDeveloperMetadataRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
sheets.spreadsheets.sheets.copyTo
Copies a single sheet from a spreadsheet to another spreadsheet. Returns the properties of the newly created sheet.
google_sheets.sheets.spreadsheets.sheets.copyTo({
"spreadsheetId": "",
"sheetId": 0
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet containing the sheet to copy. - sheetId required
integer
: The ID of the sheet to copy. - body CopySheetToAnotherSpreadsheetRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output SheetProperties
sheets.spreadsheets.values.get
Returns a range of values from a spreadsheet. The caller must specify the spreadsheet ID and a range.
google_sheets.sheets.spreadsheets.values.get({
"spreadsheetId": "",
"range": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to retrieve data from. - range required
string
: The A1 notation of the values to retrieve. - dateTimeRenderOption
string
(values: SERIAL_NUMBER, FORMATTED_STRING): 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. - majorDimension
string
(values: DIMENSION_UNSPECIFIED, ROWS, COLUMNS): The major dimension that results should use. For example, if the spreadsheet data is:A1=1,B1=2,A2=3,B2=4
, then requestingrange=A1:B2,majorDimension=ROWS
returns[[1,2],[3,4]]
, whereas requestingrange=A1:B2,majorDimension=COLUMNS
returns[[1,3],[2,4]]
. - valueRenderOption
string
(values: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA): How values should be represented in the output. The default render option is ValueRenderOption.FORMATTED_VALUE. - $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output ValueRange
sheets.spreadsheets.values.update
Sets values in a range of a spreadsheet. The caller must specify the spreadsheet ID, range, and a valueInputOption.
google_sheets.sheets.spreadsheets.values.update({
"spreadsheetId": "",
"range": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to update. - range required
string
: The A1 notation of the values to update. - includeValuesInResponse
boolean
: 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). - responseDateTimeRenderOption
string
(values: SERIAL_NUMBER, FORMATTED_STRING): 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. - responseValueRenderOption
string
(values: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA): Determines how values in the response should be rendered. The default render option is ValueRenderOption.FORMATTED_VALUE. - valueInputOption
string
(values: INPUT_VALUE_OPTION_UNSPECIFIED, RAW, USER_ENTERED): How the input data should be interpreted. - body ValueRange
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output UpdateValuesResponse
sheets.spreadsheets.values.append
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 and sample code 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.
google_sheets.sheets.spreadsheets.values.append({
"spreadsheetId": "",
"range": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to update. - range required
string
: The A1 notation of a range to search for a logical table of data. Values are appended after the last row of the table. - includeValuesInResponse
boolean
: Determines if the update response should include the values of the cells that were appended. By default, responses do not include the updated values. - insertDataOption
string
(values: OVERWRITE, INSERT_ROWS): How the input data should be inserted. - responseDateTimeRenderOption
string
(values: SERIAL_NUMBER, FORMATTED_STRING): 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. - responseValueRenderOption
string
(values: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA): Determines how values in the response should be rendered. The default render option is ValueRenderOption.FORMATTED_VALUE. - valueInputOption
string
(values: INPUT_VALUE_OPTION_UNSPECIFIED, RAW, USER_ENTERED): How the input data should be interpreted. - body ValueRange
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output AppendValuesResponse
sheets.spreadsheets.values.clear
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.
google_sheets.sheets.spreadsheets.values.clear({
"spreadsheetId": "",
"range": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to update. - range required
string
: The A1 notation of the values to clear. - body ClearValuesRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output ClearValuesResponse
sheets.spreadsheets.values.batchClear
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.
google_sheets.sheets.spreadsheets.values.batchClear({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to update. - body BatchClearValuesRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output BatchClearValuesResponse
sheets.spreadsheets.values.batchClearByDataFilter
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.
google_sheets.sheets.spreadsheets.values.batchClearByDataFilter({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to update. - body BatchClearValuesByDataFilterRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
sheets.spreadsheets.values.batchGet
Returns one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more ranges.
google_sheets.sheets.spreadsheets.values.batchGet({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to retrieve data from. - dateTimeRenderOption
string
(values: SERIAL_NUMBER, FORMATTED_STRING): 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. - majorDimension
string
(values: DIMENSION_UNSPECIFIED, ROWS, COLUMNS): The major dimension that results should use. For example, if the spreadsheet data is:A1=1,B1=2,A2=3,B2=4
, then requestingrange=A1:B2,majorDimension=ROWS
returns[[1,2],[3,4]]
, whereas requestingrange=A1:B2,majorDimension=COLUMNS
returns[[1,3],[2,4]]
. - ranges
array
: The A1 notation of the values to retrieve. - valueRenderOption
string
(values: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA): How values should be represented in the output. The default render option is ValueRenderOption.FORMATTED_VALUE. - $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output BatchGetValuesResponse
sheets.spreadsheets.values.batchGetByDataFilter
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.
google_sheets.sheets.spreadsheets.values.batchGetByDataFilter({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to retrieve data from. - body BatchGetValuesByDataFilterRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
sheets.spreadsheets.values.batchUpdate
Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more ValueRanges.
google_sheets.sheets.spreadsheets.values.batchUpdate({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to update. - body BatchUpdateValuesRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output BatchUpdateValuesResponse
sheets.spreadsheets.values.batchUpdateByDataFilter
Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.
google_sheets.sheets.spreadsheets.values.batchUpdateByDataFilter({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The ID of the spreadsheet to update. - body BatchUpdateValuesByDataFilterRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
sheets.spreadsheets.batchUpdate
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.
google_sheets.sheets.spreadsheets.batchUpdate({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The spreadsheet to apply the updates to. - body BatchUpdateSpreadsheetRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
sheets.spreadsheets.getByDataFilter
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.
google_sheets.sheets.spreadsheets.getByDataFilter({
"spreadsheetId": ""
}, context)
Input
- input
object
- spreadsheetId required
string
: The spreadsheet to request. - body GetSpreadsheetByDataFilterRequest
- $.xgafv
string
(values: 1, 2): V1 error format. - access_token
string
: OAuth access token. - alt
string
(values: json, media, proto): Data format for response. - callback
string
: JSONP - fields
string
: Selector specifying which fields to include in a partial response. - key
string
: 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. - oauth_token
string
: OAuth 2.0 token for the current user. - prettyPrint
boolean
: Returns response with indentations and line breaks. - quotaUser
string
: 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. - upload_protocol
string
: Upload protocol for media (e.g. "raw", "multipart"). - uploadType
string
: Legacy upload protocol for media (e.g. "media", "multipart").
- spreadsheetId required
Output
- output Spreadsheet
Definitions
AddBandingRequest
- AddBandingRequest
object
: Adds a new banded range to the spreadsheet.- bandedRange BandedRange
AddBandingResponse
- AddBandingResponse
object
: The result of adding a banded range.- bandedRange BandedRange
AddChartRequest
- AddChartRequest
object
: Adds a chart to a sheet in the spreadsheet.- chart EmbeddedChart
AddChartResponse
- AddChartResponse
object
: The result of adding a chart to a spreadsheet.- chart EmbeddedChart
AddConditionalFormatRuleRequest
- AddConditionalFormatRuleRequest
object
: Adds a new conditional format rule at the given index. All subsequent rules' indexes are incremented.- index
integer
: The zero-based index where the rule should be inserted. - rule ConditionalFormatRule
- index
AddDataSourceRequest
- AddDataSourceRequest
object
: 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 additionalbigquery.readonly
OAuth scope.- dataSource DataSource
AddDataSourceResponse
- AddDataSourceResponse
object
: The result of adding a data source.- dataExecutionStatus DataExecutionStatus
- dataSource DataSource
AddDimensionGroupRequest
- AddDimensionGroupRequest
object
: 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.- range DimensionRange
AddDimensionGroupResponse
- AddDimensionGroupResponse
object
: The result of adding a group.- dimensionGroups
array
: All groups of a dimension after adding a group to that dimension.- items DimensionGroup
- dimensionGroups
AddFilterViewRequest
- AddFilterViewRequest
object
: Adds a filter view.- filter FilterView
AddFilterViewResponse
- AddFilterViewResponse
object
: The result of adding a filter view.- filter FilterView
AddNamedRangeRequest
- AddNamedRangeRequest
object
: Adds a named range to the spreadsheet.- namedRange NamedRange
AddNamedRangeResponse
- AddNamedRangeResponse
object
: The result of adding a named range.- namedRange NamedRange
AddProtectedRangeRequest
- AddProtectedRangeRequest
object
: Adds a new protected range.- protectedRange ProtectedRange
AddProtectedRangeResponse
- AddProtectedRangeResponse
object
: The result of adding a new protected range.- protectedRange ProtectedRange
AddSheetRequest
- AddSheetRequest
object
: 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.- properties SheetProperties
AddSheetResponse
- AddSheetResponse
object
: The result of adding a sheet.- properties SheetProperties
AddSlicerRequest
- AddSlicerRequest
object
: Adds a slicer to a sheet in the spreadsheet.- slicer Slicer
AddSlicerResponse
- AddSlicerResponse
object
: The result of adding a slicer to a spreadsheet.- slicer Slicer
AppendCellsRequest
- AppendCellsRequest
object
: Adds new cells after the last row with data in a sheet, inserting new rows into the sheet if necessary.- fields
string
: 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. - rows
array
: The data to append.- items RowData
- sheetId
integer
: The sheet ID to append the data to.
- fields
AppendDimensionRequest
- AppendDimensionRequest
object
: Appends rows or columns to the end of a sheet.- dimension
string
(values: DIMENSION_UNSPECIFIED, ROWS, COLUMNS): Whether rows or columns should be appended. - length
integer
: The number of rows or columns to append. - sheetId
integer
: The sheet to append rows or columns to.
- dimension
AppendValuesResponse
- AppendValuesResponse
object
: The response when updating a range of values in a spreadsheet.- spreadsheetId
string
: The spreadsheet the updates were applied to. - tableRange
string
: 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. - updates UpdateValuesResponse
- spreadsheetId
AutoFillRequest
- AutoFillRequest
object
: Fills in more data based on existing data.- range GridRange
- sourceAndDestination SourceAndDestination
- useAlternateSeries
boolean
: True if we should generate data with the "alternate" series. This differs based on the type and amount of source data.
AutoResizeDimensionsRequest
- AutoResizeDimensionsRequest
object
: Automatically resizes one or more dimensions based on the contents of the cells in that dimension.- dataSourceSheetDimensions DataSourceSheetDimensionRange
- dimensions DimensionRange
BandedRange
- BandedRange
object
: A banded (alternating colors) range in a sheet.- bandedRangeId
integer
: The id of the banded range. - columnProperties BandingProperties
- range GridRange
- rowProperties BandingProperties
- bandedRangeId
BandingProperties
- BandingProperties
object
: 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.- firstBandColor Color
- firstBandColorStyle ColorStyle
- footerColor Color
- footerColorStyle ColorStyle
- headerColor Color
- headerColorStyle ColorStyle
- secondBandColor Color
- secondBandColorStyle ColorStyle
BaselineValueFormat
- BaselineValueFormat
object
: Formatting options for baseline value.- comparisonType
string
(values: COMPARISON_TYPE_UNDEFINED, ABSOLUTE_DIFFERENCE, PERCENTAGE_DIFFERENCE): The comparison type of key value with baseline value. - description
string
: Description which is appended after the baseline value. This field is optional. - negativeColor Color
- negativeColorStyle ColorStyle
- position TextPosition
- positiveColor Color
- positiveColorStyle ColorStyle
- textFormat TextFormat
- comparisonType
BasicChartAxis
- BasicChartAxis
object
: An axis of the chart. A chart may not have more than one axis per axis position.- format TextFormat
- position
string
(values: BASIC_CHART_AXIS_POSITION_UNSPECIFIED, BOTTOM_AXIS, LEFT_AXIS, RIGHT_AXIS): The position of this axis. - title
string
: The title of this axis. If set, this overrides any title inferred from headers of the data. - titleTextPosition TextPosition
- viewWindowOptions ChartAxisViewWindowOptions
BasicChartDomain
- BasicChartDomain
object
: The domain of a chart. For example, if charting stock prices over time, this would be the date.- domain ChartData
- reversed
boolean
: True to reverse the order of the domain values (horizontal axis).
BasicChartSeries
- BasicChartSeries
object
: 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".- color Color
- colorStyle ColorStyle
- dataLabel DataLabel
- lineStyle LineStyle
- pointStyle PointStyle
- series ChartData
- styleOverrides
array
: Style override settings for series data points. - targetAxis
string
(values: BASIC_CHART_AXIS_POSITION_UNSPECIFIED, BOTTOM_AXIS, LEFT_AXIS, RIGHT_AXIS): 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. - type
string
(values: BASIC_CHART_TYPE_UNSPECIFIED, BAR, LINE, AREA, COLUMN, SCATTER, COMBO, STEPPED_AREA): 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.
BasicChartSpec
- BasicChartSpec
object
: The specification for a basic chart. See BasicChartType for the list of charts this supports.- axis
array
: The axis on the chart.- items BasicChartAxis
- chartType
string
(values: BASIC_CHART_TYPE_UNSPECIFIED, BAR, LINE, AREA, COLUMN, SCATTER, COMBO, STEPPED_AREA): The type of the chart. - compareMode
string
(values: BASIC_CHART_COMPARE_MODE_UNSPECIFIED, DATUM, CATEGORY): The behavior of tooltips and data highlighting when hovering on data and chart area. - domains
array
: The domain of data this is charting. Only a single domain is supported.- items BasicChartDomain
- headerCount
integer
: 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.) - interpolateNulls
boolean
: 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. - legendPosition
string
(values: BASIC_CHART_LEGEND_POSITION_UNSPECIFIED, BOTTOM_LEGEND, LEFT_LEGEND, RIGHT_LEGEND, TOP_LEGEND, NO_LEGEND): The position of the chart legend. - lineSmoothing
boolean
: Gets whether all lines should be rendered smooth or straight by default. Applies to Line charts. - series
array
: The data this chart is visualizing.- items BasicChartSeries
- stackedType
string
(values: BASIC_CHART_STACKED_TYPE_UNSPECIFIED, NOT_STACKED, STACKED, PERCENT_STACKED): The stacked type for charts that support vertical stacking. Applies to Area, Bar, Column, Combo, and Stepped Area charts. - threeDimensional
boolean
: True to make the chart 3D. Applies to Bar and Column charts. - totalDataLabel DataLabel
- axis
BasicFilter
- BasicFilter
object
: The default filter associated with a sheet.- criteria
object
: 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. - filterSpecs
array
: 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 FilterSpec
- range GridRange
- sortSpecs
array
: The sort order per column. Later specifications are used when values are equal in the earlier specifications.- items SortSpec
- criteria
BasicSeriesDataPointStyleOverride
- BasicSeriesDataPointStyleOverride
object
: Style override settings for a single series data point.- color Color
- colorStyle ColorStyle
- index
integer
: Zero based index of the series data point. - pointStyle PointStyle
BatchClearValuesByDataFilterRequest
- BatchClearValuesByDataFilterRequest
object
: The request for clearing more than one range selected by a DataFilter in a spreadsheet.- dataFilters
array
: The DataFilters used to determine which ranges to clear.- items DataFilter
- dataFilters
BatchClearValuesByDataFilterResponse
- BatchClearValuesByDataFilterResponse
object
: The response when clearing a range of values selected with DataFilters in a spreadsheet.- clearedRanges
array
: 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
string
- items
- spreadsheetId
string
: The spreadsheet the updates were applied to.
- clearedRanges
BatchClearValuesRequest
- BatchClearValuesRequest
object
: The request for clearing more than one range of values in a spreadsheet.- ranges
array
: The ranges to clear, in A1 notation.- items
string
- items
- ranges
BatchClearValuesResponse
- BatchClearValuesResponse
object
: The response when clearing a range of values in a spreadsheet.- clearedRanges
array
: 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
string
- items
- spreadsheetId
string
: The spreadsheet the updates were applied to.
- clearedRanges
BatchGetValuesByDataFilterRequest
- BatchGetValuesByDataFilterRequest
object
: The request for retrieving a range of values in a spreadsheet selected by a set of DataFilters.- dataFilters
array
: 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 DataFilter
- dateTimeRenderOption
string
(values: SERIAL_NUMBER, FORMATTED_STRING): 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. - majorDimension
string
(values: DIMENSION_UNSPECIFIED, ROWS, COLUMNS): 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 setsmajorDimension=ROWS
returns[[1,2],[3,4]]
, whereas a request that setsmajorDimension=COLUMNS
returns[[1,3],[2,4]]
. - valueRenderOption
string
(values: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA): How values should be represented in the output. The default render option is ValueRenderOption.FORMATTED_VALUE.
- dataFilters
BatchGetValuesByDataFilterResponse
- BatchGetValuesByDataFilterResponse
object
: The response when retrieving more than one range of values in a spreadsheet selected by DataFilters.- spreadsheetId
string
: The ID of the spreadsheet the data was retrieved from. - valueRanges
array
: The requested values with the list of data filters that matched them.- items MatchedValueRange
- spreadsheetId
BatchGetValuesResponse
- BatchGetValuesResponse
object
: The response when retrieving more than one range of values in a spreadsheet.- spreadsheetId
string
: The ID of the spreadsheet the data was retrieved from. - valueRanges
array
: The requested values. The order of the ValueRanges is the same as the order of the requested ranges.- items ValueRange
- spreadsheetId
BatchUpdateSpreadsheetRequest
- BatchUpdateSpreadsheetRequest
object
: The request for updating any aspect of a spreadsheet.- includeSpreadsheetInResponse
boolean
: Determines if the update response should include the spreadsheet resource. - requests
array
: 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 Request
- responseIncludeGridData
boolean
: 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. - responseRanges
array
: Limits the ranges included in the response spreadsheet. Meaningful only if include_spreadsheet_in_response is 'true'.- items
string
- items
- includeSpreadsheetInResponse
BatchUpdateSpreadsheetResponse
- BatchUpdateSpreadsheetResponse
object
: The reply for batch updating a spreadsheet.- replies
array
: The reply of the updates. This maps 1:1 with the updates, although replies to some requests may be empty.- items Response
- spreadsheetId
string
: The spreadsheet the updates were applied to. - updatedSpreadsheet Spreadsheet
- replies
BatchUpdateValuesByDataFilterRequest
- BatchUpdateValuesByDataFilterRequest
object
: The request for updating more than one range of values in a spreadsheet.- data
array
: 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 DataFilterValueRange
- includeValuesInResponse
boolean
: Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values. TheupdatedData
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). - responseDateTimeRenderOption
string
(values: SERIAL_NUMBER, FORMATTED_STRING): 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. - responseValueRenderOption
string
(values: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA): Determines how values in the response should be rendered. The default render option is ValueRenderOption.FORMATTED_VALUE. - valueInputOption
string
(values: INPUT_VALUE_OPTION_UNSPECIFIED, RAW, USER_ENTERED): How the input data should be interpreted.
- data
BatchUpdateValuesByDataFilterResponse
- BatchUpdateValuesByDataFilterResponse
object
: The response when updating a range of values in a spreadsheet.- responses
array
: The response for each range updated. - spreadsheetId
string
: The spreadsheet the updates were applied to. - totalUpdatedCells
integer
: The total number of cells updated. - totalUpdatedColumns
integer
: The total number of columns where at least one cell in the column was updated. - totalUpdatedRows
integer
: The total number of rows where at least one cell in the row was updated. - totalUpdatedSheets
integer
: The total number of sheets where at least one cell in the sheet was updated.
- responses
BatchUpdateValuesRequest
- BatchUpdateValuesRequest
object
: The request for updating more than one range of values in a spreadsheet.- data
array
: The new values to apply to the spreadsheet.- items ValueRange
- includeValuesInResponse
boolean
: Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values. TheupdatedData
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). - responseDateTimeRenderOption
string
(values: SERIAL_NUMBER, FORMATTED_STRING): 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. - responseValueRenderOption
string
(values: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA): Determines how values in the response should be rendered. The default render option is ValueRenderOption.FORMATTED_VALUE. - valueInputOption
string
(values: INPUT_VALUE_OPTION_UNSPECIFIED, RAW, USER_ENTERED): How the input data should be interpreted.
- data
BatchUpdateValuesResponse
- BatchUpdateValuesResponse
object
: The response when updating a range of values in a spreadsheet.- responses
array
: One UpdateValuesResponse per requested range, in the same order as the requests appeared.- items UpdateValuesResponse
- spreadsheetId
string
: The spreadsheet the updates were applied to. - totalUpdatedCells
integer
: The total number of cells updated. - totalUpdatedColumns
integer
: The total number of columns where at least one cell in the column was updated. - totalUpdatedRows
integer
: The total number of rows where at least one cell in the row was updated. - totalUpdatedSheets
integer
: The total number of sheets where at least one cell in the sheet was updated.
- responses
BigQueryDataSourceSpec
- BigQueryDataSourceSpec
object
: The specification of a BigQuery data source that's connected to a sheet.- projectId
string
: 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. - querySpec BigQueryQuerySpec
- tableSpec BigQueryTableSpec
- projectId
BigQueryQuerySpec
- BigQueryQuerySpec
object
: Specifies a custom BigQuery query.- rawQuery
string
: The raw query string.
- rawQuery
BigQueryTableSpec
- BigQueryTableSpec
object
: Specifies a BigQuery table definition. Only native tables is allowed.- datasetId
string
: The BigQuery dataset id. - tableId
string
: The BigQuery table id. - tableProjectId
string
: The ID of a BigQuery project the table belongs to. If not specified, the project_id is assumed.
- datasetId
BooleanCondition
- BooleanCondition
object
: A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters.- type
string
(values: 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): The type of condition. - values
array
: 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 ConditionValue
- type
BooleanRule
- BooleanRule
object
: A rule that may or may not match, depending on the condition.- condition BooleanCondition
- format CellFormat
Border
- Border
object
: A border along a cell.- color Color
- colorStyle ColorStyle
- style
string
(values: STYLE_UNSPECIFIED, DOTTED, DASHED, SOLID, SOLID_MEDIUM, SOLID_THICK, NONE, DOUBLE): The style of the border. - width
integer
: The width of the border, in pixels. Deprecated; the width is determined by the "style" field.
Borders
BubbleChartSpec
- BubbleChartSpec
object
: A bubble chart.- bubbleBorderColor Color
- bubbleBorderColorStyle ColorStyle
- bubbleLabels ChartData
- bubbleMaxRadiusSize
integer
: The max radius size of the bubbles, in pixels. If specified, the field must be a positive value. - bubbleMinRadiusSize
integer
: The minimum radius size of the bubbles, in pixels. If specific, the field must be a positive value. - bubbleOpacity
number
: The opacity of the bubbles between 0 and 1.0. 0 is fully transparent and 1 is fully opaque. - bubbleSizes ChartData
- bubbleTextStyle TextFormat
- domain ChartData
- groupIds ChartData
- legendPosition
string
(values: BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED, BOTTOM_LEGEND, LEFT_LEGEND, RIGHT_LEGEND, TOP_LEGEND, NO_LEGEND, INSIDE_LEGEND): Where the legend of the chart should be drawn. - series ChartData
CandlestickChartSpec
- CandlestickChartSpec
object
: A candlestick chart.- data
array
: The Candlestick chart data. Only one CandlestickData is supported.- items CandlestickData
- domain CandlestickDomain
- data
CandlestickData
- CandlestickData
object
: The Candlestick chart data, each containing the low, open, close, and high values for a series.- closeSeries CandlestickSeries
- highSeries CandlestickSeries
- lowSeries CandlestickSeries
- openSeries CandlestickSeries
CandlestickDomain
- CandlestickDomain
object
: The domain of a CandlestickChart.- data ChartData
- reversed
boolean
: True to reverse the order of the domain values (horizontal axis).
CandlestickSeries
- CandlestickSeries
object
: The series of a CandlestickData.- data ChartData
CellData
- CellData
object
: Data about a specific cell.- dataSourceFormula DataSourceFormula
- dataSourceTable DataSourceTable
- dataValidation DataValidationRule
- effectiveFormat CellFormat
- effectiveValue ExtendedValue
- formattedValue
string
: The formatted value of the cell. This is the value as it's shown to the user. This field is read-only. - hyperlink
string
: A hyperlink this cell points to, if any. If the cell contains multiple hyperlinks, this field will be empty. This field is read-only. To set it, use a=HYPERLINK
formula in the userEnteredValue.formulaValue field. - note
string
: Any note on the cell. - pivotTable PivotTable
- textFormatRuns
array
: Runs of rich text applied to subsections of the cell. Runs are only valid on user entered strings, not formulas, bools, or numbers. Properties of a run start at a specific index in the text and continue until the next run. Runs will inherit 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 TextFormatRun
- userEnteredFormat CellFormat
- userEnteredValue ExtendedValue
CellFormat
- CellFormat
object
: The format of a cell.- backgroundColor Color
- backgroundColorStyle ColorStyle
- borders Borders
- horizontalAlignment
string
(values: HORIZONTAL_ALIGN_UNSPECIFIED, LEFT, CENTER, RIGHT): The horizontal alignment of the value in the cell. - hyperlinkDisplayType
string
(values: HYPERLINK_DISPLAY_TYPE_UNSPECIFIED, LINKED, PLAIN_TEXT): How a hyperlink, if it exists, should be displayed in the cell. - numberFormat NumberFormat
- padding Padding
- textDirection
string
(values: TEXT_DIRECTION_UNSPECIFIED, LEFT_TO_RIGHT, RIGHT_TO_LEFT): The direction of the text in the cell. - textFormat TextFormat
- textRotation TextRotation
- verticalAlignment
string
(values: VERTICAL_ALIGN_UNSPECIFIED, TOP, MIDDLE, BOTTOM): The vertical alignment of the value in the cell. - wrapStrategy
string
(values: WRAP_STRATEGY_UNSPECIFIED, OVERFLOW_CELL, LEGACY_WRAP, CLIP, WRAP): The wrap strategy for the value in the cell.
ChartAxisViewWindowOptions
- ChartAxisViewWindowOptions
object
: The options that define a "view window" for a chart (such as the visible values in an axis).- viewWindowMax
number
: 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. - viewWindowMin
number
: 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. - viewWindowMode
string
(values: DEFAULT_VIEW_WINDOW_MODE, VIEW_WINDOW_MODE_UNSUPPORTED, EXPLICIT, PRETTY): The view window's mode.
- viewWindowMax
ChartCustomNumberFormatOptions
- ChartCustomNumberFormatOptions
object
: Custom number formatting options for chart attributes.- prefix
string
: Custom prefix to be prepended to the chart attribute. This field is optional. - suffix
string
: Custom suffix to be appended to the chart attribute. This field is optional.
- prefix
ChartData
- ChartData
object
: The data included in a domain or series.- aggregateType
string
(values: CHART_AGGREGATE_TYPE_UNSPECIFIED, AVERAGE, COUNT, MAX, MEDIAN, MIN, SUM): The aggregation type for the series of a data source chart. Not supported for regular charts. - columnReference DataSourceColumnReference
- groupRule ChartGroupRule
- sourceRange ChartSourceRange
- aggregateType
ChartDateTimeRule
- ChartDateTimeRule
object
: 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.- type
string
(values: 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): The type of date-time grouping to apply.
- type
ChartGroupRule
- ChartGroupRule
object
: 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.- dateTimeRule ChartDateTimeRule
- hist