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