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

Class Spreadsheet

uzyskiwać dostęp do plików Arkuszy Google i je modyfikować; Typowe operacje to dodawanie nowych arkuszy i dodawanie współpracowników.

Metody

Metoda	Zwracany typ	Krótki opis
`addDeveloperMetadata(key)`	`Spreadsheet`	Dodaje metadane dewelopera o podanym kluczu do arkusza kalkulacyjnego najwyższego poziomu.
`addDeveloperMetadata(key, visibility)`	`Spreadsheet`	Dodaje do arkusza kalkulacyjnego metadane dewelopera o określonym kluczu i widoczności.
`addDeveloperMetadata(key, value)`	`Spreadsheet`	Dodaje do arkusza kalkulacyjnego metadane dewelopera o określonym kluczu i wartości.
`addDeveloperMetadata(key, value, visibility)`	`Spreadsheet`	Dodaje do arkusza kalkulacyjnego metadane dewelopera o określonym kluczu, wartości i widoczności.
`addEditor(emailAddress)`	`Spreadsheet`	Dodaje danego użytkownika do listy edytorów zasobu `Spreadsheet`.
`addEditor(user)`	`Spreadsheet`	Dodaje danego użytkownika do listy edytorów zasobu `Spreadsheet`.
`addEditors(emailAddresses)`	`Spreadsheet`	Dodaje podaną tablicę użytkowników do listy edytorów zasobu `Spreadsheet`.
`addMenu(name, subMenus)`	`void`	Tworzy nowe menu w interfejsie arkusza kalkulacyjnego.
`addViewer(emailAddress)`	`Spreadsheet`	Dodaje danego użytkownika do listy przeglądających w: `Spreadsheet`.
`addViewer(user)`	`Spreadsheet`	Dodaje danego użytkownika do listy przeglądających w: `Spreadsheet`.
`addViewers(emailAddresses)`	`Spreadsheet`	Dodaje podaną tablicę użytkowników do listy przeglądających obiekt `Spreadsheet`.
`appendRow(rowContents)`	`Sheet`	Dodaje wiersz na dole bieżącego regionu danych w arkuszu.
`autoResizeColumn(columnPosition)`	`Sheet`	Określa szerokość danej kolumny zgodnie z jej zawartością.
`copy(name)`	`Spreadsheet`	Skopiowanie arkusza kalkulacyjnego i zwrócenie nowego.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Zwraca `DeveloperMetadataFinder` w przypadku znalezienia metadanych dewelopera w zakresie ten arkusz kalkulacyjny.
`createTextFinder(findText)`	`TextFinder`	Tworzy wyszukiwarkę tekstu dla arkusza kalkulacyjnego, która może służyć do wyszukiwania i zastępowania tekstu w obrębie arkusza w arkuszu kalkulacyjnym.
`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 danej pozycji.
`deleteRow(rowPosition)`	`Sheet`	Usuwa wiersz na danej pozycji.
`deleteRows(rowPosition, howMany)`	`void`	Usuwa liczbę wierszy, zaczynając od danej pozycji.
`deleteSheet(sheet)`	`void`	Usuwa określony arkusz.
`duplicateActiveSheet()`	`Sheet`	Powiela aktywny arkusz i ustawia go jako aktywny.
`getActiveCell()`	`Range`	Zwraca aktywną komórkę w tym arkuszu.
`getActiveRange()`	`Range`	Zwraca wybrany zakres w aktywnym arkuszu lub `null`, jeśli nie ma aktywnego zakresu.
`getActiveRangeList()`	`RangeList`	Zwraca listę aktywnych zakresów w aktywnym arkuszu lub `null`, jeśli nie ma żadnych aktywnych zakresów zakresów.
`getActiveSheet()`	`Sheet`	Pobiera aktywny arkusz w arkuszu kalkulacyjnym.
`getAs(contentType)`	`Blob`	Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
`getBandings()`	`Banding[]`	Zwraca wszystkie pasma w tym arkuszu kalkulacyjnym.
`getBlob()`	`Blob`	Zwraca dane wewnątrz tego obiektu jako obiekt blob.
`getColumnWidth(columnPosition)`	`Integer`	Pobiera szerokość danej kolumny w pikselach.
`getCurrentCell()`	`Range`	Zwraca bieżącą komórkę w aktywnym arkuszu lub `null`, jeśli nie ma bieżącej komórki.
`getDataRange()`	`Range`	Zwraca wartość `Range` odpowiadającą wymiarom zawierającym dane.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Pobiera wszystkie formuły źródła danych.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Pobiera wszystkie tabele przestawne źródła danych.
`getDataSourceRefreshSchedules()`	`DataSourceRefreshSchedule[]`	Pobiera harmonogramy odświeżania tego arkusza kalkulacyjnego.
`getDataSourceSheets()`	`DataSourceSheet[]`	Zwraca wszystkie arkusze źródeł danych w arkuszu kalkulacyjnym.
`getDataSourceTables()`	`DataSourceTable[]`	Pobiera wszystkie tabele źródeł danych.
`getDataSources()`	`DataSource[]`	Zwraca wszystkie źródła danych w arkuszu kalkulacyjnym.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Pobiera metadane dewelopera powiązane z arkuszem kalkulacyjnym najwyższego poziomu.
`getEditors()`	`User[]`	Pobiera listę edytorów elementu `Spreadsheet`.
`getFormUrl()`	`String`	Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza kalkulacyjnego, lub `null`, jeśli ten arkusz kalkulacyjny nie ma powiązanego formularza.
`getFrozenColumns()`	`Integer`	Zwraca liczbę zablokowanych kolumn.
`getFrozenRows()`	`Integer`	Zwraca liczbę zablokowanych wierszy.
`getId()`	`String`	Pobiera unikalny identyfikator tego arkusza kalkulacyjnego.
`getImages()`	`OverGridImage[]`	Zwraca wszystkie obrazy w arkuszu.
`getIterativeCalculationConvergenceThreshold()`	`Number`	Zwraca wartość progową używaną podczas obliczeń iteracyjnych.
`getLastColumn()`	`Integer`	Zwraca pozycję ostatniej kolumny, która zawiera treść.
`getLastRow()`	`Integer`	Zwraca pozycję ostatniego wiersza, który zawiera treść.
`getMaxIterativeCalculationCycles()`	`Integer`	Zwraca maksymalną liczbę iteracji używanych podczas obliczeń iteracyjnych.
`getName()`	`String`	Pobiera nazwę dokumentu.
`getNamedRanges()`	`NamedRange[]`	Pobiera wszystkie zakresy nazwane z tego arkusza kalkulacyjnego.
`getNumSheets()`	`Integer`	Zwraca liczbę arkuszy w danym 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 podany w notacji A1 lub R1C1.
`getRangeByName(name)`	`Range`	Zwraca zakres nazwany lub `null`, jeśli nie znaleziono żadnego zakresu o podanej nazwie.
`getRangeList(a1Notations)`	`RangeList`	Zwraca kolekcję `RangeList` reprezentującą zakresy w tym samym określonym arkuszu możesz użyć niepustej listy notacji A1 lub notacji R1C1.
`getRecalculationInterval()`	`RecalculationInterval`	Zwraca interwał obliczeń dla tego arkusza kalkulacyjnego.
`getRowHeight(rowPosition)`	`Integer`	Pobiera wysokość danego wiersza w pikselach.
`getSelection()`	`Selection`	Zwraca bieżącą `Selection` z arkusza kalkulacyjnego.
`getSheetByName(name)`	`Sheet`	Zwraca arkusz o podanej nazwie.
`getSheetId()`	`Integer`	Zwraca identyfikator arkusza reprezentowanego przez ten obiekt.
`getSheetName()`	`String`	Zwraca nazwę arkusza.
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	Zwraca prostokątną siatkę wartości z tego zakresu, zaczynając od podanych współrzędnych.
`getSheets()`	`Sheet[]`	Pobiera wszystkie arkusze z tego arkusza kalkulacyjnego.
`getSpreadsheetLocale()`	`String`	Pobiera język arkusza kalkulacyjnego.
`getSpreadsheetTheme()`	`SpreadsheetTheme`	Zwraca bieżący motyw arkusza kalkulacyjnego lub `null`, jeśli nie zastosowano żadnego motywu.
`getSpreadsheetTimeZone()`	`String`	Pobiera strefę czasową arkusza kalkulacyjnego.
`getUrl()`	`String`	Zwraca adres URL danego arkusza kalkulacyjnego.
`getViewers()`	`User[]`	Pobiera listę przeglądających i komentujących dla elementu `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 określonej pozycji kolumny.
`insertColumnBefore(beforePosition)`	`Sheet`	Wstawia kolumnę przed określoną pozycją kolumny.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Wstawia podaną liczbę kolumn po określonej pozycji kolumny.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Wstawia liczbę kolumn przed określoną pozycją kolumny.
`insertDataSourceSheet(spec)`	`DataSourceSheet`	Wstawia nowy obiekt `DataSourceSheet` w arkuszu kalkulacyjnym i rozpoczyna wykonywanie kodu.
`insertImage(blobSource, column, row)`	`OverGridImage`	Wstawia obiekt `Spreadsheet` jako obraz w dokumencie w danym wierszu i kolumnie.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	Wstawia obiekt `Spreadsheet` jako obraz w dokumencie w danym wierszu i kolumnie, ze znakiem w pikselach.
`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 danej kolumnie z przesunięciem w pikselach.
`insertRowAfter(afterPosition)`	`Sheet`	Wstawia wiersz po określonej pozycji wiersza.
`insertRowBefore(beforePosition)`	`Sheet`	Wstawia wiersz przed określoną pozycją wiersza.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Wstawia liczbę wierszy po określonej pozycji wiersza.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Wstawia liczbę wierszy przed określoną pozycją wiersza.
`insertSheet()`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego z użyciem domyślnej nazwy arkusza.
`insertSheet(sheetIndex)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego o podanym indeksie.
`insertSheet(sheetIndex, options)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego o podanym indeksie i używa opcjonalnych ustawień zaawansowanych .
`insertSheet(options)`	`Sheet`	Wstawia do arkusza kalkulacyjnego nowy arkusz z użyciem domyślnej nazwy arkusza i opcjonalnych ustawień zaawansowanych .
`insertSheet(sheetName)`	`Sheet`	Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie.
`insertSheet(sheetName, sheetIndex)`	`Sheet`	Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie w podanym indeksie.
`insertSheet(sheetName, sheetIndex, options)`	`Sheet`	Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie w podanym indeksie i używa za pomocą opcjonalnych argumentów zaawansowanych.
`insertSheet(sheetName, options)`	`Sheet`	Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie i używa opcjonalnych ustawień zaawansowanych .
`insertSheetWithDataSourceTable(spec)`	`Sheet`	Wstawia nowy arkusz w arkuszu kalkulacyjnym, tworzy element `DataSourceTable` obejmujący cały arkusz z określoną specyfikacją źródła danych i rozpocznie wykonywanie danych.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Wskazuje, czy dana kolumna została ukryta przez użytkownika.
`isIterativeCalculationEnabled()`	`Boolean`	Wskazuje, czy w tym arkuszu kalkulacyjnym są włączone obliczenia iteracyjne.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Wskazuje, czy dany wiersz jest ukryty przez filtr (nie przez widok filtra).
`isRowHiddenByUser(rowPosition)`	`Boolean`	Wskazuje, czy dany wiersz został ukryty przez użytkownika.
`moveActiveSheet(pos)`	`void`	Przenosi aktywny arkusz na określoną pozycję na liście arkuszy.
`moveChartToObjectSheet(chart)`	`Sheet`	Tworzy nowy arkusz `SheetType.OBJECT` i przenosi do niego udostępniony wykres.
`refreshAllDataSources()`	`void`	Odświeża wszystkie obsługiwane źródła danych i ich połączone obiekty źródeł danych (pomija nieprawidłowe) obiektów źródła danych.
`removeEditor(emailAddress)`	`Spreadsheet`	Usuwa danego użytkownika z listy edytorów zasobu `Spreadsheet`.
`removeEditor(user)`	`Spreadsheet`	Usuwa danego użytkownika z listy edytorów zasobu `Spreadsheet`.
`removeMenu(name)`	`void`	Usuwa menu dodane przez: `addMenu(name, subMenus)`.
`removeNamedRange(name)`	`void`	Usuwa zakres nazwany o podanej nazwie.
`removeViewer(emailAddress)`	`Spreadsheet`	Usuwa dane użytkownika z listy przeglądających i komentujących `Spreadsheet`.
`removeViewer(user)`	`Spreadsheet`	Usuwa dane użytkownika z listy przeglądających i komentujących `Spreadsheet`.
`rename(newName)`	`void`	Zmienia nazwę dokumentu.
`renameActiveSheet(newName)`	`void`	Zmienia nazwę bieżącego aktywnego arkusza na określoną nową nazwę.
`resetSpreadsheetTheme()`	`SpreadsheetTheme`	Usuwa zastosowany motyw i ustawia motyw domyślny w arkuszu kalkulacyjnym.
`setActiveRange(range)`	`Range`	Ustawia określony zakres jako element `active range` w aktywnym arkuszu, przy czym lewą górną komórkę zakresu jako `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Ustawia określoną listę zakresów jako `active ranges` w aktywny arkusz.
`setActiveSelection(range)`	`Range`	Określa aktywny obszar zaznaczenia w tym arkuszu.
`setActiveSelection(a1Notation)`	`Range`	Ustawia aktywny wybór zgodnie z notacją A1 lub R1C1.
`setActiveSheet(sheet)`	`Sheet`	Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym. Możliwe jest przywrócenie najnowsze zaznaczenie w tym arkuszu.
`setColumnWidth(columnPosition, width)`	`Sheet`	Ustawia szerokość danej kolumny w pikselach.
`setCurrentCell(cell)`	`Range`	Ustawia określoną komórkę jako `current cell`.
`setFrozenColumns(columns)`	`void`	Zatrzymuje określoną liczbę kolumn.
`setFrozenRows(rows)`	`void`	Blokuje podaną liczbę wierszy.
`setIterativeCalculationConvergenceThreshold(minThreshold)`	`Spreadsheet`	Ustawia minimalną wartość progową dla obliczeń iteracyjnych.
`setIterativeCalculationEnabled(isEnabled)`	`Spreadsheet`	Określa, czy w arkuszu kalkulacyjnym mają być włączone obliczenia iteracyjne.
`setMaxIterativeCalculationCycles(maxIterations)`	`Spreadsheet`	Określa maksymalną liczbę iteracji obliczeń, które powinny zostać wykonane podczas iteracji obliczeń.
`setNamedRange(name, range)`	`void`	Nadaje zakresowi nazwę.
`setRecalculationInterval(recalculationInterval)`	`Spreadsheet`	Ustawia częstotliwość ponownego obliczania w tym arkuszu kalkulacyjnym.
`setRowHeight(rowPosition, height)`	`Sheet`	Ustawia wysokość wiersza danego wiersza w pikselach.
`setSpreadsheetLocale(locale)`	`void`	Określa język arkusza kalkulacyjnego.
`setSpreadsheetTheme(theme)`	`SpreadsheetTheme`	Ustawia motyw w arkuszu kalkulacyjnym.
`setSpreadsheetTimeZone(timezone)`	`void`	Ustawia strefę czasową dla arkusza kalkulacyjnego.
`show(userInterface)`	`void`	Wyświetla niestandardowy komponent interfejsu w oknie wyśrodkowanym w przeglądarce użytkownika widoczny obszar.
`sort(columnPosition)`	`Sheet`	Sortuje arkusz rosnąco według kolumny.
`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 daną wiadomością.
`toast(msg, title)`	`void`	W prawym dolnym rogu arkusza kalkulacyjnego wyświetla się wyskakujące okienko z podanym komunikatem tytuł.
`toast(msg, title, timeoutSeconds)`	`void`	W prawym dolnym rogu arkusza kalkulacyjnego wyświetla się wyskakujące okienko z podanym tytułem który jest widoczny przez określony czas.
`unhideColumn(column)`	`void`	Odkrywa kolumnę w podanym zakresie.
`unhideRow(row)`	`void`	Odkrywa wiersz w podanym zakresie.
`updateMenu(name, subMenus)`	`void`	Aktualizuje menu dodane przez użytkownika `addMenu(name, subMenus)`.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Oczekuje na zakończenie wszystkich bieżących wykonań w arkuszu kalkulacyjnym. Limit czasu wynosi po podana liczba sekund.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
`getSheetProtection()`	`PageProtection`	Zwraca instancję `PageProtection` opisującą uprawnienia dla bieżącego arkusza.
`isAnonymousView()`	`Boolean`	Wskazuje, czy dokument umożliwia anonimowe przeglądanie.
`isAnonymousWrite()`	`Boolean`	Wskazuje, czy dokument umożliwia edytowanie przez anonimowych użytkowników.
`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`	`void`	Ustawia zasady dokumentu dotyczące anonimowego czytania i pisania.
`setSheetProtection(permissions)`	`void`	Określa uprawnienia dla bieżącego arkusza.

Szczegółowa dokumentacja

`addDeveloperMetadata(key)`

Dodaje metadane dewelopera o podanym kluczu 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 tworzenia łańcuchów.

Autoryzacja

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

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

`addDeveloperMetadata(key, visibility)`

Dodaje do arkusza kalkulacyjnego metadane dewelopera o określonym kluczu 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 tworzenia łańcuchów.

Autoryzacja

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

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

`addDeveloperMetadata(key, value)`

Dodaje do arkusza kalkulacyjnego metadane dewelopera o określonym kluczu 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 tworzenia łańcuchów.

Autoryzacja

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

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

`addDeveloperMetadata(key, value, visibility)`

Dodaje do arkusza kalkulacyjnego metadane dewelopera o określonym kluczu, 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 tworzenia łańcuchów.

Autoryzacja

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

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

`addEditor(emailAddress)`

Dodaje danego użytkownika do listy edytorów zasobu Spreadsheet. Jeśli użytkownik był już na liście widzów, ta metoda wycofuje użytkownika z listy widzów.

Parametry

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

Powrót

Spreadsheet – Spreadsheet do łańcuchów.

Autoryzacja

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

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

`addEditor(user)`

Dodaje danego użytkownika do listy edytorów zasobu Spreadsheet. Jeśli użytkownik był już na liście widzów, ta metoda wycofuje użytkownika z listy widzów.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika, który ma zostać dodany.

Powrót

Spreadsheet – Spreadsheet do łańcuchów.

Autoryzacja

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

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

`addEditors(emailAddresses)`

Dodaje podaną tablicę użytkowników do listy edytorów zasobu Spreadsheet. Jeśli któryś z Użytkownicy byli już na liście widzów, więc ta metoda powoduje wyeliminowanie ich z listy widzów.

Parametry

Nazwa	Typ	Opis
`emailAddresses`	`String[]`	Tablica adresów e-mail użytkowników do dodania.

Powrót

Spreadsheet – Spreadsheet do łańcuchów.

Autoryzacja

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

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

`addMenu(name, subMenus)`

Tworzy nowe menu w interfejsie arkusza kalkulacyjnego.

Każda pozycja menu uruchamia funkcję zdefiniowaną przez użytkownika. Zwykle najlepiej jest wywołać je za pomocą funkcji onOpen(), aby menu było tworzone automatycznie podczas wczytywania 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 uwzględnionych bibliotek, np. `Library.libFunction1`.

Autoryzacja

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

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

`addViewer(emailAddress)`

Dodaje danego użytkownika do listy przeglądających w: Spreadsheet. Jeśli użytkownik był już na liście redaktorów, ta metoda nie będzie działać.

Parametry

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

Powrót

Spreadsheet – Spreadsheet do łańcuchów.

Autoryzacja

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

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

`addViewer(user)`

Dodaje danego użytkownika do listy przeglądających w: Spreadsheet. Jeśli użytkownik był już na liście redaktorów, ta metoda nie będzie działać.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika, który ma zostać dodany.

Powrót

Spreadsheet – Spreadsheet do łańcuchów.

Autoryzacja

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

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

`addViewers(emailAddresses)`

Dodaje podaną tablicę użytkowników do listy przeglądających obiekt Spreadsheet. Jeśli któryś z Użytkownicy byli już na liście edytorów, ta metoda nie ma u nich żadnego efektu.

Parametry

Nazwa	Typ	Opis
`emailAddresses`	`String[]`	Tablica adresów e-mail użytkowników do dodania.

Powrót

Spreadsheet – Spreadsheet do łańcuchów.

Autoryzacja

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

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

`appendRow(rowContents)`

Dodaje wiersz na dole bieżącego regionu danych w arkuszu. Jeśli rozpoczyna się zawartość komórki dla funkcji =, jest ona interpretowana jako wzór.

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

Powrót

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`autoResizeColumn(columnPosition)`

Określa szerokość danej kolumny zgodnie z jej zawartością.

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

sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Pozycja danej kolumny, której rozmiar ma zostać zmieniony.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`copy(name)`

Skopiowanie arkusza kalkulacyjnego i zwrócenie nowego.

// 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 tworzenia łańcuchów.

Autoryzacja

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

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

`createDeveloperMetadataFinder()`

Zwraca DeveloperMetadataFinder w przypadku znalezienia metadanych dewelopera w zakresie ten arkusz kalkulacyjny. Domyślnie uwzględniane są wszystkie metadane powiązane z arkuszem kalkulacyjnym, arkusze, wiersze i kolumny.

// 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 służąca do wyszukiwania metadanych w zakresie tego arkusza kalkulacyjnego.

`createTextFinder(findText)`

Tworzy wyszukiwarkę tekstu dla arkusza kalkulacyjnego, która może służyć do wyszukiwania i zastępowania tekstu w obrębie arkusza w arkuszu kalkulacyjnym. Wyszukiwanie rozpoczyna się od pierwszego arkusza w arkuszu kalkulacyjnym.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

// Creates  a text finder.
var textFinder = spreadsheet.createTextFinder('dog');

// Returns the first occurrence of 'dog' in the spreadsheet.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = findOccurrence.replaceWith('cat');

Parametry

Nazwa	Typ	Opis
`findText`	`String`	Tekst do wyszukania.

Powrót

TextFinder – pole 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`deleteColumn(columnPosition)`

Usuwa kolumnę 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, zaczynająca się od 1 w pierwszej kolumnie.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`deleteColumns(columnPosition, howMany)`

Usuwa określoną liczbę kolumn, zaczynając od danej pozycji.

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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`deleteRow(rowPosition)`

Usuwa wiersz na danej pozycji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja wiersza, zaczynająca się od 1 w pierwszym wierszu.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`deleteRows(rowPosition, howMany)`

Usuwa liczbę wierszy, zaczynając od danej pozycji.

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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`deleteSheet(sheet)`

Usuwa określony arkusz.

// The code below deletes the specified sheet.
var ss = SpreadsheetApp.getActive();
var sheet = ss.getSheetByName('My Sheet');
ss.deleteSheet(sheet);

Parametry

Nazwa	Typ	Opis
`sheet`	`Sheet`	Arkusz do usunięcia.

Autoryzacja

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

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

`duplicateActiveSheet()`

Powiela aktywny arkusz i ustawia go jako aktywny.

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

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`getActiveCell()`

Zwraca aktywną komórkę w tym arkuszu.

Uwaga: zalecamy użycie getCurrentCell(), która zwraca bieżącą zaznaczoną 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getActiveRange()`

Zwraca wybrany zakres w aktywnym arkuszu lub null, jeśli nie ma aktywnego zakresu. Jeśli wybrano wiele zakresów. Ta metoda zwraca tylko ostatnio wybrany zakres.

Termin „aktywny zakres” odnosi się do zakresu wybranego przez użytkownika w aktywnym arkuszu, a 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też

setActiveRange(range)

`getActiveRangeList()`

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

Jeśli wybierzesz 1 zakres, ta operacja będzie działać jak wywołanie getActiveRange().

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

Powrót

RangeList – lista aktywnych zakresów

Autoryzacja

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

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

Zobacz też

setActiveRangeList(rangeList)

`getActiveSheet()`

Pobiera aktywny arkusz w arkuszu kalkulacyjnym.

Aktywny arkusz w arkuszu kalkulacyjnym to arkusz wyświetlany w arkuszu kalkulacyjnym. Interfejs.

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

Powrót

Sheet – aktywny arkusz w arkuszu kalkulacyjnym.

`getAs(contentType)`

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ten dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mojplik.pdf”. Jednak zakłada, że część nazwy pliku, która następuje po ostatnim kropce (jeśli występuje), jest już , które należy zastąpić. W rezultacie „ShoppingList.12.25.2014” zmienia się w „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zobacz Limity dla Google Usługi. Nowo utworzone domeny Google Workspace mogą być tymczasowo bardziej rygorystyczne limity.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME do skonwertowania. W przypadku większości blobów atrybut `'application/pdf'` to jedyną prawidłową opcją. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG możesz też użyć dowolnego z tych atrybutów: `'image/bmp'`, `'image/gif'`, `'image/jpeg'` lub `'image/png'`. prawidłowe. W przypadku dokumentów w Dokumentach Google prawidłowa jest też wartość `'text/markdown'`.

Powrót

Blob – dane w postaci obiektu blob.

`getBandings()`

Zwraca wszystkie pasma w tym arkuszu kalkulacyjnym.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets an array of the bandings in the spreadsheet.
const bandings = ss.getBandings();

// Logs the range of the first banding in the spreadsheet to the console.
console.log(bandings[0].getRange().getA1Notation());

Powrót

Banding[] – pasma w tym arkuszu kalkulacyjnym.

Autoryzacja

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

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

`getBlob()`

Zwraca dane wewnątrz tego obiektu jako obiekt blob.

Powrót

Blob – dane w postaci obiektu blob.

`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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getCurrentCell()`

Zwraca bieżącą komórkę w aktywnym arkuszu lub null, jeśli nie ma bieżącej komórki. bieżąca komórka to komórka podświetlona w interfejsie Arkuszy Google i podświetlona obramowania. Bieżąca komórka nie może być więcej niż 1 komórka. Gdy użytkownik wybierze co najmniej jeden zakres komórek, jedna z zaznaczonych komórek jest bieżącą komórką.

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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getDataRange()`

Zwraca wartość Range odpowiadającą wymiarom zawierającym dane.

Jest to odpowiednik tworzenia zakresu ograniczonego przez wartości 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getDataSourceFormulas()`

Pobiera wszystkie formuły źródła 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ódła danych.

Autoryzacja

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

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

`getDataSourcePivotTables()`

Pobiera wszystkie tabele przestawne źródła danych.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Powrót

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

Autoryzacja

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

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

`getDataSourceRefreshSchedules()`

Pobiera harmonogramy odświeżania tego arkusza kalkulacyjnego.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Activates BigQuery operations for the connected spreadsheet.
SpreadsheetApp.enableBigQueryExecution();

// Gets the frequency type of the first referesh schedule in the array.
const frequencyType = ss.getDataSourceRefreshSchedules()[0]
                        .getFrequency()
                        .getFrequencyType()
                        .toString();

// Logs the frequency type to the console.
console.log(frequencyType);

Powrót

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

Autoryzacja

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

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

`getDataSourceSheets()`

Zwraca wszystkie arkusze źródeł danych w arkuszu kalkulacyjnym.

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the first data source sheet in the spreadsheet.
const dataSource = ss.getDataSourceSheets()[0];

// Gets the name of the data source sheet.
console.log(dataSource.asSheet().getName());

Powrót

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

Autoryzacja

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

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

`getDataSourceTables()`

Pobiera wszystkie tabele źródeł danych.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

Powrót

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

Autoryzacja

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

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

`getDataSources()`

Zwraca wszystkie źródła danych w arkuszu kalkulacyjnym.

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the data sources on the spreadsheet.
const dataSources = ss.getDataSources();

// Logs the name of the first column on the first data source.
console.log(dataSources[0].getColumns()[0].getName());

Powrót

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

Autoryzacja

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

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

`getDeveloperMetadata()`

Pobiera metadane dewelopera powiązane z arkuszem kalkulacyjnym najwyższego poziomu.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds 'Google' as a key to the spreadsheet metadata.
ss.addDeveloperMetadata('Google');

// Gets the spreadsheet's metadata.
const ssMetadata = ss.getDeveloperMetadata();

// Gets the first set of the spreadsheet's metadata and logs the key to the console.
console.log(ssMetadata[0].getKey());

Powrót

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

Autoryzacja

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

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

`getEditors()`

Pobiera listę edytorów elementu Spreadsheet.

Powrót

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

Autoryzacja

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

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

`getFormUrl()`

Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza kalkulacyjnego, lub null, jeśli ten arkusz kalkulacyjny nie ma powiązanego formularza. Jeśli wiele formularzy wysyła odpowiedzi do tego arkusza kalkulacyjnego, zwracany adres URL formularza jest nieokreślony. Alternatywnie powiązania adresów URL formularzy w arkuszu mogą pobierany jest 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, w którym odpowiedzi są umieszczane w tym arkuszu kalkulacyjnym, lub null, jeśli: ten arkusz kalkulacyjny nie ma powiązanego formularza.

Autoryzacja

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

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

`getFrozenColumns()`

Zwraca liczbę zablokowanych kolumn.

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

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

Powrót

Integer – liczba zablokowanych kolumn

Autoryzacja

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

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

`getFrozenRows()`

Zwraca liczbę zablokowanych wierszy.

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

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

Powrót

Integer – liczba zablokowanych wierszy.

Autoryzacja

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

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

`getId()`

Pobiera unikalny identyfikator tego arkusza kalkulacyjnego. Identyfikator arkusza kalkulacyjnego można wyodrębnić z jego adresu URL. Na przykład identyfikator arkusza kalkulacyjnego w adresie URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 to „abc1234567”.

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

Powrót

String – unikalny identyfikator (lub klucz) arkusza kalkulacyjnego.

`getImages()`

Zwraca wszystkie obrazy 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getIterativeCalculationConvergenceThreshold()`

Zwraca wartość progową używaną podczas obliczeń iteracyjnych. Gdy wyniki kolejnych działań obliczenia różnią się o mniejszą od tej wartości, obliczenia iteracyjne zatrzymują się.

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

Autoryzacja

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

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

`getLastColumn()`

Zwraca pozycję ostatniej kolumny, która zawiera treść.

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

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Powrót

Integer – ostatnia kolumna arkusza zawierającego treść

Autoryzacja

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

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

`getLastRow()`

Zwraca pozycję ostatniego wiersza, który zawiera treść.

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

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Powrót

Integer – ostatni wiersz arkusza zawierającego treść;

Autoryzacja

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

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

`getMaxIterativeCalculationCycles()`

Zwraca maksymalną liczbę iteracji używanych 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getName()`

Pobiera nazwę dokumentu.

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

Powrót

String – nazwa arkusza kalkulacyjnego.

Autoryzacja

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

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

`getNamedRanges()`

Pobiera wszystkie zakresy nazwane z tego arkusza kalkulacyjnego.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  Logger.log(namedRanges[i].getName());
}

Powrót

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

Autoryzacja

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

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

`getNumSheets()`

Zwraca liczbę arkuszy w danym 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 jest na dysku współdzielonym.

Autoryzacja

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

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

`getPredefinedSpreadsheetThemes()`

Zwraca listę wstępnie zdefiniowanych motywów.

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

Powrót

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

Autoryzacja

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

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

`getProtections(type)`

Pobiera tablicę obiektów reprezentujących wszystkie chronione zakresy lub arkusze w arkuszu kalkulacyjnym.

// Remove all range protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Remove all sheet protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

Parametry

Nazwa	Typ	Opis
`type`	`ProtectionType`	Typ obszaru chronionego: `SpreadsheetApp.ProtectionType.RANGE` lub `SpreadsheetApp.ProtectionType.SHEET`

Powrót

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

Autoryzacja

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

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

`getRange(a1Notation)`

Zwraca zakres podany 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 notacji R1C1.

Powrót

Range – zakres w wyznaczonym miejscu

Autoryzacja

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

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

`getRangeByName(name)`

Zwraca zakres nazwany lub null, jeśli nie znaleziono żadnego zakresu o podanej nazwie. Jeśli kilka arkusze arkusza kalkulacyjnego używają tej samej nazwy zakresu, określ nazwę arkusza bez dodatkowych cudzysłowów – na przykład getRangeByName('TaxRates') lub getRangeByName('Sheet Name!TaxRates'), ale nie getRangeByName('"Sheet Name"!TaxRates').

// Log the number of columns for the range named 'TaxRates' in the active spreadsheet.
var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates');
if (range != null) {
  Logger.log(range.getNumColumns());
}

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa zakresu do pobrania.

Powrót

Range – zakres komórek o podanej nazwie.

`getRangeList(a1Notations)`

Zwraca kolekcję RangeList reprezentującą zakresy w tym samym określonym arkuszu możesz użyć niepustej listy notacji A1 lub notacji R1C1.

// Get a list of ranges A1:D4, F1:H4.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var rangeList  = sheet.getRangeList(['A1:D4', 'F1:H4']);

Parametry

Nazwa	Typ	Opis
`a1Notations`	`String[]`	Lista zakresów do zwrócenia, zgodnie z zapisem A1 lub notacją R1C1.

Powrót

RangeList – lista zakresów w wybranej lokalizacji

Autoryzacja

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

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

`getRecalculationInterval()`

Zwraca interwał obliczeń 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 – odstęp obliczeń dla tego arkusza kalkulacyjnego.

Autoryzacja

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

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

`getRowHeight(rowPosition)`

Pobiera wysokość danego wiersza w pikselach.

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

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja sprawdzanego wiersza.

Powrót

Integer – wysokość wiersza w pikselach

Autoryzacja

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

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

`getSelection()`

Zwraca bieżącą Selection z arkusza kalkulacyjnego.

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

Powrót

Selection – bieżący wybór

Autoryzacja

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

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

`getSheetByName(name)`

Zwraca arkusz o podanej nazwie.

Jeśli wiele arkuszy ma tę samą nazwę, zwracany jest ten, który znajduje się najbardziej po lewej stronie. 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 podanej nazwie.

`getSheetId()`

Zwraca identyfikator arkusza reprezentowanego przez ten obiekt.

Jest to unikalny identyfikator arkusza. Identyfikator jest monotonicznie rosnąca liczba całkowita przypisana podczas tworzenia arkusza, niezależna od pozycji arkusza. Ten jest przydatny w połączeniu z metodami takimi jak Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd), które przyjmują parametr gridId, a nie wystąpienie Sheet.

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

Logger.log(sheet.getSheetId());

Powrót

Integer – unikalny identyfikator arkusza;

Autoryzacja

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

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

`getSheetName()`

Zwraca nazwę arkusza.

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

Logger.log(sheet.getSheetName());

Powrót

String – nazwa arkusza,

Autoryzacja

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

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

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

Zwraca prostokątną siatkę wartości z tego zakresu, zaczynając od podanych współrzędnych. A -1 wartość podana jako pozycja wiersza lub kolumny jest równoważna z uzyskaniem ostatniego wiersza lub kolumny , który zawiera dane w arkuszu.

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

// The two samples below produce the same output
var values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

var range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

Parametry

Nazwa	Typ	Opis
`startRow`	`Integer`	Pozycja wiersza początkowego.
`startColumn`	`Integer`	Pozycja kolumny początkowej.
`numRows`	`Integer`	Liczba wierszy, dla których zostaną zwrócone wartości.
`numColumns`	`Integer`	Liczba kolumn, dla których zostaną zwrócone wartości.

Powrót

Object[][] – dwuwymiarowa tablica wartości.

Autoryzacja

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

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

`getSheets()`

Pobiera wszystkie arkusze z tego arkusza kalkulacyjnego.

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

Powrót

Sheet[] – tablica wszystkich arkuszy w arkuszu kalkulacyjnym.

`getSpreadsheetLocale()`

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

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Powrót

String – język arkusza kalkulacyjnego.

Autoryzacja

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

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

`getSpreadsheetTheme()`

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

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

Powrót

SpreadsheetTheme – aktualnie stosowany motyw.

Autoryzacja

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

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

`getSpreadsheetTimeZone()`

Pobiera strefę czasową arkusza kalkulacyjnego.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Powrót

String – strefa czasowa podana w polu „long” (długie). (np. „Ameryka/Nowy_Jork”, jak podano w autor: Joda.org).

Autoryzacja

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

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

`getUrl()`

Zwraca adres URL danego arkusza kalkulacyjnego.

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

Powrót

String – adres URL danego arkusza kalkulacyjnego.

Autoryzacja

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

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

`getViewers()`

Pobiera listę przeglądających i komentujących dla elementu Spreadsheet.

Powrót

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

Autoryzacja

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

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

`hideColumn(column)`

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

Autoryzacja

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

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

`hideRow(row)`

Ukrywa wiersze w 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`insertColumnAfter(afterPosition)`

Wstawia kolumnę po określonej pozycji kolumny.

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

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

Parametry

Nazwa	Typ	Opis
`afterPosition`	`Integer`	Kolumna, po której ma zostać dodana nowa kolumna.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`insertColumnBefore(beforePosition)`

Wstawia kolumnę przed określoną 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ą chcesz dodać nową kolumnę.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`insertColumnsAfter(afterPosition, howMany)`

Wstawia podaną liczbę kolumn po określonej pozycji kolumny.

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

// Inserts two columns after the first column on the first sheet of the spreadsheet.
sheet.insertColumnsAfter(1,2);

Parametry

Nazwa	Typ	Opis
`afterPosition`	`Integer`	Kolumna, po której ma zostać dodana nowa kolumna.
`howMany`	`Integer`	Liczba kolumn do wstawienia.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`insertColumnsBefore(beforePosition, howMany)`

Wstawia liczbę kolumn przed określoną 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ą chcesz dodać nową kolumnę.
`howMany`	`Integer`	Liczba kolumn do wstawienia.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`insertDataSourceSheet(spec)`

Wstawia nowy obiekt DataSourceSheet w arkuszu kalkulacyjnym i rozpoczyna wykonywanie kodu. Jako efekt uboczny sprawia, że nowy arkusz staje się aktywny.

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution(), aby włączyć wykonywanie kodu dla określonego źródła danych typu.

// 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, za pomocą której chcesz wstawić dane.

Powrót

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

Autoryzacja

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

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

`insertImage(blobSource, column, row)`

Wstawia obiekt Spreadsheet jako obraz w dokumencie w danym wierszu i kolumnie. Obraz rozmiar jest pobierany z zawartości obiektu blob. Maksymalny obsługiwany rozmiar bloba to 2 MB.

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

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

Parametry

Nazwa	Typ	Opis
`blobSource`	`BlobSource`	Obiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę.
`column`	`Integer`	Pozycja kolumny.
`row`	`Integer`	Pozycja wiersza.

Powrót

OverGridImage – wstawiony obraz.

Autoryzacja

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

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

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

Wstawia obiekt Spreadsheet jako obraz w dokumencie w danym wierszu i kolumnie, ze znakiem w pikselach. Rozmiar obrazu jest pobierany z zawartości obiektu blob. Maksymalny obsługiwany obiekt blob Rozmiar pliku to 2MB.

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

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parametry

Nazwa	Typ	Opis
`blobSource`	`BlobSource`	Obiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę.
`column`	`Integer`	Pozycja kolumny.
`row`	`Integer`	Pozycja wiersza.
`offsetX`	`Integer`	Odsunięcie w poziomie od rogu komórki w pikselach.
`offsetY`	`Integer`	Odsunięcie w pionie od rogu komórki w pikselach.

Powrót

OverGridImage – wstawiony obraz.

Autoryzacja

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

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

`insertImage(url, column, row)`

Wstawia obraz w dokumencie w danym wierszu i kolumnie.

Podany adres URL musi być publicznie dostępny.

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

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);

Parametry

Nazwa	Typ	Opis
`url`	`String`	Adres URL obrazu.
`column`	`Integer`	Pozycja kolumny siatki.
`row`	`Integer`	Pozycja wiersza siatki.

Powrót

OverGridImage – wstawiony obraz.

Autoryzacja

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

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

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

Wstawia obraz w dokumencie w danym wierszu i danej kolumnie z przesunięciem w pikselach.

Podany adres URL musi być publicznie dostępny.

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

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);

Parametry

Nazwa	Typ	Opis
`url`	`String`	Adres URL obrazu.
`column`	`Integer`	Pozycja kolumny.
`row`	`Integer`	Pozycja wiersza.
`offsetX`	`Integer`	Odsunięcie w poziomie od rogu komórki w pikselach.
`offsetY`	`Integer`	Odsunięcie w pionie od rogu komórki w pikselach.

Powrót

OverGridImage – wstawiony obraz.

Autoryzacja

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

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

`insertRowAfter(afterPosition)`

Wstawia wiersz po określonej 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 chcesz dodać nowy wiersz.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`insertRowBefore(beforePosition)`

Wstawia wiersz przed określoną 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 chcesz dodać nowy wiersz.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`insertRowsAfter(afterPosition, howMany)`

Wstawia liczbę wierszy po określonej pozycji wiersza.

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

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

Parametry

Nazwa	Typ	Opis
`afterPosition`	`Integer`	Wiersz, po którym mają zostać dodane nowe wiersze.
`howMany`	`Integer`	Liczba wierszy do wstawienia.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`insertRowsBefore(beforePosition, howMany)`

Wstawia liczbę wierszy przed określoną 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, w którym chcesz dodać nowe wiersze.
`howMany`	`Integer`	Liczba wierszy do wstawienia.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`insertSheet()`

Wstawia nowy arkusz do arkusza kalkulacyjnego z użyciem domyślnej nazwy arkusza. Nowy arkusz stanie się aktywny arkusz.

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

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetIndex)`

Wstawia nowy arkusz do arkusza kalkulacyjnego o podanym indeksie. Nowy arkusz stanie się aktywny arkusza kalkulacyjnego.

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

Parametry

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

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetIndex, options)`

Wstawia nowy arkusz do arkusza kalkulacyjnego o podanym indeksie i używa opcjonalnych ustawień zaawansowanych . Nowy arkusz stanie się arkuszem aktywnym.

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 ustaw wartość 0 w arkuszu kalkulacyjnym.
`options`	`Object`	Opcjonalne zaawansowane argumenty JavaScript.

Parametry zaawansowane

Nazwa	Typ	Opis
`template`	`Sheet`	Wszystkie dane z obiektu arkusza szablonu są kopiowane do nowy arkusz. Szablon arkusza musi być jednym z arkuszy obiektu Arkusza kalkulacyjnego.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(options)`

Wstawia do arkusza kalkulacyjnego nowy arkusz z użyciem domyślnej nazwy arkusza i opcjonalnych ustawień zaawansowanych . Nowy arkusz stanie się arkuszem aktywnym.

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

Parametry

Nazwa	Typ	Opis
`options`	`Object`	Opcjonalne zaawansowane argumenty JavaScriptu wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
`template`	`Sheet`	Wszystkie dane z obiektu arkusza szablonu są kopiowane do nowy arkusz. Szablon arkusza musi być jednym z arkuszy tego obiektu arkusza kalkulacyjnego.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetName)`

Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie. Nowy arkusz stanie się aktywny arkusza kalkulacyjnego.

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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`insertSheet(sheetName, sheetIndex)`

Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie w podanym indeksie. Nowy arkusz stanie się arkuszem aktywnym.

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 ustaw wartość 0 w arkuszu kalkulacyjnym.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetName, sheetIndex, options)`

Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie w podanym indeksie i używa za pomocą opcjonalnych argumentów zaawansowanych. Nowy arkusz stanie się arkuszem aktywnym.

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 dla arkusza kalkulacyjnego ustaw wartość 0.
`options`	`Object`	Opcjonalne zaawansowane argumenty JavaScript.

Parametry zaawansowane

Nazwa	Typ	Opis
`template`	`Sheet`	Wszystkie dane z obiektu arkusza szablonu są kopiowane do nowy arkusz. Szablon arkusza musi być jednym z arkuszy obiektu Arkusza kalkulacyjnego.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheet(sheetName, options)`

Wstawia do arkusza kalkulacyjnego nowy arkusz o podanej nazwie i używa opcjonalnych ustawień zaawansowanych . Nowy arkusz stanie się arkuszem aktywnym.

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

Parametry zaawansowane

Nazwa	Typ	Opis
`template`	`Sheet`	Wszystkie dane z obiektu arkusza szablonu są kopiowane do nowy arkusz. Szablon arkusza musi być jednym z arkuszy obiektu Arkusza kalkulacyjnego.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`insertSheetWithDataSourceTable(spec)`

Wstawia nowy arkusz w arkuszu kalkulacyjnym, tworzy element DataSourceTable obejmujący cały arkusz z określoną specyfikacją źródła danych i rozpocznie wykonywanie danych. Jako strona sprawia, że nowy arkusz staje się arkuszem aktywnym.

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution(), aby włączyć wykonywanie kodu dla określonego źródła danych typu.

// 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, za pomocą której chcesz wstawić dane.

Powrót

Sheet – nowy arkusz.

Autoryzacja

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

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

`isColumnHiddenByUser(columnPosition)`

Wskazuje, czy dana kolumna została 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, lub false, jeśli jest ukryta.

Autoryzacja

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

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

`isIterativeCalculationEnabled()`

Wskazuje, czy w tym arkuszu kalkulacyjnym są włączone obliczenia iteracyjne.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Powrót

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

Autoryzacja

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

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

`isRowHiddenByFilter(rowPosition)`

Wskazuje, czy dany wiersz jest ukryty przez filtr (nie przez widok filtra).

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja sprawdzanego wiersza.

Powrót

Boolean – true, jeśli wiersz jest ukryty, lub false, jeśli jest ukryty.

Autoryzacja

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

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

`isRowHiddenByUser(rowPosition)`

Wskazuje, czy dany wiersz został 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 sprawdzanego wiersza.

Powrót

Boolean – true, jeśli wiersz jest ukryty, lub false, jeśli jest ukryty.

Autoryzacja

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

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

`moveActiveSheet(pos)`

Przenosi aktywny arkusz na określoną pozycję na liście arkuszy. Zgłasza wyjątek, jeśli pozycja jest ujemna lub większa niż liczba arkuszy.

// This example assumes that there are 2 sheets in the current
// active spreadsheet: one named "first" in position 1 and another named "second"
// in position 2.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Gets the "first" sheet and activates it.
var sheet = spreadsheet.getSheetByName("first").activate();

// Logs 'Current index of sheet: 1'
console.log("Current index of sheet: %s", sheet.getIndex());

spreadsheet.moveActiveSheet(2);

// Logs 'New index of sheet: 2'
console.log("New index of sheet: %s", sheet.getIndex());

Parametry

Nazwa	Typ	Opis
`pos`	`Integer`	Pozycja 1 indeksu, na którą ma zostać przeniesiony aktywny arkusz na liście arkuszy.

Autoryzacja

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

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

`moveChartToObjectSheet(chart)`

Tworzy nowy arkusz SheetType.OBJECT i przenosi do niego udostępniony wykres. Jeśli wykres jest już w osobnym arkuszu, zostanie on zwrócony bez utworzenia nowego.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.newChart().setPosition(1, 1, 0, 0).build();
sheet.insertChart(chart);
var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);

Parametry

Nazwa	Typ	Opis
`chart`	`EmbeddedChart`	Wykres do przeniesienia.

Powrót

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

Autoryzacja

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

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

`refreshAllDataSources()`

Odświeża wszystkie obsługiwane źródła danych i ich połączone obiekty źródeł danych (pomija nieprawidłowe) obiektów źródła danych.

Użyj metod SpreadsheetApp#enable...Execution(), aby włączyć wykonywanie kodu dla: określonego typu źródła danych.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the first data source sheet on the spreadsheet.
const dataSheet = ss.getDataSourceSheets()[0];

// Refreshes all data sources on the spreadsheet.
ss.refreshAllDataSources();

// Logs the last refreshed time of the first data source sheet.
console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);

Autoryzacja

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

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

`removeEditor(emailAddress)`

Usuwa danego użytkownika z listy edytorów zasobu Spreadsheet. Ta metoda nie: zablokuj dostęp do usługi Spreadsheet użytkownikom, którzy należą do klasy użytkowników, którzy ogólny dostęp – na przykład jeśli domena Spreadsheet jest udostępniona całej domenie domeny 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 też usunięcie użytkownika z listy przeglądających.

Parametry

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

Powrót

Spreadsheet – Spreadsheet do łańcuchów.

Autoryzacja

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

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

`removeEditor(user)`

W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy przeglądających.

Parametry

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

Powrót

Spreadsheet – Spreadsheet do łańcuchów.

Autoryzacja

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

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

`removeMenu(name)`

Usuwa menu dodane przez: addMenu(name, subMenus). Argument name powinno mieć taką samą wartość jak odpowiednie 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`removeNamedRange(name)`

Usuwa zakres nazwany o podanej nazwie. Zgłasza wyjątek, jeśli nie ma zakresu o podanej nazwie znajduje się w arkuszu kalkulacyjnym.

// 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`removeViewer(emailAddress)`

Usuwa dane użytkownika z listy przeglądających i komentujących Spreadsheet. Ten nie ma zastosowania, jeśli użytkownik jest edytującym, a nie przeglądającym lub komentującym. Ta metoda również Nie blokuje dostępu do elementu Spreadsheet użytkownikom, którzy należą do klasy użytkowników, mieć ogólny dostęp – na przykład jeśli domena Spreadsheet została udostępniona domenie całej domeny 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 też usunięcie użytkownika z listy redaktorów.

Parametry

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

Powrót

Spreadsheet – Spreadsheet do tworzenia łańcuchów.

Autoryzacja

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

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

`removeViewer(user)`

Usuwa dane użytkownika z listy przeglądających i komentujących Spreadsheet. Ten nie ma zastosowania, jeśli użytkownik jest edytorem, a nie przeglądającym. Ta metoda nie blokuje też dostępu do funkcji Spreadsheet przez użytkowników, jeśli należą do klasy użytkowników, którzy mają ogólne warunki dostępu – na przykład jeśli element Spreadsheet został 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 też usunięcie użytkownika z listy redaktorów.

Parametry

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

Powrót

Spreadsheet – Spreadsheet do tworzenia łańcuchów.

Autoryzacja

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

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

`rename(newName)`

Zmienia nazwę dokumentu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.rename("This is the new name");

Parametry

Nazwa	Typ	Opis
`newName`	`String`	Nowa nazwa dokumentu.

Autoryzacja

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

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

`renameActiveSheet(newName)`

Zmienia nazwę bieżącego aktywnego arkusza na określoną nową nazwę.

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

Parametry

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

Autoryzacja

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

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

`resetSpreadsheetTheme()`

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

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

Powrót

SpreadsheetTheme – motyw domyślny.

Autoryzacja

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

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

`setActiveRange(range)`

Ustawia określony zakres jako element active range w aktywnym arkuszu, przy czym lewą górną komórkę zakresu jako 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.

Powrót

Range – nowo aktywny zakres.

Autoryzacja

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

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

`setActiveRangeList(rangeList)`

Ustawia określoną listę zakresów jako active ranges w aktywny arkusz. Ostatni zakres na liście to active range.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
sheet.setActiveRangeList(rangeList);

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

Parametry

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

Powrót

RangeList – nowo wybrana lista zakresów.

Autoryzacja

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

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

`setActiveSelection(range)`

Określa aktywny obszar zaznaczenia w tym arkuszu.

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

var range = sheet.getRange("A1:D4");
sheet.setActiveSelection(range);

Parametry

Nazwa	Typ	Opis
`range`	`Range`	Zakres do ustawienia jako aktywny.

Powrót

Range – nowo aktywny zakres.

Autoryzacja

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

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

`setActiveSelection(a1Notation)`

Ustawia aktywny wybór 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 zostać ustawiony jako aktywny, określony w notacji A1 lub R1C1.

Powrót

Range – nowo aktywny zakres.

Autoryzacja

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

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

`setActiveSheet(sheet)`

Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym. Wyświetli się interfejs Arkuszy Google wybranego arkusza, 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 zostać ustawiony jako aktywny.

Powrót

Sheet – aktywny arkusz.

Autoryzacja

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

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

`setActiveSheet(sheet, restoreSelection)`

Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym. Możliwe jest przywrócenie najnowsze zaznaczenie w tym arkuszu. Interfejs Arkuszy Google wyświetla wybrany arkusz, chyba że ponieważ arkusz należy 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`	Tf `true`, ostatni wybór nowego aktywnego arkusza zostanie zaznaczony ponownie w miarę uaktywnienia nowego arkusza. jeśli `false`, nowy arkusz stanie się aktywne bez zmiany bieżącego wyboru.

Powrót

Sheet – nowy aktywny arkusz.

Autoryzacja

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

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

`setColumnWidth(columnPosition, width)`

Ustawia szerokość danej kolumny w pikselach.

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

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(1, 200);

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Pozycja danej kolumny do ustawienia.
`width`	`Integer`	Szerokość w pikselach, jaka ma być używana.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`setCurrentCell(cell)`

Ustawia określoną komórkę jako current cell.

Jeśli określona komórka znajduje się w już wybranym zakresie, aktywny zakres z komórką bieżącą komórką.

Jeśli określonej komórki nie ma w żadnym wybranym zakresie, wszelkie istniejące zaznaczenie jest zostanie usunięta, a komórka stanie się bieżącą komórką i aktywnym zakresem.

Uwaga: określony Range musi składać się z jednej komórki. W przeciwnym razie zwraca 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.

Powrót

Range – nowo ustawiona komórka,

Autoryzacja

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

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

`setFrozenColumns(columns)`

Zatrzymuje określoną liczbę kolumn. Jeśli wartość wynosi zero, żadne kolumny nie są zablokowane.

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

// Freezes the first column
sheet.setFrozenColumns(1);

Parametry

Nazwa	Typ	Opis
`columns`	`Integer`	Liczba kolumn do zablokowania.

Autoryzacja

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

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

`setFrozenRows(rows)`

Blokuje podaną liczbę wierszy. Jeśli zero, żadne wiersze nie są zablokowane.

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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setIterativeCalculationConvergenceThreshold(minThreshold)`

Ustawia minimalną wartość progową dla obliczeń iteracyjnych. Gdy wyniki kolejnych działań obliczenia różnią się o mniejszą od tej wartości, obliczenia iteracyjne zatrzymują się. Ta wartość musi być nieujemna, a domyślna wartość to 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 (nie może być liczbą ujemną).

Powrót

Spreadsheet – ten arkusz kalkulacyjny do tworzenia łańcuchów.

Autoryzacja

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

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

`setIterativeCalculationEnabled(isEnabled)`

Określa, czy w arkuszu kalkulacyjnym mają być włączone obliczenia iteracyjne. Jeśli maksymalna liczba cykle obliczeniowe i próg zbieżności nie zostały wcześniej ustawione, gdy obliczenia jest włączona, domyślne wartości to odpowiednio 50 i 0,05. Jeśli któraś z nich została już wcześniej ustawiona, zachowywanie poprzednich wartości.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Parametry

Nazwa	Typ	Opis
`isEnabled`	`Boolean`	`true`, jeśli powinno być włączone obliczenia iteracyjne; `false` w przeciwnym razie.

Powrót

Spreadsheet – ten arkusz kalkulacyjny do tworzenia łańcuchów.

Autoryzacja

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

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

`setMaxIterativeCalculationCycles(maxIterations)`

Określa maksymalną liczbę iteracji obliczeń, które powinny zostać wykonane podczas iteracji obliczeń. Ta wartość musi mieścić się w przedziale od 1 do 10 000 (włącznie), a domyślna wartość 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 000).

Powrót

Spreadsheet – ten arkusz kalkulacyjny do tworzenia łańcuchów.

Autoryzacja

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

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

`setNamedRange(name, range)`

Nadaje zakresowi nazwę.

// 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setRecalculationInterval(recalculationInterval)`

Ustawia częstotliwość ponownego obliczania w tym arkuszu kalkulacyjnym.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the  calculation interval for the spreadsheet to 'ON_CHANGE'.
const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE);

// Logs the calculation interval to the console.
console.log(interval);

Parametry

Nazwa	Typ	Opis
`recalculationInterval`	`RecalculationInterval`	Nowy interwał przeliczenia.

Powrót

Spreadsheet – ten arkusz kalkulacyjny do tworzenia łańcuchów.

Autoryzacja

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

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

`setRowHeight(rowPosition, height)`

Ustawia wysokość wiersza danego wiersza w pikselach. Domyślnie wiersze są powiększane, aby dopasować się do zawartości komórki. Jeśli chcesz wymusić wysokość wierszy do określonej wysokości, użyj funkcji Sheet.setRowHeightsForced(startRow, numRows, height).

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

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(1, 200);

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja wiersza do zmiany.
`height`	`Integer`	Wysokość w pikselach.

Powrót

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`setSpreadsheetLocale(locale)`

Określa 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 do użycia (np. „en”, „fr” lub „en_US”).

Autoryzacja

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

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

`setSpreadsheetTheme(theme)`

Ustawia motyw w arkuszu kalkulacyjnym.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// The code below sets the second predefined theme as the current theme of the spreadsheet.
var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes();
spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);

Parametry

Nazwa	Typ	Opis
`theme`	`SpreadsheetTheme`	Motyw, który chcesz zastosować.

Powrót

SpreadsheetTheme – nowy, bieżący motyw.

Autoryzacja

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

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

`setSpreadsheetTimeZone(timezone)`

Ustawia strefę czasową dla arkusza kalkulacyjnego.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Parametry

Nazwa	Typ	Opis
`timezone`	`String`	Strefa czasowa podana w formacie „long” (np. "Ameryka/Nowy_Jork", podane przez Joda.org).

Autoryzacja

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

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

`show(userInterface)`

Wyświetla niestandardowy komponent interfejsu w oknie wyśrodkowanym w przeglądarce użytkownika widoczny obszar. Wykonanie skryptu po stronie serwera nie zostało zawieszone. Aby komunikować się z po stronie serwera, komponent interfejsu musi wykonywać asynchroniczne wywołania zwrotne po stronie serwera skrypt.

Jeśli skrypt po stronie serwera wyświetlał wcześniej okno, które nie zostało jeszcze zamknięte, Istniejące okno zostanie zastąpione interfejsem nowego okna.

Poniższy fragment kodu wyświetla prostą aplikację HtmlService w oknie z określony tytuł, wysokość i szerokość:

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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/script.container.ui

`sort(columnPosition)`

Sortuje arkusz rosnąco według kolumny.

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 ma być sortowana.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`sort(columnPosition, ascending)`

Sortuje arkusz według kolumny. Przyjmuje parametr określający sortowanie rosnące lub malejąco.

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 ma być sortowana.
`ascending`	`Boolean`	`true` – malejąco, `false` – malejąco.

Powrót

Sheet – arkusz, przydatny do tworzenia łańcuchów metod.

Autoryzacja

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

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

`toast(msg)`

W prawym dolnym rogu arkusza kalkulacyjnego wyświetla się wyskakujące okienko z daną wiadomością.

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

Parametry

Nazwa	Typ	Opis
`msg`	`String`	Wiadomość, która ma być wyświetlana w wyskakującym okienku.

Autoryzacja

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

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

`toast(msg, title)`

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

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

Parametry

Nazwa	Typ	Opis
`msg`	`String`	Wiadomość, która ma być wyświetlana w wyskakującym okienku.
`title`	`String`	Opcjonalny tytuł toastu.

Autoryzacja

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

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

`toast(msg, title, timeoutSeconds)`

W prawym dolnym rogu arkusza kalkulacyjnego wyświetla się wyskakujące okienko z podanym tytułem który jest widoczny przez określony czas.

// Show a 3-second popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);

Parametry

Nazwa	Typ	Opis
`msg`	`String`	Wiadomość, która ma być wyświetlana w wyskakującym okienku.
`title`	`String`	Opcjonalny tytuł toastu.
`timeoutSeconds`	`Number`	limit czasu w sekundach; Jeśli `null`, domyślny czas to 5 sekund; W przypadku wartości ujemnej będzie wyświetlany do momentu zamknięcia.

Autoryzacja

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

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

`unhideColumn(column)`

Odkrywa kolumnę w 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 do odkrycia (jeśli jest ukryty).

Autoryzacja

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

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

`unhideRow(row)`

Odkrywa wiersz w podanym zakresie.

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

// This unhides the first row if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideRow(range);

Parametry

Nazwa	Typ	Opis
`row`	`Range`	Zakres do odkrycia (jeśli jest ukryty).

Autoryzacja

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

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

`updateMenu(name, subMenus)`

Aktualizuje menu dodane przez użytkownika addMenu(name, subMenus). Działa dokładnie tak samo jak addMenu(name, subMenus).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var menuEntries = [];
menuEntries.push({name: "Lone Menu Entry", functionName: "function1"});
ss.updateMenu("addMenuExample", menuEntries);

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa menu do aktualizacji.
`subMenus`	`Object[]`	Tablica map JavaScript z parametrami `name` i `functionName`. Możesz używać funkcji z uwzględnionych bibliotek, np. `Library.libFunction1`.

Autoryzacja

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

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

Oczekuje na zakończenie wszystkich bieżących wykonań w arkuszu kalkulacyjnym. Limit czasu wynosi po podana liczba sekund. Zgłasza wyjątek, jeśli wykonania nie zostaną ukończone w czasie wykonywania kodu , ale nie anuluje uruchomień związanych z danymi.

Parametry

Nazwa	Typ	Opis
`timeoutInSeconds`	`Integer`	Czas oczekiwania na uruchomienia danych (w sekundach). Maksymalna liczba to 300 sek.

Autoryzacja

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

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

Wycofane metody

`getSheetProtection()`

Wycofano. W przypadku arkuszy kalkulacyjnych utworzonych w nowszej wersji Arkuszy Google użyj funkcji Sheet.getProtections(type), która zwraca wydajniejszą klasę Protection. Chociaż ta metoda została wycofana, nadal jest dostępna w przypadku zgodność ze starszą wersją Arkuszy

Zwraca instancję PageProtection opisującą 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`isAnonymousView()`

Wycofano. Od stycznia 2014 r. ta funkcja jest wycofana i nie jest dostępna w nowej wersji w Arkuszach Google.

Wskazuje, czy dokument umożliwia anonimowe przeglądanie. Nie jest już obsługiwane w nowej wersji Arkuszy Google, użyj 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 przeglądanie anonimowe. W przeciwnym razie: false.

Autoryzacja

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

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

Zobacz też

Usługa Dysk

`isAnonymousWrite()`

Wycofano. Od stycznia 2014 r. ta funkcja jest wycofana i nie jest dostępna w nowej wersji w Arkuszach Google.

Wskazuje, czy dokument umożliwia edytowanie przez anonimowych użytkowników. Ponieważ nie jest już obsługiwane w nowej wersji Arkuszy Google, używaj zamiast nich 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 umożliwia edytowanie anonimowo, false w przeciwnym razie.

Autoryzacja

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

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

Zobacz też

Usługa Dysk

`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`

Wycofano. Od stycznia 2014 r. ta funkcja jest wycofana i nie jest dostępna w nowej wersji w Arkuszach Google.

Ustawia zasady dokumentu dotyczące anonimowego czytania i pisania. Ta funkcja nie jest już obsługiwana w nową wersję Arkuszy Google, możesz użyć 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; W przeciwnym razie: `false`.
`anonymousWriteAllowed`	`Boolean`	`true`, aby zezwolić na anonimowe odczyty; W przeciwnym razie: `false`.

Autoryzacja

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

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

Zobacz też

isAnonymousView()
isAnonymousWrite()
Usługa Dysk

`setSheetProtection(permissions)`

Wycofano. W przypadku arkuszy kalkulacyjnych utworzonych w nowszej wersji Arkuszy Google użyj funkcji Sheet.protect(), która zwraca wydajniejszą klasę Protection. Chociaż metoda ta została wycofana, ale nadal jest dostępna dla zgodności ze starszą wersją Arkusze.

Określa 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 w tym arkuszu.

Autoryzacja

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

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