Образцы

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

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

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