API Google Таблиц — это интерфейс RESTful, который позволяет читать и изменять данные электронной таблицы. Наиболее распространенное использование этого API включает в себя следующие задачи:
- Создание электронных таблиц
- Чтение и запись значений ячеек электронной таблицы
- Обновить форматирование таблицы
- Управление подключенными таблицами
Ниже приведен список общих терминов, используемых в этом API:
- электронная таблица
Основной объект в Google Таблицах, который может содержать несколько листов, каждый из которых содержит структурированную информацию, содержащуюся в ячейках. Ресурс
Spreadsheet
представляет каждую электронную таблицу и имеет уникальное значениеspreadsheetId
, содержащее буквы, цифры, дефисы или символы подчеркивания. Идентификатор таблицы можно найти в URL-адресе Google Таблиц:https://docs.google.com/spreadsheets/d/ spreadsheetId /edit#gid=0
- Лист
Страница или вкладка в электронной таблице. Ресурс
Sheet
представляет каждый лист и имеет уникальный заголовок и числовое значениеsheetId
. Вы можете найти идентификатор листа в URL-адресе Google Таблиц:https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid= sheetId
- Клетка
Отдельное поле текста или данных на листе. Ячейки расположены в строках и столбцах и могут быть сгруппированы как диапазон ячеек. Ресурс
CellData
представляет каждую ячейку, но не имеет уникального значения идентификатора. Вместо этого координаты строки и столбца идентифицируют ячейки.- Обозначение А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». Аналогично,Sheet1
относится ко всем ячейкам Листа1. Однако если существует именованный диапазон с названием «Лист1», то «Лист1» относится к именованному диапазону, аSheet1
— к листу.- Обозначение R1C1
- Синтаксис, используемый для определения ячейки или диапазона ячеек с помощью строки, содержащей имя листа, а также координаты начальной и конечной ячейки с использованием номеров строк и номеров столбцов. Этот метод менее распространен, чем нотация A1, но может быть полезен при ссылке на диапазон ячеек относительно позиции данной ячейки.
Показать примеры
-
Sheet1!R1C1:R2C2
относится к первым двум ячейкам в двух верхних строках Sheet1. -
R1C1:R2C2
относится к первым двум ячейкам в двух верхних строках первого видимого листа. -
Sheet1!R[3]C[1]
относится к ячейке, которая находится на три строки ниже и на один столбец справа от текущей ячейки.
- Именованный диапазон
- Определенная ячейка или диапазон ячеек с настраиваемым именем для упрощения ссылок во всем приложении. Ресурс
FilterView
представляет именованный диапазон. - Защищенный диапазон
- Определенная ячейка или диапазон ячеек, которые нельзя изменить. Ресурс
ProtectedRange
представляет защищенный диапазон.
Связанные темы
Дополнительную информацию о разработке с использованием API Google Workspace, включая обработку аутентификации и авторизации, см. в разделе «Разработка в Google Workspace» .
Чтобы узнать, как настроить и запустить приложение Sheets API, прочтите краткий обзор кратких руководств .