Method: spreadsheets.values.batchUpdate

Define valores em um ou mais intervalos de uma planilha. O autor da chamada precisa especificar o ID da planilha, um valueInputOption e um ou mais ValueRanges.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
spreadsheetId

string

O ID da planilha a ser atualizada.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "valueInputOption": enum (ValueInputOption),
  "data": [
    {
      object (ValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
Campos
valueInputOption

enum (ValueInputOption)

Como os dados de entrada devem ser interpretados.

data[]

object (ValueRange)

Os novos valores a serem aplicados à planilha.

includeValuesInResponse

boolean

Determina se a resposta de atualização deve incluir os valores das células que foram atualizadas. Por padrão, as respostas não incluem os valores atualizados. O campo updatedData em cada um dos BatchUpdateValuesResponse.responses contém os valores atualizados. Se o intervalo a ser gravado for maior do que o intervalo realmente gravado, a resposta incluirá todos os valores do intervalo solicitado (excluindo as linhas e colunas vazias finais).

responseValueRenderOption

enum (ValueRenderOption)

Determina como os valores na resposta devem ser renderizados. A opção de renderização padrão é FORMATTED_VALUE.

responseDateTimeRenderOption

enum (DateTimeRenderOption)

Determina como as datas, as horas e as durações na resposta devem ser renderizadas. Isso será ignorado se responseValueRenderOption for FORMATTED_VALUE. A opção de renderização dateTime padrão é SERIAL_NUMBER.

Corpo da resposta

A resposta ao atualizar um intervalo de valores em uma planilha.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "spreadsheetId": string,
  "totalUpdatedRows": integer,
  "totalUpdatedColumns": integer,
  "totalUpdatedCells": integer,
  "totalUpdatedSheets": integer,
  "responses": [
    {
      object (UpdateValuesResponse)
    }
  ]
}
Campos
spreadsheetId

string

A planilha em que as atualizações foram aplicadas.

totalUpdatedRows

integer

O número total de linhas em que pelo menos uma célula foi atualizada.

totalUpdatedColumns

integer

O número total de colunas em que pelo menos uma célula foi atualizada.

totalUpdatedCells

integer

O número total de células atualizadas.

totalUpdatedSheets

integer

O número total de páginas em que pelo menos uma célula foi atualizada.

responses[]

object (UpdateValuesResponse)

Um UpdateValuesResponse por intervalo solicitado, na mesma ordem em que as solicitações apareceram.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte o Guia de autorização.