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

Class Folder

folder na Dysku Google, Foldery można otwierać i tworzyć w 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 danego użytkownika do listy edytujących `Folder`.
`addEditor(user)`	`Folder`	Dodaje danego użytkownika do listy edytujących `Folder`.
`addEditors(emailAddresses)`	`Folder`	Dodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku `Folder`.
`addViewer(emailAddress)`	`Folder`	Dodaje danego użytkownika do listy widzów `Folder`.
`addViewer(user)`	`Folder`	Dodaje danego użytkownika do listy widzów `Folder`.
`addViewers(emailAddresses)`	`Folder`	Dodaje podany tablicowy zbiór użytkowników do listy widzów `Folder`.
`createFile(blob)`	`File`	Tworzy plik w bieżącym folderze na podstawie dowolnych danych z podanego zbioru danych `Blob`.
`createFile(name, content)`	`File`	Tworzy plik tekstowy w bieżącym folderze o podanej nazwie i treści.
`createFile(name, content, mimeType)`	`File`	Tworzy plik w bieżącym folderze z podaną nazwą, treścią i typem 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 go.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Tworzy i zwraca skrót do podanego identyfikatora elementu i klucza zasobu na Dysku.
`getAccess(email)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getAccess(user)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getDateCreated()`	`Date`	Pobiera datę utworzenia elementu `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ą podrzędnymi 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, które są podrzędnymi bieżącego folderu i mają podany typ MIME.
`getFolders()`	`FolderIterator`	Pobiera kolekcję wszystkich folderów podrzędnych 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 elementu `Folder`.
`getName()`	`String`	Pobiera nazwę `Folder`.
`getOwner()`	`User`	Pobiera właściciela tego `Folder`.
`getParents()`	`FolderIterator`	Pobiera kolekcję folderów, które są bezpośrednimi folderami nadrzędnymi folderu `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 `Folder` może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniana za pomocą linku.
`getSecurityUpdateEnabled()`	`Boolean`	Pobiera informację, czy ten `Folder` wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku.
`getSharingAccess()`	`Access`	Pobiera informacje o klasie użytkowników, którzy mogą uzyskać dostęp do `Folder`, z wyjątkiem użytkowników, którzy mają wyraźnie przyznany dostęp.
`getSharingPermission()`	`Permission`	Pobiera uprawnienia przyznane użytkownikom, którzy mogą uzyskać dostęp do `Folder`, z wyjątkiem pojedynczych użytkowników, którym dostęp został wyraźnie przyznany.
`getSize()`	`Integer`	Pobiera liczbę bajtów użytych do przechowywania `Folder` na Dysku.
`getUrl()`	`String`	Pobiera adres URL, za pomocą którego można otworzyć `Folder` w aplikacji Google, takiej jak Dysk lub Dokumenty.
`getViewers()`	`User[]`	Pobiera listę osób, które oglądały lub komentowały ten `Folder`.
`isShareableByEditors()`	`Boolean`	Określa, czy użytkownicy z uprawnieniami do edycji w `Folder` mogą udostępniać inne uprawnienia innym użytkownikom lub zmieniać uprawnienia.
`isStarred()`	`Boolean`	Określa, czy `Folder` zostało oznaczone 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`	Usunięcie danego użytkownika z listy edytujących w przypadku `Folder`.
`removeEditor(user)`	`Folder`	Usunięcie danego użytkownika z listy edytujących w przypadku `Folder`.
`removeViewer(emailAddress)`	`Folder`	Usunięcie danego użytkownika z listy widzów i komentujących `Folder`.
`removeViewer(user)`	`Folder`	Usunięcie danego użytkownika z listy widzów i komentujących `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Unieważnia przyznany danemu użytkownikowi dostęp do `Folder`.
`revokePermissions(user)`	`Folder`	Unieważnia przyznany danemu użytkownikowi dostęp do `Folder`.
`searchFiles(params)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są podrzędne bieżącego folderu i spełniają podane kryteria wyszukiwania.
`searchFolders(params)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów, które są podfolderami bieżącego folderu i pasują do podanych kryteriów wyszukiwania.
`setDescription(description)`	`Folder`	Ustawia opis `Folder`.
`setName(name)`	`Folder`	Ustawia nazwę `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ępniany za pomocą linku.
`setShareableByEditors(shareable)`	`Folder`	Określa, czy użytkownicy z uprawnieniami do edycji w `Folder` mogą udostępniać innym użytkownikom lub zmieniać uprawnienia.
`setSharing(accessType, permissionType)`	`Folder`	Określa, które grupy użytkowników mogą uzyskać dostęp do `Folder` i jakie uprawnienia zostaną im przyznane, z wyłączeniem użytkowników indywidualnych, którzy uzyskali dostęp wprost.
`setStarred(starred)`	`Folder`	Określa, czy `Folder` ma być oznaczone 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 danego użytkownika do listy edytujących Folder. Jeśli użytkownik był już na liście widzów, ta metoda powoduje usunięcie go z tej listy.

Parametry

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

Powrót

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

Autoryzacja

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

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

`addEditor(user)`

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

Parametry

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

Powrót

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

Autoryzacja

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

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

`addEditors(emailAddresses)`

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

Parametry

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

Powrót

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

Autoryzacja

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

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

`addViewer(emailAddress)`

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

Parametry

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

Powrót

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

Autoryzacja

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

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

`addViewer(user)`

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

Parametry

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

Powrót

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

Autoryzacja

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

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

`addViewers(emailAddresses)`

Dodaje podany tablicowy zbiór 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 – ta Folder służy do tworzenia łańcuszków.

Autoryzacja

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

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

`createFile(blob)`

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

Parametry

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

Powrót

File – nowy plik.

Autoryzacja

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

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

`createFile(name, content)`

Tworzy plik tekstowy w bieżącym folderze o podanej nazwie i treści. Wyjątek, jeśli 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`	Treść nowego pliku.

Powrót

File – nowy plik.

Autoryzacja

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

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

`createFile(name, content, mimeType)`

Tworzy plik w bieżącym folderze z podaną nazwą, treścią i typem MIME. Wyjątek jest rzucany, jeśli 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, które korzystają 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, które korzystają 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 go.

Parametry

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

Powrót

File – nowy skrót.

Autoryzacja

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

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

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

Tworzy i zwraca skrót do podanego identyfikatora elementu i klucza zasobu na Dysku. Klucz zasobu to dodatkowy parametr, który musi zostać przekazany, 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, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym 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ń grupy dyskusyjnej Google ani uprawnień odziedziczonych 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, które korzystają 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 uprawnienia przyznane konkretnemu użytkownikowi. Ta metoda nie obsługuje zwracania uprawnień grupy dyskusyjnej Google ani uprawnień odziedziczonych 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, które korzystają 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()`

Pobiera datę utworzenia elementu Folder.

Powrót

Date – data utworzenia Folder

Autoryzacja

Skrypty, które korzystają 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 elementu Folder,

Autoryzacja

Skrypty, które korzystają 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 tego Folder. Jeśli użytkownik, który wykonuje skrypt, nie ma uprawnień do edycji obiektu Folder, ta metoda zwraca pusty 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 pusty tablicowy zbiór, jeśli nie.

Autoryzacja

Skrypty, które korzystają 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, które są podrzędnymi bieżącego folderu.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 – kolekcja wszystkich plików, które są podrzędnymi bieżącego folderu i mają określoną nazwę.

Autoryzacja

Skrypty, które korzystają 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, które są 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ą podrzędnymi bieżącego folderu i mają dany typ MIME.

Autoryzacja

Skrypty, które korzystają 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 bieżącego folderu.

Powrót

FolderIterator – kolekcja wszystkich folderów, które są podrzędne bieżącemu folderowi.

Autoryzacja

Skrypty, które korzystają 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ą 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 – kolekcja wszystkich folderów podrzędnych bieżącego folderu o danej nazwie.

Autoryzacja

Skrypty, które korzystają 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 Folder.

Powrót

String – identyfikator Folder

Autoryzacja

Skrypty, które korzystają 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 elementu Folder.

Powrót

Date – data ostatniej aktualizacji Folder

Autoryzacja

Skrypty, które korzystają 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ę Folder.

Powrót

String – nazwa Folder

Autoryzacja

Skrypty, które korzystają 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 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 zasobu Folder.

Autoryzacja

Skrypty, które korzystają 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 folderami nadrzędnymi folderu Folder.

Powrót

FolderIterator – kolekcja folderów, które są bezpośrednimi folderami nadrzędnymi folderu Folder

Autoryzacja

Skrypty, które korzystają 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, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.

Powrót

String – klucz zasobu Folder.

Autoryzacja

Skrypty, które korzystają 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 Folder może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniana 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ć wymóg klucza zasobu w przypadku kwalifikujących się plików, użyj opcji setSecurityUpdateEnabled.

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

Powrót

Boolean – czy można zastosować wymóg klucza zasobu w przypadku Folder.

Autoryzacja

Skrypty, które korzystają 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()`

Pobiera informację, czy ten Folder wymaga klucza zasobu, aby uzyskać dostęp, 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ć wymóg klucza zasobu w przypadku kwalifikujących się plików, użyj setSecurityUpdateEnabled.

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

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 informacje o klasie użytkowników, którzy mogą uzyskać dostęp do Folder, z wyjątkiem użytkowników, którzy mają wyraźnie przyznany dostęp.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 mogą uzyskać dostęp do Folder, z wyjątkiem pojedynczych użytkowników, którym dostęp został wyraźnie przyznany.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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żytych do przechowywania Folder na Dysku. Pamiętaj, że pliki aplikacji Google Workspace nie są wliczane do limitu miejsca na dane na Dysku, dlatego zwracane są bajty 0.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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()`

Pobiera adres URL, za pomocą którego można otworzyć 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, które korzystają 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ę osób, które oglądały lub komentowały ten Folder. Jeśli użytkownik, który wykonuje skrypt, nie ma uprawnień do edycji obiektu Folder, ta metoda zwraca pusty 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 widzów i komentatorów tego Folder, jeśli użytkownik ma uprawnienia do edycji, lub pusty tablicowy zbiór w przeciwnym razie.

Autoryzacja

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

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

`isShareableByEditors()`

Określa, czy użytkownicy z uprawnieniami do edycji Folder mogą udostępniać inne uprawnienia 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, które korzystają 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 Folder zostało oznaczone gwiazdką na Dysku użytkownika.

Powrót

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

Autoryzacja

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

https://www.googleapis.com/auth/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, które korzystają 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.

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

Parametry

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

Powrót

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

Autoryzacja

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

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

`removeEditor(emailAddress)`

Usunięcie danego użytkownika z listy edytujących w przypadku Folder. Ta metoda nie blokuje dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, 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 widzów.

Parametry

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

Powrót

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

Autoryzacja

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

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

`removeEditor(user)`

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

Parametry

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

Powrót

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

Autoryzacja

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

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

`removeViewer(emailAddress)`

Usunięcie danego użytkownika z listy widzów i komentujących Folder. Ta metoda nie ma żadnego wpływu, jeśli użytkownik jest edytorem, a nie widzem lub komentatorem. Ta metoda nie blokuje też dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, 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 edytorów.

Parametry

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

Powrót

Folder – Folder do łańcucha.

Autoryzacja

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

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

`removeViewer(user)`

Usunięcie danego użytkownika z listy widzów i komentujących Folder. Ta metoda nie ma żadnego wpływu, jeśli użytkownik jest edytorem, a nie widzem. Ta metoda nie blokuje też dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład 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.Folder

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

Parametry

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

Powrót

Folder – Folder do łańcucha.

Autoryzacja

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

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

`revokePermissions(emailAddress)`

Unieważnia przyznany danemu użytkownikowi dostęp do Folder. Ta metoda nie blokuje dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. 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 chcesz odebrać dostęp.

Powrót

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

Autoryzacja

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

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

`revokePermissions(user)`

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika, którego uprawnienia dostępu należy cofnąć.

Powrót

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

Autoryzacja

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

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

`searchFiles(params)`

Pobiera kolekcję wszystkich plików, które są podrzędne bieżącego folderu i pasują do podanych kryteriów wyszukiwania. Kryteria wyszukiwania zostały opisane w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z wersji 2 interfejsu Drive API, a niektóre pola zapytania różnią się od wersji 3. Zapoznaj się z różnicami między polami w wersji 2 a 3.

Argument params to ciąg znaków zapytania, który może zawierać wartości ciągu znaków, więc należy poprawnie stosować znaki cudzysłowe (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 opisane w dokumentacji pakietu SDK Dysku Google.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 kolekcję wszystkich folderów, które są podfolderami bieżącego folderu i pasują do podanych kryteriów wyszukiwania. Kryteria wyszukiwania zostały opisane w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z wersji 2 interfejsu Drive API, a niektóre pola zapytania różnią się od wersji 3. Zapoznaj się z różnicami między polami w wersji 2 a 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 opisane w dokumentacji pakietu SDK Dysku Google.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 Folder.

Parametry

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

Powrót

Folder – ta Folder, aby utworzyć łańcuch

Autoryzacja

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

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

`setName(name)`

Ustawia nazwę Folder.

Parametry

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

Powrót

Folder – ta Folder, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 daje również poprzedniemu właścicielowi wyraźny dostęp do edycji Folder.

Parametry

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

Powrót

Folder – ta Folder, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 daje również poprzedniemu właścicielowi wyraźny dostęp do edycji Folder.

Parametry

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

Powrót

Folder – ta Folder, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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ę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`	Określa, czy w przypadku `Folder` ma być wymagany klucz zasobu.

Powrót

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

Autoryzacja

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

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

`setShareableByEditors(shareable)`

Określa, czy użytkownicy z uprawnieniami do edycji w Folder mogą udostępniać innym użytkownikom lub zmieniać uprawnienia. Wartość domyślna dla nowego typu 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 zmieniania uprawnień; `false` jeśli nie

Powrót

Folder – ta Folder, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 grupy użytkowników mogą uzyskać dostęp do Folder i jakie uprawnienia zostaną im przyznane, z wyłączeniem użytkowników indywidualnych, którzy uzyskali 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.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametry

Nazwa	Typ	Opis
`accessType`	`Access`	klasa użytkowników, która powinna mieć dostęp do `Folder`
`permissionType`	`Permission`	uprawnienia, które należy przyznać użytkownikom mającym dostęp do `Folder`.

Powrót

Folder – ta Folder, aby utworzyć łańcuch

Autoryzacja

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

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

`setStarred(starred)`

Określa, czy Folder ma być oznaczone gwiazdką na Dysku użytkownika. Wartość domyślna dla nowych Folderto false.

Parametry

Nazwa	Typ	Opis
`starred`	`Boolean`	`true`, jeśli `Folder` ma być oznaczone gwiazdką na Dysku użytkownika; `false` w przeciwnym razie

Powrót

Folder – ta Folder, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 na Dysku użytkownika. Tylko właściciel może przenieść Folder do kosza. Wartość domyślna dla nowych typów Folder to false.

Parametry

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

Powrót

Folder – ta Folder, aby utworzyć łańcuch

Autoryzacja

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

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

Wycofane metody

`addFile(child)`

Wycofany. Zamiast tego użyj pola File.moveTo(destination) lub createShortcut(targetId).

Dodaje podany plik do bieżącego folderu. Ta metoda nie powoduje przeniesienia pliku z jego 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 nadrzędny pliku dodanego jako podrzędny.

Autoryzacja

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

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

`addFolder(child)`

Wycofany. Zamiast tego użyj pola moveTo(destination) lub createShortcut(targetId).

Dodaje podany folder do bieżącego folderu. Ta metoda nie powoduje przeniesienia 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 jako podrzędny.

Autoryzacja

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

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

`removeFile(child)`

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

Usuwa podany plik z bieżącego folderu. Ta metoda nie powoduje usunięcia pliku, ale jeśli zostanie on 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, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`removeFolder(child)`

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

Usuwa podany folder z bieżącego folderu. Ta metoda nie powoduje usunięcia 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 podrzędny, który chcesz usunąć.

Powrót

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

Autoryzacja

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

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