В этом разделе представлена лаборатория кода, которую вы можете использовать, чтобы познакомиться с API Google Таблиц. Также предоставляется набор примеров «рецептов», демонстрирующих, как преобразовать предполагаемое действие Google Sheets в запрос API.
Часто существует несколько способов выполнить определенную задачу с помощью API. Принимая решение о том, как подойти к задаче, имейте в виду следующее:
- Если вам нужно прочитать или записать значения ячеек, коллекция
spreadsheets.values— лучший выбор, чем коллекцияspreadsheets. Интерфейс первого проще использовать для простых операций чтения/записи. Везде, где это возможно, используйте пакетные методы (
spreadsheet.batchUpdate,spreadsheet.values.batchGetиspreadsheet.values.batchUpdate), чтобы объединить несколько запросов в один вызов метода. Использование этих пакетных методов повышает эффективность, поскольку они:- Уменьшите накладные расходы HTTP клиента.
- Уменьшите количество сделанных запросов.
- Уменьшите количество редакций документа.
- Обеспечьте атомарность всех изменений в пакете.
Рецепты
Примеры, перечисленные в этом разделе, демонстрируют, как выражать общие действия в Таблицах как запросы API Таблиц v4.
Эти примеры представлены в виде HTTP-запросов, которые не зависят от языка. Чтобы узнать, как реализовать протоколы запросов Sheets API на определенном языке с помощью клиентских библиотек Google API, см. руководства по чтению и записи значений ячеек и обновлению электронных таблиц .
Рецепты в этом разделе разделены на следующие категории:
- Базовое чтение — рецепты, показывающие, как читать значения с листа.
- Базовое письмо — рецепты, показывающие, как записывать значения на лист.
- Базовое форматирование — рецепты, показывающие, как изменить внешний вид листов и ячеек.
- Диаграммы — рецепты, показывающие, как создавать и изменять диаграммы на листе.
- Условное форматирование — рецепты, показывающие, как изменить внешний вид ячейки в зависимости от условий.
- Операции с данными — рецепты, показывающие, как создавать, перемещать и манипулировать данными в электронной таблице.
- Именованные и защищенные диапазоны — рецепты, показывающие, как создавать, обновлять и удалять именованные и защищенные диапазоны в электронной таблице.
- Сводные таблицы — рецепты, показывающие, как создавать сводные таблицы на листе.
- Операции со строками и столбцами — рецепты, показывающие, как добавлять, удалять и перемещать строки и столбцы, а также обновлять их свойства.
- Операции с листами — рецепты, показывающие, как создавать, очищать, копировать и удалять листы, а также управлять их свойствами.