Помимо данных, содержащихся в ячейках, электронная таблица включает в себя множество других типов данных, таких как:
- Размеры
- Форматы ячеек и границы
- Именованные диапазоны
- Охраняемые полигоны
- Условное форматирование
Это лишь некоторые из множества типов данных, которые управляют внешним видом и работой электронной таблицы. Метод spreadsheets.batchUpdate позволяет обновлять любые из этих данных электронной таблицы. Изменения группируются в пакет, так что если один запрос не удался, никакие другие (потенциально зависимые) изменения не будут записаны.
На этой странице описаны основы использования метода spreadsheets.batchUpdate . Если вам необходимо читать и записывать данные значений ячеек, вы также можете использовать ресурс spreadsheets.values описанный в разделе «Чтение и запись значений ячеек» .
Категории операций
Конкретные операции, поддерживаемые функцией spreadsheets.batchUpdate можно сгруппировать в следующие широкие категории:
| Категория | Описание |
|---|---|
| Добавить (и продублировать ) | Добавление новых объектов (иногда на основе старых, как в случае с дублирующимися запросами). |
| Обновить (и установить ) | Обновить определенные свойства объекта, обычно оставляя старые свойства без изменений (в то время как запрос Set перезаписывает предыдущие данные). |
| Удалить | Удалите объекты. |
В следующем разделе эти категории используются для описания поведения конкретных операций.
Операции пакетного обновления
Метод spreadsheets.batchUpdate принимает один или несколько объектов Request , каждый из которых определяет тип выполняемого запроса. Существует множество различных типов запросов. Ниже приведено описание типов запросов, сгруппированных по различным категориям.
Также существуют дополнительные запросы, имитирующие действия пользователя по манипулированию данными:
- AutoFillRequest
- CutPasteRequest
- КопироватьЗапрос
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Пределы
Чтобы узнать больше об ограничениях на количество ячеек и строк в Google Таблицах, см. раздел «Файлы, которые можно хранить в Google Диске» .
Полевые маски
Многие запросы на обновление требуют использования масок полей. Это список полей, разделенных запятыми, для обновления только определенных полей объекта, оставляя остальные поля без изменений. Маска поля * рассматривается как подстановочный знак и является сокращенным способом указания каждого поля в сообщении (это означает, что поле может вернуться в свое состояние по умолчанию, если вы не укажете для него значение в запросе). Для получения дополнительной информации о масках полей см. раздел «Использование масок полей» .
В следующем примере используется метод UpdateSpreadsheetPropertiesRequest для обновления только заголовка электронной таблицы:
Запрос:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
Текст запроса:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
Замените TITLE на новое название электронной таблицы.
Ответы
При обновлении электронной таблицы некоторые типы запросов могут возвращать ответы. Ответы возвращаются в виде массива, причем каждый ответ занимает тот же индекс, что и соответствующий запрос. Некоторые запросы не имеют ответов, и для них ответ является пустым.
Как правило, запросы на добавление (add) получают в ответ информацию, например, идентификатор добавляемого объекта. Список поддерживаемых ответов см. в разделе « Ответы ».
Пример
Приведенный ниже пример кода выполняет следующие действия:
- Обновляет заголовок электронной таблицы, используя переменную
title. - Находит и заменяет значения ячеек в электронной таблице, используя переменные
findиreplacement.