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 código de exemplo 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 à planilha (em colunas ou em linhas). Não influencia 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 código 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 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 da 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 datas, horas e durações na resposta devem ser renderizadas. Isso será ignorado se responseValueRenderOption for FORMATTED_VALUE. A opção de renderização padrão de data e 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 à qual 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). Vazio se nenhuma tabela foi encontrada.
updates

object (UpdateValuesResponse)

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

Escopos de autorização

Requer um dos seguintes escopos de 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 dados novos são inseridos.

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