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

API Google Таблиц — это RESTful-интерфейс, позволяющий читать и изменять данные в электронных таблицах. 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. Аналогично, «Лист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 .