Class Folder

folder na Dysku Google; Dostęp do folderów można uzyskać lub tworzyć je w sekcji DriveApp.

// Log the name of every folder in the user's Drive.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
  const folder = folders.next();
  Logger.log(folder.getName());
}

Metody

Metoda	Zwracany typ	Krótki opis
`addEditor(emailAddress)`	`Folder`	Dodaje podanego użytkownika do listy edytujących `Folder`.
`addEditor(user)`	`Folder`	Dodaje podanego użytkownika do listy edytujących `Folder`.
`addEditors(emailAddresses)`	`Folder`	Dodaje podaną tablicę użytkowników do listy edytujących `Folder`.
`addViewer(emailAddress)`	`Folder`	Dodaje podanego użytkownika do listy osób, które mogą wyświetlać `Folder`.
`addViewer(user)`	`Folder`	Dodaje podanego użytkownika do listy osób, które mogą wyświetlać `Folder`.
`addViewers(emailAddresses)`	`Folder`	Dodaje podaną tablicę użytkowników do listy widzów `Folder`.
`createFile(blob)`	`File`	Tworzy w bieżącym folderze plik z podanym `Blob` dowolnych danych.
`createFile(name, content)`	`File`	Tworzy w bieżącym folderze plik tekstowy o podanej nazwie i zawartości.
`createFile(name, content, mimeType)`	`File`	Tworzy w bieżącym folderze plik o podanej nazwie, zawartości i typie MIME.
`createFolder(name)`	`Folder`	Tworzy w bieżącym folderze folder o podanej nazwie.
`createShortcut(targetId)`	`File`	Tworzy skrót do podanego identyfikatora elementu na Dysku i zwraca go.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Tworzy skrót do podanego identyfikatora elementu na Dysku i klucza zasobu, a następnie go zwraca.
`getAccess(email)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getAccess(user)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getDateCreated()`	`Date`	Pobiera datę utworzenia `Folder`.
`getDescription()`	`String`	Pobiera opis elementu `Folder`.
`getEditors()`	`User[]`	Pobiera listę edytorów tego `Folder`.
`getFiles()`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu.
`getFilesByName(name)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu i mają podaną nazwę.
`getFilesByType(mimeType)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu i mają podany typ MIME.
`getFolders()`	`FolderIterator`	Pobiera kolekcję wszystkich folderów podrzędnych względem bieżącego folderu.
`getFoldersByName(name)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów, które są podrzędne względem bieżącego folderu i mają podaną nazwę.
`getId()`	`String`	Pobiera identyfikator `Folder`.
`getLastUpdated()`	`Date`	Pobiera datę ostatniej aktualizacji `Folder`.
`getName()`	`String`	Pobiera nazwę `Folder`.
`getOwner()`	`User`	Pobiera właściciela tego zasobu `Folder`.
`getParents()`	`FolderIterator`	Pobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnymi elementu `Folder`.
`getResourceKey()`	`String`	Pobiera klucz zasobu `Folder`, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.
`getSecurityUpdateEligible()`	`Boolean`	Określa, czy ten `Folder` może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku.
`getSecurityUpdateEnabled()`	`Boolean`	Określa, czy ten `Folder` wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku.
`getSharingAccess()`	`Access`	Określa, która grupa użytkowników może uzyskać dostęp do `Folder`, oprócz użytkowników, którym wyraźnie przyznano dostęp.
`getSharingPermission()`	`Permission`	Pobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do `Folder`, oprócz użytkowników, którym wyraźnie przyznano dostęp.
`getSize()`	`Integer`	Pobiera liczbę bajtów używanych do przechowywania `Folder` na Dysku.
`getUrl()`	`String`	Pobiera adres URL, którego można użyć do otwarcia `Folder` w aplikacji Google, takiej jak Dysk lub Dokumenty.
`getViewers()`	`User[]`	Pobiera listę przeglądających i komentujących tego `Folder`.
`isShareableByEditors()`	`Boolean`	Określa, czy użytkownicy z uprawnieniami do edycji `Folder` mogą udostępniać go innym użytkownikom lub zmieniać uprawnienia.
`isStarred()`	`Boolean`	Określa, czy `Folder` został oznaczony gwiazdką na Dysku użytkownika.
`isTrashed()`	`Boolean`	Określa, czy `Folder` znajduje się w koszu na Dysku użytkownika.
`moveTo(destination)`	`Folder`	Przenosi ten element do podanego folderu docelowego.
`removeEditor(emailAddress)`	`Folder`	Usuwa danego użytkownika z listy osób edytujących `Folder`.
`removeEditor(user)`	`Folder`	Usuwa danego użytkownika z listy osób edytujących `Folder`.
`removeViewer(emailAddress)`	`Folder`	Usuwa danego użytkownika z listy przeglądających i komentujących `Folder`.
`removeViewer(user)`	`Folder`	Usuwa danego użytkownika z listy przeglądających i komentujących `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Unieważnia dostęp do `Folder` przyznany danemu użytkownikowi.
`revokePermissions(user)`	`Folder`	Unieważnia dostęp do `Folder` przyznany danemu użytkownikowi.
`searchFiles(params)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu i spełniają podane kryteria wyszukiwania.
`searchFolders(params)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów, które są elementami podrzędnymi bieżącego folderu i spełniają podane kryteria wyszukiwania.
`setDescription(description)`	`Folder`	Ustawia opis elementu `Folder`.
`setName(name)`	`Folder`	Ustawia nazwę elementu `Folder`.
`setOwner(emailAddress)`	`Folder`	Zmienia właściciela `Folder`.
`setOwner(user)`	`Folder`	Zmienia właściciela `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Określa, czy `Folder` wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku.
`setShareableByEditors(shareable)`	`Folder`	Określa, czy użytkownicy z uprawnieniami do edycji `Folder` mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia.
`setSharing(accessType, permissionType)`	`Folder`	Określa, która grupa użytkowników może uzyskać dostęp do `Folder` i jakie uprawnienia zostaną im przyznane, oprócz uprawnień przyznanych poszczególnym użytkownikom.
`setStarred(starred)`	`Folder`	Określa, czy `Folder` jest oznaczony gwiazdką na Dysku użytkownika.
`setTrashed(trashed)`	`Folder`	Określa, czy `Folder` znajduje się w koszu na Dysku użytkownika.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
`addFile(child)`	`Folder`	Dodaje podany plik do bieżącego folderu.
`addFolder(child)`	`Folder`	Dodaje podany folder do bieżącego folderu.
`removeFile(child)`	`Folder`	Usuwa podany plik z bieżącego folderu.
`removeFolder(child)`	`Folder`	Usuwa podany folder z bieżącego folderu.

Szczegółowa dokumentacja

`addEditor(emailAddress)`

Dodaje podanego użytkownika do listy edytujących Folder. Jeśli użytkownik był już na liście widzów, ta metoda usuwa go z tej listy.

Parametry

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

Powrót

Folder – ten Folder do tworzenia łańcuszków.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addEditor(user)`

Dodaje podanego użytkownika do listy edytujących Folder. Jeśli użytkownik był już na liście widzów, ta metoda usuwa go z tej listy.

Parametry

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

Powrót

Folder – ten Folder do tworzenia łańcuszków.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addEditors(emailAddresses)`

Dodaje podaną tablicę użytkowników do listy edytujących Folder. Jeśli któryś z użytkowników był już na liście widzów, ta metoda usuwa go z tej listy.

Parametry

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

Powrót

Folder – ten Folder do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addViewer(emailAddress)`

Dodaje podanego użytkownika do listy osób, które mogą wyświetlać Folder. Jeśli użytkownik był już na liście edytujących, ta metoda nie ma wpływu.

Parametry

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

Powrót

Folder – ten Folder do tworzenia łańcuszków.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addViewer(user)`

Dodaje podanego użytkownika do listy osób, które mogą wyświetlać Folder. Jeśli użytkownik był już na liście edytujących, ta metoda nie ma wpływu.

Parametry

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

Powrót

Folder – ten Folder do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addViewers(emailAddresses)`

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

Parametry

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

Powrót

Folder – ten Folder do tworzenia łańcuszków.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createFile(blob)`

Tworzy w bieżącym folderze plik z podanym Blob dowolnych danych.

Parametry

Nazwa	Typ	Opis
`blob`	`BlobSource`	Dane nowego pliku.

Powrót

File – nowy plik.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createFile(name, content)`

Tworzy w bieżącym folderze plik tekstowy o podanej nazwie i zawartości. Zwraca wyjątek, jeśli content jest większy niż 50 MB.

// Create a text file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa nowego pliku.
`content`	`String`	Treść nowego pliku.

Powrót

File – nowy plik.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createFile(name, content, mimeType)`

Tworzy w bieżącym folderze plik o podanej nazwie, zawartości i typie MIME. Zwraca wyjątek, jeśli rozmiar pliku content przekracza 10 MB.

// Create an HTML file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa nowego pliku.
`content`	`String`	Treść nowego pliku.
`mimeType`	`String`	Typ MIME nowego pliku.

Powrót

File – nowy plik.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createFolder(name)`

Tworzy w bieżącym folderze folder o podanej nazwie.

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa nowego folderu.

Powrót

Folder – nowy folder.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createShortcut(targetId)`

Tworzy skrót do podanego identyfikatora elementu na Dysku i zwraca go.

Parametry

Nazwa	Typ	Opis
`targetId`	`String`	Identyfikator pliku docelowego lub folderu.

Powrót

File – nowy skrót.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

Tworzy skrót do podanego identyfikatora elementu na Dysku i klucza zasobu, a następnie go zwraca. Klucz zasobu to dodatkowy parametr, który należy przekazać, aby uzyskać dostęp do docelowego pliku lub folderu udostępnionego za pomocą linku.

// Creates shortcuts for all folders in the user's drive that have a specific
// name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your
// drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and
  // returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(
      folder.getId(),
      folder.getResourceKey(),
  );
}

Parametry

Nazwa	Typ	Opis
`targetId`	`String`	Identyfikator docelowego pliku lub folderu.
`targetResourceKey`	`String`	Klucz zasobu docelowego pliku lub folderu.

Powrót

File – nowy skrót.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getAccess(email)`

Pobiera uprawnienia przyznane konkretnemu użytkownikowi. Ta metoda nie obsługuje zwracania uprawnień dla grupy dyskusyjnej Google ani uprawnień dziedziczonych przez grupy dyskusyjne Google.

Parametry

Nazwa	Typ	Opis
`email`	`String`	Adres e-mail użytkownika, którego uprawnienia mają zostać sprawdzone. Grupy dyskusyjne Google nie są obsługiwane.

Powrót

Permission – uprawnienia przyznane użytkownikowi.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getAccess(user)`

Pobiera uprawnienia przyznane konkretnemu użytkownikowi. Ta metoda nie obsługuje zwracania uprawnień dla grupy dyskusyjnej Google ani uprawnień dziedziczonych przez grupy dyskusyjne Google.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika, którego uprawnienia mają zostać sprawdzone.

Powrót

Permission – uprawnienia przyznane użytkownikowi.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDateCreated()`

Pobiera datę utworzenia Folder.

Powrót

Date – data utworzenia Folder.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDescription()`

Pobiera opis elementu Folder.

Powrót

String – opis elementu Folder;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getEditors()`

Pobiera listę edytorów tego Folder. Jeśli użytkownik, który uruchamia skrypt, nie ma uprawnień do edytowania Folder, ta metoda zwraca pustą tablicę.

//  Gets a folder by its ID.
//  TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (const editor of editors) {
  console.log(editor.getName());
}

Powrót

User[] – lista edytujących dla tego Folder, jeśli użytkownik ma uprawnienia do edycji, lub pusta tablica w przeciwnym razie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFiles()`

Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu.

Powrót

FileIterator – zbiór wszystkich plików, które są elementami podrzędnymi bieżącego folderu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFilesByName(name)`

Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu i mają podaną nazwę.

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwy plików do znalezienia.

Powrót

FileIterator – zbiór wszystkich plików, które są elementami podrzędnymi bieżącego folderu i mają podaną nazwę.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFilesByType(mimeType)`

Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu i mają podany typ MIME.

Parametry

Nazwa	Typ	Opis
`mimeType`	`String`	Typ MIME plików do znalezienia.

Powrót

FileIterator – kolekcja wszystkich plików, które są elementami podrzędnymi bieżącego folderu i mają podany typ MIME.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFolders()`

Pobiera kolekcję wszystkich folderów podrzędnych względem bieżącego folderu.

Powrót

FolderIterator – zbiór wszystkich folderów podrzędnych w stosunku do bieżącego folderu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFoldersByName(name)`

Pobiera kolekcję wszystkich folderów, które są podrzędne względem bieżącego folderu i mają podaną nazwę.

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa folderów do znalezienia.

Powrót

FolderIterator – zbiór wszystkich folderów, które są podrzędne względem bieżącego folderu i mają podaną nazwę.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getId()`

Pobiera identyfikator Folder.

Powrót

String – identyfikator Folder

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getLastUpdated()`

Pobiera datę ostatniej aktualizacji Folder.

Powrót

Date – data ostatniej aktualizacji Folder.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getName()`

Pobiera nazwę Folder.

Powrót

String – nazwa Folder

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getOwner()`

Pobiera właściciela tego zasobu Folder.

//  Gets a folder by its ID.
//  TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

Powrót

User – właściciel tego Folder.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getParents()`

Pobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnymi elementu Folder.

Powrót

FolderIterator – zbiór folderów, które są bezpośrednimi folderami nadrzędnymi elementu Folder.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getResourceKey()`

Pobiera klucz zasobu Folder, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.

Powrót

String – klucz zasobu Folder.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getSecurityUpdateEligible()`

Określa, czy ten Folder może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku.

Dysk wymaga klucza zasobu, aby uzyskać dostęp do niektórych plików lub folderów udostępnionych za pomocą linku. Ta zmiana jest częścią aktualizacji zabezpieczeń. Aktualizacja jest domyślnie włączona w przypadku kwalifikujących się plików i folderów. Aby włączyć lub wyłączyć wymaganie klucza zasobu w przypadku kwalifikujących się plików, użyj setSecurityUpdateEnabled.

Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.

Powrót

Boolean – czy wymaganie dotyczące klucza zasobu można zastosować w przypadku Folder.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getSecurityUpdateEnabled()`

Określa, czy ten Folder wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku. To wymaganie jest domyślnie włączone w przypadku kwalifikujących się plików i folderów. Aby włączyć lub wyłączyć wymaganie klucza zasobu w przypadku kwalifikujących się plików, użyj ikony setSecurityUpdateEnabled.

Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.

Powrót

Boolean – czy wymaganie dotyczące klucza zasobu jest włączone w przypadku tego Folder.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getSharingAccess()`

Określa, która grupa użytkowników może uzyskać dostęp do Folder, oprócz użytkowników, którym wyraźnie przyznano dostęp.

Powrót

Access – która grupa użytkowników może uzyskać dostęp do Folder

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getSharingPermission()`

Pobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do Folder, oprócz użytkowników, którym wyraźnie przyznano dostęp.

Powrót

Permission – uprawnienia przyznane użytkownikom, którzy mają dostęp do Folder

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getSize()`

Pobiera liczbę bajtów używanych do przechowywania Folder na Dysku. Pamiętaj, że pliki aplikacji Google Workspace nie są wliczane do limitu miejsca na Dysku, dlatego zwracają 0 bajtów.

Powrót

Integer – liczba bajtów użytych do przechowywania Folder na Dysku.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getUrl()`

Pobiera adres URL, którego można użyć do otwarcia Folder w aplikacji Google, takiej jak Dysk lub Dokumenty.

Powrót

String – adres URL, którego można użyć do wyświetlenia tego Folder w aplikacji Google, takiej jak Dysk lub Dokumenty.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getViewers()`

Pobiera listę przeglądających i komentujących tego Folder. Jeśli użytkownik, który wykonuje skrypt, nie ma uprawnień do edycji Folder, ta metoda zwraca pustą tablicę.

//  Gets a folder by its ID.
//  TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (const viewer of viewers) {
  console.log(viewer.getName());
}

Powrót

User[] – lista przeglądających i komentujących ten Folder, jeśli użytkownik ma uprawnienia do edycji, lub pusta tablica w przeciwnym razie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`isShareableByEditors()`

Określa, czy użytkownicy z uprawnieniami do edycji Folder mogą udostępniać go innym użytkownikom lub zmieniać uprawnienia.

Powrót

Boolean – true jeśli użytkownicy z uprawnieniami do edycji mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia; false jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`isStarred()`

Określa, czy Folder został oznaczony gwiazdką na Dysku użytkownika.

Powrót

Boolean – true, jeśli Folder jest oznaczony gwiazdką na Dysku użytkownika; false, jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`isTrashed()`

Określa, czy Folder znajduje się w koszu na Dysku użytkownika.

Powrót

Boolean – true, jeśli Folder znajduje się w koszu na Dysku użytkownika;false w przeciwnym razie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`moveTo(destination)`

Przenosi ten element do podanego folderu docelowego.

Aby przenieść element do folderu docelowego, bieżący użytkownik musi być właścicielem pliku lub mieć uprawnienia do edycji bieżącego folderu nadrzędnego elementu.

Parametry

Nazwa	Typ	Opis
`destination`	`Folder`	Folder, który stanie się nowym folderem nadrzędnym.

Powrót

Folder – ten Folder do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeEditor(emailAddress)`

Usuwa danego użytkownika z listy osób edytujących Folder. Ta metoda nie blokuje użytkownikom dostępu do Folder, jeśli należą oni do klasy użytkowników, którzy mają ogólny dostęp, np. jeśli Folder jest udostępniony całej domenie użytkownika lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy osób, które mogą je wyświetlać.

Parametry

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

Powrót

Folder – ten Folder do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeEditor(user)`

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy osób, które mogą je wyświetlać.

Parametry

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

Powrót

Folder – ten Folder do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeViewer(emailAddress)`

Usuwa danego użytkownika z listy przeglądających i komentujących Folder. Ta metoda nie ma wpływu, jeśli użytkownik jest edytującym, a nie przeglądającym lub komentującym. Ta metoda nie blokuje też dostępu do Folder użytkownikom, którzy należą do grupy użytkowników mających ogólny dostęp, np. jeśli Folder jest udostępniony całej domenie użytkownika lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

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

Parametry

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

Powrót

Folder – ten znak Folder służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeViewer(user)`

Usuwa danego użytkownika z listy przeglądających i komentujących Folder. Ta metoda nie ma wpływu, jeśli użytkownik jest edytującym, a nie przeglądającym. Ta metoda nie blokuje też dostępu do Folder użytkownikom, którzy należą do klasy użytkowników mających ogólny dostęp, np. jeśli Folder jest udostępniony całej domenie użytkownika lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

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

Parametry

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

Powrót

Folder – ten znak Folder służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`revokePermissions(emailAddress)`

Unieważnia dostęp do Folder przyznany danemu użytkownikowi. Ta metoda nie blokuje użytkownikom dostępu do Folder, jeśli należą oni do klasy użytkowników, którzy mają ogólny dostęp – na przykład jeśli Folder jest udostępniony całej domenie użytkownika.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, któremu należy odebrać dostęp.

Powrót

Folder – ten Folder do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`revokePermissions(user)`

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika, którego dostęp ma zostać cofnięty.

Powrót

Folder – ten Folder do tworzenia łańcuszków.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`searchFiles(params)`

Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu i spełniają podane kryteria wyszukiwania. Kryteria wyszukiwania są szczegółowo opisane w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z interfejsu Drive API w wersji 2, a niektóre pola zapytań różnią się od tych w wersji 3. Sprawdź różnice w polach między wersjami 2 i 3.

Argument params to ciąg zapytania, który może zawierać wartości tekstowe, więc uważaj, aby poprawnie używać znaków cudzysłowu (np. "title contains 'Gulliver\\'s Travels'" lub 'title contains "Gulliver\'s Travels"').

// Logs the name of every file that are children of the current folder and modified after February 28,
// 2022 whose name contains "untitled.""
const files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getName());
}

Parametry

Nazwa	Typ	Opis
`params`	`String`	Kryteria wyszukiwania zgodnie z opisem w dokumentacji pakietu SDK Dysku Google.

Powrót

FileIterator – zbiór wszystkich plików, które są elementami podrzędnymi bieżącego folderu i spełniają kryteria wyszukiwania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`searchFolders(params)`

Pobiera kolekcję wszystkich folderów, które są elementami podrzędnymi bieżącego folderu i spełniają podane kryteria wyszukiwania. Kryteria wyszukiwania są szczegółowo opisane w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z interfejsu Drive API w wersji 2, a niektóre pola zapytań różnią się od tych w wersji 3. Sprawdź różnice w polach między wersjami 2 i 3.

// Logs the name of every folder that are children of the current folder and you own and is starred.
const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  const folder = folders.next();
  console.log(folder.getName());
}

Parametry

Nazwa	Typ	Opis
`params`	`String`	Kryteria wyszukiwania zgodnie z opisem w dokumentacji pakietu SDK Dysku Google.

Powrót

FolderIterator – kolekcja wszystkich folderów podrzędnych w stosunku do bieżącego folderu, które spełniają kryteria wyszukiwania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setDescription(description)`

Ustawia opis elementu Folder.

Parametry

Nazwa	Typ	Opis
`description`	`String`	nowy opis `Folder`,

Powrót

Folder – ten Folder do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setName(name)`

Ustawia nazwę elementu Folder.

Parametry

Nazwa	Typ	Opis
`name`	`String`	nową nazwę `Folder`;

Powrót

Folder – ten Folder do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setOwner(emailAddress)`

Zmienia właściciela Folder. Ta metoda przyznaje też poprzedniemu właścicielowi wyraźne uprawnienia do edycji Folder.

Dysk nie obsługuje zmiany własności w przypadku elementów, których właścicielem są konta gmail.com. Jest to możliwe w przypadku kont Workspace.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, który ma zostać nowym właścicielem.

Powrót

Folder – ten Folder do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setOwner(user)`

Zmienia właściciela Folder. Ta metoda przyznaje też poprzedniemu właścicielowi wyraźne uprawnienia do edycji Folder.

Dysk nie obsługuje zmiany własności w przypadku elementów, których właścicielem są konta gmail.com. Jest to możliwe w przypadku kont Workspace.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika, który ma zostać nowym właścicielem.

Powrót

Folder – ten Folder do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setSecurityUpdateEnabled(enabled)`

Określa, czy Folder wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku. Odpowiednie pliki i foldery są domyślnie włączone.

Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.

Parametry

Nazwa	Typ	Opis
`enabled`	`Boolean`	Czy włączyć wymaganie klucza zasobu dla `Folder`.

Powrót

Folder – ten Folder do tworzenia łańcuszków.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setShareableByEditors(shareable)`

Określa, czy użytkownicy z uprawnieniami do edycji Folder mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia. Domyślna wartość nowego parametru Folder to true.

Parametry

Nazwa	Typ	Opis
`shareable`	`Boolean`	`true` czy użytkownicy z uprawnieniami do edycji powinni mieć możliwość udostępniania innym użytkownikom lub zmiany uprawnień; `false` jeśli nie,

Powrót

Folder – ten Folder do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setSharing(accessType, permissionType)`

Określa, która klasa użytkowników może uzyskać dostęp do Folder i jakie uprawnienia zostaną im przyznane, oprócz poszczególnych użytkowników, którym wyraźnie przyznano dostęp.

// Creates a folder that anyone on the Internet can read from and write to.
// (Domain administrators can prohibit this setting for users of a Google
// Workspace domain.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametry

Nazwa	Typ	Opis
`accessType`	`Access`	która grupa użytkowników powinna mieć dostęp do `Folder`.
`permissionType`	`Permission`	uprawnienia, które powinny zostać przyznane użytkownikom mającym dostęp do `Folder`;

Powrót

Folder – ten Folder do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setStarred(starred)`

Określa, czy Folder jest oznaczony gwiazdką na Dysku użytkownika. Wartość domyślna dla nowych Folder to false.

Parametry

Nazwa	Typ	Opis
`starred`	`Boolean`	`true`, jeśli `Folder` ma być oznaczony gwiazdką na Dysku użytkownika; `false`, jeśli nie.

Powrót

Folder – ten Folder do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setTrashed(trashed)`

Określa, czy Folder znajduje się w koszu na Dysku użytkownika. Tylko właściciel może przenieść Folder do kosza. Wartość domyślna nowych Folder to false.

Parametry

Nazwa	Typ	Opis
`trashed`	`Boolean`	`true` – jeśli `Folder` ma zostać przeniesiony do kosza na Dysku użytkownika; `false` – w przeciwnym razie.

Powrót

Folder – ten Folder do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Wycofane metody

`addFile(child)`

Wycofano. Zamiast tego użyj zasady File.moveTo(destination) lub createShortcut(targetId).

Dodaje podany plik do bieżącego folderu. Ta metoda nie powoduje przeniesienia pliku z dotychczasowego folderu nadrzędnego. Plik może mieć jednocześnie więcej niż 1 folder nadrzędny.

Parametry

Nazwa	Typ	Opis
`child`	`File`	Plik podrzędny do dodania.

Powrót

Folder – nowy folder nadrzędny pliku dodanego jako podrzędny.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addFolder(child)`

Wycofano. Zamiast tego użyj zasady moveTo(destination) lub createShortcut(targetId).

Dodaje podany folder do bieżącego folderu. Ta metoda nie przenosi folderu z jego obecnego folderu nadrzędnego. Folder może mieć jednocześnie więcej niż 1 folder nadrzędny.

Parametry

Nazwa	Typ	Opis
`child`	`Folder`	Folder podrzędny do dodania.

Powrót

Folder – nowy folder nadrzędny dodanego folderu podrzędnego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeFile(child)`

Wycofano. Służy do tego właściwość File.moveTo(destination).

Usuwa podany plik z bieżącego folderu. Ta metoda nie usuwa pliku, ale jeśli plik zostanie usunięty ze wszystkich folderów nadrzędnych, nie będzie widoczny na Dysku, chyba że zostanie wyszukany lub wyświetlony w widoku „Wszystkie elementy”.

Parametry

Nazwa	Typ	Opis
`child`	`File`	Plik podrzędny do usunięcia.

Powrót

Folder – poprzedni element nadrzędny elementu podrzędnego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeFolder(child)`

Wycofano. Służy do tego właściwość moveTo(destination).

Usuwa podany folder z bieżącego folderu. Ta metoda nie usuwa folderu ani jego zawartości, ale jeśli folder zostanie usunięty ze wszystkich folderów nadrzędnych, nie będzie widoczny na Dysku, chyba że zostanie wyszukany lub wyświetlony w widoku „Wszystkie elementy”.

Parametry

Nazwa	Typ	Opis
`child`	`Folder`	Folder dziecka do usunięcia.

Powrót

Folder – poprzedni element nadrzędny elementu podrzędnego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Class Folder Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Metody

Wycofane metody

Szczegółowa dokumentacja

addEditor(emailAddress)

Parametry

Powrót

Autoryzacja

addEditor(user)

Parametry

Powrót

Autoryzacja

addEditors(emailAddresses)

Parametry

Powrót

Autoryzacja

addViewer(emailAddress)

Parametry

Powrót

Autoryzacja

addViewer(user)

Parametry

Powrót

Autoryzacja

addViewers(emailAddresses)

Parametry

Powrót

Autoryzacja

createFile(blob)

Parametry

Powrót

Autoryzacja

createFile(name, content)

Parametry

Powrót

Autoryzacja

createFile(name, content, mimeType)

Parametry

Powrót

Autoryzacja

createFolder(name)

Parametry

Powrót

Autoryzacja

createShortcut(targetId)

Parametry

Powrót

Autoryzacja

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

Parametry

Powrót

Autoryzacja

getAccess(email)

Parametry

Powrót

Autoryzacja

getAccess(user)

Parametry

Powrót

Autoryzacja

getDateCreated()

Powrót

Autoryzacja

getDescription()

Powrót

Autoryzacja

getEditors()

Powrót

Autoryzacja

getFiles()

Powrót

Autoryzacja

getFilesByName(name)

Parametry

Powrót

Autoryzacja

getFilesByType(mimeType)

Parametry

Powrót

Autoryzacja

Class Folder

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addViewer(emailAddress)`

`addViewer(user)`

`addViewers(emailAddresses)`

`createFile(blob)`

`createFile(name, content)`

`createFile(name, content, mimeType)`

`createFolder(name)`

`createShortcut(targetId)`

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

`getAccess(email)`

`getAccess(user)`

`getDateCreated()`

`getDescription()`

`getEditors()`

`getFiles()`

`getFilesByName(name)`

`getFilesByType(mimeType)`

`getFolders()`

`getFoldersByName(name)`

`getId()`

`getLastUpdated()`

`getName()`

`getOwner()`

`getParents()`

`getResourceKey()`

`getSecurityUpdateEligible()`

`getSecurityUpdateEnabled()`

`getSharingAccess()`

`getSharingPermission()`

`getSize()`

`getUrl()`

`getViewers()`

`isShareableByEditors()`

`isStarred()`

`isTrashed()`

`moveTo(destination)`

`removeEditor(emailAddress)`

`removeEditor(user)`

`removeViewer(emailAddress)`