Esempi

Questa sezione presenta un codelab che puoi utilizzare per acquisire familiarità con l'API Fogli Google. Vengono inoltre forniti una serie di esempi di "ricetta" che mostrano come tradurre un'azione prevista di Fogli Google in una richiesta API.

Spesso sono disponibili più modi per completare una determinata attività con l'API. Quando scegli l'approccio da seguire per un'attività, tieni presente quanto segue:

• Se devi leggere o scrivere valori delle celle, la raccolta spreadsheets.values è una scelta migliore rispetto alla raccolta spreadsheets. L'interfaccia precedente è più facile da utilizzare per semplici operazioni di lettura/scrittura.

• Se possibile, utilizza i metodi batch (spreadsheet.batchUpdate, spreadsheet.values.batchGet e spreadsheet.values.batchUpdate) per raggruppare più richieste in un'unica chiamata al metodo. L'utilizzo di questi metodi batch migliora l'efficienza in quanto:

  • Riduci l'overhead HTTP del client.
  • Riduci il numero di query effettuate.
  • Riduci il numero di revisioni del documento.
  • Garantisci l'atomicità di tutte le modifiche nel batch.

Formule

Gli esempi elencati in questa sezione mostrano come esprimere le azioni comuni in Fogli sotto forma di richieste dell'API Fogli v4.

Questi esempi vengono presentati sotto forma di richieste HTTP per essere indipendenti dal linguaggio. Per informazioni su come implementare i protocolli di richiesta dell'API Fogli in un linguaggio specifico utilizzando le librerie client dell'API di Google, consulta le guide Lettura e scrittura di valori delle celle e Aggiorna 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: formule 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: 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: formule che mostrano come aggiungere, rimuovere e spostare righe e colonne e come aggiornarne le proprietà.
• Operazioni sui fogli: formule che mostrano come creare, cancellare, copiare ed eliminare fogli, nonché come controllarne le proprietà.