Method: spreadsheets.values.append

Anexa valores a uma planilha. O intervalo de entrada é usado para pesquisar dados existentes e encontrar uma "tabela" nesse intervalo. Os valores serão anexados à próxima linha da tabela, começando pela primeira coluna. Consulte o guia e o exemplo de código para saber 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 à planilha (por coluna ou por linha), não influenciando a célula em que 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 pesquisar uma tabela lógica de dados. Os valores são anexados após a ú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 precisa incluir os valores das células que foram 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, os horários e as durações na resposta devem ser renderizados. Isso será ignorado se responseValueRenderOption for FORMATTED_VALUE. A opção padrão de renderização de data/hora é 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 (na notação A1) da tabela em que os valores estão sendo anexados (antes da anexação). Vazia se nenhuma tabela for encontrada.
updates

object (UpdateValuesResponse)

Informações sobre as atualizações 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 atuais são alterados quando novos dados são inseridos.

Enums
OVERWRITE Os novos dados substituem os dados atuais nas áreas em que são gravados. Observação: a adição de dados ao final da planilha ainda insere novas linhas ou colunas para que os dados possam ser gravados.
INSERT_ROWS As linhas são inseridas para os novos dados.