- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- Запрос
- Запрос свойств электронной таблицы
- Упдейтшитпропертиесрекуест
- ОбновлениеDimensionPropertiesRequest
- DataSourceSheetDimensionRange
- ОбновлениеНамедРангерекуест
- повторите запрос ячейки
- Адднамедранжрекуест
- УдалитьНамедРангерекуест
- Аддшитрекуест
- Удалить ЛистЗапрос
- автозаполнениезапрос
- Источник и место назначения
- ВырезатьВставитьЗапрос
- PasteType
- КопироватьВставитьЗапрос
- ВставитьОриентация
- MergeCellsRequest
- Тип слияния
- UnmergeCellsRequest
- Упдейбордерсрекуест
- апдейтселлсрекуест
- Аддфилтервиеврекуест
- AppendCellsRequest
- Клирбасикфилтеррекуест
- DeleteDimensionRequest
- УдалитьEmbeddedObjectRequest
- Удалить фильтрвиеврекуест
- ДубликатФилтервиеврекуест
- Дубликатлистрекуест
- FindReplaceRequest
- Инсертименсионрекуест
- Инсерранжерекуест
- MoveDimensionRequest
- UpdateEmbeddedObjectPositionRequest
- Вставитьдатарекуест
- Тексттоколумнсрекуест
- Тип разделителя
- Обновить фильтрвиеврекуест
- УдалитьRangeRequest
- AppendDimensionRequest
- Аддкондиционалформатрулерекуест
- Упдейкондиционалформатрулерекуест
- DeleteConditionalFormatRuleRequest
- SortRangeRequest
- Сетдатавалидатионрекуест
- Сетбасикфилтеррекуест
- Аддпротектедранжерекуест
- Упдейтепротектедранжерекуест
- Удалитьпротектедранжрекуест
- AutoResizeDimensionsRequest
- Аддчартрекуест
- ОбновитьChartSpecRequest
- Упдейбандингрекуест
- Аддбандингрекуест
- Удалитьбандингрекуест
- CreateDeveloperMetadataRequest
- UpdateDeveloperMetadataRequest
- DeleteDeveloperMetadataRequest
- RandomizeRangeRequest
- AddDimensionGroupRequest
- УдалитьDimensionGroupRequest
- ОбновлениеDimensionGroupRequest
- TrimWhitespaceRequest
- УдалитьДупликатесЗапрос
- апдейтэмбеддедобжектбордеррекуест
- AddSlicerRequest
- ОбновлениеSlicerSpecRequest
- Адддатасаурцерекуест
- апдейтдатасаурцерекуест
- Удалить источник данных
- Обновить источник данных
- DataSourceObjectReferences
- DataSourceObjectReference
- Ответ
- Адднамедранжереспонсе
- AddSheetResponse
- АддФильтервиевреспонсор
- ДубликатФилтервиевреспонсе
- Двойной лист ответа
- FindReplaceResponse
- UpdateEmbeddedObjectPositionResponse
- Упдейкондиционалформатрулереспонсе
- DeleteConditionalFormatRuleResponse
- Аддпротектедранжереспонсе
- Аддчартответ
- AddBandingResponse
- CreateDeveloperMetadataResponse
- UpdateDeveloperMetadataResponse
- DeleteDeveloperMetadataResponse
- Адддименсионграупреспонсе
- DeleteDimensionGroupResponse
- TrimWhitespaceResponse
- УдалитьДупликатесОтклик
- AddSlicerResponse
- Адддатасаурцереспонсе
- Упдейдатааурцереспонсе
- Обновитьдатасаурцереспонсе
- RefreshDataSourceObjectExecutionStatus
- Попробуй это!
Применяет одно или несколько обновлений к электронной таблице.
Каждый request
проверяется перед применением. Если какой-либо запрос недействителен, весь запрос завершится ошибкой, и ничего не будет применено.
На некоторые запросы есть replies
, чтобы предоставить вам некоторую информацию о том, как они применяются. Ответы будут отражать запросы. Например, если вы применили 4 обновления, а на 3-е был ответ, то в ответе будет 2 пустых ответа, фактический ответ и еще один пустой ответ в указанном порядке.
Из-за совместной природы электронных таблиц не гарантируется, что электронная таблица будет точно отражать ваши изменения после ее завершения, однако гарантируется, что обновления в запросе будут применяться вместе атомарно. Ваши изменения могут быть изменены по отношению к изменениям соавторов. Если соавторов нет, в электронной таблице должны быть отражены ваши изменения.
HTTP-запрос
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
spreadsheetId | Электронная таблица, к которой применяются обновления. |
Тело запроса
Тело запроса содержит данные со следующей структурой:
Представление JSON |
---|
{
"requests": [
{
object ( |
Поля | |
---|---|
requests[] | Список обновлений, которые необходимо применить к электронной таблице. Запросы будут применяться в том порядке, в котором они указаны. Если какой-либо запрос недействителен, запросы не будут применяться. |
includeSpreadsheetInResponse | Определяет, должен ли ответ на обновление включать ресурс электронной таблицы. |
responseRanges[] | Ограничивает диапазоны, включенные в электронную таблицу ответов. Имеет смысл только в том случае, если |
responseIncludeGridData | Истинно, если должны быть возвращены данные сетки. Имеет смысл только в том случае, если |
Тело ответа
Ответ на пакетное обновление электронной таблицы.
В случае успеха тело ответа содержит данные со следующей структурой:
Представление JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Поля | |
---|---|
spreadsheetId | Электронная таблица, к которой были применены обновления. |
replies[] | Ответ обновлений. Это соответствует обновлениям 1:1, хотя ответы на некоторые запросы могут быть пустыми. |
updatedSpreadsheet | Электронная таблица после применения обновлений. Это устанавливается, только если |
Области авторизации
Требуется одна из следующих областей действия OAuth:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
Дополнительные сведения см. в руководстве по авторизации .