- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- InsertDataOption
- Faça um teste
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 |
O ID da planilha a ser atualizada. |
range |
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 |
Como os dados de entrada devem ser interpretados. |
insertDataOption |
Como os dados de entrada devem ser inseridos. |
includeValuesInResponse |
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 |
Determina como os valores na resposta devem ser renderizados. A opção de renderização padrão é |
responseDateTimeRenderOption |
Determina como as datas, as horas e as durações na resposta devem ser renderizadas. Isso será ignorado se |
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 ( |
Campos | |
---|---|
spreadsheetId |
A planilha em que as atualizações foram aplicadas. |
tableRange |
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 |
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. |