Method: spreadsheets.values.append

Anexa valores a uma planilha. O intervalo de entrada é usado para pesquisar dados existentes e encontrar uma "tabela" dentro desse intervalo. Os valores serão anexados na próxima linha da tabela, começando pela primeira coluna. Consulte o guia e o exemplo de código para ver detalhes específicos sobre como as tabelas são detectadas e os dados são anexados.

O autor da chamada precisa especificar o ID da planilha, o intervalo e um valueInputOption. O valueInputOption controla apenas como os dados de entrada serão adicionados à página (por coluna ou linha). Ele não influencia em qual célula os dados começam a ser gravados.

Solicitação HTTP

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

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 de um intervalo para procurar uma tabela lógica de dados. Os valores são anexados depois da última linha da tabela.

Parâmetros de consulta

Parâmetros
valueInputOption

enum (ValueInputOption)

Como os dados de entrada devem ser interpretados.

insertDataOption

enum (InsertDataOption)

Como os dados de entrada devem ser inseridos.

includeValuesInResponse

boolean

Determina se a resposta de atualização deve incluir os valores das células anexadas. Por padrão, as respostas não incluem os valores atualizados.

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 solicitação

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

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,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
Campos
spreadsheetId

string

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

tableRange

string

O intervalo (em notação A1) da tabela à qual os valores estão sendo anexados (antes dos valores serem anexados). Vai ser vazio se nenhuma tabela for encontrada.

updates

object (UpdateValuesResponse)

Informações sobre as atualizações que foram aplicadas.

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.

InsertDataOption

Determina como os dados existentes são alterados quando novos dados são inseridos.

Enums
OVERWRITE Os novos dados substituem os dados existentes nas áreas em que estão gravados. Observação: ao adicionar dados ao final da planilha, novas linhas ou colunas ainda serão inseridas para que os dados possam ser gravados.
INSERT_ROWS As linhas são inseridas para os novos dados.