Esempi

Questa sezione presenta un codelab che puoi utilizzare per acquisire familiarità con l'API Google Sheets. Viene inoltre fornito un insieme di esempi di "ricette" che mostrano come tradurre un'azione Google Sheets prevista 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 valori delle celle, la raccolta spreadsheets.values è una scelta migliore rispetto alla raccolta spreadsheets. L'interfaccia del primo è più facile da usare per semplici operazioni di lettura/scrittura.

  • Ove possibile, utilizza i metodi batch (spreadsheet.batchUpdate, spreadsheet.values.batchGet, e spreadsheet.values.batchUpdate) per raggruppare più richieste in una singola chiamata al metodo. L'utilizzo di questi metodi batch migliora l'efficienza perché:

    • Ridurre 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 elencati in questa sezione mostrano come esprimere azioni comuni in Fogli 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 Sheets in un linguaggio specifico utilizzando le librerie client delle 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 di 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 i grafici in un foglio.
  • Formattazione condizionale: ricette che mostrano come modificare l'aspetto delle celle in base alle 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 e come controllarne le proprietà.