Questa sezione presenta un codelab che puoi utilizzare per acquisire familiarità con l'API Fogli Google. Viene inoltre fornito un insieme di esempi di "formula" che mostrano come tradurre un'azione prevista di Fogli Google in una richiesta API.
Spesso esistono più modi per completare una determinata attività con l'API. Quando decidi come affrontare un'attività, tieni presente quanto segue:
- Se hai bisogno di leggere o scrivere valori delle celle, la raccolta
spreadsheets.valuesè una scelta migliore rispetto alla raccoltaspreadsheets. L'interfaccia della versione precedente è più facile da utilizzare per operazioni di lettura/scrittura semplici. Se possibile, utilizza i metodi batch (
spreadsheet.batchUpdate,spreadsheet.values.batchGetespreadsheet.values.batchUpdate) per raggruppare più richieste in un'unica chiamata a metodo. L'utilizzo di questi metodi batch migliora l'efficienza in quanto:- Riduci l'overhead HTTP del client.
- Riduci il numero di query eseguite.
- Riduci il numero di revisioni del documento.
- Garantisci l'atomicità di tutte le modifiche nel batch.
Ricette
Gli esempi riportati in questa sezione mostrano come esprimere azioni comuni in Fogli sotto forma di richieste dell'API Fogli v4.
Questi esempi sono presentati sotto forma di richieste HTTP per essere neutrali dal linguaggio. Per informazioni su come implementare i protocolli di richiesta dell'API Fogli in una lingua specifica utilizzando le librerie client dell'API di Google, consulta le guide Lettura e scrittura dei valori delle celle e Aggiornamento dei 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 modificare l'aspetto di fogli e celle.
- Grafici: ricette che mostrano come creare e modificare grafici in un foglio.
- Formattazione condizionale: ricette che mostrano come modificare l'aspetto delle celle in base alle condizioni.
- Operazioni sui dati: formule che mostrano come creare, spostare e manipolare i dati in un foglio di lavoro.
- Intervalli denominati e protetti: formule che mostrano come creare, aggiornare e rimuovere intervalli denominati e protetti in un foglio di lavoro.
- Tabelle pivot: formule che mostrano come creare tabelle pivot in un foglio.
- Operazioni su righe e colonne: formule che mostrano come aggiungere, rimuovere e spostare righe e colonne, nonché come aggiornarne le proprietà.
- Operazioni per i fogli: ricette che mostrano come creare, cancellare, copiare ed eliminare fogli, nonché come controllarne le proprietà.