Accedere ai file di Fogli Google e modificarli. Le operazioni comuni includono l'aggiunta di nuovi fogli e l'aggiunta 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 metadati dello sviluppatore con la chiave, il valore e la visibilità specificati. |
addEditor(emailAddress) | Spreadsheet | Aggiunge l'utente specificato all'elenco di editor per Spreadsheet . |
addEditor(user) | Spreadsheet | Aggiunge l'utente specificato all'elenco di editor per Spreadsheet . |
addEditors(emailAddresses) | Spreadsheet | Aggiunge l'array di utenti specificato all'elenco di editor per Spreadsheet . |
addMenu(name, subMenus) | void | Crea un nuovo menu nell'interfaccia utente del foglio di lavoro. |
addViewer(emailAddress) | Spreadsheet | Aggiunge l'utente specificato all'elenco di visualizzatori per Spreadsheet . |
addViewer(user) | Spreadsheet | Aggiunge l'utente specificato all'elenco di visualizzatori per Spreadsheet . |
addViewers(emailAddresses) | Spreadsheet | Aggiunge l'array specificato di utenti all'elenco di visualizzatori per Spreadsheet . |
appendRow(rowContents) | Sheet | Aggiunge una riga alla parte inferiore della regione di dati corrente nel foglio. |
autoResizeColumn(columnPosition) | Sheet | Imposta la larghezza della colonna specificata per adattarla ai suoi contenuti. |
copy(name) | Spreadsheet | Copia il foglio di lavoro e restituisce il nuovo foglio di lavoro. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Restituisce un DeveloperMetadataFinder per trovare i metadati dello sviluppatore nell'ambito di
questo foglio di lavoro. |
createTextFinder(findText) | TextFinder | Crea una funzione di ricerca testo per il foglio di lavoro, che può essere utilizzata per trovare e sostituire testo all'interno nel foglio di lavoro. |
deleteActiveSheet() | Sheet | Elimina il foglio attualmente attivo. |
deleteColumn(columnPosition) | Sheet | Elimina la colonna nella posizione specificata. |
deleteColumns(columnPosition, howMany) | void | Elimina una serie di colonne a partire dalla posizione della colonna specificata. |
deleteRow(rowPosition) | Sheet | Elimina la riga nella posizione specificata per la riga. |
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 rende il 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 di intervalli attivi nel foglio attivo o null se non sono presenti intervalli attivi
intervalli di tempo. |
getActiveSheet() | Sheet | Recupera 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 contenuto specificato. |
getBandings() | Banding[] | Restituisce tutte le bande nel foglio di lavoro. |
getBlob() | Blob | Restituisce i dati all'interno dell'oggetto sotto forma di 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 una cella corrente. |
getDataRange() | Range | Restituisce un valore 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 del foglio di lavoro. |
getDataSourceSheets() | DataSourceSheet[] | Restituisce tutti i fogli di origine 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[] | Restituisce i metadati dello sviluppatore associati al foglio di lavoro di primo livello. |
getEditors() | User[] | Ottiene 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
a questo foglio di lavoro non è associato alcun modulo. |
getFrozenColumns() | Integer | Restituisce il numero di colonne bloccate. |
getFrozenRows() | Integer | Restituisce il numero di righe bloccate. |
getId() | String | Ottiene un identificatore univoco per questo foglio di lavoro. |
getImages() | OverGridImage[] | Restituisce tutte le immagini sopra la griglia del foglio. |
getIterativeCalculationConvergenceThreshold() | Number | Restituisce il valore di soglia utilizzato durante il calcolo iterativo. |
getLastColumn() | Integer | Restituisce la posizione dell'ultima colonna con contenuti. |
getLastRow() | Integer | Restituisce la posizione dell'ultima riga con contenuti. |
getMaxIterativeCalculationCycles() | Integer | Restituisce il numero massimo di iterazioni da utilizzare durante un calcolo iterativo. |
getName() | String | Recupera il nome del documento. |
getNamedRanges() | NamedRange[] | Recupera tutti gli intervalli denominati in questo foglio di lavoro. |
getNumSheets() | Integer | Restituisce il numero di fogli del foglio di lavoro. |
getOwner() | User | Restituisce il proprietario del documento o null per un documento di 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 fogli protetti nel foglio di lavoro. |
getRange(a1Notation) | Range | Restituisce l'intervallo come specificato nella notazione A1 o nella notazione 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 specificato
da un elenco non vuoto di notazioni A1 o R1C1. |
getRecalculationInterval() | RecalculationInterval | Restituisce l'intervallo di calcolo per il foglio di lavoro. |
getRowHeight(rowPosition) | Integer | Restituisce l'altezza in pixel della riga specificata. |
getSelection() | Selection | Restituisce il valore Selection corrente nel foglio di lavoro. |
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 dei valori per questo intervallo a partire dalle coordinate date. |
getSheets() | Sheet[] | Recupera tutti i fogli del foglio di lavoro. |
getSpreadsheetLocale() | String | Recupera 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 | Consente di acquisire il fuso orario del foglio di lavoro. |
getUrl() | String | Restituisce l'URL del foglio di lavoro specificato. |
getViewers() | User[] | Consente di acquisire l'elenco di visualizzatori e commentatori di 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
e l'offset di 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 di 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 nel foglio di lavoro un nuovo foglio nell'indice specificato. |
insertSheet(sheetIndex, options) | Sheet | Inserisce un nuovo foglio nel foglio di lavoro nell'indice specificato e utilizza il campo avanzato facoltativo argomenti. |
insertSheet(options) | Sheet | Inserisce un nuovo foglio nel foglio di lavoro utilizzando un nome del foglio predefinito e il campo avanzato facoltativo argomenti. |
insertSheet(sheetName) | Sheet | Inserisce nel foglio di lavoro un nuovo foglio con il nome specificato. |
insertSheet(sheetName, sheetIndex) | Sheet | Inserisce nel foglio di lavoro un nuovo foglio con il nome specificato nell'indice specificato. |
insertSheet(sheetName, sheetIndex, options) | Sheet | Inserisce nel foglio di lavoro un nuovo foglio con il nome specificato nell'indice specificato e utilizza argomenti avanzati facoltativi. |
insertSheet(sheetName, options) | Sheet | Inserisce nel foglio di lavoro un nuovo foglio con il nome specificato e utilizza il campo avanzato facoltativo argomenti. |
insertSheetWithDataSourceTable(spec) | Sheet | Inserisce un nuovo foglio nel foglio di lavoro, crea un DataSourceTable che copre
l'intero foglio con la specifica dell'origine dati specificata e avvia l'esecuzione dei dati. |
isColumnHiddenByUser(columnPosition) | Boolean | Indica se la colonna specificata è nascosta dall'utente. |
isIterativeCalculationEnabled() | Boolean | Indica se il calcolo iterativo è attivato nel foglio di lavoro. |
isRowHiddenByFilter(rowPosition) | Boolean | Indica se la riga specificata è nascosta da un filtro (non da una visualizzazione filtrata). |
isRowHiddenByUser(rowPosition) | Boolean | 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 al suo interno il grafico fornito. |
refreshAllDataSources() | void | Aggiorna tutte le origini dati supportate e i relativi oggetti delle origini dati collegati, saltando le origini dati non valide oggetti di origine dati. |
removeEditor(emailAddress) | Spreadsheet | Rimuove l'utente specificato dall'elenco degli editor per Spreadsheet . |
removeEditor(user) | Spreadsheet | Rimuove l'utente specificato dall'elenco degli editor per 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 per Spreadsheet . |
removeViewer(user) | Spreadsheet | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per 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 di intervalli specificato 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 nella notazione R1C1. |
setActiveSheet(sheet) | Sheet | Imposta il foglio specificato come foglio attivo nel foglio di lavoro. |
setActiveSheet(sheet, restoreSelection) | Sheet | Imposta il foglio in modo che sia attivo nel foglio di lavoro, con la possibilità di ripristinare il 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 minima 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 la fase iterativa calcolo. |
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 | Consente di impostare le impostazioni internazionali del foglio di lavoro. |
setSpreadsheetTheme(theme) | SpreadsheetTheme | Consente di impostare un tema nel 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 nel pannello area visibile. |
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 in questione. |
toast(msg, title) | void | Mostra una finestra popup nell'angolo in basso a destra del foglio di lavoro con il messaggio in questione e titolo. |
toast(msg, title, timeoutSeconds) | void | Mostra una finestra popup nell'angolo in basso a destra del foglio di lavoro con il titolo specificato e , che rimanga 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 | Consente di aggiornare 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 fornito il numero di secondi. |
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 sviluppatore. |
Invio
Spreadsheet
: foglio di lavoro per il collegamento.
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 sviluppatore. |
visibility | DeveloperMetadataVisibility | La visibilità dei nuovi metadati sviluppatore. |
Invio
Spreadsheet
: foglio di lavoro per il collegamento.
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 sviluppatore. |
value | String | Il valore dei nuovi metadati sviluppatore. |
Invio
Spreadsheet
: foglio di lavoro per il collegamento.
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 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 sviluppatore. |
value | String | Il valore dei nuovi metadati sviluppatore. |
visibility | DeveloperMetadataVisibility | La visibilità dei nuovi metadati sviluppatore. |
Invio
Spreadsheet
: foglio di lavoro per il collegamento.
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 di editor per Spreadsheet
. Se l'utente era già
nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da aggiungere. |
Invio
Spreadsheet
: 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
addEditor(user)
Aggiunge l'utente specificato all'elenco di editor per Spreadsheet
. Se l'utente era già
nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Invio
Spreadsheet
: 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
addEditors(emailAddresses)
Aggiunge l'array di utenti specificato all'elenco di editor per Spreadsheet
. Se uno dei
utenti erano già presenti nell'elenco dei visualizzatori, questo metodo li promuove dall'elenco dei
spettatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Invio
Spreadsheet
: 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
addMenu(name, subMenus)
Crea un nuovo menu nell'interfaccia utente del foglio di lavoro.
Ogni voce di menu esegue una funzione definita dall'utente. In genere, è consigliabile richiamarlo dalla funzione onOpen()
in modo che il menu venga creato automaticamente al caricamento del foglio di lavoro.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 i 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 di visualizzatori per Spreadsheet
. Se l'utente era già
nell'elenco degli editor, questo metodo non ha alcun effetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da aggiungere. |
Invio
Spreadsheet
: 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
addViewer(user)
Aggiunge l'utente specificato all'elenco di visualizzatori per Spreadsheet
. Se l'utente era già
nell'elenco degli editor, questo metodo non ha alcun effetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Invio
Spreadsheet
: 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
addViewers(emailAddresses)
Aggiunge l'array specificato di utenti all'elenco di visualizzatori per Spreadsheet
. Se uno dei
utenti erano già presenti nell'elenco degli editor, questo metodo non ha alcun effetto su di loro.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Invio
Spreadsheet
: 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
appendRow(rowContents)
Aggiunge una riga alla parte inferiore della regione di dati corrente nel foglio. Se i contenuti di una cella iniziano
con =
, viene interpretato come una formula.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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 per adattarla ai suoi contenuti.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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 il nuovo foglio di lavoro.
// This code makes a copy of the current spreadsheet and names it appropriately var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.copy("Copy of " + ss.getName());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome della copia. |
Invio
Spreadsheet
: foglio di lavoro per il collegamento.
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,
fogli, righe e 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());
Invio
DeveloperMetadataFinder
: uno strumento di ricerca dei metadati per gli sviluppatori per cercare i metadati nell'ambito di questo foglio di lavoro.
createTextFinder(findText)
Crea una funzione di ricerca testo per il foglio di lavoro, che può essere utilizzata per trovare e sostituire testo all'interno nel foglio di lavoro. La ricerca inizia dal primo foglio del foglio di lavoro.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Creates a text finder. var textFinder = spreadsheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the spreadsheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
findText | String | Il testo da cercare. |
Invio
TextFinder
: TextFinder
per il 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 var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();
Invio
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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 una serie di colonne a partire dalla posizione della colonna specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 per la riga.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. var ss = SpreadsheetApp.getActive(); var 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 rende il foglio attivo.
// The code below makes a duplicate of the active sheet SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();
Invio
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 il valore
cella evidenziata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Invio
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
se sono 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 da ricalcolare attivamente.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Invio
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
getActiveRangeList()
Restituisce l'elenco di intervalli attivi nel foglio attivo o null
se non sono presenti intervalli attivi
intervalli di tempo.
Se è selezionato un solo intervallo, si comporta come una chiamata getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Invio
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
getActiveSheet()
Recupera il foglio attivo in un foglio di lavoro.
Il foglio attivo di un foglio di lavoro è il foglio visualizzato nel foglio di lavoro nell'interfaccia utente.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
Invio
Sheet
: il foglio attivo nel foglio di lavoro.
getAs(contentType)
Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.
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, vengono visualizzati anche i valori 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png'
valida. Per un documento di Documenti Google è valido anche 'text/markdown' . |
Invio
Blob
: i dati come blob.
getBandings()
Restituisce tutte le bande nel 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());
Invio
Banding[]
: le bande 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
getBlob()
getColumnWidth(columnPosition)
Restituisce la larghezza in pixel della colonna specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
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 una cella corrente. La
la cella corrente è quella su cui è attivo lo stato attivo nell'UI di Fogli Google ed è evidenziata da un
bordo. Non è mai presente più di una cella corrente. Quando un utente seleziona uno o più intervalli di celle,
una delle celle della selezione è la cella corrente.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Invio
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 valore Range
corrispondente alle dimensioni in cui sono presenti i dati.
Questo è funzionalmente equivalente alla creazione di un intervallo delimitato da A1 e (Sheet.getLastColumn(), Sheet.getLastRow()).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
Invio
Range
: un intervallo costituito da tutti i dati presenti 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
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());
Invio
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());
Invio
DataSourcePivotTable[]
: un elenco di tabelle pivot di 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 del 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);
Invio
DataSourceRefreshSchedule[]
: le pianificazioni dell'aggiornamento 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
getDataSourceSheets()
Restituisce tutti i fogli di origine 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());
Invio
DataSourceSheet[]
: un array di tutti i fogli 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
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());
Invio
DataSourceTable[]
: un elenco di tabelle di 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());
Invio
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()
Restituisce 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());
Invio
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()
Ottiene l'elenco degli editor per questo Spreadsheet
.
Invio
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
a questo foglio di lavoro non è associato alcun modulo. 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 recuperata tramite il metodo Sheet.getFormUrl()
.
// 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);
Invio
String
: l'URL del modulo in cui le risposte vengono inserite in questo foglio di lavoro oppure null
se
a questo foglio di lavoro non è associato un modulo.
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Invio
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Invio
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()
Ottiene 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());
Invio
String
: l'ID (o chiave) univoco del foglio di lavoro.
getImages()
Restituisce tutte le immagini sopra la griglia del 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()); }
Invio
OverGridImage[]
: un array di immagini over-the-grid.
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 una differiscono di meno di questo valore, 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());
Invio
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 con contenuti.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Invio
Integer
: l'ultima colonna del foglio con 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Invio
Integer
: l'ultima riga del foglio con 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
getMaxIterativeCalculationCycles()
Restituisce il numero massimo di iterazioni da utilizzare durante un 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());
Invio
Integer
: il numero massimo di iterazioni del 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()
Recupera il nome del documento.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getName());
Invio
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. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { Logger.log(namedRanges[i].getName()); }
Invio
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 del foglio di lavoro.
// The code below logs the number of sheets in the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());
Invio
Integer
: il numero di fogli nel foglio di lavoro.
getOwner()
Restituisce il proprietario del documento o null
per un documento di un Drive condiviso.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var owner = ss.getOwner(); Logger.log(owner.getEmail());
Invio
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. var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet() .getPredefinedSpreadsheetThemes();
Invio
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 fogli protetti nel foglio di lavoro.
// Remove all range protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove all sheet protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET); for (var i = 0; i < protections.length; i++) { var 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 . |
Invio
Protection[]
: un array di oggetti che rappresentano tutti gli intervalli o 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 come specificato nella notazione A1 o nella notazione R1C1.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
a1Notation | String | L'intervallo da restituire, come specificato in notazione A1 o notazione R1C1. |
Invio
Range
: l'intervallo nella località 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ù
utilizzano lo stesso nome di intervallo, specifica il nome del foglio senza
virgolette, 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. var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates'); if (range != null) { Logger.log(range.getNumColumns()); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome dell'intervallo da ottenere. |
Invio
Range
: l'intervallo di celle con il nome specificato.
getRangeList(a1Notations)
Restituisce la raccolta RangeList
che rappresenta gli intervalli nello stesso foglio specificato
da un elenco non vuoto di notazioni A1 o R1C1.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
a1Notations | String[] | L'elenco di intervalli da restituire, come specificato nella notazione A1 o nella notazione R1C1. |
Invio
RangeList
: l'elenco di intervalli nella località 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 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'); // Logs the calculation interval for the spreadsheet to the console. console.log(ss.getRecalculationInterval().toString());
Invio
RecalculationInterval
: l'intervallo di calcolo 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
getRowHeight(rowPosition)
Restituisce l'altezza in pixel della riga specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Integer
: altezza della 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 il valore Selection
corrente nel foglio di lavoro.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Invio
Selection
: la selezione 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
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" var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses"); if (sheet != null) { Logger.log(sheet.getIndex()); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome del foglio da recuperare. |
Invio
Sheet
: il foglio con il nome specificato.
getSheetId()
Restituisce l'ID del foglio rappresentato da questo oggetto.
Si tratta di un ID del foglio univoco per il foglio di lavoro. L'ID è un modello monotonico
numero intero crescente assegnato al momento della creazione del foglio, indipendente dalla posizione del foglio. Questo
è utile in combinazione con metodi come Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
che utilizzano un parametro gridId
anziché un'istanza Sheet
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Invio
Integer
: un ID del 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Invio
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 dei valori per questo intervallo a partire dalle coordinate date. A -1 valore specificato come posizione di riga o colonna equivale a ottenere l'ultima riga o colonna che contiene dati nel foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var 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. |
Invio
Object[][]
: un array di valori bidimensionale
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 del foglio di lavoro.
// The code below logs the name of the second sheet var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets(); if (sheets.length > 1) { Logger.log(sheets[1].getName()); }
Invio
Sheet[]
: un array di tutti i fogli del foglio di lavoro.
getSpreadsheetLocale()
Recupera 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);
Invio
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. var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();
Invio
SpreadsheetTheme
: 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()
Consente di acquisire 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);
Invio
String
: il fuso orario, specificato in "long" (ad es. "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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getUrl());
Invio
String
: l'URL 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
getViewers()
Consente di acquisire l'elenco di visualizzatori e commentatori di Spreadsheet
.
Invio
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.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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
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'origine dati specifica
di testo.
// 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. |
Invio
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. L'immagine
viene recuperata
dai contenuti del blob. Le dimensioni massime supportate del blob sono 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobSource | BlobSource | Il blob contenente i contenuti dell'immagine, il tipo MIME e (facoltativamente) il nome. |
column | Integer | La posizione della colonna. |
row | Integer | La posizione della riga. |
Invio
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
e l'offset di pixel. Le dimensioni dell'immagine vengono recuperate dai contenuti del blob. Il blob massimo supportato
è di 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var 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 dell'immagine, il tipo MIME e (facoltativamente) il nome. |
column | Integer | La posizione della colonna. |
row | Integer | La posizione della riga. |
offsetX | Integer | L'offset orizzontale dell'angolo della cella in pixel. |
offsetY | Integer | L'offset verticale dall'angolo della cella in pixel. |
Invio
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 nella griglia. |
row | Integer | La posizione della riga della griglia. |
Invio
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 di pixel.
L'URL fornito deve essere accessibile pubblicamente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 | L'offset orizzontale dell'angolo della cella in pixel. |
offsetY | Integer | L'offset verticale dall'angolo della cella in pixel. |
Invio
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Sheet
: il foglio, utile per concatenare i 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 foglio attivo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet();
Invio
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 nel foglio di lavoro un nuovo foglio nell'indice specificato. Il nuovo foglio diventa attivo in un foglio di calcolo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sheetIndex | Integer | L'indice del foglio appena creato. Per inserire un foglio come primo in nel foglio di lavoro, impostalo su 0. |
Invio
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 nell'indice specificato e utilizza il campo avanzato facoltativo argomenti. Il nuovo foglio diventa il foglio attivo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 in nel foglio di lavoro, impostalo su 0. |
options | Object | Argomenti avanzati JavaScript facoltativi. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
template | Sheet | Tutti i dati dell'oggetto del foglio del modello vengono copiati nuovo foglio. Il modello del foglio deve essere uno dei fogli dell'oggetto Foglio di lavoro. |
Invio
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 del foglio predefinito e il campo avanzato facoltativo argomenti. Il nuovo foglio diventa il foglio attivo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 del foglio del modello vengono copiati nuovo foglio. Il modello del foglio deve essere uno dei fogli di questo oggetto Foglio di lavoro. |
Invio
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 nel foglio di lavoro un nuovo foglio con il nome specificato. Il nuovo foglio diventa attivo in un foglio di calcolo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sheetName | String | Il nome del nuovo foglio. |
Invio
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 nel foglio di lavoro un nuovo foglio con il nome specificato nell'indice specificato. Il nuovo foglio diventa il foglio attivo.
var 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 in nel foglio di lavoro, impostalo su 0. |
Invio
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 nel foglio di lavoro un nuovo foglio con il nome specificato nell'indice specificato e utilizza argomenti avanzati facoltativi. Il nuovo foglio diventa il foglio attivo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 nel foglio di lavoro, impostalo su 0. |
options | Object | Argomenti avanzati JavaScript facoltativi. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
template | Sheet | Tutti i dati dell'oggetto del foglio del modello vengono copiati nuovo foglio. Il modello del foglio deve essere uno dei fogli dell'oggetto Foglio di lavoro. |
Invio
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 nel foglio di lavoro un nuovo foglio con il nome specificato e utilizza il campo avanzato facoltativo argomenti. Il nuovo foglio diventa il foglio attivo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 del foglio del modello vengono copiati nuovo foglio. Il modello del foglio deve essere uno dei fogli dell'oggetto Foglio di lavoro. |
Invio
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 copre
l'intero foglio con la specifica dell'origine dati specificata e avvia l'esecuzione dei dati. Come lato
rende il nuovo foglio 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'origine dati specifica
di testo.
// 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. |
Invio
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)
Indica se la colonna specificata è nascosta dall'utente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Boolean
: true
se la colonna è nascosta, false
in caso contrario.
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()
Indica se il calcolo iterativo è attivato nel 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());
Invio
Boolean
: true
se è attivato il calcolo iterativo, 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)
Indica se la riga specificata è nascosta da un filtro (non da una visualizzazione filtrata).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Boolean
: true
se la riga è nascosta, false
in caso contrario.
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)
Indica se la riga specificata è nascosta dall'utente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Invio
Boolean
: true
se la riga è nascosta, false
in caso contrario.
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 è 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. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Gets the "first" sheet and activates it. var 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 di 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 al suo interno il grafico fornito. Se il grafico
è già nel proprio foglio, il foglio viene restituito senza crearne uno nuovo.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.newChart().setPosition(1, 1, 0, 0).build(); sheet.insertChart(chart); var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
chart | EmbeddedChart | Il grafico da spostare. |
Invio
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 delle origini dati collegati, saltando le origini dati non valide oggetti di origine dati.
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'); // 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 per Spreadsheet
. Questo metodo non
impedisce agli utenti di accedere a Spreadsheet
se appartengono a una classe di utenti con
accesso generale, ad esempio se Spreadsheet
viene condiviso con l'intera organizzazione
dominio 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. |
Invio
Spreadsheet
: 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
removeEditor(user)
Rimuove l'utente specificato dall'elenco degli editor per Spreadsheet
. Questo metodo non
impedisce agli utenti di accedere a Spreadsheet
se appartengono a una classe di utenti con
accesso generale, ad esempio se Spreadsheet
viene condiviso con l'intera organizzazione
dominio 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 |
---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Invio
Spreadsheet
: 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
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() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"}, {name: "foo", functionName: "foo"}]); } function removeBadMenu() { var 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 non è presente alcun intervallo con il nome specificato nel foglio di lavoro.
// The code below creates a new named range "foo", and then remove it. var 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 per Spreadsheet
. Questo
non ha effetto se l'utente è un editor, non un visualizzatore o un commentatore. Questo metodo
non impedisce agli utenti di accedere a Spreadsheet
se appartengono a una classe di utenti che
dispongono di accesso generale, ad esempio, se Spreadsheet
è condiviso con
l'intero dominio 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. |
Invio
Spreadsheet
: 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 per Spreadsheet
. Questo
non ha effetto se l'utente è un editor, non un visualizzatore. Inoltre, questo metodo non blocca
agli utenti di accedere a Spreadsheet
se appartengono a una classe di utenti con
accesso, ad esempio se Spreadsheet
è condiviso con l'intero dominio dell'utente oppure
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. |
Invio
Spreadsheet
: 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.
var 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();
Invio
SpreadsheetTheme
: 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
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo da impostare come intervallo attivo. |
Invio
Range
: l'intervallo appena 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 di intervalli specificato come active ranges
nel
foglio attivo. L'ultimo intervallo nell'elenco è impostato come active range
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rangeList | RangeList | L'elenco di intervalli da selezionare. |
Invio
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo da impostare come selezione attiva. |
Invio
Range
: l'intervallo appena 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 nella notazione R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
a1Notation | String | L'intervallo da impostare come attivo, come specificato nella notazione A1 o nella notazione R1C1. |
Invio
Range
: l'intervallo appena 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. Viene visualizzata la UI di Fogli Google 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. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sheet | Sheet | Il foglio da impostare come foglio attivo. |
Invio
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 in modo che sia attivo nel foglio di lavoro, con la possibilità di ripristinare il selezione più recente all'interno del foglio. Nella UI di Fogli Google viene visualizzato il foglio scelto, a meno che il foglio appartiene a un altro foglio di lavoro.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var firstSheet = spreadsheet.getSheets()[0]; var 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 var range = spreadsheet.getActiveSheet().getSelection().getActiveRange(); Logger.log(range.getA1Notation());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sheet | Sheet | Il nuovo foglio attivo. |
restoreSelection | Boolean | Tf true , la selezione più recente del nuovo foglio attivo
viene selezionato di nuovo quando il nuovo foglio diventa attivo. se false , il nuovo foglio
diventa attivo senza modificare la selezione corrente. |
Invio
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 da impostare della colonna specificata. |
width | Integer | La larghezza in pixel su cui impostarla. |
Invio
Sheet
: il foglio, utile per concatenare i 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, quell'intervallo diventa il intervallo attivo con la cella come cella corrente.
Se la cella specificata non è presente in alcun intervallo selezionato, la selezione esistente verrà rimosso e la cella diventa la cella corrente e l'intervallo attivo.
Nota: il valore Range
specificato deve essere composto da una cella, altrimenti genera un
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
cell | Range | La cella da impostare come cella corrente. |
Invio
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 il valore è zero, nessuna colonna è bloccata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 il valore è zero, non ci sono righe bloccate.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 minima per il calcolo iterativo. Quando i risultati di una differiscono di meno di questo valore, 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 minima di convergenza (deve essere non negativa). |
Invio
Spreadsheet
: foglio di lavoro per il collegamento.
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 viene raggiunto il numero massimo i cicli di calcolo e la soglia di convergenza non erano stati precedentemente impostati quando i valori predefiniti sono rispettivamente 50 e 0, 05. Se uno dei due è già stato impostato, conservano i valori precedenti.
// 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
negli altri casi. |
Invio
Spreadsheet
: foglio di lavoro per il collegamento.
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 la fase iterativa calcolo. 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 del calcolo (compreso tra 1 e 10.000). |
Invio
Spreadsheet
: foglio di lavoro per il collegamento.
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 var 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. |
Invio
Spreadsheet
: foglio di lavoro per il collegamento.
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 ingrandiscono per adattarsi ai contenuti della cella. Se
vuoi forzare le righe a un'altezza specificata, utilizza Sheet.setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 su cui impostarla. |
Invio
Sheet
: il foglio, utile per concatenare i 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)
Consente di impostare 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 di impostazione regionale 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)
Consente di impostare un tema nel foglio di lavoro.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // The code below sets the second predefined theme as the current theme of the spreadsheet. var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes(); spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
theme | SpreadsheetTheme | Il tema da applicare. |
Invio
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 "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 personalizzato dell'interfaccia utente in una finestra di dialogo centrata nel pannello area visibile. L'esecuzione dello script lato server non è sospeso. Per comunicare con lato server, il componente dell'interfaccia utente deve effettuare callback asincroni sul lato server lo script.
Se in precedenza lo script lato server mostrava una finestra di dialogo che non era ancora stata ignorata, la finestra di dialogo esistente viene sostituita con l'interfaccia utente 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:
var 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 alla quale ordinare. |
Invio
Sheet
: il foglio, utile per concatenare i 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. Utilizza un parametro per specificare la posizione crescente o decrescente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 alla quale ordinare. |
ascending | Boolean | true per l'ordinamento crescente, false per quello decrescente. |
Invio
Sheet
: il foglio, utile per concatenare i 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 in questione.
// Show a popup with the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
msg | String | Il messaggio da mostrare nell'avviso popup. |
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 in questione e titolo.
// 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 nell'avviso popup. |
title | String | Il titolo facoltativo del 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, timeoutSeconds)
Mostra una finestra popup nell'angolo in basso a destra del foglio di lavoro con il titolo specificato e , che rimanga 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 nell'avviso popup. |
title | String | Il titolo facoltativo del toast. |
timeoutSeconds | Number | Timeout in secondi. se null , l'avviso popup è di 5 secondi per impostazione predefinita;
se negativo, il toast rimane fino a quando non viene spento. |
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var 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)
Consente di aggiornare un menu aggiunto da addMenu(name, subMenus)
. Funziona esattamente come addMenu(name, subMenus)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 i 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 fornito il numero di secondi. Genera un'eccezione se le esecuzioni non vengono completate entro i tempi ma non annulla le esecuzioni dei dati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
timeoutInSeconds | Integer | Il tempo di attesa dell'esecuzione dei dati, in secondi. Il numero 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