Questa guida descrive come e perché utilizzare l'API Fogli Google 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 a tabelle e nomi di 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 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" in range specificato con due colonne impostate. Una colonna percentuale nella prima colonna e un tipo di colonna con menu 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 colonna come numerico, data, menu a discesa, smart chip, casella di controllo. I tipi di colonna di valutazione e casella di controllo vengono compilati con i valori predefiniti 0 e FALSE.
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 dropdown, dataValidationRule per la colonna deve essere impostato con una condizione ONE_OF_LIST. Per gli altri tipi di colonne non è necessario 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 di una tabella, puoi utilizzare DeleteRangeRequest in caso contrario, 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, range si espande di 1 riga. Se stai aggiornando una tabella esistente con un piè di pagina
e lo rimuovi, range si riduce di 1 riga.
Aggiungere 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 sono consapevoli di righe e piè di pagina completi. Se non sono presenti righe vuote, le righe vengono inserite alla fine della tabella e prima di eventuali piè di pagina, se applicabili.
Eliminazione di una tabella
Utilizza il metodo spreadsheets.batchUpdate 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.
Utilizzare le tabelle con altre funzionalità di Fogli
Altre funzionalità dell'API che supportano le tabelle come dati di supporto includono filtri, visualizzazioni filtrate e intervalli protetti.