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

Class Spreadsheet

Uzyskiwać dostęp do plików Arkuszy Google i je modyfikować. Typowymi operacjami są dodawanie nowych arkuszy i współpracowników.

Metody

Metoda	Zwracany typ	Krótki opis
`addDeveloperMetadata(key)`	`Spreadsheet`	Dodaje metadane dewelopera z określonym kluczem do arkusza kalkulacyjnego najwyższego poziomu.
`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 danego użytkownika do listy edytujących `Spreadsheet`.
`addEditor(user)`	`Spreadsheet`	Dodaje danego użytkownika do listy edytujących `Spreadsheet`.
`addEditors(emailAddresses)`	`Spreadsheet`	Dodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku `Spreadsheet`.
`addMenu(name, subMenus)`	`void`	Tworzy nowe menu w interfejsie arkusza kalkulacyjnego.
`addViewer(emailAddress)`	`Spreadsheet`	Dodaje danego użytkownika do listy widzów `Spreadsheet`.
`addViewer(user)`	`Spreadsheet`	Dodaje danego użytkownika do listy widzów `Spreadsheet`.
`addViewers(emailAddresses)`	`Spreadsheet`	Dodaje podany tablicowy zbiór użytkowników do listy widzów `Spreadsheet`.
`appendRow(rowContents)`	`Sheet`	Dodaje wiersz na dole bieżącego regionu danych w arkuszu.
`autoResizeColumn(columnPosition)`	`Sheet`	Ustawia szerokość danej kolumny tak, aby pasowała do jej zawartości.
`copy(name)`	`Spreadsheet`	Skopiuj arkusz kalkulacyjny i zwróć nowy.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Zwraca `DeveloperMetadataFinder` dla znalezienia metadanych dewelopera w zakresie tego arkusza kalkulacyjnego.
`createTextFinder(findText)`	`TextFinder`	Tworzy w arkuszu kalkulacyjnym narzędzie do wyszukiwania tekstu, które umożliwia znajdowanie i zastępowanie tekstu w arkuszu.
`deleteActiveSheet()`	`Sheet`	usuwa aktualnie aktywny arkusz.
`deleteColumn(columnPosition)`	`Sheet`	Usuwa kolumnę na podanej pozycji.
`deleteColumns(columnPosition, howMany)`	`void`	Usuwa określoną liczbę kolumn, zaczynając od podanej pozycji kolumny.
`deleteRow(rowPosition)`	`Sheet`	Usuwa wiersz na podanej pozycji.
`deleteRows(rowPosition, howMany)`	`void`	Usuwa określoną liczbę wierszy, rozpoczynając od podanej pozycji wiersza.
`deleteSheet(sheet)`	`void`	Usuwa określony arkusz.
`duplicateActiveSheet()`	`Sheet`	Duplikat aktywnego arkusza stanie się nowym aktywnym arkuszem.
`getActiveCell()`	`Range`	Zwraca aktywną komórkę w tym arkuszu.
`getActiveRange()`	`Range`	Zwraca wybrany zakres na aktywnym arkuszu lub `null`, jeśli nie ma aktywnego zakresu.
`getActiveRangeList()`	`RangeList`	Zwraca listę aktywnych zakresów na aktywnym arkuszu lub `null`, jeśli nie ma aktywnych zakresów.
`getActiveSheet()`	`Sheet`	Pobiera aktywny arkusz w arkuszu kalkulacyjnym.
`getAs(contentType)`	`Blob`	Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści.
`getBandings()`	`Banding[]`	Zwraca wszystkie pasma w tym arkuszu kalkulacyjnym.
`getBlob()`	`Blob`	Zwraca dane w tym obiekcie jako blob.
`getColumnWidth(columnPosition)`	`Integer`	Pobiera szerokość danej kolumny w pikselach.
`getCurrentCell()`	`Range`	Zwraca bieżącą komórkę na aktywnym arkuszu lub `null`, jeśli nie ma bieżącej komórki.
`getDataRange()`	`Range`	Zwraca `Range` odpowiadający wymiarom, w których 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 najwyższego poziomu.
`getEditors()`	`User[]`	Pobiera listę edytorów tego `Spreadsheet`.
`getFormUrl()`	`String`	Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza kalkulacyjnego, lub `null`, jeśli z tym arkuszem nie jest powiązany żaden formularz.
`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 na siatce w arkuszu.
`getIterativeCalculationConvergenceThreshold()`	`Number`	Zwraca wartość progową użytą podczas iteracyjnego obliczenia.
`getLastColumn()`	`Integer`	Zwraca pozycję ostatniej kolumny z zawartością.
`getLastRow()`	`Integer`	Zwraca pozycję ostatniego wiersza zawierającego dane.
`getMaxIterativeCalculationCycles()`	`Integer`	Zwraca maksymalną liczbę iteracji do użycia podczas obliczeń iteracyjnych.
`getName()`	`String`	Pobiera nazwę dokumentu.
`getNamedRanges()`	`NamedRange[]`	Pobiera wszystkie zakresy nazwane w tym arkuszu kalkulacyjnym.
`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 R1C1.
`getRangeByName(name)`	`Range`	Zwraca zakres o nazwie lub `null`, jeśli nie znaleziono zakresu o podanej nazwie.
`getRangeList(a1Notations)`	`RangeList`	Zwraca kolekcję `RangeList` reprezentującą zakresy na tym samym arkuszu, które są określone przez niepustą listę zapisów w notacji A1 lub R1C1.
`getRecalculationInterval()`	`RecalculationInterval`	Zwraca interwał obliczania dla tego arkusza kalkulacyjnego.
`getRowHeight(rowPosition)`	`Integer`	Pobiera wysokość danego wiersza w pikselach.
`getSelection()`	`Selection`	Zwraca bieżącą wartość `Selection` w arkuszu kalkulacyjnym.
`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, rozpoczynając od podanych współrzędnych.
`getSheets()`	`Sheet[]`	Pobiera wszystkie arkusze w tym arkuszu kalkulacyjnym.
`getSpreadsheetLocale()`	`String`	Pobiera ustawienia regionalne arkusza kalkulacyjnego.
`getSpreadsheetTheme()`	`SpreadsheetTheme`	Zwraca bieżący motyw arkusza kalkulacyjnego lub `null`, jeśli nie ma żadnego motywu.
`getSpreadsheetTimeZone()`	`String`	Pobiera strefę czasową arkusza kalkulacyjnego.
`getUrl()`	`String`	Zwraca adres URL danego arkusza kalkulacyjnego.
`getViewers()`	`User[]`	Pobiera listę osób, które oglądały lub komentowały ten `Spreadsheet`.
`hideColumn(column)`	`void`	Ukrywa kolumnę lub kolumny w podanym zakresie.
`hideRow(row)`	`void`	Ukrywa wiersze w podanym zakresie.
`insertColumnAfter(afterPosition)`	`Sheet`	Wstawia kolumnę po podanej kolumnie.
`insertColumnBefore(beforePosition)`	`Sheet`	Wstawia kolumnę przed podaną pozycją kolumny.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Wstawia określoną liczbę kolumn po podanej kolumnie.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Wstawia określoną liczbę kolumn przed podaną pozycją kolumny.
`insertDataSourceSheet(spec)`	`DataSourceSheet`	Wstawia do arkusza kalkulacyjnego nowy element `DataSourceSheet` i uruchamia 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 danym wierszu i kolumnie z przesunięciem o pewną liczbę pikseli.
`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 przesunięciem o piksele.
`insertRowAfter(afterPosition)`	`Sheet`	Wstawia wiersz po podanej pozycji wiersza.
`insertRowBefore(beforePosition)`	`Sheet`	Wstawia wiersz przed podaną pozycją wiersza.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Wstawia określoną liczbę wierszy po podanej pozycji wiersza.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Wstawia określoną liczbę wierszy przed podaną pozycją wiersza.
`insertSheet()`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego, używając domyślnej nazwy arkusza.
`insertSheet(sheetIndex)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego pod podanym indeksem.
`insertSheet(sheetIndex, options)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego pod podanym indeksem i używa opcjonalnych parametrów zaawansowanych.
`insertSheet(options)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego, używając domyślnej nazwy arkusza i opcjonalnych parametrów zaawansowanych.
`insertSheet(sheetName)`	`Sheet`	Wstawia do arkusza nowy arkusz o podanej nazwie.
`insertSheet(sheetName, sheetIndex)`	`Sheet`	Wstawia nowy arkusz o podanej nazwie w podanym indeksie.
`insertSheet(sheetName, sheetIndex, options)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego o danej nazwie w danym indeksie i używa opcjonalnych argumentów zaawansowanych.
`insertSheet(sheetName, options)`	`Sheet`	Wstawia do arkusza kalkulacyjnego nową kartę o podanej nazwie i używa opcjonalnych parametrów zaawansowanych.
`insertSheetWithDataSourceTable(spec)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego, tworzy `DataSourceTable` obejmujący cały arkusz z danym źródłem danych i rozpoczyna wykonywanie danych.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Zwraca informację, czy dana kolumna jest ukryta przez użytkownika.
`isIterativeCalculationEnabled()`	`Boolean`	Zwraca informację, czy w tej arkuszu kalkulacja iteracyjna jest włączona.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Zwraca wartość wskazującą, czy dany wiersz jest ukryty przez filtr (a nie przez widok filtra).
`isRowHiddenByUser(rowPosition)`	`Boolean`	Zwraca informację, czy dany wiersz jest ukryty przez użytkownika.
`moveActiveSheet(pos)`	`void`	Przenosi aktywny arkusz na wybraną pozycję na liście arkuszy.
`moveChartToObjectSheet(chart)`	`Sheet`	Tworzy nowy arkusz `SheetType.OBJECT` i przenosi do niego podany 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`	Usunięcie danego użytkownika z listy edytujących w przypadku `Spreadsheet`.
`removeEditor(user)`	`Spreadsheet`	Usunięcie danego użytkownika z listy edytujących w przypadku `Spreadsheet`.
`removeMenu(name)`	`void`	Usuwa menu, które zostało dodane przez użytkownika `addMenu(name, subMenus)`.
`removeNamedRange(name)`	`void`	Usuwa zakres nazwany o podanej nazwie.
`removeViewer(emailAddress)`	`Spreadsheet`	Usunięcie danego użytkownika z listy widzów i komentujących `Spreadsheet`.
`removeViewer(user)`	`Spreadsheet`	Usunięcie danego użytkownika z listy widzów i komentujących `Spreadsheet`.
`rename(newName)`	`void`	Zmienia nazwę dokumentu.
`renameActiveSheet(newName)`	`void`	Zmień nazwę bieżącego aktywnego arkusza na podany nowy.
`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, przy czym lewa górna komórka zakresu jest `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Ustawia określoną listę zakresów jako `active ranges` w aktywnym arkuszu.
`setActiveSelection(range)`	`Range`	Określa aktywny obszar zaznaczenia na tym arkuszu.
`setActiveSelection(a1Notation)`	`Range`	Ustawia aktywny zakres zaznaczania zgodnie z notacją A1 lub R1C1.
`setActiveSheet(sheet)`	`Sheet`	Ustawia podany arkusz jako aktywny arkusz w arkuszu kalkulacyjnym.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym z opcją przywrócenia ostatniego zaznaczenia na tym arkuszu.
`setColumnWidth(columnPosition, width)`	`Sheet`	Ustawia szerokość danej kolumny w pikselach.
`setCurrentCell(cell)`	`Range`	Ustawia wskazaną komórkę jako `current cell`.
`setFrozenColumns(columns)`	`void`	Blokuje podany numer kolumn.
`setFrozenRows(rows)`	`void`	Blokuje podany numer wiersza.
`setIterativeCalculationConvergenceThreshold(minThreshold)`	`Spreadsheet`	Ustawia minimalną wartość progu dla obliczeń iteracyjnych.
`setIterativeCalculationEnabled(isEnabled)`	`Spreadsheet`	Określa, czy w tym arkuszu kalkulacyjnym jest włączone obliczenie iteracyjne.
`setMaxIterativeCalculationCycles(maxIterations)`	`Spreadsheet`	Określa maksymalną liczbę iteracji obliczeń, które mają być wykonywane podczas obliczeń iteracyjnych.
`setNamedRange(name, range)`	`void`	Nazwa zakresu.
`setRecalculationInterval(recalculationInterval)`	`Spreadsheet`	Określa, jak często arkusz kalkulacyjny ma być ponownie obliczany.
`setRowHeight(rowPosition, height)`	`Sheet`	Ustawia wysokość wiersza w pikselach.
`setSpreadsheetLocale(locale)`	`void`	Ustawia język arkusza kalkulacyjnego.
`setSpreadsheetTheme(theme)`	`SpreadsheetTheme`	Ustawia motyw w arkuszu kalkulacyjnym.
`setSpreadsheetTimeZone(timezone)`	`void`	Ustawia strefę czasową arkusza kalkulacyjnego.
`show(userInterface)`	`void`	Wyświetla niestandardowy komponent interfejsu użytkownika w oknie dialogowym wyśrodkowanym w widżecie przeglądarki użytkownika.
`sort(columnPosition)`	`Sheet`	Sortuje arkusz według kolumny w kolejności rosnącej.
`sort(columnPosition, ascending)`	`Sheet`	Sortuje arkusz według kolumny.
`toast(msg)`	`void`	W prawym dolnym rogu arkusza kalkulacyjnego wyświetla się wyskakujące okienko z danym komunikatem.
`toast(msg, title)`	`void`	W prawym dolnym rogu arkusza kalkulacyjnego wyświetla okno z komunikatem i tytułem.
`toast(msg, title, timeoutSeconds)`	`void`	W prawym dolnym rogu arkusza kalkulacyjnego wyświetla się wyskakujące okienko z danym tytułem i wiadomością, które pozostaje widoczne przez określony czas.
`unhideColumn(column)`	`void`	Odkrywa kolumnę w podanym zakresie.
`unhideRow(row)`	`void`	Odkrywa wiersz w podanym zakresie.
`updateMenu(name, subMenus)`	`void`	Zaktualizowano menu dodane przez `addMenu(name, subMenus)`.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Czeka na zakończenie wszystkich bieżących wykonań w arkuszu kalkulacyjnym i przerywa po upływie podanej liczby sekund.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
`getSheetProtection()`	`PageProtection`	Zwraca instancję `PageProtection`, która opisuje uprawnienia dla bieżącego arkusza.
`isAnonymousView()`	`Boolean`	Wskazuje, czy dokument umożliwia anonimowe wyświetlanie.
`isAnonymousWrite()`	`Boolean`	Wskazuje, czy dokument zezwala na wprowadzanie zmian przez anonimowych użytkowników.
`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`	`void`	Ustawia zasady dotyczące anonimowego czytania i pisania w dokumencie.
`setSheetProtection(permissions)`	`void`	Ustawia uprawnienia dla bieżącego arkusza.

Szczegółowa dokumentacja

`addDeveloperMetadata(key)`

Dodaje metadane dewelopera z określonym kluczem do arkusza kalkulacyjnego najwyższego poziomu.

// 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.

Powrót

Spreadsheet – ten arkusz kalkulacyjny, do łańcucha.

Autoryzacja

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

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

`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.

Powrót

Spreadsheet – ten arkusz kalkulacyjny, do łańcucha.

Autoryzacja

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

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

`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.

Powrót

Spreadsheet – ten arkusz kalkulacyjny, do łańcucha.

Autoryzacja

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

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

`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.

Powrót

Spreadsheet – ten arkusz kalkulacyjny, do łańcucha.

Autoryzacja

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

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

`addEditor(emailAddress)`

Dodaje danego użytkownika do listy edytujących Spreadsheet. Jeśli użytkownik był już na liście widzów, ta metoda powoduje usunięcie go z tej listy.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz dodać.

Powrót

Spreadsheet – ta Spreadsheet służy do tworzenia łańcuszków.

Autoryzacja

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

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

`addEditor(user)`

Dodaje danego użytkownika do listy edytujących Spreadsheet. Jeśli użytkownik był już na liście widzów, ta metoda powoduje usunięcie go z tej listy.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika, którego chcesz dodać.

Powrót

Spreadsheet – ta Spreadsheet służy do tworzenia łańcuszków.

Autoryzacja

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

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

`addEditors(emailAddresses)`

Dodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku Spreadsheet. Jeśli któryś z użytkowników znajduje się już na liście widzów, ta metoda spowoduje usunięcie go z tej listy.

Parametry

Nazwa	Typ	Opis
`emailAddresses`	`String[]`	Tablica adresów e-mail użytkowników, których chcesz dodać.

Powrót

Spreadsheet – ta Spreadsheet służy do tworzenia łańcuszków.

Autoryzacja

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

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

`addMenu(name, subMenus)`

Tworzy nowe menu w interfejsie arkusza kalkulacyjnego.

Każdy wpis w menu uruchamia funkcję zdefiniowaną przez użytkownika. Zwykle wywołujesz ją z funkcji onOpen(), aby menu było tworzone automatycznie po załadowaniu 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`.

Autoryzacja

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

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

`addViewer(emailAddress)`

Dodaje danego użytkownika do listy widzów Spreadsheet. Jeśli użytkownik był już na liście redaktorów, ta metoda nie przyniesie efektu.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz dodać.

Powrót

Spreadsheet – ta Spreadsheet służy do tworzenia łańcuszków.

Autoryzacja

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

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

`addViewer(user)`

Dodaje danego użytkownika do listy widzów Spreadsheet. Jeśli użytkownik był już na liście redaktorów, ta metoda nie przyniesie efektu.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika, którego chcesz dodać.

Powrót

Spreadsheet – ta Spreadsheet służy do tworzenia łańcuszków.

Autoryzacja

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

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

`addViewers(emailAddresses)`

Dodaje podany tablicowy zbiór użytkowników do listy widzów Spreadsheet. Jeśli któryś z użytkowników był już na liście edytujących, ta metoda nie będzie miała na niego wpływu.

Parametry

Nazwa	Typ	Opis
`emailAddresses`	`String[]`	Tablica adresów e-mail użytkowników, których chcesz dodać.

Powrót

Spreadsheet – ta Spreadsheet służy do tworzenia łańcuszków.

Autoryzacja

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

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

`appendRow(rowContents)`

Dodaje wiersz na dole bieżącego regionu danych w arkuszu. Jeśli zawartość komórki zaczyna się od =, jest 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.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod.

Autoryzacja

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

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

`autoResizeColumn(columnPosition)`

Ustawia szerokość danej kolumny tak, 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 kolumny, której rozmiar chcesz zmienić.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`copy(name)`

Skopiuj arkusz kalkulacyjny i zwróć 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.

Powrót

Spreadsheet – ten arkusz kalkulacyjny, do łańcucha.

Autoryzacja

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

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

`createDeveloperMetadataFinder()`

Zwraca DeveloperMetadataFinder dla znalezienia metadanych dewelopera w zakresie tego arkusza kalkulacyjnego. Domyślnie uwzględnia to wszystkie metadane powiązane z arkuszami, wierszami i kolumnami 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');

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

Powrót

DeveloperMetadataFinder – wyszukiwarka metadanych dewelopera do wyszukiwania metadanych w zakresie tego arkusza kalkulacyjnego.

`createTextFinder(findText)`

Tworzy w arkuszu kalkulacyjnym narzędzie do wyszukiwania tekstu, które umożliwia znajdowanie i zastępowanie tekstu w arkuszu. 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, który chcesz wyszukać.

Powrót

TextFinder – TextFinder 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();

Powrót

Sheet – nowy aktywny arkusz.

Autoryzacja

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

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

`deleteColumn(columnPosition)`

Usuwa kolumnę na podanej pozycji.

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, która zaczyna się od 1 w przypadku pierwszej kolumny.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`deleteColumns(columnPosition, howMany)`

Usuwa określoną 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.

Autoryzacja

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

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

`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 dla pierwszego wiersza.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`deleteRows(rowPosition, howMany)`

Usuwa określoną liczbę wierszy, rozpoczynając od podanej 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.

Autoryzacja

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

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

`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.

Autoryzacja

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

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

`duplicateActiveSheet()`

Duplikat aktywnego arkusza stanie się nowym aktywnym arkuszem.

// The code below makes a duplicate of the active sheet
SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`getActiveCell()`

Zwraca aktywną komórkę w tym arkuszu.

Uwaga: zalecamy użycie funkcji getCurrentCell(), która zwraca aktualnie wyróżnioną komórkę.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Returns the active cell
var cell = sheet.getActiveCell();

Powrót

Range – bieżąca aktywna komórka

Autoryzacja

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

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

`getActiveRange()`

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

Termin „zakres aktywny” odnosi się do zakresu wybranego przez użytkownika na 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();

Powrót

Range – aktywny zakres

Autoryzacja

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

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

Zobacz też

setActiveRange(range)

`getActiveRangeList()`

Zwraca listę aktywnych zakresów na aktywnym arkuszu lub null, jeśli nie ma aktywnych zakresów.

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

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

Powrót

RangeList — lista aktywnych zakresów

Autoryzacja

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

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

Zobacz też

setActiveRangeList(rangeList)

`getActiveSheet()`

Pobiera aktywny arkusz w arkuszu kalkulacyjnym.

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

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

Powrót

Sheet – aktywny arkusz w arkuszu kalkulacyjnym.

`getAs(contentType)`

Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „mójplik.pdf”. Zakłada ona jednak, że część nazwy pliku, która następuje po ostatnim okresie (jeśli w ogóle występuje), to istniejące rozszerzenie, które należy zastąpić. W rezultacie plik „ShoppingList.12.25.2014” staje się „ShoppingList.12.25.pdf”.

Informacje o limitach dziennych konwersji znajdziesz w artykule Limity dotyczące usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME, na który ma nastąpić konwersja. W przypadku większości blobów opcja `'application/pdf'` jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są również wartości `'image/bmp'`, `'image/gif'`, `'image/jpeg'` lub `'image/png'`. W przypadku dokumentu w Dokumentach Google możesz też użyć `'text/markdown'`.

Powrót

Blob – dane w postaci bloba.

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

Powrót

Banding[] – pasma w tym arkuszu kalkulacyjnym.

Autoryzacja

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

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

`getBlob()`

Zwraca dane w tym obiekcie jako blob.

Powrót

Blob – dane w postaci bloba.

`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`	Pozycja kolumny do sprawdzenia.

Powrót

Integer – szerokość kolumny w pikselach

Autoryzacja

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

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

`getCurrentCell()`

Zwraca bieżącą komórkę na aktywnym arkuszu lub null, jeśli nie ma bieżącej komórki. Bieżąca komórka to komórka, która jest aktywna w interfejsie Arkuszy Google i wyróżniona ciemną obwódką. Nigdy nie ma więcej niż 1 bieżącej komórki. Gdy użytkownik wybierze co najmniej jeden zakres komórek, jedna z komórek w zakresie jest 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();

Powrót

Range – bieżąca komórka

Autoryzacja

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

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

`getDataRange()`

Zwraca Range odpowiadający wymiarom, w których znajdują się dane.

Jest to funkcjonalnie to samo, co utworzenie zakresu ograniczonego przez 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);
}

Powrót

Range – zakres obejmujący wszystkie dane w arkuszu kalkulacyjnym

Autoryzacja

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

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

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

Powrót

DataSourceFormula[] – lista formuł źródeł danych.

Autoryzacja

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

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

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

Powrót

DataSourcePivotTable[] – lista tabel przestawnych źródeł danych.

Autoryzacja

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

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

`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);

Powrót

DataSourceRefreshSchedule[] – harmonogramy odświeżania tego arkusza kalkulacyjnego.

Autoryzacja

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

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

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

Powrót

DataSourceSheet[] – tablice wszystkich źródeł danych.

Autoryzacja

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

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

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

Powrót

DataSourceTable[] – lista tabel źródeł danych.

Autoryzacja

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

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

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

Powrót

DataSource[] – tablica wszystkich źródeł danych.

Autoryzacja

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

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

`getDeveloperMetadata()`

Pobiera metadane dewelopera powiązane z arkuszem 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());

Powrót

DeveloperMetadata[] – metadane dewelopera powiązane z tym zakresem.

Autoryzacja

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

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

`getEditors()`

Pobiera listę edytorów tego Spreadsheet.

Powrót

User[] – tablica użytkowników z uprawnieniami do edycji.

Autoryzacja

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

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

`getFormUrl()`

Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza kalkulacyjnego, lub null, jeśli z tym arkuszem nie jest powiązany żaden formularz. Jeśli do tego arkusza kalkulacyjnego odpowiedzi przesyła wiele formularzy, zwracany adres URL formularza jest nieokreślony. Jako alternatywę możesz pobrać powiązania adresów URL formularzy na poszczególnych arkuszach 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);

Powrót

String – adres URL formularza, którego odpowiedzi są umieszczane w tym arkuszu kalkulacyjnym, lub null, jeśli ten arkusz nie jest powiązany z żadnym formularzem.

Autoryzacja

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

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

`getFrozenColumns()`

Zwraca liczbę zablokowanych kolumn.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());

Powrót

Integer — liczba zablokowanych kolumn

Autoryzacja

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

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

`getFrozenRows()`

Zwraca liczbę zablokowanych wierszy.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());

Powrót

Integer — liczba zablokowanych wierszy

Autoryzacja

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

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

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

Powrót

String – unikalny identyfikator (lub klucz) arkusza kalkulacyjnego.

`getImages()`

Zwraca wszystkie obrazy na siatce w arkuszu.

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

Powrót

OverGridImage[] – tablica obrazów nad siatką.

Autoryzacja

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

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

`getIterativeCalculationConvergenceThreshold()`

Zwraca wartość progową użytą podczas iteracyjnego obliczenia. Gdy wyniki kolejnych obliczeń różnią się od siebie o mniej niż tę wartość, obliczenia iteracyjne są przerywane.

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

Powrót

Number – próg zbieżności.

Autoryzacja

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

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

`getLastColumn()`

Zwraca pozycję ostatniej kolumny, która zawiera dane.

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

Powrót

Integer – ostatnia kolumna arkusza, która zawiera treści

Autoryzacja

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

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

`getLastRow()`

Zwraca pozycję ostatniego wiersza, który zawiera dane.

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

Powrót

Integer – ostatni wiersz arkusza, który zawiera treści

Autoryzacja

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

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

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

Powrót

Integer – maksymalna liczba iteracji obliczeń.

Autoryzacja

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

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

`getName()`

Pobiera nazwę dokumentu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getName());

Powrót

String – nazwa arkusza kalkulacyjnego.

Autoryzacja

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

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

`getNamedRanges()`

Pobiera wszystkie zakresy nazwane w tym arkuszu kalkulacyjnym.

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

Powrót

NamedRange[] – tablica wszystkich zakresów nazwanych w arkuszu kalkulacyjnym.

Autoryzacja

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

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

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

Powrót

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

Powrót

User – właściciel dokumentu lub null, jeśli dokument znajduje się na dysku współdzielonym.

Autoryzacja

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

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

`getPredefinedSpreadsheetThemes()`

Zwraca listę wstępnie zdefiniowanych motywów.

// The code below returns the list of predefined themes.
var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet()
                               .getPredefinedSpreadsheetThemes();

Powrót

SpreadsheetTheme[] – lista wstępnie zdefiniowanych motywów.

Autoryzacja

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

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

`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`.

Powrót

Protection[] – tablica obiektów reprezentujących wszystkie chronione zakresy lub arkusze w arkuszu kalkulacyjnym.

Autoryzacja

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

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

`getRange(a1Notation)`

Zwraca zakres określony w notacji A1 lub 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 R1C1.

Powrót

Range – zasięg w wybranym miejscu

Autoryzacja

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

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

`getRangeByName(name)`

Zwraca zakres o nazwie lub null, jeśli nie znaleziono zakresu o podanej nazwie. Jeśli w arkuszu kalkulacyjnym występuje kilka arkuszy, które używają tej samej nazwy zakresu, podaj nazwę arkusza bez dodatkowych cudzysłowów, np. 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 pobrania.

Powrót

Range – zakres komórek o podanej nazwie.

`getRangeList(a1Notations)`

Zwraca kolekcję RangeList reprezentującą zakresy na tym samym arkuszu, określone przez niepustą listę zapisów A1 lub 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, określona w notacji A1 lub R1C1.

Powrót

RangeList – lista zakresów w wyznaczonej lokalizacji

Autoryzacja

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

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

`getRecalculationInterval()`

Zwraca interwał obliczania 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());

Powrót

RecalculationInterval – przedział czasowy obliczeń w tym arkuszu kalkulacyjnym.

Autoryzacja

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

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

`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.

Powrót

Integer – wysokość wiersza w pikselach

Autoryzacja

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

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

`getSelection()`

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

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var currentCell = selection.getCurrentCell();

Powrót

Selection – bieżący wybór

Autoryzacja

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

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

`getSheetByName(name)`

Zwraca arkusz o podanej nazwie.

Jeśli wiele arkuszy ma tę samą nazwę, zwracany jest arkusz znajdujący się najdalej w lewo. Zwraca 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, który ma zostać pobrany.

Powrót

Sheet – arkusz o danej nazwie.

`getSheetId()`

Zwraca identyfikator arkusza reprezentowanego przez ten obiekt.

Jest to identyfikator arkusza, który jest unikalny dla danego arkusza kalkulacyjnego. Identyfikator jest monotonicznie rosnącą liczbą całkowitą przypisaną w momencie tworzenia arkusza i niezależną 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());

Powrót

Integer – identyfikator arkusza, który jest unikalny dla arkusza kalkulacyjnego.

Autoryzacja

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

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

`getSheetName()`

Zwraca nazwę arkusza.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log(sheet.getSheetName());

Powrót

String – nazwa arkusza.

Autoryzacja

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

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

`getSheetValues(startRow, startColumn, numRows, numColumns)`

Zwraca prostokątną siatkę wartości dla tego zakresu, rozpoczynając od podanych współrzędnych. Wartość -1 podana jako pozycja wiersza lub kolumny jest równoważna uzyskaniu ostatniego wiersza lub ostatniej kolumny zawierającej 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 początkowego wiersza.
`startColumn`	`Integer`	Pozycja pierwszej kolumny.
`numRows`	`Integer`	Liczba wierszy, dla których mają być zwracane wartości.
`numColumns`	`Integer`	Liczba kolumn, dla których mają być zwracane wartości.

Powrót

Object[][] – dwuwymiarowa tablica wartości

Autoryzacja

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

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

`getSheets()`

Pobiera wszystkie arkusze w tym arkuszu kalkulacyjnym.

// The code below logs the name of the second sheet
var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
if (sheets.length > 1) {
  Logger.log(sheets[1].getName());
}

Powrót

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

Powrót

String – lokalizacja arkusza kalkulacyjnego.

Autoryzacja

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

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

`getSpreadsheetTheme()`

Zwraca bieżący motyw arkusza kalkulacyjnego lub null, jeśli nie ma żadnego motywu.

// The code below returns the current theme of the spreadsheet.
var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();

Powrót

SpreadsheetTheme – aktualnie zastosowany motyw.

Autoryzacja

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

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

`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);

Powrót

String – strefa czasowa określona w formacie „długim” (np. „Ameryka/Nowy Jork”, zgodnie z informacjami na stronie Joda.org).

Autoryzacja

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

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

`getUrl()`

Zwraca adres URL danego arkusza kalkulacyjnego.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getUrl());

Powrót

String – adres URL danego arkusza kalkulacyjnego.

Autoryzacja

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

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

`getViewers()`

Pobiera listę osób, które oglądały lub komentowały ten Spreadsheet.

Powrót

User[] – tablica użytkowników z uprawnieniami do wyświetlania lub komentowania.

Autoryzacja

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

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

`hideColumn(column)`

Ukrywa kolumnę lub kolumny w podanym 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 kolumny do ukrycia.

Autoryzacja

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

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

`hideRow(row)`

Ukrywa wiersze w podanym 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.

Autoryzacja

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

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

`insertColumnAfter(afterPosition)`

Wstawia kolumnę po podanej kolumnie.

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 ma zostać dodana nowa kolumna.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`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, przed którą ma zostać dodana nowa kolumna.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`insertColumnsAfter(afterPosition, howMany)`

Wstawia określoną liczbę kolumn po podanej kolumnie.

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 ma zostać dodana nowa kolumna.
`howMany`	`Integer`	Liczba kolumn do wstawienia.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`insertColumnsBefore(beforePosition, howMany)`

Wstawia określoną 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, przed którą ma zostać dodana nowa kolumna.
`howMany`	`Integer`	Liczba kolumn do wstawienia.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`insertDataSourceSheet(spec)`

Wstawia do arkusza kalkulacyjnego nowy element DataSourceSheet i uruchamia wykonywanie danych. W efekcie spowoduje to też, że nowy arkusz stanie się aktywnym arkuszem.

Wyjątek jest zgłaszany, jeśli typ źródła danych nie jest włączony. Aby umożliwić wykonywanie zapytań do bazy danych w przypadku konkretnego typu źródła danych, użyj metody SpreadsheetApp#enable...Execution().

// 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 do wstawienia.

Powrót

DataSourceSheet – arkusz nowego źródła danych.

Autoryzacja

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

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

`insertImage(blobSource, column, row)`

Wstawia Spreadsheet jako obraz w dokumencie w danym wierszu i kolumnie. Rozmiar obrazu jest pobierany z zawartości bloba. 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`	Blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę.
`column`	`Integer`	Pozycja kolumny.
`row`	`Integer`	Pozycja wiersza.

Powrót

OverGridImage – wstawiony obraz.

Autoryzacja

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

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

`insertImage(blobSource, column, row, offsetX, offsetY)`

Wstawia Spreadsheet jako obraz w dokumencie w danym wierszu i kolumnie z przesunięciem o pewną liczbę pikseli. Rozmiar obrazu jest pobierany z zawartości bloba. 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`	Blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę.
`column`	`Integer`	Pozycja kolumny.
`row`	`Integer`	Pozycja wiersza.
`offsetX`	`Integer`	Poziome przesunięcie od narożnika komórki w pikselach.
`offsetY`	`Integer`	Pionowe przesunięcie od narożnika komórki w pikselach.

Powrót

OverGridImage – wstawiony obraz.

Autoryzacja

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

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

`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.

Powrót

OverGridImage – wstawiony obraz.

Autoryzacja

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

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

`insertImage(url, column, row, offsetX, offsetY)`

Wstawia obraz w dokumencie w danym wierszu i kolumnie z przesunięciem o piksele.

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`	Poziome przesunięcie od narożnika komórki w pikselach.
`offsetY`	`Integer`	Pionowe przesunięcie od narożnika komórki w pikselach.

Powrót

OverGridImage – wstawiony obraz.

Autoryzacja

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

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

`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.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`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.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`insertRowsAfter(afterPosition, howMany)`

Wstawia określoną 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ą być dodawane nowe wiersze.
`howMany`	`Integer`	Liczba wierszy do wstawienia.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`insertRowsBefore(beforePosition, howMany)`

Wstawia określoną 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, przed którym mają zostać dodane nowe wiersze.
`howMany`	`Integer`	Liczba wierszy do wstawienia.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`insertSheet()`

Wstawia nowy arkusz do arkusza kalkulacyjnego, używając domyślnej nazwy arkusza. Nowy arkusz staje się aktywnym arkuszem.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet();

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetIndex)`

Wstawia nowy arkusz do arkusza kalkulacyjnego pod podanym indeksem. Nowy arkusz staje się aktywnym arkuszem.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet(1);

Parametry

Nazwa	Typ	Opis
`sheetIndex`	`Integer`	Indeks nowo utworzonego arkusza. Aby wstawić arkusz jako pierwszy w arkuszu kalkulacyjnym, ustaw tę wartość na 0.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetIndex, options)`

Wstawia nowy arkusz do arkusza kalkulacyjnego pod podanym indeksem i używa opcjonalnych parametrów zaawansowanych. Nowy arkusz staje 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 kalkulacyjnym, ustaw tę wartość na 0.
`options`	`Object`	Opcjonalne zaawansowane argumenty JavaScriptu.

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.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(options)`

Wstawia nowy arkusz do arkusza kalkulacyjnego, używając domyślnej nazwy arkusza i opcjonalnych parametrów zaawansowanych. Nowy arkusz staje się aktywnym arkuszem.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet({template: templateSheet});

Parametry

Nazwa	Typ	Opis
`options`	`Object`	Opcjonalne zaawansowane argumenty 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 obiektu Arkusz kalkulacyjny.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetName)`

Wstawia do arkusza nowy arkusz o podanej nazwie. Nowy arkusz staje się aktywnym arkuszem.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet');

Parametry

Nazwa	Typ	Opis
`sheetName`	`String`	Nazwa nowego arkusza.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetName, sheetIndex)`

Wstawia nowy arkusz o podanej nazwie w podanym 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 kalkulacyjnym, ustaw tę wartość na 0.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetName, sheetIndex, options)`

Wstawia nowy arkusz do arkusza kalkulacyjnego o danej nazwie w danym indeksie i używa opcjonalnych argumentów zaawansowanych. Nowy arkusz staje 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 go na 0.
`options`	`Object`	Opcjonalne zaawansowane argumenty JavaScriptu.

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.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetName, options)`

Wstawia do arkusza kalkulacyjnego nową kartę o podanej nazwie i używa opcjonalnych parametrów zaawansowanych. Nowy arkusz staje 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 zaawansowane argumenty JavaScriptu.

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.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheetWithDataSourceTable(spec)`

Wstawia nowy arkusz do arkusza kalkulacyjnego, tworzy DataSourceTable obejmujący cały arkusz z danym źródłem danych i rozpoczyna wykonywanie danych. W efekcie powoduje to, że nowy arkusz staje się aktywnym arkuszem.

// 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 do wstawienia.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`isColumnHiddenByUser(columnPosition)`

Zwraca informację, 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`	Pozycja kolumny do sprawdzenia.

Powrót

Boolean – true, jeśli kolumna jest ukryta, a w przeciwnym razie false.

Autoryzacja

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

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

`isIterativeCalculationEnabled()`

Zwraca informację, czy w tej arkuszu kalkulacja iteracyjna jest włączona.

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

Powrót

Boolean – true, jeśli obliczenia iteracyjne są włączone, false w przeciwnym razie.

Autoryzacja

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

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

`isRowHiddenByFilter(rowPosition)`

Zwraca informację, czy dany wiersz jest ukryty przez filtr (a nie 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.

Powrót

Boolean – true, jeśli wiersz jest ukryty, false w przeciwnym razie.

Autoryzacja

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

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

`isRowHiddenByUser(rowPosition)`

Zwraca informację, 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.

Powrót

Boolean – true, jeśli wiersz jest ukryty, false w przeciwnym razie.

Autoryzacja

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

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

`moveActiveSheet(pos)`

Przenosi aktywny arkusz na wybraną pozycję na liście arkuszy. Wyjątek jest zgłaszany, 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 na liście arkuszy, do której ma zostać przeniesiony aktywny arkusz.

Autoryzacja

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

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

`moveChartToObjectSheet(chart)`

Tworzy nowy arkusz SheetType.OBJECT i przenosi do niego podany wykres. Jeśli wykres jest już na osobnej karcie, zwracana jest ta karta bez tworzenia nowej.

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, który chcesz przenieść.

Powrót

Sheet – arkusz, na którym znajduje się wykres.

Autoryzacja

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

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

`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.

Aby umożliwić wykonywanie zapytań do bazy danych w przypadku konkretnego typu źródła danych, użyj metody SpreadsheetApp#enable...Execution().

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

Autoryzacja

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

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

`removeEditor(emailAddress)`

Usunięcie danego użytkownika z listy edytujących w przypadku Spreadsheet. Ta metoda nie blokuje dostępu do Spreadsheet użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Spreadsheet jest udostępniony całej domenie użytkownika lub jeśli Spreadsheet znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy widzów.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz usunąć.

Powrót

Spreadsheet – ta Spreadsheet służy do tworzenia łańcuszków.

Autoryzacja

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

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

`removeEditor(user)`

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy widzów.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do usunięcia.

Powrót

Spreadsheet – ta Spreadsheet służy do tworzenia łańcuszków.

Autoryzacja

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

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

`removeMenu(name)`

Usuwa menu, które zostało dodane przez użytkownika addMenu(name, subMenus). Argument name powinien mieć tę samą wartość co odpowiadające wywołanie funkcji 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.

Autoryzacja

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

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

`removeNamedRange(name)`

Usuwa zakres nazwany o podanej nazwie. Wyjątek jest zgłaszany, jeśli w arkuszu kalkulacyjnym nie ma zakresu o podanej 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.

Autoryzacja

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

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

`removeViewer(emailAddress)`

Usunięcie danego użytkownika z listy widzów i komentujących Spreadsheet. Ta metoda nie ma żadnego wpływu, jeśli użytkownik jest edytorem, a nie widzem lub komentatorem. Ta metoda nie blokuje też dostępu do Spreadsheet użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Spreadsheet jest udostępniony całej domenie użytkownika lub jeśli Spreadsheet znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy edytorów.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz usunąć.

Powrót

Spreadsheet – ta Spreadsheet służy do łańcuchowania.

Autoryzacja

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

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

`removeViewer(user)`

Usunięcie danego użytkownika z listy widzów i komentujących Spreadsheet. Ta metoda nie ma żadnego wpływu, jeśli użytkownik jest edytorem, a nie widzem. Ta metoda nie blokuje też dostępu do Spreadsheet użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład jeśli Spreadsheet jest udostępniony całej domenie użytkownika lub jeśli Spreadsheet znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.Spreadsheet

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy edytorów.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do usunięcia.

Powrót

Spreadsheet – ta Spreadsheet służy do łańcuchowania.

Autoryzacja

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

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

`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.

Autoryzacja

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

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

`renameActiveSheet(newName)`

Zmień nazwę bieżącego aktywnego arkusza na podany nowy.

// The code below renames the active sheet to "Hello world"
SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");

Parametry

Nazwa	Typ	Opis
`newName`	`String`	Nowa nazwa bieżącego aktywnego arkusza.

Autoryzacja

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

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

`resetSpreadsheetTheme()`

Usuwa zastosowany motyw i ustawia motyw domyślny w arkuszu kalkulacyjnym.

// The code below applies default theme on the spreadsheet.
SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();

Powrót

SpreadsheetTheme – motyw domyślny.

Autoryzacja

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

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

`setActiveRange(range)`

Ustawia określony zakres jako active range w aktywnym arkuszu, przy czym lewa górna komórka zakresu jest 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.

Powrót

Range – nowo aktywny zakres

Autoryzacja

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

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

`setActiveRangeList(rangeList)`

Ustawia określoną listę zakresów jako active ranges w aktywnym arkuszu. Ostatni zakres na liście jest ustawiony jako 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.

Powrót

RangeList – nowo wybrana lista zakresów

Autoryzacja

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

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

`setActiveSelection(range)`

Określa aktywny obszar zaznaczenia na 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.

Powrót

Range – nowo aktywny zakres

Autoryzacja

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

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

`setActiveSelection(a1Notation)`

Ustawia aktywny zakres zaznaczania zgodnie z notacją A1 lub R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.setActiveSelection("A1:D4");

Parametry

Nazwa	Typ	Opis
`a1Notation`	`String`	Zakres, który ma być ustawiony jako aktywny, określony w notacji A1 lub R1C1.

Powrót

Range – nowo aktywny zakres

Autoryzacja

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

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

`setActiveSheet(sheet)`

Ustawia podany arkusz jako aktywny arkusz w arkuszu kalkulacyjnym. Interfejs Arkuszy Google wyświetla wybrany arkusz, chyba że 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.

Powrót

Sheet – aktywny arkusz.

Autoryzacja

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

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

`setActiveSheet(sheet, restoreSelection)`

Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym z opcją przywrócenia ostatniego zaznaczenia na tym arkuszu. Interfejs Arkuszy Google wyświetla wybrany arkusz, chyba że 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`	Jeśli wybierzesz `true`, ostatnio wybrany element nowego aktywnego arkusza zostanie ponownie wybrany, gdy nowy arkusz stanie się aktywny. Jeśli wybierzesz `false`, nowy arkusz stanie się aktywny bez zmiany bieżącego wyboru.

Powrót

Sheet – nowy aktywny arkusz.

Autoryzacja

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

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

`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, którą chcesz ustawić.
`width`	`Integer`	Szerokość w pikselach.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`setCurrentCell(cell)`

Ustawia wskazaną komórkę jako current cell.

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

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

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

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.

Powrót

Range – nowo ustawiona bieżąca komórka

Autoryzacja

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

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

`setFrozenColumns(columns)`

Blokuje podany numer kolumn. Jeśli wartość wynosi 0, żadne kolumny nie są wstrzymywane.

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.

Autoryzacja

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

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

`setFrozenRows(rows)`

Blokuje podany numer wiersza. Jeśli jest równa 0, żadne wiersze nie są wstrzymywane.

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.

Autoryzacja

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

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

`setIterativeCalculationConvergenceThreshold(minThreshold)`

Ustawia minimalną wartość progu dla obliczeń iteracyjnych. Gdy wyniki kolejnych obliczeń różnią się od siebie o mniej niż tę wartość, obliczenia iteracyjne są przerywane. Ta wartość musi być nieujemna i domyślnie 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).

Powrót

Spreadsheet – ten arkusz kalkulacyjny, do łańcucha.

Autoryzacja

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

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

`setIterativeCalculationEnabled(isEnabled)`

Określa, czy w tym arkuszu kalkulacyjnym jest włączone obliczenie iteracyjne. Jeśli po aktywowaniu obliczeń nie została jeszcze określona maksymalna liczba cykli obliczeń ani próg zbieżności, domyślnie przyjmuje się odpowiednio 50 i 0,05. Jeśli któraś z nich była wcześniej ustawiona, zachowa swoją poprzednią wartość.

// 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 mają być włączone obliczenia iteracyjne; `false`w przeciwnym razie.

Powrót

Spreadsheet – ten arkusz kalkulacyjny, do łańcucha.

Autoryzacja

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

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

`setMaxIterativeCalculationCycles(maxIterations)`

Określa maksymalną liczbę iteracji obliczeń, które mają być wykonywane podczas obliczeń iteracyjnych. Ta wartość musi mieścić się w zakresie od 1 do 10 000 (włącznie). Domyślnie jest to 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 tys.).

Powrót

Spreadsheet – ten arkusz kalkulacyjny, do łańcucha.

Autoryzacja

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

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

`setNamedRange(name, range)`

Nazwa zakresu.

// 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.

Autoryzacja

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

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

`setRecalculationInterval(recalculationInterval)`

Określa, jak często arkusz kalkulacyjny ma być ponownie obliczany.

// 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ł ponownego obliczania.

Powrót

Spreadsheet – ten arkusz kalkulacyjny, do łańcucha.

Autoryzacja

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

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

`setRowHeight(rowPosition, height)`

Ustawia wysokość wiersza w pikselach. Domyślnie wiersze rozszerzają się, aby pomieścić zawartość komórki. Jeśli chcesz wymusić określoną wysokość wierszy, użyj atrybutu 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, którą chcesz zmienić.
`height`	`Integer`	Wysokość w pikselach.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod.

Autoryzacja

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

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

`setSpreadsheetLocale(locale)`

Ustawia język 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óry ma być używany (np. „pl”, „en” lub „pl_PL”).

Autoryzacja

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

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

`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.

Powrót

SpreadsheetTheme – nowy bieżący motyw.

Autoryzacja

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

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

`setSpreadsheetTimeZone(timezone)`

Ustawia 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 określona w formacie „długim” (np. „Ameryka/Nowy Jork”, zgodnie z informacjami podanymi na stronie Joda.org).

Autoryzacja

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

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

`show(userInterface)`

Wyświetla niestandardowy komponent interfejsu użytkownika w oknie dialogowym wyśrodkowanym w widżecie przeglądarki użytkownika. Wykonywanie skryptu po stronie serwera nie jest zawieszone. Aby komunikować się z serwerem, komponent interfejsu użytkownika musi wykonywać asynchroniczne wywołania zwrotne do skryptu po stronie serwera.

Jeśli skrypt po stronie serwera wyświetlił wcześniej okno, które nie zostało jeszcze zamknięte, to okno zostanie zastąpione interfejsem nowego 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`.

Autoryzacja

Skrypty, które korzystają 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 w kolejności rosnącej.

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 chcesz sortować.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`sort(columnPosition, ascending)`

Sortuje arkusz według kolumny. Przyjmuje parametr określający kolejność rosnącą lub malejącą.

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 chcesz sortować.
`ascending`	`Boolean`	`true` – sortowanie rosnąco, `false` – malejąco.

Powrót

Sheet – arkusz, przydatny do łańcuchowania metod

Autoryzacja

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

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

`toast(msg)`

W prawym dolnym rogu arkusza kalkulacyjnego wyświetla się wyskakujące okienko z danym komunikatem.

// Show a popup with the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started');

Parametry

Nazwa	Typ	Opis
`msg`	`String`	Treść komunikatu wyświetlanego w toastu.

Autoryzacja

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

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

`toast(msg, title)`

W prawym dolnym rogu arkusza kalkulacyjnego wyświetla okno z komunikatem 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`	Treść komunikatu wyświetlanego w toastu.
`title`	`String`	Opcjonalny tytuł komunikatu.

Autoryzacja

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

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

`toast(msg, title, timeoutSeconds)`

W prawym dolnym rogu arkusza kalkulacyjnego wyświetla się wyskakujące okienko z danym tytułem i wiadomością, które pozostaje 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`	Treść komunikatu wyświetlanego w toastu.
`title`	`String`	Opcjonalny tytuł komunikatu.
`timeoutSeconds`	`Number`	Czas oczekiwania w sekundach. Jeśli jest `null`, toast jest wyświetlany domyślnie przez 5 sekund. Jeśli jest ujemny, toast pozostaje widoczny, dopóki nie zostanie zamknięty.

Autoryzacja

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

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

`unhideColumn(column)`

Odkrywa kolumnę w podanym 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, który ma być odsłonięty, jeśli jest ukryty.

Autoryzacja

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

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

`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, który ma być odsłonięty, jeśli jest ukryty.

Autoryzacja

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

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

`updateMenu(name, subMenus)`

Zaktualizowano menu dodane przez addMenu(name, subMenus). Działa 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 zaktualizowania.
`subMenus`	`Object[]`	Tablica map JavaScript z parametrami `name` i `functionName`. Możesz używać funkcji z dołączonych bibliotek, takich jak `Library.libFunction1`.

Autoryzacja

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

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

Czeka na zakończenie wszystkich bieżących wykonań w arkuszu kalkulacyjnym i przerywa po upływie podanej liczby sekund. Wyjątek jest zgłaszany, jeśli wykonanie nie zostało ukończone w czasie limitu, ale nie powoduje anulowania wykonania danych.

Parametry

Nazwa	Typ	Opis
`timeoutInSeconds`	`Integer`	Czas oczekiwania na wykonanie zapytań do bazy danych (w sekundach). Maksymalny czas trwania to 300 sekund.

Autoryzacja

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

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

Wycofane metody

`getSheetProtection()`

Wycofany. W przypadku arkuszy kalkulacyjnych utworzonych w nowszej wersji Arkuszy Google użyj funkcji Sheet.getProtections(type), która zwraca bardziej zaawansowaną klasę Protection. Chociaż ta metoda została wycofana, pozostaje dostępna ze względu na zgodność ze starszymi wersjami Arkuszy.

Zwraca instancję PageProtection, która opisuje uprawnienia dla bieżącego arkusza.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser("user@example.com");

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
var users = permissions.getUsers();
Logger.log(users);

Powrót

PageProtection – obiekt opisujący uprawnienia dostępu do arkusza

Autoryzacja

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

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

`isAnonymousView()`

Wycofany. Od stycznia 2014 r. ta funkcja jest wycofana i niedostępna w nowej wersji Arkuszy Google.

Wskazuje, czy dokument umożliwia anonimowe wyświetlanie. W nowej wersji Arkuszy Google funkcja ta nie jest już obsługiwana, dlatego zamiast niej używaj funkcji File.getSharingAccess() i File.getSharingPermission().

// Determine if the document allows anonymous viewing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission != DriveApp.Permission.NONE;

Powrót

Boolean – true, jeśli dokument umożliwia anonimowe wyświetlanie, false w przeciwnym razie – false.

Autoryzacja

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

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

Zobacz też

Usługa Dysku

`isAnonymousWrite()`

Wycofany. Od stycznia 2014 r. ta funkcja jest wycofana i niedostępna w nowej wersji Arkuszy Google.

Wskazuje, czy dokument zezwala na wprowadzanie zmian przez anonimowych użytkowników. Ponieważ ta funkcja nie jest już obsługiwana w nowej wersji Arkuszy Google, użyj zamiast niej funkcji File.getSharingAccess() i File.getSharingPermission().

// Determine if the document allow anonymous edits via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission == DriveApp.Permission.EDIT;

Powrót

Boolean – true, jeśli dokument zezwala na edytowanie anonimowe, false w przeciwnym razie true.

Autoryzacja

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

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

Zobacz też

Usługa Dysku

`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`

Wycofany. Od stycznia 2014 r. ta funkcja jest wycofana i niedostępna w nowej wersji Arkuszy Google.

Ustawia zasady dotyczące anonimowego czytania i pisania w dokumencie. Ta funkcja nie jest już obsługiwana w nowej wersji Arkuszy Google, dlatego użyj jako alternatywy File.setSharing(accessType, permissionType).

// Set the document's policy on anonymous reading and writing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());

// Set anonymous read.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.VIEW);

// Set anonymous write.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.EDIT);

// Disable anonymous access.
file.setSharing(DriveApi.Access.PRIVATE, file.getSharingPermission());

Parametry

Nazwa	Typ	Opis
`anonymousReadAllowed`	`Boolean`	`true`, aby zezwolić na anonimowe odczyty; `false` w innym przypadku.
`anonymousWriteAllowed`	`Boolean`	`true`, aby zezwolić na anonimowe odczyty; `false` w innym przypadku.

Autoryzacja

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

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

Zobacz też

isAnonymousView()
isAnonymousWrite()
Usługa Dysku

`setSheetProtection(permissions)`

Wycofany. W przypadku arkuszy kalkulacyjnych utworzonych w nowszej wersji Arkuszy Google użyj funkcji Sheet.protect(), która zwraca bardziej zaawansowaną klasę Protection. Chociaż ta metoda została wycofana, pozostaje dostępna ze względu na zgodność ze starszymi wersjami Arkuszy.

Ustawia uprawnienia dla bieżącego arkusza.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
var sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

Parametry

Nazwa	Typ	Opis
`permissions`	`PageProtection`	Obiekt uprawnień dostępu do ustawienia na tym arkuszu.

Autoryzacja

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

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