---
sidebar_position: 1
---

# Set cell values
 Sets sheet cell values



`Function SetCellValues(Val Token, Val Spreadsheet, Val ValueMapping, Val Sheet = "", Val MajorDimension = "COLUMNS") Export`

  | Parameter | CLI option | Type | Description |
  |-|-|-|-|
  | Token | --token | String | Token |
  | Spreadsheet | --spreadsheet | String | SpreadsheetID |
  | 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

<br/>




```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");
  
  Spreadsheet = "1Pu07Y5UiGVfW4fqfP7tcSQtdSX_2wdm2Ih23zlxJJwc";
  Sheet = "Sheet2";
  
  Response = OPI_GoogleSheets.SetCellValues(Token, Spreadsheet, 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
  }
  ]
  }
```
