Примеры

В этом разделе представлена ​​лаборатория кода, которую вы можете использовать, чтобы познакомиться с 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, см. руководства по чтению и записи значений ячеек и обновлению электронных таблиц .

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

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