---
sidebar_position: 1
---

# SetCellValues
 Sets sheet cell values


*Function SetCellValues(Val Token, Val Book, Val ValueMapping, Val Sheet = "", Val MajorDimension = "COLUMNS") Export*

 | Parameter | CLI option | Type | Destination |
 |-|-|-|-|
 | Token | --token | String | Token |
 | Book | --spreadsheet | String | BookID |
 | ValueMapping | --data | Map Of KeyAndValue | Fill data where the key is the cell name like A1 |
 | Sheet | --sheetname | String | Sheet name (first sheet by default) |
 | MajorDimension | --dim | String | Main dimension when filling the array range |

 
 Returns: Map Of KeyAndValue - serialized JSON response from Google

```bsl title="Code example"
	
 
 ValueMapping = New Map;
 ValueMapping.Insert("A1", "ThisIsA1");
 ValueMapping.Insert("A2", "ThisIsA2");
 ValueMapping.Insert("B2", "ThisIsB2");
 ValueMapping.Insert("B3", "ThisIsB3");
 ValueMapping.Insert("A3", "ThisIsA3");
 ValueMapping.Insert("A4", "ThisIsA4");
 ValueMapping.Insert("B1", "ThisIsB1");
 ValueMapping.Insert("B4", "ThisIsB4");
 
 Book = "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc";
 Sheet = "Sheet2";
 
 Response = OPI_GoogleSheets.SetCellValues(Token, Book, ValueMapping, Sheet); //Map
 Response = OPI_Tools.JSONString(Response); //JSON string
 
 
	
```

```sh title="CLI command example"
 
 oint gsheets SetCellValues --token %token% --spreadsheet "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc" --data %data% --sheetname "Sheet2" --dim %dim%


```


```json title="Result"

{
 "spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
 "totalUpdatedRows": 4,
 "totalUpdatedColumns": 2,
 "totalUpdatedCells": 8,
 "totalUpdatedSheets": 1,
 "responses": [
 {
 "spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
 "updatedRange": "'Sheet2'!A1",
 "updatedRows": 1,
 "updatedColumns": 1,
 "updatedCells": 1
 },
 {
 "spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
 "updatedRange": "'Sheet2'!A2",
 "updatedRows": 1,
 "updatedColumns": 1,
 "updatedCells": 1
 },
 {
 "spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
 "updatedRange": "'Sheet2'!B2",
 "updatedRows": 1,
 "updatedColumns": 1,
 "updatedCells": 1
 },
 {
 "spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
 "updatedRange": "'Sheet2'!B3",
 "updatedRows": 1,
 "updatedColumns": 1,
 "updatedCells": 1
 },
 {
 "spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
 "updatedRange": "'Sheet2'!A3",
 "updatedRows": 1,
 "updatedColumns": 1,
 "updatedCells": 1
 },
 {
 "spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
 "updatedRange": "'Sheet2'!A4",
 "updatedRows": 1,
 "updatedColumns": 1,
 "updatedCells": 1
 },
 {
 "spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
 "updatedRange": "'Sheet2'!B1",
 "updatedRows": 1,
 "updatedColumns": 1,
 "updatedCells": 1
 },
 {
 "spreadsheetId": "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc",
 "updatedRange": "'Sheet2'!B4",
 "updatedRows": 1,
 "updatedColumns": 1,
 "updatedCells": 1
 }
 ]
 }

```