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 |
---|---|---|
Auto | Auto | Wyliczenie typów serii używanych do obliczania wartości autouzupełnianych. |
Banding | Banding | Wyliczenie możliwych tematów grupowania. |
Boolean | Boolean | Wyliczenie kryteriów logicznych formatowania warunkowego. |
Border | Border | Wyliczenie prawidłowych stylów do ustawiania obramowania Range . |
Color | Color | Wyliczenie możliwych typów kolorów. |
Copy | Copy | Wyliczenie możliwych typów wklejania. |
Data | Data | Wyliczenie możliwych kodów błędów wykonania danych. |
Data | Data | Wyliczenie możliwych stanów wykonania danych. |
Data | Data | Wyliczenie możliwych typów parametrów źródła danych. |
Data | Data | Wyliczenie możliwych zakresów odświeżania źródeł danych. |
Data | Data | Wyliczenie możliwych typów źródeł danych. |
Data | Data | Wyliczenie reprezentujące kryteria sprawdzania poprawności danych, które można ustawić w zakresie. |
Date | Date | Wyliczenie reguł grupowania „data i godzina”. |
Developer | Developer | Wyliczenie możliwych typów lokalizacji metadanych dewelopera. |
Developer | Developer | 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. |
Frequency | Frequency | Wyliczenie możliwych typów częstotliwości. |
Group | Group | Wyliczenie pozycji, w których może znajdować się przełącznik grupy. |
Interpolation | Interpolation | Wyliczenie typów interpolacji gradientu formatu warunkowego. |
Pivot | Pivot | Wyliczenie funkcji, których można używać do sumowania wartości w tabeli przestawnej. |
Pivot | Pivot | Wyliczenie sposobów wyświetlania wartości w tabeli przestawnej. |
Protection | Protection | Wyliczenie reprezentujące części arkusza kalkulacyjnego, które można chronić przed zmianami. |
Recalculation | Recalculation | Wyliczenie możliwych przedziałów, których można używać w przeliczaniu arkusza kalkulacyjnego. |
Relative | Relative | Wyliczenie opcji daty względnej do obliczenia wartości do użycia w Boolean na podstawie daty. |
Sheet | Sheet | Wyliczenie różnych typów arkuszy, które mogą występować w arkuszu kalkulacyjnym. |
Sort | Sort | Wyliczenie kolejności sortowania. |
Text | Text | Wyliczenie prawidłowych wskazówek tekstowych. |
Text | Text | Wyliczenie wstępnie ustawionych ograniczników do podziału tekstu na kolumny. |
Theme | Theme | Wyliczenie możliwych typów kolorów motywu. |
Value | Value | 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 . |
Wrap | Wrap | 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. |
enable | void | Włącza wykonywanie zapytań do bazy danych we wszystkich typach źródeł danych. |
enable | void | Włącza wykonywanie danych w przypadku źródeł danych BigQuery. |
enable | void | Włącza wykonywanie zapytań do bazy danych w przypadku źródeł danych Looker. |
flush() | void | Stosuje wszystkie oczekujące zmiany w arkuszu kalkulacyjnym. |
get | Spreadsheet | Zwraca aktualnie aktywny arkusz kalkulacyjny lub null , jeśli nie ma żadnego. |
get | Range | Zwraca wybrany zakres na aktywnym arkuszu lub null , jeśli nie ma aktywnego zakresu. |
get | Range | Zwraca listę aktywnych zakresów na aktywnym arkuszu lub null , jeśli nie ma wybranych żadnych zakresów. |
get | Sheet | Pobiera aktywny arkusz w arkuszu kalkulacyjnym. |
get | Spreadsheet | Zwraca aktualnie aktywny arkusz kalkulacyjny lub null , jeśli nie ma żadnego. |
get | 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. |
get | Selection | Zwraca bieżącą wartość Selection w arkuszu kalkulacyjnym. |
get | Ui | Zwraca instancję środowiska interfejsu użytkownika arkusza kalkulacyjnego, która umożliwia skryptowi dodawanie funkcji takich jak menu, okna dialogowe i paski boczne. |
new | Cell | Tworzy kreator dla Cell . |
new | Color | Tworzy kreator dla Color . |
new | Conditional | Tworzy kreator reguły formatowania warunkowego. |
new | Data | Tworzy kreator dla Data . |
new | Data | Tworzy kreator reguły sprawdzania poprawności danych. |
new | Filter | Tworzy kreator dla Filter . |
new | Rich | Tworzy kreator wartości sformatowanego tekstu. |
new | Text | Tworzy kreator stylu tekstu. |
open(file) | Spreadsheet | Otwiera arkusz kalkulacyjny odpowiadający danemu obiektowi pliku. |
open | Spreadsheet | Otwiera arkusz kalkulacyjny o podanym identyfikatorze. |
open | Spreadsheet | Otwiera arkusz kalkulacyjny z podanym adresem URL. |
set | Range | Ustawia określony zakres jako active range , a komórkę w lewym górnym rogu zakresu jako current cell . |
set | Range | Ustawia wskazaną listę zakresów jako active ranges . |
set | Sheet | Ustawia aktywną kartę w arkuszu kalkulacyjnym. |
set | Sheet | Ustawia aktywny arkusz w arkuszu kalkulacyjnym z opcją przywracania ostatniego zaznaczonego obszaru na tym arkuszu. |
set | void | Ustawia aktywny arkusz kalkulacyjny. |
set | 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
enable All Data Sources Execution()
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
enable Big Query Execution()
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
enable Looker Execution()
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(); } }
get Active()
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
get Active Range()
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
get Active Range List()
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 get
.
// Returns the list of active ranges. const rangeList = SpreadsheetApp.getActiveRangeList();
Powrót
Range
— 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
get Active Sheet()
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
get Active Spreadsheet()
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
get Current Cell()
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
get Selection()
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
get Ui()
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
new Cell Image()
Tworzy kreator dla Cell
.
// 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
Cell
– nowy kreator.
new Color()
Tworzy kreator dla Color
.
const rgbColor = SpreadsheetApp.newColor().setRgbColor('#FF0000').build();
Powrót
Color
– nowy kreator.
new Conditional Format Rule()
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
Conditional
– nowy kreator.
new Data Source Spec()
Tworzy kreator dla Data
.
// 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
Data
– nowy kreator.
new Data Validation()
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
Data
– nowy kreator.
new Filter Criteria()
Tworzy kreator dla Filter
.
// 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
Filter
– nowy kreator
new Rich Text Value()
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
Rich
– nowy kreator.
new Text Style()
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
Text
– 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
open By Id(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
open By Url(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
set Active Range(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
set Active Range List(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 |
---|---|---|
range | Range | Lista zakresów do wyboru. |
Powrót
Range
– 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
set Active Sheet(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
set Active Sheet(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. |
restore | 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
set Active Spreadsheet(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 |
---|---|---|
new | Spreadsheet | Arkusz kalkulacyjny, który ma być aktywny. |
set Current Cell(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 zostać 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