Class SpreadsheetApp

SpreadsheetApp

Accedere ai file Fogli Google e crearli. Questa è la classe principale del servizio fogli di lavoro.

Proprietà

ProprietàTipoDescrizione
AutoFillSeriesAutoFillSeriesUn'enumerazione dei tipi di serie utilizzati per calcolare i valori compilati automaticamente.
BandingThemeBandingThemeUn'enumerazione dei possibili temi a bande.
BooleanCriteriaBooleanCriteriaUn'enumerazione dei criteri booleani di formattazione condizionale.
BorderStyleBorderStyleUn'enumerazione degli stili validi per l'impostazione dei bordi su un Range.
ColorTypeColorTypeUn'enumerazione dei possibili tipi di colore.
CopyPasteTypeCopyPasteTypeUn'enumerazione dei possibili tipi di incolla.
DataExecutionErrorCodeDataExecutionErrorCodeUn'enumerazione dei possibili codici di errore dell'esecuzione dei dati.
DataExecutionStateDataExecutionStateUn'enumerazione dei possibili stati di esecuzione dei dati.
DataSourceParameterTypeDataSourceParameterTypeUn'enumerazione dei possibili tipi di parametri dell'origine dati.
DataSourceRefreshScopeDataSourceRefreshScopeUn'enumerazione dei possibili ambiti di aggiornamento delle origini dati.
DataSourceTypeDataSourceTypeUn'enumerazione dei possibili tipi di origini dati.
DataValidationCriteriaDataValidationCriteriaUn'enumerazione che rappresenta i criteri di convalida dei dati che possono essere impostati su un intervallo.
DateTimeGroupingRuleTypeDateTimeGroupingRuleTypeUn'enumerazione di una regola di raggruppamento per data e ora.
DeveloperMetadataLocationTypeDeveloperMetadataLocationTypeUn'enumerazione dei possibili tipi di località per i metadati dello sviluppatore.
DeveloperMetadataVisibilityDeveloperMetadataVisibilityUn'enumerazione delle possibili visibilità dei metadati dello sviluppatore.
DimensionDimensionUn'enumerazione delle possibili dimensioni di un foglio di lavoro.
DirectionDirectionUn'enumerazione delle possibili direzioni per spostarsi all'interno di un foglio di lavoro utilizzando i tasti freccia.
FrequencyTypeFrequencyTypeUn'enumerazione dei possibili tipi di frequenza.
GroupControlTogglePositionGroupControlTogglePositionUn'enumerazione delle posizioni in cui può trovarsi l'opzione di attivazione/disattivazione del controllo del gruppo.
InterpolationTypeInterpolationTypeUn'enumerazione dei tipi di interpolazione del gradiente del formato condizionale.
PivotTableSummarizeFunctionPivotTableSummarizeFunctionUn'enumerazione delle funzioni che possono essere utilizzate per riepilogare i valori in una tabella pivot.
PivotValueDisplayTypePivotValueDisplayTypeUn'enumerazione delle modalità di visualizzazione di un valore pivot.
ProtectionTypeProtectionTypeUn'enumerazione che rappresenta le parti di un foglio di lavoro che possono essere protette dalle modifiche.
RecalculationIntervalRecalculationIntervalUn'enumerazione dei possibili intervalli che possono essere utilizzati nel ricalcolo del foglio di lavoro.
RelativeDateRelativeDateUn'enumerazione delle opzioni di date relative per calcolare un valore da utilizzare nell'elemento BooleanCriteria basato sulle date.
SheetTypeSheetTypeUn'enumerazione dei diversi tipi di fogli che possono essere presenti in un foglio di lavoro.
SortOrderSortOrderUn'enumerazione dell'ordinamento.
TextDirectionTextDirectionUn'enumerazione di indicazioni stradali di testo valide.
TextToColumnsDelimiterTextToColumnsDelimiterUn'enumerazione dei delimitatori preimpostati per la suddivisione del testo nelle colonne.
ThemeColorTypeThemeColorTypeUn'enumerazione dei possibili tipi di colore del tema.
ValueTypeValueTypeUn'enumerazione dei tipi di valori restituiti da Range.getValue() e Range.getValues() dalla classe Intervallo del servizio Foglio di lavoro. I valori di enumerazione elencati di seguito si aggiungono a Number, Boolean, Date o String.
WrapStrategyWrapStrategyUn'enumerazione delle strategie utilizzate per l'aggregazione delle celle.

Metodi

MetodoTipo restituitoBreve descrizione
create(name)SpreadsheetCrea un nuovo foglio di lavoro con il nome specificato.
create(name, rows, columns)SpreadsheetCrea un nuovo foglio di lavoro con il nome specificato e il numero di righe e colonne specificato.
enableAllDataSourcesExecution()voidAttiva l'esecuzione dei dati per tutti i tipi di origini dati.
enableBigQueryExecution()voidAttiva l'esecuzione dei dati per le origini dati BigQuery.
flush()voidApplica tutte le modifiche in sospeso al foglio di lavoro.
getActive()SpreadsheetRestituisce il foglio di lavoro attualmente attivo o null se non è presente.
getActiveRange()RangeRestituisce l'intervallo selezionato nel foglio attivo oppure null se non è presente alcun intervallo attivo.
getActiveRangeList()RangeListRestituisce l'elenco di intervalli attivi nel foglio attivo o null se non sono selezionati intervalli.
getActiveSheet()SheetRestituisce il foglio attivo in un foglio di lavoro.
getActiveSpreadsheet()SpreadsheetRestituisce il foglio di lavoro attualmente attivo o null se non è presente.
getCurrentCell()RangeRestituisce la cella corrente (evidenziata) selezionata in uno degli intervalli attivi nel foglio attivo o null in assenza di cella corrente.
getSelection()SelectionRestituisce il valore Selection corrente nel foglio di lavoro.
getUi()UiRestituisce un'istanza dell'ambiente dell'interfaccia utente del foglio di lavoro che consente allo script di aggiungere funzionalità come menu, finestre di dialogo e barre laterali.
newCellImage()CellImageBuilderCrea un generatore per un CellImage.
newColor()ColorBuilderCrea un generatore per un Color.
newConditionalFormatRule()ConditionalFormatRuleBuilderCrea un generatore per una regola di formattazione condizionale.
newDataSourceSpec()DataSourceSpecBuilderCrea un generatore per un DataSourceSpec.
newDataValidation()DataValidationBuilderCrea un generatore per una regola di convalida dei dati.
newFilterCriteria()FilterCriteriaBuilderCrea un generatore per un FilterCriteria.
newRichTextValue()RichTextValueBuilderCrea un generatore per un valore RTF.
newTextStyle()TextStyleBuilderCrea un generatore per uno stile di testo.
open(file)SpreadsheetApre il foglio di lavoro corrispondente all'oggetto File specificato.
openById(id)SpreadsheetApre il foglio di lavoro con l'ID specificato.
openByUrl(url)SpreadsheetApre il foglio di lavoro con l'URL specificato.
setActiveRange(range)RangeImposta l'intervallo specificato come active range, con la cella in alto a sinistra nell'intervallo come current cell.
setActiveRangeList(rangeList)RangeListImposta l'elenco di intervalli specificato come active ranges.
setActiveSheet(sheet)SheetImposta il foglio attivo in un foglio di lavoro.
setActiveSheet(sheet, restoreSelection)SheetImposta il foglio attivo in un foglio di lavoro, con la possibilità di ripristinare la selezione più recente all'interno di quel foglio.
setActiveSpreadsheet(newActiveSpreadsheet)voidImposta il foglio di lavoro attivo.
setCurrentCell(cell)RangeImposta la cella specificata come current cell.

Documentazione dettagliata

create(name)

Crea un nuovo foglio di lavoro con il nome specificato.

// The code below creates a new spreadsheet "Finances" and logs the URL for it
var ssNew = SpreadsheetApp.create("Finances");
Logger.log(ssNew.getUrl());

Parametri

NomeTipoDescrizione
nameStringIl nome del foglio di lavoro.

Ritorni

Spreadsheet: un nuovo 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

create(name, rows, columns)

Crea un nuovo foglio di lavoro con il nome specificato e il numero di righe e colonne specificato.

// The code below creates a new spreadsheet "Finances" with 50 rows and 5 columns and logs the
// URL for it
var ssNew = SpreadsheetApp.create("Finances", 50, 5);
Logger.log(ssNew.getUrl());

Parametri

NomeTipoDescrizione
nameStringIl nome del foglio di lavoro.
rowsIntegerIl numero di righe per il foglio di lavoro.
columnsIntegerIl numero di colonne per il foglio di lavoro.

Ritorni

Spreadsheet: un nuovo 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

enableAllDataSourcesExecution()

Attiva l'esecuzione dei dati per tutti i tipi di origini dati.

L'esecuzione dei dati genera un'eccezione se il tipo di origine dati non è attivo. Utilizza questo metodo per attivare l'esecuzione dei dati per tutti i tipi di origini dati.

// Turns data execution on for all types of data sources.
SpreadsheetApp.enableAllDataSourcesExecution();

// 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 the first data source sheet in the spreadsheet and refreshes the data.
ss.getDataSourceSheets()[0].refreshData();

Autorizzazione

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

  • https://www.googleapis.com/auth/bigquery.readonly

enableBigQueryExecution()

Attiva l'esecuzione dei dati per le origini dati BigQuery.

L'esecuzione dei dati per l'origine dati BigQuery genera un'eccezione se non è attivata.

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

// 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 the first data source sheet in the spreadsheet and refreshes the BigQuery data.
ss.getDataSourceSheets()[0].refreshData();

Autorizzazione

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

  • https://www.googleapis.com/auth/bigquery.readonly

flush()

Applica tutte le modifiche in sospeso al foglio di lavoro.

Le operazioni sui fogli di lavoro vengono a volte raggruppate per migliorare le prestazioni, ad esempio quando si eseguono più chiamate a Range.getValue(). Tuttavia, a volte potresti voler assicurarti che tutte le modifiche in sospeso vengano apportate immediatamente, ad esempio per mostrare i dati degli utenti durante l'esecuzione di uno script.

// The code below changes the background color of cells A1 and B1 twenty times. You should be
// able to see the updates live in the spreadsheet. If flush() is not called, the updates may
// be applied live or may all be applied at once when the script completes.
function colors() {
  var sheet = SpreadsheetApp.getActiveSheet();
  for (var i = 0; i < 20; i++) {
    if ((i % 2) == 0) {
      sheet.getRange('A1').setBackground('green');
      sheet.getRange('B1').setBackground('red');
    } else {
      sheet.getRange('A1').setBackground('red');
      sheet.getRange('B1').setBackground('green');
    }
    SpreadsheetApp.flush();
  }
}

getActive()

Restituisce il foglio di lavoro attualmente attivo o null se non è presente.

Le funzioni eseguite nel contesto di un foglio di lavoro possono ottenere un riferimento all'oggetto Foglio di lavoro corrispondente chiamando questa funzione.

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActive().getUrl());

Ritorni

Spreadsheet: l'oggetto Foglio di lavoro 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

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.

In genere questo indica l'intervallo selezionato da un utente nel foglio attivo, ma in una funzione personalizzata fa riferimento alla cella che viene ricalcolata attivamente.

// The code below logs the background color for the active range.
var colorObject = SpreadsheetApp.getActiveRange().getBackgroundObject();
// Assume the color has ColorType.RGB.
Logger.log(colorObject.asRgbColor().asHexString());

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

getActiveRangeList()

Restituisce l'elenco di intervalli attivi nel foglio attivo o null se non sono selezionati intervalli. L'intervallo attivo contenente la cella evidenziata corrente è posizionato per ultimo nell'elenco.

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

// Returns the list of active ranges.
var rangeList = SpreadsheetApp.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

getActiveSheet()

Restituisce il foglio attivo in un foglio di lavoro.

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

// The code below logs the name of the active sheet.
Logger.log(SpreadsheetApp.getActiveSheet().getName());

Ritorni

Sheet: l'oggetto Fogli 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

getActiveSpreadsheet()

Restituisce il foglio di lavoro attualmente attivo o null se non è presente.

Le funzioni eseguite nel contesto di un foglio di lavoro possono ottenere un riferimento all'oggetto Spreadsheet corrispondente chiamando questa funzione.

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

Ritorni

Spreadsheet: l'oggetto Foglio di lavoro 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

getCurrentCell()

Restituisce la cella corrente (evidenziata) selezionata in uno degli intervalli attivi nel foglio attivo o null in assenza di cella corrente.

// Returns the current highlighted cell in the one of the active ranges.
var currentCell = SpreadsheetApp.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

getSelection()

Restituisce il valore Selection corrente nel foglio di lavoro.

var selection = SpreadsheetApp.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

getUi()

Restituisce un'istanza dell'ambiente dell'interfaccia utente del foglio di lavoro che consente allo script di aggiungere funzionalità come menu, finestre di dialogo e barre laterali. Uno script può interagire con l'interfaccia utente solo per l'istanza corrente di un foglio di lavoro aperto e solo se lo script è associato al foglio di lavoro. Per ulteriori informazioni, consulta le guide ai menu e alle finestre di dialogo e barre laterali.

// Add a custom menu to the active spreadsheet, including a separator and a sub-menu.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(SpreadsheetApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Ritorni

Ui: un'istanza dell'ambiente dell'interfaccia utente di questo foglio di lavoro


newCellImage()

Crea un generatore per un CellImage.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 on Sheet1.
const range = sheet.getRange('A1');

// Builds an image using a source URL.
const cellImage = SpreadsheetApp.newCellImage()
  .setSourceUrl('https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png')
  .build();

// Sets the image in cell A1.
range.setValue(cellImage);

Ritorni

CellImageBuilder: il nuovo strumento per la creazione.


newColor()

Crea un generatore per un Color.

var rgbColor = SpreadsheetApp.newColor().setRgbColor("#FF0000").build();

Ritorni

ColorBuilder: il nuovo strumento per la creazione.


newConditionalFormatRule()

Crea un generatore per una regola di formattazione condizionale.

// Adds a conditional format rule to a sheet that causes all cells in range A1:B3 to turn red
// if they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActive().getActiveSheet();
var range = sheet.getRange('A1:B3');
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build()
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Ritorni

ConditionalFormatRuleBuilder: il nuovo strumento di creazione.


newDataSourceSpec()

Crea un generatore per un DataSourceSpec.

// 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');

// Enables BigQuery.
SpreadsheetApp.enableBigQueryExecution();

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

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

Ritorni

DataSourceSpecBuilder: il nuovo strumento per la creazione.


newDataValidation()

Crea un generatore per una regola di convalida dei dati.

var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireNumberBetween(1, 100)
    .setAllowInvalid(false)
    .setHelpText('Number must be between 1 and 100.')
    .build();
cell.setDataValidation(rule);

Ritorni

DataValidationBuilder: il nuovo strumento per la creazione.


newFilterCriteria()

Crea un generatore per un FilterCriteria.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets the range to A1:D20.
const range = sheet.getRange('A1:D20');

// Creates a filter and applies it to the specified range.
range.createFilter();

// Gets the current filter for the range and creates filter criteria that only shows cells
// that aren't empty.
const filter = range.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();

// Sets the criteria to  column C.
filter.setColumnFilterCriteria(3, criteria);

Ritorni

FilterCriteriaBuilder: il nuovo strumento di creazione


newRichTextValue()

Crea un generatore per un valore RTF.

// Sets cell A1 to have the text "Hello world", with "Hello" bolded.
var cell = SpreadsheetApp.getActive().getRange('A1');
var bold = SpreadsheetApp.newTextStyle().setBold(true).build();
var value = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
cell.setRichTextValue(value);

Ritorni

RichTextValueBuilder: il nuovo strumento per la creazione.


newTextStyle()

Crea un generatore per uno stile di testo.

// Sets range A1:B3 to have red, size 22, bolded, underlined text.
var range = SpreadsheetApp.getActive().getRange('A1:B3');
var style = SpreadsheetApp.newTextStyle()
    .setForegroundColor("red")
    .setFontSize(22)
    .setBold(true)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Ritorni

TextStyleBuilder: il nuovo strumento per la creazione.


open(file)

Apre il foglio di lavoro corrispondente all'oggetto File specificato.

// Get any starred spreadsheets from Google Drive, then open the spreadsheets and log the name
// of the first sheet within each spreadsheet.
var files = DriveApp.searchFiles(
    'starred = true and mimeType = "' + MimeType.GOOGLE_SHEETS + '"');
while (files.hasNext()) {
  var spreadsheet = SpreadsheetApp.open(files.next());
  var sheet = spreadsheet.getSheets()[0];
  Logger.log(sheet.getName());
}

Parametri

NomeTipoDescrizione
fileFileIl file da aprire.

Ritorni

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

openById(id)

Apre il foglio di lavoro con l'ID specificato. L'ID di un foglio di lavoro può essere estratto dal relativo URL. Ad esempio, l'ID del foglio di lavoro nell'URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 è "abc1234567".

// The code below opens a spreadsheet using its ID and logs the name for it.
// Note that the spreadsheet is NOT physically opened on the client side.
// It is opened on the server only (for modification by the script).
var ss = SpreadsheetApp.openById("abc1234567");
Logger.log(ss.getName());

Parametri

NomeTipoDescrizione
idStringL'identificatore univoco del foglio di lavoro.

Ritorni

Spreadsheet: l'oggetto Foglio di lavoro con l'ID specificato

Autorizzazione

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

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

openByUrl(url)

Apre il foglio di lavoro con l'URL specificato. Genera un'eccezione di scripting se l'URL non esiste o se l'utente non è autorizzato ad accedervi.

// Opens a spreadsheet by its URL and logs its name.
// Note that the spreadsheet doesn't physically open on the client side.
// It opens on the server only (for modification by the script).
var ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc1234567/edit');
console.log(ss.getName());

Parametri

NomeTipoDescrizione
urlStringL'URL del foglio di lavoro.

Ritorni

Spreadsheet: l'oggetto del foglio di lavoro con l'URL specificato.

Autorizzazione

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

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

setActiveRange(range)

Imposta l'intervallo specificato come active range, con la cella in alto a sinistra nell'intervallo come current cell.

L'interfaccia utente del foglio di lavoro mostra il foglio che contiene l'intervallo scelto e seleziona le celle definite nell'intervallo scelto.

// The code below sets range C1:D4 in the first sheet as the active range.
var range = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('C1:D4');
SpreadsheetApp.setActiveRange(range);

var selection = SpreadsheetApp.getSelection();
// Current cell: C1
var currentCell = selection.getCurrentCell();
// Active Range: C1:D4
var activeRange = selection.getActiveRange();

Parametri

NomeTipoDescrizione
rangeRangeL'intervallo che deve essere impostato come intervallo attivo.

Ritorni

Range: il nuovo intervallo attivo


setActiveRangeList(rangeList)

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

// The code below sets ranges [D4, B2:C4] in the active sheet as the active ranges.
var rangeList = SpreadsheetApp.getActiveSheet().getRanges(['D4', 'B2:C4']);
SpreadsheetApp.setActiveRangeList(rangeList);

var selection = SpreadsheetApp.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

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

setActiveSheet(sheet)

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

// The code below makes the 2nd sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);

Parametri

NomeTipoDescrizione
sheetSheetIl nuovo foglio attivo.

Ritorni

Sheet: il foglio che è stato impostato come nuovo foglio attivo


setActiveSheet(sheet, restoreSelection)

Imposta il foglio attivo in un foglio di lavoro, con la possibilità di ripristinare la selezione più recente all'interno di quel foglio. L'interfaccia utente di Fogli Google mostra il foglio scelto, a meno che il foglio non appartenga a un altro foglio di lavoro.

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

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

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

Parametri

NomeTipoDescrizione
sheetSheetIl nuovo foglio attivo.
restoreSelectionBooleanSe true, la selezione più recente del nuovo foglio attivo viene selezionata di nuovo quando il nuovo foglio diventa attivo; se false, il nuovo foglio diventa attivo senza modificare la selezione corrente.

Ritorni

Sheet: il nuovo foglio attivo

Autorizzazione

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

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

setActiveSpreadsheet(newActiveSpreadsheet)

Imposta il foglio di lavoro attivo.

// The code below makes the spreadsheet with key "1234567890" the active spreadsheet
var ss = SpreadsheetApp.openById("1234567890");
SpreadsheetApp.setActiveSpreadsheet(ss);

Parametri

NomeTipoDescrizione
newActiveSpreadsheetSpreadsheetIl foglio di lavoro da rendere attivo.

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, la 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 questo metodo genera un'eccezione.

// The code below sets the cell B5 in the first sheet as the current cell.
var cell = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('B5');
SpreadsheetApp.setCurrentCell(cell);

var selection = SpreadsheetApp.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

Parametri

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