Примеры

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

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

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

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

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

Рецепты

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

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

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

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