Questa pagina è stata tradotta dall'API Cloud Translation.

Class Spreadsheet

Accedere ai file Fogli Google e modificarli. Le operazioni comuni sono l'aggiunta di nuovi fogli e di collaboratori.

Metodi

Metodo	Tipo restituito	Breve descrizione
`addDeveloperMetadata(key)`	`Spreadsheet`	Aggiunge i metadati dello sviluppatore con la chiave specificata al foglio di lavoro di primo livello.
`addDeveloperMetadata(key, visibility)`	`Spreadsheet`	Aggiunge al foglio di lavoro i metadati dello sviluppatore con la chiave e la visibilità specificate.
`addDeveloperMetadata(key, value)`	`Spreadsheet`	Aggiunge al foglio di lavoro i metadati dello sviluppatore con la chiave e il valore specificati.
`addDeveloperMetadata(key, value, visibility)`	`Spreadsheet`	Aggiunge al foglio di lavoro i metadati dello sviluppatore con la chiave, il valore e la visibilità specificati.
`addEditor(emailAddress)`	`Spreadsheet`	Aggiunge l'utente specificato all'elenco degli editor per `Spreadsheet`.
`addEditor(user)`	`Spreadsheet`	Aggiunge l'utente specificato all'elenco degli editor per `Spreadsheet`.
`addEditors(emailAddresses)`	`Spreadsheet`	Aggiunge l'array di utenti specificato all'elenco degli editor del `Spreadsheet`.
`addMenu(name, subMenus)`	`void`	Crea un nuovo menu nella UI del foglio di lavoro.
`addViewer(emailAddress)`	`Spreadsheet`	Aggiunge l'utente specificato all'elenco degli spettatori di `Spreadsheet`.
`addViewer(user)`	`Spreadsheet`	Aggiunge l'utente specificato all'elenco degli spettatori di `Spreadsheet`.
`addViewers(emailAddresses)`	`Spreadsheet`	Aggiunge l'array di utenti specificato all'elenco dei visualizzatori di `Spreadsheet`.
`appendRow(rowContents)`	`Sheet`	Aggiunge una riga in fondo all'area dati corrente del foglio.
`autoResizeColumn(columnPosition)`	`Sheet`	Imposta la larghezza della colonna specificata in modo che si adatti ai contenuti.
`copy(name)`	`Spreadsheet`	Copia il foglio di lavoro e restituisce quello nuovo.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Restituisce un `DeveloperMetadataFinder` per trovare i metadati dello sviluppatore nell'ambito di questo foglio di lavoro.
`createTextFinder(findText)`	`TextFinder`	Crea un cercatore di testo per il foglio di lavoro, che può essere utilizzato per trovare e sostituire testo all'interno del foglio di lavoro.
`deleteActiveSheet()`	`Sheet`	Elimina il foglio attualmente attivo.
`deleteColumn(columnPosition)`	`Sheet`	Elimina la colonna nella posizione specificata.
`deleteColumns(columnPosition, howMany)`	`void`	Elimina un numero di colonne a partire dalla posizione della colonna specificata.
`deleteRow(rowPosition)`	`Sheet`	Elimina la riga nella posizione specificata.
`deleteRows(rowPosition, howMany)`	`void`	Elimina un numero di righe a partire dalla posizione della riga specificata.
`deleteSheet(sheet)`	`void`	Elimina il foglio specificato.
`duplicateActiveSheet()`	`Sheet`	Duplica il foglio attivo e lo imposta come foglio attivo.
`getActiveCell()`	`Range`	Restituisce la cella attiva in questo foglio.
`getActiveRange()`	`Range`	Restituisce l'intervallo selezionato nel foglio attivo o `null` se non è presente alcun intervallo attivo.
`getActiveRangeList()`	`RangeList`	Restituisce l'elenco degli intervalli attivi nel foglio attivo o `null` se non sono presenti intervalli attivi.
`getActiveSheet()`	`Sheet`	Restituisce il foglio attivo in un foglio di lavoro.
`getAs(contentType)`	`Blob`	Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
`getBandings()`	`Banding[]`	Restituisce tutte le bande in questo foglio di lavoro.
`getBlob()`	`Blob`	Restituisce i dati all'interno di questo oggetto come blob.
`getColumnWidth(columnPosition)`	`Integer`	Restituisce la larghezza in pixel della colonna specificata.
`getCurrentCell()`	`Range`	Restituisce la cella corrente nel foglio attivo o `null` se non è presente alcuna cella corrente.
`getDataRange()`	`Range`	Restituisce un `Range` corrispondente alle dimensioni in cui sono presenti i dati.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Recupera tutte le formule dell'origine dati.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Recupera tutte le tabelle pivot dell'origine dati.
`getDataSourceRefreshSchedules()`	`DataSourceRefreshSchedule[]`	Recupera le pianificazioni di aggiornamento di questo foglio di lavoro.
`getDataSourceSheets()`	`DataSourceSheet[]`	Restituisce tutti i fogli delle origini dati nel foglio di lavoro.
`getDataSourceTables()`	`DataSourceTable[]`	Recupera tutte le tabelle dell'origine dati.
`getDataSources()`	`DataSource[]`	Restituisce tutte le origini dati nel foglio di lavoro.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Recupera i metadati dello sviluppatore associati al foglio di lavoro di primo livello.
`getEditors()`	`User[]`	Recupera l'elenco degli editor per questo `Spreadsheet`.
`getFormUrl()`	`String`	Restituisce l'URL del modulo che invia le risposte a questo foglio di lavoro oppure `null` se questo foglio di lavoro non ha un modulo associato.
`getFrozenColumns()`	`Integer`	Restituisce il numero di colonne bloccate.
`getFrozenRows()`	`Integer`	Restituisce il numero di righe bloccate.
`getId()`	`String`	Restituisce un identificatore univoco per questo foglio di lavoro.
`getImages()`	`OverGridImage[]`	Restituisce tutte le immagini fuori griglia nel foglio.
`getIterativeCalculationConvergenceThreshold()`	`Number`	Restituisce il valore di soglia utilizzato durante il calcolo iterativo.
`getLastColumn()`	`Integer`	Restituisce la posizione dell'ultima colonna che contiene contenuti.
`getLastRow()`	`Integer`	Restituisce la posizione dell'ultima riga con contenuti.
`getMaxIterativeCalculationCycles()`	`Integer`	Restituisce il numero massimo di iterazioni da utilizzare durante il calcolo iterativo.
`getName()`	`String`	Restituisce il nome del documento.
`getNamedRanges()`	`NamedRange[]`	Recupera tutti gli intervalli denominati in questo foglio di lavoro.
`getNumSheets()`	`Integer`	Restituisce il numero di fogli in questo foglio di lavoro.
`getOwner()`	`User`	Restituisce il proprietario del documento o `null` per un documento in un Drive condiviso.
`getPredefinedSpreadsheetThemes()`	`SpreadsheetTheme[]`	Restituisce l'elenco dei temi predefiniti.
`getProtections(type)`	`Protection[]`	Restituisce un array di oggetti che rappresentano tutti gli intervalli o i fogli protetti nel foglio di lavoro.
`getRange(a1Notation)`	`Range`	Restituisce l'intervallo specificato nella notazione A1 o R1C1.
`getRangeByName(name)`	`Range`	Restituisce un intervallo denominato o `null` se non viene trovato alcun intervallo con il nome specificato.
`getRangeList(a1Notations)`	`RangeList`	Restituisce la raccolta `RangeList` che rappresenta gli intervalli nello stesso foglio specificati da un elenco non vuoto di notazioni A1 o R1C1.
`getRecalculationInterval()`	`RecalculationInterval`	Restituisce l'intervallo di calcolo per questo foglio di lavoro.
`getRowHeight(rowPosition)`	`Integer`	Restituisce l'altezza in pixel della riga specificata.
`getSelection()`	`Selection`	Restituisce l'`Selection` corrente nel foglio di lavoro.
`getSheetById(id)`	`Sheet`	Recupera il foglio con l'ID specificato.
`getSheetByName(name)`	`Sheet`	Restituisce un foglio con il nome specificato.
`getSheetId()`	`Integer`	Restituisce l'ID del foglio rappresentato da questo oggetto.
`getSheetName()`	`String`	Restituisce il nome del foglio.
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	Restituisce la griglia rettangolare di valori per questo intervallo a partire dalle coordinate indicate.
`getSheets()`	`Sheet[]`	Recupera tutti i fogli di questo foglio di lavoro.
`getSpreadsheetLocale()`	`String`	Restituisce le impostazioni internazionali del foglio di lavoro.
`getSpreadsheetTheme()`	`SpreadsheetTheme`	Restituisce il tema corrente del foglio di lavoro o `null` se non è applicato alcun tema.
`getSpreadsheetTimeZone()`	`String`	Recupera il fuso orario del foglio di lavoro.
`getUrl()`	`String`	Restituisce l'URL del foglio di lavoro specificato.
`getViewers()`	`User[]`	Recupera l'elenco di visualizzatori e commentatori per questo `Spreadsheet`.
`hideColumn(column)`	`void`	Nasconde la colonna o le colonne nell'intervallo specificato.
`hideRow(row)`	`void`	Nasconde le righe nell'intervallo specificato.
`insertColumnAfter(afterPosition)`	`Sheet`	Inserisce una colonna dopo la posizione della colonna specificata.
`insertColumnBefore(beforePosition)`	`Sheet`	Inserisce una colonna prima della posizione della colonna specificata.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Inserisce un determinato numero di colonne dopo la posizione della colonna specificata.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Inserisce un numero di colonne prima della posizione della colonna specificata.
`insertDataSourceSheet(spec)`	`DataSourceSheet`	Inserisce un nuovo `DataSourceSheet` nel foglio di lavoro e avvia l'esecuzione dei dati.
`insertImage(blobSource, column, row)`	`OverGridImage`	Inserisce un `Spreadsheet` come immagine nel documento in una determinata riga e colonna.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	Inserisce un `Spreadsheet` come immagine nel documento in una determinata riga e colonna, con un offset in pixel.
`insertImage(url, column, row)`	`OverGridImage`	Inserisce un'immagine nel documento in una determinata riga e colonna.
`insertImage(url, column, row, offsetX, offsetY)`	`OverGridImage`	Inserisce un'immagine nel documento in una determinata riga e colonna, con un offset in pixel.
`insertRowAfter(afterPosition)`	`Sheet`	Inserisce una riga dopo la posizione della riga specificata.
`insertRowBefore(beforePosition)`	`Sheet`	Inserisce una riga prima della posizione della riga specificata.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Inserisce un numero di righe dopo la posizione della riga specificata.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Inserisce un numero di righe prima della posizione della riga specificata.
`insertSheet()`	`Sheet`	Inserisce un nuovo foglio nel foglio di lavoro, utilizzando un nome predefinito.
`insertSheet(sheetIndex)`	`Sheet`	Inserisce un nuovo foglio nel foglio di lavoro all'indice specificato.
`insertSheet(sheetIndex, options)`	`Sheet`	Inserisce un nuovo foglio nel foglio di lavoro all'indice specificato e utilizza argomenti avanzati facoltativi.
`insertSheet(options)`	`Sheet`	Inserisce un nuovo foglio nel foglio di lavoro, utilizzando un nome predefinito e argomenti avanzati facoltativi.
`insertSheet(sheetName)`	`Sheet`	Inserisce un nuovo foglio nel foglio di lavoro con il nome specificato.
`insertSheet(sheetName, sheetIndex)`	`Sheet`	Inserisce un nuovo foglio nel foglio di lavoro con il nome specificato all'indice specificato.
`insertSheet(sheetName, sheetIndex, options)`	`Sheet`	Inserisce un nuovo foglio nel foglio di lavoro con il nome specificato all'indice specificato e utilizza argomenti avanzati facoltativi.
`insertSheet(sheetName, options)`	`Sheet`	Inserisce un nuovo foglio nel foglio di lavoro con il nome specificato e utilizza argomenti avanzati facoltativi.
`insertSheetWithDataSourceTable(spec)`	`Sheet`	Inserisce un nuovo foglio nel foglio di lavoro, crea un `DataSourceTable` che si estende su tutto il foglio con la specifica dell'origine dati fornita e avvia l'esecuzione dei dati.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Restituisce un valore che indica se la colonna specificata è nascosta all'utente.
`isIterativeCalculationEnabled()`	`Boolean`	Restituisce un valore che indica se il calcolo iterativo è attivato in questo foglio di lavoro.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Restituisce un valore che indica se la riga specificata è nascosta da un filtro (non da una visualizzazione filtrata).
`isRowHiddenByUser(rowPosition)`	`Boolean`	Restituisce un valore che indica se la riga specificata è nascosta dall'utente.
`moveActiveSheet(pos)`	`void`	Sposta il foglio attivo nella posizione specificata nell'elenco dei fogli.
`moveChartToObjectSheet(chart)`	`Sheet`	Crea un nuovo foglio `SheetType.OBJECT` e sposta il grafico fornito.
`refreshAllDataSources()`	`void`	Aggiorna tutte le origini dati supportate e i relativi oggetti di origine dati collegati, ignorando quelli non validi.
`removeEditor(emailAddress)`	`Spreadsheet`	Rimuove l'utente specificato dall'elenco degli editor del `Spreadsheet`.
`removeEditor(user)`	`Spreadsheet`	Rimuove l'utente specificato dall'elenco degli editor del `Spreadsheet`.
`removeMenu(name)`	`void`	Rimuove un menu aggiunto da `addMenu(name, subMenus)`.
`removeNamedRange(name)`	`void`	Elimina un intervallo denominato con il nome specificato.
`removeViewer(emailAddress)`	`Spreadsheet`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del `Spreadsheet`.
`removeViewer(user)`	`Spreadsheet`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del `Spreadsheet`.
`rename(newName)`	`void`	Rinomina il documento.
`renameActiveSheet(newName)`	`void`	Rinomina il foglio attivo corrente con il nuovo nome specificato.
`resetSpreadsheetTheme()`	`SpreadsheetTheme`	Rimuove il tema applicato e imposta il tema predefinito nel foglio di lavoro.
`setActiveRange(range)`	`Range`	Imposta l'intervallo specificato come `active range` nel foglio attivo, con la cella in alto a sinistra dell'intervallo come `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Imposta l'elenco specificato di intervalli come `active ranges` nel foglio attivo.
`setActiveSelection(range)`	`Range`	Imposta la regione di selezione attiva per questo foglio.
`setActiveSelection(a1Notation)`	`Range`	Imposta la selezione attiva, come specificato nella notazione A1 o R1C1.
`setActiveSheet(sheet)`	`Sheet`	Imposta il foglio specificato come foglio attivo nel foglio di lavoro.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	Imposta il foglio specificato come foglio attivo nel foglio di lavoro, con un'opzione per ripristinare la selezione più recente all'interno del foglio.
`setColumnWidth(columnPosition, width)`	`Sheet`	Imposta la larghezza della colonna specificata in pixel.
`setCurrentCell(cell)`	`Range`	Imposta la cella specificata come `current cell`.
`setFrozenColumns(columns)`	`void`	Blocca il numero specificato di colonne.
`setFrozenRows(rows)`	`void`	Blocca il numero specificato di righe.
`setIterativeCalculationConvergenceThreshold(minThreshold)`	`Spreadsheet`	Imposta il valore di soglia minimo per il calcolo iterativo.
`setIterativeCalculationEnabled(isEnabled)`	`Spreadsheet`	Imposta se il calcolo iterativo è attivato in questo foglio di lavoro.
`setMaxIterativeCalculationCycles(maxIterations)`	`Spreadsheet`	Imposta il numero massimo di iterazioni di calcolo da eseguire durante il calcolo iterativo.
`setNamedRange(name, range)`	`void`	Assegna un nome a un intervallo.
`setRecalculationInterval(recalculationInterval)`	`Spreadsheet`	Imposta la frequenza di ricalcolo di questo foglio di lavoro.
`setRowHeight(rowPosition, height)`	`Sheet`	Imposta l'altezza della riga specificata in pixel.
`setSpreadsheetLocale(locale)`	`void`	Imposta le impostazioni internazionali del foglio di lavoro.
`setSpreadsheetTheme(theme)`	`SpreadsheetTheme`	Imposta un tema sul foglio di lavoro.
`setSpreadsheetTimeZone(timezone)`	`void`	Imposta il fuso orario per il foglio di lavoro.
`show(userInterface)`	`void`	Visualizza un componente dell'interfaccia utente personalizzato in una finestra di dialogo centrata nella finestra del browser dell'utente.
`sort(columnPosition)`	`Sheet`	Ordina un foglio per colonna, in ordine crescente.
`sort(columnPosition, ascending)`	`Sheet`	Ordina un foglio per colonna.
`toast(msg)`	`void`	Mostra una finestra popup nell'angolo in basso a destra del foglio di lavoro con il messaggio specificato.
`toast(msg, title)`	`void`	Mostra una finestra popup nell'angolo in basso a destra del foglio di lavoro con il messaggio e il titolo specificati.
`toast(msg, title, timeoutSeconds)`	`void`	Mostra una finestra popup nell'angolo in basso a destra del foglio di lavoro con il titolo e il messaggio specificati, che rimane visibile per un determinato periodo di tempo.
`unhideColumn(column)`	`void`	Mostra la colonna nell'intervallo specificato.
`unhideRow(row)`	`void`	Mostra la riga nell'intervallo specificato.
`updateMenu(name, subMenus)`	`void`	Aggiorna un menu aggiunto da `addMenu(name, subMenus)`.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Attende il completamento di tutte le esecuzioni correnti nel foglio di lavoro, con timeout dopo il numero di secondi fornito.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
`getSheetProtection()`	`PageProtection`	Restituisce un'istanza `PageProtection` che descrive le autorizzazioni per il foglio corrente.
`isAnonymousView()`	`Boolean`	Indica se il documento consente la visualizzazione anonima.
`isAnonymousWrite()`	`Boolean`	Indica se il documento consente modifiche da parte di utenti anonimi.
`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`	`void`	Imposta i criteri del documento per la lettura e la scrittura anonime.
`setSheetProtection(permissions)`	`void`	Imposta le autorizzazioni per il foglio corrente.

Documentazione dettagliata

`addDeveloperMetadata(key)`

Aggiunge i metadati dello sviluppatore con la chiave specificata al foglio di lavoro di primo livello.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Adds the key 'NAME' in the developer metadata for the spreadsheet.
ss.addDeveloperMetadata('NAME');

// Gets the first developer metadata object and logs its key.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

Parametri

Nome	Tipo	Descrizione
`key`	`String`	La chiave per i nuovi metadati dello sviluppatore.

Indietro

Spreadsheet: questo foglio di lavoro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, visibility)`

Aggiunge al foglio di lavoro i metadati dello sviluppatore con la chiave e la visibilità specificate.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Adds the key 'NAME' in the developer metadata for the spreadsheet and sets
// the visibility to the developer project that created the metadata.
ss.addDeveloperMetadata(
    'NAME',
    SpreadsheetApp.DeveloperMetadataVisibility.PROJECT,
);

// Gets the first developer metadata object and logs its key and visibility
// setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()},
.             Visibility: ${developerMetaData.getVisibility()}`);

Parametri

Nome	Tipo	Descrizione
`key`	`String`	La chiave per i nuovi metadati dello sviluppatore.
`visibility`	`DeveloperMetadataVisibility`	La visibilità dei nuovi metadati dello sviluppatore.

Indietro

Spreadsheet: questo foglio di lavoro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value)`

Aggiunge al foglio di lavoro i metadati dello sviluppatore con la chiave e il valore specificati.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata
// for the spreadsheet.
ss.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the first developer metadata object and logs its key and value.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(
    `Key: ${developerMetaData.getKey()}, Value: ${
        developerMetaData.getValue()}`,
);

Parametri

Nome	Tipo	Descrizione
`key`	`String`	La chiave per i nuovi metadati dello sviluppatore.
`value`	`String`	Il valore dei nuovi metadati dello sviluppatore.

Indietro

Spreadsheet: questo foglio di lavoro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value, visibility)`

Aggiunge al foglio di lavoro i metadati dello sviluppatore con la chiave, il valore e la visibilità specificati.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to any developer project with document access.
ss.addDeveloperMetadata(
    'NAME',
    'GOOGLE',
    SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT,
);

// Gets the first developer metadata object and logs its key, value, and
// visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(`Key: ${developerMetaData.getKey()},
             Value: ${developerMetaData.getValue()},
             Visibility: ${developerMetaData.getVisibility()}`);

Parametri

Nome	Tipo	Descrizione
`key`	`String`	La chiave per i nuovi metadati dello sviluppatore.
`value`	`String`	Il valore dei nuovi metadati dello sviluppatore.
`visibility`	`DeveloperMetadataVisibility`	La visibilità dei nuovi metadati dello sviluppatore.

Indietro

Spreadsheet: questo foglio di lavoro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditor(emailAddress)`

Aggiunge l'utente specificato all'elenco degli editor per Spreadsheet. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da aggiungere.

Indietro

Spreadsheet — This Spreadsheet, for chaining.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditor(user)`

Aggiunge l'utente specificato all'elenco degli editor per Spreadsheet. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da aggiungere.

Indietro

Spreadsheet — This Spreadsheet, for chaining.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditors(emailAddresses)`

Aggiunge l'array di utenti specificato all'elenco degli editor del Spreadsheet. Se alcuni utenti erano già presenti nell'elenco degli spettatori, questo metodo li rimuove dall'elenco.

Parametri

Nome	Tipo	Descrizione
`emailAddresses`	`String[]`	Un array di indirizzi email degli utenti da aggiungere.

Indietro

Spreadsheet — This Spreadsheet, for chaining.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addMenu(name, subMenus)`

Crea un nuovo menu nella UI del foglio di lavoro.

Ogni voce di menu esegue una funzione definita dall'utente. In genere, vuoi chiamarlo dalla funzione onOpen() in modo che il menu venga creato automaticamente quando viene caricato il foglio di lavoro.

// The onOpen function is executed automatically every time a Spreadsheet is
// loaded
function onOpen() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const menuEntries = [];
  // When the user clicks on "addMenuExample" then "Menu Entry 1", the function
  // function1 is executed.
  menuEntries.push({name: 'Menu Entry 1', functionName: 'function1'});
  menuEntries.push(null);  // line separator
  menuEntries.push({name: 'Menu Entry 2', functionName: 'function2'});

  ss.addMenu('addMenuExample', menuEntries);
}

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome del menu da creare.
`subMenus`	`Object[]`	Un array di mappe JavaScript con parametri `name` e `functionName`. Puoi utilizzare le funzioni delle librerie incluse, ad esempio `Library.libFunction1`.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addViewer(emailAddress)`

Aggiunge l'utente specificato all'elenco degli spettatori di Spreadsheet. Se l'utente era già nell'elenco degli editor, questo metodo non ha effetto.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da aggiungere.

Indietro

Spreadsheet — This Spreadsheet, for chaining.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addViewer(user)`

Aggiunge l'utente specificato all'elenco degli spettatori di Spreadsheet. Se l'utente era già nell'elenco degli editor, questo metodo non ha effetto.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da aggiungere.

Indietro

Spreadsheet — This Spreadsheet, for chaining.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addViewers(emailAddresses)`

Aggiunge l'array di utenti specificato all'elenco dei visualizzatori di Spreadsheet. Se alcuni utenti erano già presenti nell'elenco degli editor, questo metodo non ha alcun effetto.

Parametri

Nome	Tipo	Descrizione
`emailAddresses`	`String[]`	Un array di indirizzi email degli utenti da aggiungere.

Indietro

Spreadsheet — This Spreadsheet, for chaining.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`appendRow(rowContents)`

Aggiunge una riga in fondo all'area dati corrente del foglio. Se i contenuti di una cella iniziano con =, vengono interpretati come una formula.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Appends a new row with 3 columns to the bottom of the current
// data region in the sheet containing the values in the array.
sheet.appendRow(['a man', 'a plan', 'panama']);

Parametri

Nome	Tipo	Descrizione
`rowContents`	`Object[]`	Un array di valori da inserire dopo l'ultima riga del foglio.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoResizeColumn(columnPosition)`

Imposta la larghezza della colonna specificata in modo che si adatti ai contenuti.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

sheet.getRange('a1').setValue(
    'Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

Parametri

Nome	Tipo	Descrizione
`columnPosition`	`Integer`	La posizione della colonna specificata da ridimensionare.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copy(name)`

Copia il foglio di lavoro e restituisce quello nuovo.

// This code makes a copy of the current spreadsheet and names it appropriately
const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.copy(`Copy of ${ss.getName()}`);

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome della copia.

Indietro

Spreadsheet: questo foglio di lavoro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDeveloperMetadataFinder()`

Restituisce un DeveloperMetadataFinder per trovare i metadati dello sviluppatore nell'ambito di questo foglio di lavoro. Per impostazione predefinita, vengono presi in considerazione tutti i metadati associati al foglio di lavoro, ai fogli, alle righe e alle colonne.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Adds developer metadata to the spreadsheet.
ss.addDeveloperMetadata('NAME', 'CHARLIE');
ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION');
ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT');

// Creates a developer metadata finder.
const developerMetadataFinder = ss.createDeveloperMetadataFinder();

// Finds the developer metadata objects with 'COMPANY' as the key.
const googleMetadataFromSpreadsheet =
    developerMetadataFinder.withKey('COMPANY').find();

// Gets the first result of developer metadata that has the key 'COMPANY' and
// logs its value.
console.log(googleMetadataFromSpreadsheet[0].getValue());

Indietro

DeveloperMetadataFinder: uno strumento di ricerca dei metadati dello sviluppatore per cercare i metadati nell'ambito di questo foglio di lavoro.

`createTextFinder(findText)`

Crea un cercatore di testo per il foglio di lavoro, che può essere utilizzato per trovare e sostituire testo all'interno del foglio di lavoro. La ricerca inizia dal primo foglio del foglio di lavoro.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

// Creates  a text finder.
const textFinder = spreadsheet.createTextFinder('dog');

// Returns the first occurrence of 'dog' in the spreadsheet.
const firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
const numOccurrencesReplaced = textFinder.replaceWith('cat');

Parametri

Nome	Tipo	Descrizione
`findText`	`String`	Il testo da cercare.

Indietro

TextFinder: il TextFinder del foglio di lavoro.

`deleteActiveSheet()`

Elimina il foglio attualmente attivo.

// The code below deletes the currently active sheet and stores the new active
// sheet in a variable
const newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();

Indietro

Sheet: il nuovo foglio attivo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteColumn(columnPosition)`

Elimina la colonna nella posizione specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first column
sheet.deleteColumn(1);

Parametri

Nome	Tipo	Descrizione
`columnPosition`	`Integer`	La posizione della colonna, a partire da 1 per la prima colonna.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteColumns(columnPosition, howMany)`

Elimina un numero di colonne a partire dalla posizione della colonna specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first two columns
sheet.deleteColumns(1, 2);

Parametri

Nome	Tipo	Descrizione
`columnPosition`	`Integer`	La posizione della prima colonna da eliminare.
`howMany`	`Integer`	Il numero di colonne da eliminare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteRow(rowPosition)`

Elimina la riga nella posizione specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

Parametri

Nome	Tipo	Descrizione
`rowPosition`	`Integer`	La posizione della riga, a partire da 1 per la prima riga.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteRows(rowPosition, howMany)`

Elimina un numero di righe a partire dalla posizione della riga specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first two rows
sheet.deleteRows(1, 2);

Parametri

Nome	Tipo	Descrizione
`rowPosition`	`Integer`	La posizione della prima riga da eliminare.
`howMany`	`Integer`	Il numero di righe da eliminare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteSheet(sheet)`

Elimina il foglio specificato.

// The code below deletes the specified sheet.
const ss = SpreadsheetApp.getActive();
const sheet = ss.getSheetByName('My Sheet');
ss.deleteSheet(sheet);

Parametri

Nome	Tipo	Descrizione
`sheet`	`Sheet`	Il foglio da eliminare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`duplicateActiveSheet()`

Duplica il foglio attivo e lo imposta come foglio attivo.

// The code below makes a duplicate of the active sheet
SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getActiveCell()`

Restituisce la cella attiva in questo foglio.

Nota:è preferibile utilizzare getCurrentCell(), che restituisce la cella correntemente evidenziata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Returns the active cell
const cell = sheet.getActiveCell();

Indietro

Range: la cella attiva corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getActiveRange()`

Restituisce l'intervallo selezionato nel foglio attivo o null se non è presente alcun intervallo attivo. Se vengono selezionati più intervalli, questo metodo restituisce solo l'ultimo intervallo selezionato.

Il termine "intervallo attivo" si riferisce all'intervallo selezionato da un utente nel foglio attivo, ma in una funzione personalizzata si riferisce alla cella che viene ricalcolata attivamente.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const activeRange = sheet.getActiveRange();

Indietro

Range: l'intervallo attivo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Vedi anche

setActiveRange(range)

`getActiveRangeList()`

Restituisce l'elenco degli intervalli attivi nel foglio attivo o null se non sono presenti intervalli attivi.

Se è selezionato un singolo intervallo, questo si comporta come una chiamata getActiveRange().

const sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
const activeRangeList = sheet.getActiveRangeList();

Indietro

RangeList: l'elenco degli intervalli attivi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Vedi anche

setActiveRangeList(rangeList)

`getActiveSheet()`

Restituisce il foglio attivo in un foglio di lavoro.

Il foglio attivo in un foglio di lavoro è quello visualizzato nell'interfaccia utente del foglio di lavoro.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

Indietro

Sheet: il foglio attivo nel foglio di lavoro.

`getAs(contentType)`

Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato. Questo metodo aggiunge l'estensione appropriata al nome file, ad esempio "myfile.pdf". Tuttavia, si presume che la parte del nome file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più rigide.

Parametri

Nome	Tipo	Descrizione
`contentType`	`String`	Il tipo MIME in cui eseguire la conversione. Per la maggior parte dei blob, `'application/pdf'` è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, sono validi anche `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`. Per un documento Google, è valido anche `'text/markdown'`.

Indietro

Blob: i dati come blob.

`getBandings()`

Restituisce tutte le bande in questo foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets an array of the bandings in the spreadsheet.
const bandings = ss.getBandings();

// Logs the range of the first banding in the spreadsheet to the console.
console.log(bandings[0].getRange().getA1Notation());

Indietro

Banding[]: le bande in questo foglio di lavoro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBlob()`

Restituisce i dati all'interno di questo oggetto come blob.

Indietro

Blob: i dati come blob.

`getColumnWidth(columnPosition)`

Restituisce la larghezza in pixel della colonna specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Columns start at 1
Logger.log(sheet.getColumnWidth(1));

Parametri

Nome	Tipo	Descrizione
`columnPosition`	`Integer`	La posizione della colonna da esaminare.

Indietro

Integer: larghezza della colonna in pixel.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getCurrentCell()`

Restituisce la cella corrente nel foglio attivo o null se non è presente alcuna cella corrente. La cella corrente è quella evidenziata nella UI di Fogli Google da un bordo scuro. Non esiste mai più di una cella corrente. Quando un utente seleziona uno o più intervalli di celle, una delle celle nella selezione è la cella corrente.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// Returns the current highlighted cell in the one of the active ranges.
const currentCell = sheet.getCurrentCell();

Indietro

Range: la cella corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataRange()`

Restituisce un Range corrispondente alle dimensioni in cui sono presenti i dati.

Ciò equivale funzionalmente a creare un intervallo delimitato da A1 e (Sheet.getLastColumn(), Sheet.getLastRow()).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This represents ALL the data
const range = sheet.getDataRange();
const values = range.getValues();

// This logs the spreadsheet in CSV format with a trailing comma
for (let i = 0; i < values.length; i++) {
  let row = '';
  for (let j = 0; j < values[i].length; j++) {
    if (values[i][j]) {
      row = row + values[i][j];
    }
    row = `${row},`;
  }
  Logger.log(row);
}

Indietro

Range: un intervallo costituito da tutti i dati del foglio di lavoro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceFormulas()`

Recupera tutte le formule dell'origine dati.

// Opens the spreadsheet by its ID. If you created your script from within a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

// Logs the first data source formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Indietro

DataSourceFormula[]: un elenco di formule dell'origine dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourcePivotTables()`

Recupera tutte le tabelle pivot dell'origine dati.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Indietro

DataSourcePivotTable[]: un elenco delle tabelle pivot delle origini dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceRefreshSchedules()`

Recupera le pianificazioni di aggiornamento di questo foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Activates BigQuery operations for the connected spreadsheet.
SpreadsheetApp.enableBigQueryExecution();

// Gets the frequency type of the first referesh schedule in the array.
const frequencyType = ss.getDataSourceRefreshSchedules()[0]
                          .getFrequency()
                          .getFrequencyType()
                          .toString();

// Logs the frequency type to the console.
console.log(frequencyType);

Indietro

DataSourceRefreshSchedule[]: le pianificazioni di aggiornamento di questo foglio di lavoro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceSheets()`

Restituisce tutti i fogli delle origini dati nel foglio di lavoro.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets the first data source sheet in the spreadsheet.
const dataSource = ss.getDataSourceSheets()[0];

// Gets the name of the data source sheet.
console.log(dataSource.asSheet().getName());

Indietro

DataSourceSheet[]: un array di tutti i fogli delle origini dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceTables()`

Recupera tutte le tabelle dell'origine dati.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

Indietro

DataSourceTable[]: un elenco delle tabelle delle origini dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSources()`

Restituisce tutte le origini dati nel foglio di lavoro.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets the data sources on the spreadsheet.
const dataSources = ss.getDataSources();

// Logs the name of the first column on the first data source.
console.log(dataSources[0].getColumns()[0].getName());

Indietro

DataSource[]: un array di tutte le origini dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDeveloperMetadata()`

Recupera i metadati dello sviluppatore associati al foglio di lavoro di primo livello.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Adds 'Google' as a key to the spreadsheet metadata.
ss.addDeveloperMetadata('Google');

// Gets the spreadsheet's metadata.
const ssMetadata = ss.getDeveloperMetadata();

// Gets the first set of the spreadsheet's metadata and logs the key to the
// console.
console.log(ssMetadata[0].getKey());

Indietro

DeveloperMetadata[]: i metadati dello sviluppatore associati a questo intervallo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getEditors()`

Recupera l'elenco degli editor per questo Spreadsheet.

Indietro

User[]: un array di utenti con autorizzazione di modifica.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormUrl()`

Restituisce l'URL del modulo che invia le risposte a questo foglio di lavoro oppure null se questo foglio di lavoro non ha un modulo associato. Se più moduli inviano risposte a questo foglio di lavoro, l'URL del modulo restituito è indeterminato. In alternativa, le associazioni di URL dei moduli per foglio possono essere recuperate tramite il metodo Sheet.getFormUrl(). Genera un'eccezione se l'utente non dispone dell'autorizzazione per modificare il foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets the form URL from the spreadsheet.
const formUrl = ss.getFormUrl();

// Logs the form URL to the console.
console.log(formUrl);

Indietro

String: l'URL del modulo che inserisce le risposte in questo foglio di lavoro o null se questo foglio di lavoro non ha un modulo associato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFrozenColumns()`

Restituisce il numero di colonne bloccate.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

Logger.log('Number of frozen columns: %s', sheet.getFrozenColumns());

Indietro

Integer: il numero di colonne bloccate.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFrozenRows()`

Restituisce il numero di righe bloccate.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

Logger.log('Number of frozen rows: %s', sheet.getFrozenRows());

Indietro

Integer: il numero di righe bloccate.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getId()`

Restituisce un identificatore univoco per questo foglio di lavoro. Un ID foglio di lavoro può essere estratto dal relativo URL. Ad esempio, l'ID foglio di lavoro nell'URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 è "abc1234567".

// The code below logs the ID for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());

Indietro

String: l'ID univoco (o chiave) del foglio di lavoro.

`getImages()`

Restituisce tutte le immagini fuori griglia nel foglio.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use
// ss.getImages() instead.
const images = sheet.getImages();

// For each image, logs the anchor cell in A1 notation.
for (const image of images) {
  console.log(image.getAnchorCell().getA1Notation());
}

Indietro

OverGridImage[]: una serie di immagini sopra la griglia.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getIterativeCalculationConvergenceThreshold()`

Restituisce il valore di soglia utilizzato durante il calcolo iterativo. Quando i risultati di calcoli successivi differiscono di un valore inferiore a questo, il calcolo iterativo si interrompe.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Indietro

Number: la soglia di convergenza.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastColumn()`

Restituisce la posizione dell'ultima colonna che contiene contenuti.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This logs the value in the very last cell of this sheet
const lastRow = sheet.getLastRow();
const lastColumn = sheet.getLastColumn();
const lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Indietro

Integer: l'ultima colonna del foglio contenente i contenuti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastRow()`

Restituisce la posizione dell'ultima riga con contenuti.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This logs the value in the very last cell of this sheet
const lastRow = sheet.getLastRow();
const lastColumn = sheet.getLastColumn();
const lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Indietro

Integer: l'ultima riga del foglio che contiene contenuti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getMaxIterativeCalculationCycles()`

Restituisce il numero massimo di iterazioni da utilizzare durante il calcolo iterativo.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Indietro

Integer: il numero massimo di iterazioni di calcolo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getName()`

Restituisce il nome del documento.

const ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getName());

Indietro

String: il nome del foglio di lavoro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNamedRanges()`

Recupera tutti gli intervalli denominati in questo foglio di lavoro.

// The code below logs the name of the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
  Logger.log(namedRanges[i].getName());
}

Indietro

NamedRange[]: un array di tutti gli intervalli denominati nel foglio di lavoro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumSheets()`

Restituisce il numero di fogli in questo foglio di lavoro.

// The code below logs the number of sheets in the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());

Indietro

Integer: il numero di fogli nel foglio di lavoro.

`getOwner()`

Restituisce il proprietario del documento o null per un documento in un Drive condiviso.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const owner = ss.getOwner();
Logger.log(owner.getEmail());

Indietro

User: il proprietario del documento o null se il documento si trova in un Drive condiviso.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getPredefinedSpreadsheetThemes()`

Restituisce l'elenco dei temi predefiniti.

// The code below returns the list of predefined themes.
const predefinedThemesList =
    SpreadsheetApp.getActiveSpreadsheet().getPredefinedSpreadsheetThemes();

Indietro

SpreadsheetTheme[]: elenco di temi predefiniti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getProtections(type)`

Restituisce un array di oggetti che rappresentano tutti gli intervalli o i fogli protetti nel foglio di lavoro.

// Remove all range protections in the spreadsheet that the user has permission
// to edit.
const ss = SpreadsheetApp.getActive();
const protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (let i = 0; i < protections.length; i++) {
  const protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Remove all sheet protections in the spreadsheet that the user has permission
// to edit.
const ss = SpreadsheetApp.getActive();
const protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET);
for (let i = 0; i < protections.length; i++) {
  const protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

Parametri

Nome	Tipo	Descrizione
`type`	`ProtectionType`	Il tipo di area protetta, `SpreadsheetApp.ProtectionType.RANGE` o `SpreadsheetApp.ProtectionType.SHEET`.

Indietro

Protection[]: un array di oggetti che rappresentano tutti gli intervalli o i fogli protetti nel foglio di lavoro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange(a1Notation)`

Restituisce l'intervallo specificato nella notazione A1 o R1C1.

// Get a range A1:D4 on sheet titled "Invoices"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange('Invoices!A1:D4');

// Get cell A1 on the first sheet
const sheet = ss.getSheets()[0];
const cell = sheet.getRange('A1');

Parametri

Nome	Tipo	Descrizione
`a1Notation`	`String`	L'intervallo da restituire, come specificato nella notazione A1 o R1C1.

Indietro

Range: l'intervallo nella posizione designata.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRangeByName(name)`

Restituisce un intervallo denominato o null se non viene trovato alcun intervallo con il nome specificato. Se più fogli del foglio di lavoro utilizzano lo stesso nome intervallo, specifica il nome del foglio senza virgolette aggiuntive, ad esempio getRangeByName('TaxRates') o getRangeByName('Sheet Name!TaxRates'), ma non getRangeByName('"Sheet Name"!TaxRates').

// Log the number of columns for the range named 'TaxRates' in the active
// spreadsheet.
const range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates');
if (range != null) {
  Logger.log(range.getNumColumns());
}

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome dell'intervallo da ottenere.

Indietro

Range: l'intervallo di celle con il nome specificato.

`getRangeList(a1Notations)`

Restituisce la raccolta RangeList che rappresenta gli intervalli nello stesso foglio specificati da un elenco non vuoto di notazioni A1 o R1C1.

// Get a list of ranges A1:D4, F1:H4.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);

Parametri

Nome	Tipo	Descrizione
`a1Notations`	`String[]`	L'elenco degli intervalli da restituire, come specificato nella notazione A1 o R1C1.

Indietro

RangeList: l'elenco dei range nella posizione designata.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRecalculationInterval()`

Restituisce l'intervallo di calcolo per questo foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Logs the calculation interval for the spreadsheet to the console.
console.log(ss.getRecalculationInterval().toString());

Indietro

RecalculationInterval: l'intervallo di calcolo per questo foglio di lavoro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowHeight(rowPosition)`

Restituisce l'altezza in pixel della riga specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

Parametri

Nome	Tipo	Descrizione
`rowPosition`	`Integer`	La posizione della riga da esaminare.

Indietro

Integer: altezza riga in pixel.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSelection()`

Restituisce l'Selection corrente nel foglio di lavoro.

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const currentCell = selection.getCurrentCell();

Indietro

Selection: la selezione attuale.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetById(id)`

Recupera il foglio con l'ID specificato. Utilizza Sheet.getSheetId().

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetById(12345);

Parametri

Nome	Tipo	Descrizione
`id`	`Integer`	L'ID del foglio da ottenere.

Indietro

Sheet: il foglio con l'ID specificato o null se non viene trovato alcun foglio.

`getSheetByName(name)`

Restituisce un foglio con il nome specificato.

Se più fogli hanno lo stesso nome, viene restituito quello più a sinistra. Restituisce null se non esiste un foglio con il nome specificato.

// The code below logs the index of a sheet named "Expenses"
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Expenses');
if (sheet != null) {
  Logger.log(sheet.getIndex());
}

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome del foglio da ottenere.

Indietro

Sheet: il foglio con il nome specificato.

`getSheetId()`

Restituisce l'ID del foglio rappresentato da questo oggetto.

Si tratta di un ID per il foglio univoco per il foglio di lavoro. L'ID è un numero intero in aumento monotono assegnato al momento della creazione del foglio e indipendente dalla posizione del foglio. Questo è utile in combinazione con metodi come Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) che accettano un parametro gridId anziché un'istanza Sheet.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

Logger.log(sheet.getSheetId());

Indietro

Integer: un ID per il foglio univoco per il foglio di lavoro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetName()`

Restituisce il nome del foglio.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

Logger.log(sheet.getSheetName());

Indietro

String: il nome del foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetValues(startRow, startColumn, numRows, numColumns)`

Restituisce la griglia rettangolare di valori per questo intervallo a partire dalle coordinate indicate. Un valore -1 fornito come posizione di riga o colonna equivale a ottenere l'ultima riga o colonna che contiene dati nel foglio.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The two samples below produce the same output
let values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

const range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

Parametri

Nome	Tipo	Descrizione
`startRow`	`Integer`	La posizione della riga iniziale.
`startColumn`	`Integer`	La posizione della colonna iniziale.
`numRows`	`Integer`	Il numero di righe per cui restituire i valori.
`numColumns`	`Integer`	Il numero di colonne per cui restituire i valori.

Indietro

Object[][]: un array bidimensionale di valori.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheets()`

Recupera tutti i fogli di questo foglio di lavoro.

// The code below logs the name of the second sheet
const sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
// Iterates through the sheets and logs the name and ID of each sheet.
for (const sheet of sheets) {
  Logger.log(`name: ${sheet.getName()}, ID: ${sheet.getSheetId()}`);
}

Indietro

Sheet[]: un array di tutti i fogli del foglio di lavoro.

`getSpreadsheetLocale()`

Restituisce le impostazioni internazionali del foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Indietro

String: le impostazioni internazionali del foglio di lavoro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSpreadsheetTheme()`

Restituisce il tema corrente del foglio di lavoro o null se non è applicato alcun tema.

// The code below returns the current theme of the spreadsheet.
const currentTheme =
    SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();

Indietro

SpreadsheetTheme: il tema attualmente applicato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSpreadsheetTimeZone()`

Recupera il fuso orario del foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Indietro

String: il fuso orario, specificato in formato "long" (ad esempio, "America/New_York", come indicato da Joda.org).

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getUrl()`

Restituisce l'URL del foglio di lavoro specificato.

const ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getUrl());

Indietro

String: l'URL del foglio di lavoro specificato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getViewers()`

Recupera l'elenco di visualizzatori e commentatori per questo Spreadsheet.

Indietro

User[]: un array di utenti con autorizzazione di visualizzazione o commento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideColumn(column)`

Nasconde la colonna o le colonne nell'intervallo specificato.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This hides the first column
let range = sheet.getRange('A1');
sheet.hideColumn(range);

// This hides the first 3 columns
range = sheet.getRange('A:C');
sheet.hideColumn(range);

Parametri

Nome	Tipo	Descrizione
`column`	`Range`	L'intervallo di colonne da nascondere.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideRow(row)`

Nasconde le righe nell'intervallo specificato.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This hides the first row
const range = sheet.getRange('A1');
sheet.hideRow(range);

Parametri

Nome	Tipo	Descrizione
`row`	`Range`	L'intervallo di righe da nascondere.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnAfter(afterPosition)`

Inserisce una colonna dopo la posizione della colonna specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

Parametri

Nome	Tipo	Descrizione
`afterPosition`	`Integer`	La colonna dopo la quale deve essere aggiunta la nuova colonna.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnBefore(beforePosition)`

Inserisce una colonna prima della posizione della colonna specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This inserts a column in the first column position
sheet.insertColumnBefore(1);

Parametri

Nome	Tipo	Descrizione
`beforePosition`	`Integer`	La colonna prima della quale deve essere aggiunta la nuova colonna.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnsAfter(afterPosition, howMany)`

Inserisce un determinato numero di colonne dopo la posizione della colonna specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Inserts two columns after the first column on the first sheet of the
// spreadsheet.
sheet.insertColumnsAfter(1, 2);

Parametri

Nome	Tipo	Descrizione
`afterPosition`	`Integer`	La colonna dopo la quale deve essere aggiunta la nuova colonna.
`howMany`	`Integer`	Il numero di colonne da inserire.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnsBefore(beforePosition, howMany)`

Inserisce un numero di colonne prima della posizione della colonna specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This inserts five columns before the first column
sheet.insertColumnsBefore(1, 5);

Parametri

Nome	Tipo	Descrizione
`beforePosition`	`Integer`	La colonna prima della quale deve essere aggiunta la nuova colonna.
`howMany`	`Integer`	Il numero di colonne da inserire.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertDataSourceSheet(spec)`

Inserisce un nuovo DataSourceSheet nel foglio di lavoro e avvia l'esecuzione dei dati. Come effetto collaterale, il nuovo foglio diventa anche il foglio attivo.

Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo specifico di origine dati.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Builds a data source specification.
// TODO (developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
                           .asBigQuery()
                           .setProjectId('project-id-1')
                           .setTableProjectId('bigquery-public-data')
                           .setDatasetId('ncaa_basketball')
                           .setTableId('mbb_historical_teams_games')
                           .build();

// Adds the data source and its data to the spreadsheet.
ss.insertDataSourceSheet(dataSourceSpec);

Parametri

Nome	Tipo	Descrizione
`spec`	`DataSourceSpec`	La specifica dell'origine dati da inserire.

Indietro

DataSourceSheet: il nuovo foglio dell'origine dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(blobSource, column, row)`

Inserisce un Spreadsheet come immagine nel documento in una determinata riga e colonna. Le dimensioni dell'immagine vengono recuperate dai contenuti del blob. La dimensione massima supportata per i blob è 2 MB.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

Parametri

Nome	Tipo	Descrizione
`blobSource`	`BlobSource`	Il blob contenente i contenuti, il tipo MIME e (facoltativamente) il nome dell'immagine.
`column`	`Integer`	La posizione della colonna.
`row`	`Integer`	La posizione della riga.

Indietro

OverGridImage: l'immagine inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(blobSource, column, row, offsetX, offsetY)`

Inserisce un Spreadsheet come immagine nel documento in una determinata riga e colonna, con un offset in pixel. Le dimensioni dell'immagine vengono recuperate dai contenuti del blob. La dimensione massima supportata del blob è 2 MB.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parametri

Nome	Tipo	Descrizione
`blobSource`	`BlobSource`	Il blob contenente i contenuti, il tipo MIME e (facoltativamente) il nome dell'immagine.
`column`	`Integer`	La posizione della colonna.
`row`	`Integer`	La posizione della riga.
`offsetX`	`Integer`	Lo scostamento orizzontale dall'angolo della cella in pixel.
`offsetY`	`Integer`	Lo scostamento verticale dall'angolo della cella in pixel.

Indietro

OverGridImage: l'immagine inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(url, column, row)`

Inserisce un'immagine nel documento in una determinata riga e colonna.

L'URL fornito deve essere accessibile pubblicamente.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

sheet.insertImage('https://www.google.com/images/srpr/logo3w.png', 1, 1);

Parametri

Nome	Tipo	Descrizione
`url`	`String`	L'URL dell'immagine.
`column`	`Integer`	La posizione della colonna della griglia.
`row`	`Integer`	La posizione della riga della griglia.

Indietro

OverGridImage: l'immagine inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(url, column, row, offsetX, offsetY)`

Inserisce un'immagine nel documento in una determinata riga e colonna, con un offset in pixel.

L'URL fornito deve essere accessibile pubblicamente.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

sheet.insertImage(
    'https://www.google.com/images/srpr/logo3w.png',
    1,
    1,
    10,
    10,
);

Parametri

Nome	Tipo	Descrizione
`url`	`String`	L'URL dell'immagine.
`column`	`Integer`	La posizione della colonna.
`row`	`Integer`	La posizione della riga.
`offsetX`	`Integer`	Lo scostamento orizzontale dall'angolo della cella in pixel.
`offsetY`	`Integer`	Lo scostamento verticale dall'angolo della cella in pixel.

Indietro

OverGridImage: l'immagine inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowAfter(afterPosition)`

Inserisce una riga dopo la posizione della riga specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This inserts a row after the first row position
sheet.insertRowAfter(1);

Parametri

Nome	Tipo	Descrizione
`afterPosition`	`Integer`	La riga dopo la quale deve essere aggiunta la nuova riga.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowBefore(beforePosition)`

Inserisce una riga prima della posizione della riga specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This inserts a row before the first row position
sheet.insertRowBefore(1);

Parametri

Nome	Tipo	Descrizione
`beforePosition`	`Integer`	La riga prima della quale deve essere aggiunta la nuova riga.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowsAfter(afterPosition, howMany)`

Inserisce un numero di righe dopo la posizione della riga specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

Parametri

Nome	Tipo	Descrizione
`afterPosition`	`Integer`	La riga dopo la quale devono essere aggiunte le nuove righe.
`howMany`	`Integer`	Il numero di righe da inserire.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowsBefore(beforePosition, howMany)`

Inserisce un numero di righe prima della posizione della riga specificata.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This inserts five rows before the first row
sheet.insertRowsBefore(1, 5);

Parametri

Nome	Tipo	Descrizione
`beforePosition`	`Integer`	La riga prima della quale devono essere aggiunte le nuove righe.
`howMany`	`Integer`	Il numero di righe da inserire.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet()`

Inserisce un nuovo foglio nel foglio di lavoro, utilizzando un nome predefinito. Il nuovo foglio diventa il foglio attivo.

const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet();

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetIndex)`

Inserisce un nuovo foglio nel foglio di lavoro all'indice specificato. Il nuovo foglio diventa il foglio attivo.

const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet(1);

Parametri

Nome	Tipo	Descrizione
`sheetIndex`	`Integer`	L'indice del foglio appena creato. Per inserire un foglio come primo nel foglio di lavoro, imposta il valore su 0.

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetIndex, options)`

Inserisce un nuovo foglio nel foglio di lavoro all'indice specificato e utilizza argomenti avanzati facoltativi. Il nuovo foglio diventa il foglio attivo.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const templateSheet = ss.getSheetByName('Sales');
ss.insertSheet(1, {template: templateSheet});

Parametri

Nome	Tipo	Descrizione
`sheetIndex`	`Integer`	L'indice del foglio appena creato. Per inserire un foglio come primo nel foglio di lavoro, imposta il valore su 0.
`options`	`Object`	Argomenti avanzati JavaScript facoltativi.

Parametri avanzati

Nome	Tipo	Descrizione
`template`	`Sheet`	Tutti i dati dell'oggetto foglio modello vengono copiati nel nuovo foglio. Il modello di foglio deve essere uno dei fogli dell'oggetto Foglio di lavoro.

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(options)`

Inserisce un nuovo foglio nel foglio di lavoro, utilizzando un nome predefinito e argomenti avanzati facoltativi. Il nuovo foglio diventa il foglio attivo.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const templateSheet = ss.getSheetByName('Sales');
ss.insertSheet({template: templateSheet});

Parametri

Nome	Tipo	Descrizione
`options`	`Object`	Argomenti avanzati JavaScript facoltativi, elencati di seguito.

Parametri avanzati

Nome	Tipo	Descrizione
`template`	`Sheet`	Tutti i dati dell'oggetto foglio modello vengono copiati nel nuovo foglio. Il modello di foglio deve essere uno dei fogli di questo oggetto Foglio di lavoro.

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName)`

Inserisce un nuovo foglio nel foglio di lavoro con il nome specificato. Il nuovo foglio diventa il foglio attivo.

const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet');

Parametri

Nome	Tipo	Descrizione
`sheetName`	`String`	Il nome del nuovo foglio.

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName, sheetIndex)`

Inserisce un nuovo foglio nel foglio di lavoro con il nome specificato all'indice specificato. Il nuovo foglio diventa il foglio attivo.

const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet', 1);

Parametri

Nome	Tipo	Descrizione
`sheetName`	`String`	Il nome del nuovo foglio.
`sheetIndex`	`Integer`	L'indice del foglio appena creato. Per inserire un foglio come primo nel foglio di lavoro, imposta il valore su 0.

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName, sheetIndex, options)`

Inserisce un nuovo foglio nel foglio di lavoro con il nome specificato all'indice specificato e utilizza argomenti avanzati facoltativi. Il nuovo foglio diventa il foglio attivo.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', 1, {template: templateSheet});

Parametri

Nome	Tipo	Descrizione
`sheetName`	`String`	Il nome del nuovo foglio.
`sheetIndex`	`Integer`	L'indice del foglio appena inserito. Per inserire un foglio come primo in un foglio di lavoro, impostalo su 0.
`options`	`Object`	Argomenti avanzati JavaScript facoltativi.

Parametri avanzati

Nome	Tipo	Descrizione
`template`	`Sheet`	Tutti i dati dell'oggetto foglio modello vengono copiati nel nuovo foglio. Il modello di foglio deve essere uno dei fogli dell'oggetto Foglio di lavoro.

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName, options)`

Inserisce un nuovo foglio nel foglio di lavoro con il nome specificato e utilizza argomenti avanzati facoltativi. Il nuovo foglio diventa il foglio attivo.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', {template: templateSheet});

Parametri

Nome	Tipo	Descrizione
`sheetName`	`String`	Il nome del nuovo foglio.
`options`	`Object`	Argomenti avanzati JavaScript facoltativi.

Parametri avanzati

Nome	Tipo	Descrizione
`template`	`Sheet`	Tutti i dati dell'oggetto foglio modello vengono copiati nel nuovo foglio. Il modello di foglio deve essere uno dei fogli dell'oggetto Foglio di lavoro.

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheetWithDataSourceTable(spec)`

Inserisce un nuovo foglio nel foglio di lavoro, crea un DataSourceTable che si estende su tutto il foglio con la specifica dell'origine dati fornita e avvia l'esecuzione dei dati. Come effetto collaterale, il nuovo foglio diventa il foglio attivo.

Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo specifico di origine dati.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Adds a sheet and sets cell A1 as the parameter cell.
const parameterCell = ss.insertSheet('parameterSheet').getRange('A1');

// Sets the value of the parameter cell to 'Duke'.
parameterCell.setValue('Duke');

const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' +
    '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL';

// Adds a data source with a query parameter.
// TODO(developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
                           .asBigQuery()
                           .setProjectId('project-id-1')
                           .setRawQuery(query)
                           .setParameterFromCell('SCHOOL', 'parameterSheet!A1')
                           .build();

// Adds sheets for the data source and data source table to the spreadsheet.
ss.insertSheetWithDataSourceTable(dataSourceSpec);

Parametri

Nome	Tipo	Descrizione
`spec`	`DataSourceSpec`	La specifica dell'origine dati da inserire.

Indietro

Sheet: il nuovo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isColumnHiddenByUser(columnPosition)`

Restituisce un valore che indica se la colonna specificata è nascosta all'utente.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Columns start at 1
Logger.log(sheet.isColumnHiddenByUser(1));

Parametri

Nome	Tipo	Descrizione
`columnPosition`	`Integer`	La posizione della colonna da esaminare.

Indietro

Boolean - true se la colonna è nascosta, false altrimenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isIterativeCalculationEnabled()`

Restituisce un valore che indica se il calcolo iterativo è attivato in questo foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Indietro

Boolean — true se il calcolo iterativo è attivato, false altrimenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isRowHiddenByFilter(rowPosition)`

Restituisce un valore che indica se la riga specificata è nascosta da un filtro (non da una visualizzazione filtrata).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

Parametri

Nome	Tipo	Descrizione
`rowPosition`	`Integer`	La posizione della riga da esaminare.

Indietro

Boolean: true se la riga è nascosta, false altrimenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isRowHiddenByUser(rowPosition)`

Restituisce un valore che indica se la riga specificata è nascosta dall'utente.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.isRowHiddenByUser(1));

Parametri

Nome	Tipo	Descrizione
`rowPosition`	`Integer`	La posizione della riga da esaminare.

Indietro

Boolean: true se la riga è nascosta, false altrimenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveActiveSheet(pos)`

Sposta il foglio attivo nella posizione specificata nell'elenco dei fogli. Genera un'eccezione se la posizione è negativa o maggiore del numero di fogli.

// This example assumes that there are 2 sheets in the current
// active spreadsheet: one named "first" in position 1 and another named
// "second" in position 2.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Gets the "first" sheet and activates it.
const sheet = spreadsheet.getSheetByName('first').activate();

// Logs 'Current index of sheet: 1'
console.log('Current index of sheet: %s', sheet.getIndex());

spreadsheet.moveActiveSheet(2);

// Logs 'New index of sheet: 2'
console.log('New index of sheet: %s', sheet.getIndex());

Parametri

Nome	Tipo	Descrizione
`pos`	`Integer`	La posizione con indice 1 in cui spostare il foglio attivo nell'elenco dei fogli.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveChartToObjectSheet(chart)`

Crea un nuovo foglio SheetType.OBJECT e sposta il grafico fornito. Se il grafico si trova già in un foglio, questo viene restituito senza crearne uno nuovo.

const sheet = SpreadsheetApp.getActiveSheet();
const chart = sheet.newChart().setPosition(1, 1, 0, 0).build();
sheet.insertChart(chart);
const objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);

Parametri

Nome	Tipo	Descrizione
`chart`	`EmbeddedChart`	Il grafico da spostare.

Indietro

Sheet: il foglio in cui si trova il grafico.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshAllDataSources()`

Aggiorna tutte le origini dati supportate e i relativi oggetti di origine dati collegati, ignorando quelli non validi.

Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo di origine dati specifico.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets the first data source sheet on the spreadsheet.
const dataSheet = ss.getDataSourceSheets()[0];

// Refreshes all data sources on the spreadsheet.
ss.refreshAllDataSources();

// Logs the last refreshed time of the first data source sheet.
console.log(
    `Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`,
);

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeEditor(emailAddress)`

Rimuove l'utente specificato dall'elenco degli editor del Spreadsheet. Questo metodo non impedisce agli utenti di accedere a Spreadsheet se appartengono a una classe di utenti che dispone di accesso generale, ad esempio se Spreadsheet è condiviso con l'intero dominio dell'utente o se Spreadsheet si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da rimuovere.

Indietro

Spreadsheet — This Spreadsheet, for chaining.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeEditor(user)`

Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Indietro

Spreadsheet — This Spreadsheet, for chaining.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeMenu(name)`

Rimuove un menu aggiunto da addMenu(name, subMenus). L'argomento name deve avere lo stesso valore della chiamata corrispondente a addMenu(name, subMenus).

// The onOpen function is executed automatically every time a Spreadsheet is
// loaded
function onOpen() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.addMenu('badMenu', [
    {name: 'remove bad menu', functionName: 'removeBadMenu'},
    {name: 'foo', functionName: 'foo'},
  ]);
}
function removeBadMenu() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.removeMenu(
      'badMenu');  // name must match the name used when added the menu
}
function foo() {
  // Do nothing
}

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome del menu da rimuovere.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeNamedRange(name)`

Elimina un intervallo denominato con il nome specificato. Genera un'eccezione se nel foglio di lavoro non viene trovato alcun intervallo con il nome specificato.

// The code below creates a new named range "foo", and then remove it.
const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange('foo', ss.getActiveRange());
ss.removeNamedRange('foo');

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome dell'intervallo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeViewer(emailAddress)`

Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del Spreadsheet. Questo metodo non ha alcun effetto se l'utente è un editor, non un visualizzatore o un commentatore. Questo metodo non impedisce inoltre agli utenti di accedere a Spreadsheet se appartengono a una classe di utenti che hanno accesso generale, ad esempio se Spreadsheet è condiviso con l'intero dominio dell'utente o se Spreadsheet si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da rimuovere.

Indietro

Spreadsheet — Questo Spreadsheet per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeViewer(user)`

Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del Spreadsheet. Questo metodo non ha alcun effetto se l'utente è un editor, non un visualizzatore. Questo metodo non impedisce agli utenti di accedere a Spreadsheet se appartengono a una classe di utenti che hanno accesso generale, ad esempio se Spreadsheet è condiviso con l'intero dominio dell'utente o se Spreadsheet si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Indietro

Spreadsheet — Questo Spreadsheet per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`rename(newName)`

Rinomina il documento.

const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.rename('This is the new name');

Parametri

Nome	Tipo	Descrizione
`newName`	`String`	Il nuovo nome del documento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`renameActiveSheet(newName)`

Rinomina il foglio attivo corrente con il nuovo nome specificato.

// The code below renames the active sheet to "Hello world"
SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet('Hello world');

Parametri

Nome	Tipo	Descrizione
`newName`	`String`	Il nuovo nome del foglio attivo corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`resetSpreadsheetTheme()`

Rimuove il tema applicato e imposta il tema predefinito nel foglio di lavoro.

// The code below applies default theme on the spreadsheet.
SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();

Indietro

SpreadsheetTheme: il tema predefinito.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveRange(range)`

Imposta l'intervallo specificato come active range nel foglio attivo, con la cella in alto a sinistra dell'intervallo come current cell.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const range = sheet.getRange('A1:D4');
sheet.setActiveRange(range);

const selection = sheet.getSelection();
// Current cell: A1
const currentCell = selection.getCurrentCell();
// Active Range: A1:D4
const activeRange = selection.getActiveRange();

Parametri

Nome	Tipo	Descrizione
`range`	`Range`	L'intervallo da impostare come intervallo attivo.

Indietro

Range: il nuovo intervallo attivo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveRangeList(rangeList)`

Imposta l'elenco specificato di intervalli come active ranges nel foglio attivo. L'ultimo intervallo nell'elenco è impostato come active range.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
sheet.setActiveRangeList(rangeList);

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

Parametri

Nome	Tipo	Descrizione
`rangeList`	`RangeList`	L'elenco degli intervalli da selezionare.

Indietro

RangeList: l'elenco di intervalli appena selezionato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSelection(range)`

Imposta la regione di selezione attiva per questo foglio.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D4');
sheet.setActiveSelection(range);

Parametri

Nome	Tipo	Descrizione
`range`	`Range`	L'intervallo da impostare come selezione attiva.

Indietro

Range: il nuovo intervallo attivo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSelection(a1Notation)`

Imposta la selezione attiva, come specificato nella notazione A1 o R1C1.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

sheet.setActiveSelection('A1:D4');

Parametri

Nome	Tipo	Descrizione
`a1Notation`	`String`	L'intervallo da impostare come attivo, specificato nella notazione A1 o R1C1.

Indietro

Range: il nuovo intervallo attivo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSheet(sheet)`

Imposta il foglio specificato come foglio attivo nel foglio di lavoro. L'interfaccia utente di Fogli Google mostra il foglio scelto, a meno che non appartenga a un altro foglio di lavoro.

// The code below makes the first sheet active in the active spreadsheet.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);

Parametri

Nome	Tipo	Descrizione
`sheet`	`Sheet`	Il foglio da impostare come foglio attivo.

Indietro

Sheet: il foglio attivo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSheet(sheet, restoreSelection)`

Imposta il foglio specificato come foglio attivo nel foglio di lavoro, con un'opzione per ripristinare la selezione più recente all'interno del foglio. L'interfaccia utente di Fogli Google mostra il foglio scelto, a meno che non appartenga a un altro foglio di lavoro.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const firstSheet = spreadsheet.getSheets()[0];
const secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
const range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Parametri

Nome	Tipo	Descrizione
`sheet`	`Sheet`	Il nuovo foglio attivo.
`restoreSelection`	`Boolean`	Se `true`, la selezione più recente del nuovo foglio attivo viene selezionata di nuovo quando il nuovo foglio diventa attivo; se `false`, il nuovo foglio diventa attivo senza modificare la selezione corrente.

Indietro

Sheet: il nuovo foglio attivo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setColumnWidth(columnPosition, width)`

Imposta la larghezza della colonna specificata in pixel.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(1, 200);

Parametri

Nome	Tipo	Descrizione
`columnPosition`	`Integer`	La posizione della colonna da impostare.
`width`	`Integer`	La larghezza in pixel da impostare.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setCurrentCell(cell)`

Imposta la cella specificata come current cell.

Se la cella specificata è presente in un intervallo già selezionato, questo intervallo diventa l'intervallo attivo con la cella come cella corrente.

Se la cella specificata non è presente in alcun intervallo selezionato, qualsiasi selezione esistente viene rimossa e la cella diventa la cella corrente e l'intervallo attivo.

Nota:il Range specificato deve essere costituito da una cella, altrimenti viene generata un'eccezione.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const cell = sheet.getRange('B5');
sheet.setCurrentCell(cell);

const selection = sheet.getSelection();
// Current cell: B5
const currentCell = selection.getCurrentCell();

Parametri

Nome	Tipo	Descrizione
`cell`	`Range`	La cella da impostare come cella corrente.

Indietro

Range: la cella corrente appena impostata.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFrozenColumns(columns)`

Blocca il numero specificato di colonne. Se è zero, non vengono bloccate colonne.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Freezes the first column
sheet.setFrozenColumns(1);

Parametri

Nome	Tipo	Descrizione
`columns`	`Integer`	Il numero di colonne da bloccare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFrozenRows(rows)`

Blocca il numero specificato di righe. Se è zero, non vengono bloccate righe.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Freezes the first row
sheet.setFrozenRows(1);

Parametri

Nome	Tipo	Descrizione
`rows`	`Integer`	Il numero di righe da bloccare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setIterativeCalculationConvergenceThreshold(minThreshold)`

Imposta il valore di soglia minimo per il calcolo iterativo. Quando i risultati di calcoli successivi differiscono di un valore inferiore a questo, il calcolo iterativo si interrompe. Questo valore deve essere non negativo e il valore predefinito è 0, 05.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Parametri

Nome	Tipo	Descrizione
`minThreshold`	`Number`	La soglia di convergenza minima (deve essere non negativa).

Indietro

Spreadsheet: questo foglio di lavoro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setIterativeCalculationEnabled(isEnabled)`

Imposta se il calcolo iterativo è attivato in questo foglio di lavoro. Se il numero massimo di cicli di calcolo e la soglia di convergenza non sono stati impostati in precedenza quando il calcolo viene attivato, i valori predefiniti sono 50 e 0,05 rispettivamente. Se uno dei due è stato impostato in precedenza, i valori precedenti vengono mantenuti.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Parametri

Nome	Tipo	Descrizione
`isEnabled`	`Boolean`	`true` se il calcolo iterativo deve essere abilitato; `false` altrimenti.

Indietro

Spreadsheet: questo foglio di lavoro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setMaxIterativeCalculationCycles(maxIterations)`

Imposta il numero massimo di iterazioni di calcolo da eseguire durante il calcolo iterativo. Questo valore deve essere compreso tra 1 e 10.000 (incluso) e il valore predefinito è 50.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Parametri

Nome	Tipo	Descrizione
`maxIterations`	`Integer`	Il numero massimo di iterazioni di calcolo (compreso tra 1 e 10.000).

Indietro

Spreadsheet: questo foglio di lavoro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNamedRange(name, range)`

Assegna un nome a un intervallo.

// The code below creates a new named range "TaxRates" in the active spreadsheet
const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange('TaxRates', SpreadsheetApp.getActiveRange());

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome da assegnare all'intervallo.
`range`	`Range`	La specifica dell'intervallo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRecalculationInterval(recalculationInterval)`

Imposta la frequenza di ricalcolo di questo foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Sets the  calculation interval for the spreadsheet to 'ON_CHANGE'.
const interval = ss.setRecalculationInterval(
    SpreadsheetApp.RecalculationInterval.ON_CHANGE,
);

// Logs the calculation interval to the console.
console.log(interval);

Parametri

Nome	Tipo	Descrizione
`recalculationInterval`	`RecalculationInterval`	Il nuovo intervallo di ricalcolo.

Indietro

Spreadsheet: questo foglio di lavoro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRowHeight(rowPosition, height)`

Imposta l'altezza della riga specificata in pixel. Per impostazione predefinita, le righe si espandono per adattarsi ai contenuti delle celle. Se vuoi forzare le righe a un'altezza specifica, utilizza Sheet.setRowHeightsForced(startRow, numRows, height).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(1, 200);

Parametri

Nome	Tipo	Descrizione
`rowPosition`	`Integer`	La posizione della riga da modificare.
`height`	`Integer`	L'altezza in pixel da impostare.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSpreadsheetLocale(locale)`

Imposta le impostazioni internazionali del foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Sets the spreadsheet locale.
ss.setSpreadsheetLocale('fr');

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Parametri

Nome	Tipo	Descrizione
`locale`	`String`	Il codice della lingua da utilizzare (ad esempio "en", "fr" o "en_US").

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSpreadsheetTheme(theme)`

Imposta un tema sul foglio di lavoro.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// The code below sets the second predefined theme as the current theme of the
// spreadsheet.
const predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes();
spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);

Parametri

Nome	Tipo	Descrizione
`theme`	`SpreadsheetTheme`	Il tema da applicare.

Indietro

SpreadsheetTheme: il nuovo tema corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSpreadsheetTimeZone(timezone)`

Imposta il fuso orario per il foglio di lavoro.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets spreadsheet, you can use
// SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Parametri

Nome	Tipo	Descrizione
`timezone`	`String`	Il fuso orario, specificato in formato "long" (ad esempio, "America/New_York", come elencato da Joda.org).

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`show(userInterface)`

Visualizza un componente dell'interfaccia utente personalizzato in una finestra di dialogo centrata nella finestra del browser dell'utente. L'esecuzione dello script lato server non è sospesa. Per comunicare con il lato server, il componente dell'interfaccia utente deve effettuare callback asincroni allo script lato server.

Se lo script lato server visualizzava in precedenza una finestra di dialogo che non è ancora stata chiusa, l'interfaccia utente della finestra di dialogo esistente viene sostituita con quella della finestra di dialogo appena richiesta.

Il seguente snippet di codice mostra una semplice applicazione HtmlService in una finestra di dialogo con titolo, altezza e larghezza specificati:

const htmlApp = HtmlService
                    .createHtmlOutput(
                        '<p>A change of speed, a change of style...</p>',
                        )
                    .setTitle('My HtmlService Application')
                    .setWidth(250)
                    .setHeight(300);

SpreadsheetApp.getActiveSpreadsheet().show(htmlApp);

// The script resumes execution immediately after showing the dialog.

Parametri

Nome	Tipo	Descrizione
`userInterface`	`Object`	Un `HtmlOutput`.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/script.container.ui

`sort(columnPosition)`

Ordina un foglio per colonna, in ordine crescente.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Sorts the sheet by the first column, ascending
sheet.sort(1);

Parametri

Nome	Tipo	Descrizione
`columnPosition`	`Integer`	La colonna in base a cui ordinare.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`sort(columnPosition, ascending)`

Ordina un foglio per colonna. Accetta un parametro per specificare l'ordine crescente o decrescente.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Sorts the sheet by the first column, descending
sheet.sort(1, false);

Parametri

Nome	Tipo	Descrizione
`columnPosition`	`Integer`	La colonna in base a cui ordinare.
`ascending`	`Boolean`	`true` per gli ordinamenti crescenti, `false` per quelli decrescenti.

Indietro

Sheet: il foglio, utile per il concatenamento dei metodi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`toast(msg)`

Mostra una finestra popup nell'angolo in basso a destra del foglio di lavoro con il messaggio specificato.

// Show a popup with the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started');

Parametri

Nome	Tipo	Descrizione
`msg`	`String`	Il messaggio da mostrare nella notifica di tipo toast.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`toast(msg, title)`

Mostra una finestra popup nell'angolo in basso a destra del foglio di lavoro con il messaggio e il titolo specificati.

// Show a popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');

Parametri

Nome	Tipo	Descrizione
`msg`	`String`	Il messaggio da mostrare nella notifica di tipo toast.
`title`	`String`	Il titolo facoltativo della notifica di tipo avviso.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`toast(msg, title, timeoutSeconds)`

Mostra una finestra popup nell'angolo in basso a destra del foglio di lavoro con il titolo e il messaggio specificati, che rimane visibile per un determinato periodo di tempo.

// Show a 3-second popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);

Parametri

Nome	Tipo	Descrizione
`msg`	`String`	Il messaggio da mostrare nella notifica di tipo toast.
`title`	`String`	Il titolo facoltativo della notifica di tipo avviso.
`timeoutSeconds`	`Number`	Il timeout in secondi; se `null`, la notifica toast è impostata su 5 secondi per impostazione predefinita; se negativo, la notifica toast rimane finché non viene chiusa.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`unhideColumn(column)`

Mostra la colonna nell'intervallo specificato.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This unhides the first column if it was previously hidden
const range = sheet.getRange('A1');
sheet.unhideColumn(range);

Parametri

Nome	Tipo	Descrizione
`column`	`Range`	L'intervallo da mostrare, se nascosto.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`unhideRow(row)`

Mostra la riga nell'intervallo specificato.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This unhides the first row if it was previously hidden
const range = sheet.getRange('A1');
sheet.unhideRow(range);

Parametri

Nome	Tipo	Descrizione
`row`	`Range`	L'intervallo da mostrare, se nascosto.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`updateMenu(name, subMenus)`

Aggiorna un menu aggiunto da addMenu(name, subMenus). Funziona esattamente come addMenu(name, subMenus).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const menuEntries = [];
menuEntries.push({name: 'Lone Menu Entry', functionName: 'function1'});
ss.updateMenu('addMenuExample', menuEntries);

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome del menu da aggiornare.
`subMenus`	`Object[]`	Un array di mappe JavaScript con parametri `name` e `functionName`. Puoi utilizzare le funzioni delle librerie incluse, ad esempio `Library.libFunction1`.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

Attende il completamento di tutte le esecuzioni correnti nel foglio di lavoro, con timeout dopo il numero di secondi fornito. Genera un'eccezione se le esecuzioni non vengono completate quando si verifica il timeout, ma non annulla le esecuzioni dei dati.

Parametri

Nome	Tipo	Descrizione
`timeoutInSeconds`	`Integer`	Il tempo di attesa per le esecuzioni dei dati, in secondi. Il massimo è 300 secondi.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Metodi ritirati

`getSheetProtection()`

Deprecato. Per i fogli di lavoro creati nella versione più recente di Fogli Google, utilizza Sheet.getProtections(type), che restituisce la classe Protection più potente. Sebbene questo metodo sia deprecato, rimane disponibile per compatibilità con la versione precedente di Fogli

Restituisce un'istanza PageProtection che descrive le autorizzazioni per il foglio corrente.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser('user@example.com');

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
const users = permissions.getUsers();
Logger.log(users);

Indietro

PageProtection: un oggetto che descrive le autorizzazioni di accesso al foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isAnonymousView()`

Deprecato. A partire da gennaio 2014 questa funzione è obsoleta e non disponibile nella nuova versione di Fogli Google.

Indica se il documento consente la visualizzazione anonima. Poiché questa funzionalità non è più supportata nella nuova versione di Fogli Google, utilizza File.getSharingAccess() e File.getSharingPermission().

// Determine if the document allows anonymous viewing via the Drive API.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const file = DriveApp.getFileById(ss.getId());
const access = file.getSharingAccess();
const permission = file.getSharingPermission();
const isAnonymousAccess = access === DriveApp.Access.ANYONE ||
    access === DriveApp.Access.ANYONE_WITH_LINK;
const isAnonymousEdit =
    isAnonymousAccess && permission !== DriveApp.Permission.NONE;

Indietro

Boolean: true se il documento consente la visualizzazione anonima, false altrimenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Vedi anche

Servizio Drive

`isAnonymousWrite()`

Deprecato. A partire da gennaio 2014 questa funzione è obsoleta e non disponibile nella nuova versione di Fogli Google.

Indica se il documento consente modifiche da parte di utenti anonimi. Poiché questa funzionalità non è più supportata nella nuova versione di Fogli Google, utilizza File.getSharingAccess() e File.getSharingPermission().

// Determine if the document allow anonymous edits via the Drive API.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const file = DriveApp.getFileById(ss.getId());
const access = file.getSharingAccess();
const permission = file.getSharingPermission();
const isAnonymousAccess = access === DriveApp.Access.ANYONE ||
    access === DriveApp.Access.ANYONE_WITH_LINK;
const isAnonymousEdit =
    isAnonymousAccess && permission === DriveApp.Permission.EDIT;

Indietro

Boolean: true se il documento consente la modifica anonima, false altrimenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Vedi anche

Servizio Drive

`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`

Deprecato. A partire da gennaio 2014 questa funzione è obsoleta e non disponibile nella nuova versione di Fogli Google.

Imposta i criteri del documento per la lettura e la scrittura anonime. Poiché questa funzionalità non è più supportata nella nuova versione di Fogli Google, utilizza File.setSharing(accessType, permissionType) come alternativa.

// Set the document's policy on anonymous reading and writing via the Drive API.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const file = DriveApp.getFileById(ss.getId());

// Set anonymous read.
file.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.VIEW);

// Set anonymous write.
file.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

// Disable anonymous access.
file.setSharing(DriveApp.Access.PRIVATE, file.getSharingPermission());

Parametri

Nome	Tipo	Descrizione
`anonymousReadAllowed`	`Boolean`	`true` per consentire le letture anonime; `false` altrimenti.
`anonymousWriteAllowed`	`Boolean`	`true` per consentire le letture anonime; `false` altrimenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Vedi anche

isAnonymousView()
isAnonymousWrite()
Servizio Drive

`setSheetProtection(permissions)`

Deprecato. Per i fogli di lavoro creati nella versione più recente di Fogli Google, utilizza Sheet.protect(), che restituisce la classe Protection più potente. Sebbene questo metodo sia deprecato, rimane disponibile per la compatibilità con la versione precedente di Fogli.

Imposta le autorizzazioni per il foglio corrente.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
const sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

Parametri

Nome	Tipo	Descrizione
`permissions`	`PageProtection`	L'oggetto delle autorizzazioni di accesso da impostare su questo foglio.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Class Spreadsheet Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Metodi

Metodi ritirati

Documentazione dettagliata

addDeveloperMetadata(key)

Parametri

Indietro

Autorizzazione

addDeveloperMetadata(key, visibility)

Parametri

Indietro

Autorizzazione

addDeveloperMetadata(key, value)

Parametri

Indietro

Autorizzazione

addDeveloperMetadata(key, value, visibility)

Parametri

Indietro

Autorizzazione

addEditor(emailAddress)

Parametri

Indietro

Autorizzazione

addEditor(user)

Parametri

Indietro

Autorizzazione

addEditors(emailAddresses)

Parametri

Indietro

Autorizzazione

addMenu(name, subMenus)

Parametri

Autorizzazione

addViewer(emailAddress)

Parametri

Indietro

Autorizzazione

addViewer(user)

Parametri

Indietro

Autorizzazione

addViewers(emailAddresses)

Parametri

Indietro

Autorizzazione

appendRow(rowContents)

Parametri

Indietro

Autorizzazione

autoResizeColumn(columnPosition)

Parametri

Indietro

Autorizzazione

copy(name)

Parametri

Indietro

Autorizzazione

createDeveloperMetadataFinder()

Indietro

createTextFinder(findText)

Parametri

Indietro

deleteActiveSheet()

Indietro

Autorizzazione

deleteColumn(columnPosition)

Parametri

Indietro

Autorizzazione

deleteColumns(columnPosition, howMany)

Parametri

Autorizzazione

deleteRow(rowPosition)

Parametri

Indietro

Autorizzazione

deleteRows(rowPosition, howMany)

Parametri

Class Spreadsheet

`addDeveloperMetadata(key)`

`addDeveloperMetadata(key, visibility)`

`addDeveloperMetadata(key, value)`

`addDeveloperMetadata(key, value, visibility)`

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addMenu(name, subMenus)`

`addViewer(emailAddress)`

`addViewer(user)`

`addViewers(emailAddresses)`

`appendRow(rowContents)`

`autoResizeColumn(columnPosition)`

`copy(name)`

`createDeveloperMetadataFinder()`

`createTextFinder(findText)`

`deleteActiveSheet()`

`deleteColumn(columnPosition)`

`deleteColumns(columnPosition, howMany)`

`deleteRow(rowPosition)`

`deleteRows(rowPosition, howMany)`

`deleteSheet(sheet)`

`duplicateActiveSheet()`

`getActiveCell()`

`getActiveRange()`

`getActiveRangeList()`

`getActiveSheet()`

`getAs(contentType)`

`getBandings()`

`getBlob()`

`getColumnWidth(columnPosition)`

`getCurrentCell()`

`getDataRange()`

`getDataSourceFormulas()`

`getDataSourcePivotTables()`

`getDataSourceRefreshSchedules()`

`getDataSourceSheets()`

`getDataSourceTables()`

`getDataSources()`

`getDeveloperMetadata()`

`getEditors()`

`getFormUrl()`

`getFrozenColumns()`

`getFrozenRows()`