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

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

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

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

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

Основной объект в Google Sheets, который может содержать несколько листов, каждый со структурированной информацией, содержащейся в ячейках. Ресурс Spreadsheet представляет каждую электронную таблицу и имеет уникальное значение spreadsheetId , содержащее буквы, цифры, дефисы или символы подчеркивания. Вы можете найти идентификатор электронной таблицы в URL-адресе Google Sheets:

https://docs.google.com/spreadsheets/d/ spreadsheetId /edit#gid=0

Лист

Страница или вкладка в электронной таблице. Ресурс Sheet представляет каждый лист и имеет уникальный заголовок и числовое значение sheetId . Вы можете найти идентификатор листа в URL-адресе Google Sheets:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid= sheetId

Клетка

Отдельное поле текста или данных на листе. Ячейки расположены в строках и столбцах и могут быть сгруппированы как диапазон ячеек. Ресурс CellData представляет каждую ячейку, но не имеет уникального значения идентификатора. Вместо этого координаты строк и столбцов идентифицируют ячейки.

Обозначение А1

Синтаксис, используемый для определения ячейки или диапазона ячеек с помощью строки, содержащей имя листа, а также координаты начальной и конечной ячейки с использованием букв столбцов и номеров строк. Этот метод является наиболее распространенным и полезным при ссылке на абсолютный диапазон ячеек.

Показать примеры

  • Sheet1!A1:B2 относится к первым двум ячейкам в двух верхних строках Sheet1.
  • Sheet1!A:A относится ко всем ячейкам в первом столбце Sheet1.
  • Sheet1!1:2 относится ко всем ячейкам в первых двух строках листа Лист1.
  • Sheet1!A5:A относится ко всем ячейкам первого столбца Листа 1, начиная со строки 5.
  • A1:B2 относится к первым двум ячейкам в двух верхних строках первого видимого листа.
  • Sheet1 относится ко всем ячейкам в Sheet1.
  • 'My Custom Sheet'!A:A относится ко всем ячейкам в первом столбце листа с именем «Мой пользовательский лист». Одинарные кавычки необходимы для имен листов с пробелами, специальными символами или буквенно-цифровой комбинацией.
  • 'My Custom Sheet' относится ко всем ячейкам в «Моем пользовательском листе».

Совет . По возможности используйте разные имена для объектов в электронных таблицах. Например, A1 относится к ячейке A1 на первом видимом листе, тогда как «A1» относится ко всем ячейкам на листе с именем A1. Точно так же Sheet1 относится ко всем ячейкам в Sheet1. Однако если имеется именованный диапазон с названием «Лист1», то «Лист1» относится к именованному диапазону, а «Лист1» — к листу.

нотация R1C1

Синтаксис, используемый для определения ячейки или диапазона ячеек с помощью строки, содержащей имя листа, а также координаты начальной и конечной ячеек с использованием номеров строк и номеров столбцов. Этот метод менее распространен, чем нотация A1, но может быть полезен при ссылке на диапазон ячеек относительно данной позиции ячейки.

Показать примеры

  • Sheet1!R1C1:R2C2 относится к первым двум ячейкам в двух верхних строках Sheet1.
  • R1C1:R2C2 относится к первым двум ячейкам в двух верхних строках первого видимого листа.
  • Sheet1!R[3]C[1] относится к ячейке, которая находится на три строки ниже и на один столбец справа от текущей ячейки.
Именованный диапазон

Определенная ячейка или диапазон ячеек с настраиваемым именем для упрощения ссылок в приложении. Ресурс FilterView представляет собой именованный диапазон.

Защищенный диапазон

Определенная ячейка или диапазон ячеек, которые нельзя изменить. Ресурс ProtectedRange представляет защищенный диапазон.

Следующие шаги

  • Чтобы узнать о разработке с помощью API Google Workspace, включая обработку аутентификации и авторизации, см. раздел Разработка в Google Workspace .

  • Чтобы узнать, как настроить и запустить простое приложение API Таблиц, прочитайте обзор Quickstarts .