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 alle tabelle e nomi delle tabelle. 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 degli eventi e la gestione dell'inventario.
Aggiungi una tabella
Per aggiungere una tabella, utilizza il batchUpdate, fornendo una richiesta addTable. Utilizza questa richiesta per aggiungere una tabella al foglio di lavoro.
L'esempio seguente crea una tabella denominata "Project Tracker" nell'intervallo range specificato con 2 colonne impostate. Una colonna percentuale nella prima colonna e un tipo di colonna 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 colonna
Le tabelle hanno tipi di colonne come numerico, data, menu a discesa, smart chip, casella di controllo. I tipi di colonne di valutazione e casella di controllo vengono compilati con i valori predefiniti 0 e FALSE, rispettivamente.
Tipo di colonna a discesa
Il tipo di colonna a discesa crea un menu a discesa con chip. Se un tipo di colonna è impostato come menu a discesa, il dataValidationRule per la colonna deve essere impostato con una condizione ONE_OF_LIST. Altri tipi di colonne non devono impostare il campo `dataValidationRule.
Aggiorna una tabella
Utilizza il spreadsheets.batchUpdate
metodo e fornisci un UpdateTableRequest.
Modifica 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 la InsertRangeRequest o la InsertDimensionRequest
Se devi eliminare una riga della tabella, puoi utilizzare DeleteRangeRequest In alternativa, 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 piè di pagina per aggiungerne uno, l'range si espande di una riga. Se stai aggiornando una tabella esistente con un piè di pagina e lo rimuovi, l'range si riduce di una riga.
Aggiungi valori a una tabella
Utilizza AppendCellsRequest
con tableId per aggiungere righe alla fine di una tabella. In questo modo, i valori vengono aggiunti alla prima riga libera e vengono riconosciute le righe complete e i piè di pagina. Se non sono presenti righe vuote, le righe vengono inserite alla fine della tabella e prima di qualsiasi piè di pagina, se applicabile.
Elimina una tabella
Utilizza il spreadsheets.batchUpdate
metodo e fornisci un
DeleteTableRequest.
Utilizza DeleteTableRequest
per eliminare l'intera tabella e i relativi contenuti.
Utilizza DeleteBandingRequest per rimuovere la formattazione della tabella, ma conservare i dati.
Utilizza le tabelle con altre funzionalità di Fogli
Altre funzionalità dell'API che supportano le tabelle come dati di backup includono filtri, visualizzazioni filtro e intervalli protetti.