Method: spreadsheets.values.append

Aggiunge valori a un foglio di lavoro. L'intervallo di input viene utilizzato per cercare i dati esistenti e trovare una "tabella" all'interno di questo intervallo. I valori verranno aggiunti alla riga successiva della tabella, a partire dalla prima colonna. Per informazioni dettagliate su come vengono rilevate le tabelle e vengono aggiunti i dati, consulta la guida e il codice di esempio.

L'utente che chiama deve specificare l'ID del foglio di lavoro, l'intervallo e un valueInputOption. valueInputOption controlla solo la modalità di aggiunta dei dati di input al foglio (per riga o per colonna), ma 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

string

L'ID del foglio di lavoro da aggiornare.
range

string

La notazione A1 di un intervallo in cui cercare una tabella logica di dati. I valori vengono aggiunti dopo l'ultima riga della tabella.

Parametri di query

Parametri
valueInputOption

enum (ValueInputOption)

Come devono essere interpretati i dati di input.
insertDataOption

enum (InsertDataOption)

Come devono essere inseriti i dati di input.
includeValuesInResponse

boolean

Determina se la risposta all'aggiornamento deve includere i valori delle celle aggiunte. Per impostazione predefinita, le risposte non includono i valori aggiornati.
responseValueRenderOption

enum (ValueRenderOption)

Determina la modalità di visualizzazione dei valori nella risposta. L'opzione di rendering predefinita è FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Determina la modalità di visualizzazione di date, ore e durate nella risposta. Questo valore viene ignorato se responseValueRenderOption è FORMATTED_VALUE. L'opzione di visualizzazione predefinita per dateTime è SERIAL_NUMBER.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di ValueRange.

Corpo della risposta

La risposta all'aggiornamento di 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 (UpdateValuesResponse)
  }
}
Campi
spreadsheetId

string

Il foglio di lavoro a cui sono stati applicati gli aggiornamenti.
tableRange

string

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

object (UpdateValuesResponse)

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 all'autorizzazione.

InsertDataOption

Determina in che modo i dati esistenti vengono modificati quando vengono inseriti nuovi dati.

Enum
OVERWRITE I nuovi dati sovrascrivono i dati esistenti nelle aree in cui vengono scritti. Nota: l'aggiunta di dati alla fine del foglio inserirà comunque nuove righe o colonne in modo che i dati possano essere scritti.
INSERT_ROWS Le righe vengono inserite per i nuovi dati.