Обзор API Google Таблиц

Google Sheets API — это RESTful-интерфейс, позволяющий читать и изменять данные электронной таблицы. Sheets API позволяет:

  • Создание электронных таблиц
  • Чтение и запись значений ячеек электронной таблицы
  • Обновить форматирование электронной таблицы
  • Управление подключенными листами

Ниже приведен список общих терминов, используемых в API Таблиц:

Электронная таблица

Основной объект в Google Таблицах. Может содержать несколько Sheets , каждый из которых содержит структурированную информацию в Cells . Ресурс spreadsheets представляет собой электронную таблицу. Он содержит уникальное значение spreadsheetId .

Идентификатор электронной таблицы
Уникальный идентификатор электронной таблицы. Это определенная строка, содержащая буквы, цифры и некоторые специальные символы, которые ссылаются на электронную таблицу, и ее можно вывести из URL-адреса электронной таблицы. Идентификаторы электронных таблиц стабильны, даже если имя электронной таблицы меняется. 
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
Лист

Страница или вкладка в электронной таблице. Ресурс 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. Аналогично, Sheet1 относится к листу с именем Sheet1. Однако если есть именованный диапазон с названием "Sheet1", то Sheet1 относится к именованному диапазону, а 'Sheet1' относится к листу.

Обозначение R1C1
Синтаксис, используемый для определения ячейки или диапазона ячеек со строкой, содержащей имя листа и начальные и конечные координаты ячейки с использованием номеров строк и столбцов. Этот метод менее распространен, чем нотация A1, но может быть полезен при ссылке на диапазон ячеек относительно позиции данной ячейки.
  • Sheet1!R1C1:R2C2 относится к первым двум ячейкам в двух верхних строках Листа1.
  • R1C1:R2C2 относится к первым двум ячейкам в двух верхних строках первого видимого листа.
  • Sheet1!R[3]C[1] ссылается на ячейку, которая находится на три строки ниже и на один столбец правее текущей ячейки.
Названный диапазон
Определенная ячейка или диапазон ячеек с пользовательским именем для упрощения ссылок в приложении. Ресурс FilterView представляет именованный диапазон.
Защищенный диапазон
Определенная ячейка или диапазон ячеек, которые не могут быть изменены. Ресурс ProtectedRange представляет защищенный диапазон.