googlesheets

Get spreadsheet values

TOOL
Slug
GOOGLESHEETS_VALUES_GET
Version
20261001_00
Toolkit
googlesheets
Returns a range of values from a spreadsheet. Use when you need to read data from specific cells or ranges in a Google Sheet.
rangerequired
STRING
The A1 notation or R1C1 notation of the range to retrieve values from. If the sheet name contains spaces or special characters, wrap the sheet name in single quotes (e.g., "'My Sheet'!A1:B2"). Without single quotes, the API will return a 400 error for sheet names with spaces. Examples: 'Sheet1!A1:B3', "'Sheet With Spaces'!A1:D5", 'A1:D5' (no sheet name uses first visible sheet), 'Sheet1!A:A' (entire column), 'SheetName' (entire sheet).
end_row
INTEGER
1-based row number to stop reading at (inclusive). Use with start_row for pagination to avoid large response errors. Example: start_row=501, end_row=1000 fetches rows 501-1000.
start_row
INTEGER
1-based row number to start reading from (inclusive). Use with end_row for pagination to avoid large response errors. Example: start_row=1, end_row=500 fetches the first 500 rows.
spreadsheet_idrequired
STRING
The unique identifier of the Google Spreadsheet from which to retrieve values. This is the long alphanumeric string found in the spreadsheet URL between '/d/' and '/edit' (e.g., '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms'). WARNING: Do NOT use the spreadsheet name or title (e.g., 'My Sales Report'); you must use the actual ID from the URL.
major_dimension
STRING
The major dimension for results.
Options: DIMENSION_UNSPECIFIED, ROWS, COLUMNS
value_render_option
STRING
How values should be rendered in the output. FORMATTED_VALUE: Values are calculated and formatted (default). UNFORMATTED_VALUE: Values are calculated but not formatted. FORMULA: Values are not calculated; the formula is returned instead.
Options: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA
Default: "FORMATTED_VALUE"
date_time_render_option
STRING
How dates, times, and durations should be represented in the output. SERIAL_NUMBER: Dates are returned as serial numbers (default). FORMATTED_STRING: Dates returned as formatted strings.
Options: SERIAL_NUMBER, FORMATTED_STRING
Default: "SERIAL_NUMBER"