Class Folder

Folder

folder na Dysku Google, Foldery można otwierać i tworzyć w DriveApp.

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

Metody

MetodaZwracany typKrótki opis
addEditor(emailAddress)FolderDodaje danego użytkownika do listy edytujących Folder.
addEditor(user)FolderDodaje danego użytkownika do listy edytujących Folder.
addEditors(emailAddresses)FolderDodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku Folder.
addViewer(emailAddress)FolderDodaje danego użytkownika do listy widzów Folder.
addViewer(user)FolderDodaje danego użytkownika do listy widzów Folder.
addViewers(emailAddresses)FolderDodaje podany tablicowy zbiór użytkowników do listy widzów Folder.
createFile(blob)FileTworzy plik w bieżącym folderze na podstawie dowolnych danych z podanego zbioru danych Blob.
createFile(name, content)FileTworzy plik tekstowy w bieżącym folderze o podanej nazwie i treści.
createFile(name, content, mimeType)FileTworzy plik w bieżącym folderze z podaną nazwą, treścią i typem 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 go.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileTworzy i zwraca skrót do podanego identyfikatora elementu i klucza zasobu na Dysku.
getAccess(email)PermissionPobiera uprawnienia przyznane konkretnemu użytkownikowi.
getAccess(user)PermissionPobiera uprawnienia przyznane konkretnemu użytkownikowi.
getDateCreated()DatePobiera datę utworzenia elementu Folder.
getDescription()StringPobiera opis elementu Folder.
getEditors()User[]Pobiera listę edytorów tego Folder.
getFiles()FileIteratorPobiera kolekcję wszystkich plików, które są podrzędnymi 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, które są podrzędnymi bieżącego folderu i mają podany typ MIME.
getFolders()FolderIteratorPobiera kolekcję wszystkich folderów podrzędnych bieżącego folderu.
getFoldersByName(name)FolderIteratorPobiera kolekcję wszystkich folderów, które są podrzędne względem bieżącego folderu i mają podaną nazwę.
getId()StringPobiera identyfikator Folder.
getLastUpdated()DatePobiera datę ostatniej aktualizacji elementu Folder.
getName()StringPobiera nazwę Folder.
getOwner()UserPobiera właściciela tego Folder.
getParents()FolderIteratorPobiera kolekcję folderów, które są bezpośrednimi folderami nadrzędnymi folderu Folder.
getResourceKey()StringPobiera klucz zasobu Folder, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.
getSecurityUpdateEligible()BooleanOkreśla, czy Folder może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniana za pomocą linku.
getSecurityUpdateEnabled()BooleanPobiera informację, czy ten Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku.
getSharingAccess()AccessPobiera informacje o klasie użytkowników, którzy mogą uzyskać dostęp do Folder, z wyjątkiem użytkowników, którzy mają wyraźnie przyznany dostęp.
getSharingPermission()PermissionPobiera uprawnienia przyznane użytkownikom, którzy mogą uzyskać dostęp do Folder, z wyjątkiem pojedynczych użytkowników, którym dostęp został wyraźnie przyznany.
getSize()IntegerPobiera liczbę bajtów użytych do przechowywania Folder na Dysku.
getUrl()StringPobiera adres URL, za pomocą którego można otworzyć Folder w aplikacji Google, takiej jak Dysk lub Dokumenty.
getViewers()User[]Pobiera listę osób, które oglądały lub komentowały ten Folder.
isShareableByEditors()BooleanOkreśla, czy użytkownicy z uprawnieniami do edycji w Folder mogą udostępniać inne uprawnienia innym użytkownikom lub zmieniać uprawnienia.
isStarred()BooleanOkreśla, czy Folder zostało oznaczone 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)FolderUsunięcie danego użytkownika z listy edytujących w przypadku Folder.
removeEditor(user)FolderUsunięcie danego użytkownika z listy edytujących w przypadku Folder.
removeViewer(emailAddress)FolderUsunięcie danego użytkownika z listy widzów i komentujących Folder.
removeViewer(user)FolderUsunięcie danego użytkownika z listy widzów i komentujących Folder.
revokePermissions(emailAddress)FolderUnieważnia przyznany danemu użytkownikowi dostęp do Folder.
revokePermissions(user)FolderUnieważnia przyznany danemu użytkownikowi dostęp do Folder.
searchFiles(params)FileIteratorPobiera kolekcję wszystkich plików, które są podrzędne bieżącego folderu i pasują do podanych kryteriów wyszukiwania.
searchFolders(params)FolderIteratorPobiera kolekcję wszystkich folderów, które są podfolderami bieżącego folderu i pasują do podanych kryteriów wyszukiwania.
setDescription(description)FolderUstawia opis Folder.
setName(name)FolderUstawia nazwę 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ępniany za pomocą linku.
setShareableByEditors(shareable)FolderOkreśla, czy użytkownicy z uprawnieniami do edycji w Folder mogą udostępniać innym użytkownikom lub zmieniać uprawnienia.
setSharing(accessType, permissionType)FolderOkreśla, które grupy użytkowników mogą uzyskiwać dostęp do Folder i jakie uprawnienia są im przyznawane, oprócz użytkowników indywidualnych, którzy mają wyraźnie przyznany dostęp.
setStarred(starred)FolderOkreśla, czy Folder ma być oznaczone gwiazdką na Dysku użytkownika.
setTrashed(trashed)FolderOkreśla, czy Folder znajduje się w koszu na Dysku użytkownika.

Szczegółowa dokumentacja

addEditor(emailAddress)

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

Parametry

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

Powrót

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

Autoryzacja

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

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

addEditor(user)

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika, którego chcesz dodać.

Powrót

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

Autoryzacja

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

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

addEditors(emailAddresses)

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

Parametry

NazwaTypOpis
emailAddressesString[]Tablica adresów e-mail użytkowników, których chcesz dodać.

Powrót

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

Autoryzacja

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

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

addViewer(emailAddress)

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

Parametry

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

Powrót

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

Autoryzacja

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

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

addViewer(user)

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika, którego chcesz dodać.

Powrót

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

Autoryzacja

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

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

addViewers(emailAddresses)

Dodaje podany tablicowy zbiór użytkowników do listy widzów Folder. Jeśli któryś z użytkowników był już na liście edytujących, ta metoda nie będzie miała na niego wpływu.

Parametry

NazwaTypOpis
emailAddressesString[]Tablica adresów e-mail użytkowników, których chcesz dodać.

Powrót

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

Autoryzacja

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

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

createFile(blob)

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

Parametry

NazwaTypOpis
blobBlobSourcedane nowego pliku.

Powrót

File – nowy plik.

Autoryzacja

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

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

createFile(name, content)

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

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

Parametry

NazwaTypOpis
nameStringNazwa nowego pliku.
contentStringTreść nowego pliku.

Powrót

File – nowy plik.

Autoryzacja

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

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

createFile(name, content, mimeType)

Tworzy plik w bieżącym folderze z podaną nazwą, treścią i typem MIME. Wyjątek jest rzucany, jeśli content przekracza 10 MB.

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

Parametry

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

Powrót

File – nowy plik.

Autoryzacja

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

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

createFolder(name)

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

Parametry

NazwaTypOpis
nameStringNazwa nowego folderu.

Powrót

Folder – nowy folder.

Autoryzacja

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

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

createShortcut(targetId)

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

Parametry

NazwaTypOpis
targetIdStringIdentyfikator pliku lub folderu docelowego.

Powrót

File – nowy skrót.

Autoryzacja

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

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

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

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

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

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

Parametry

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

Powrót

File – nowy skrót.

Autoryzacja

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

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

getAccess(email)

Pobiera uprawnienia przyznane konkretnemu użytkownikowi. Ta metoda nie obsługuje zwracania uprawnień grupy dyskusyjnej Google ani uprawnień odziedziczonych przez grupy dyskusyjne Google.

Parametry

NazwaTypOpis
emailStringAdres e-mail użytkownika, którego uprawnienia mają zostać sprawdzone. Grupy dyskusyjne Google nie są obsługiwane.

Powrót

Permission – uprawnienia przyznane użytkownikowi.

Autoryzacja

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

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

getAccess(user)

Pobiera uprawnienia przyznane konkretnemu użytkownikowi. Ta metoda nie obsługuje zwracania uprawnień grupy dyskusyjnej Google ani uprawnień odziedziczonych przez grupy dyskusyjne Google.

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika, którego uprawnienia mają zostać sprawdzone.

Powrót

Permission – uprawnienia przyznane użytkownikowi.

Autoryzacja

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

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

getDateCreated()

Pobiera datę utworzenia elementu Folder.

Powrót

Date – data utworzenia Folder

Autoryzacja

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

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

getDescription()

Pobiera opis elementu Folder.

Powrót

String – opis elementu Folder,

Autoryzacja

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

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

getEditors()

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

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

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

Powrót

User[] – lista edytujących dla tego Folder, jeśli użytkownik ma uprawnienia do edycji, lub pusty tablicowy zbiór, jeśli nie.

Autoryzacja

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

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

getFiles()

Pobiera kolekcję wszystkich plików, które są podrzędnymi bieżącego folderu.

Powrót

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

Autoryzacja

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

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

getFilesByName(name)

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

Parametry

NazwaTypOpis
nameStringNazwa plików do znalezienia.

Powrót

FileIterator – kolekcja wszystkich plików, które są podrzędnymi bieżącego folderu i mają określoną nazwę.

Autoryzacja

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

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

getFilesByType(mimeType)

Pobiera kolekcję wszystkich plików, które są podrzędnymi bieżącego folderu i mają podany typ MIME.

Parametry

NazwaTypOpis
mimeTypeStringTyp MIME plików do znalezienia.

Powrót

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

Autoryzacja

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

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

getFolders()

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

Powrót

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

Autoryzacja

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

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

getFoldersByName(name)

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

Parametry

NazwaTypOpis
nameStringNazwa folderów do znalezienia.

Powrót

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

Autoryzacja

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

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

getId()

Pobiera identyfikator Folder.

Powrót

String – identyfikator Folder

Autoryzacja

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

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

getLastUpdated()

Pobiera datę ostatniej aktualizacji elementu Folder.

Powrót

Date – data ostatniej aktualizacji Folder

Autoryzacja

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

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

getName()

Pobiera nazwę Folder.

Powrót

String – nazwa Folder

Autoryzacja

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

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

getOwner()

Pobiera właściciela tego Folder.

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

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

Powrót

User – właściciel tego zasobu Folder.

Autoryzacja

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

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

getParents()

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

Powrót

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

Autoryzacja

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

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

getResourceKey()

Pobiera klucz zasobu Folder, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.

Powrót

String – klucz zasobu Folder.

Autoryzacja

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

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

getSecurityUpdateEligible()

Określa, czy Folder może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniana za pomocą linku.

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

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

Powrót

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

Autoryzacja

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

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

getSecurityUpdateEnabled()

Pobiera informację, czy ten Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku. To wymaganie jest domyślnie włączone w przypadku kwalifikujących się plików i folderów. Aby włączyć lub wyłączyć wymóg klucza zasobu w przypadku kwalifikujących się plików, użyj setSecurityUpdateEnabled.

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

Powrót

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

Autoryzacja

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

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

getSharingAccess()

Pobiera informacje o klasie użytkowników, którzy mogą uzyskać dostęp do Folder, z wyjątkiem użytkowników, którzy mają wyraźnie przyznany dostęp.

Powrót

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

Autoryzacja

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

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

getSharingPermission()

Pobiera uprawnienia przyznane użytkownikom, którzy mogą uzyskać dostęp do Folder, z wyjątkiem pojedynczych użytkowników, którym dostęp został wyraźnie przyznany.

Powrót

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

Autoryzacja

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

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

getSize()

Pobiera liczbę bajtów użytych do przechowywania Folder na Dysku. Pamiętaj, że pliki aplikacji Google Workspace nie są wliczane do limitu miejsca na dane na Dysku, dlatego zwracane są bajty 0.

Powrót

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

Autoryzacja

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

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

getUrl()

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

Powrót

String – adres URL, którego można użyć do wyświetlenia tego Folder w aplikacji Google, takiej jak Dysk lub Dokumenty.

Autoryzacja

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

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

getViewers()

Pobiera listę osób, które oglądały lub komentowały ten Folder. Jeśli użytkownik, który wykonuje skrypt, nie ma uprawnień do edycji obiektu Folder, ta metoda zwraca pusty tablicę.

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

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

Powrót

User[] – lista widzów i komentatorów tego Folder, jeśli użytkownik ma uprawnienia do edycji, lub pusty tablicowy zbiór w przeciwnym razie.

Autoryzacja

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

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

isShareableByEditors()

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

Powrót

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

Autoryzacja

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

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

isStarred()

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

Powrót

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

Autoryzacja

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

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

isTrashed()

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

Powrót

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

Autoryzacja

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

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

moveTo(destination)

Przenosi ten element do podanego folderu docelowego.

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

Parametry

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

Powrót

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

Autoryzacja

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

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

removeEditor(emailAddress)

Usunięcie danego użytkownika z listy edytujących w przypadku Folder. Ta metoda nie blokuje dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder jest udostępniony całej domenie użytkownika lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

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

Parametry

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

Powrót

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

Autoryzacja

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

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

removeEditor(user)

Usunięcie danego użytkownika z listy edytujących w przypadku Folder. Ta metoda nie blokuje dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder jest udostępniony całej domenie użytkownika lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika do usunięcia.

Powrót

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

Autoryzacja

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

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

removeViewer(emailAddress)

Usunięcie danego użytkownika z listy widzów i komentujących Folder. Ta metoda nie ma żadnego wpływu, jeśli użytkownik jest edytorem, a nie widzem lub komentatorem. Ta metoda nie blokuje też dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder jest udostępniony całej domenie użytkownika lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

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

Parametry

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

Powrót

Folder – Folder do łańcucha.

Autoryzacja

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

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

removeViewer(user)

Usunięcie danego użytkownika z listy widzów i komentujących Folder. Ta metoda nie ma żadnego wpływu, jeśli użytkownik jest edytorem, a nie widzem. Ta metoda nie blokuje też dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład jeśli Folder jest udostępniony całej domenie użytkownika lub jeśli Folder znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.Folder

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

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika do usunięcia.

Powrót

Folder – Folder do łańcucha.

Autoryzacja

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

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

revokePermissions(emailAddress)

Unieważnia przyznany danemu użytkownikowi dostęp do Folder. Ta metoda nie blokuje dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder jest udostępniony całej domenie użytkownika.

Parametry

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

Powrót

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

Autoryzacja

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

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

revokePermissions(user)

Unieważnia przyznany danemu użytkownikowi dostęp do Folder. Ta metoda nie blokuje dostępu do Folder użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder jest udostępniony całej domenie użytkownika.

Parametry

NazwaTypOpis
userUserReprezentacja użytkownika, którego uprawnienia dostępu należy cofnąć.

Powrót

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

Autoryzacja

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

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

searchFiles(params)

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

Argument params to ciąg znaków zapytania, który może zawierać wartości ciągu znaków, więc należy poprawnie stosować znaki cudzysłowe (np. "title contains 'Gulliver\\'s Travels'" lub 'title contains "Gulliver\'s Travels"').

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

Parametry

NazwaTypOpis
paramsStringkryteria wyszukiwania opisane w dokumentacji pakietu SDK Dysku Google.

Powrót

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

Autoryzacja

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

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

searchFolders(params)

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

Argument params to ciąg znaków zapytania, który może zawierać wartości ciągu znaków, więc należy poprawnie stosować znaki cudzysłowe (np. "title contains 'Gulliver\\'s Travels'" lub 'title contains "Gulliver\'s Travels"').

// Logs the name of every folder that are children of the current folder and you own and is starred.
const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  const folder = folders.next();
  console.log(folder.getName());
}

Parametry

NazwaTypOpis
paramsStringkryteria wyszukiwania opisane w dokumentacji pakietu SDK Dysku Google.

Powrót

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

Autoryzacja

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

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

setDescription(description)

Ustawia opis Folder.

Parametry

NazwaTypOpis
descriptionStringnowy opis Folder.

Powrót

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

Autoryzacja

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

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

setName(name)

Ustawia nazwę Folder.

Parametry

NazwaTypOpis
nameStringnowa nazwa Folder

Powrót

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

Autoryzacja

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

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

setOwner(emailAddress)

Zmienia właściciela Folder. Ta metoda daje również poprzedniemu właścicielowi wyraźny dostęp do edycji Folder.

Parametry

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

Powrót

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

Autoryzacja

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

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

setOwner(user)

Zmienia właściciela Folder. Ta metoda daje również poprzedniemu właścicielowi wyraźny dostęp do edycji Folder.

Parametry

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

Powrót

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

Autoryzacja

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

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

setSecurityUpdateEnabled(enabled)

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

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

Parametry

NazwaTypOpis
enabledBooleanOkreśla, czy w przypadku Folder ma być wymagany klucz zasobu.

Powrót

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

Autoryzacja

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

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

setShareableByEditors(shareable)

Określa, czy użytkownicy z uprawnieniami do edycji w Folder mogą udostępniać innym użytkownikom lub zmieniać uprawnienia. Wartość domyślna dla nowego typu Folder to true.

Parametry

NazwaTypOpis
shareableBooleantrue czy użytkownicy z uprawnieniami do edycji powinni mieć możliwość udostępniania innym użytkownikom lub zmieniania uprawnień; false jeśli nie

Powrót

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

Autoryzacja

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

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

setSharing(accessType, permissionType)

Określa, które grupy użytkowników mogą uzyskiwać dostęp do Folder i jakie uprawnienia są im przyznawane, oprócz użytkowników indywidualnych, którzy mają wyraźnie przyznany 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.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametry

NazwaTypOpis
accessTypeAccessklasa użytkowników, która powinna mieć dostęp do Folder
permissionTypePermissionuprawnienia, które należy przyznać użytkownikom mającym dostęp do Folder.

Powrót

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

Autoryzacja

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

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

setStarred(starred)

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

Parametry

NazwaTypOpis
starredBooleantrue, jeśli Folder ma być oznaczone gwiazdką na Dysku użytkownika; false w przeciwnym razie

Powrót

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

Autoryzacja

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

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

setTrashed(trashed)

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

Parametry

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

Powrót

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

Autoryzacja

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

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

Wycofane metody