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

Class Folder

Folder na Dysku Google. Foldery są dostępne i tworzone w usłudze 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 danego użytkownika do listy edytorów zasobu `Folder`.
`addEditor(user)`	`Folder`	Dodaje danego użytkownika do listy edytorów zasobu `Folder`.
`addEditors(emailAddresses)`	`Folder`	Dodaje podaną tablicę użytkowników do listy edytorów zasobu `Folder`.
`addViewer(emailAddress)`	`Folder`	Dodaje danego użytkownika do listy przeglądających w: `Folder`.
`addViewer(user)`	`Folder`	Dodaje danego użytkownika do listy przeglądających w: `Folder`.
`addViewers(emailAddresses)`	`Folder`	Dodaje podaną tablicę użytkowników do listy przeglądających obiekt `Folder`.
`createFile(blob)`	`File`	Tworzy plik w bieżącym folderze na podstawie wybranych danych (`Blob`).
`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 folder o podanej nazwie w bieżącym folderze.
`createShortcut(targetId)`	`File`	Tworzy skrót do podanego identyfikatora elementu na Dysku i zwraca ten identyfikator.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Tworzy skrót do podanego identyfikatora elementu na Dysku i klucza zasobu i zwraca ten skrót.
`getAccess(email)`	`Permission`	Pobiera uprawnienie przyznane danemu użytkownikowi.
`getAccess(user)`	`Permission`	Pobiera uprawnienie przyznane danemu użytkownikowi.
`getDateCreated()`	`Date`	Otrzymuje datę utworzenia elementu `Folder`.
`getDescription()`	`String`	Pobiera opis elementu `Folder`.
`getEditors()`	`User[]`	Pobiera listę edytorów elementu `Folder`.
`getFiles()`	`FileIterator`	Pobiera kolekcję wszystkich plików podrzędnych względem bieżącego folderu.
`getFilesByName(name)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są podrzędne względem bieżącego folderu i mają podaną nazwę.
`getFilesByType(mimeType)`	`FileIterator`	Pobiera kolekcję wszystkich plików podrzędnych względem bieżącego folderu i o podanym typie MIME.
`getFolders()`	`FolderIterator`	Pobiera kolekcję wszystkich folderów podrzędnych folderu bieżącego.
`getFoldersByName(name)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów, które są folderami podrzędnymi bieżącego folderu i mają podaną nazwę.
`getId()`	`String`	Pobiera identyfikator elementu `Folder`.
`getLastUpdated()`	`Date`	Pobiera datę ostatniej aktualizacji urządzenia `Folder`.
`getName()`	`String`	Pobiera nazwę elementu `Folder`.
`getOwner()`	`User`	Pobiera właściciela tego elementu (`Folder`).
`getParents()`	`FolderIterator`	Pobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnymi folderu `Folder`.
`getResourceKey()`	`String`	Pobiera klucz zasobu `Folder` wymagany, aby uzyskać dostęp do elementów, które zostały udostępnione za pomocą linku.
`getSecurityUpdateEligible()`	`Boolean`	Określa, czy to urządzenie `Folder` kwalifikuje się do stosowania aktualizacji zabezpieczeń, która wymaga klucza zasobu, aby uzyskać dostęp, gdy jest on udostępniany za pomocą linku.
`getSecurityUpdateEnabled()`	`Boolean`	Określa, czy `Folder` wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępnione za pomocą linku.
`getSharingAccess()`	`Access`	Pobiera klasę użytkowników, którzy mają dostęp do: `Folder` (oprócz poszczególnych osób) użytkownikom, którym wprost przyznano dostęp.
`getSharingPermission()`	`Permission`	pobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do: `Folder`, oprócz poszczególnych użytkowników, którym wprost przyznano dostęp.
`getSize()`	`Integer`	Pobiera liczbę bajtów używanych do przechowywania elementu `Folder` na Dysku.
`getUrl()`	`String`	Uzyskuje adres URL, którego można użyć do otwarcia pliku `Folder` w aplikacji Google, np. Dysk lub Dokumenty.
`getViewers()`	`User[]`	Pobiera listę przeglądających i komentujących dla elementu `Folder`.
`isShareableByEditors()`	`Boolean`	Określa, czy użytkownicy z uprawnieniami do edycji zasobu `Folder` mogą udostępnić innym użytkownikom lub zmienić uprawnienia.
`isStarred()`	`Boolean`	Określa, czy element `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 edytorów zasobu `Folder`.
`removeEditor(user)`	`Folder`	Usuwa danego użytkownika z listy edytorów zasobu `Folder`.
`removeViewer(emailAddress)`	`Folder`	Usuwa dane użytkownika z listy przeglądających i komentujących `Folder`.
`removeViewer(user)`	`Folder`	Usuwa dane użytkownika z listy przeglądających i komentujących `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Odbierze uprawnienia `Folder` przyznane danemu użytkownikowi.
`revokePermissions(user)`	`Folder`	Odbierze uprawnienia `Folder` przyznane danemu użytkownikowi.
`searchFiles(params)`	`FileIterator`	Pobiera zbiór wszystkich plików podrzędnych względem bieżącego folderu i które pasują do danego wyszukiwania kryteria.
`searchFolders(params)`	`FolderIterator`	Pobiera zbiór wszystkich folderów podrzędnych bieżącego folderu i pasujących do podanego wyszukiwania kryteria.
`setDescription(description)`	`Folder`	Ustawia opis elementu `Folder`.
`setName(name)`	`Folder`	Określa 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, aby uzyskać dostęp, gdy jest udostępnione za pomocą linku.
`setShareableByEditors(shareable)`	`Folder`	Określa, czy użytkownicy z uprawnieniami do edycji w elemencie `Folder` mogą udostępniać treści innym użytkownikom lub zmienić uprawnienia.
`setSharing(accessType, permissionType)`	`Folder`	Określa, które klasy użytkowników mają dostęp do elementu `Folder` i jakie uprawnienia użytkownicy, którym przyznano dostęp wprost.
`setStarred(starred)`	`Folder`	Określa, czy element `Folder` jest oznaczony gwiazdką na Dysku użytkownika.
`setTrashed(trashed)`	`Folder`	Określa, czy `Folder` znajduje się w koszu Dysku użytkownika.

Wycofane metody

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

Szczegółowa dokumentacja

`addEditor(emailAddress)`

Dodaje danego użytkownika do listy edytorów zasobu Folder. 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

Folder – Folder 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/drive

`addEditor(user)`

Dodaje danego użytkownika do listy edytorów zasobu Folder. 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

Folder – Folder 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/drive

`addEditors(emailAddresses)`

Dodaje podaną tablicę użytkowników do listy edytorów zasobu Folder. 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

Folder – Folder 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/drive

`addViewer(emailAddress)`

Dodaje danego użytkownika do listy przeglądających w: Folder. 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

Folder – Folder 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/drive

`addViewer(user)`

Dodaje danego użytkownika do listy przeglądających w: Folder. 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

Folder – Folder 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/drive

`addViewers(emailAddresses)`

Dodaje podaną tablicę użytkowników do listy przeglądających obiekt Folder. 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

Folder – Folder 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/drive

`createFile(blob)`

Tworzy plik w bieżącym folderze na podstawie wybranych danych (Blob).

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

Powrót

File – nowy plik.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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. Wyrzuca wyjątek, jeśli rozmiar 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.

Powrót

File – nowy plik.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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. Rzuty wyjątek, jeśli rozmiar 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.

Powrót

File – nowy plik.

Autoryzacja

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

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

`createFolder(name)`

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

Parametry

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

Powrót

Folder – nowy folder.

Autoryzacja

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

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

`createShortcut(targetId)`

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

Parametry

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

Powrót

File – nowy skrót.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 i zwraca ten skrót. Zasób klucz to dodatkowy parametr, który musi zostać przekazany, aby uzyskać dostęp do docelowego pliku lub folderu, który Element został udostępniony 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 pliku lub folderu docelowego.
`targetResourceKey`	`String`	Klucz zasobu docelowego pliku lub folderu.

Powrót

File – nowy skrót.

Autoryzacja

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

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

`getAccess(email)`

Pobiera uprawnienie przyznane danemu użytkownikowi.

Parametry

Nazwa	Typ	Opis
`email`	`String`	adres e-mail użytkownika, którego uprawnienia powinny zostać sprawdzone.

Powrót

Permission – uprawnienia przyznane użytkownikowi;

Autoryzacja

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

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

`getAccess(user)`

Pobiera uprawnienie przyznane danemu użytkownikowi.

Parametry

Nazwa	Typ	Opis
`user`	`User`	reprezentacja użytkownika, którego uprawnienia powinny zostać sprawdzone

Powrót

Permission – uprawnienia przyznane użytkownikowi;

Autoryzacja

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

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

`getDateCreated()`

Otrzymuje datę utworzenia elementu Folder.

Powrót

Date – data utworzenia elementu Folder;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 pola Folder.

Autoryzacja

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

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

`getEditors()`

Pobiera listę edytorów elementu Folder. Jeśli użytkownik, który wykonuje skrypt nie ma uprawnień do edycji obiektu 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 (editor of editors) {
  console.log(editor.getName());
}

Powrót

User[] – lista edytorów elementu Folder, jeśli użytkownik ma uprawnienia do edycji lub w przeciwnym razie pusta tablica.

Autoryzacja

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

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

`getFiles()`

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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ą podrzędne względem bieżącego folderu i mają podaną nazwę.

Parametry

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

Powrót

FileIterator – zbiór wszystkich plikó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 co najmniej jednym z tych zakresów:

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

`getFilesByType(mimeType)`

Pobiera kolekcję wszystkich plików podrzędnych względem bieżącego folderu i o podanym typie MIME.

Parametry

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

Powrót

FileIterator – zbiór wszystkich plików podrzędnych względem bieżącego folderu i zawierających podany kod MIME. typu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 folderu bieżącego.

Powrót

FolderIterator – kolekcja wszystkich folderów podrzędnych folderu bieżącego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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ą folderami podrzędnymi 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 o podanej nazwie, które są folderami podrzędnymi bieżącego folderu.

Autoryzacja

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

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

`getId()`

Pobiera identyfikator elementu Folder.

Powrót

String – identyfikator instancji Folder,

Autoryzacja

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

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

`getLastUpdated()`

Pobiera datę ostatniej aktualizacji urządzenia Folder.

Powrót

Date – data ostatniej aktualizacji elementu Folder.

Autoryzacja

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

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

`getName()`

Pobiera nazwę elementu Folder.

Powrót

String – nazwa Folder

Autoryzacja

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

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

`getOwner()`

Pobiera właściciela tego elementu (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 elementu (Folder).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 folderu Folder.

Powrót

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

Autoryzacja

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

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

`getResourceKey()`

Pobiera klucz zasobu Folder wymagany, aby uzyskać dostęp do elementów, które zostały udostępnione za pomocą linku.

Powrót

String – klucz zasobu klasy Folder.

Autoryzacja

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

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

`getSecurityUpdateEligible()`

Określa, czy to urządzenie Folder kwalifikuje się do stosowania aktualizacji zabezpieczeń, która wymaga klucza zasobu, aby uzyskać dostęp, gdy jest on 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ą . Ta zmiana jest częścią aktualizacji zabezpieczeń. Aktualizacja jest domyślnie włączona dla kwalifikujących się użytkowników pliki i foldery. Aby włączyć lub wyłączyć wymaganie dotyczące klucza zasobu w przypadku kwalifikujących się plików, użyj polecenia setSecurityUpdateEnabled

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

Powrót

Boolean – określa, czy wymaganie dotyczące klucza zasobu można zastosować do Folder.

Autoryzacja

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

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

`getSecurityUpdateEnabled()`

Określa, czy Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępnione 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 dotyczące klucza zasobu w przypadku kwalifikujących się plików, użyj funkcji setSecurityUpdateEnabled.

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

Powrót

Boolean – określa, czy w przypadku tego zasobu (Folder) włączone jest wymaganie dotyczące klucza zasobu.

Autoryzacja

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

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

`getSharingAccess()`

Pobiera klasę użytkowników, którzy mają dostęp do: Folder (oprócz poszczególnych osób) użytkownikom, którym wprost przyznano dostęp.

Powrót

Access – klasa użytkowników, którzy mają dostęp do pliku Folder.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 poszczególnych użytkowników, którym wprost przyznano dostęp.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 elementu Folder na Dysku. Pamiętaj, że Pliki aplikacji Google Workspace nie wliczają się do limitu miejsca na Dysku, więc nie wliczają się do limitu miejsca na Dysku. 0 B.

Powrót

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

Autoryzacja

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

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

`getUrl()`

Uzyskuje adres URL, którego można użyć do otwarcia pliku Folder w aplikacji Google, np. Dysk lub Dokumenty.

Powrót

String – adres URL umożliwiający wyświetlenie elementu Folder w aplikacji Google, np. Dysk lub Dokumenty

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 dla elementu Folder. Jeśli użytkownik, który uruchamia skrypt, nie ma uprawnień do edycji elementu 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 (viewer of viewers) {
  console.log(viewer.getName());
}

Powrót

User[] – lista przeglądających i komentujących element Folder, jeśli użytkownik dokonał edycji. dostępu, a w przeciwnym razie pustej tablicy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 zasobu Folder mogą udostępnić innym użytkownikom lub zmienić uprawnienia.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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, jeśli nie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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ć co najmniej uprawnienia do edycji elementu w bieżącym folderze nadrzędnym, aby przenieść element do folderu docelowego.

Parametry

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

Powrót

Folder – Folder 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/drive

`removeEditor(emailAddress)`

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

Folder – Folder 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/drive

`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

Folder – Folder 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/drive

`removeViewer(emailAddress)`

Usuwa dane użytkownika z listy przeglądających i komentujących Folder. 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 Folder użytkownikom, którzy należą do klasy użytkowników, mieć ogólny dostęp – na przykład jeśli domena Folder została udostępniona domenie całej domeny 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 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

Folder – Folder 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/drive

`removeViewer(user)`

Usuwa dane użytkownika z listy przeglądających i komentujących Folder. Ten nie ma zastosowania, jeśli użytkownik jest edytorem, a nie przeglądającym. Ta metoda nie blokuje też dostępu do funkcji Folder 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 Folder został 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 też usunięcie użytkownika z listy redaktorów.

Parametry

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

Powrót

Folder – Folder 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/drive

`revokePermissions(emailAddress)`

Odbierze uprawnienia Folder przyznane danemu użytkownikowi. Ta metoda nie: zablokuj dostęp do usługi Folder użytkownikom, którzy należą do klasy użytkowników, mieć ogólny dostęp – jeśli na przykład element Folder został udostępniony domenie całą domenę.

Parametry

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

Powrót

Folder – Folder 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/drive

`revokePermissions(user)`

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika, któremu chcesz odebrać dostęp.

Powrót

Folder – Folder 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/drive

`searchFiles(params)`

Pobiera zbiór wszystkich plików podrzędnych względem bieżącego folderu i które pasują do danego wyszukiwania kryteria. Szczegółowe informacje o kryteriach wyszukiwania znajdziesz w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że Dysk usługa korzysta z interfejsu Drive API w wersji 2, a niektóre pola zapytania różnią się od wersji 3. Przeanalizuj pole różnice między wersjami 2 i 3.

Argument params to ciąg zapytania, który może zawierać wartości w postaci ciągów znaków, dlatego zachowaj ostrożność. aby prawidłowo zmienić znaczenie cudzysłowów (na przykład "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 opisane w dokumentacji pakietu SDK Dysku Google;

Powrót

FileIterator – zbiór wszystkich plików podrzędnych względem bieżącego folderu i pasujących do wyszukiwania. kryteria.

Autoryzacja

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

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

`searchFolders(params)`

Pobiera zbiór wszystkich folderów podrzędnych bieżącego folderu i pasujących do podanego wyszukiwania kryteria. Szczegółowe informacje o kryteriach wyszukiwania znajdziesz w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że Dysk usługa korzysta z interfejsu Drive API w wersji 2, a niektóre pola zapytania różnią się od wersji 3. Przeanalizuj pole różnice 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 opisane w dokumentacji pakietu SDK Dysku Google;

Powrót

FolderIterator – zbiór wszystkich folderów podrzędnych z bieżącego folderu i pasujących do wyszukiwania. kryteria.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 dla: `Folder`

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

`setName(name)`

Określa nazwę elementu Folder.

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nowa nazwa usługi `Folder`

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

`setOwner(emailAddress)`

Zmienia właściciela: Folder. Ta metoda przypisuje również poprzedniemu właścicielowi użytkowników z uprawnieniami do edycji elementu Folder.

Parametry

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

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

`setOwner(user)`

Zmienia właściciela: Folder. Ta metoda przypisuje również poprzedniemu właścicielowi użytkowników z uprawnieniami do edycji elementu Folder.

Parametry

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

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

`setSecurityUpdateEnabled(enabled)`

Określa, czy Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępnione 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`	Określa, czy włączyć wymaganie dotyczące klucza zasobu w `Folder`.

Powrót

Folder – Folder 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/drive

`setShareableByEditors(shareable)`

Określa, czy użytkownicy z uprawnieniami do edycji w elemencie Folder mogą udostępniać treści innym użytkownikom lub zmienić uprawnienia. Ustawienie domyślne nowego modelu Folder to true

Parametry

Nazwa	Typ	Opis
`shareable`	`Boolean`	`true`, jeśli użytkownicy z uprawnieniami do edycji powinni mieć możliwość udostępniania treści tym osobom: innym użytkownikom ani zmieniać uprawnień; `false`, jeśli nie

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

`setSharing(accessType, permissionType)`

Określa, które klasy użytkowników mają dostęp do elementu Folder i jakie uprawnienia użytkownicy, którym przyznano dostęp wprost.

// 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`	grupy użytkowników, którzy powinni mieć dostęp do `Folder`
`permissionType`	`Permission`	uprawnienia użytkowników mających dostęp do `Folder`

Powrót

Folder – Folder, łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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ślna wartość dla nowe Folder są false.

Parametry

Nazwa	Typ	Opis
`starred`	`Boolean`	`true`, jeśli element `Folder` powinien być oznaczony gwiazdką w sekcji Dysk; `false`, jeśli nie

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

`setTrashed(trashed)`

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

Parametry

Nazwa	Typ	Opis
`trashed`	`Boolean`	`true`, jeśli element `Folder` ma zostać przeniesiony do kosza Dysk użytkownika; `false`, jeśli nie

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

Wycofane metody

`addFile(child)`

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

Dodaje dany plik do bieżącego folderu. Ta metoda nie przenosi pliku z istniejący folder nadrzędny; plik może mieć więcej niż 1 element nadrzędny jednocześnie.

Parametry

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

Powrót

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

Autoryzacja

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

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

`addFolder(child)`

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

Dodaje dany folder do bieżącego folderu. Ta metoda nie powoduje przeniesienia folderu z jego istniejący folder nadrzędny; folder może mieć jednocześnie więcej niż 1 element nadrzędny.

Parametry

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 dany plik z bieżącego folderu. Ta metoda nie usuwa pliku, ale Jeśli plik zostanie usunięty ze wszystkich elementów nadrzędnych, nie będzie go można zobaczyć na Dysku, chyba że przeprowadzisz wyszukiwanie lub za pomocą opcji „Wszystkie elementy” widok.

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 co najmniej jednym z tych zakresów:

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

`removeFolder(child)`

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

Usuwa dany folder z bieżącego folderu. Ta metoda nie usuwa folderu lub jego zawartości, ale jeśli zostanie on usunięty ze wszystkich swoich folderów nadrzędnych, nie będzie go widać na Dysku z wyjątkiem wyszukiwania lub użycia opcji „Wszystkie elementy” widok.

Parametry

Nazwa	Typ	Opis
`child`	`Folder`	Folder 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 co najmniej jednym z tych zakresów:

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