Questa guida descrive come e perché utilizzare l'API Google Sheets per creare tabelle nei fogli di lavoro.
Che cos'è una tabella?
Con le tabelle, puoi semplificare la creazione dei dati e ridurre la necessità di formattare, inserire e aggiornare ripetutamente i dati applicando automaticamente formato e struttura a intervalli di dati.
Le tabelle hanno molte funzionalità, come intestazioni, piè di pagina, tipi di colonne, filtri, visualizzazioni, riferimenti e nomi. Scopri di più nell'annuncio della funzionalità e scopri come utilizzare le tabelle in Fogli.
Puoi utilizzare le tabelle per attività come il monitoraggio dei progetti, la pianificazione di eventi e la gestione dell'inventario.
Aggiungi una tabella
Per aggiungere una tabella, utilizza il metodo batchUpdate, fornendo una richiesta addTable. Utilizza questa richiesta per aggiungere una tabella al foglio di lavoro.
Il seguente esempio crea una tabella denominata "Project Tracker" nel percorso
range specificato con due colonne impostate. Una colonna con percentuale nella prima colonna e una colonna
di tipo elenco a discesa nella seconda colonna.
{
"addTable": {
"table": {
"name": "Project Tracker",
"tableId": "123",
"range": {
"sheetId": 0,
"startColumnIndex": 0,
"endColumnIndex": 5,
"startRowIndex": 0,
"endRowIndex": 5,
},
"columnProperties": [
{
"columnIndex": 0,
"columnName": "Column 1",
"columnType": "PERCENT"
},
{
"columnIndex": 1,
"columnName": "Column 2",
"columnType": "DROPDOWN",
"dataValidationRule": {
"condition": {
"type": "ONE_OF_LIST",
"values": [
{
"userEnteredValue": "Not Started"
},
{
"userEnteredValue": "In Progress"
},
{
"userEnteredValue": "Complete"
}
]
}
}
}
],
}
}
}
Tipi di colonne
Le tabelle hanno tipi di colonne come numerico, data, menu a discesa, smart chip, casella di controllo. I tipi di colonna valutazione e casella di controllo vengono compilati con i valori predefiniti 0 e FALSE rispettivamente.
Tipo di colonna a discesa
Il tipo di colonna menu a discesa crea un menu a discesa con chip. Se un tipo di colonna è impostato come
menu a discesa, la dataValidationRule per la colonna deve essere impostata con una
condizione ONE_OF_LIST. Gli altri tipi di colonne non devono impostare il campo `dataValidationRule`.
Aggiornare una tabella
Utilizza il metodo spreadsheets.batchUpdate
e fornisci un UpdateTableRequest.
Modificare le dimensioni della tabella
Utilizza il metodo UpdateTableRequest
per modificare il range che la tabella deve aggiungere nuove righe/colonne.
Se devi aggiungere una nuova riga o colonna all'interno della tabella, utilizza InsertRangeRequest o InsertDimensionRequest.
Se devi eliminare una riga della tabella, puoi utilizzare DeleteRangeRequest altrimenti puoi utilizzare DeleteDimensionRequest per eliminare un'intera riga dal foglio di lavoro.
Attiva/disattiva il piè di pagina della tabella
Se stai aggiornando una tabella esistente senza un piè di pagina per aggiungerne uno, il
range si espande di una riga. Se stai aggiornando una tabella esistente con un piè di pagina
e lo rimuovi, range si riduce di una riga.
Aggiungere valori a una tabella
Utilizza AppendCellsRequest
con tableId per aggiungere righe alla fine di una tabella. Aggiunge i valori alla
prima riga libera ed è a conoscenza di righe complete e piè di pagina. Se non sono presenti righe vuote, vengono inserite righe alla fine della tabella e prima di qualsiasi piè di pagina, se applicabile.
Eliminazione di una tabella
Utilizza il metodo spreadsheets.batchUpdate e fornisci una DeleteTableRequest.
Utilizza DeleteTableRequest
per eliminare l'intera tabella e i relativi contenuti.
Utilizza DeleteBandingRequest per rimuovere la formattazione della tabella, ma conservare i dati.
Utilizzare le tabelle con altre funzionalità di Fogli
Altre funzionalità API che supportano le tabelle come dati di base includono filtri, visualizzazioni filtrate e intervalli protetti.