Class Folder

Folder

Folder na Dysku Google. Foldery są dostępne i tworzone w usłudze DriveApp. 

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

Metody

MetodaZwracany typKrótki opis
addEditor(emailAddress)FolderDodaje danego użytkownika do listy edytorów zasobu Folder.
addEditor(user)FolderDodaje danego użytkownika do listy edytorów zasobu Folder.
addEditors(emailAddresses)FolderDodaje podaną tablicę użytkowników do listy edytorów zasobu Folder.
addViewer(emailAddress)FolderDodaje danego użytkownika do listy przeglądających w: Folder.
addViewer(user)FolderDodaje danego użytkownika do listy przeglądających w: Folder.
addViewers(emailAddresses)FolderDodaje podaną tablicę użytkowników do listy przeglądających obiekt Folder.
createFile(blob)FileTworzy plik w bieżącym folderze na podstawie wybranych danych (Blob).
createFile(name, content)FileTworzy w bieżącym folderze plik tekstowy o podanej nazwie i zawartości.
createFile(name, content, mimeType)FileTworzy w bieżącym folderze plik o podanej nazwie, zawartości i typie MIME.
createFolder(name)FolderTworzy folder o podanej nazwie w bieżącym folderze.
createShortcut(targetId)FileTworzy skrót do podanego identyfikatora elementu na Dysku i zwraca ten identyfikator.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileTworzy skrót do podanego identyfikatora elementu na Dysku i klucza zasobu i zwraca ten skrót.
getAccess(email)PermissionPobiera uprawnienie przyznane danemu użytkownikowi.
getAccess(user)PermissionPobiera uprawnienie przyznane danemu użytkownikowi.
getDateCreated()DateOtrzymuje datę utworzenia elementu Folder.
getDescription()StringPobiera opis elementu Folder.
getEditors()User[]Pobiera listę edytorów elementu Folder.
getFiles()FileIteratorPobiera kolekcję wszystkich plików podrzędnych względem bieżącego folderu.
getFilesByName(name)FileIteratorPobiera kolekcję wszystkich plików, które są podrzędne względem bieżącego folderu i mają podaną nazwę.
getFilesByType(mimeType)FileIteratorPobiera kolekcję wszystkich plików podrzędnych względem bieżącego folderu i o podanym typie MIME.
getFolders()FolderIteratorPobiera kolekcję wszystkich folderów podrzędnych folderu bieżącego.
getFoldersByName(name)FolderIteratorPobiera kolekcję wszystkich folderów, które są folderami podrzędnymi bieżącego folderu i mają podaną nazwę.
getId()StringPobiera identyfikator elementu Folder.
getLastUpdated()DatePobiera datę ostatniej aktualizacji urządzenia Folder.
getName()StringPobiera nazwę elementu Folder.
getOwner()UserPobiera właściciela tego elementu (Folder).
getParents()FolderIteratorPobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnymi folderu Folder.
getResourceKey()StringPobiera klucz zasobu Folder wymagany, aby uzyskać dostęp do elementów, które zostały udostępnione za pomocą linku.
getSecurityUpdateEligible()BooleanOkreśla, czy to urządzenie Folder kwalifikuje się do stosowania aktualizacji zabezpieczeń, która wymaga klucza zasobu, aby uzyskać dostęp, gdy jest on udostępniany za pomocą linku.
getSecurityUpdateEnabled()BooleanOkreśla, czy Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępnione za pomocą linku.
getSharingAccess()AccessPobiera klasę użytkowników, którzy mają dostęp do: Folder (oprócz poszczególnych osób) użytkownikom, którym wprost przyznano dostęp.
getSharingPermission()Permissionpobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do: Folder, oprócz poszczególnych użytkowników, którym wprost przyznano dostęp.
getSize()IntegerPobiera liczbę bajtów używanych do przechowywania elementu Folder na Dysku.
getUrl()StringUzyskuje adres URL, którego można użyć do otwarcia pliku Folder w aplikacji Google, np. Dysk lub Dokumenty.
getViewers()User[]Pobiera listę przeglądających i komentujących dla elementu Folder.
isShareableByEditors()BooleanOkreśla, czy użytkownicy z uprawnieniami do edycji zasobu Folder mogą udostępnić innym użytkownikom lub zmienić uprawnienia.
isStarred()BooleanOkreśla, czy element Folder został oznaczony gwiazdką na Dysku użytkownika.
isTrashed()BooleanOkreśla, czy Folder znajduje się w koszu na Dysku użytkownika.
moveTo(destination)FolderPrzenosi ten element do podanego folderu docelowego.
removeEditor(emailAddress)FolderUsuwa danego użytkownika z listy edytorów zasobu Folder.
removeEditor(user)FolderUsuwa danego użytkownika z listy edytorów zasobu Folder.
removeViewer(emailAddress)FolderUsuwa dane użytkownika z listy przeglądających i komentujących Folder.
removeViewer(user)FolderUsuwa dane użytkownika z listy przeglądających i komentujących Folder.
revokePermissions(emailAddress)FolderOdbierze uprawnienia Folder przyznane danemu użytkownikowi.
revokePermissions(user)FolderOdbierze uprawnienia Folder przyznane danemu użytkownikowi.
searchFiles(params)FileIteratorPobiera zbiór wszystkich plików podrzędnych względem bieżącego folderu i które pasują do danego wyszukiwania kryteria.
searchFolders(params)FolderIteratorPobiera zbiór wszystkich folderów podrzędnych bieżącego folderu i pasujących do podanego wyszukiwania kryteria.
setDescription(description)FolderUstawia opis elementu Folder.
setName(name)FolderOkreśla nazwę elementu Folder.
setOwner(emailAddress)FolderZmienia właściciela: Folder.
setOwner(user)FolderZmienia właściciela: Folder.
setSecurityUpdateEnabled(enabled)FolderOkreśla, czy Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępnione za pomocą linku.
setShareableByEditors(shareable)FolderOkreśla, czy użytkownicy z uprawnieniami do edycji w elemencie Folder mogą udostępniać treści innym użytkownikom lub zmienić uprawnienia.
setSharing(accessType, permissionType)FolderOkreśla, które klasy użytkowników mają dostęp do elementu Folder i jakie uprawnienia użytkownicy, którym przyznano dostęp wprost.
setStarred(starred)FolderOkreśla, czy element Folder jest oznaczony gwiazdką na Dysku użytkownika.
setTrashed(trashed)FolderOkreśla, czy Folder znajduje się w koszu Dysku użytkownika.

Szczegółowa dokumentacja

addEditor(emailAddress)

Dodaje danego użytkownika do listy edytorów zasobu Folder. Jeśli użytkownik był już na liście widzów, ta metoda wycofuje użytkownika z listy widzów.

Parametry

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

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

addEditor(user)

Dodaje danego użytkownika do listy edytorów zasobu Folder. Jeśli użytkownik był już na liście widzów, ta metoda wycofuje użytkownika z listy widzów.

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika, który ma zostać dodany.

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

addEditors(emailAddresses)

Dodaje podaną tablicę użytkowników do listy edytorów zasobu Folder. Jeśli któryś z Użytkownicy byli już na liście widzów, więc ta metoda powoduje wyeliminowanie ich z listy widzów.

Parametry

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

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

addViewer(emailAddress)

Dodaje danego użytkownika do listy przeglądających w: Folder. Jeśli użytkownik był już na liście redaktorów, ta metoda nie będzie działać.

Parametry

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

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

addViewer(user)

Dodaje danego użytkownika do listy przeglądających w: Folder. Jeśli użytkownik był już na liście redaktorów, ta metoda nie będzie działać.

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika, który ma zostać dodany.

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

addViewers(emailAddresses)

Dodaje podaną tablicę użytkowników do listy przeglądających obiekt Folder. Jeśli któryś z Użytkownicy byli już na liście edytorów, ta metoda nie ma u nich żadnego efektu.

Parametry

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

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

createFile(blob)

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

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

Parametry

NazwaTypOpis
blobBlobSourceDane nowego pliku.

Powrót

File – nowy plik.

Autoryzacja

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

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

createFile(name, content)

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

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

Parametry

NazwaTypOpis
nameStringNazwa nowego pliku.
contentStringZawartość nowego pliku.

Powrót

File – nowy plik.

Autoryzacja

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

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

createFile(name, content, mimeType)

Tworzy w bieżącym folderze plik o podanej nazwie, zawartości i typie MIME. Rzuty wyjątek, jeśli rozmiar content przekracza 10 MB. 

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

Parametry

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

Powrót

File – nowy plik.

Autoryzacja

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

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

createFolder(name)

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

Parametry

NazwaTypOpis
nameStringNazwa nowego folderu.

Powrót

Folder – nowy folder.

Autoryzacja

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

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

createShortcut(targetId)

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

Parametry

NazwaTypOpis
targetIdStringIdentyfikator pliku docelowego lub folderu docelowego.

Powrót

File – nowy skrót.

Autoryzacja

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

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

Tworzy skrót do podanego identyfikatora elementu na Dysku i klucza zasobu i zwraca ten skrót. Zasób klucz to dodatkowy parametr, który musi zostać przekazany, aby uzyskać dostęp do docelowego pliku lub folderu, który Element został udostępniony za pomocą linku. 

// Creates shortcuts for all folders in the user's drive that have a specific name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey());
}

Parametry

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

Powrót

File – nowy skrót.

Autoryzacja

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

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

getAccess(email)

Pobiera uprawnienie przyznane danemu użytkownikowi.

Parametry

NazwaTypOpis
emailStringadres e-mail użytkownika, którego uprawnienia powinny zostać sprawdzone.

Powrót

Permission – uprawnienia przyznane użytkownikowi;

Autoryzacja

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

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

getAccess(user)

Pobiera uprawnienie przyznane danemu użytkownikowi.

Parametry

NazwaTypOpis
userUserreprezentacja użytkownika, którego uprawnienia powinny zostać sprawdzone

Powrót

Permission – uprawnienia przyznane użytkownikowi;

Autoryzacja

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

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

getDateCreated()

Otrzymuje datę utworzenia elementu Folder.

Powrót

Date – data utworzenia elementu Folder;

Autoryzacja

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

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

getDescription()

Pobiera opis elementu Folder.

Powrót

String – opis pola Folder.

Autoryzacja

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

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

getEditors()

Pobiera listę edytorów elementu Folder. Jeśli użytkownik, który wykonuje skrypt nie ma uprawnień do edycji obiektu Folder, ta metoda zwraca pustą tablicę. 

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (editor of editors) {
  console.log(editor.getName());
}

Powrót

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

Autoryzacja

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

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

getFiles()

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

Powrót

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

Autoryzacja

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

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

getFilesByName(name)

Pobiera kolekcję wszystkich plików, które są podrzędne względem bieżącego folderu i mają podaną nazwę.

Parametry

NazwaTypOpis
nameStringNazwa plików do znalezienia.

Powrót

FileIterator – zbiór wszystkich plików, które są podrzędne względem bieżącego folderu i mają podaną nazwę.

Autoryzacja

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

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

getFilesByType(mimeType)

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

Parametry

NazwaTypOpis
mimeTypeStringTyp MIME plików do znalezienia.

Powrót

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

Autoryzacja

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

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

getFolders()

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

Powrót

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

Autoryzacja

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

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

getFoldersByName(name)

Pobiera kolekcję wszystkich folderów, które są folderami podrzędnymi bieżącego folderu i mają podaną nazwę.

Parametry

NazwaTypOpis
nameStringNazwa folderów do znalezienia.

Powrót

FolderIterator – zbiór wszystkich folderów o podanej nazwie, które są folderami podrzędnymi bieżącego folderu.

Autoryzacja

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

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

getId()

Pobiera identyfikator elementu Folder.

Powrót

String – identyfikator instancji Folder,

Autoryzacja

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

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

getLastUpdated()

Pobiera datę ostatniej aktualizacji urządzenia Folder.

Powrót

Date – data ostatniej aktualizacji elementu Folder.

Autoryzacja

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

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

getName()

Pobiera nazwę elementu Folder.

Powrót

String – nazwa Folder

Autoryzacja

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

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

getOwner()

Pobiera właściciela tego elementu (Folder). 

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

Powrót

User – właściciel tego elementu (Folder).

Autoryzacja

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

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

getParents()

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

Powrót

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

Autoryzacja

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

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

getResourceKey()

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

Powrót

String – klucz zasobu klasy Folder.

Autoryzacja

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

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

getSecurityUpdateEligible()

Określa, czy to urządzenie Folder kwalifikuje się do stosowania aktualizacji zabezpieczeń, która wymaga klucza zasobu, aby uzyskać dostęp, gdy jest on udostępniany za pomocą linku.

Dysk wymaga klucza zasobu, aby uzyskać dostęp do niektórych plików lub folderów udostępnionych za pomocą . Ta zmiana jest częścią aktualizacji zabezpieczeń. Aktualizacja jest domyślnie włączona dla kwalifikujących się użytkowników pliki i foldery. Aby włączyć lub wyłączyć wymaganie dotyczące klucza zasobu w przypadku kwalifikujących się plików, użyj polecenia setSecurityUpdateEnabled

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

Powrót

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

Autoryzacja

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

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

getSecurityUpdateEnabled()

Określa, czy Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępnione za pomocą linku. To wymaganie jest domyślnie włączone w przypadku kwalifikujących się plików i folderów. Aby włączyć lub wyłączyć wymaganie dotyczące klucza zasobu w przypadku kwalifikujących się plików, użyj funkcji setSecurityUpdateEnabled.

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

Powrót

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

Autoryzacja

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

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

getSharingAccess()

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

Powrót

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

Autoryzacja

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

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

getSharingPermission()

pobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do: Folder, oprócz poszczególnych użytkowników, którym wprost przyznano dostęp.

Powrót

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

Autoryzacja

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

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

getSize()

Pobiera liczbę bajtów używanych do przechowywania elementu Folder na Dysku. Pamiętaj, że Pliki aplikacji Google Workspace nie wliczają się do limitu miejsca na Dysku, więc nie wliczają się do limitu miejsca na Dysku. 0 B.

Powrót

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

Autoryzacja

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

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

getUrl()

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

Powrót

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

Autoryzacja

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

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

getViewers()

Pobiera listę przeglądających i komentujących dla elementu Folder. Jeśli użytkownik, który uruchamia skrypt, nie ma uprawnień do edycji elementu Folder, ta metoda zwraca pustą tablicę. 

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (viewer of viewers) {
  console.log(viewer.getName());
}

Powrót

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

Autoryzacja

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

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

isShareableByEditors()

Określa, czy użytkownicy z uprawnieniami do edycji zasobu Folder mogą udostępnić innym użytkownikom lub zmienić uprawnienia.

Powrót

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

Autoryzacja

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

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

isStarred()

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

Powrót

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

Autoryzacja

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

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

isTrashed()

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

Powrót

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

Autoryzacja

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

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

moveTo(destination)

Przenosi ten element do podanego folderu docelowego.

Bieżący użytkownik musi być właścicielem pliku lub mieć co najmniej uprawnienia do edycji elementu w bieżącym folderze nadrzędnym, aby przenieść element do folderu docelowego.

Parametry

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

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

removeEditor(emailAddress)

Usuwa danego użytkownika z listy edytorów zasobu Folder. Ta metoda nie: zablokuj dostęp do usługi Folder użytkownikom, którzy należą do klasy użytkowników, którzy ogólny dostęp – na przykład jeśli domena Folder jest udostępniona całej domenie domeny lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy przeglądających.

Parametry

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

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

removeEditor(user)

Usuwa danego użytkownika z listy edytorów zasobu Folder. Ta metoda nie: zablokuj dostęp do usługi Folder użytkownikom, którzy należą do klasy użytkowników, którzy ogólny dostęp – na przykład jeśli domena Folder jest udostępniona całej domenie domeny lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy przeglądających.

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika do usunięcia.

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

removeViewer(emailAddress)

Usuwa dane użytkownika z listy przeglądających i komentujących Folder. Ten nie ma zastosowania, jeśli użytkownik jest edytującym, a nie przeglądającym lub komentującym. Ta metoda również Nie blokuje dostępu do elementu Folder użytkownikom, którzy należą do klasy użytkowników, mieć ogólny dostęp – na przykład jeśli domena Folder została udostępniona domenie całej domeny lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy redaktorów.

Parametry

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

Powrót

Folder – Folder do tworzenia łańcuchów.

Autoryzacja

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

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

removeViewer(user)

Usuwa dane użytkownika z listy przeglądających i komentujących Folder. Ten nie ma zastosowania, jeśli użytkownik jest edytorem, a nie przeglądającym. Ta metoda nie blokuje też dostępu do funkcji Folder przez użytkowników, jeśli należą do klasy użytkowników, którzy mają ogólne warunki dostępu – na przykład jeśli element Folder został udostępniony całej domenie użytkownika lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy redaktorów.

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika do usunięcia.

Powrót

Folder – Folder do tworzenia łańcuchów.

Autoryzacja

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

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

revokePermissions(emailAddress)

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

Parametry

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

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

revokePermissions(user)

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika, któremu chcesz odebrać dostęp.

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

searchFiles(params)

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

Argument params to ciąg zapytania, który może zawierać wartości w postaci ciągów znaków, dlatego zachowaj ostrożność. aby prawidłowo zmienić znaczenie cudzysłowów (na przykład "title contains 'Gulliver\\'s Travels'" lub 'title contains "Gulliver\'s Travels"'). 

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

Parametry

NazwaTypOpis
paramsStringkryteria wyszukiwania opisane w dokumentacji pakietu SDK Dysku Google;

Powrót

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

Autoryzacja

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

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

searchFolders(params)

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

Argument params to ciąg zapytania, który może zawierać wartości w postaci ciągów znaków, dlatego zachowaj ostrożność. aby prawidłowo zmienić znaczenie cudzysłowów (na przykład "title contains 'Gulliver\\'s Travels'" lub 'title contains "Gulliver\'s Travels"'). 

// Logs the name of every 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 opisane w dokumentacji pakietu SDK Dysku Google;

Powrót

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

Autoryzacja

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

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

setDescription(description)

Ustawia opis elementu Folder.

Parametry

NazwaTypOpis
descriptionStringnowy opis dla: Folder

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

setName(name)

Określa nazwę elementu Folder.

Parametry

NazwaTypOpis
nameStringNowa nazwa usługi Folder

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

setOwner(emailAddress)

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

Parametry

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

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

setOwner(user)

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

Parametry

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

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

setSecurityUpdateEnabled(enabled)

Określa, czy Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępnione za pomocą linku. Odpowiednie pliki i foldery są domyślnie włączone.

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

Parametry

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

Powrót

Folder – Folder do łańcuchów.

Autoryzacja

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

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

setShareableByEditors(shareable)

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

Parametry

NazwaTypOpis
shareableBooleantrue, jeśli użytkownicy z uprawnieniami do edycji powinni mieć możliwość udostępniania treści tym osobom: innym użytkownikom ani zmieniać uprawnień; false, jeśli nie

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

setSharing(accessType, permissionType)

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

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

Parametry

NazwaTypOpis
accessTypeAccessgrupy użytkowników, którzy powinni mieć dostęp do Folder
permissionTypePermissionuprawnienia użytkowników mających dostęp do Folder

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

setStarred(starred)

Określa, czy element Folder jest oznaczony gwiazdką na Dysku użytkownika. Domyślna wartość dla nowe Folder są false.

Parametry

NazwaTypOpis
starredBooleantrue, jeśli element Folder powinien być oznaczony gwiazdką w sekcji Dysk; false, jeśli nie

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

setTrashed(trashed)

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

Parametry

NazwaTypOpis
trashedBooleantrue, jeśli element Folder ma zostać przeniesiony do kosza Dysk użytkownika; false, jeśli nie

Powrót

Folder – Folder, łańcuch

Autoryzacja

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

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

Wycofane metody