Questa sezione presenta un codelab che puoi utilizzare per acquisire familiarità con l'API Fogli Google. Viene fornita anche una serie di esempi di "ricette" che mostrano come tradurre un'azione di Fogli Google in una richiesta API.
Spesso esiste più di un modo per completare una determinata attività con l'API. Quando decidi come affrontare un'attività, tieni presente quanto segue:
- Se devi leggere o scrivere i valori delle celle, la raccolta
spreadsheets.valuesè una scelta migliore rispetto alla raccoltaspreadsheets. L'interfaccia del primo è più facile da usare per semplici operazioni di lettura/scrittura. Ove possibile, utilizza i metodi batch (
spreadsheet.batchUpdate,spreadsheet.values.batchGetespreadsheet.values.batchUpdate) per raggruppare più richieste in una singola chiamata al metodo. L'utilizzo di questi metodi gruppati migliora l'efficienza in quanto:- Riduci l'overhead HTTP del client.
- Riduci il numero di query effettuate.
- Riduci il numero di revisioni del documento.
- Assicurati l'atomicità di tutte le modifiche nel batch.
Ricette
Gli esempi elencati in questa sezione mostrano come esprimere azioni comuni in Sheets come richieste dell'API Sheets v4.
Questi esempi sono presentati sotto forma di richieste HTTP per essere indipendenti dalla lingua. Per scoprire come implementare i protocolli di richiesta dell'API Fogli in un linguaggio specifico utilizzando le librerie client dell'API Google, consulta le guide Leggere e scrivere valori delle celle e Aggiornare i fogli di lavoro.
Le ricette in questa sezione sono suddivise nelle seguenti categorie:
- Lettura di base: ricette che mostrano come leggere i valori da un foglio.
- Scrittura di base: ricette che mostrano come scrivere valori in un foglio.
- Formattazione di base: ricette che mostrano come cambiare l'aspetto di fogli e celle.
- Grafici: ricette che mostrano come creare e modificare i grafici in un foglio.
- Formattazione condizionale: ricette che mostrano come modificare l'aspetto delle celle in base a condizioni.
- Operazioni sui dati: ricette che mostrano come creare, spostare e manipolare i dati in un foglio di lavoro.
- Intervalli denominati e protetti: ricette che mostrano come creare, aggiornare e rimuovere intervalli denominati e protetti in un foglio di lavoro.
- Tabelle pivot: ricette che mostrano come creare tabelle pivot in un foglio.
- Operazioni su righe e colonne: ricette che mostrano come aggiungere, rimuovere e spostare righe e colonne e aggiornarne le proprietà.
- Operazioni sui fogli: ricette che mostrano come creare, cancellare, copiare ed eliminare fogli, nonché controllare le relative proprietà.