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 di 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 spreadsheets raccolta. L'interfaccia della prima è più facile da usare per le 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é:

  • Riduce il sovraccarico HTTP del client.
  • Riduce il numero di query eseguite.
  • Riduce il numero di revisioni del documento.
  • Garantisce l'atomicità di tutte le modifiche nel batch.

Ricette

Gli esempi elencati in questa sezione mostrano come esprimere le azioni comuni in Fogli come richieste dell'API Google Sheets v4.

Questi esempi vengono presentati sotto forma di richieste HTTP per essere indipendenti dalla lingua. Per scoprire come implementare i protocolli di richiesta dell'API Google Sheets in una lingua specifica utilizzando le librerie client delle API di Google, consulta le guide Leggere e scrivere i 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 i 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 i fogli, nonché controllarne le proprietà.