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

Class Folder

Folder na Dysku Google. Foldery można otwierać i tworzyć w aplikacji DriveApp.

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

Metody

Metoda	Zwracany typ	Krótki opis
`addEditor(emailAddress)`	`Folder`	Dodaje wybranego użytkownika do listy edytorów `Folder`.
`addEditor(user)`	`Folder`	Dodaje wybranego użytkownika do listy edytorów `Folder`.
`addEditors(emailAddresses)`	`Folder`	Dodaje określoną tablicę użytkowników do listy edytorów `Folder`.
`addViewer(emailAddress)`	`Folder`	Dodaje danego użytkownika do listy widzów elementu `Folder`.
`addViewer(user)`	`Folder`	Dodaje danego użytkownika do listy widzów elementu `Folder`.
`addViewers(emailAddresses)`	`Folder`	Dodaje określoną tablicę użytkowników do listy widzów elementu `Folder`.
`createFile(blob)`	`File`	Tworzy plik w bieżącym folderze na podstawie `Blob` dowolnych danych.
`createFile(name, content)`	`File`	Tworzy plik tekstowy w bieżącym folderze o podanej nazwie i zawartości.
`createFile(name, content, mimeType)`	`File`	Tworzy w bieżącym folderze plik o podanej nazwie, treści i typie MIME.
`createFolder(name)`	`Folder`	Tworzy folder w bieżącym folderze o podanej nazwie.
`createShortcut(targetId)`	`File`	Powoduje utworzenie skrótu do podanego identyfikatora elementu na Dysku i zwraca go.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Tworzy skrót do identyfikatora elementu Dysku i klucza zasobu oraz zwraca go.
`getAccess(email)`	`Permission`	Pobiera uprawnienia przyznane użytkownikowi.
`getAccess(user)`	`Permission`	Pobiera uprawnienia przyznane użytkownikowi.
`getDateCreated()`	`Date`	Pobiera datę utworzenia zasobu `Folder`.
`getDescription()`	`String`	Pobiera opis `Folder`.
`getEditors()`	`User[]`	Pobiera listę edytorów tego pliku (`Folder`).
`getFiles()`	`FileIterator`	Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu.
`getFilesByName(name)`	`FileIterator`	Pobiera kolekcję wszystkich plików podrzędnych wobec bieżącego folderu o danej nazwie.
`getFilesByType(mimeType)`	`FileIterator`	Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu i mających określony typ MIME.
`getFolders()`	`FolderIterator`	Pobiera kolekcję wszystkich folderów podrzędnych bieżącego folderu.
`getFoldersByName(name)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów podrzędnych wobec bieżącego folderu i o danej nazwie.
`getId()`	`String`	Pobiera identyfikator `Folder`.
`getLastUpdated()`	`Date`	Pobiera datę ostatniej aktualizacji zasobu `Folder`.
`getName()`	`String`	Pobiera nazwę `Folder`.
`getOwner()`	`User`	Pobiera właściciela zasobu `Folder`.
`getParents()`	`FolderIterator`	Pobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnym folderu `Folder`.
`getResourceKey()`	`String`	Pobiera klucz zasobu `Folder` wymagany do uzyskania dostępu do elementów, które zostały udostępnione za pomocą linku.
`getSecurityUpdateEligible()`	`Boolean`	Określa, czy `Folder` może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu w celu udostępnienia go przy użyciu linku.
`getSecurityUpdateEnabled()`	`Boolean`	Określa, czy `Folder` wymaga klucza dostępu do zasobu, gdy jest udostępniany za pomocą linku.
`getSharingAccess()`	`Access`	Pobiera klasę użytkowników, która pozwala uzyskać dostęp do zasobu `Folder`, wraz z użytkownikami, którym przyznano dostęp wprost.
`getSharingPermission()`	`Permission`	Pobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do elementu `Folder`, oprócz wszystkich użytkowników, którym jawnie przyznano dostęp.
`getSize()`	`Integer`	Pobiera liczbę bajtów używanych do przechowywania pliku `Folder` na Dysku.
`getUrl()`	`String`	Pobiera adres URL, którego można użyć do otwarcia elementu `Folder` w aplikacji Google, takiej jak Dysk czy Dokumenty.
`getViewers()`	`User[]`	Pobiera listę widzów i komentarzy do filmu `Folder`.
`isShareableByEditors()`	`Boolean`	Określa, czy użytkownicy z uprawnieniami do edycji `Folder` mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia.
`isStarred()`	`Boolean`	Określa, czy element `Folder` został oznaczony gwiazdką na Dysku użytkownika.
`isTrashed()`	`Boolean`	Określa, czy plik `Folder` znajduje się w koszu na Dysku użytkownika.
`moveTo(destination)`	`Folder`	Przenosi ten element do podanego folderu docelowego.
`removeEditor(emailAddress)`	`Folder`	Usunięcie użytkownika z listy edytorów `Folder`.
`removeEditor(user)`	`Folder`	Usunięcie użytkownika z listy edytorów `Folder`.
`removeViewer(emailAddress)`	`Folder`	Usunięcie użytkownika z listy widzów i komentujących: `Folder`.
`removeViewer(user)`	`Folder`	Usunięcie użytkownika z listy widzów i komentujących: `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Cofnie dostęp do `Folder` przyznane danemu użytkownikowi.
`revokePermissions(user)`	`Folder`	Cofnie dostęp do `Folder` przyznane danemu użytkownikowi.
`searchFiles(params)`	`FileIterator`	Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu, które spełniają określone kryteria wyszukiwania.
`searchFolders(params)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów podrzędnych tego folderu, które spełniają określone kryteria wyszukiwania.
`setDescription(description)`	`Folder`	Ustawia opis elementu `Folder`.
`setName(name)`	`Folder`	Ustawia nazwę tagu `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 w celu udostępnienia go przy użyciu 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órzy użytkownicy mają dostęp do `Folder` i jakie uprawnienia otrzymują, a także dla poszczególnych użytkowników, którym jawnie przyznano dostęp.
`setStarred(starred)`	`Folder`	Określa, czy element `Folder` jest oznaczony gwiazdką na Dysku użytkownika.
`setTrashed(trashed)`	`Folder`	Określa, czy element `Folder` znajduje się w koszu na Dysku użytkownika.

Metody wycofane

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

Szczegółowa dokumentacja

`addEditor(emailAddress)`

Dodaje wybranego użytkownika do listy edytorów Folder. Jeśli użytkownik był już na liście widzów, ta metoda powoduje, że zostanie on usunięty z listy widzów.

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`addEditor(user)`

Dodaje wybranego użytkownika do listy edytorów Folder. Jeśli użytkownik był już na liście widzów, ta metoda powoduje, że zostanie on usunięty z listy widzów.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do dodania.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`addEditors(emailAddresses)`

Dodaje określoną tablicę użytkowników do listy edytorów Folder. Jeśli którykolwiek użytkownik był na liście widzów, ta metoda spowoduje, że znikną oni z listy widzów.

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`addViewer(emailAddress)`

Dodaje danego użytkownika do listy widzów elementu Folder. Jeśli użytkownik był już na liście edytorów, ta metoda nie ma żadnego efektu.

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`addViewer(user)`

Dodaje danego użytkownika do listy widzów elementu Folder. Jeśli użytkownik był już na liście edytorów, ta metoda nie ma żadnego efektu.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do dodania.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`addViewers(emailAddresses)`

Dodaje określoną tablicę użytkowników do listy widzów elementu Folder. Jeśli którykolwiek użytkownik był już na liście edytorów, ta metoda nie będzie miała wpływu na jego konto.

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`createFile(blob)`

Tworzy plik w bieżącym folderze na podstawie Blob dowolnych danych.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().createFile(blob);

Parametry

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

Zwróć

File – nowy plik.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`createFile(name, content)`

Tworzy plik tekstowy w bieżącym folderze o podanej nazwie i zawartości. Zgłasza wyjątek, jeśli rozmiar pliku content przekracza 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`	Zawartość nowego pliku.

Zwróć

File – nowy plik.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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, treści i typie MIME. Zgłasza 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`	Zawartość nowego pliku.
`mimeType`	`String`	Typ MIME nowego pliku.

Zwróć

File – nowy plik.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`createFolder(name)`

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

Parametry

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

Zwróć

Folder – nowy folder.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`createShortcut(targetId)`

Powoduje utworzenie skrótu do podanego identyfikatora elementu na Dysku i zwraca go.

Parametry

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

Zwróć

File – nowy skrót.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

Tworzy skrót do identyfikatora elementu Dysku i klucza zasobu oraz zwraca go. Klucze zasobów to dodatkowy parametr, który trzeba przekazać, aby uzyskać dostęp do pliku docelowego lub folderu udostępnionego za pomocą linku.

Parametry

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

Zwróć

File – nowy skrót.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getAccess(email)`

Pobiera uprawnienia przyznane użytkownikowi.

Parametry

Nazwa	Typ	Opis
`email`	`String`	adres e-mail użytkownika, którego uprawnienia powinny być sprawdzane;

Zwróć

Permission – uprawnienia przyznane użytkownikowi,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 użytkownikowi.

Parametry

Nazwa	Typ	Opis
`user`	`User`	reprezentacja użytkownika, którego uprawnienia powinny być sprawdzane.

Zwróć

Permission – uprawnienia przyznane użytkownikowi,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getDateCreated()`

Pobiera datę utworzenia zasobu Folder.

Zwróć

Date – data utworzenia Folder;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getDescription()`

Pobiera opis Folder.

Zwróć

String – opis elementu Folder

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 pliku (Folder). Jeśli użytkownik, który wykonał skrypt, nie ma uprawnień do edycji obiektu Folder, ta metoda zwraca pustą tablicę.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getFiles()`

Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu.

Zwróć

FileIterator – zbiór wszystkich plików podrzędnych bieżącego folderu,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 podrzędnych wobec bieżącego folderu o danej nazwie.

Parametry

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

Zwróć

FileIterator – zbiór wszystkich plików podrzędnych bieżącego folderu o podanej nazwie;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getFilesByType(mimeType)`

Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu i mających określony typ MIME.

Parametry

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

Zwróć

FileIterator – zbiór wszystkich plików podrzędnych bieżącego folderu o określonym typie MIME.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 bieżącego folderu.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 podrzędnych wobec bieżącego folderu i o danej nazwie.

Parametry

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

Zwróć

FolderIterator – zbiór wszystkich folderów podrzędnych bieżącego folderu o danej nazwie.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getId()`

Pobiera identyfikator Folder.

Zwróć

String – identyfikator elementu Folder,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 zasobu Folder.

Zwróć

Date – data ostatniej aktualizacji zasobu Folder.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getName()`

Pobiera nazwę Folder.

Zwróć

String – nazwa klucza Folder

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 zasobu Folder.

Zwróć

User – obiekt User reprezentujący właściciela,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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ędnym folderu Folder.

Zwróć

FolderIterator – zbiór folderów, które są bezpośrednimi elementami nadrzędnymi folderu Folder

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 wymagany do uzyskania dostępu do elementów, które zostały udostępnione za pomocą linku.

Zwróć

String – klucz zasobu Folder.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getSecurityUpdateEligible()`

Określa, czy Folder może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu w celu udostępnienia go przy użyciu linku.

Dysk wymaga klucza zasobu, aby mieć dostęp do niektórych plików lub folderów, które zostały udostępnione za pomocą linku. Ta zmiana stanowi część aktualizacji zabezpieczeń. Aktualizacja jest domyślnie włączona w przypadku odpowiednich plików i folderów. Aby włączyć lub wyłączyć wymaganie klucza zasobu w przypadku odpowiednich plików, użyj setSecurityUpdateEnabled.

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

Zwróć

Boolean – określa, czy można zastosować wymaganie klucza zasobu do Folder;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getSecurityUpdateEnabled()`

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

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

Zwróć

Boolean – określa, czy w przypadku tego zasobu Folder włączono wymaganie klucza zasobu.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getSharingAccess()`

Pobiera klasę użytkowników, która pozwala uzyskać dostęp do zasobu Folder, wraz z użytkownikami, którym przyznano dostęp wprost.

Zwróć

Access – która grupa użytkowników ma dostęp do Folder;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 elementu Folder, oprócz wszystkich użytkowników, którym jawnie przyznano dostęp.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 pliku Folder na Dysku. Pliki aplikacji Google Workspace nie wliczają się do limitów miejsca na Dysku, dlatego zwracają 0 B.

Zwróć

Integer – liczba bajtów używanych do przechowywania pliku Folder na Dysku

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 elementu Folder w aplikacji Google, takiej jak Dysk czy Dokumenty.

Zwróć

String – adres URL, którego można użyć, aby wyświetlić Folder w aplikacji Google, takiej jak Dysk czy Dokumenty.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getViewers()`

Pobiera listę widzów i komentarzy do filmu Folder. Jeśli użytkownik, który wykonał skrypt, nie ma uprawnień do edycji obiektu Folder, ta metoda zwraca pustą tablicę.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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ć pliki innym użytkownikom lub zmieniać uprawnienia.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`isStarred()`

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

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`isTrashed()`

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

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

Bieżący użytkownik musi być właścicielem pliku lub mieć uprawnienia do edycji bieżącego folderu nadrzędnego elementu, aby móc go przenieść do folderu docelowego.

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`removeEditor(emailAddress)`

Usunięcie użytkownika z listy edytorów Folder. Ta metoda nie blokuje użytkownikom dostępu do Folder, jeśli należą do klasy użytkowników z ogólnym dostępem – na przykład gdy Folder jest udostępniany w całej domenie użytkownika lub gdy Folder znajduje się na dysku współdzielonym, do którego ten użytkownik ma dostęp.

W przypadku plików na Dysku użytkownik zostanie też usunięty z listy przeglądających.

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`removeEditor(user)`

W przypadku plików na Dysku użytkownik zostanie też usunięty z listy przeglądających.

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`removeViewer(emailAddress)`

Usunięcie użytkownika z listy widzów i komentujących: Folder. Ta metoda nie działa, jeśli użytkownik jest edytorem, a nie przeglądającym lub komentującym. Ta metoda nie blokuje też dostępu do Folder, jeśli należą oni do grupy użytkowników, którzy mają ogólny dostęp (na przykład jeśli Folder jest udostępniony w całej domenie użytkownika lub Folder znajduje się na dysku współdzielonym, do którego ten użytkownik ma dostęp).

W przypadku plików na Dysku użytkownik zostanie też usunięty z listy edytorów.

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`removeViewer(user)`

Usunięcie użytkownika z listy widzów i komentujących: Folder. Ta metoda nie działa, jeśli użytkownik jest edytorem, a nie przeglądającym. Ta metoda również nie blokuje dostępu do zasobu Folder, jeśli należą oni do grupy użytkowników, którzy mają ogólny dostęp (na przykład jeśli Folder jest udostępniony w całej domenie użytkownika lub gdy Folder znajduje się na dysku współdzielonym, do którego ten użytkownik ma dostęp).

W przypadku plików na Dysku użytkownik zostanie też usunięty z listy edytorów.

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`revokePermissions(emailAddress)`

Cofnie dostęp do Folder przyznane danemu użytkownikowi. Ta metoda nie blokuje użytkownikom dostępu do: Folder, jeśli należą do klasy użytkowników, którzy mają ogólny dostęp (np. gdy Folder jest udostępniany w całej domenie użytkownika).

Parametry

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

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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órej dostęp powinien zostać unieważniony.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`searchFiles(params)`

Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu, które spełniają określone kryteria wyszukiwania. Kryteria wyszukiwania znajdziesz w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk używa interfejsu Drive API w wersji 2, a niektóre pola zapytania różnią się od tych w wersji 3. Zapoznaj się z różnicami między wersjami 2 i 3.

Argument params to ciąg zapytania, który może zawierać wartości ciągu znaków. Z tego względu należy uważać, aby prawidłowo ująć znaki 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.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Parametry

Nazwa	Typ	Opis
`params`	`String`	kryteria wyszukiwania, jak opisano w dokumentacji pakietu SDK Dysku Google;

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 podrzędnych tego folderu, które spełniają określone kryteria wyszukiwania. Kryteria wyszukiwania znajdziesz w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk używa interfejsu Drive API w wersji 2, a niektóre pola zapytania różnią się od tych w wersji 3. Zapoznaj się z różnicami 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.
var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

Parametry

Nazwa	Typ	Opis
`params`	`String`	kryteria wyszukiwania, jak opisano w dokumentacji pakietu SDK Dysku Google;

Zwróć

FolderIterator – zbiór wszystkich folderów podrzędnych tego folderu, które spełniają kryteria wyszukiwania.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 usługi `Folder`

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setName(name)`

Ustawia nazwę tagu Folder.

Parametry

Nazwa	Typ	Opis
`name`	`String`	nowa nazwa `Folder`

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 uprawnienia do edycji pliku Folder.

Parametry

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

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 uprawnienia do edycji pliku Folder.

Parametry

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

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setSecurityUpdateEnabled(enabled)`

Określa, czy Folder wymaga klucza zasobu w celu udostępnienia go przy użyciu 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`	Określa, czy włączyć wymaganie klucza zasobu dla zasobu `Folder`.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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ślnie nowa kolumna Folder ma wartość true.

Parametry

Nazwa	Typ	Opis
`shareable`	`Boolean`	`true`, jeśli użytkownicy z uprawnieniami do edycji powinni mieć możliwość udostępniania plików innym użytkownikom lub zmieniania tych uprawnień. Jeśli nie, `false`

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setSharing(accessType, permissionType)`

Określa, którzy użytkownicy mają dostęp do Folder i jakie uprawnienia otrzymują, a także dla poszczególnych użytkowników, którym jawnie 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.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametry

Nazwa	Typ	Opis
`accessType`	`Access`	to, do jakiej klasy będą mieli dostęp `Folder`;
`permissionType`	`Permission`	uprawnienia, które powinny zostać przyznane użytkownikom mającym dostęp do `Folder`

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setStarred(starred)`

Określa, czy element Folder jest oznaczony gwiazdką na Dysku użytkownika. Domyślne ustawienie Folder to false.

Parametry

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

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setTrashed(trashed)`

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

Parametry

Nazwa	Typ	Opis
`trashed`	`Boolean`	`true`, jeśli `Folder` powinno zostać przeniesione do kosza na Dysku użytkownika. Jeśli nie, `false`

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

Metody wycofane

`addFile(child)`

Wycofane. Zamiast niego użyj parametru File.moveTo(destination) lub createShortcut(targetId).

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

Parametry

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

Zwróć

Folder – nowy element nadrzędny pliku dodanego jako potomny.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`addFolder(child)`

Wycofane. Zamiast niego użyj parametru moveTo(destination) lub createShortcut(targetId).

Dodaje określony folder do bieżącego folderu. Ta metoda nie powoduje przeniesienia folderu poza istniejący folder nadrzędny. Może być jednocześnie więcej niż 1 nadrzędny folder.

Parametry

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

Zwróć

Folder – nowy element nadrzędny folderu dodanego jako element podrzędny.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`removeFile(child)`

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

Usuwa określony plik z bieżącego folderu. Ta metoda nie powoduje usunięcia pliku, ale jeśli zostanie on usunięty ze wszystkich elementów nadrzędnych, nie będzie widoczny na Dysku, chyba że wyszukaj go lub użyjesz widoku „Wszystkie elementy”.

Parametry

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

Zwróć

Folder – poprzedni element podrzędny elementu podrzędnego,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`removeFolder(child)`

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

Usuwa określony folder z bieżącego. Ta metoda nie powoduje usunięcia folderu ani jego zawartości, ale jeśli folder zostanie usunięty ze wszystkich elementów nadrzędnych, nie będzie widoczny na Dysku, chyba że będziesz go szukać lub w widoku „Wszystkie elementy”.

Parametry

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

Zwróć

Folder – poprzedni element podrzędny elementu podrzędnego,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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