- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- InsertDataOption
- Prova!
Aggiunge valori a un foglio di lavoro. L'intervallo di input viene utilizzato per cercare dati esistenti e trovare una "tabella" al suo interno. I valori verranno aggiunti alla riga successiva della tabella a partire dalla prima colonna della tabella. Per dettagli specifici su come vengono rilevate le tabelle e aggiunti i dati, consulta la guida e il codice campione.
Il chiamante deve specificare l'ID del foglio di lavoro, l'intervallo e un valueInputOption
. valueInputOption
controlla solo il modo in cui i dati di input verranno aggiunti al foglio (a livello di colonna o di riga), non influisce sulla cella in cui iniziano a essere scritti i dati.
Richiesta HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
spreadsheetId |
L'ID del foglio di lavoro da aggiornare. |
range |
La notazione A1 di un intervallo per la ricerca di una tabella logica di dati. I valori vengono aggiunti dopo l'ultima riga della tabella. |
Parametri di ricerca
Parametri | |
---|---|
valueInputOption |
Come devono essere interpretati i dati di input. |
insertDataOption |
Modalità di inserimento dei dati di input. |
includeValuesInResponse |
Determina se la risposta di aggiornamento deve includere i valori delle celle che sono state aggiunte. Per impostazione predefinita, le risposte non includono i valori aggiornati. |
responseValueRenderOption |
Determina il rendering dei valori nella risposta. L'opzione di rendering predefinita è |
responseDateTimeRenderOption |
Determina come devono essere visualizzati le date, gli orari e le durate della risposta. Questa impostazione viene ignorata se |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di ValueRange
.
Corpo della risposta
La risposta quando si aggiorna un intervallo di valori in un foglio di lavoro.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
Campi | |
---|---|
spreadsheetId |
Il foglio di lavoro a cui sono stati applicati gli aggiornamenti. |
tableRange |
L'intervallo (in notazione A1) della tabella a cui vengono aggiunti i valori (prima dell'aggiunta dei valori). Vuoto se non è stata trovata alcuna tabella. |
updates |
Informazioni sugli aggiornamenti applicati. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Per ulteriori informazioni, consulta la Guida alle autorizzazioni.
Inserisci dati
Determina il modo in cui i dati esistenti vengono modificati quando vengono inseriti nuovi dati.
Enum | |
---|---|
OVERWRITE |
I nuovi dati sovrascriveranno i dati esistenti nelle aree in cui sono scritti. Nota: se aggiungi i dati alla fine del foglio, verranno comunque inserite nuove righe o colonne in modo che i dati possano essere scritti. |
INSERT_ROWS |
Vengono inserite righe per i nuovi dati. |