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

Class Folder

Folder na Dysku Google. Dostęp do folderów i możliwość ich tworzenia możesz uzyskać tutaj: 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 wskazanego użytkownika do listy edytorów w `Folder`.
`addEditor(user)`	`Folder`	Dodaje wskazanego użytkownika do listy edytorów w `Folder`.
`addEditors(emailAddresses)`	`Folder`	Dodaje podaną tablicę użytkowników do listy edytorów elementu `Folder`.
`addViewer(emailAddress)`	`Folder`	Dodaje danego użytkownika do listy przeglądających stronę `Folder`.
`addViewer(user)`	`Folder`	Dodaje danego użytkownika do listy przeglądających stronę `Folder`.
`addViewers(emailAddresses)`	`Folder`	Dodaje podaną tablicę użytkowników do listy osób przeglądających element `Folder`.
`createFile(blob)`	`File`	Tworzy plik w bieżącym folderze na podstawie dowolnych 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, a następnie go zwraca.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Tworzy skrót do podanego identyfikatora elementu na Dysku i klucza zasobu, a następnie go zwraca.
`getAccess(email)`	`Permission`	Pobiera uprawnienia przyznane danemu użytkownikowi.
`getAccess(user)`	`Permission`	Pobiera uprawnienia przyznane danemu użytkownikowi.
`getDateCreated()`	`Date`	Pobiera datę utworzenia `Folder`.
`getDescription()`	`String`	Pobiera opis obiektu `Folder`.
`getEditors()`	`User[]`	Pobiera listę edytorów tego elementu (`Folder`).
`getFiles()`	`FileIterator`	Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu.
`getFilesByName(name)`	`FileIterator`	Pobiera zbiór wszystkich plików, które są podrzędne wobec bieżącego folderu i mają podaną nazwę.
`getFilesByType(mimeType)`	`FileIterator`	Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu i mających podany typ MIME.
`getFolders()`	`FolderIterator`	Pobiera zbiór wszystkich folderów podrzędnych wobec bieżącego folderu.
`getFoldersByName(name)`	`FolderIterator`	Pobiera zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i mają podaną nazwę.
`getId()`	`String`	Pobiera identyfikator elementu `Folder`.
`getLastUpdated()`	`Date`	Pobiera datę ostatniej aktualizacji elementu `Folder`.
`getName()`	`String`	Pobiera nazwę elementu `Folder`.
`getOwner()`	`User`	Przejmuje właściciela elementu `Folder`.
`getParents()`	`FolderIterator`	Pobiera zbiór folderów, które są bezpośrednimi elementami nadrzędnymi elementu `Folder`.
`getResourceKey()`	`String`	Pobiera klucz zasobu `Folder`, który jest wymagany do uzyskania dostępu do elementów udostępnionych przy użyciu linku.
`getSecurityUpdateEligible()`	`Boolean`	Sprawdza, czy `Folder` może zastosować aktualizację zabezpieczeń, która wymaga dostępu przy użyciu klucza zasobu, gdy jest on udostępniany przy użyciu linku.
`getSecurityUpdateEnabled()`	`Boolean`	Sprawdza, czy `Folder` wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany przy użyciu linku.
`getSharingAccess()`	`Access`	Określa, która klasa użytkowników (oprócz poszczególnych użytkowników, którym przyznano dostęp) ma dostęp do `Folder`.
`getSharingPermission()`	`Permission`	Otrzymuje uprawnienia przyznane tym użytkownikom, którzy mają dostęp do elementu `Folder`, oprócz wszystkich użytkowników, którym przyznano dostęp wprost.
`getSize()`	`Integer`	Pobiera liczbę bajtów używanych do przechowywania elementu `Folder` na Dysku.
`getUrl()`	`String`	Pobiera adres URL, za pomocą którego można otworzyć plik `Folder` w aplikacji Google, takiej jak Dysk czy Dokumenty.
`getViewers()`	`User[]`	Pobiera listę przeglądających i komentujących tego elementu (`Folder`).
`isShareableByEditors()`	`Boolean`	Określa, czy użytkownicy z uprawnieniami do edycji elementu `Folder` mogą udostępniać pliki innym użytkownikom czy zmieniać uprawnienia.
`isStarred()`	`Boolean`	Określa, czy zasób `Folder` jest oznaczony gwiazdką na Dysku użytkownika.
`isTrashed()`	`Boolean`	Określa, czy zasób `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 `Folder`.
`removeEditor(user)`	`Folder`	Usuwa danego użytkownika z listy edytorów `Folder`.
`removeViewer(emailAddress)`	`Folder`	Usuwa danego użytkownika z listy przeglądających i komentujących elementu `Folder`.
`removeViewer(user)`	`Folder`	Usuwa danego użytkownika z listy przeglądających i komentujących elementu `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Unieważnia dostęp do uprawnienia `Folder` przyznanego danemu użytkownikowi.
`revokePermissions(user)`	`Folder`	Unieważnia dostęp do uprawnienia `Folder` przyznanego danemu użytkownikowi.
`searchFiles(params)`	`FileIterator`	Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu i pasujących do podanych kryteriów wyszukiwania.
`searchFolders(params)`	`FolderIterator`	Pobiera zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i spełniają określone kryteria wyszukiwania.
`setDescription(description)`	`Folder`	Ustawia opis obiektu `Folder`.
`setName(name)`	`Folder`	Ustawia nazwę: `Folder`.
`setOwner(emailAddress)`	`Folder`	Zmienia właściciela elementu `Folder`.
`setOwner(user)`	`Folder`	Zmienia właściciela elementu `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Określa, czy `Folder` wymaga klucza zasobu w celu uzyskania dostępu, gdy jest udostępniany za pomocą linku.
`setShareableByEditors(shareable)`	`Folder`	Określa, czy użytkownicy z uprawnieniami do edycji elementu `Folder` mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia.
`setSharing(accessType, permissionType)`	`Folder`	Określa, która klasa użytkowników ma dostęp do elementu `Folder` i jakie uprawnienia są im przyznane (z wyjątkiem poszczególnych użytkowników, którym przyznano dostęp bezpośrednio).
`setStarred(starred)`	`Folder`	Określa, czy `Folder` ma być oznaczony gwiazdką na Dysku użytkownika.
`setTrashed(trashed)`	`Folder`	Określa, czy zasób `Folder` znajduje się w koszu na 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 podany folder z bieżącego folderu.

Szczegółowa dokumentacja

`addEditor(emailAddress)`

Dodaje wskazanego użytkownika do listy edytorów w Folder. Jeśli użytkownik był już na liście widzów, ta metoda przesuwa go poza listę widzów.

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 wskazanego użytkownika do listy edytorów w Folder. Jeśli użytkownik był już na liście widzów, ta metoda przesuwa go poza listę widzów.

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 elementu Folder. Jeśli którykolwiek z użytkowników był już na liście widzów, ta metoda przesuwa go poza listę widzów.

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 stronę 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ć.

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 stronę 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, który ma zostać dodany.

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 osób przeglądających element Folder. Jeśli którykolwiek z użytkowników był już na liście edytorów, ta metoda nie będzie działać.

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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

Powroty

File – nowy plik.

Upoważnienie

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. Zwraca wyjątek, jeśli content ma rozmiar większy niż 50 MB.

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

Parametry

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

Powroty

File – nowy plik.

Upoważnienie

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. Jeśli rozmiar pliku content przekracza 10 MB, zgłasza wyjątek.

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

Powroty

File – nowy plik.

Upoważnienie

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.

Powroty

Folder – nowy folder.

Upoważnienie

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, a następnie go zwraca.

Parametry

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

Powroty

File – nowy skrót.

Upoważnienie

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, a następnie go zwraca. Klucz zasobu to dodatkowy parametr, który trzeba przekazać, by uzyskać dostęp do pliku docelowego lub folderu udostępnionego przy użyciu 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.

Powroty

File – nowy skrót.

Upoważnienie

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 uprawnienia przyznane danemu użytkownikowi.

Parametry

Nazwa	Typ	Opis
`email`	`String`	adres e-mail użytkownika, którego uprawnienia należy sprawdzić

Powroty

Permission – uprawnienia przyznane użytkownikowi,

Upoważnienie

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 uprawnienia przyznane danemu użytkownikowi.

Parametry

Nazwa	Typ	Opis
`user`	`User`	reprezentacja użytkownika, którego uprawnienia należy sprawdzić

Powroty

Permission – uprawnienia przyznane użytkownikowi,

Upoważnienie

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()`

Pobiera datę utworzenia Folder.

Powroty

Date – data utworzenia elementu (Folder).

Upoważnienie

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 obiektu Folder.

Powroty

String – opis kolumny Folder

Upoważnienie

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 tego elementu (Folder). Jeśli użytkownik, który wykona 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 editors and logs their names to the console.
const editors = folder.getEditors();
for (editor of editors) {
  console.log(editor.getName());
}

Powroty

User[] – lista edytorów elementu Folder, jeśli użytkownik ma uprawnienia do edycji, lub pustej tablicy w innym przypadku.

Upoważnienie

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 zbiór wszystkich plików podrzędnych bieżącego folderu.

Powroty

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

Upoważnienie

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 zbiór wszystkich plików, które są podrzędne wobec bieżącego folderu i mają podaną nazwę.

Parametry

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

Powroty

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

Upoważnienie

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 zbiór wszystkich plików podrzędnych bieżącego folderu i mających podany typ MIME.

Parametry

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

Powroty

FileIterator – zbiór wszystkich plików podrzędnych bieżącego folderu i mających podany typ MIME.

Upoważnienie

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 zbiór wszystkich folderów podrzędnych wobec bieżącego folderu.

Powroty

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

Upoważnienie

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 zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i mają podaną nazwę.

Parametry

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

Powroty

FolderIterator – zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i mają określoną nazwę.

Upoważnienie

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.

Powroty

String – identyfikator kolumny Folder,

Upoważnienie

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 elementu Folder.

Powroty

Date – data ostatniej aktualizacji obiektu Folder,

Upoważnienie

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.

Powroty

String – nazwa kolumny Folder.

Upoważnienie

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()`

Przejmuje właściciela 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());

Powroty

User – właściciel elementu Folder.

Upoważnienie

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 zbiór folderów, które są bezpośrednimi elementami nadrzędnymi elementu Folder.

Powroty

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

Upoważnienie

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, który jest wymagany do uzyskania dostępu do elementów udostępnionych przy użyciu linku.

Powroty

String – klucz zasobu Folder.

Upoważnienie

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()`

Sprawdza, czy Folder może zastosować aktualizację zabezpieczeń, która wymaga dostępu przy użyciu klucza zasobu, gdy jest on udostępniany przy użyciu linku.

Dysk wymaga klucza zasobu, aby uzyskać dostęp do niektórych plików i folderów udostępnionych przy użyciu linku. Ta zmiana jest częścią 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 kwalifikujących się plików, użyj setSecurityUpdateEnabled.

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

Powroty

Boolean – określa, czy wymaganie klucza zasobu może zostać zastosowane do Folder.

Upoważnienie

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()`

Sprawdza, czy Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany przy użyciu linku. To wymaganie jest domyślnie włączone w przypadku odpowiednich 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.

Powroty

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

Upoważnienie

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()`

Określa, która klasa użytkowników (oprócz poszczególnych użytkowników, którym przyznano dostęp) ma dostęp do Folder.

Powroty

Access – klasa użytkowników mających dostęp do elementu Folder.

Upoważnienie

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()`

Otrzymuje uprawnienia przyznane tym użytkownikom, którzy mają dostęp do elementu Folder, oprócz wszystkich użytkowników, którym przyznano dostęp wprost.

Powroty

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

Upoważnienie

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. Pliki aplikacji Google Workspace nie wliczają się do limitu miejsca na Dysku i dlatego zwracają 0 B.

Powroty

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

Upoważnienie

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()`

Pobiera adres URL, za pomocą którego można otworzyć plik Folder w aplikacji Google, takiej jak Dysk czy Dokumenty.

Powroty

String – adres URL, pod którym można wyświetlić ten element (Folder) w aplikacji Google, takiej jak Dysk czy Dokumenty

Upoważnienie

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 tego elementu (Folder). Jeśli użytkownik, który wykonuje 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());
}

Powroty

User[] – lista przeglądających i komentujących elementu Folder, jeśli użytkownik ma uprawnienia do edycji, lub pustą tablicę w innym przypadku.

Upoważnienie

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 elementu Folder mogą udostępniać pliki innym użytkownikom czy zmieniać uprawnienia.

Powroty

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

Upoważnienie

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 zasób Folder jest oznaczony gwiazdką na Dysku użytkownika.

Powroty

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

Upoważnienie

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 zasób Folder znajduje się w koszu na Dysku użytkownika.

Powroty

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

Upoważnienie

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.

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

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 Folder. Ta metoda nie blokuje użytkownikom dostępu do Folder, jeśli należą do klasy użytkowników z dostępem ogólnym – na przykład gdy zasób Folder jest udostępniany całej domenie użytkownika lub gdy 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 osób przeglądających.

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 osób przeglądających.

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 danego użytkownika z listy przeglądających i komentujących elementu Folder. Ta metoda nie działa, jeśli użytkownik jest edytującym, a nie przeglądającym lub komentującym. Ta metoda nie blokuje też użytkownikom dostępu do zasobu Folder, jeśli należą do klasy użytkowników z ogólnymi uprawnieniami dostępu – na przykład gdy Folder jest udostępniony całej domenie użytkownika lub gdy 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 edytorów.

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 danego użytkownika z listy przeglądających i komentujących elementu Folder. Ta metoda nie działa, jeśli użytkownik jest edytorem, a nie przeglądającym. Ta metoda nie blokuje też użytkownikom dostępu do Folder, jeśli należą do klasy użytkowników z ogólnymi uprawnieniami dostępu – na przykład gdy Folder jest udostępniony całej domenie użytkownika lub 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 edytorów.

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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

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

`revokePermissions(emailAddress)`

Unieważnia dostęp do uprawnienia Folder przyznanego danemu użytkownikowi. 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 całej domenie użytkownika.

Parametry

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

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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órego dostęp powinien zostać unieważniony.

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 bieżącego folderu i pasujących do podanych kryteriów wyszukiwania. Szczegółowe informacje na temat kryteriów wyszukiwania znajdziesz w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z interfejsu Drive API w wersji 2, a niektóre pola zapytań różnią się od wersji 3. Zapoznaj się z różnicami między wersją 2 a 3.

Argument params to ciąg zapytania, który może zawierać wartości w postaci ciągów znaków. Pamiętaj więc, aby prawidłowo zmieniać znaczenie cudzysłowów (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 zgodnie z dokumentacją pakietu SDK Dysku Google.

Powroty

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

Upoważnienie

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, które są podrzędne wobec bieżącego folderu i spełniają określone kryteria wyszukiwania. Szczegółowe informacje na temat kryteriów wyszukiwania znajdziesz w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z interfejsu Drive API w wersji 2, a niektóre pola zapytań różnią się od wersji 3. Zapoznaj się z różnicami między wersją 2 a 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 zgodnie z dokumentacją pakietu SDK Dysku Google.

Powroty

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

Upoważnienie

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 obiektu Folder.

Parametry

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

Powroty

Folder – ten Folder, do łańcuchów

Upoważnienie

Skrypty korzystające 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`

Powroty

Folder – ten Folder, do łańcuchów

Upoważnienie

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 elementu Folder. Ta metoda daje też poprzedniemu właścicielowi uprawnienia do edycji elementu Folder.

Parametry

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

Powroty

Folder – ten Folder, do łańcuchów

Upoważnienie

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 elementu Folder. Ta metoda daje też poprzedniemu właścicielowi uprawnienia do edycji elementu Folder.

Parametry

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

Powroty

Folder – ten Folder, do łańcuchów

Upoważnienie

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 w celu uzyskania dostępu, gdy jest udostępniany za pomocą linku. Odpowiednie pliki i foldery są domyślnie włączone.

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

Parametry

Nazwa	Typ	Opis
`enabled`	`Boolean`	Określa, czy włączyć wymaganie klucza zasobu dla obiektu `Folder`.

Powroty

Folder – ten element typu Folder do tworzenia łańcuchów.

Upoważnienie

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 elementu Folder mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia. Wartością domyślną nowego elementu Folder jest true.

Parametry

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

Powroty

Folder – ten Folder, do łańcuchów

Upoważnienie

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óra klasa użytkowników ma dostęp do elementu Folder i jakie uprawnienia są im przyznane (z wyjątkiem poszczególnych użytkowników, którym przyznano dostęp bezpośrednio).

// 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`	która klasa użytkowników powinna mieć dostęp do `Folder`
`permissionType`	`Permission`	uprawnienia, które należy przyznać użytkownikom mającym dostęp do: `Folder`

Powroty

Folder – ten Folder, do łańcuchów

Upoważnienie

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 Folder ma być oznaczony gwiazdką na Dysku użytkownika. Wartością domyślną dla nowych komponentów Folder jest false.

Parametry

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

Powroty

Folder – ten Folder, do łańcuchów

Upoważnienie

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 zasób Folder znajduje się w koszu na Dysku użytkownika. Tylko właściciel może przenieść do kosza element Folder. Wartością domyślną nowych Folder jest false.

Parametry

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

Powroty

Folder – ten Folder, do łańcuchów

Upoważnienie

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 tego użyj File.moveTo(destination) lub createShortcut(targetId).

Dodaje dany plik do bieżącego folderu. Ta metoda nie powoduje przeniesienia pliku z istniejącego folderu nadrzędnego, ponieważ plik może mieć więcej niż 1 element nadrzędny jednocześnie.

Parametry

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

Powroty

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

Upoważnienie

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 tego użyj moveTo(destination) lub createShortcut(targetId).

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

Parametry

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

Powroty

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

Upoważnienie

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 powoduje usunięcia pliku, ale jeśli plik zostanie usunięty ze wszystkich elementów nadrzędnych, nie będzie można go wyświetlić na Dysku, chyba że wyszukasz go lub użyjesz widoku „Wszystkie elementy”.

Parametry

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

Powroty

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

Upoważnienie

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 podany folder z bieżącego folderu. Ta metoda nie usuwa 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 go wyszukasz lub użyjesz widoku „Wszystkie elementy”.

Parametry

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

Powroty

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

Upoważnienie

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

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