Method: spreadsheets.values.update

Define valores em um intervalo de uma planilha. O autor da chamada precisa especificar o ID da planilha, o intervalo e um valueInputOption.

Solicitação HTTP

PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

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

Parâmetros de caminho

Parâmetros
spreadsheetId

string

O ID da planilha a ser atualizada.

range

string

A notação A1 dos valores a serem atualizados.

Parâmetros de consulta

Parâmetros
valueInputOption

enum (ValueInputOption)

Como os dados de entrada devem ser interpretados.

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. Se o intervalo a ser gravado for maior do que o intervalo gravado, a resposta incluirá todos os valores do intervalo solicitado (excluindo linhas e colunas vazias no final).

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, os horários e as durações na resposta devem ser renderizados. Isso será ignorado se responseValueRenderOption for FORMATTED_VALUE. A opção de renderização padrão de dateTime é SERIAL_NUMBER.

Corpo da solicitação

O corpo da solicitação contém uma instância de ValueRange.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de UpdateValuesResponse.

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.