Class Folder

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

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

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

Metody

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

Szczegółowa dokumentacja

addEditor(emailAddress)

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

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz dodać.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

addEditor(user)

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika do dodania.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

addEditors(emailAddresses)

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

Parametry

NazwaTypOpis
emailAddressesString[]Tablica adresów e-mail użytkowników do dodania.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

addViewer(emailAddress)

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

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz dodać.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

addViewer(user)

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika do dodania.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

addViewers(emailAddresses)

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

Parametry

NazwaTypOpis
emailAddressesString[]Tablica adresów e-mail użytkowników do dodania.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

createFile(blob)

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

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

Parametry

NazwaTypOpis
blobBlobSourceDane nowego pliku.

Zwróć

File – nowy plik.

Upoważnienie

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

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

createFile(name, content)

Tworzy plik tekstowy w bieżącym folderze o podanej nazwie i zawartości. Zgłasza wyjątek, jeśli rozmiar pliku content przekracza 50 MB.

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

Parametry

NazwaTypOpis
nameStringNazwa nowego pliku.
contentStringZawartość nowego pliku.

Zwróć

File – nowy plik.

Upoważnienie

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

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

createFile(name, content, mimeType)

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

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

Parametry

NazwaTypOpis
nameStringNazwa nowego pliku.
contentStringZawartość nowego pliku.
mimeTypeStringTyp MIME nowego pliku.

Zwróć

File – nowy plik.

Upoważnienie

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

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

createFolder(name)

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

Parametry

NazwaTypOpis
nameStringNazwa nowego folderu.

Zwróć

Folder – nowy folder.

Upoważnienie

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

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

createShortcut(targetId)

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

Parametry

NazwaTypOpis
targetIdStringIdentyfikator pliku docelowego lub folderu.

Zwróć

File – nowy skrót.

Upoważnienie

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

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

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

Parametry

NazwaTypOpis
targetIdStringIdentyfikator pliku lub folderu docelowego.
targetResourceKeyStringKlucz zasobu pliku docelowego lub folderu.

Zwróć

File – nowy skrót.

Upoważnienie

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

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

getAccess(email)

Pobiera uprawnienia przyznane użytkownikowi.

Parametry

NazwaTypOpis
emailStringadres e-mail użytkownika, którego uprawnienia powinny być sprawdzane;

Zwróć

Permission – uprawnienia przyznane użytkownikowi,

Upoważnienie

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

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

getAccess(user)

Pobiera uprawnienia przyznane użytkownikowi.

Parametry

NazwaTypOpis
userUserreprezentacja użytkownika, którego uprawnienia powinny być sprawdzane.

Zwróć

Permission – uprawnienia przyznane użytkownikowi,

Upoważnienie

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

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

getDateCreated()

Pobiera datę utworzenia zasobu Folder.

Zwróć

Date – data utworzenia Folder;

Upoważnienie

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

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

getDescription()

Pobiera opis Folder.

Zwróć

String – opis elementu Folder

Upoważnienie

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

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

getEditors()

Pobiera listę edytorów tego pliku (Folder). Jeśli użytkownik, który wykonał skrypt, nie ma uprawnień do edycji obiektu Folder, ta metoda zwraca pustą tablicę.

Zwróć

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

Upoważnienie

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

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

getFiles()

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

Zwróć

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

Upoważnienie

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

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

getFilesByName(name)

Pobiera kolekcję wszystkich plików podrzędnych wobec bieżącego folderu o danej nazwie.

Parametry

NazwaTypOpis
nameStringNazwa plików do znalezienia.

Zwróć

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

Upoważnienie

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

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

getFilesByType(mimeType)

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

Parametry

NazwaTypOpis
mimeTypeStringTyp MIME plików do znalezienia.

Zwróć

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

Upoważnienie

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

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

getFolders()

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

Zwróć

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

Upoważnienie

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

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

getFoldersByName(name)

Pobiera kolekcję wszystkich folderów podrzędnych wobec bieżącego folderu i o danej nazwie.

Parametry

NazwaTypOpis
nameStringNazwa folderów do znalezienia.

Zwróć

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

Upoważnienie

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

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

getId()

Pobiera identyfikator Folder.

Zwróć

String – identyfikator elementu Folder,

Upoważnienie

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

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

getLastUpdated()

Pobiera datę ostatniej aktualizacji zasobu Folder.

Zwróć

Date – data ostatniej aktualizacji zasobu Folder.

Upoważnienie

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

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

getName()

Pobiera nazwę Folder.

Zwróć

String – nazwa klucza Folder

Upoważnienie

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

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

getOwner()

Pobiera właściciela zasobu Folder.

Zwróć

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

Upoważnienie

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

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

getParents()

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

Zwróć

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

Upoważnienie

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

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

getResourceKey()

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

Zwróć

String – klucz zasobu Folder.

Upoważnienie

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

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

getSecurityUpdateEligible()

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

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

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

Zwróć

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

Upoważnienie

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

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

getSecurityUpdateEnabled()

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

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

Zwróć

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

Upoważnienie

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

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

getSharingAccess()

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

Zwróć

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

Upoważnienie

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

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

getSharingPermission()

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

Zwróć

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

Upoważnienie

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

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

getSize()

Pobiera liczbę bajtów używanych do przechowywania pliku Folder na Dysku. Pliki aplikacji Google Workspace nie wliczają się do limitów miejsca na Dysku, dlatego zwracają 0 B.

Zwróć

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

Upoważnienie

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

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

getUrl()

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

Zwróć

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

Upoważnienie

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

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

getViewers()

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

Zwróć

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

Upoważnienie

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

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

isShareableByEditors()

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

Zwróć

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

Upoważnienie

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

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

isStarred()

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

Zwróć

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

Upoważnienie

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

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

isTrashed()

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

Zwróć

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

Upoważnienie

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

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

moveTo(destination)

Przenosi ten element do podanego folderu docelowego.

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

Parametry

NazwaTypOpis
destinationFolderFolder, który staje się nowym elementem nadrzędnym.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

removeEditor(emailAddress)

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

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

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz usunąć.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

removeEditor(user)

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

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika do usunięcia.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

removeViewer(emailAddress)

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

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

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz usunąć.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

removeViewer(user)

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

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika do usunięcia.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

revokePermissions(emailAddress)

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

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, któremu chcesz anulować dostęp.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

revokePermissions(user)

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika, której dostęp powinien zostać unieważniony.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

searchFiles(params)

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

Argument params to ciąg zapytania, który może zawierać wartości ciągu znaków. Z tego względu należy uważać, aby prawidłowo ująć znaki cudzysłowu (np. "title contains 'Gulliver\\'s Travels'" lub 'title contains "Gulliver\'s Travels"').

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

Parametry

NazwaTypOpis
paramsStringkryteria wyszukiwania, jak opisano w dokumentacji pakietu SDK Dysku Google;

Zwróć

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

Upoważnienie

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

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

searchFolders(params)

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

Argument params to ciąg zapytania, który może zawierać wartości ciągu znaków. Z tego względu należy uważać, aby prawidłowo ująć znaki cudzysłowu (np. "title contains 'Gulliver\\'s Travels'" lub 'title contains "Gulliver\'s Travels"').

// Logs the name of every 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

NazwaTypOpis
paramsStringkryteria wyszukiwania, jak opisano w dokumentacji pakietu SDK Dysku Google;

Zwróć

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

Upoważnienie

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

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

setDescription(description)

Ustawia opis elementu Folder.

Parametry

NazwaTypOpis
descriptionStringnowy opis usługi Folder

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

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

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

setName(name)

Ustawia nazwę tagu Folder.

Parametry

NazwaTypOpis
nameStringnowa nazwa Folder

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

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

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

setOwner(emailAddress)

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

Parametry

NazwaTypOpis
emailAddressStringadres e-mail użytkownika, który ma zostać nowym właścicielem;

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

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

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

setOwner(user)

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

Parametry

NazwaTypOpis
userUserreprezentacja użytkownika, który ma zostać nowym właścicielem;

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

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

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

setSecurityUpdateEnabled(enabled)

Określa, czy Folder wymaga klucza zasobu w celu udostępnienia go przy użyciu linku. Odpowiednie pliki i foldery są domyślnie włączone.

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

Parametry

NazwaTypOpis
enabledBooleanOkreśla, czy włączyć wymaganie klucza zasobu dla zasobu Folder.

Zwróć

Folder – to Folder do łańcucha.

Upoważnienie

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

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

setShareableByEditors(shareable)

Określa, czy użytkownicy z uprawnieniami do edycji Folder mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia. Domyślnie nowa kolumna Folder ma wartość true.

Parametry

NazwaTypOpis
shareableBooleantrue, jeśli użytkownicy z uprawnieniami do edycji powinni mieć możliwość udostępniania plików innym użytkownikom lub zmieniania tych uprawnień. Jeśli nie, false

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

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

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

setSharing(accessType, permissionType)

Określa, którzy użytkownicy mają dostęp do Folder i jakie uprawnienia otrzymują, a także dla poszczególnych użytkowników, którym jawnie przyznano dostęp.

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

Parametry

NazwaTypOpis
accessTypeAccessto, do jakiej klasy będą mieli dostęp Folder;
permissionTypePermissionuprawnienia, które powinny zostać przyznane użytkownikom mającym dostęp do Folder

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

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

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

setStarred(starred)

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

Parametry

NazwaTypOpis
starredBooleantrue, jeśli Folder ma być oznaczony gwiazdką na Dysku użytkownika. Jeśli nie, false

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

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

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

setTrashed(trashed)

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

Parametry

NazwaTypOpis
trashedBooleantrue, jeśli Folder powinno zostać przeniesione do kosza na Dysku użytkownika. Jeśli nie, false

Zwróć

Folder – ten Folder to łańcuch

Upoważnienie

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

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

Metody wycofane