Class Spreadsheet

Foglio di lavoro

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

Metodi

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

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

NomeTipoDescrizione
keyStringLa chiave per i nuovi metadati dello sviluppatore.

Invio

Spreadsheet: questo foglio di lavoro, per l'accodamento.

Autorizzazione

Gli script che utilizzano questo 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

NomeTipoDescrizione
keyStringLa chiave per i nuovi metadati dello sviluppatore.
visibilityDeveloperMetadataVisibilityLa visibilità dei nuovi metadati dello sviluppatore.

Invio

Spreadsheet: questo foglio di lavoro, per l'accodamento.

Autorizzazione

Gli script che utilizzano questo 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

NomeTipoDescrizione
keyStringLa chiave per i nuovi metadati dello sviluppatore.
valueStringIl valore per i nuovi metadati dello sviluppatore.

Invio

Spreadsheet: questo foglio di lavoro, per l'accodamento.

Autorizzazione

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

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

addDeveloperMetadata(key, value, visibility)

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

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

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

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

Parametri

NomeTipoDescrizione
keyStringLa chiave per i nuovi metadati dello sviluppatore.
valueStringIl valore per i nuovi metadati dello sviluppatore.
visibilityDeveloperMetadataVisibilityLa visibilità dei nuovi metadati dello sviluppatore.

Invio

Spreadsheet: questo foglio di lavoro, per l'accodamento.

Autorizzazione

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

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

addEditor(emailAddress)

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

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da aggiungere.

Invio

Spreadsheet: questo Spreadsheet, per l'accodamento.

Autorizzazione

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

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

addEditor(user)

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

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da aggiungere.

Invio

Spreadsheet: questo Spreadsheet, per l'accodamento.

Autorizzazione

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

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

addEditors(emailAddresses)

Aggiunge l'array di utenti specificato all'elenco degli editor di Spreadsheet. Se uno degli utenti faceva già parte dell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

Parametri

NomeTipoDescrizione
emailAddressesString[]Un array di indirizzi email degli utenti da aggiungere.

Invio

Spreadsheet: questo Spreadsheet, per l'accodamento.

Autorizzazione

Gli script che utilizzano questo 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 chiamarlo 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

NomeTipoDescrizione
nameStringIl nome del menu da creare.
subMenusObject[]Un array di mappe JavaScript con parametri name e functionName . Puoi utilizzare le funzioni delle librerie incluse, ad esempio Library.libFunction1.

Autorizzazione

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

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

addViewer(emailAddress)

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

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da aggiungere.

Invio

Spreadsheet: questo Spreadsheet, per l'accodamento.

Autorizzazione

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

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

addViewer(user)

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

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da aggiungere.

Invio

Spreadsheet: questo Spreadsheet, per l'accodamento.

Autorizzazione

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

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

addViewers(emailAddresses)

Aggiunge l'array di utenti specificato all'elenco degli spettatori per Spreadsheet. Se uno degli utenti faceva già parte dell'elenco degli editor, questo metodo non ha alcun effetto su di lui.

Parametri

NomeTipoDescrizione
emailAddressesString[]Un array di indirizzi email degli utenti da aggiungere.

Invio

Spreadsheet: questo Spreadsheet, per l'accodamento.

Autorizzazione

Gli script che utilizzano questo 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 dell'area dati corrente nel foglio. Se i contenuti di una cella iniziano con =, vengono interpretati 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

NomeTipoDescrizione
rowContentsObject[]Un array di valori da inserire dopo l'ultima riga del foglio.

Invio

Sheet: il foglio, utile per l'accodamento dei metodi.

Autorizzazione

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

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

autoResizeColumn(columnPosition)

Imposta la larghezza della colonna in modo che si adatti ai relativi 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

NomeTipoDescrizione
columnPositionIntegerLa posizione della colonna da ridimensionare.

Invio

Sheet: il foglio, utile per l'accodamento dei metodi

Autorizzazione

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

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

copy(name)

Copia il foglio di lavoro e restituisce quello nuovo.

// This code makes a copy of the current spreadsheet and names it appropriately
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.copy("Copy of " + ss.getName());

Parametri

NomeTipoDescrizione
nameStringIl nome della copia.

Invio

Spreadsheet: questo foglio di lavoro, per l'accodamento.

Autorizzazione

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

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

createDeveloperMetadataFinder()

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

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

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

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

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

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

Invio

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


createTextFinder(findText)

Crea un cercatore di testo per il foglio di lavoro, che può essere utilizzato per trovare e sostituire il testo al suo interno. 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

NomeTipoDescrizione
findTextStringIl testo da cercare.

Invio

TextFinder: il TextFinder per il foglio di lavoro.


deleteActiveSheet()

Consente di eliminare 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

NomeTipoDescrizione
columnPositionIntegerLa posizione della colonna, che inizia da 1 per la prima colonna.

Invio

Sheet: il foglio, utile per l'accodamento dei metodi

Autorizzazione

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

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

deleteColumns(columnPosition, howMany)

Consente di eliminare un numero di colonne a partire dalla posizione 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

NomeTipoDescrizione
columnPositionIntegerLa posizione della prima colonna da eliminare.
howManyIntegerIl 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)

Consente di eliminare la riga nella posizione specificata.

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

Parametri

NomeTipoDescrizione
rowPositionIntegerLa posizione della riga, che inizia da 1 per la prima riga.

Invio

Sheet: il foglio, utile per l'accodamento di 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)

Consente di eliminare un numero di righe a partire dalla posizione 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

NomeTipoDescrizione
rowPositionIntegerLa posizione della prima riga da eliminare.
howManyIntegerIl 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)

Consente di eliminare il foglio specificato.

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

Parametri

NomeTipoDescrizione
sheetSheetIl 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 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 la cella attualmente 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 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 in fase di ricalcolo attivo.

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 degli intervalli attivi nel foglio attivo o null se non sono presenti intervalli attivi.

Se è selezionato un singolo intervallo, il comportamento è simile a 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 in un foglio di lavoro è quello visualizzato nell'interfaccia utente del foglio di lavoro.

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 contenuti specificato. Questo metodo aggiunge l'estensione appropriata al nome file, ad esempio "myfile.pdf". Tuttavia, assume che la parte del nome file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".

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

Parametri

NomeTipoDescrizione
contentTypeStringIl tipo MIME a cui eseguire la conversione. Per la maggior parte dei blob, 'application/pdf' è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, sono validi anche 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. Per un documento di Documenti Google, è valido anche 'text/markdown'.

Invio

Blob: i dati come blob.


getBandings()

Restituisce tutte le fasce in questo foglio di lavoro.

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

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

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

Invio

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

Autorizzazione

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

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

getBlob()

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

Invio

Blob: i dati come blob.


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

NomeTipoDescrizione
columnPositionIntegerLa 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 esiste una cella corrente. La cella corrente è la cella attiva nell'interfaccia utente di Fogli Google ed è evidenziata da un bordi scuro. Non esiste mai più di una cella corrente. Quando un utente seleziona uno o più intervalli di celle, una delle celle nella selezione è la cella corrente.

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 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 del foglio di lavoro

Autorizzazione

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

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

getDataSourceFormulas()

Recupera tutte le formule dell'origine dati.

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

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

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

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

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 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

getDataSourceRefreshSchedules()

Recupera le pianificazioni di aggiornamento di questo foglio di lavoro.

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

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

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

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

Invio

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

Autorizzazione

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

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

getDataSourceSheets()

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

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

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

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

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

Invio

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

Autorizzazione

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

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

getDataSourceTables()

Recupera tutte le tabelle dell'origine dati.

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

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

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

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

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()

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

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

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

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

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

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()

Recupera l'elenco degli editor di 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 questo foglio di lavoro non ha un modulo associato. Se più moduli inviano risposte a questo foglio di lavoro, l'URL del modulo restituito è indeterminato. In alternativa, le associazioni degli URL dei moduli per foglio possono essere recuperate 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 che inserisce le risposte in questo foglio di lavoro oppure null se questo foglio di lavoro non ha un modulo associato.

Autorizzazione

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

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

getFrozenColumns()

Restituisce il numero di colonne bloccate.

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()

Restituisce un identificatore univoco per questo foglio di lavoro. L'ID di un 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 la chiave) univoco del foglio di lavoro.


getImages()

Restituisce tutte le immagini fuori griglia nel foglio.

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

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

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

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

Invio

OverGridImage[]: un array di immagini sopra la griglia.

Autorizzazione

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

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

getIterativeCalculationConvergenceThreshold()

Restituisce il valore di soglia utilizzato durante il calcolo iterativo. Quando i risultati dei calcoli successivi differiscono per 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 contenente 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 contenente 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 contenente 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 contenente contenuti

Autorizzazione

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

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

getMaxIterativeCalculationCycles()

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

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

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

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

Invio

Integer: il numero massimo di iterazioni di calcolo.

Autorizzazione

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

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

getName()

Restituisce il nome del documento.

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 in questo 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 in 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 i 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

NomeTipoDescrizione
typeProtectionTypeIl tipo di area protetta, SpreadsheetApp.ProtectionType.RANGE o SpreadsheetApp.ProtectionType.SHEET.

Invio

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

Autorizzazione

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

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

getRange(a1Notation)

Restituisce l'intervallo specificato nella notazione A1 o R1C1.

// Get a range A1:D4 on sheet titled "Invoices"
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

NomeTipoDescrizione
a1NotationStringL'intervallo da restituire, come specificato nella notazione A1 o 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ù fogli del foglio di lavoro utilizzano lo stesso nome di intervallo, specifica il nome del foglio senza virgolette aggiuntive, ad esempio getRangeByName('TaxRates') o getRangeByName('Sheet Name!TaxRates'), ma non getRangeByName('"Sheet Name"!TaxRates').

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

Parametri

NomeTipoDescrizione
nameStringIl nome dell'intervallo da recuperare.

Invio

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


getRangeList(a1Notations)

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

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

Parametri

NomeTipoDescrizione
a1NotationsString[]L'elenco degli intervalli da restituire, come specificato nella notazione A1 o R1C1.

Invio

RangeList: l'elenco di intervalli nella posizione designata

Autorizzazione

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

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

getRecalculationInterval()

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

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

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

Invio

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

Autorizzazione

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

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

getRowHeight(rowPosition)

Restituisce l'altezza in pixel della riga specificata.

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

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

Parametri

NomeTipoDescrizione
rowPositionIntegerLa posizione della riga da esaminare.

Invio

Integer: altezza riga in pixel

Autorizzazione

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

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

getSelection()

Restituisce il 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

NomeTipoDescrizione
nameStringIl 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 numero intero monotonicamente crescente assegnato al momento della creazione del foglio ed è indipendente dalla posizione del foglio. Questo è utile in combinazione con metodi come Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) che accettano un parametro gridId anziché un'istanza Sheet.

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

Logger.log(sheet.getSheetId());

Invio

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

Autorizzazione

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

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

getSheetName()

Restituisce il nome del foglio.

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 di valori per questo intervallo a partire dalle coordinate specificate. Un valore -1 fornito come posizione della riga o della colonna equivale all'ultima riga o colonna con 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

NomeTipoDescrizione
startRowIntegerLa posizione della riga iniziale.
startColumnIntegerLa posizione della colonna iniziale.
numRowsIntegerIl numero di righe per cui restituire i valori.
numColumnsIntegerIl numero di colonne per cui restituire i valori.

Invio

Object[][]: un array bidimensionale di valori

Autorizzazione

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

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

getSheets()

Recupera tutti i fogli di questo foglio di lavoro.

// The code below logs the name of the second sheet
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: la lingua 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: il tema attualmente applicato.

Autorizzazione

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

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

getSpreadsheetTimeZone()

Recupera il fuso orario del foglio di lavoro.

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

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

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

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

Invio

String: il fuso orario, specificato in formato "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 specificato.

Autorizzazione

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

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

getViewers()

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

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

NomeTipoDescrizione
columnRangeL'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

NomeTipoDescrizione
rowRangeL'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

NomeTipoDescrizione
afterPositionIntegerLa colonna dopo la quale deve essere aggiunta la nuova colonna.

Invio

Sheet: il foglio, utile per l'accodamento di 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

NomeTipoDescrizione
beforePositionIntegerLa colonna prima della quale deve essere aggiunta la nuova colonna.

Invio

Sheet: il foglio, utile per l'accodamento dei metodi

Autorizzazione

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

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

insertColumnsAfter(afterPosition, howMany)

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

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

NomeTipoDescrizione
afterPositionIntegerLa colonna dopo la quale deve essere aggiunta la nuova colonna.
howManyIntegerIl numero di colonne da inserire.

Invio

Sheet: il foglio, utile per l'accodamento dei metodi

Autorizzazione

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

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

insertColumnsBefore(beforePosition, howMany)

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

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

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

Parametri

NomeTipoDescrizione
beforePositionIntegerLa colonna prima della quale deve essere aggiunta la nuova colonna.
howManyIntegerIl numero di colonne da inserire.

Invio

Sheet: il foglio, utile per l'accodamento dei metodi

Autorizzazione

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

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

insertDataSourceSheet(spec)

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

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

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

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

// 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

NomeTipoDescrizione
specDataSourceSpecLa 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. Le dimensioni dell'immagine vengono recuperate dai contenuti del blob. Il limite massimo per le dimensioni del blob supportate è 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

NomeTipoDescrizione
blobSourceBlobSourceIl blob contenente i contenuti dell'immagine, il tipo MIME e (facoltativamente) il nome.
columnIntegerLa posizione della colonna.
rowIntegerLa 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 offset in pixel. Le dimensioni dell'immagine vengono recuperate dai contenuti del blob. La dimensione massima supportata per i blob è 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

NomeTipoDescrizione
blobSourceBlobSourceIl blob contenente i contenuti dell'immagine, il tipo MIME e (facoltativamente) il nome.
columnIntegerLa posizione della colonna.
rowIntegerLa posizione della riga.
offsetXIntegerLo scostamento orizzontale dall'angolo della cella in pixel.
offsetYIntegerLo scostamento 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

NomeTipoDescrizione
urlStringL'URL dell'immagine.
columnIntegerLa posizione della colonna della griglia.
rowIntegerLa 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 uno spostamento in 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

NomeTipoDescrizione
urlStringL'URL dell'immagine.
columnIntegerLa posizione della colonna.
rowIntegerLa posizione della riga.
offsetXIntegerLo scostamento orizzontale dall'angolo della cella in pixel.
offsetYIntegerLo scostamento 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

NomeTipoDescrizione
afterPositionIntegerLa riga dopo la quale deve essere aggiunta la nuova riga.

Invio

Sheet: il foglio, utile per l'accodamento di 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

NomeTipoDescrizione
beforePositionIntegerLa riga prima della quale deve essere aggiunta la nuova riga.

Invio

Sheet: il foglio, utile per l'accodamento di 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

NomeTipoDescrizione
afterPositionIntegerLa riga dopo la quale devono essere aggiunte le nuove righe.
howManyIntegerIl numero di righe da inserire.

Invio

Sheet: il foglio, utile per l'accodamento dei metodi

Autorizzazione

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

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

insertRowsBefore(beforePosition, howMany)

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

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

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

Parametri

NomeTipoDescrizione
beforePositionIntegerLa riga prima della quale devono essere aggiunte le nuove righe.
howManyIntegerIl numero di righe da inserire.

Invio

Sheet: il foglio, utile per l'accodamento di metodi

Autorizzazione

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

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

insertSheet()

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

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 un nuovo foglio nel foglio di lavoro nell'indice specificato. Il nuovo foglio diventa attivo.

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

Parametri

NomeTipoDescrizione
sheetIndexIntegerL'indice del foglio appena creato. Per inserire un foglio come primo 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 argomenti avanzati facoltativi. Il nuovo foglio diventa quello attivo.

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

Parametri

NomeTipoDescrizione
sheetIndexIntegerL'indice del foglio appena creato. Per inserire un foglio come primo nel foglio di lavoro, impostalo su 0.
optionsObjectArgomenti avanzati JavaScript facoltativi.

Parametri avanzati

NomeTipoDescrizione
templateSheetTutti i dati dell'oggetto foglio del modello vengono copiati nel nuovo foglio. Il modello di foglio deve essere uno dei fogli dell'oggetto FoglioDiLavoro.

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 predefinito e argomenti avanzati facoltativi. Il nuovo foglio diventa quello attivo.

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

Parametri

NomeTipoDescrizione
optionsObjectArgomenti avanzati JavaScript facoltativi, elencati di seguito.

Parametri avanzati

NomeTipoDescrizione
templateSheetTutti i dati dell'oggetto foglio del modello vengono copiati nel nuovo foglio. Il modello di 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 un nuovo foglio nel foglio di lavoro con il nome specificato. Il nuovo foglio diventa attivo.

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

Parametri

NomeTipoDescrizione
sheetNameStringIl 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 un nuovo foglio nel foglio di lavoro con il nome specificato nell'indice specificato. Il nuovo foglio diventa attivo.

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

Parametri

NomeTipoDescrizione
sheetNameStringIl nome del nuovo foglio.
sheetIndexIntegerL'indice del foglio appena creato. Per inserire un foglio come primo 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 un nuovo foglio nel foglio di lavoro con il nome specificato nell'indice specificato e utilizza gli argomenti avanzati facoltativi. Il nuovo foglio diventa quello attivo.

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

Parametri

NomeTipoDescrizione
sheetNameStringIl nome del nuovo foglio.
sheetIndexIntegerL'indice del foglio appena inserito. Per inserire un foglio come primo in un foglio di lavoro, impostalo su 0.
optionsObjectArgomenti avanzati JavaScript facoltativi.

Parametri avanzati

NomeTipoDescrizione
templateSheetTutti i dati dell'oggetto foglio del modello vengono copiati nel nuovo foglio. Il modello di foglio deve essere uno dei fogli dell'oggetto FoglioDiLavoro.

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 un nuovo foglio nel foglio di lavoro con il nome specificato e utilizza argomenti avanzati facoltativi. Il nuovo foglio diventa quello attivo.

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

Parametri

NomeTipoDescrizione
sheetNameStringIl nome del nuovo foglio.
optionsObjectArgomenti avanzati JavaScript facoltativi.

Parametri avanzati

NomeTipoDescrizione
templateSheetTutti i dati dell'oggetto foglio del modello vengono copiati nel nuovo foglio. Il modello di foglio deve essere uno dei fogli dell'oggetto FoglioDiLavoro.

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 copra l'intero foglio con la specifica dell'origine dati specificata e avvia l'esecuzione dei dati. Come effetto collaterale, il nuovo foglio diventa il foglio attivo.

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

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

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

// 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

NomeTipoDescrizione
specDataSourceSpecLa 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)

Restituisce 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

NomeTipoDescrizione
columnPositionIntegerLa 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()

Restituisce se il calcolo iterativo è attivato in questo foglio di lavoro.

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

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

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

Invio

Boolean - true se il calcolo iterativo è attivato, 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

isRowHiddenByFilter(rowPosition)

Restituisce 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

NomeTipoDescrizione
rowPositionIntegerLa 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)

Restituisce 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

NomeTipoDescrizione
rowPositionIntegerLa 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. Viene lanciata un'eccezione se la posizione è negativa o maggiore del numero di fogli.

// This example assumes that there are 2 sheets in the current
// active spreadsheet: one named "first" in position 1 and another named "second"
// in position 2.
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

NomeTipoDescrizione
posIntegerLa posizione dell'indice 1 in cui spostare il foglio attivo nell'elenco dei fogli.

Autorizzazione

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

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

moveChartToObjectSheet(chart)

Crea un nuovo foglio SheetType.OBJECT e sposta il grafico fornito al suo interno. Se il grafico è già su un proprio foglio, viene restituito quel foglio 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

NomeTipoDescrizione
chartEmbeddedChartIl 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