Feature/read cells

.gitignore

@@ -18,4 +18,6 @@ admin/i18n/*/flat.txt
 #ignore .commitinfo created by ioBroker release script
 .commitinfo
 
-coverage
+coverage
+build
+

README.md

@@ -34,6 +34,7 @@ This adapter can be used to automatically interact with google sheets.
 * [Delete sheets](docs/features/delete-sheets.md)
 * [Duplicate sheets](docs/features/duplicate-sheet.md)
 * [Read cell](docs/features/read-cell.md)
+* [Read cells](docs/features/read-cells.md)
 * [Write cell](docs/features/write-cell.md)
 * [Write cells](docs/features/write-cells.md)
 
@@ -120,6 +121,7 @@ Make sure the Service Account has adequate permissions to write to the spreadshe
     ### **WORK IN PROGRESS**
 -->
 ### **WORK IN PROGRESS**
+- (Thomas Pohl) Added readCells feature: Read multiple cells in one call using A1 notation (e.g. A1:B10), including Blockly block and documentation.
 - (copilot) Adapter requires node.js >= 22 now
 
 ### 1.0.1 (2026-02-16)

admin/blockly.js

@@ -128,5 +128,6 @@ loadJS('../google-spreadsheet/blocks/deleteSheet.js');
 loadJS('../google-spreadsheet/blocks/deleteSheets.js');
 loadJS('../google-spreadsheet/blocks/duplicateSheet.js');
 loadJS('../google-spreadsheet/blocks/readCell.js');
+loadJS('../google-spreadsheet/blocks/readCells.js');
 loadJS('../google-spreadsheet/blocks/writeCell.js');
 loadJS('../google-spreadsheet/blocks/writeCells.js');

admin/blocks/readCells.js

@@ -0,0 +1,56 @@
+'use strict';
+/*global Blockly */
+/*global getInstances */
+/*global getInstanceAndAlias */
+
+/// --- Read Cells  --------------------------------------------------
+
+Blockly.Words['google-spreadsheet_readcells_read-from'] = { en: 'read from', de: 'Lies von' };
+Blockly.Words['google-spreadsheet_readcells_on-sheetName'] = { en: 'sheet', de: 'Tabellenblatt' };
+Blockly.Words['google-spreadsheet_readcells_in-range'] = { en: 'range', de: 'Bereich' };
+Blockly.GoogleSheets.blocks['google-spreadsheet.readCells'] =
+    '<block type="google-spreadsheet.readCells">' +
+    '     <field name="INSTANCE"></field>' +
+    '     <value name="SHEET_NAME">' +
+    '         <shadow type="text">' +
+    '             <field name="TEXT">text</field>' +
+    '         </shadow>' +
+    '     </value>' +
+    '     <value name="RANGE">' +
+    '         <shadow type="text">' +
+    '             <field name="TEXT">A1:A7</field>' +
+    '         </shadow>' +
+    '     </value>' +
+    '</block>';
+
+Blockly.Blocks['google-spreadsheet.readCells'] = {
+    init: function () {
+        const instances = getInstances(false);
+
+        this.appendDummyInput('NAME')
+            .appendField(Blockly.Translate('google-spreadsheet_readcells_read-from'))
+            .appendField(new Blockly.FieldDropdown(instances), 'INSTANCE');
+
+        this.appendValueInput('SHEET_NAME').appendField(Blockly.Translate('google-spreadsheet_readcells_on-sheetName'));
+
+        this.appendValueInput('RANGE').appendField(Blockly.Translate('google-spreadsheet_readcells_in-range'));
+
+        this.setInputsInline(true);
+        this.setPreviousStatement(false, null);
+        this.setNextStatement(false, null);
+        this.setOutput(true, 'Array');
+
+        this.setColour(Blockly.GoogleSheets.HUE);
+    },
+};
+
+Blockly.JavaScript.forBlock['google-spreadsheet.readCells'] = function (block) {
+    const { instance, alias } = getInstanceAndAlias(block);
+    const sheetName = Blockly.JavaScript.valueToCode(block, 'SHEET_NAME', Blockly.JavaScript.ORDER_ATOMIC);
+    const range = Blockly.JavaScript.valueToCode(block, 'RANGE', Blockly.JavaScript.ORDER_ATOMIC);
+
+    return [
+        `await new Promise((resolve)=>{sendTo("google-spreadsheet${instance}", "readCells", {sheet: ${sheetName}, range: ${range}, alias: "${alias}"}, (response)=>{resolve(response)}, (response)=>{console.log('Error: ' + response.error); resolve([]);}); })`,
+        Blockly.JavaScript.ORDER_ATOMIC,
+    ];
+};