Accedere ai fogli dei fogli di lavoro e modificarli. Le operazioni più comuni sono la ridenominazione di un foglio e l'accesso agli oggetti dell'intervallo dal foglio.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
activate() | Sheet | Attiva questo foglio. |
addDeveloperMetadata(key) | Sheet | Aggiunge al foglio i metadati dello sviluppatore con la chiave specificata. |
addDeveloperMetadata(key, visibility) | Sheet | Aggiunge al foglio i metadati dello sviluppatore con la chiave e la visibilità specificate. |
addDeveloperMetadata(key, value) | Sheet | Aggiunge al foglio i metadati dello sviluppatore con la chiave e il valore specificati. |
addDeveloperMetadata(key, value, visibility) | Sheet | Aggiunge al foglio i metadati dello sviluppatore con la chiave, il valore e la visibilità specificati. |
appendRow(rowContents) | Sheet | Accoda una riga alla fine dell'area di dati corrente nel foglio. |
asDataSourceSheet() | DataSourceSheet | Restituisce il foglio come DataSourceSheet se il foglio è di tipo SheetType.DATASOURCE o null in caso contrario. |
autoResizeColumn(columnPosition) | Sheet | Consente di impostare la larghezza della colonna specificata per adattarla ai suoi contenuti. |
autoResizeColumns(startColumn, numColumns) | Sheet | Imposta la larghezza di tutte le colonne a partire dalla posizione specificata per adattarsi ai relativi contenuti. |
autoResizeRows(startRow, numRows) | Sheet | Imposta l'altezza di tutte le righe a partire dalla posizione della riga specificata per adattarla ai relativi contenuti. |
clear() | Sheet | Cancella il foglio di contenuti e le informazioni di formattazione. |
clear(options) | Sheet | Consente di cancellare il foglio di contenuti e/o il formato, come specificato con le opzioni avanzate fornite. |
clearConditionalFormatRules() | void | Rimuove tutte le regole di formattazione condizionale dal foglio. |
clearContents() | Sheet | Cancella il foglio di contenuti, mantenendo le informazioni di formattazione. |
clearFormats() | Sheet | Cancella il foglio di formattazione, mantenendo i contenuti. |
clearNotes() | Sheet | Cancella dal foglio tutte le note. |
collapseAllColumnGroups() | Sheet | Comprime tutti i gruppi di colonne nel foglio. |
collapseAllRowGroups() | Sheet | Comprime tutti i gruppi di righe nel foglio. |
copyTo(spreadsheet) | Sheet | Copia il foglio in un determinato foglio di lavoro, che può essere lo stesso foglio di lavoro dell'origine. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Restituisce un valore DeveloperMetadataFinder per trovare i metadati dello sviluppatore nell'ambito di questo foglio. |
createTextFinder(findText) | TextFinder | Crea una ricerca di testo per il foglio, che può trovare e sostituire testo all'interno del foglio. |
deleteColumn(columnPosition) | Sheet | Elimina la colonna nella posizione specificata. |
deleteColumns(columnPosition, howMany) | void | Elimina un numero di colonne a partire dalla posizione della colonna specificata. |
deleteRow(rowPosition) | Sheet | Elimina la riga nella posizione specificata per la riga. |
deleteRows(rowPosition, howMany) | void | Elimina un numero di righe a partire dalla posizione della riga specificata. |
expandAllColumnGroups() | Sheet | Espande tutti i gruppi di colonne nel foglio. |
expandAllRowGroups() | Sheet | Espande tutti i gruppi di righe nel foglio. |
expandColumnGroupsUpToDepth(groupDepth) | Sheet | Espande tutti i gruppi di colonne fino alla profondità specificata e comprime tutti gli altri. |
expandRowGroupsUpToDepth(groupDepth) | Sheet | Espande tutti i gruppi di righe fino alla profondità specificata e comprime tutti gli altri. |
getActiveCell() | Range | Restituisce la cella attiva in questo foglio. |
getActiveRange() | Range | Restituisce l'intervallo selezionato nel foglio attivo oppure null se non è presente alcun intervallo attivo. |
getActiveRangeList() | RangeList | Restituisce l'elenco di intervalli attivi nel foglio attivo o null se non sono presenti intervalli attivi. |
getBandings() | Banding[] | Restituisce tutte le bande in questo foglio. |
getCharts() | EmbeddedChart[] | Restituisce un array di grafici in questo foglio. |
getColumnGroup(columnIndex, groupDepth) | Group | Restituisce il gruppo di colonne alla profondità dell'indice e del gruppo specificati. |
getColumnGroupControlPosition() | GroupControlTogglePosition | Restituisce GroupControlTogglePosition per tutti i gruppi di colonne nel foglio. |
getColumnGroupDepth(columnIndex) | Integer | Restituisce la profondità del gruppo della colonna nell'indice specificato. |
getColumnWidth(columnPosition) | Integer | Restituisce la larghezza in pixel della colonna specificata. |
getConditionalFormatRules() | ConditionalFormatRule[] | Visualizza tutte le regole di formattazione condizionale in questo foglio. |
getCurrentCell() | Range | Restituisce la cella corrente nel foglio attivo o null se non c'è alcuna cella corrente. |
getDataRange() | Range | Restituisce un valore Range corrispondente alle dimensioni in cui sono presenti i dati. |
getDataSourceFormulas() | DataSourceFormula[] | Restituisce tutte le formule dell'origine dati. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Restituisce tutte le tabelle pivot dell'origine dati. |
getDataSourceTables() | DataSourceTable[] | Restituisce tutte le tabelle dell'origine dati. |
getDeveloperMetadata() | DeveloperMetadata[] | Ottieni tutti i metadati dello sviluppatore associati a questo foglio. |
getDrawings() | Drawing[] | Restituisce un array di disegni nel foglio. |
getFilter() | Filter | Restituisce il filtro in questo foglio o null se non è presente alcun filtro. |
getFormUrl() | String | Restituisce l'URL del modulo che invia le risposte a questo foglio oppure null se il foglio non ha alcun modulo associato. |
getFrozenColumns() | Integer | Restituisce il numero di colonne bloccate. |
getFrozenRows() | Integer | Restituisce il numero di righe bloccate. |
getImages() | OverGridImage[] | Restituisce tutte le immagini over-the-grid nel foglio. |
getIndex() | Integer | Restituisce la posizione del foglio nel foglio di lavoro principale. |
getLastColumn() | Integer | Restituisce la posizione dell'ultima colonna con contenuti. |
getLastRow() | Integer | Restituisce la posizione dell'ultima riga con contenuti. |
getMaxColumns() | Integer | Restituisce il numero corrente di colonne nel foglio, indipendentemente dal contenuto. |
getMaxRows() | Integer | Restituisce il numero corrente di righe del foglio, indipendentemente dai contenuti. |
getName() | String | Restituisce il nome del foglio. |
getNamedRanges() | NamedRange[] | Restituisce tutti gli intervalli denominati in questo foglio. |
getParent() | Spreadsheet | Restituisce il valore Spreadsheet che contiene il foglio. |
getPivotTables() | PivotTable[] | Restituisce tutte le tabelle pivot di questo foglio. |
getProtections(type) | Protection[] | Restituisce un array di oggetti che rappresentano tutti gli intervalli protetti nel foglio o un array di un singolo elemento che rappresenta la protezione sul foglio stesso. |
getRange(row, column) | Range | Restituisce l'intervallo con la cella superiore sinistra alle coordinate fornite. |
getRange(row, column, numRows) | Range | Restituisce l'intervallo con la cella in alto a sinistra nelle coordinate specificate e con il numero di righe specificato. |
getRange(row, column, numRows, numColumns) | Range | Restituisce l'intervallo con la cella in alto a sinistra alle coordinate fornite con il numero specificato di righe e colonne. |
getRange(a1Notation) | Range | Restituisce l'intervallo come specificato nella notazione A1 o nella notazione R1C1. |
getRangeList(a1Notations) | RangeList | Restituisce la raccolta RangeList che rappresenta gli intervalli nello stesso foglio specificati da un elenco non vuoto di notazioni A1 o R1C1. |
getRowGroup(rowIndex, groupDepth) | Group | Restituisce il gruppo di righe alla profondità dell'indice e del gruppo specificati. |
getRowGroupControlPosition() | GroupControlTogglePosition | Restituisce GroupControlTogglePosition per tutti i gruppi di righe nel foglio. |
getRowGroupDepth(rowIndex) | Integer | Restituisce la profondità del gruppo della riga nell'indice specificato. |
getRowHeight(rowPosition) | Integer | Restituisce l'altezza in pixel della riga specificata. |
getSelection() | Selection | Restituisce il valore Selection corrente nel foglio di lavoro. |
getSheetId() | Integer | Restituisce l'ID del foglio rappresentato da questo oggetto. |
getSheetName() | String | Restituisce il nome del foglio. |
getSheetValues(startRow, startColumn, numRows, numColumns) | Object[][] | Restituisce la griglia rettangolare di valori per questo intervallo a partire dalle coordinate specificate. |
getSlicers() | Slicer[] | Restituisce un array di controlli filtro sul foglio. |
getTabColorObject() | Color | Restituisce il colore della scheda del foglio o null se la scheda del foglio non è colorata. |
getType() | SheetType | Restituisce il tipo di foglio. |
hasHiddenGridlines() | Boolean | Restituisce true se le linee della griglia del foglio sono nascoste. In caso contrario, restituisce false . |
hideColumn(column) | void | Nasconde la colonna o le colonne nell'intervallo specificato. |
hideColumns(columnIndex) | void | Nasconde una singola colonna nell'indice specificato. |
hideColumns(columnIndex, numColumns) | void | Nasconde una o più colonne consecutive che iniziano in corrispondenza dell'indice specificato. |
hideRow(row) | void | Nasconde le righe nell'intervallo specificato. |
hideRows(rowIndex) | void | Nasconde la riga nell'indice specificato. |
hideRows(rowIndex, numRows) | void | Nasconde una o più righe consecutive che iniziano in corrispondenza dell'indice specificato. |
hideSheet() | Sheet | Nasconde questo foglio. |
insertChart(chart) | void | Aggiunge un nuovo grafico a questo foglio. |
insertColumnAfter(afterPosition) | Sheet | Inserisce una colonna dopo la posizione della colonna specificata. |
insertColumnBefore(beforePosition) | Sheet | Inserisce una colonna prima della posizione della colonna specificata. |
insertColumns(columnIndex) | void | Inserisce una colonna vuota in un foglio nella posizione specificata. |
insertColumns(columnIndex, numColumns) | void | Inserisce una o più colonne vuote consecutive in un foglio a partire dalla posizione specificata. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Inserisce un determinato numero di colonne dopo la posizione della colonna specificata. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Inserisce un numero di colonne prima della posizione della colonna specificata. |
insertImage(blobSource, column, row) | OverGridImage | Inserisce un elemento BlobSource come immagine nel documento in una determinata riga e colonna. |
insertImage(blobSource, column, row, offsetX, offsetY) | OverGridImage | Inserisce un valore BlobSource come immagine nel documento in una determinata riga e colonna, con un offset di pixel. |
insertImage(url, column, row) | OverGridImage | Inserisce un'immagine nel documento in una determinata riga e colonna. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Inserisce un'immagine nel documento in una determinata riga e colonna, con un offset di pixel. |
insertRowAfter(afterPosition) | Sheet | Inserisce una riga dopo la posizione della riga specificata. |
insertRowBefore(beforePosition) | Sheet | Inserisce una riga prima della posizione della riga specificata. |
insertRows(rowIndex) | void | Inserisce una riga vuota in un foglio nella posizione specificata. |
insertRows(rowIndex, numRows) | void | Inserisce una o più righe vuote consecutive in un foglio che inizia dalla posizione specificata. |
insertRowsAfter(afterPosition, howMany) | Sheet | Inserisce un numero di righe dopo la posizione della riga specificata. |
insertRowsBefore(beforePosition, howMany) | Sheet | Inserisce un numero di righe prima della posizione della riga specificata. |
insertSlicer(range, anchorRowPos, anchorColPos) | Slicer | Aggiunge un nuovo controllo filtro a questo foglio. |
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY) | Slicer | Aggiunge un nuovo controllo filtro a questo foglio. |
isColumnHiddenByUser(columnPosition) | Boolean | Indica se la colonna specificata è nascosta dall'utente. |
isRightToLeft() | Boolean | Restituisce true se il layout del foglio è da destra a sinistra. |
isRowHiddenByFilter(rowPosition) | Boolean | Restituisce se la riga specificata è nascosta da un filtro (non da una visualizzazione filtrata). |
isRowHiddenByUser(rowPosition) | Boolean | Restituisce se la riga specificata è nascosta dall'utente. |
isSheetHidden() | Boolean | Restituisce true se il foglio è attualmente nascosto. |
moveColumns(columnSpec, destinationIndex) | void | Consente di spostare le colonne selezionate dall'intervallo specificato nella posizione indicata dal destinationIndex . |
moveRows(rowSpec, destinationIndex) | void | Consente di spostare le righe selezionate dall'intervallo specificato nella posizione indicata dal destinationIndex . |
newChart() | EmbeddedChartBuilder | Restituisce un generatore per creare un nuovo grafico per questo foglio. |
protect() | Protection | Crea un oggetto in grado di proteggere il foglio dalla modifica, tranne che per gli utenti che dispongono dell'autorizzazione. |
removeChart(chart) | void | Rimuove un grafico dal foglio principale. |
setActiveRange(range) | Range | Imposta l'intervallo specificato come active range nel foglio attivo, con
la cella in alto a sinistra nell'intervallo come current cell . |
setActiveRangeList(rangeList) | RangeList | Imposta l'elenco specificato di intervalli come active ranges nel
foglio attivo. |
setActiveSelection(range) | Range | Imposta la regione di selezione attiva per questo foglio. |
setActiveSelection(a1Notation) | Range | Imposta la selezione attiva, come specificato nella notazione A1 o R1C1. |
setColumnGroupControlPosition(position) | Sheet | Imposta la posizione del pulsante di attivazione/disattivazione del gruppo di colonne sul foglio. |
setColumnWidth(columnPosition, width) | Sheet | Imposta la larghezza della colonna specificata in pixel. |
setColumnWidths(startColumn, numColumns, width) | Sheet | Imposta la larghezza delle colonne specificate in pixel. |
setConditionalFormatRules(rules) | void | Sostituisce tutte le regole di formattazione condizionale attualmente esistenti nel foglio con le regole di input. |
setCurrentCell(cell) | Range | Imposta la cella specificata come current cell . |
setFrozenColumns(columns) | void | Blocca il numero di colonne specificato. |
setFrozenRows(rows) | void | Blocca il numero specificato di righe. |
setHiddenGridlines(hideGridlines) | Sheet | Nasconde o mostra le linee della griglia del foglio. |
setName(name) | Sheet | Imposta il nome del foglio. |
setRightToLeft(rightToLeft) | Sheet | Consente di impostare o annullare l'impostazione del layout del foglio da destra a sinistra. |
setRowGroupControlPosition(position) | Sheet | Imposta la posizione del pulsante di attivazione/disattivazione del controllo del gruppo di righe sul foglio. |
setRowHeight(rowPosition, height) | Sheet | Imposta l'altezza in pixel della riga specificata. |
setRowHeights(startRow, numRows, height) | Sheet | Imposta l'altezza in pixel delle righe specificate. |
setRowHeightsForced(startRow, numRows, height) | Sheet | Imposta l'altezza in pixel delle righe specificate. |
setTabColor(color) | Sheet | Imposta il colore della scheda del foglio. |
setTabColorObject(color) | Sheet | Imposta il colore della scheda del foglio. |
showColumns(columnIndex) | void | Mostra la colonna nell'indice specificato. |
showColumns(columnIndex, numColumns) | void | Mostra una o più colonne consecutive a partire dall'indice specificato. |
showRows(rowIndex) | void | Mostra la riga nell'indice specificato. |
showRows(rowIndex, numRows) | void | Mostra una o più righe consecutive a partire dall'indice specificato. |
showSheet() | Sheet | Rende visibile il foglio. |
sort(columnPosition) | Sheet | Ordina un foglio per colonna, in ordine crescente. |
sort(columnPosition, ascending) | Sheet | Ordina un foglio per colonna. |
unhideColumn(column) | void | Mostra la colonna nell'intervallo specificato. |
unhideRow(row) | void | Mostra la riga nell'intervallo specificato. |
updateChart(chart) | void | Aggiorna il grafico in questo foglio. |
Documentazione dettagliata
activate()
Attiva questo foglio. Non altera il foglio stesso, ma solo la nozione di foglio attivo del padre.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.activate();
Ritorni
Sheet
: il foglio appena attivo.
addDeveloperMetadata(key)
Aggiunge al foglio i metadati dello sviluppatore con la chiave specificata.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' to the developer metadata for the sheet. sheet.addDeveloperMetadata('NAME'); // Gets the updated metadata info and logs it to the console. console.log(sheet.getDeveloperMetadata()[0].getKey());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
key | String | La chiave per i nuovi metadati dello sviluppatore. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Aggiunge al foglio 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'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' and sets the developer metadata visibility to PROJECT // for the sheet. sheet.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
key | String | La chiave per i nuovi metadati dello sviluppatore. |
visibility | DeveloperMetadataVisibility | La visibilità dei nuovi metadati dello sviluppatore. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Aggiunge al foglio 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'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for the sheet. sheet.addDeveloperMetadata('COMPANY', 'TECH'); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
key | String | La chiave per i nuovi metadati dello sviluppatore. |
value | String | Il valore dei nuovi metadati dello sviluppatore. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Aggiunge al foglio 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'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and sets the // visibility to DOCUMENT for the sheet. sheet.addDeveloperMetadata( 'COMPANY', 'TECH', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
key | String | La chiave per i nuovi metadati dello sviluppatore. |
value | String | Il valore dei nuovi metadati dello sviluppatore. |
visibility | DeveloperMetadataVisibility | La visibilità dei nuovi metadati dello sviluppatore. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
Accoda una riga alla fine dell'area di 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
Nome | Tipo | Descrizione |
---|---|---|
rowContents | Object[] | Un array di valori da inserire dopo l'ultima riga del foglio. |
Ritorni
Sheet
: il foglio, utile per il concatenamento dei metodi.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asDataSourceSheet()
Restituisce il foglio come DataSourceSheet
se il foglio è di tipo SheetType.DATASOURCE
o null
in caso contrario.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the data source sheet value if the sheet is of type // SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value. const dataSourceSheet = sheet.asDataSourceSheet(); // Gets the data source sheet value and logs it to the console. console.log(dataSourceSheet); console.log(sheet.getType().toString());
Ritorni
DataSourceSheet
: un 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
autoResizeColumn(columnPosition)
Consente di impostare la larghezza della colonna specificata per adattarla ai suoi contenuti.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnPosition | Integer | La posizione della colonna da ridimensionare. |
Ritorni
Sheet
: il foglio, utile per il collegamento 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
autoResizeColumns(startColumn, numColumns)
Imposta la larghezza di tutte le colonne a partire dalla posizione specificata per adattarsi ai relativi contenuti.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 columns to a width that fits their text. sheet.autoResizeColumns(1, 15);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startColumn | Integer | La colonna iniziale da ridimensionare automaticamente. |
numColumns | Integer | Il numero di colonne da ridimensionare automaticamente. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeRows(startRow, numRows)
Imposta l'altezza di tutte le righe a partire dalla posizione della riga specificata per adattarla ai relativi contenuti.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 rows to a height that fits their text. sheet.autoResizeRows(1, 15);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startRow | Integer | La riga iniziale da ridimensionare automaticamente. |
numRows | Integer | Il numero di righe da ridimensionare automaticamente. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Cancella il foglio di contenuti e le informazioni di formattazione.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clear();
Ritorni
Sheet
: foglio cancellato.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Consente di cancellare il foglio di contenuti e/o il formato, come specificato con le opzioni avanzate fornite.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.clear({ formatOnly: true, contentsOnly: true });
Parametri
Nome | Tipo | Descrizione |
---|---|---|
options | Object | Una mappa JavaScript contenente le opzioni avanzate elencate di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
contentsOnly | Boolean | Indica se cancellare i contenuti. |
formatOnly | Boolean | Indica se cancellare il formato. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearConditionalFormatRules()
Rimuove tutte le regole di formattazione condizionale dal foglio. Equivale a chiamare setConditionalFormatRules(rules)
con un array vuoto come input.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.clearConditionalFormatRules();
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContents()
Cancella il foglio di contenuti, mantenendo le informazioni di formattazione.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearContents();
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormats()
Cancella il foglio di formattazione, mantenendo i contenuti.
Per formattazione si intende il modo in cui i dati vengono formattati come consentito dalle opzioni del menu "Formato" (ad es. grassetto, corsivo, formattazione condizionale) e non dalla larghezza o dall'altezza delle celle.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearFormats();
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNotes()
Cancella dal foglio tutte le note.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearNotes();
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllColumnGroups()
Comprime tutti i gruppi di colonne nel foglio.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are collapsed. sheet.collapseAllColumnGroups();
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllRowGroups()
Comprime tutti i gruppi di righe nel foglio.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are collapsed. sheet.collapseAllRowGroups();
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(spreadsheet)
Copia il foglio in un determinato foglio di lavoro, che può essere lo stesso foglio di lavoro dell'origine. Il foglio copiato si chiama "Copia di [nome originale]".
var source = SpreadsheetApp.getActiveSpreadsheet(); var sheet = source.getSheets()[0]; var destination = SpreadsheetApp.openById('ID_GOES HERE'); sheet.copyTo(destination);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
spreadsheet | Spreadsheet | Il foglio di lavoro in cui copiare questo foglio, che può essere lo stesso dell'origine. |
Ritorni
Sheet
: il nuovo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Restituisce un valore DeveloperMetadataFinder
per trovare i metadati dello sviluppatore nell'ambito di questo foglio. I metadati rientrano nell'ambito di un determinato foglio se sono associati al foglio stesso o a una riga, colonna o intervallo su quel foglio.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Creates the developer metadata finder. const metadatafinder = sheet.createDeveloperMetadataFinder(); // Finds the metadata with value 'PARIS' and displays its key in the console. console.log(metadatafinder.withValue('PARIS').find()[0].getKey());
Ritorni
DeveloperMetadataFinder
: uno sviluppatore che si occupa di ricerca dei metadati per cercare i metadati nell'ambito di questa scheda.
createTextFinder(findText)
Crea una ricerca di testo per il foglio, che può trovare e sostituire testo all'interno del foglio.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Creates a text finder. var textFinder = sheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the sheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
findText | String | Il testo da cercare. |
Ritorni
TextFinder
: il valore TextFinder
del foglio.
deleteColumn(columnPosition)
Elimina la colonna nella posizione specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnPosition | Integer | La posizione della colonna, a partire da 1 per la prima colonna. |
Ritorni
Sheet
: il foglio, utile per il collegamento dei metodi
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Elimina una serie di colonne a partire dalla posizione della colonna specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnPosition | Integer | La posizione della prima colonna da eliminare. |
howMany | Integer | Il numero di colonne da eliminare. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
Elimina la riga nella posizione specificata per la riga.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowPosition | Integer | La posizione della riga, a partire da 1 per la prima riga. |
Ritorni
Sheet
: il foglio, utile per il collegamento dei metodi
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Elimina un numero di righe a partire dalla posizione della riga specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowPosition | Integer | La posizione della prima riga da eliminare. |
howMany | Integer | Il numero di righe da eliminare. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllColumnGroups()
Espande tutti i gruppi di colonne nel foglio. Questo metodo richiede almeno un gruppo di colonne.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are expanded. sheet.expandAllColumnGroups();
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllRowGroups()
Espande tutti i gruppi di righe nel foglio. Questo metodo richiede almeno un gruppo di righe.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are expanded. sheet.expandAllRowGroups();
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandColumnGroupsUpToDepth(groupDepth)
Espande tutti i gruppi di colonne fino alla profondità specificata e comprime tutti gli altri.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandColumnGroupsUpToDepth(2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
groupDepth | Integer | La profondità del gruppo fino alla quale espandere i gruppi di colonne. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandRowGroupsUpToDepth(groupDepth)
Espande tutti i gruppi di righe fino alla profondità specificata e comprime tutti gli altri.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandRowGroupsUpToDepth(2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
groupDepth | Integer | La profondità del gruppo fino alla quale espandere i gruppi di righe. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
Restituisce la cella attiva in questo foglio.
Nota: è preferibile utilizzare getCurrentCell()
, che restituisce la cella evidenziata corrente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Ritorni
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 oppure null
se non è presente alcun intervallo attivo. Se sono selezionati più intervalli, questo metodo restituisce solo l'ultimo intervallo selezionato.
Il termine "intervallo attivo" fa riferimento all'intervallo selezionato da un utente nel foglio attivo, ma in una funzione personalizzata fa riferimento alla cella che viene ricalcolata attivamente.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Ritorni
Range
: l'intervallo attivo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Vedi anche
getActiveRangeList()
Restituisce l'elenco di intervalli attivi nel foglio attivo o null
se non sono presenti intervalli attivi.
Se è stato selezionato un singolo intervallo, si comporta come una chiamata getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Ritorni
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
getBandings()
Restituisce tutte le bande in questo foglio.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the banding info for the sheet. const bandings = sheet.getBandings(); // Gets info on the bandings' second row color and logs it to the console. for (const banding of bandings) { console.log(banding.getSecondRowColor()); }
Ritorni
Banding[]
: tutte le bande in questo foglio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCharts()
Restituisce un array di grafici in questo foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; // Do something with the chart }
Ritorni
EmbeddedChart[]
: un array di grafici.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
Restituisce il gruppo di colonne alla profondità dell'indice e del gruppo specificati.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at column 2 and has a depth of 1, or // null if the group doesn’t exist. var columnGroup = sheet.getColumnGroup(2, 1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnIndex | Integer | L'indice della colonna del pulsante di attivazione/disattivazione del controllo del gruppo o di un indice all'interno del gruppo. |
groupDepth | Integer | La profondità del gruppo. |
Ritorni
Group
: gruppo di colonne in corrispondenza dell'indice e della profondità di controllo oppure genera un'eccezione se il gruppo non esiste.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupControlPosition()
Restituisce GroupControlTogglePosition
per tutti i gruppi di colonne nel foglio.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the // group. var columnGroupControlPosition = sheet.getColumnGroupControlPosition();
Ritorni
GroupControlTogglePosition
: true
se il pulsante di attivazione/disattivazione del controllo del raggruppamento di colonne viene visualizzato dopo il gruppo in questo foglio e 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
getColumnGroupDepth(columnIndex)
Restituisce la profondità del gruppo della colonna nell'indice specificato.
La profondità del gruppo indica quanti gruppi si sovrappongono alla colonna. L'intervallo può essere compreso tra zero e otto.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over columns 1 through 3 var groupDepth = sheet.getColumnGroupDepth(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnIndex | Integer | L'indice della colonna. |
Ritorni
Integer
: la profondità del gruppo della colonna nell'indice 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
getColumnWidth(columnPosition)
Restituisce la larghezza in pixel della colonna specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnPosition | Integer | La posizione della colonna da esaminare. |
Ritorni
Integer
: larghezza 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
getConditionalFormatRules()
Visualizza tutte le regole di formattazione condizionale in questo foglio.
// Logs the conditional format rules in a sheet. var rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules(); for (var i = 0; i < rules.length; i++) { var rule = rules[i]; Logger.log(rule); }
Ritorni
ConditionalFormatRule[]
: un array di tutte le regole nel 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
getCurrentCell()
Restituisce la cella corrente nel foglio attivo o null
se non c'è alcuna cella corrente. La cella corrente è quella evidenziata nell'interfaccia utente di Fogli Google ed è evidenziata da un bordo scuro. Non c'è mai più di una cella corrente. Quando un utente seleziona uno o più intervalli di celle,
una delle celle della selezione è la cella corrente.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Ritorni
Range
: la cella corrente
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
Restituisce un valore Range
corrispondente alle dimensioni in cui sono presenti i dati.
Ciò equivale a creare un intervallo limitato 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); }
Ritorni
Range
: un intervallo composto da tutti i dati nel foglio di lavoro
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Restituisce 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());
Ritorni
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()
Restituisce 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());
Ritorni
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
getDataSourceTables()
Restituisce 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());
Ritorni
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
getDeveloperMetadata()
Ottieni tutti i metadati dello sviluppatore associati a questo foglio.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Gets all the developer metadata for the sheet. const developerMetaDataList = sheet.getDeveloperMetadata(); // Logs the developer metadata to the console. for (const developerMetaData of developerMetaDataList) { console.log(developerMetaData.getKey()); }
Ritorni
DeveloperMetadata[]
: i metadati dello sviluppatore associati a questo foglio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDrawings()
Restituisce un array di disegni nel foglio.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the drawings from the sheet. const allDrawings = sheet.getDrawings(); // Logs the number of drawings present on the sheet. console.log(allDrawings.length);
Ritorni
Drawing[]
: l'elenco dei disegni in questo foglio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Restituisce il filtro in questo foglio o null
se non è presente alcun filtro.
// Gets the filter on the active sheet. let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter();
Ritorni
Filter
: il filtro.
Autorizzazione
Gli script che utilizzano questo 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 oppure null
se il foglio non ha alcun modulo associato.
var sheet = SpreadsheetApp.getActiveSheet(); var url = sheet.getFormUrl();
Ritorni
String
: l'URL del modulo che inserisce le risposte in questo foglio oppure null
se al foglio non è associato un modulo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
Restituisce il numero di colonne bloccate.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Ritorni
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());
Ritorni
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
getImages()
Restituisce tutte le immagini over-the-grid 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()); }
Ritorni
OverGridImage[]
: un array di immagini over-the-grid.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIndex()
Restituisce la posizione del foglio nel foglio di lavoro principale. Inizia da 1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); // Note that the JavaScript index is 0, but this logs 1 var sheet = ss.getSheets()[0]; // ... because spreadsheets are 1-indexed Logger.log(sheet.getIndex());
Ritorni
Integer
: la posizione del foglio nel foglio di lavoro principale.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Restituisce la posizione dell'ultima colonna con contenuti.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Ritorni
Integer
: l'ultima colonna del foglio con contenuti
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Restituisce la posizione dell'ultima riga con contenuti.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Ritorni
Integer
: l'ultima riga del foglio con 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
getMaxColumns()
Restituisce il numero corrente di colonne nel foglio, indipendentemente dal contenuto.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxColumns());
Ritorni
Integer
: la larghezza massima 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
getMaxRows()
Restituisce il numero corrente di righe del foglio, indipendentemente dai contenuti.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxRows());
Ritorni
Integer
: l'altezza massima 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
getName()
Restituisce il nome del foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getName());
Ritorni
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
getNamedRanges()
Restituisce tutti gli intervalli denominati in questo foglio.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges(); if (namedRanges.length > 1) { Logger.log(namedRanges[0].getName()); }
Ritorni
NamedRange[]
: un array di tutti gli intervalli denominati nel 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
getParent()
Restituisce il valore Spreadsheet
che contiene il foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // parent is identical to ss var parent = sheet.getParent();
Ritorni
Spreadsheet
: foglio di lavoro principale.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPivotTables()
Restituisce tutte le tabelle pivot di questo foglio.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the pivot table info for the sheet. const pivotTables = sheet.getPivotTables(); // Logs the pivot tables to the console. for (const pivotTable of pivotTables) { console.log(pivotTable.getSourceDataRange().getValues()); }
Ritorni
PivotTable[]
: le tabelle pivot in questo foglio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
Restituisce un array di oggetti che rappresentano tutti gli intervalli protetti nel foglio o un array di un singolo elemento che rappresenta la protezione sul foglio stesso.
// Remove all range protections in the spreadsheet that the user has permission to edit. var sheet = SpreadsheetApp.getActiveSheet(); var protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove sheet protection from the active sheet, if the user has permission to edit it. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0]; if (protection && protection.canEdit()) { protection.remove(); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
type | ProtectionType | Il tipo di area protetta, SpreadsheetApp.ProtectionType.RANGE o SpreadsheetApp.ProtectionType.SHEET . |
Ritorni
Protection[]
: un array di oggetti che rappresenta tutti gli intervalli protetti nel foglio o un array di un singolo elemento che rappresenta la protezione sul foglio stesso.
Autorizzazione
Gli script che utilizzano questo 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(row, column)
Restituisce l'intervallo con la cella superiore sinistra alle coordinate fornite.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Passing only two arguments returns a "range" with a single cell. var range = sheet.getRange(1, 1); var values = range.getValues(); Logger.log(values[0][0]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
row | Integer | L'indice della riga della cella da restituire; l'indicizzazione delle righe inizia con 1. |
column | Integer | L'indice della colonna della cella da restituire; l'indicizzazione delle colonne inizia con 1. |
Ritorni
Range
: un intervallo contenente solo questa cella.
Autorizzazione
Gli script che utilizzano questo 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(row, column, numRows)
Restituisce l'intervallo con la cella in alto a sinistra nelle coordinate specificate e con il numero di righe specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // When the "numRows" argument is used, only a single column of data is returned. var range = sheet.getRange(1, 1, 3); var values = range.getValues(); // Prints 3 values from the first column, starting from row 1. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
row | Integer | L'indice della riga iniziale dell'intervallo; l'indicizzazione delle righe inizia con 1. |
column | Integer | L'indice della colonna dell'intervallo; l'indicizzazione delle colonne inizia con 1. |
numRows | Integer | Il numero di righe da restituire. |
Ritorni
Range
: intervallo contenente una singola colonna di dati con il numero di righe 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
getRange(row, column, numRows, numColumns)
Restituisce l'intervallo con la cella in alto a sinistra alle coordinate fornite con il numero specificato di righe e colonne.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 3, 3); var values = range.getValues(); // Print values from a 3x3 box. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
row | Integer | L'indice della riga iniziale dell'intervallo; l'indicizzazione delle righe inizia con 1. |
column | Integer | L'indice della colonna iniziale dell'intervallo; l'indicizzazione della colonna inizia con 1. |
numRows | Integer | Il numero di righe da restituire. |
numColumns | Integer | Il numero di colonne da restituire. |
Ritorni
Range
: un intervallo corrispondente all'area specificata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
Restituisce l'intervallo come specificato nella notazione A1 o nella notazione R1C1.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
a1Notation | String | L'intervallo da restituire, come specificato nella notazione A1 o nella notazione R1C1. |
Ritorni
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
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
Nome | Tipo | Descrizione |
---|---|---|
a1Notations | String[] | L'elenco di intervalli da restituire, come specificato nella notazione A1 o R1C1. |
Ritorni
RangeList
: l'elenco di intervalli nella località designata
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroup(rowIndex, groupDepth)
Restituisce il gruppo di righe alla profondità dell'indice e del gruppo specificati.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at row 2 and has a depth of 1, or // null if the group doesn’t exist. var rowGroup = sheet.getRowGroup(2, 1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowIndex | Integer | L'indice della riga del controllo del gruppo o di un indice all'interno del gruppo. |
groupDepth | Integer | La profondità del gruppo. |
Ritorni
Group
: gruppo di righe in corrispondenza dell'indice e della profondità di controllo oppure genera un'eccezione se il gruppo non esiste.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupControlPosition()
Restituisce GroupControlTogglePosition
per tutti i gruppi di righe nel foglio.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the row grouping control toggle is shown after the // group. var rowGroupControlPosition = sheet.getRowGroupControlPosition();
Ritorni
GroupControlTogglePosition
: true
se il pulsante di attivazione/disattivazione del controllo di raggruppamento delle righe viene visualizzato dopo il gruppo in questo foglio
e 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
getRowGroupDepth(rowIndex)
Restituisce la profondità del gruppo della riga nell'indice specificato.
La profondità del gruppo indica quanti gruppi si sovrappongono alla riga. L'intervallo può essere compreso tra zero e otto.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over rows 1 through 3 var groupDepth = sheet.getRowGroupDepth(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowIndex | Integer | L'indice della riga. |
Ritorni
Integer
: la profondità del gruppo della riga nell'indice 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
getRowHeight(rowPosition)
Restituisce l'altezza in pixel della riga specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowPosition | Integer | La posizione della riga da esaminare. |
Ritorni
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 valore Selection
corrente nel foglio di lavoro.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Ritorni
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
getSheetId()
Restituisce l'ID del foglio rappresentato da questo oggetto.
Questo è un ID del foglio univoco per il foglio di lavoro. L'ID è un numero intero monotonico crescente assegnato al momento della creazione del foglio, indipendente dalla posizione del foglio. Ciò è 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());
Ritorni
Integer
: un ID del foglio univoco per il foglio di lavoro
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Restituisce il nome del foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Ritorni
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 specificato come posizione della riga o della colonna equivale a ottenere l'ultima riga o colonna contenente dati nel foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startRow | Integer | La posizione della riga iniziale. |
startColumn | Integer | La posizione della colonna iniziale. |
numRows | Integer | Il numero di righe per cui restituire i valori. |
numColumns | Integer | Il numero di colonne per cui restituire i valori. |
Ritorni
Object[][]
: una matrice 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
getSlicers()
Restituisce un array di controlli filtro sul foglio.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all slicers in the spreadsheet. const slicers = sheet.getSlicers(); // Logs the slicer titles to the console. for (const slicer of slicers) { console.log(slicer.getTitle()); }
Ritorni
Slicer[]
: l'elenco dei controlli filtro in questo foglio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTabColorObject()
Restituisce il colore della scheda del foglio o null
se la scheda del foglio non è colorata.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = first.getTabColorObject();
Ritorni
Color
: il colore della scheda del foglio o null
se la scheda del foglio non è colorata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getType()
Restituisce il tipo di foglio.
Il tipo predefinito di foglio è SheetType.GRID
. Un foglio che contiene un singolo oggetto incorporato, come EmbeddedChart
, è un foglio SheetType.OBJECT
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getType());
Ritorni
SheetType
: il tipo di 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
hasHiddenGridlines()
Restituisce true
se le linee della griglia del foglio sono nascoste. In caso contrario, restituisce false
.
Le linee della griglia sono visibili per impostazione predefinita.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if the spreadsheet has hidden gridelines and logs the result to the console. console.log(sheet.hasHiddenGridlines());
Ritorni
Boolean
: true
se le linee della griglia sono nascoste; in caso contrario false
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Nasconde la colonna o le colonne nell'intervallo specificato.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
column | Range | L'intervallo di colonne da nascondere. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex)
Nasconde una singola colonna nell'indice specificato. Utilizza 1-index per questo metodo.
Per nascondere più di una colonna utilizzando un indice, utilizza hideColumns(columnIndex, numColumns)
.
Per nascondere più di una colonna utilizzando un intervallo, utilizza hideColumn()
.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Hides the first column sheet.hideColumns(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnIndex | Integer | L'indice della colonna 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
hideColumns(columnIndex, numColumns)
Nasconde una o più colonne consecutive che iniziano in corrispondenza dell'indice specificato. Utilizza 1-index per questo metodo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three columns sheet.hideColumns(1, 3);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnIndex | Integer | L'indice iniziale delle colonne da nascondere. |
numColumns | Integer | Il numero di colonne da nascondere. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
Nasconde le righe nell'intervallo specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
row | Range | L'intervallo di righe da nascondere. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex)
Nasconde la riga nell'indice specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first row sheet.hideRows(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowIndex | Integer | L'indice della riga 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
hideRows(rowIndex, numRows)
Nasconde una o più righe consecutive che iniziano in corrispondenza dell'indice specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three rows sheet.hideRows(1, 3);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowIndex | Integer | L'indice iniziale delle righe da nascondere. |
numRows | Integer | Il numero 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
hideSheet()
Nasconde questo foglio. Non ha effetto se il foglio è già nascosto. Se questo metodo viene richiamato nell'unico foglio visibile, genera un'eccezione.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.hideSheet();
Ritorni
Sheet
: il foglio 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
insertChart(chart)
Aggiunge un nuovo grafico a questo foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates a simple bar chart from the first three rows // of the first two columns of the spreadsheet var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B4")) .setPosition(5, 5, 0, 0) .setOption("title", "Dynamic Chart") .build(); sheet.insertChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
chart | EmbeddedChart | Il grafico da inserire. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Inserisce una colonna dopo la posizione della colonna specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
afterPosition | Integer | La colonna dopo la quale aggiungere la nuova colonna. |
Ritorni
Sheet
: il foglio, utile per il collegamento dei metodi
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Inserisce una colonna prima della posizione della colonna specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
beforePosition | Integer | La colonna prima della quale aggiungere la nuova colonna. |
Ritorni
Sheet
: il foglio, utile per il collegamento 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
insertColumns(columnIndex)
Inserisce una colonna vuota in un foglio nella posizione specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by one sheet.insertColumns(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnIndex | Integer | L'indice che indica dove inserire una colonna. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex, numColumns)
Inserisce una o più colonne vuote consecutive in un foglio a partire dalla posizione specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by three sheet.insertColumns(1, 3);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnIndex | Integer | L'indice che indica dove inserire una colonna. |
numColumns | Integer | Il numero di colonne da inserire. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Inserisce un determinato numero di colonne dopo la posizione della colonna specificata.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Inserts two columns after the first column on the first sheet of the spreadsheet. sheet.insertColumnsAfter(1,2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
afterPosition | Integer | La colonna dopo la quale aggiungere la nuova colonna. |
howMany | Integer | Il numero di colonne da inserire. |
Ritorni
Sheet
: il foglio, utile per il collegamento 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
Nome | Tipo | Descrizione |
---|---|---|
beforePosition | Integer | La colonna prima della quale aggiungere la nuova colonna. |
howMany | Integer | Il numero di colonne da inserire. |
Ritorni
Sheet
: il foglio, utile per il collegamento 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
insertImage(blobSource, column, row)
Inserisce un elemento BlobSource
come immagine nel documento in una determinata riga e colonna. Le dimensioni dell'immagine vengono recuperate dai contenuti del blob. Le dimensioni massime supportate per il blob sono 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobSource | BlobSource | Il blob contenente i contenuti dell'immagine, il tipo MIME e (facoltativamente) il nome. |
column | Integer | La posizione della colonna. |
row | Integer | La posizione della riga. |
Ritorni
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 valore BlobSource
come immagine nel documento in una determinata riga e colonna, con un offset di pixel. Le dimensioni dell'immagine vengono recuperate dai contenuti del blob. Le dimensioni massime supportate per il blob
sono 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobSource | BlobSource | Il blob contenente i contenuti dell'immagine, il tipo MIME e (facoltativamente) il nome. |
column | Integer | La posizione della colonna. |
row | Integer | La posizione della riga. |
offsetX | Integer | Lo scostamento orizzontale dall'angolo della cella in pixel. |
offsetY | Integer | L'offset verticale dall'angolo della cella in pixel. |
Ritorni
OverGridImage
: l'immagine inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
Inserisce un'immagine nel documento in una determinata riga e colonna.
L'URL fornito deve essere accessibile pubblicamente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
url | String | L'URL dell'immagine. |
column | Integer | La posizione della colonna della griglia. |
row | Integer | La posizione della riga della griglia. |
Ritorni
OverGridImage
: l'immagine inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
Inserisce un'immagine nel documento in una determinata riga e colonna, con un offset di pixel.
L'URL fornito deve essere accessibile pubblicamente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
url | String | L'URL dell'immagine. |
column | Integer | La posizione della colonna. |
row | Integer | La posizione della riga. |
offsetX | Integer | Lo scostamento orizzontale dall'angolo della cella in pixel. |
offsetY | Integer | L'offset verticale dall'angolo della cella in pixel. |
Ritorni
OverGridImage
: l'immagine inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
Inserisce una riga dopo la posizione della riga specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
afterPosition | Integer | La riga dopo la quale aggiungere la nuova riga. |
Ritorni
Sheet
: il foglio, utile per il collegamento dei metodi
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Inserisce una riga prima della posizione della riga specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
beforePosition | Integer | La riga prima della quale aggiungere la nuova riga. |
Ritorni
Sheet
: il foglio, utile per il collegamento 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
insertRows(rowIndex)
Inserisce una riga vuota in un foglio nella posizione specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by one sheet.insertRows(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowIndex | Integer | L'indice che indica dove inserire una riga. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex, numRows)
Inserisce una o più righe vuote consecutive in un foglio che inizia dalla posizione specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by three sheet.insertRows(1, 3);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowIndex | Integer | L'indice che indica dove inserire una riga. |
numRows | Integer | Il numero di righe da inserire. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Inserisce un numero di righe dopo la posizione della riga specificata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
afterPosition | Integer | La riga dopo la quale aggiungere le nuove righe. |
howMany | Integer | Il numero di righe da inserire. |
Ritorni
Sheet
: il foglio, utile per il collegamento 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
Nome | Tipo | Descrizione |
---|---|---|
beforePosition | Integer | La riga prima della quale aggiungere le nuove righe. |
howMany | Integer | Il numero di righe da inserire. |
Ritorni
Sheet
: il foglio, utile per il collegamento 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
insertSlicer(range, anchorRowPos, anchorColPos)
Aggiunge un nuovo controllo filtro a questo foglio.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range of the sheet. const range = sheet.getRange('A1:D10'); // Inserts the slicer with a random range into the sheet. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10); // Logs the insert slicer result to the console. console.log(insertSlicers);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo su cui viene creato il controllo filtro. |
anchorRowPos | Integer | Il lato superiore del controllo filtro è ancorato a questa riga. |
anchorColPos | Integer | Il lato superiore del controllo filtro è ancorato in questa colonna. |
Ritorni
Slicer
: il controllo filtro appena inserito.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)
Aggiunge un nuovo controllo filtro a questo foglio.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range. const range = sheet.getRange('A1:D10'); // Inserts a slicer using the random range function. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0); // Logs the insert slicer result to the console. console.log(insertSlicers);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo su cui viene creato il controllo filtro. |
anchorRowPos | Integer | Il lato superiore del controllo filtro è ancorato a questa riga. |
anchorColPos | Integer | Il lato superiore del controllo filtro è ancorato in questa colonna. |
offsetX | Integer | Lo scostamento orizzontale dall'angolo della cella in pixel. |
offsetY | Integer | L'offset verticale dall'angolo della cella in pixel. |
Ritorni
Slicer
: il controllo filtro appena inserito.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
Indica se la colonna specificata è nascosta dall'utente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnPosition | Integer | La posizione della colonna da esaminare. |
Ritorni
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
isRightToLeft()
Restituisce true
se il layout del foglio è da destra a sinistra. Restituisce false
se il foglio utilizza il layout predefinito da sinistra a destra.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if a spreadsheet is ordered from right to left and logs the result to the console. console.log(sheet.isRightToLeft());
Ritorni
Boolean
: true
se da destra a sinistra; 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
Nome | Tipo | Descrizione |
---|---|---|
rowPosition | Integer | La posizione della riga da esaminare. |
Ritorni
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
Nome | Tipo | Descrizione |
---|---|---|
rowPosition | Integer | La posizione della riga da esaminare. |
Ritorni
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
isSheetHidden()
Restituisce true
se il foglio è attualmente nascosto.
var sheet = SpreadsheetApp.getActiveSheet(); if (sheet.isSheetHidden()) { // do something... }
Ritorni
Boolean
: true
se il foglio è nascosto, altrimenti false
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveColumns(columnSpec, destinationIndex)
Consente di spostare le colonne selezionate dall'intervallo specificato nella posizione indicata dal destinationIndex
. L'elemento columnSpec
non deve rappresentare esattamente un'intera colonna o un gruppo di colonne da spostare, ma seleziona tutte le colonne incluse nell'intervallo.
// The code below moves rows A-B to destination index 5. // This results in those columns becoming columns C-D. var sheet = SpreadsheetApp.getActiveSheet(); // Selects column A and column B to be moved. var columnSpec = sheet.getRange("A1:B1"); sheet.moveColumns(columnSpec, 5);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnSpec | Range | Un intervallo che comprende le colonne da spostare. |
destinationIndex | Integer | L'indice in cui devono essere spostate le colonne. Tieni presente che questo indice si basa sulle coordinate precedenti lo spostamento delle colonne. I dati esistenti vengono spostati verso destra per fare spazio alle colonne spostate, mentre le colonne di origine vengono rimosse dalla griglia. Pertanto, i dati potrebbero trovarsi in un indice diverso da quello specificato in origine. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveRows(rowSpec, destinationIndex)
Consente di spostare le righe selezionate dall'intervallo specificato nella posizione indicata dal destinationIndex
. L'elemento rowSpec
non deve rappresentare esattamente un'intera riga o un gruppo di righe da spostare, ma seleziona tutte le righe incluse nell'intervallo.
// The code below moves rows 1-2 to destination index 5. // This results in those rows becoming rows 3-4. var sheet = SpreadsheetApp.getActiveSheet(); // Selects row 1 and row 2 to be moved. var rowSpec = sheet.getRange("A1:A2"); sheet.moveRows(rowSpec, 5);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowSpec | Range | Un intervallo che comprende le righe da spostare. |
destinationIndex | Integer | L'indice in cui devono essere spostate le righe. Tieni presente che questo indice si basa sulle coordinate prima dello spostamento delle righe. I dati esistenti vengono spostati verso il basso per fare spazio alle righe spostate, mentre le righe di origine vengono rimosse dalla griglia. Di conseguenza, i dati potrebbero trovarsi in un indice diverso da quello specificato in origine. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
newChart()
Restituisce un generatore per creare un nuovo grafico per questo foglio.
Questo esempio mostra come creare un nuovo grafico:
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B8"); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setPosition(2, 2, 0, 0) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build());
Ritorni
EmbeddedChartBuilder
: uno strumento per la creazione di un nuovo grafico.
protect()
Crea un oggetto in grado di proteggere il foglio dalla modifica, tranne che per gli utenti che dispongono dell'autorizzazione. Finché lo script non modifica effettivamente l'elenco degli editor del foglio (chiamando
Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
o impostando un nuovo
valore per Protection.setDomainEdit(editable)
), le autorizzazioni rispecchiano quelle del
foglio di lavoro stesso, il che significa di fatto che il foglio non è protetto. Se il foglio è già protetto, questo metodo restituisce un oggetto che rappresenta le impostazioni di protezione esistenti.
Un foglio protetto può includere regioni non protette.
// Protect the active sheet, then remove all other users from the list of editors. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.protect().setDescription('Sample protected sheet'); // Ensure the current user is an editor before removing others. Otherwise, if the user's edit // permission comes from a group, the script throws an exception upon removing the group. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Ritorni
Protection
: oggetto che rappresenta le impostazioni di protezione.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeChart(chart)
Rimuove un grafico dal foglio principale.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This removes all the embedded charts from the spreadsheet var charts = sheet.getCharts(); for (var i in charts) { sheet.removeChart(charts[i]); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
chart | EmbeddedChart | Il grafico da rimuovere. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Imposta l'intervallo specificato come active range
nel foglio attivo, con
la cella in alto a sinistra nell'intervallo come current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo da impostare come intervallo attivo. |
Ritorni
Range
: l'intervallo appena attivo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRangeList(rangeList)
Imposta l'elenco specificato di intervalli come active ranges
nel
foglio attivo. L'ultimo intervallo nell'elenco è impostato come active range
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rangeList | RangeList | L'elenco di intervalli da selezionare. |
Ritorni
RangeList
: l'elenco di intervalli appena selezionato
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(range)
Imposta la regione di selezione attiva per questo foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo da impostare come selezione attiva. |
Ritorni
Range
: l'intervallo appena attivo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(a1Notation)
Imposta la selezione attiva, come specificato nella notazione A1 o R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
a1Notation | String | L'intervallo da impostare come attivo, come specificato nella notazione A1 o nella notazione R1C1. |
Ritorni
Range
: l'intervallo appena attivo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnGroupControlPosition(position)
Imposta la posizione del pulsante di attivazione/disattivazione del gruppo di colonne sul foglio.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
position | GroupControlTogglePosition | La posizione del pulsante di attivazione/disattivazione del controllo del gruppo di colonne. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnPosition, width)
Imposta la larghezza della colonna specificata in pixel.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnPosition | Integer | La posizione della colonna da impostare. |
width | Integer | La larghezza in pixel da impostare. |
Ritorni
Sheet
: il foglio, utile per il collegamento 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
setColumnWidths(startColumn, numColumns, width)
Imposta la larghezza delle colonne specificate in pixel.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three columns to a width of 200 pixels sheet.setColumnWidths(1, 3, 200);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startColumn | Integer | La posizione iniziale della colonna da modificare. |
numColumns | Integer | Il numero di colonne da modificare. |
width | Integer | La larghezza in pixel da impostare. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setConditionalFormatRules(rules)
Sostituisce tutte le regole di formattazione condizionale attualmente esistenti nel foglio con le regole di input. Le regole vengono valutate nel relativo ordine di input.
// Remove one of the existing conditional format rules. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); rules.splice(1, 1); // Deletes the 2nd format rule. sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rules | ConditionalFormatRule[] | Le nuove regole di formattazione condizionale. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
Imposta la cella specificata come current cell
.
Se la cella specificata è presente in un intervallo già selezionato, questo intervallo diventa l'intervallo attivo con la cella come cella corrente.
Se la cella specificata non è presente in nessun intervallo selezionato, qualsiasi selezione esistente viene rimossa e la cella diventa la cella corrente e l'intervallo attivo.
Nota: il valore Range
specificato deve essere composto da una cella, altrimenti genera un'eccezione.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
cell | Range | La cella da impostare come cella corrente. |
Ritorni
Range
: la cella corrente appena impostata
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenColumns(columns)
Blocca il numero di colonne specificato. Se il valore è zero, nessuna colonna è bloccata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columns | Integer | Il numero di colonne da bloccare. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenRows(rows)
Blocca il numero specificato di righe. Se il valore è zero, nessuna riga è bloccata.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rows | Integer | Il numero di righe da bloccare. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHiddenGridlines(hideGridlines)
Nasconde o mostra le linee della griglia del foglio.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can us eSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Hides the gridlines in the sheet. sheet.setHiddenGridlines(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
hideGridlines | Boolean | Se true , nascondi le linee della griglia in questo foglio, altrimenti mostrale. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Imposta il nome del foglio.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setName("not first anymore");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nuovo nome del foglio. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRightToLeft(rightToLeft)
Consente di impostare o annullare l'impostazione del layout del foglio da destra a sinistra.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets the sheet layout, so that the sheet is ordered from right to left. sheet.setRightToLeft(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rightToLeft | Boolean | Se true , il layout del foglio è impostato da destra a sinistra, con la cella A1 nell'angolo in alto a destra. Se false , il layout del foglio viene impostato sul valore predefinito da sinistra a destra, con la cella A1 in alto a sinistra. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowGroupControlPosition(position)
Imposta la posizione del pulsante di attivazione/disattivazione del controllo del gruppo di righe sul foglio.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
position | GroupControlTogglePosition | La posizione del pulsante di attivazione/disattivazione del controllo del gruppo di righe. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
Imposta l'altezza in pixel della riga specificata. Per impostazione predefinita, le righe si espandono per adattarsi al contenuto della cella. Se
vuoi forzare le righe a un'altezza specificata, utilizza setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowPosition | Integer | La posizione della riga da modificare. |
height | Integer | L'altezza in pixel da impostare. |
Ritorni
Sheet
: il foglio, utile per il concatenamento dei metodi.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeights(startRow, numRows, height)
Imposta l'altezza in pixel delle righe specificate. Per impostazione predefinita, le righe si espandono per adattarsi al contenuto della cella. Se vuoi forzare le righe a un'altezza specificata, utilizza setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 20 pixels sheet.setRowHeights(1, 3, 20);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startRow | Integer | La posizione iniziale della riga da modificare. |
numRows | Integer | Il numero di righe da modificare. |
height | Integer | L'altezza in pixel da impostare. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeightsForced(startRow, numRows, height)
Imposta l'altezza in pixel delle righe specificate. Per impostazione predefinita, le righe si espandono per adattarsi al contenuto della cella. Quando utilizzi setRowHeightsForced
, le righe vengono forzate all'altezza specificata anche se i contenuti delle celle sono più alti dell'altezza della riga.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 5 pixels. sheet.setRowHeightsForced(1, 3, 5);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startRow | Integer | La posizione iniziale della riga da modificare. |
numRows | Integer | Il numero di righe da modificare. |
height | Integer | L'altezza in pixel da impostare. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColor(color)
Imposta il colore della scheda del foglio.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setTabColor("ff0000"); // Set the color to red. first.setTabColor(null); // Unset the color.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Un codice colore in notazione CSS (come '#ffffff' o 'white' ) oppure null per reimpostare il colore della scheda. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColorObject(color)
Imposta il colore della scheda del foglio.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); first.setTabColorObject(color); // Set the color to theme accent 1. first.setTabColorObject(null); // Unset the color.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | Il colore della scheda del foglio da impostare. |
Ritorni
Sheet
: questo foglio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex)
Mostra la colonna nell'indice specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first column sheet.showColumns(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnIndex | Integer | L'indice della colonna da mostrare. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex, numColumns)
Mostra una o più colonne consecutive a partire dall'indice specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three columns sheet.showColumns(1, 3);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnIndex | Integer | L'indice iniziale delle colonne da mostrare. |
numColumns | Integer | Il numero di colonne da mostrare. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex)
Mostra la riga nell'indice specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first row sheet.showRows(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowIndex | Integer | L'indice della riga da mostrare. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex, numRows)
Mostra una o più righe consecutive a partire dall'indice specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three rows sheet.showRows(1, 3);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowIndex | Integer | L'indice iniziale delle righe da mostrare. |
numRows | Integer | Il numero di righe da mostrare. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showSheet()
Rende visibile il foglio. Non ha effetto se il foglio è già visibile.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.showSheet();
Ritorni
Sheet
: il foglio 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
sort(columnPosition)
Ordina un foglio per colonna, in ordine crescente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnPosition | Integer | La colonna in base alla quale ordinare. |
Ritorni
Sheet
: il foglio, utile per il collegamento dei metodi
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Ordina un foglio per colonna. Utilizza un parametro per specificare in ordine crescente o decrescente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnPosition | Integer | La colonna in base alla quale ordinare. |
ascending | Boolean | true per l'ordinamento crescente, false per l'ordinamento decrescente. |
Ritorni
Sheet
: il foglio, utile per il collegamento 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
unhideColumn(column)
Mostra la colonna nell'intervallo specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
column | Range | L'intervallo da mostrare, se nascosto. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideRow(row)
Mostra la riga nell'intervallo specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
row | Range | L'intervallo da mostrare, se nascosto. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateChart(chart)
Aggiorna il grafico in questo foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code is going to loop through all the charts and change them to // column charts var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; var newChart = chart .modify() .setChartType(Charts.ChartType.COLUMN) .build(); sheet.updateChart(newChart); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
chart | EmbeddedChart | Il grafico da aggiornare. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets