uzyskiwać dostęp do plików Arkuszy Google i je modyfikować; Typowe operacje to dodawanie nowych arkuszy i dodawanie współpracowników.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addDeveloperMetadata(key) | Spreadsheet | Dodaje do arkusza kalkulacyjnego najwyższego poziomu metadane dewelopera z określonym kluczem. |
addDeveloperMetadata(key, visibility) | Spreadsheet | Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem i widocznością. |
addDeveloperMetadata(key, value) | Spreadsheet | Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem i wartością. |
addDeveloperMetadata(key, value, visibility) | Spreadsheet | Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem, wartością i widocznością. |
addEditor(emailAddress) | Spreadsheet | Dodaje wskazanego użytkownika do listy edytorów w Spreadsheet . |
addEditor(user) | Spreadsheet | Dodaje wskazanego użytkownika do listy edytorów w Spreadsheet . |
addEditors(emailAddresses) | Spreadsheet | Dodaje podaną tablicę użytkowników do listy edytorów elementu Spreadsheet . |
addMenu(name, subMenus) | void | Tworzy nowe menu w interfejsie arkusza kalkulacyjnego. |
addViewer(emailAddress) | Spreadsheet | Dodaje danego użytkownika do listy przeglądających stronę Spreadsheet . |
addViewer(user) | Spreadsheet | Dodaje danego użytkownika do listy przeglądających stronę Spreadsheet . |
addViewers(emailAddresses) | Spreadsheet | Dodaje podaną tablicę użytkowników do listy osób przeglądających element Spreadsheet . |
appendRow(rowContents) | Sheet | Dodaje wiersz na dole bieżącego regionu danych w arkuszu. |
autoResizeColumn(columnPosition) | Sheet | Ustawia szerokość danej kolumny, aby pasowała do jej zawartości. |
copy(name) | Spreadsheet | Kopiuje arkusz kalkulacyjny i zwraca nowy. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Zwraca DeveloperMetadataFinder do wyszukiwania metadanych dewelopera w zakresie tego arkusza kalkulacyjnego. |
createTextFinder(findText) | TextFinder | Tworzy w arkuszu kalkulacyjnym funkcję wyszukiwania tekstu, która pozwala znajdować i zastępować tekst w arkuszu kalkulacyjnym. |
deleteActiveSheet() | Sheet | Usuwa aktualnie aktywny arkusz. |
deleteColumn(columnPosition) | Sheet | Usuwa kolumnę znajdującą się w danym miejscu. |
deleteColumns(columnPosition, howMany) | void | Usuwa liczbę kolumn, zaczynając od podanej pozycji kolumny. |
deleteRow(rowPosition) | Sheet | Usuwa wiersz na podanej pozycji. |
deleteRows(rowPosition, howMany) | void | Usuwa wiele wierszy, zaczynając od określonej pozycji wiersza. |
deleteSheet(sheet) | void | Usuwa określony arkusz. |
duplicateActiveSheet() | Sheet | Powiela aktywny arkusz i zmienia go w aktywny. |
getActiveCell() | Range | Zwraca aktywną komórkę w tym arkuszu. |
getActiveRange() | Range | Zwraca wybrany zakres w aktywnym arkuszu lub null , jeśli nie ma aktywnego zakresu. |
getActiveRangeList() | RangeList | Zwraca listę aktywnych zakresów w aktywnym arkuszu lub funkcję null , jeśli nie ma aktywnych zakresów. |
getActiveSheet() | Sheet | Pobiera aktywny arkusz z arkusza kalkulacyjnego. |
getAs(contentType) | Blob | Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. |
getBandings() | Banding[] | Zwraca wszystkie pasma w tym arkuszu kalkulacyjnym. |
getBlob() | Blob | Zwracaj dane wewnątrz tego obiektu jako obiekt blob. |
getColumnWidth(columnPosition) | Integer | Pobiera szerokość danej kolumny w pikselach. |
getCurrentCell() | Range | Zwraca bieżącą komórkę w aktywnym arkuszu lub null , jeśli nie ma bieżącej komórki. |
getDataRange() | Range | Zwraca wartość Range odpowiadającą wymiarowi, w którym znajdują się dane. |
getDataSourceFormulas() | DataSourceFormula[] | Pobiera wszystkie formuły źródeł danych. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Pobiera wszystkie tabele przestawne źródła danych. |
getDataSourceRefreshSchedules() | DataSourceRefreshSchedule[] | Pobiera harmonogramy odświeżania tego arkusza kalkulacyjnego. |
getDataSourceSheets() | DataSourceSheet[] | Zwraca wszystkie arkusze źródeł danych w arkuszu kalkulacyjnym. |
getDataSourceTables() | DataSourceTable[] | Pobiera wszystkie tabele źródeł danych. |
getDataSources() | DataSource[] | Zwraca wszystkie źródła danych w arkuszu kalkulacyjnym. |
getDeveloperMetadata() | DeveloperMetadata[] | Pobiera metadane dewelopera powiązane z arkuszem kalkulacyjnym najwyższego poziomu. |
getEditors() | User[] | Pobiera listę edytorów tego elementu (Spreadsheet ). |
getFormUrl() | String | Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza kalkulacyjnego, lub null , jeśli arkusz kalkulacyjny nie ma powiązanego formularza. |
getFrozenColumns() | Integer | Zwraca liczbę zablokowanych kolumn. |
getFrozenRows() | Integer | Zwraca liczbę zablokowanych wierszy. |
getId() | String | Pobiera unikalny identyfikator tego arkusza kalkulacyjnego. |
getImages() | OverGridImage[] | Zwraca wszystkie obrazy w siatce. |
getIterativeCalculationConvergenceThreshold() | Number | Zwraca wartość progową używaną podczas obliczeń iteracyjnych. |
getLastColumn() | Integer | Zwraca pozycję ostatniej kolumny, która zawiera treść. |
getLastRow() | Integer | Zwraca pozycję ostatniego wiersza zawierającego treść. |
getMaxIterativeCalculationCycles() | Integer | Zwraca maksymalną liczbę iteracji do użycia podczas obliczeń iteracyjnych. |
getName() | String | Pobiera nazwę dokumentu. |
getNamedRanges() | NamedRange[] | Pobiera wszystkie zakresy nazwane z tego arkusza kalkulacyjnego. |
getNumSheets() | Integer | Zwraca liczbę arkuszy w tym arkuszu kalkulacyjnym. |
getOwner() | User | Zwraca właściciela dokumentu lub null w przypadku dokumentu na dysku współdzielonym. |
getPredefinedSpreadsheetThemes() | SpreadsheetTheme[] | Zwraca listę wstępnie zdefiniowanych motywów. |
getProtections(type) | Protection[] | Pobiera tablicę obiektów reprezentujących wszystkie chronione zakresy lub arkusze w arkuszu kalkulacyjnym. |
getRange(a1Notation) | Range | Zwraca zakres określony w notacji A1 lub w notacji R1C1. |
getRangeByName(name) | Range | Zwraca zakres nazwany lub null , jeśli nie znaleziono zakresu o podanej nazwie. |
getRangeList(a1Notations) | RangeList | Zwraca kolekcję RangeList reprezentującą zakresy w tym samym arkuszu określoną za pomocą niepustej listy notacji A1 lub notacji R1C1. |
getRecalculationInterval() | RecalculationInterval | Zwraca interwał obliczeniowy dla tego arkusza kalkulacyjnego. |
getRowHeight(rowPosition) | Integer | Pobiera wysokość danego wiersza w pikselach. |
getSelection() | Selection | Zwraca bieżącą wartość Selection z arkusza kalkulacyjnego. |
getSheetByName(name) | Sheet | Zwraca arkusz o podanej nazwie. |
getSheetId() | Integer | Zwraca identyfikator arkusza reprezentowanego przez ten obiekt. |
getSheetName() | String | Zwraca nazwę arkusza. |
getSheetValues(startRow, startColumn, numRows, numColumns) | Object[][] | Zwraca prostokątną siatkę wartości dla tego zakresu, zaczynając od podanych współrzędnych. |
getSheets() | Sheet[] | Pobiera wszystkie arkusze z tego arkusza kalkulacyjnego. |
getSpreadsheetLocale() | String | Pobiera ustawienia regionalne arkusza kalkulacyjnego. |
getSpreadsheetTheme() | SpreadsheetTheme | Zwraca bieżący motyw arkusza kalkulacyjnego lub wartość null , jeśli nie zastosowano żadnego motywu. |
getSpreadsheetTimeZone() | String | Pobiera strefę czasową arkusza kalkulacyjnego. |
getUrl() | String | Zwraca adres URL danego arkusza kalkulacyjnego. |
getViewers() | User[] | Pobiera listę przeglądających i komentujących tego elementu (Spreadsheet ). |
hideColumn(column) | void | Ukrywa kolumnę lub kolumny w danym zakresie. |
hideRow(row) | void | Ukrywa wiersze w danym zakresie. |
insertColumnAfter(afterPosition) | Sheet | Wstawia kolumnę po podanej pozycji kolumny. |
insertColumnBefore(beforePosition) | Sheet | Wstawia kolumnę przed podaną pozycją kolumny. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Wstawia podaną liczbę kolumn po podanej pozycji kolumny. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Wstawia pewną liczbę kolumn przed podaną pozycją kolumny. |
insertDataSourceSheet(spec) | DataSourceSheet | Wstawia nowy element DataSourceSheet w arkuszu kalkulacyjnym i rozpoczyna wykonywanie danych. |
insertImage(blobSource, column, row) | OverGridImage | Wstawia Spreadsheet jako obraz w dokumencie w danym wierszu i kolumnie. |
insertImage(blobSource, column, row, offsetX, offsetY) | OverGridImage | Wstawia Spreadsheet jako obraz w dokumencie w określonym wierszu i kolumnie z przesunięciem piksela. |
insertImage(url, column, row) | OverGridImage | Wstawia obraz w dokumencie w danym wierszu i kolumnie. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Wstawia obraz w dokumencie w danym wierszu i kolumnie z odsunięciem piksela. |
insertRowAfter(afterPosition) | Sheet | Wstawia wiersz po podanej pozycji wiersza. |
insertRowBefore(beforePosition) | Sheet | Wstawia wiersz przed podaną pozycją wiersza. |
insertRowsAfter(afterPosition, howMany) | Sheet | Wstawia liczbę wierszy po podanej pozycji wiersza. |
insertRowsBefore(beforePosition, howMany) | Sheet | Wstawia pewną liczbę wierszy przed podaną pozycją wiersza. |
insertSheet() | Sheet | Wstawia do arkusza kalkulacyjnego nowy arkusz z domyślną nazwą arkusza. |
insertSheet(sheetIndex) | Sheet | Wstawia nowy arkusz do arkusza kalkulacyjnego w danym indeksie. |
insertSheet(sheetIndex, options) | Sheet | Wstawia nowy arkusz w arkuszu kalkulacyjnym w danym indeksie i używa opcjonalnych argumentów zaawansowanych. |
insertSheet(options) | Sheet | Wstawia do arkusza kalkulacyjnego nowy arkusz z użyciem domyślnej nazwy arkusza i opcjonalnych argumentów zaawansowanych. |
insertSheet(sheetName) | Sheet | Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie. |
insertSheet(sheetName, sheetIndex) | Sheet | Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie w danym indeksie. |
insertSheet(sheetName, sheetIndex, options) | Sheet | Wstawia do arkusza kalkulacyjnego nowy arkusz z podaną nazwą w danym indeksie i używa opcjonalnych argumentów zaawansowanych. |
insertSheet(sheetName, options) | Sheet | Wstawia do arkusza kalkulacyjnego nowy arkusz z podaną nazwą i używa opcjonalnych argumentów zaawansowanych. |
insertSheetWithDataSourceTable(spec) | Sheet | Wstawia w arkuszu kalkulacyjnym nowy arkusz, tworzy element DataSourceTable rozciągający cały arkusz zgodnie ze specyfikacją źródła danych i rozpoczyna wykonywanie kodu. |
isColumnHiddenByUser(columnPosition) | Boolean | Zwraca, czy dana kolumna jest ukryta przez użytkownika. |
isIterativeCalculationEnabled() | Boolean | Wskazuje, czy w tym arkuszu kalkulacyjnym są włączone obliczenia iteracyjne. |
isRowHiddenByFilter(rowPosition) | Boolean | Zwraca, czy dany wiersz został ukryty przez filtr (a nie przez widok filtra). |
isRowHiddenByUser(rowPosition) | Boolean | Zwraca, czy dany wiersz jest ukryty przez użytkownika. |
moveActiveSheet(pos) | void | Przenosi aktywny arkusz na określoną pozycję na liście arkuszy. |
moveChartToObjectSheet(chart) | Sheet | Tworzy nowy arkusz SheetType.OBJECT i przenosi do niego udostępniony wykres. |
refreshAllDataSources() | void | Odświeża wszystkie obsługiwane źródła danych i powiązane z nimi obiekty źródeł danych, pomijając nieprawidłowe obiekty źródeł danych. |
removeEditor(emailAddress) | Spreadsheet | Usuwa danego użytkownika z listy edytorów Spreadsheet . |
removeEditor(user) | Spreadsheet | Usuwa danego użytkownika z listy edytorów Spreadsheet . |
removeMenu(name) | void | Usuwa menu dodane przez użytkownika addMenu(name, subMenus) . |
removeNamedRange(name) | void | Usuwa zakres nazwany o podanej nazwie. |
removeViewer(emailAddress) | Spreadsheet | Usuwa danego użytkownika z listy przeglądających i komentujących elementu Spreadsheet . |
removeViewer(user) | Spreadsheet | Usuwa danego użytkownika z listy przeglądających i komentujących elementu Spreadsheet . |
rename(newName) | void | Zmienia nazwę dokumentu. |
renameActiveSheet(newName) | void | Zmienia nazwę aktualnie aktywnego arkusza na nową nazwę. |
resetSpreadsheetTheme() | SpreadsheetTheme | Usuwa zastosowany motyw i ustawia motyw domyślny w arkuszu kalkulacyjnym. |
setActiveRange(range) | Range | Ustawia określony zakres jako active range w aktywnym arkuszu, a lewa górna komórka w zakresie to current cell . |
setActiveRangeList(rangeList) | RangeList | Ustawia określoną listę zakresów jako active ranges w aktywnym arkuszu. |
setActiveSelection(range) | Range | Określa aktywny region zaznaczenia w tym arkuszu. |
setActiveSelection(a1Notation) | Range | Ustawia aktywne zaznaczenie zgodnie z zapisem A1 lub notacją R1C1. |
setActiveSheet(sheet) | Sheet | Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym. |
setActiveSheet(sheet, restoreSelection) | Sheet | Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym, ale z możliwością przywrócenia ostatniego zaznaczenia w tym arkuszu. |
setColumnWidth(columnPosition, width) | Sheet | Ustawia szerokość danej kolumny w pikselach. |
setCurrentCell(cell) | Range | Ustawia określoną komórkę jako current cell . |
setFrozenColumns(columns) | void | Blokuje podaną liczbę kolumn. |
setFrozenRows(rows) | void | Blokuje podaną liczbę wierszy. |
setIterativeCalculationConvergenceThreshold(minThreshold) | Spreadsheet | Ustawia minimalną wartość progową dla obliczeń iteracyjnych. |
setIterativeCalculationEnabled(isEnabled) | Spreadsheet | Określa, czy w tym arkuszu kalkulacyjnym mają być aktywowane obliczenia iteracyjne. |
setMaxIterativeCalculationCycles(maxIterations) | Spreadsheet | Określa maksymalną liczbę iteracji obliczeń, które należy wykonać podczas obliczeń iteracyjnych. |
setNamedRange(name, range) | void | Określa zakres. |
setRecalculationInterval(recalculationInterval) | Spreadsheet | Określa częstotliwość ponownego obliczania danych w arkuszu kalkulacyjnym. |
setRowHeight(rowPosition, height) | Sheet | Ustawia wysokość wiersza danego wiersza w pikselach. |
setSpreadsheetLocale(locale) | void | Określa ustawienia regionalne arkusza kalkulacyjnego. |
setSpreadsheetTheme(theme) | SpreadsheetTheme | Ustawia motyw w arkuszu kalkulacyjnym. |
setSpreadsheetTimeZone(timezone) | void | Określa strefę czasową arkusza kalkulacyjnego. |
show(userInterface) | void | Wyświetla niestandardowy komponent interfejsu w oknie pośrodku widocznego obszaru przeglądarki użytkownika. |
sort(columnPosition) | Sheet | Sortuje arkusz według kolumny rosnąco. |
sort(columnPosition, ascending) | Sheet | Sortuje arkusz według kolumny. |
toast(msg) | void | W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z określoną wiadomością. |
toast(msg, title) | void | W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z określoną wiadomością i tytułem. |
toast(msg, title, timeoutSeconds) | void | W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z podanym tytułem i komunikatem, które pozostają widoczne przez określony czas. |
unhideColumn(column) | void | Odkrywa kolumnę w danym zakresie. |
unhideRow(row) | void | Odkrywa wiersz w podanym zakresie. |
updateMenu(name, subMenus) | void | Aktualizuje menu dodane przez użytkownika addMenu(name, subMenus) . |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Czekam na zakończenie wszystkich bieżących wykonań w arkuszu kalkulacyjnym, a limit czasu wynosi po podanej liczbie sekund. |
Szczegółowa dokumentacja
addDeveloperMetadata(key)
Dodaje do arkusza kalkulacyjnego najwyższego poziomu metadane dewelopera z określonym kluczem.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' in the developer metadata for the spreadsheet. ss.addDeveloperMetadata('NAME') // Gets the first developer metadata object and logs its key. const developerMetaData = ss.getDeveloperMetadata()[0] console.log(developerMetaData.getKey())
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | Klucz nowych metadanych dewelopera. |
Powroty
Spreadsheet
– ten arkusz kalkulacyjny do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
addDeveloperMetadata(key, visibility)
Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem i widocznością.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility // to the developer project that created the metadata. ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the first developer metadata object and logs its key and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, . Visibility: ${developerMetaData.getVisibility()}`);
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | Klucz nowych metadanych dewelopera. |
visibility | DeveloperMetadataVisibility | Widoczność nowych metadanych dewelopera. |
Powroty
Spreadsheet
– ten arkusz kalkulacyjny do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
addDeveloperMetadata(key, value)
Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem i wartością.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the // spreadsheet. ss.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the first developer metadata object and logs its key and value. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | Klucz nowych metadanych dewelopera. |
value | String | Wartość nowych metadanych dewelopera. |
Powroty
Spreadsheet
– ten arkusz kalkulacyjny do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
addDeveloperMetadata(key, value, visibility)
Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem, wartością i widocznością.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to any developer project with document access. ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the first developer metadata object and logs its key, value, and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}, Visibility: ${developerMetaData.getVisibility()}`);
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | Klucz nowych metadanych dewelopera. |
value | String | Wartość nowych metadanych dewelopera. |
visibility | DeveloperMetadataVisibility | Widoczność nowych metadanych dewelopera. |
Powroty
Spreadsheet
– ten arkusz kalkulacyjny do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
addEditor(emailAddress)
Dodaje wskazanego użytkownika do listy edytorów w Spreadsheet
. Jeśli użytkownik był już na liście widzów, ta metoda przesuwa go poza listę widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
addEditor(user)
Dodaje wskazanego użytkownika do listy edytorów w Spreadsheet
. Jeśli użytkownik był już na liście widzów, ta metoda przesuwa go poza listę widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, który ma zostać dodany. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
addEditors(emailAddresses)
Dodaje podaną tablicę użytkowników do listy edytorów elementu Spreadsheet
. Jeśli którykolwiek z użytkowników był już na liście widzów, ta metoda przesuwa go poza listę widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddresses | String[] | Tablica adresów e-mail użytkowników do dodania. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
addMenu(name, subMenus)
Tworzy nowe menu w interfejsie arkusza kalkulacyjnego.
Każda pozycja menu uruchamia funkcję zdefiniowaną przez użytkownika. Zwykle trzeba wywołać je z funkcji onOpen()
, aby menu tworzone było automatycznie po wczytaniu arkusza kalkulacyjnego.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is // executed. menuEntries.push({name: "Menu Entry 1", functionName: "function1"}); menuEntries.push(null); // line separator menuEntries.push({name: "Menu Entry 2", functionName: "function2"}); ss.addMenu("addMenuExample", menuEntries); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa menu do utworzenia. |
subMenus | Object[] | Tablica map JavaScript z parametrami name i functionName
. Możesz używać funkcji z dołączonych bibliotek, takich jak
Library.libFunction1 . |
Upoważnienie
Skrypty korzystające 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
addViewer(emailAddress)
Dodaje danego użytkownika do listy przeglądających stronę Spreadsheet
. Jeśli użytkownik był już na liście edytorów, ta metoda nie ma żadnego efektu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
addViewer(user)
Dodaje danego użytkownika do listy przeglądających stronę Spreadsheet
. Jeśli użytkownik był już na liście edytorów, ta metoda nie ma żadnego efektu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, który ma zostać dodany. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
addViewers(emailAddresses)
Dodaje podaną tablicę użytkowników do listy osób przeglądających element Spreadsheet
. Jeśli którykolwiek z użytkowników był już na liście edytorów, ta metoda nie będzie działać.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddresses | String[] | Tablica adresów e-mail użytkowników do dodania. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
appendRow(rowContents)
Dodaje wiersz na dole bieżącego regionu danych w arkuszu. Jeśli zawartość komórki zaczyna się od ciągu =
, jest ona interpretowana jako formuła.
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"]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowContents | Object[] | Tablica wartości do wstawienia po ostatnim wierszu w arkuszu. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
autoResizeColumn(columnPosition)
Ustawia szerokość danej kolumny, aby pasowała do jej zawartości.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja danej kolumny, której rozmiar ma zostać zmieniony. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
copy(name)
Kopiuje arkusz kalkulacyjny i zwraca nowy.
// This code makes a copy of the current spreadsheet and names it appropriately var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.copy("Copy of " + ss.getName());
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa kopii. |
Powroty
Spreadsheet
– ten arkusz kalkulacyjny do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
createDeveloperMetadataFinder()
Zwraca DeveloperMetadataFinder
do wyszukiwania metadanych dewelopera w zakresie tego arkusza kalkulacyjnego. Domyślnie uwzględniane są wszystkie metadane powiązane z arkuszem kalkulacyjnym, arkuszami, wierszami i kolumnami.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds developer metadata to the spreadsheet. ss.addDeveloperMetadata('NAME', 'CHARLIE'); ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION'); ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT'); // Creates a developer metadata finder. const developerMetadataFinder = ss.createDeveloperMetadataFinder(); // Finds the developer metadata objects with 'COMPANY' as the key. const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find(); // Gets the first result of developer metadata that has the key 'COMPANY' and logs its value. console.log(googleMetadataFromSpreadsheet[0].getValue());
Powroty
DeveloperMetadataFinder
– wyszukiwarka metadanych programisty umożliwiająca wyszukiwanie metadanych w zakresie tego arkusza kalkulacyjnego.
createTextFinder(findText)
Tworzy w arkuszu kalkulacyjnym funkcję wyszukiwania tekstu, która pozwala znajdować i zastępować tekst w arkuszu kalkulacyjnym. Wyszukiwanie rozpoczyna się od pierwszego arkusza arkusza kalkulacyjnego.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Creates a text finder. var textFinder = spreadsheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the spreadsheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parametry
Nazwa | Typ | Opis |
---|---|---|
findText | String | Tekst do wyszukania. |
Powroty
TextFinder
– TextFinder
dla arkusza kalkulacyjnego.
deleteActiveSheet()
Usuwa aktualnie aktywny arkusz.
// The code below deletes the currently active sheet and stores the new active sheet in a // variable var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();
Powroty
Sheet
– nowy aktywny arkusz.
Upoważnienie
Skrypty korzystające 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
deleteColumn(columnPosition)
Usuwa kolumnę znajdującą się w danym miejscu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja kolumny, począwszy od 1 dla pierwszej kolumny. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
deleteColumns(columnPosition, howMany)
Usuwa liczbę kolumn, zaczynając od podanej pozycji kolumny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja pierwszej kolumny do usunięcia. |
howMany | Integer | Liczba kolumn do usunięcia. |
Upoważnienie
Skrypty korzystające 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
deleteRow(rowPosition)
Usuwa wiersz na podanej pozycji.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza, zaczynająca się od 1 w pierwszym wierszu. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
deleteRows(rowPosition, howMany)
Usuwa wiele wierszy, zaczynając od określonej pozycji wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja pierwszego wiersza do usunięcia. |
howMany | Integer | Liczba wierszy do usunięcia. |
Upoważnienie
Skrypty korzystające 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
deleteSheet(sheet)
Usuwa określony arkusz.
// The code below deletes the specified sheet. var ss = SpreadsheetApp.getActive(); var sheet = ss.getSheetByName('My Sheet'); ss.deleteSheet(sheet);
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheet | Sheet | Arkusz do usunięcia. |
Upoważnienie
Skrypty korzystające 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
duplicateActiveSheet()
Powiela aktywny arkusz i zmienia go w aktywny.
// The code below makes a duplicate of the active sheet SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
getActiveCell()
Zwraca aktywną komórkę w tym arkuszu.
Uwaga: zalecamy użycie getCurrentCell()
, który zwraca aktualnie podświetloną komórkę.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Powroty
Range
– bieżąca aktywna komórka,
Upoważnienie
Skrypty korzystające 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 w aktywnym arkuszu lub null
, jeśli nie ma aktywnego zakresu. Jeśli wybierzesz wiele zakresów, ta metoda zwróci tylko ostatnio wybrany zakres.
Termin „aktywny zakres” odnosi się do zakresu wybranego przez użytkownika w aktywnym arkuszu, ale w funkcji niestandardowej odnosi się do komórki, która jest aktywnie przeliczana.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Powroty
Range
– aktywny zakres,
Upoważnienie
Skrypty korzystające 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
Zobacz też
getActiveRangeList()
Zwraca listę aktywnych zakresów w aktywnym arkuszu lub funkcję null
, jeśli nie ma aktywnych zakresów.
Jeśli został wybrany 1 zakres, działa to jak wywołanie getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Powroty
RangeList
– lista aktywnych zakresów.
Upoważnienie
Skrypty korzystające 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
Zobacz też
getActiveSheet()
Pobiera aktywny arkusz z arkusza kalkulacyjnego.
Aktywny arkusz w arkuszu kalkulacyjnym to ten, który jest wyświetlany w interfejsie arkusza kalkulacyjnego.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
Powroty
Sheet
– aktywny arkusz w arkuszu kalkulacyjnym.
getAs(contentType)
Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.
Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf' . W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: 'image/bmp' , 'image/gif' , 'image/jpeg' i 'image/png' . |
Powroty
Blob
– dane w postaci obiektu blob.
getBandings()
Zwraca wszystkie pasma w tym arkuszu kalkulacyjnym.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets an array of the bandings in the spreadsheet. const bandings = ss.getBandings(); // Logs the range of the first banding in the spreadsheet to the console. console.log(bandings[0].getRange().getA1Notation());
Powroty
Banding[]
– pasy w tym arkuszu kalkulacyjnym.
Upoważnienie
Skrypty korzystające 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
getBlob()
getColumnWidth(columnPosition)
Pobiera szerokość danej kolumny w pikselach.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Położenie kolumny do sprawdzenia. |
Powroty
Integer
– szerokość kolumny w pikselach
Upoważnienie
Skrypty korzystające 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ą komórkę w aktywnym arkuszu lub null
, jeśli nie ma bieżącej komórki. Bieżąca komórka to ta, która jest wyróżniona w interfejsie Arkuszy Google i jest wyróżniona ciemną obwódką. Nie ma więcej niż jednej komórki. Gdy użytkownik wybierze co najmniej 1 zakres komórek, jedna z komórek w zaznaczeniu stanie się komórką bieżącą.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Powroty
Range
– bieżąca komórka,
Upoważnienie
Skrypty korzystające 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
getDataRange()
Zwraca wartość Range
odpowiadającą wymiarowi, w którym znajdują się dane.
Jest to funkcjonalnie odpowiednik utworzenia zakresu ograniczonego przez komórki A1 i (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); }
Powroty
Range
– zakres składający się ze wszystkich danych z arkusza kalkulacyjnego;
Upoważnienie
Skrypty korzystające 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
getDataSourceFormulas()
Pobiera wszystkie formuły źródeł danych.
// 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());
Powroty
DataSourceFormula[]
– lista formuł źródeł danych.
Upoważnienie
Skrypty korzystające 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
getDataSourcePivotTables()
Pobiera wszystkie tabele przestawne źródła danych.
// 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());
Powroty
DataSourcePivotTable[]
– lista tabel przestawnych źródeł danych.
Upoważnienie
Skrypty korzystające 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
getDataSourceRefreshSchedules()
Pobiera harmonogramy odświeżania tego arkusza kalkulacyjnego.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates BigQuery operations for the connected spreadsheet. SpreadsheetApp.enableBigQueryExecution(); // Gets the frequency type of the first referesh schedule in the array. const frequencyType = ss.getDataSourceRefreshSchedules()[0] .getFrequency() .getFrequencyType() .toString(); // Logs the frequency type to the console. console.log(frequencyType);
Powroty
DataSourceRefreshSchedule[]
– harmonogramy odświeżania arkusza kalkulacyjnego.
Upoważnienie
Skrypty korzystające 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
getDataSourceSheets()
Zwraca wszystkie arkusze źródeł danych w arkuszu kalkulacyjnym.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the first data source sheet in the spreadsheet. const dataSource = ss.getDataSourceSheets()[0]; // Gets the name of the data source sheet. console.log(dataSource.asSheet().getName());
Powroty
DataSourceSheet[]
– tablica wszystkich arkuszy źródeł danych.
Upoważnienie
Skrypty korzystające 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
getDataSourceTables()
Pobiera wszystkie tabele źródeł danych.
// 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());
Powroty
DataSourceTable[]
– lista tabel źródeł danych.
Upoważnienie
Skrypty korzystające 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
getDataSources()
Zwraca wszystkie źródła danych w arkuszu kalkulacyjnym.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the data sources on the spreadsheet. const dataSources = ss.getDataSources(); // Logs the name of the first column on the first data source. console.log(dataSources[0].getColumns()[0].getName());
Powroty
DataSource[]
– tablica wszystkich źródeł danych.
Upoważnienie
Skrypty korzystające 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
getDeveloperMetadata()
Pobiera metadane dewelopera powiązane z arkuszem kalkulacyjnym najwyższego poziomu.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds 'Google' as a key to the spreadsheet metadata. ss.addDeveloperMetadata('Google'); // Gets the spreadsheet's metadata. const ssMetadata = ss.getDeveloperMetadata(); // Gets the first set of the spreadsheet's metadata and logs the key to the console. console.log(ssMetadata[0].getKey());
Powroty
DeveloperMetadata[]
– metadane dewelopera powiązane z tym zakresem.
Upoważnienie
Skrypty korzystające 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
getEditors()
Pobiera listę edytorów tego elementu (Spreadsheet
).
Powroty
User[]
– tablica użytkowników z uprawnieniami do edycji.
Upoważnienie
Skrypty korzystające 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
getFormUrl()
Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza kalkulacyjnego, lub null
, jeśli arkusz kalkulacyjny nie ma powiązanego formularza. Jeśli wiele formularzy wysyła odpowiedzi do tego arkusza kalkulacyjnego,
zwrócony adres URL formularza jest nieokreślony. Powiązania adresów URL formularzy z arkuszami możesz też pobierać za pomocą metody Sheet.getFormUrl()
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the form URL from the spreadsheet. const formUrl = ss.getFormUrl(); // Logs the form URL to the console. console.log(formUrl);
Powroty
String
– adres URL formularza, w którym znajdują się odpowiedzi w tym arkuszu kalkulacyjnym, lub null
, jeśli arkusz kalkulacyjny nie ma powiązanego formularza.
Upoważnienie
Skrypty korzystające 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
getFrozenColumns()
Zwraca liczbę zablokowanych kolumn.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Powroty
Integer
– liczba zablokowanych kolumn;
Upoważnienie
Skrypty korzystające 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
getFrozenRows()
Zwraca liczbę zablokowanych wierszy.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Powroty
Integer
– liczba zablokowanych wierszy,
Upoważnienie
Skrypty korzystające 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
getId()
Pobiera unikalny identyfikator tego arkusza kalkulacyjnego. Identyfikator arkusza kalkulacyjnego można wyodrębnić z jego adresu URL. Na przykład identyfikator arkusza kalkulacyjnego w adresie URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 to „abc1234567”.
// The code below logs the ID for the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());
Powroty
String
– unikalny identyfikator (lub klucz) arkusza kalkulacyjnego.
getImages()
Zwraca wszystkie obrazy w siatce.
// 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()); }
Powroty
OverGridImage[]
– tablica obrazów nad siatką.
Upoważnienie
Skrypty korzystające 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
getIterativeCalculationConvergenceThreshold()
Zwraca wartość progową używaną podczas obliczeń iteracyjnych. Gdy wyniki kolejnych obliczeń różnią się o mniejszą wartość, obliczenia iteracyjne są zatrzymywane.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
Powroty
Number
– próg zbieżności.
Upoważnienie
Skrypty korzystające 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
getLastColumn()
Zwraca pozycję ostatniej kolumny, która zawiera treść.
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());
Powroty
Integer
– ostatnia kolumna w arkuszu, która zawiera treść.
Upoważnienie
Skrypty korzystające 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
getLastRow()
Zwraca pozycję ostatniego wiersza zawierającego treść.
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());
Powroty
Integer
– ostatni wiersz arkusza zawierający treść,
Upoważnienie
Skrypty korzystające 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
getMaxIterativeCalculationCycles()
Zwraca maksymalną liczbę iteracji do użycia podczas obliczeń iteracyjnych.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
Powroty
Integer
– maksymalna liczba iteracji obliczeń.
Upoważnienie
Skrypty korzystające 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
getName()
Pobiera nazwę dokumentu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getName());
Powroty
String
– nazwa arkusza kalkulacyjnego.
Upoważnienie
Skrypty korzystające 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
getNamedRanges()
Pobiera wszystkie zakresy nazwane z tego arkusza kalkulacyjnego.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { Logger.log(namedRanges[i].getName()); }
Powroty
NamedRange[]
– tablica wszystkich nazwanych zakresów w arkuszu kalkulacyjnym.
Upoważnienie
Skrypty korzystające 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
getNumSheets()
Zwraca liczbę arkuszy w tym arkuszu kalkulacyjnym.
// The code below logs the number of sheets in the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());
Powroty
Integer
– liczba arkuszy w arkuszu kalkulacyjnym.
getOwner()
Zwraca właściciela dokumentu lub null
w przypadku dokumentu na dysku współdzielonym.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var owner = ss.getOwner(); Logger.log(owner.getEmail());
Powroty
User
– właściciel dokumentu lub null
, jeśli dokument znajduje się na dysku współdzielonym.
Upoważnienie
Skrypty korzystające 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
getPredefinedSpreadsheetThemes()
Zwraca listę wstępnie zdefiniowanych motywów.
// The code below returns the list of predefined themes. var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet() .getPredefinedSpreadsheetThemes();
Powroty
SpreadsheetTheme[]
– lista wstępnie zdefiniowanych motywów.
Upoważnienie
Skrypty korzystające 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
getProtections(type)
Pobiera tablicę obiektów reprezentujących wszystkie chronione zakresy lub arkusze w arkuszu kalkulacyjnym.
// Remove all range protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove all sheet protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
Parametry
Nazwa | Typ | Opis |
---|---|---|
type | ProtectionType | Typ obszaru chronionego: SpreadsheetApp.ProtectionType.RANGE lub SpreadsheetApp.ProtectionType.SHEET . |
Powroty
Protection[]
– tablica obiektów reprezentująca wszystkie chronione zakresy lub arkusze w arkuszu kalkulacyjnym.
Upoważnienie
Skrypty korzystające 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
getRange(a1Notation)
Zwraca zakres określony w notacji A1 lub w notacji 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");
Parametry
Nazwa | Typ | Opis |
---|---|---|
a1Notation | String | Zakres do zwrócenia, określony w notacji A1 lub w notacji R1C1. |
Powroty
Range
– zakres w lokalizacji określonej
Upoważnienie
Skrypty korzystające 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
getRangeByName(name)
Zwraca zakres nazwany lub null
, jeśli nie znaleziono zakresu o podanej nazwie. Jeśli wiele arkuszy arkusza kalkulacyjnego ma tę samą nazwę zakresu, podaj nazwę bez dodatkowych cudzysłowów, na przykład getRangeByName('TaxRates')
lub getRangeByName('Sheet Name!TaxRates')
, ale nie getRangeByName('"Sheet
Name"!TaxRates')
.
// Log the number of columns for the range named 'TaxRates' in the active spreadsheet. var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates'); if (range != null) { Logger.log(range.getNumColumns()); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa zakresu do uzyskania. |
Powroty
Range
– zakres komórek o podanej nazwie.
getRangeList(a1Notations)
Zwraca kolekcję RangeList
reprezentującą zakresy w tym samym arkuszu określoną za pomocą niepustej listy notacji A1 lub notacji R1C1.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
Parametry
Nazwa | Typ | Opis |
---|---|---|
a1Notations | String[] | Lista zakresów do zwrócenia, zgodnie z notacją A1 lub notacją R1C1. |
Powroty
RangeList
– lista zakresów w lokalizacji wskazanej
Upoważnienie
Skrypty korzystające 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
getRecalculationInterval()
Zwraca interwał obliczeniowy dla tego arkusza kalkulacyjnego.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Logs the calculation interval for the spreadsheet to the console. console.log(ss.getRecalculationInterval().toString());
Powroty
RecalculationInterval
– interwał obliczeniowy dla danego arkusza kalkulacyjnego.
Upoważnienie
Skrypty korzystające 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
getRowHeight(rowPosition)
Pobiera wysokość danego wiersza w pikselach.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza do sprawdzenia. |
Powroty
Integer
– wysokość wiersza w pikselach
Upoważnienie
Skrypty korzystające 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
z arkusza kalkulacyjnego.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Powroty
Selection
– bieżący wybór;
Upoważnienie
Skrypty korzystające 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
getSheetByName(name)
Zwraca arkusz o podanej nazwie.
Jeśli kilka arkuszy ma taką samą nazwę, zwracany jest ten pierwszy. Zwraca wartość null
, jeśli nie ma arkusza o podanej nazwie.
// The code below logs the index of a sheet named "Expenses" var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses"); if (sheet != null) { Logger.log(sheet.getIndex()); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa arkusza do pobrania. |
Powroty
Sheet
– arkusz o danej nazwie.
getSheetId()
Zwraca identyfikator arkusza reprezentowanego przez ten obiekt.
Jest to identyfikator arkusza, który jest unikalny dla tego arkusza kalkulacyjnego. Identyfikator to rosnąca monotonicznie liczba całkowita przypisywana w momencie tworzenia arkusza, niezależna od jego pozycji. Jest to przydatne w połączeniu z metodami takimi jak Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
, które przyjmują parametr gridId
, a nie instancję Sheet
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Powroty
Integer
– unikalny identyfikator arkusza kalkulacyjnego dla danego arkusza kalkulacyjnego;
Upoważnienie
Skrypty korzystające 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
getSheetName()
Zwraca nazwę arkusza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Powroty
String
– nazwa arkusza,
Upoważnienie
Skrypty korzystające 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
getSheetValues(startRow, startColumn, numRows, numColumns)
Zwraca prostokątną siatkę wartości dla tego zakresu, zaczynając od podanych współrzędnych. Wartość -1 podana jako pozycja wiersza lub kolumny odpowiada uzyskaniu ostatniego wiersza lub kolumny, które zawierają dane w arkuszu.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startRow | Integer | Pozycja wiersza początkowego. |
startColumn | Integer | Pozycja kolumny początkowej. |
numRows | Integer | Liczba wierszy, dla których mają zostać zwrócone wartości. |
numColumns | Integer | Liczba kolumn, dla których mają zostać zwrócone wartości. |
Powroty
Object[][]
– dwuwymiarowa tablica wartości.
Upoważnienie
Skrypty korzystające 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
getSheets()
Pobiera wszystkie arkusze z tego arkusza kalkulacyjnego.
// The code below logs the name of the second sheet var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets(); if (sheets.length > 1) { Logger.log(sheets[1].getName()); }
Powroty
Sheet[]
– tablica wszystkich arkuszy w arkuszu kalkulacyjnym.
getSpreadsheetLocale()
Pobiera ustawienia regionalne arkusza kalkulacyjnego.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
Powroty
String
– język arkusza kalkulacyjnego.
Upoważnienie
Skrypty korzystające 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
getSpreadsheetTheme()
Zwraca bieżący motyw arkusza kalkulacyjnego lub wartość null
, jeśli nie zastosowano żadnego motywu.
// The code below returns the current theme of the spreadsheet. var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();
Powroty
SpreadsheetTheme
– aktualnie stosowany motyw.
Upoważnienie
Skrypty korzystające 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
getSpreadsheetTimeZone()
Pobiera strefę czasową arkusza kalkulacyjnego.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
Powroty
String
– strefa czasowa podana w formacie „long” (np. „Ameryka/Nowy_Jork” według nazwy Joda.org).
Upoważnienie
Skrypty korzystające 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
getUrl()
Zwraca adres URL danego arkusza kalkulacyjnego.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getUrl());
Powroty
String
– adres URL danego arkusza kalkulacyjnego.
Upoważnienie
Skrypty korzystające 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
getViewers()
Pobiera listę przeglądających i komentujących tego elementu (Spreadsheet
).
Powroty
User[]
– tablica użytkowników z uprawnieniami do wyświetlania lub komentowania.
Upoważnienie
Skrypty korzystające 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
hideColumn(column)
Ukrywa kolumnę lub kolumny w danym zakresie.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
column | Range | Zakres kolumn do ukrycia. |
Upoważnienie
Skrypty korzystające 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
hideRow(row)
Ukrywa wiersze w danym zakresie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
Parametry
Nazwa | Typ | Opis |
---|---|---|
row | Range | Zakres wierszy do ukrycia. |
Upoważnienie
Skrypty korzystające 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
insertColumnAfter(afterPosition)
Wstawia kolumnę po podanej pozycji kolumny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
afterPosition | Integer | Kolumna, po której należy dodać nową kolumnę. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
insertColumnBefore(beforePosition)
Wstawia kolumnę przed podaną pozycją kolumny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Kolumna, do której należy dodać nową kolumnę. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
insertColumnsAfter(afterPosition, howMany)
Wstawia podaną liczbę kolumn po podanej pozycji kolumny.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
afterPosition | Integer | Kolumna, po której należy dodać nową kolumnę. |
howMany | Integer | Liczba kolumn do wstawienia. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
insertColumnsBefore(beforePosition, howMany)
Wstawia pewną liczbę kolumn przed podaną pozycją kolumny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Kolumna, do której należy dodać nową kolumnę. |
howMany | Integer | Liczba kolumn do wstawienia. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
insertDataSourceSheet(spec)
Wstawia nowy element DataSourceSheet
w arkuszu kalkulacyjnym i rozpoczyna wykonywanie danych. Efektem ubocznym jest też to, że nowy arkusz jest aktywny.
Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie danych w przypadku określonego typu źródła danych.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Builds a data source specification. // TODO (developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setTableProjectId('bigquery-public-data') .setDatasetId('ncaa_basketball') .setTableId('mbb_historical_teams_games') .build(); // Adds the data source and its data to the spreadsheet. ss.insertDataSourceSheet(dataSourceSpec);
Parametry
Nazwa | Typ | Opis |
---|---|---|
spec | DataSourceSpec | Specyfikacja źródła danych, z którym należy wstawić dane. |
Powroty
DataSourceSheet
– nowy arkusz źródła danych.
Upoważnienie
Skrypty korzystające 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
insertImage(blobSource, column, row)
Wstawia Spreadsheet
jako obraz w dokumencie w danym wierszu i kolumnie. Rozmiar obrazu jest pobierany z zawartości obiektu blob. Maksymalny obsługiwany rozmiar bloba to 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Obiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę. |
column | Integer | Pozycja kolumny. |
row | Integer | Pozycja wiersza. |
Powroty
OverGridImage
– wstawiony obraz.
Upoważnienie
Skrypty korzystające 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
insertImage(blobSource, column, row, offsetX, offsetY)
Wstawia Spreadsheet
jako obraz w dokumencie w określonym wierszu i kolumnie z przesunięciem piksela. Rozmiar obrazu jest pobierany z zawartości obiektu blob. Maksymalny obsługiwany rozmiar bloba to 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Obiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę. |
column | Integer | Pozycja kolumny. |
row | Integer | Pozycja wiersza. |
offsetX | Integer | Odsunięcie w poziomie od narożnika komórki w pikselach. |
offsetY | Integer | Odsunięcie w pionie od narożnika komórki w pikselach. |
Powroty
OverGridImage
– wstawiony obraz.
Upoważnienie
Skrypty korzystające 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
insertImage(url, column, row)
Wstawia obraz w dokumencie w danym wierszu i kolumnie.
Podany adres URL musi być publicznie dostępny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL obrazu. |
column | Integer | Pozycja kolumny siatki. |
row | Integer | Pozycja wiersza siatki. |
Powroty
OverGridImage
– wstawiony obraz.
Upoważnienie
Skrypty korzystające 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
insertImage(url, column, row, offsetX, offsetY)
Wstawia obraz w dokumencie w danym wierszu i kolumnie z odsunięciem piksela.
Podany adres URL musi być publicznie dostępny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL obrazu. |
column | Integer | Pozycja kolumny. |
row | Integer | Pozycja wiersza. |
offsetX | Integer | Odsunięcie w poziomie od narożnika komórki w pikselach. |
offsetY | Integer | Odsunięcie w pionie od narożnika komórki w pikselach. |
Powroty
OverGridImage
– wstawiony obraz.
Upoważnienie
Skrypty korzystające 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
insertRowAfter(afterPosition)
Wstawia wiersz po podanej pozycji wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
afterPosition | Integer | Wiersz, po którym należy dodać nowy wiersz. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
insertRowBefore(beforePosition)
Wstawia wiersz przed podaną pozycją wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Wiersz, przed którym należy dodać nowy wiersz. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
insertRowsAfter(afterPosition, howMany)
Wstawia liczbę wierszy po podanej pozycji wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
afterPosition | Integer | Wiersz, po którym mają zostać dodane nowe wiersze. |
howMany | Integer | Liczba wierszy do wstawienia. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
insertRowsBefore(beforePosition, howMany)
Wstawia pewną liczbę wierszy przed podaną pozycją wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Wiersz, do którego należy dodać nowe wiersze. |
howMany | Integer | Liczba wierszy do wstawienia. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
insertSheet()
Wstawia do arkusza kalkulacyjnego nowy arkusz z domyślną nazwą arkusza. Nowy arkusz stanie się aktywnym.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet();
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
insertSheet(sheetIndex)
Wstawia nowy arkusz do arkusza kalkulacyjnego w danym indeksie. Nowy arkusz stanie się aktywny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheetIndex | Integer | Indeks nowo utworzonego arkusza. Aby wstawić arkusz jako pierwszy w arkuszu, ustaw jego wartość na 0. |
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
insertSheet(sheetIndex, options)
Wstawia nowy arkusz w arkuszu kalkulacyjnym w danym indeksie i używa opcjonalnych argumentów zaawansowanych. Nowy arkusz stanie się aktywnym arkuszem.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet(1, {template: templateSheet});
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheetIndex | Integer | Indeks nowo utworzonego arkusza. Aby wstawić arkusz jako pierwszy w arkuszu, ustaw jego wartość na 0. |
options | Object | Opcjonalne argumenty zaawansowane JavaScript. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
template | Sheet | Wszystkie dane z obiektu arkusza szablonu zostaną skopiowane do nowego arkusza. Szablon arkusza musi być jednym z arkuszy obiektu Arkusz kalkulacyjny. |
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
insertSheet(options)
Wstawia do arkusza kalkulacyjnego nowy arkusz z użyciem domyślnej nazwy arkusza i opcjonalnych argumentów zaawansowanych. Nowy arkusz stanie się aktywnym arkuszem.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet({template: templateSheet});
Parametry
Nazwa | Typ | Opis |
---|---|---|
options | Object | Opcjonalne argumenty zaawansowane JavaScript wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
template | Sheet | Wszystkie dane z obiektu arkusza szablonu zostaną skopiowane do nowego arkusza. Szablon arkusza musi być jednym z arkuszy tego obiektu arkusza kalkulacyjnego. |
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
insertSheet(sheetName)
Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie. Nowy arkusz stanie się aktywny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet');
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheetName | String | Nazwa nowego arkusza. |
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
insertSheet(sheetName, sheetIndex)
Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie w danym indeksie. Nowy arkusz staje się aktywnym arkuszem.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet', 1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheetName | String | Nazwa nowego arkusza. |
sheetIndex | Integer | Indeks nowo utworzonego arkusza. Aby wstawić arkusz jako pierwszy w arkuszu, ustaw jego wartość na 0. |
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
insertSheet(sheetName, sheetIndex, options)
Wstawia do arkusza kalkulacyjnego nowy arkusz z podaną nazwą w danym indeksie i używa opcjonalnych argumentów zaawansowanych. Nowy arkusz stanie się aktywnym arkuszem.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', 1, {template: templateSheet});
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheetName | String | Nazwa nowego arkusza. |
sheetIndex | Integer | Indeks nowo wstawionego arkusza. Aby wstawić arkusz jako pierwszy w arkuszu kalkulacyjnym, ustaw jego wartość na 0. |
options | Object | Opcjonalne argumenty zaawansowane JavaScript. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
template | Sheet | Wszystkie dane z obiektu arkusza szablonu zostaną skopiowane do nowego arkusza. Szablon arkusza musi być jednym z arkuszy obiektu Arkusz kalkulacyjny. |
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
insertSheet(sheetName, options)
Wstawia do arkusza kalkulacyjnego nowy arkusz z podaną nazwą i używa opcjonalnych argumentów zaawansowanych. Nowy arkusz stanie się aktywnym arkuszem.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', {template: templateSheet});
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheetName | String | Nazwa nowego arkusza. |
options | Object | Opcjonalne argumenty zaawansowane JavaScript. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
template | Sheet | Wszystkie dane z obiektu arkusza szablonu zostaną skopiowane do nowego arkusza. Szablon arkusza musi być jednym z arkuszy obiektu Arkusz kalkulacyjny. |
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
insertSheetWithDataSourceTable(spec)
Wstawia w arkuszu kalkulacyjnym nowy arkusz, tworzy element DataSourceTable
rozciągający cały arkusz zgodnie ze specyfikacją źródła danych i rozpoczyna wykonywanie kodu. Efektem ubocznym jest ustawienie nowego arkusza w aktywny.
Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie danych w przypadku określonego typu źródła danych.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds a sheet and sets cell A1 as the parameter cell. const parameterCell = ss.insertSheet('parameterSheet').getRange('A1'); // Sets the value of the parameter cell to 'Duke'. parameterCell.setValue('Duke'); const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' + '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL'; // Adds a data source with a query parameter. // TODO(developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setRawQuery(query) .setParameterFromCell('SCHOOL', 'parameterSheet!A1') .build(); // Adds sheets for the data source and data source table to the spreadsheet. ss.insertSheetWithDataSourceTable(dataSourceSpec);
Parametry
Nazwa | Typ | Opis |
---|---|---|
spec | DataSourceSpec | Specyfikacja źródła danych, z którym należy wstawić dane. |
Powroty
Sheet
– nowy arkusz.
Upoważnienie
Skrypty korzystające 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
isColumnHiddenByUser(columnPosition)
Zwraca, czy dana kolumna jest ukryta przez użytkownika.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Położenie kolumny do sprawdzenia. |
Powroty
Boolean
– true
, jeśli kolumna jest ukryta. W przeciwnym razie: false
.
Upoważnienie
Skrypty korzystające 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
isIterativeCalculationEnabled()
Wskazuje, czy w tym arkuszu kalkulacyjnym są włączone obliczenia iteracyjne.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
Powroty
Boolean
– true
, jeśli włączono obliczenia iteracyjne, lub false
w przeciwnym razie.
Upoważnienie
Skrypty korzystające 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
isRowHiddenByFilter(rowPosition)
Zwraca, czy dany wiersz został ukryty przez filtr (a nie przez widok filtra).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza do sprawdzenia. |
Powroty
Boolean
– true
, jeśli wiersz jest ukryty. W przeciwnym razie false
.
Upoważnienie
Skrypty korzystające 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
isRowHiddenByUser(rowPosition)
Zwraca, czy dany wiersz jest ukryty przez użytkownika.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza do sprawdzenia. |
Powroty
Boolean
– true
, jeśli wiersz jest ukryty. W przeciwnym razie false
.
Upoważnienie
Skrypty korzystające 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
moveActiveSheet(pos)
Przenosi aktywny arkusz na określoną pozycję na liście arkuszy. Zwraca wyjątek, jeśli pozycja jest ujemna lub większa niż liczba arkuszy.
// This example assumes that there are 2 sheets in the current // active spreadsheet: one named "first" in position 1 and another named "second" // in position 2. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Gets the "first" sheet and activates it. var sheet = spreadsheet.getSheetByName("first").activate(); // Logs 'Current index of sheet: 1' console.log("Current index of sheet: %s", sheet.getIndex()); spreadsheet.moveActiveSheet(2); // Logs 'New index of sheet: 2' console.log("New index of sheet: %s", sheet.getIndex());
Parametry
Nazwa | Typ | Opis |
---|---|---|
pos | Integer | Pozycja 1 indeksu, na którą ma zostać przeniesiony aktywny arkusz na liście arkuszy. |
Upoważnienie
Skrypty korzystające 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
moveChartToObjectSheet(chart)
Tworzy nowy arkusz SheetType.OBJECT
i przenosi do niego udostępniony wykres. Jeśli wykres znajduje się już w osobnym arkuszu, zostanie on zwrócony bez utworzenia nowego.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.newChart().setPosition(1, 1, 0, 0).build(); sheet.insertChart(chart); var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);
Parametry
Nazwa | Typ | Opis |
---|---|---|
chart | EmbeddedChart | Wykres do przeniesienia. |
Powroty
Sheet
– arkusz, na którym znajduje się wykres.
Upoważnienie
Skrypty korzystające 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
refreshAllDataSources()
Odświeża wszystkie obsługiwane źródła danych i powiązane z nimi obiekty źródeł danych, pomijając nieprawidłowe obiekty źródeł danych.
Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie danych w przypadku określonego typu źródła danych.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the first data source sheet on the spreadsheet. const dataSheet = ss.getDataSourceSheets()[0]; // Refreshes all data sources on the spreadsheet. ss.refreshAllDataSources(); // Logs the last refreshed time of the first data source sheet. console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);
Upoważnienie
Skrypty korzystające 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
removeEditor(emailAddress)
Usuwa danego użytkownika z listy edytorów Spreadsheet
. Ta metoda nie blokuje użytkownikom dostępu do Spreadsheet
, jeśli należą do klasy użytkowników z dostępem ogólnym – na przykład gdy zasób Spreadsheet
jest udostępniany całej domenie użytkownika lub gdy Spreadsheet
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy osób przeglądających.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
removeEditor(user)
Usuwa danego użytkownika z listy edytorów Spreadsheet
. Ta metoda nie blokuje użytkownikom dostępu do Spreadsheet
, jeśli należą do klasy użytkowników z dostępem ogólnym – na przykład gdy zasób Spreadsheet
jest udostępniany całej domenie użytkownika lub gdy Spreadsheet
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy osób przeglądających.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, który ma zostać usunięty. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
removeMenu(name)
Usuwa menu dodane przez użytkownika addMenu(name, subMenus)
. Argument name
powinien mieć tę samą wartość co odpowiadające mu wywołanie addMenu(name, subMenus)
.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"}, {name: "foo", functionName: "foo"}]); } function removeBadMenu() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.removeMenu("badMenu"); // name must match the name used when added the menu } function foo(){ // Do nothing }
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa menu do usunięcia. |
Upoważnienie
Skrypty korzystające 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
removeNamedRange(name)
Usuwa zakres nazwany o podanej nazwie. Zwraca wyjątek, jeśli w arkuszu kalkulacyjnym nie ma zakresu o danej nazwie.
// The code below creates a new named range "foo", and then remove it. var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("foo", ss.getActiveRange()); ss.removeNamedRange("foo");
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa zakresu. |
Upoważnienie
Skrypty korzystające 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
removeViewer(emailAddress)
Usuwa danego użytkownika z listy przeglądających i komentujących elementu Spreadsheet
. Ta metoda nie działa, jeśli użytkownik jest edytującym, a nie przeglądającym lub komentującym. Ta metoda nie blokuje też użytkownikom dostępu do zasobu Spreadsheet
, jeśli należą do klasy użytkowników z ogólnymi uprawnieniami dostępu – na przykład gdy Spreadsheet
jest udostępniony całej domenie użytkownika lub gdy Spreadsheet
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy edytorów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
removeViewer(user)
Usuwa danego użytkownika z listy przeglądających i komentujących elementu Spreadsheet
. Ta metoda nie działa, jeśli użytkownik jest edytorem, a nie przeglądającym. Ta metoda nie blokuje też użytkownikom dostępu do Spreadsheet
, jeśli należą do klasy użytkowników z ogólnymi uprawnieniami dostępu – na przykład gdy Spreadsheet
jest udostępniony całej domenie użytkownika lub Spreadsheet
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy edytorów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, który ma zostać usunięty. |
Powroty
Spreadsheet
– ten element typu Spreadsheet
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
rename(newName)
Zmienia nazwę dokumentu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.rename("This is the new name");
Parametry
Nazwa | Typ | Opis |
---|---|---|
newName | String | Nowa nazwa dokumentu. |
Upoważnienie
Skrypty korzystające 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
renameActiveSheet(newName)
Zmienia nazwę aktualnie aktywnego arkusza na nową nazwę.
// The code below renames the active sheet to "Hello world" SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");
Parametry
Nazwa | Typ | Opis |
---|---|---|
newName | String | Nowa nazwa aktualnie aktywnego arkusza. |
Upoważnienie
Skrypty korzystające 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
resetSpreadsheetTheme()
Usuwa zastosowany motyw i ustawia motyw domyślny w arkuszu kalkulacyjnym.
// The code below applies default theme on the spreadsheet. SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();
Powroty
SpreadsheetTheme
– motyw domyślny.
Upoważnienie
Skrypty korzystające 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
setActiveRange(range)
Ustawia określony zakres jako active range
w aktywnym arkuszu, a lewa górna komórka w zakresie to 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();
Parametry
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres do ustawienia jako aktywny zakres. |
Powroty
Range
– nowo aktywny zakres
Upoważnienie
Skrypty korzystające 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
setActiveRangeList(rangeList)
Ustawia określoną listę zakresów jako active ranges
w aktywnym arkuszu. Ostatni zakres na liście to 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();
Parametry
Nazwa | Typ | Opis |
---|---|---|
rangeList | RangeList | Lista zakresów do wyboru. |
Powroty
RangeList
– nowo wybrana lista zakresów,
Upoważnienie
Skrypty korzystające 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
setActiveSelection(range)
Określa aktywny region zaznaczenia w tym arkuszu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Parametry
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres do ustawienia jako aktywny. |
Powroty
Range
– nowo aktywny zakres
Upoważnienie
Skrypty korzystające 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
setActiveSelection(a1Notation)
Ustawia aktywne zaznaczenie zgodnie z zapisem A1 lub notacją R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Parametry
Nazwa | Typ | Opis |
---|---|---|
a1Notation | String | Zakres do ustawienia jako aktywny, zgodnie z zapisem A1 lub notacją R1C1. |
Powroty
Range
– nowo aktywny zakres
Upoważnienie
Skrypty korzystające 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 dany arkusz jako aktywny w arkuszu kalkulacyjnym. W interfejsie Arkuszy Google zostanie wyświetlony wybrany arkusz, chyba że nie należy on do innego arkusza kalkulacyjnego.
// The code below makes the first sheet active in the active spreadsheet. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheet | Sheet | Arkusz, który ma być ustawiony jako aktywny. |
Powroty
Sheet
– aktywny arkusz.
Upoważnienie
Skrypty korzystające 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, restoreSelection)
Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym, ale z możliwością przywrócenia ostatniego zaznaczenia w tym arkuszu. W interfejsie Arkuszy Google zostanie wyświetlony wybrany arkusz, chyba że nie należy on do innego arkusza kalkulacyjnego.
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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheet | Sheet | Nowy aktywny arkusz. |
restoreSelection | Boolean | Do true ostatni zaznaczony nowy aktywny arkusz zostanie ponownie wybrany, gdy nowy arkusz stanie się aktywny. Jeśli wybierzesz false , stanie się on aktywny bez zmiany bieżącego wyboru. |
Powroty
Sheet
– nowy aktywny arkusz.
Upoważnienie
Skrypty korzystające 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
setColumnWidth(columnPosition, width)
Ustawia szerokość danej kolumny w pikselach.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja kolumny do ustawienia. |
width | Integer | Szerokość ustawiona w pikselach. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
setCurrentCell(cell)
Ustawia określoną komórkę jako current cell
.
Jeśli wskazana komórka znajduje się w już wybranym zakresie, ten zakres stanie się aktywnym zakresem z komórką bieżącą.
Jeśli określona komórka nie znajduje się w żadnym zaznaczonym zakresie, wszystkie dotychczasowe zaznaczenie zostaną usunięte, a komórka stanie się komórką bieżącą i aktywnym zakresem.
Uwaga: podany Range
musi składać się z jednej komórki w przeciwnym razie spowoduje zgłoszenie wyjątku.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parametry
Nazwa | Typ | Opis |
---|---|---|
cell | Range | Komórka, która ma zostać ustawiona jako bieżąca komórka. |
Powroty
Range
– nowo ustawiona bieżąca komórka,
Upoważnienie
Skrypty korzystające 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
setFrozenColumns(columns)
Blokuje podaną liczbę kolumn. Jeśli wartość wynosi zero, żadne kolumny nie są zablokowane.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columns | Integer | Liczba kolumn do zablokowania. |
Upoważnienie
Skrypty korzystające 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
setFrozenRows(rows)
Blokuje podaną liczbę wierszy. Jeśli wartość wynosi zero, żaden wiersz nie jest zablokowany.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rows | Integer | Liczba wierszy do zablokowania. |
Upoważnienie
Skrypty korzystające 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
setIterativeCalculationConvergenceThreshold(minThreshold)
Ustawia minimalną wartość progową dla obliczeń iteracyjnych. Gdy wyniki kolejnych obliczeń różnią się o mniejszą wartość, obliczenia iteracyjne są zatrzymywane. Ta wartość nie może być ujemna i musi wynosić 0, 05.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
Parametry
Nazwa | Typ | Opis |
---|---|---|
minThreshold | Number | Minimalny próg zbieżności (musi być nieujemny). |
Powroty
Spreadsheet
– ten arkusz kalkulacyjny do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
setIterativeCalculationEnabled(isEnabled)
Określa, czy w tym arkuszu kalkulacyjnym mają być aktywowane obliczenia iteracyjne. Jeśli maksymalna liczba cykli obliczeń i próg zbieżności nie została wcześniej ustawiona przy aktywacji obliczeń, domyślnie mają wartość odpowiednio 50 i 0,05. Jeśli któreś z tych ustawień zostało już ustawione, zachowują one swoje poprzednie wartości.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
Parametry
Nazwa | Typ | Opis |
---|---|---|
isEnabled | Boolean | true , jeśli powinno być włączone obliczenia iteracyjne; w przeciwnym razie false . |
Powroty
Spreadsheet
– ten arkusz kalkulacyjny do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
setMaxIterativeCalculationCycles(maxIterations)
Określa maksymalną liczbę iteracji obliczeń, które należy wykonać podczas obliczeń iteracyjnych. Ta wartość musi mieścić się w przedziale od 1 do 10 000 (włącznie), a domyślnie przyjmuje wartość 50.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
Parametry
Nazwa | Typ | Opis |
---|---|---|
maxIterations | Integer | Maksymalna liczba iteracji obliczeń (od 1 do 10 000). |
Powroty
Spreadsheet
– ten arkusz kalkulacyjny do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
setNamedRange(name, range)
Określa zakres.
// The code below creates a new named range "TaxRates" in the active spreadsheet var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa zakresu. |
range | Range | Specyfikacja zakresu. |
Upoważnienie
Skrypty korzystające 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
setRecalculationInterval(recalculationInterval)
Określa częstotliwość ponownego obliczania danych w arkuszu kalkulacyjnym.
// 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'); // Sets the calculation interval for the spreadsheet to 'ON_CHANGE'. const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE); // Logs the calculation interval to the console. console.log(interval);
Parametry
Nazwa | Typ | Opis |
---|---|---|
recalculationInterval | RecalculationInterval | Nowy interwał przeliczenia. |
Powroty
Spreadsheet
– ten arkusz kalkulacyjny do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające 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
setRowHeight(rowPosition, height)
Ustawia wysokość wiersza danego wiersza w pikselach. Domyślnie wiersze powiększają się, aby dopasować się do zawartości komórki. Jeśli chcesz wymusić, by wiersze miały określoną wysokość, użyj Sheet.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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza do zmiany. |
height | Integer | Wysokość, na jaką ma być ustawiona wartość w pikselach. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
setSpreadsheetLocale(locale)
Określa ustawienia regionalne arkusza kalkulacyjnego.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the spreadsheet locale. ss.setSpreadsheetLocale('fr'); // Gets the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
Parametry
Nazwa | Typ | Opis |
---|---|---|
locale | String | Kod języka, którego należy użyć (np. „pl”, „pl” lub „pl_PL”). |
Upoważnienie
Skrypty korzystające 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
setSpreadsheetTheme(theme)
Ustawia motyw w arkuszu kalkulacyjnym.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // The code below sets the second predefined theme as the current theme of the spreadsheet. var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes(); spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
theme | SpreadsheetTheme | motyw, który ma zostać zastosowany; |
Powroty
SpreadsheetTheme
– nowy bieżący motyw.
Upoważnienie
Skrypty korzystające 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
setSpreadsheetTimeZone(timezone)
Określa strefę czasową arkusza kalkulacyjnego.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
Parametry
Nazwa | Typ | Opis |
---|---|---|
timezone | String | Strefa czasowa podana w formacie „long” (np. „Ameryka/Nowy_Jork” podana przez Joda.org). |
Upoważnienie
Skrypty korzystające 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
show(userInterface)
Wyświetla niestandardowy komponent interfejsu w oknie pośrodku widocznego obszaru przeglądarki użytkownika. Wykonanie skryptu po stronie serwera nie jest zawieszone. Aby komunikować się ze stroną serwera, komponent interfejsu użytkownika musi wykonywać asynchroniczne wywołania zwrotne do skryptu po stronie serwera.
Jeśli skrypt po stronie serwera wyświetlał wcześniej okno, które nie zostało jeszcze zamknięte, zostanie ono zastąpione interfejsem nowo żądanego okna.
Ten fragment kodu wyświetla prostą aplikację HtmlService
w oknie z określonym tytułem, wysokością i szerokością:
var htmlApp = HtmlService .createHtmlOutput('<p>A change of speed, a change of style...</p>') .setTitle('My HtmlService Application') .setWidth(250) .setHeight(300); SpreadsheetApp.getActiveSpreadsheet().show(htmlApp); // The script resumes execution immediately after showing the dialog.
Parametry
Nazwa | Typ | Opis |
---|---|---|
userInterface | Object | HtmlOutput . |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/script.container.ui
sort(columnPosition)
Sortuje arkusz według kolumny rosnąco.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Kolumna, według której mają być sortowane dane. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
sort(columnPosition, ascending)
Sortuje arkusz według kolumny. Przyjmuje parametr rosnący lub malejący.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Kolumna, według której mają być sortowane dane. |
ascending | Boolean | true – sortowanie rosnąco, false – malejąco. |
Powroty
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Upoważnienie
Skrypty korzystające 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
toast(msg)
W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z określoną wiadomością.
// Show a popup with the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started');
Parametry
Nazwa | Typ | Opis |
---|---|---|
msg | String | Wiadomość, która zostanie wyświetlona w toście. |
Upoważnienie
Skrypty korzystające 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
toast(msg, title)
W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z określoną wiadomością i tytułem.
// Show a popup with the title "Status" and the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');
Parametry
Nazwa | Typ | Opis |
---|---|---|
msg | String | Wiadomość, która zostanie wyświetlona w toście. |
title | String | Opcjonalny tytuł tosta. |
Upoważnienie
Skrypty korzystające 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
toast(msg, title, timeoutSeconds)
W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z podanym tytułem i komunikatem, które pozostają widoczne przez określony czas.
// Show a 3-second popup with the title "Status" and the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);
Parametry
Nazwa | Typ | Opis |
---|---|---|
msg | String | Wiadomość, która zostanie wyświetlona w toście. |
title | String | Opcjonalny tytuł tosta. |
timeoutSeconds | Number | Limit czasu wyrażony w sekundach. Jeśli ustawiona jest wartość null , tost domyślnie przyjmuje wartość 5 sekund. Jeśli jest ujemna, toster pozostaje widoczny do momentu odrzucenia. |
Upoważnienie
Skrypty korzystające 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
unhideColumn(column)
Odkrywa kolumnę w danym zakresie.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
column | Range | Zakres do odkrycia, jeśli jest ukryty. |
Upoważnienie
Skrypty korzystające 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
unhideRow(row)
Odkrywa wiersz w podanym zakresie.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
row | Range | Zakres do odkrycia, jeśli jest ukryty. |
Upoważnienie
Skrypty korzystające 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
updateMenu(name, subMenus)
Aktualizuje menu dodane przez użytkownika addMenu(name, subMenus)
. Działa dokładnie tak samo jak addMenu(name, subMenus)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; menuEntries.push({name: "Lone Menu Entry", functionName: "function1"}); ss.updateMenu("addMenuExample", menuEntries);
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa menu do aktualizacji. |
subMenus | Object[] | Tablica map JavaScript z parametrami name i functionName
. Możesz używać funkcji z dołączonych bibliotek, takich jak
Library.libFunction1 . |
Upoważnienie
Skrypty korzystające 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
waitForAllDataExecutionsCompletion(timeoutInSeconds)
Czekam na zakończenie wszystkich bieżących wykonań w arkuszu kalkulacyjnym, a limit czasu wynosi po podanej liczbie sekund. Zgłasza wyjątek, jeśli uruchomienia nie zostały ukończone po przekroczeniu limitu czasu, ale nie anuluje wykonywania danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
timeoutInSeconds | Integer | Czas oczekiwania na uruchomienia danych (w sekundach). Maksymalna długość to 300 sekund. |
Upoważnienie
Skrypty korzystające 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