1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2024-12-23 02:06:12 +02:00
OpenIntegrations/docs/en/md/Google_Sheets/Data-work/Get-cell-values.md

83 lines
1.5 KiB
Markdown
Raw Normal View History

---
sidebar_position: 3
---
# Get cell values
Gets cell values of the table
*Function GetCellValues(Val Token, Val Book, Val CellsArray = "", Val Sheet = "") Export*
| Parameter | CLI option | Type | Destination |
|-|-|-|-|
| Token | --token | String | Token |
| Book | --spreadsheet | String | BookID |
| CellsArray | --cells | Array of String | Array of A1-type cells to get (whole sheet if not filled) |
| Sheet | --sheetname | String | Sheet name (first sheet by default) |
Returns: Map Of KeyAndValue - serialized JSON response from Google
```bsl title="Code example"
CellsArray = New Array;
CellsArray.Add("B2");
CellsArray.Add("A3");
CellsArray.Add("B4");
Book = "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc";
Sheet = "Sheet2";
Response = OPI_GoogleSheets.GetCellValues(Token, Book, CellsArray, Sheet); //Map
Response = OPI_Tools.JSONString(Response); //JSON string
```
```sh title="CLI command example"
oint gsheets GetCellValues --token %token% --spreadsheet "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc" --cells %cells% --sheetname "Sheet2"
```
```json title="Result"
{
"spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
"valueRanges": [
{
"range": "'Sheet2'!B2",
"majorDimension": "ROWS",
"values": [
[
"ThisIsB2"
]
]
},
{
"range": "'Sheet2'!A3",
"majorDimension": "ROWS",
"values": [
[
"ThisIsA3"
]
]
},
{
"range": "'Sheet2'!B4",
"majorDimension": "ROWS",
"values": [
[
"ThisIsB4"
]
]
}
]
}
```