Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
API Google Таблиц — это RESTful-интерфейс, позволяющий читать и изменять данные в электронных таблицах. API Таблиц позволяет:
Создание электронных таблиц
Чтение и запись значений ячеек электронной таблицы
Обновить форматирование электронной таблицы
Управление подключенными листами
Ниже приведен список общих терминов, используемых в API Таблиц:
Электронная таблица
Основной объект в Google Таблицах. Может содержать несколько Sheets , каждая из которых содержит структурированную информацию в Cells . Ресурс spreadsheets представляет электронную таблицу. Он содержит уникальное значение spreadsheetId .
Идентификатор электронной таблицы
Уникальный идентификатор электронной таблицы. Это определённая строка, содержащая буквы, цифры и некоторые специальные символы, которая ссылается на электронную таблицу и может быть получена из URL-адреса таблицы. Идентификаторы электронных таблиц остаются неизменными, даже если меняется их имя.
Страница или вкладка в электронной таблице. Ресурс Sheets представляет лист. Он содержит уникальное числовое значение sheetId и title листа как часть объекта SheetProperties .
Идентификатор листа
Уникальный идентификатор конкретного листа в электронной таблице. Это целое число, содержащее цифры, которые ссылаются на лист, и которое можно получить из URL-адреса электронной таблицы. Идентификаторы листов остаются неизменными, даже если меняется их имя. Пример см. в разделе Идентификатор электронной таблицы .
Клетка
Отдельное поле текста или данных на листе. Ячейки организованы в строки и столбцы и могут быть сгруппированы в диапазон ячеек. Ресурс Cells представляет каждую ячейку, но не имеет уникального идентификатора. Вместо этого ячейки идентифицируются координатами строк и столбцов.
Обозначение А1
Синтаксис, используемый для определения ячейки или диапазона ячеек с помощью строки, содержащей имя листа, а также координаты начальной и конечной ячейки, используя буквы столбцов и номера строк. Этот метод наиболее распространён и удобен при ссылке на абсолютный диапазон ячеек.
Sheet1!A1:B2 относится ко всем ячейкам в первых двух строках и столбцах Листа1.
Sheet1!A:A ссылается на все ячейки в первом столбце Листа1.
Sheet1!1:2 относится ко всем ячейкам в первых двух строках Листа1.
Sheet1!A5:A относится ко всем ячейкам первого столбца Листа 1, начиная с строки 5.
A1:B2 относится ко всем ячейкам в первых двух строках и столбцах первого видимого листа.
Sheet1 относится ко всем ячейкам на Листе1.
'Jon's_Data'!A1:D5 относится ко всем ячейкам в первых пяти строках и четырех столбцах листа с именем «Jon's_Data».
'My Custom Sheet'!A:A относится ко всем ячейкам в первом столбце листа с именем «Мой пользовательский лист».
'My Custom Sheet' относится ко всем ячейкам в «Моем пользовательском листе».
Для названий листов, содержащих пробелы или специальные символы, требуются одинарные кавычки.
Совет : По возможности используйте разные имена для объектов в электронных таблицах. Например, A1 (без кавычек) относится к ячейке A1 на первом видимом листе. 'A1' относится к листу с именем A1. Аналогично, «Лист1» относится к листу с именем «Лист1». Однако если есть именованный диапазон с именем «Лист1», то «Лист1» будет относиться к именованному диапазону, а 'Sheet1' — к листу.
Обозначение R1C1
Синтаксис, используемый для определения ячейки или диапазона ячеек строкой, содержащей имя листа, а также координаты начальной и конечной ячейки с использованием номеров строк и столбцов. Этот метод менее распространён, чем запись A1, но может быть полезен при ссылке на диапазон ячеек относительно позиции заданной ячейки.
Sheet1!R1C1:R2C2 относится к первым двум ячейкам в двух верхних строках листа Лист1.
R1C1:R2C2 относится к первым двум ячейкам в двух верхних строках первого видимого листа.
Sheet1!R[3]C[1] ссылается на ячейку, которая находится на три строки ниже и на один столбец правее текущей ячейки.
Именованный диапазон
Определенная ячейка или диапазон ячеек с пользовательским именем для упрощения ссылок в приложении. Ресурс FilterView представляет именованный диапазон.
Защищенный ареал
Определенная ячейка или диапазон ячеек, которые нельзя изменить. Ресурс ProtectedRange представляет защищенный диапазон.
Похожие темы
Информацию о разработке с использованием API Google Workspace, включая обработку аутентификации и авторизации, см. в разделе Разработка в Google Workspace .
Чтобы узнать, как настроить и запустить приложение API Таблиц, попробуйте быстрый старт JavaScript .
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-04 UTC."],[],[],null,["The Google Sheets API is a RESTful interface that lets you read and modify a\nspreadsheet's data. The Sheets API lets you:\n\n- Create spreadsheets\n- Read and write spreadsheet cell values\n- Update spreadsheet formatting\n- Manage Connected Sheets\n\nThe following is a list of common terms used in the Sheets API:\n\n*Spreadsheet*\n\n: The primary object in Google Sheets. It can contain multiple `Sheets`, each\n with structured information contained in `Cells`. The\n [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets)\n resource represents a spreadsheet. It contains a unique `spreadsheetId`\n value.\n\n *Spreadsheet ID*\n : The unique identifier for a spreadsheet. It's a particular string\n containing letters, numbers, and some special characters that reference a\n spreadsheet and it can be derived from the spreadsheet's URL. Spreadsheet\n IDs are stable, even if the spreadsheet name changes. \n\n https://docs.google.com/spreadsheets/d/\u003cvar translate=\"no\"\u003eSPREADSHEET_ID\u003c/var\u003e/edit?gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e#gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e\n\n*Sheet*\n\n: A page or tab within a spreadsheet. The\n [`Sheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets) resource\n represents a sheet. It contains a unique numeric `sheetId` value and sheet\n `title` as part of the\n [`SheetProperties`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#sheetproperties)\n object.\n\n *Sheet ID*\n : The unique identifier for a specific sheet within a spreadsheet. It's a\n particular integer containing numbers that reference a sheet and it can be\n derived from the spreadsheet's URL. Sheet IDs are stable, even if the sheet\n name changes. For an example, see [Spreadsheet ID](#spreadsheet-id).\n\n*Cell*\n\n: An individual field of text or data within a sheet. Cells are arranged in rows\n and columns, and can be grouped as a range of cells. The\n [`Cells`](/workspace/sheets/api/reference/rest/v4/spreadsheets/cells)\n resource represents each cell, but it doesn't have a unique ID value.\n Instead, row and column coordinates identify the cells.\n\n *A1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n column letters and row numbers. This method is the most common and useful\n when referencing an absolute range of cells.\n - `Sheet1!A1:B2` refers to all the cells in the first two rows and columns of Sheet1.\n - `Sheet1!A:A` refers to all the cells in the first column of Sheet1.\n - `Sheet1!1:2` refers to all the cells in the first two rows of Sheet1.\n - `Sheet1!A5:A` refers to all the cells of the first column of Sheet 1, from row 5 onward.\n - `A1:B2` refers to all the cells in the first two rows and columns of the first visible sheet.\n - `Sheet1` refers to all the cells in Sheet1.\n - `'Jon's_Data'!A1:D5` refers to all the cells in the first five rows and four columns of a sheet named \"Jon's_Data.\"\n - `'My Custom Sheet'!A:A` refers to all the cells in the first column of a sheet named \"My Custom Sheet.\"\n - `'My Custom Sheet'` refers to all the cells in \"My Custom Sheet\".\n\n Single quotes are required for sheet names with spaces or special characters.\n\n **Tip** : Where possible, use distinct names for objects in your spreadsheets. For example, A1 (without quotes) refers to cell A1 in the first visible sheet. `'A1'` refers to a sheet with the name A1. Similarly, Sheet1 refers to a sheet with the name Sheet1. However, if there's a named range titled \"Sheet1\", then Sheet1 refers to the named range and `'Sheet1'` refers to the sheet.\n\n *R1C1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n row numbers and column numbers. This method is less common than A1 notation,\n but can be useful when referencing a range of cells relative to a given\n cell's position.\n - `Sheet1!R1C1:R2C2` refers to the first two cells in the top two rows of Sheet1.\n - `R1C1:R2C2` refers to the first two cells in the top two rows of the first visible sheet.\n - `Sheet1!R[3]C[1]` refers to the cell that is three rows below and one column to the right of the current cell.\n\n *Named range*\n : A defined cell or range of cells with a custom name to simplify references\n throughout an application. A\n [`FilterView`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#filterview)\n resource represents a named range.\n\n *Protected range*\n : A defined cell or range of cells that cannot be modified. A\n [`ProtectedRange`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#protectedrange)\n resource represents a protected range.\n\nRelated topics\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Develop on\n Google Workspace](/workspace/guides/get-started).\n\n- To learn how to configure and run a Sheets API app, try the\n [JavaScript quickstart](/workspace/sheets/api/quickstart/js)."]]
