Ta strona została przetłumaczona przez Cloud Translation API.

Class SpreadsheetApp

Uzyskiwać dostęp do plików Arkuszy Google i je tworzyć. Ta klasa jest klasą nadrzędną dla usługi Arkusz.

Właściwości

Właściwość	Typ	Opis
`AutoFillSeries`	`AutoFillSeries`	Wyliczenie typów serii używanych do obliczania wartości autouzupełnianych.
`BandingTheme`	`BandingTheme`	Wyliczenie możliwych tematów grupowania.
`BooleanCriteria`	`BooleanCriteria`	Wyliczenie kryteriów logicznych formatowania warunkowego.
`BorderStyle`	`BorderStyle`	Wyliczenie prawidłowych stylów do ustawiania obramowania `Range`.
`ColorType`	`ColorType`	Wyliczenie możliwych typów kolorów.
`CopyPasteType`	`CopyPasteType`	Wyliczenie możliwych typów wklejania.
`DataExecutionErrorCode`	`DataExecutionErrorCode`	Wyliczenie możliwych kodów błędów wykonania danych.
`DataExecutionState`	`DataExecutionState`	Wyliczenie możliwych stanów wykonania danych.
`DataSourceParameterType`	`DataSourceParameterType`	Wyliczenie możliwych typów parametrów źródła danych.
`DataSourceRefreshScope`	`DataSourceRefreshScope`	Wyliczenie możliwych zakresów odświeżania źródeł danych.
`DataSourceType`	`DataSourceType`	Wyliczenie możliwych typów źródeł danych.
`DataValidationCriteria`	`DataValidationCriteria`	Wyliczenie reprezentujące kryteria sprawdzania poprawności danych, które można ustawić w zakresie.
`DateTimeGroupingRuleType`	`DateTimeGroupingRuleType`	Wyliczenie reguł grupowania „data i godzina”.
`DeveloperMetadataLocationType`	`DeveloperMetadataLocationType`	Wyliczenie możliwych typów lokalizacji metadanych dewelopera.
`DeveloperMetadataVisibility`	`DeveloperMetadataVisibility`	Wyliczenie możliwych widoczności metadanych dewelopera.
`Dimension`	`Dimension`	Wyliczenie możliwych wymiarów arkusza kalkulacyjnego.
`Direction`	`Direction`	Wyliczenie możliwych kierunków, w których można się poruszać w arkuszu kalkulacyjnym za pomocą klawiszy strzałek.
`FrequencyType`	`FrequencyType`	Wyliczenie możliwych typów częstotliwości.
`GroupControlTogglePosition`	`GroupControlTogglePosition`	Wyliczenie pozycji, w których może znajdować się przełącznik grupy.
`InterpolationType`	`InterpolationType`	Wyliczenie typów interpolacji gradientu formatu warunkowego.
`PivotTableSummarizeFunction`	`PivotTableSummarizeFunction`	Wyliczenie funkcji, których można używać do sumowania wartości w tabeli przestawnej.
`PivotValueDisplayType`	`PivotValueDisplayType`	Wyliczenie sposobów wyświetlania wartości w tabeli przestawnej.
`ProtectionType`	`ProtectionType`	Wyliczenie reprezentujące części arkusza kalkulacyjnego, które można chronić przed zmianami.
`RecalculationInterval`	`RecalculationInterval`	Wyliczenie możliwych przedziałów, których można używać w przeliczaniu arkusza kalkulacyjnego.
`RelativeDate`	`RelativeDate`	Wyliczenie opcji daty względnej do obliczenia wartości do użycia w `BooleanCriteria` na podstawie daty.
`SheetType`	`SheetType`	Wyliczenie różnych typów arkuszy, które mogą występować w arkuszu kalkulacyjnym.
`SortOrder`	`SortOrder`	Wyliczenie kolejności sortowania.
`TextDirection`	`TextDirection`	Wyliczenie prawidłowych wskazówek tekstowych.
`TextToColumnsDelimiter`	`TextToColumnsDelimiter`	Wyliczenie wstępnie ustawionych ograniczników do podziału tekstu na kolumny.
`ThemeColorType`	`ThemeColorType`	Wyliczenie możliwych typów kolorów motywu.
`ValueType`	`ValueType`	Wyliczenie typów wartości zwracanych przez funkcje `Range.getValue()` i `Range.getValues()` z klasy Range usługi Arkusz kalkulacyjny. Wartości wyliczenia wymienione poniżej są dodatkowe w porównaniu do wartości `Number`, `Boolean`, `Date` lub `String`.
`WrapStrategy`	`WrapStrategy`	Wyliczenie strategii stosowanych do zawijania komórek.

Metody

Metoda	Zwracany typ	Krótki opis
`create(name)`	`Spreadsheet`	Tworzy nowy arkusz kalkulacyjny o podanej nazwie.
`create(name, rows, columns)`	`Spreadsheet`	Tworzy nowy arkusz kalkulacyjny o podanej nazwie i określonej liczbie wierszy i kolumn.
`enableAllDataSourcesExecution()`	`void`	Włącza wykonywanie zapytań do bazy danych we wszystkich typach źródeł danych.
`enableBigQueryExecution()`	`void`	Włącza wykonywanie danych w przypadku źródeł danych BigQuery.
`enableLookerExecution()`	`void`	Włącza wykonywanie zapytań do bazy danych w przypadku źródeł danych Looker.
`flush()`	`void`	Stosuje wszystkie oczekujące zmiany w arkuszu kalkulacyjnym.
`getActive()`	`Spreadsheet`	Zwraca aktualnie aktywny arkusz kalkulacyjny lub `null`, jeśli nie ma żadnego.
`getActiveRange()`	`Range`	Zwraca wybrany zakres na aktywnym arkuszu lub `null`, jeśli nie ma aktywnego zakresu.
`getActiveRangeList()`	`RangeList`	Zwraca listę aktywnych zakresów na aktywnym arkuszu lub `null`, jeśli nie ma wybranych żadnych zakresów.
`getActiveSheet()`	`Sheet`	Pobiera aktywny arkusz w arkuszu kalkulacyjnym.
`getActiveSpreadsheet()`	`Spreadsheet`	Zwraca aktualnie aktywny arkusz kalkulacyjny lub `null`, jeśli nie ma żadnego.
`getCurrentCell()`	`Range`	Zwraca bieżącą (zaznaczoną) komórkę wybraną w jednym z aktywnych zakresów w aktywnym arkuszu lub `null`, jeśli nie ma bieżącej komórki.
`getSelection()`	`Selection`	Zwraca bieżącą wartość `Selection` w arkuszu kalkulacyjnym.
`getUi()`	`Ui`	Zwraca instancję środowiska interfejsu użytkownika arkusza kalkulacyjnego, która umożliwia skryptowi dodawanie funkcji takich jak menu, okna dialogowe i paski boczne.
`newCellImage()`	`CellImageBuilder`	Tworzy kreator dla `CellImage`.
`newColor()`	`ColorBuilder`	Tworzy kreator dla `Color`.
`newConditionalFormatRule()`	`ConditionalFormatRuleBuilder`	Tworzy kreator reguły formatowania warunkowego.
`newDataSourceSpec()`	`DataSourceSpecBuilder`	Tworzy kreator dla `DataSourceSpec`.
`newDataValidation()`	`DataValidationBuilder`	Tworzy kreator reguły sprawdzania poprawności danych.
`newFilterCriteria()`	`FilterCriteriaBuilder`	Tworzy kreator dla `FilterCriteria`.
`newRichTextValue()`	`RichTextValueBuilder`	Tworzy kreator wartości sformatowanego tekstu.
`newTextStyle()`	`TextStyleBuilder`	Tworzy kreator stylu tekstu.
`open(file)`	`Spreadsheet`	Otwiera arkusz kalkulacyjny odpowiadający danemu obiektowi pliku.
`openById(id)`	`Spreadsheet`	Otwiera arkusz kalkulacyjny o podanym identyfikatorze.
`openByUrl(url)`	`Spreadsheet`	Otwiera arkusz kalkulacyjny z podanym adresem URL.
`setActiveRange(range)`	`Range`	Ustawia określony zakres jako `active range`, a komórkę w lewym górnym rogu zakresu jako `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Ustawia wskazaną listę zakresów jako `active ranges`.
`setActiveSheet(sheet)`	`Sheet`	Ustawia aktywną kartę w arkuszu kalkulacyjnym.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	Ustawia aktywny arkusz w arkuszu kalkulacyjnym z opcją przywracania ostatniego zaznaczonego obszaru na tym arkuszu.
`setActiveSpreadsheet(newActiveSpreadsheet)`	`void`	Ustawia aktywny arkusz kalkulacyjny.
`setCurrentCell(cell)`	`Range`	Ustawia wskazaną komórkę jako `current cell`.

Szczegółowa dokumentacja

`create(name)`

Tworzy nowy arkusz kalkulacyjny o podanej nazwie.

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

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa arkusza kalkulacyjnego.

Powrót

Spreadsheet – nowy arkusz kalkulacyjny,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`create(name, rows, columns)`

Tworzy nowy arkusz kalkulacyjny o podanej nazwie i określonej liczbie wierszy i kolumn.

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

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa arkusza kalkulacyjnego.
`rows`	`Integer`	Liczba wierszy w arkuszu kalkulacyjnym.
`columns`	`Integer`	Liczba kolumn w arkuszu kalkulacyjnym.

Powrót

Spreadsheet – nowy arkusz kalkulacyjny,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`enableAllDataSourcesExecution()`

Włącza wykonywanie zapytań do bazy danych we wszystkich typach źródeł danych.

Jeśli typ źródła danych nie jest włączony, wykonanie danych powoduje wyjątek. Użyj tej metody, aby włączyć wykonywanie zapytań do bazy danych we wszystkich typach źródeł danych.

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

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`enableBigQueryExecution()`

Włącza wykonywanie danych w przypadku źródeł danych BigQuery.

Jeśli nie jest włączone, wykonywanie danych w źródle danych BigQuery powoduje wyjątek.

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

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`enableLookerExecution()`

Włącza wykonywanie zapytań do bazy danych w przypadku źródeł danych Looker.

Jeśli źródło danych Looker nie jest włączone, wywołuje ono wyjątek.

// Turns data execution on for Looker data sources.
SpreadsheetApp.enableLookerExecution();

// 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
// associated Looker data.
ss.getDataSourceSheets()[0].refreshData();

`flush()`

Stosuje wszystkie oczekujące zmiany w arkuszu kalkulacyjnym.

Operacje arkusza kalkulacyjnego są czasami łączone w pakiety w celu poprawy wydajności, np. gdy wykonywane są wielokrotne wywołania funkcji Range.getValue(). Czasami jednak warto zadbać o to, aby wszystkie oczekujące zmiany zostały wprowadzone od razu, np. aby wyświetlić dane użytkowników podczas wykonywania skryptu.

// 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() {
  const sheet = SpreadsheetApp.getActiveSheet();
  for (let 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()`

Zwraca aktualnie aktywny arkusz kalkulacyjny lub null, jeśli nie ma żadnego.

Funkcje, które są wykonywane w kontekście arkusza kalkulacyjnego, mogą uzyskać odwołanie do odpowiedniego obiektu Arkusz kalkulacyjny, wywołując tę funkcję.

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

Powrót

Spreadsheet – aktywny obiekt Arkusz kalkulacyjny

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getActiveRange()`

Zwraca wybrany zakres na aktywnym arkuszu lub null, jeśli nie ma aktywnego zakresu. Jeśli wybrano kilka zakresów, ta metoda zwraca tylko ostatni wybrany zakres.

Zwykle oznacza to zakres wybrany przez użytkownika na aktywnym arkuszu, ale w funkcji niestandardowej odnosi się do komórki, która jest aktywnie przeliczana.

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

Powrót

Range – aktywny zakres.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getActiveRangeList()`

Zwraca listę aktywnych zakresów na aktywnym arkuszu lub null, jeśli nie ma wybranych żadnych zakresów. Aktywny zakres zawierający aktualnie wyróżnioną komórkę jest umieszczany na końcu listy.

Jeśli wybrany jest pojedynczy zakres, działa on jak wywołanie funkcji getActiveRange().

// Returns the list of active ranges.
const rangeList = SpreadsheetApp.getActiveRangeList();

Powrót

RangeList — lista aktywnych zakresów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getActiveSheet()`

Pobiera aktywny arkusz w arkuszu kalkulacyjnym.

Aktywny arkusz w arkuszu kalkulacyjnym to arkusz wyświetlany w interfejsie arkusza kalkulacyjnego.

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

Powrót

Sheet – aktywny obiekt Arkusz.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getActiveSpreadsheet()`

Zwraca aktualnie aktywny arkusz kalkulacyjny lub null, jeśli nie ma żadnego.

Funkcje, które są wykonywane w kontekście arkusza kalkulacyjnego, mogą uzyskać odwołanie do odpowiedniego obiektu Spreadsheet, wywołując tę funkcję.

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

Powrót

Spreadsheet – aktywny obiekt Arkusz kalkulacyjny

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getCurrentCell()`

Zwraca bieżącą (zaznaczoną) komórkę wybraną w jednym z aktywnych zakresów w aktywnym arkuszu lub null, jeśli nie ma bieżącej komórki.

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

Powrót

Range – bieżąca komórka

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getSelection()`

Zwraca bieżącą wartość Selection w arkuszu kalkulacyjnym.

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

Powrót

Selection – bieżący wybór

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getUi()`

Zwraca instancję środowiska interfejsu użytkownika arkusza kalkulacyjnego, która umożliwia skryptowi dodawanie funkcji takich jak menu, okna dialogowe i paski boczne. Skrypt może wchodzić w interakcję z interfejsem tylko w bieżącej instancji otwartego arkusza kalkulacyjnego i tylko wtedy, gdy jest on powiązany z tym arkuszem. Więcej informacji znajdziesz w przewodnikach dotyczących menu oraz okienek dialogowych i pasków bocznych.

// 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();
}

Powrót

Ui – instancja środowiska interfejsu tej arkusza kalkulacyjnego

`newCellImage()`

Tworzy kreator dla 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);

Powrót

CellImageBuilder – nowy kreator.

`newColor()`

Tworzy kreator dla Color.

const rgbColor = SpreadsheetApp.newColor().setRgbColor('#FF0000').build();

Powrót

ColorBuilder – nowy kreator.

`newConditionalFormatRule()`

Tworzy kreator reguły formatowania warunkowego.

// 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.
const sheet = SpreadsheetApp.getActive().getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Powrót

ConditionalFormatRuleBuilder – nowy kreator.

`newDataSourceSpec()`

Tworzy kreator dla 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);

Powrót

DataSourceSpecBuilder – nowy kreator.

`newDataValidation()`

Tworzy kreator reguły sprawdzania poprawności danych.

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

Powrót

DataValidationBuilder – nowy kreator.

`newFilterCriteria()`

Tworzy kreator dla 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);

Powrót

FilterCriteriaBuilder – nowy kreator

`newRichTextValue()`

Tworzy kreator wartości sformatowanego tekstu.

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

Powrót

RichTextValueBuilder – nowy kreator.

`newTextStyle()`

Tworzy kreator stylu tekstu.

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

Powrót

TextStyleBuilder – nowy kreator.

`open(file)`

Otwiera arkusz kalkulacyjny odpowiadający danemu obiektowi pliku.

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

Parametry

Nazwa	Typ	Opis
`file`	`File`	Plik do otwarcia.

Powrót

Spreadsheet – arkusz kalkulacyjny,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`openById(id)`

Otwiera arkusz kalkulacyjny o podanym identyfikatorze. Identyfikator arkusza kalkulacyjnego można wyodrębnić z jego adresu URL. Na przykład identyfikator arkusza w adresie URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 to „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).
const ss = SpreadsheetApp.openById('abc1234567');
Logger.log(ss.getName());

Parametry

Nazwa	Typ	Opis
`id`	`String`	Unikalny identyfikator arkusza kalkulacyjnego.

Powrót

Spreadsheet – obiekt arkusza kalkulacyjnego o podanym identyfikatorze

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`openByUrl(url)`

Otwiera arkusz kalkulacyjny z podanym adresem URL. Wyjątek skryptu, jeśli adres URL nie istnieje lub użytkownik nie ma do niego dostępu.

// 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).
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc1234567/edit',
);
console.log(ss.getName());

Parametry

Nazwa	Typ	Opis
`url`	`String`	Adres URL arkusza kalkulacyjnego.

Powrót

Spreadsheet – obiekt arkusza kalkulacyjnego o podanym adresie URL.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setActiveRange(range)`

Ustawia określony zakres jako active range, a komórkę w lewym górnym rogu zakresu jako current cell.

Interfejs arkusza kalkulacyjnego wyświetla arkusz zawierający wybrany zakres i wybiera komórki zdefiniowane w wybranym zakresie.

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

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

Parametry

Nazwa	Typ	Opis
`range`	`Range`	Zakres, który ma być aktywny.

Powrót

Range – nowy aktywny zakres

`setActiveRangeList(rangeList)`

Ustawia wskazaną listę zakresów jako active ranges. Ostatni zakres na liście jest ustawiony jako active range.

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

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

Parametry

Nazwa	Typ	Opis
`rangeList`	`RangeList`	Lista zakresów do wyboru.

Powrót

RangeList – nowo wybrana lista zakresów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setActiveSheet(sheet)`

Ustawia aktywną kartę w arkuszu kalkulacyjnym. Interfejs Arkuszy Google wyświetla wybrany arkusz, chyba że należy on do innego arkusza kalkulacyjnego.

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

Parametry

Nazwa	Typ	Opis
`sheet`	`Sheet`	Nowy aktywny arkusz.

Powrót

Sheet – nowy aktywny arkusz

`setActiveSheet(sheet, restoreSelection)`

Ustawia aktywny arkusz w arkuszu kalkulacyjnym z opcją przywracania ostatniego zaznaczonego obszaru na tym arkuszu. Interfejs Arkuszy Google wyświetla wybrany arkusz, chyba że należy on do innego arkusza kalkulacyjnego.

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

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

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

Parametry

Nazwa	Typ	Opis
`sheet`	`Sheet`	Nowy aktywny arkusz.
`restoreSelection`	`Boolean`	Jeśli ustawisz wartość `true`, ostatnio wybrany element nowego aktywnego arkusza zostanie ponownie wybrany, gdy nowy arkusz stanie się aktywny. Jeśli ustawisz wartość `false`, nowy arkusz stanie się aktywny bez zmiany bieżącego wyboru.

Powrót

Sheet – nowy aktywny arkusz

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setActiveSpreadsheet(newActiveSpreadsheet)`

Ustawia aktywny arkusz kalkulacyjny.

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

Parametry

Nazwa	Typ	Opis
`newActiveSpreadsheet`	`Spreadsheet`	Arkusz kalkulacyjny, który ma być aktywny.

`setCurrentCell(cell)`

Ustawia wskazaną komórkę jako current cell.

Jeśli wybrana komórka znajduje się w już wybranym zakresie, ten zakres staje się aktywnym zakresem, a komórka staje się bieżącą komórką.

Jeśli wybrana komórka nie znajduje się w żadnym wybranym zakresie, dotychczasowe zaznaczenie zostanie usunięte, a komórka stanie się bieżącą komórką i aktywnym zakresem.

Uwaga: podana wartość Range musi składać się z jednej komórki, w przeciwnym razie ta metoda rzuci wyjątek.

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

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

Parametry

Nazwa	Typ	Opis
`cell`	`Range`	Komórka, która ma być ustawiona jako bieżąca komórka.

Powrót

Range – nowo ustawiona bieżąca komórka

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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