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

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

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

Ниже приведён список распространённых терминов, используемых в API Google Sheets:

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

Основной объект в 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 представляет каждую ячейку, но не имеет уникального идентификатора. Вместо этого ячейки идентифицируются по координатам строки и столбца.

обозначение A1
Синтаксис, используемый для определения ячейки или диапазона ячеек с помощью строки, содержащей имя листа, а также начальные и конечные координаты ячеек, используя буквы столбцов и номера строк. Этот метод является наиболее распространенным и удобным при обращении к абсолютному диапазону ячеек.
  • Sheet1!A1:B2 обозначает все ячейки в первых двух строках и столбцах листа Sheet1.
  • Sheet1!A:A обозначает все ячейки в первом столбце листа Sheet1.
  • Sheet1!1:2 обозначает все ячейки в первых двух строках листа Sheet1.
  • Sheet1!A5:A обозначает все ячейки первого столбца листа 1, начиная со строки 5.
  • A1:B2 обозначает все ячейки в первых двух строках и столбцах первого видимого листа.
  • Sheet1 обозначает все ячейки на листе Sheet1.
  • '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 обозначает первые две ячейки в двух верхних строках листа Sheet1.
  • R1C1:R2C2 обозначает первые две ячейки в двух верхних строках первого видимого листа.
  • Sheet1!R[3]C[1] обозначает ячейку, расположенную на три строки ниже и на один столбец правее текущей ячейки.
Именованный диапазон
Определенная ячейка или диапазон ячеек с пользовательским именем для упрощения ссылок во всем приложении. Ресурс FilterView представляет собой именованный диапазон.
Защищенный полигон
Определенная ячейка или диапазон ячеек, которые нельзя изменить. Ресурс ProtectedRange представляет собой защищенный диапазон.