Примеры

В этом разделе представлена практическая работа, которую вы можете использовать для знакомства с API Google Таблиц. Также представлен набор примеров-«рецептов», демонстрирующих, как преобразовать предполагаемое действие Google Таблиц в запрос к API.

Часто существует несколько способов выполнить задачу с помощью API. При выборе подхода к решению задачи имейте в виду следующее:

• Если вам нужно читать или записывать значения ячеек, коллекция spreadsheets.values — лучший выбор, чем коллекция spreadsheets . Интерфейс первой более удобен для простых операций чтения/записи.

• По возможности используйте пакетные методы ( spreadsheet.batchUpdate , spreadsheet.values.batchGet и spreadsheet.values.batchUpdate ) для объединения нескольких запросов в один вызов метода. Использование этих пакетных методов повышает эффективность, поскольку они:

  • Сокращение накладных расходов на HTTP-запросы со стороны клиента.
  • Сократите количество запросов.
  • Сократите количество правок в документе.
  • Обеспечить атомарность всех изменений в пакете.

Рецепты

Примеры, перечисленные в этом разделе, демонстрируют, как выражать общие действия в Таблицах в виде запросов Sheets API v4.

Эти примеры представлены в виде HTTP-запросов, чтобы не зависеть от языка. Чтобы узнать, как реализовать протоколы запросов API Таблиц на определённом языке с помощью клиентских библиотек API Google, см. руководства « Чтение и запись значений ячеек» и «Обновление электронных таблиц» .

Рецепты в этом разделе разделены на следующие категории:

• Базовая литература — рецепты, показывающие, как считывать значения с листа.
• Основы письма — рецепты, показывающие, как записывать значения на лист.
• Базовое форматирование — рецепты, показывающие, как изменить внешний вид листов и ячеек.
• Диаграммы — рецепты, показывающие, как создавать и изменять диаграммы на листе.
• Условное форматирование — рецепты, показывающие, как изменить внешний вид ячейки в зависимости от условий.
• Операции с данными — рецепты, показывающие, как создавать, перемещать и обрабатывать данные в электронной таблице.
• Именованные и защищенные диапазоны — рецепты, показывающие, как создавать, обновлять и удалять именованные и защищенные диапазоны в электронной таблице.
• Сводные таблицы — рецепты, показывающие, как создавать сводные таблицы на листе.
• Операции со строками и столбцами — рецепты, показывающие, как добавлять, удалять и перемещать строки и столбцы, а также обновлять их свойства.
• Операции с листами — рецепты, показывающие, как создавать, очищать, копировать и удалять листы, а также управлять их свойствами.