Method: spreadsheets.batchUpdate

Применяет одно или несколько обновлений к электронной таблице.

Каждый request проверяется перед применением. Если какой-либо запрос недействителен, весь запрос завершится ошибкой, и ничего не будет применено.

На некоторые запросы есть replies , чтобы предоставить вам некоторую информацию о том, как они применяются. Ответы будут отражать запросы. Например, если вы применили 4 обновления, а на 3-е был ответ, то в ответе будет 2 пустых ответа, фактический ответ и еще один пустой ответ в указанном порядке.

Из-за совместной природы электронных таблиц не гарантируется, что электронная таблица будет точно отражать ваши изменения после ее завершения, однако гарантируется, что обновления в запросе будут применяться вместе атомарно. Ваши изменения могут быть изменены по отношению к изменениям соавторов. Если соавторов нет, в электронной таблице должны быть отражены ваши изменения.

HTTP-запрос

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
spreadsheetId

string

Электронная таблица, к которой применяются обновления.

Тело запроса

Тело запроса содержит данные со следующей структурой:

Представление JSON
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
Поля
requests[]

object ( Request )

Список обновлений, которые необходимо применить к электронной таблице. Запросы будут применяться в том порядке, в котором они указаны. Если какой-либо запрос недействителен, запросы не будут применяться.

includeSpreadsheetInResponse

boolean

Определяет, должен ли ответ на обновление включать ресурс электронной таблицы.

responseRanges[]

string

Ограничивает диапазоны, включенные в электронную таблицу ответов. Имеет смысл только в том случае, если includeSpreadsheetInResponse имеет значение «истина».

responseIncludeGridData

boolean

Истинно, если должны быть возвращены данные сетки. Имеет смысл только в том случае, если includeSpreadsheetInResponse имеет значение «истина». Этот параметр игнорируется, если в запросе была задана маска поля.

Тело ответа

Ответ на пакетное обновление электронной таблицы.

В случае успеха тело ответа содержит данные со следующей структурой:

Представление JSON
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  }
}
Поля
spreadsheetId

string

Электронная таблица, к которой были применены обновления.

replies[]

object ( Response )

Ответ обновлений. Это соответствует обновлениям 1:1, хотя ответы на некоторые запросы могут быть пустыми.

updatedSpreadsheet

object ( Spreadsheet )

Электронная таблица после применения обновлений. Это устанавливается, только если BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response имеет true .

Области авторизации

Требуется одна из следующих областей действия OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Дополнительные сведения см. в руководстве по авторизации .