You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
You can filter the cells you want to fetch in several ways. See [Data Filters](https://developers.google.com/sheets/api/reference/rest/v4/DataFilter) for more info. Strings are treated as A1 ranges, objects are detected to be a [GridRange](https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/other#GridRange) with sheetId not required.
139
+
!> This method does not return the cells it loads, instead they are kept in a local cache managed by the sheet. See methods below (`getCell` and `getCellByA1`) to access them.
140
140
141
-
**NOTE - if using an API key (read-only access), only A1 rangesare supported**
141
+
You can filter the cells you want to fetch in several ways. See [Data Filters](https://developers.google.com/sheets/api/reference/rest/v4/DataFilter) for more info. Strings are treated as A1 ranges, objects are detected to be a [GridRange](https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/other#GridRange) with sheetId not required.
142
142
143
143
```javascript
144
144
awaitsheet.loadCells(); // no filter - will load ALL cells in the sheet
@@ -150,11 +150,13 @@ await sheet.loadCells({ startRowIndex: 50 }); // not all props required
150
150
awaitsheet.loadCells(['B2:D5', 'B50:D55']); // can pass an array of filters
151
151
```
152
152
153
+
!> If using an API key (read-only access), only A1 ranges are supported
154
+
153
155
Param|Type|Required|Description
154
156
---|---|---|---
155
157
`filters`|*|-|Can be a single filter or array of filters
156
158
157
-
- ✨ **Side effects** - cells are loaded in the doc, `cellStats` is updated
159
+
- ✨ **Side effects** - cells are loaded into local cache, `cellStats` is updated
0 commit comments