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 à próxima linha da tabela, começando com a primeira coluna da tabela. Consulte o guia e o exemplo de código para 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 à planilha (por coluna ou linha), mas 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 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 deve 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 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

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 à qual as atualizações foram aplicadas.
tableRange

string

O intervalo (em notação A1) da tabela ao 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 atuais são alterados quando novos dados são inseridos.

Enums
OVERWRITE Os novos dados substituem os dados existentes nas áreas em que foram gravados. Observação: adicionar dados ao fim da página ainda insere novas linhas ou colunas para que eles possam ser gravados.
INSERT_ROWS As linhas são inseridas para os novos dados.