folder na Dysku Google, Foldery można otwierać i tworzyć w DriveApp
.
// Log the name of every folder in the user's Drive. const folders = DriveApp.getFolders(); while (folders.hasNext()) { const folder = folders.next(); Logger.log(folder.getName()); }
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addEditor(emailAddress) | Folder | Dodaje danego użytkownika do listy edytujących Folder . |
addEditor(user) | Folder | Dodaje danego użytkownika do listy edytujących Folder . |
addEditors(emailAddresses) | Folder | Dodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku Folder . |
addViewer(emailAddress) | Folder | Dodaje danego użytkownika do listy widzów Folder . |
addViewer(user) | Folder | Dodaje danego użytkownika do listy widzów Folder . |
addViewers(emailAddresses) | Folder | Dodaje podany tablicowy zbiór użytkowników do listy widzów Folder . |
createFile(blob) | File | Tworzy plik w bieżącym folderze na podstawie dowolnych danych z podanego zbioru danych Blob . |
createFile(name, content) | File | Tworzy plik tekstowy w bieżącym folderze o podanej nazwie i treści. |
createFile(name, content, mimeType) | File | Tworzy plik w bieżącym folderze z podaną nazwą, treścią i typem MIME. |
createFolder(name) | Folder | Tworzy folder o podanej nazwie w bieżącym folderze. |
createShortcut(targetId) | File | Tworzy skrót do podanego identyfikatora elementu na Dysku i zwraca go. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Tworzy i zwraca skrót do podanego identyfikatora elementu i klucza zasobu na Dysku. |
getAccess(email) | Permission | Pobiera uprawnienia przyznane konkretnemu użytkownikowi. |
getAccess(user) | Permission | Pobiera uprawnienia przyznane konkretnemu użytkownikowi. |
getDateCreated() | Date | Pobiera datę utworzenia elementu Folder . |
getDescription() | String | Pobiera opis elementu Folder . |
getEditors() | User[] | Pobiera listę edytorów tego Folder . |
getFiles() | FileIterator | Pobiera kolekcję wszystkich plików, które są podrzędnymi bieżącego folderu. |
getFilesByName(name) | FileIterator | Pobiera kolekcję wszystkich plików, które są podrzędne względem bieżącego folderu i mają podaną nazwę. |
getFilesByType(mimeType) | FileIterator | Pobiera kolekcję wszystkich plików, które są podrzędnymi bieżącego folderu i mają podany typ MIME. |
getFolders() | FolderIterator | Pobiera kolekcję wszystkich folderów podrzędnych bieżącego folderu. |
getFoldersByName(name) | FolderIterator | Pobiera kolekcję wszystkich folderów, które są podrzędne względem bieżącego folderu i mają podaną nazwę. |
getId() | String | Pobiera identyfikator Folder . |
getLastUpdated() | Date | Pobiera datę ostatniej aktualizacji elementu Folder . |
getName() | String | Pobiera nazwę Folder . |
getOwner() | User | Pobiera właściciela tego Folder . |
getParents() | FolderIterator | Pobiera kolekcję folderów, które są bezpośrednimi folderami nadrzędnymi folderu Folder . |
getResourceKey() | String | Pobiera klucz zasobu Folder , który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku. |
getSecurityUpdateEligible() | Boolean | Określa, czy Folder może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniana za pomocą linku. |
getSecurityUpdateEnabled() | Boolean | Pobiera informację, czy ten Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku. |
getSharingAccess() | Access | Pobiera informacje o klasie użytkowników, którzy mogą uzyskać dostęp do Folder , z wyjątkiem użytkowników, którzy mają wyraźnie przyznany dostęp. |
getSharingPermission() | Permission | Pobiera uprawnienia przyznane użytkownikom, którzy mogą uzyskać dostęp do Folder , z wyjątkiem pojedynczych użytkowników, którym dostęp został wyraźnie przyznany. |
getSize() | Integer | Pobiera liczbę bajtów użytych do przechowywania Folder na Dysku. |
getUrl() | String | Pobiera adres URL, za pomocą którego można otworzyć Folder w aplikacji Google, takiej jak Dysk lub Dokumenty. |
getViewers() | User[] | Pobiera listę osób, które oglądały lub komentowały ten Folder . |
isShareableByEditors() | Boolean | Określa, czy użytkownicy z uprawnieniami do edycji w Folder mogą udostępniać inne uprawnienia innym użytkownikom lub zmieniać uprawnienia. |
isStarred() | Boolean | Określa, czy Folder zostało oznaczone gwiazdką na Dysku użytkownika. |
isTrashed() | Boolean | Określa, czy Folder znajduje się w koszu na Dysku użytkownika. |
moveTo(destination) | Folder | Przenosi ten element do podanego folderu docelowego. |
removeEditor(emailAddress) | Folder | Usunięcie danego użytkownika z listy edytujących w przypadku Folder . |
removeEditor(user) | Folder | Usunięcie danego użytkownika z listy edytujących w przypadku Folder . |
removeViewer(emailAddress) | Folder | Usunięcie danego użytkownika z listy widzów i komentujących Folder . |
removeViewer(user) | Folder | Usunięcie danego użytkownika z listy widzów i komentujących Folder . |
revokePermissions(emailAddress) | Folder | Unieważnia przyznany danemu użytkownikowi dostęp do Folder . |
revokePermissions(user) | Folder | Unieważnia przyznany danemu użytkownikowi dostęp do Folder . |
searchFiles(params) | FileIterator | Pobiera kolekcję wszystkich plików, które są podrzędne bieżącego folderu i pasują do podanych kryteriów wyszukiwania. |
searchFolders(params) | FolderIterator | Pobiera kolekcję wszystkich folderów, które są podfolderami bieżącego folderu i pasują do podanych kryteriów wyszukiwania. |
setDescription(description) | Folder | Ustawia opis Folder . |
setName(name) | Folder | Ustawia nazwę Folder . |
setOwner(emailAddress) | Folder | Zmienia właściciela Folder . |
setOwner(user) | Folder | Zmienia właściciela Folder . |
setSecurityUpdateEnabled(enabled) | Folder | Określa, czy Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku. |
setShareableByEditors(shareable) | Folder | Określa, czy użytkownicy z uprawnieniami do edycji w Folder mogą udostępniać innym użytkownikom lub zmieniać uprawnienia. |
setSharing(accessType, permissionType) | Folder | Określa, które grupy użytkowników mogą 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) | Folder | Określa, czy Folder ma być oznaczone gwiazdką na Dysku użytkownika. |
setTrashed(trashed) | Folder | Określa, czy Folder znajduje się w koszu na Dysku użytkownika. |
Szczegółowa dokumentacja
addEditor(emailAddress)
Dodaje danego użytkownika do listy edytujących Folder
. Jeśli użytkownik był już na liście widzów, ta metoda powoduje usunięcie go z tej listy.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addEditor(user)
Dodaje danego użytkownika do listy edytujących Folder
. Jeśli użytkownik był już na liście widzów, ta metoda powoduje usunięcie go z tej listy.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, którego chcesz dodać. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
Dodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku Folder
. Jeśli któryś z użytkowników znajduje się już na liście widzów, ta metoda spowoduje usunięcie go z tej listy.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddresses | String[] | Tablica adresów e-mail użytkowników, których chcesz dodać. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
Dodaje danego użytkownika do listy widzów Folder
. Jeśli użytkownik był już na liście redaktorów, ta metoda nie przyniesie efektu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addViewer(user)
Dodaje danego użytkownika do listy widzów Folder
. Jeśli użytkownik był już na liście redaktorów, ta metoda nie przyniesie efektu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, którego chcesz dodać. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
Dodaje podany tablicowy zbiór użytkowników do listy widzów Folder
. Jeśli któryś z użytkowników był już na liście edytujących, ta metoda nie będzie miała na niego wpływu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddresses | String[] | Tablica adresów e-mail użytkowników, których chcesz dodać. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createFile(blob)
Tworzy plik w bieżącym folderze na podstawie dowolnych danych z podanego zbioru danych Blob
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | BlobSource | dane nowego pliku. |
Powrót
File
– nowy plik.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createFile(name, content)
Tworzy plik tekstowy w bieżącym folderze o podanej nazwie i treści. Wyjątek, jeśli content
przekracza 50 MB.
// Create a text file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa nowego pliku. |
content | String | Treść nowego pliku. |
Powrót
File
– nowy plik.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createFile(name, content, mimeType)
Tworzy plik w bieżącym folderze z podaną nazwą, treścią i typem MIME. Wyjątek jest rzucany, jeśli content
przekracza 10 MB.
// Create an HTML file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa nowego pliku. |
content | String | Treść nowego pliku. |
mimeType | String | Typ MIME nowego pliku. |
Powrót
File
– nowy plik.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createFolder(name)
createShortcut(targetId)
Tworzy skrót do podanego identyfikatora elementu na Dysku i zwraca go.
Parametry
Nazwa | Typ | Opis |
---|---|---|
targetId | String | Identyfikator pliku lub folderu docelowego. |
Powrót
File
– nowy skrót.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)
Tworzy i zwraca skrót do podanego identyfikatora elementu i klucza zasobu na Dysku. Klucz zasobu to dodatkowy parametr, który musi zostać przekazany, aby uzyskać dostęp do docelowego pliku lub folderu udostępnionego za pomocą linku.
// Creates shortcuts for all folders in the user's drive that have a specific // name. // TODO(developer): Replace 'Test-Folder' with a valid folder name in your // drive. const folders = DriveApp.getFoldersByName('Test-Folder'); // Iterates through all folders named 'Test-Folder'. while (folders.hasNext()) { const folder = folders.next(); // Creates a shortcut to the provided Drive item ID and resource key, and // returns it. DriveApp.createShortcutForTargetIdAndResourceKey( folder.getId(), folder.getResourceKey(), ); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
targetId | String | Identyfikator docelowego pliku lub folderu. |
targetResourceKey | String | Klucz zasobu docelowego pliku lub folderu. |
Powrót
File
– nowy skrót.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
getAccess(email)
Pobiera uprawnienia przyznane konkretnemu użytkownikowi. Ta metoda nie obsługuje zwracania uprawnień grupy dyskusyjnej Google ani uprawnień odziedziczonych przez grupy dyskusyjne Google.
Parametry
Nazwa | Typ | Opis |
---|---|---|
email | String | Adres e-mail użytkownika, którego uprawnienia mają zostać sprawdzone. Grupy dyskusyjne Google nie są obsługiwane. |
Powrót
Permission
– uprawnienia przyznane użytkownikowi.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getAccess(user)
Pobiera uprawnienia przyznane konkretnemu użytkownikowi. Ta metoda nie obsługuje zwracania uprawnień grupy dyskusyjnej Google ani uprawnień odziedziczonych przez grupy dyskusyjne Google.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, którego uprawnienia mają zostać sprawdzone. |
Powrót
Permission
– uprawnienia przyznane użytkownikowi.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getDateCreated()
getDescription()
getEditors()
Pobiera listę edytorów tego Folder
. Jeśli użytkownik, który wykonuje skrypt, nie ma uprawnień do edycji obiektu Folder
, ta metoda zwraca pusty tablicę.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of editors and logs their names to the console. const editors = folder.getEditors(); for (const editor of editors) { console.log(editor.getName()); }
Powrót
User[]
– lista edytujących dla tego Folder
, jeśli użytkownik ma uprawnienia do edycji, lub pusty tablicowy zbiór, jeśli nie.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFiles()
Pobiera kolekcję wszystkich plików, które są podrzędnymi bieżącego folderu.
Powrót
FileIterator
– kolekcja wszystkich plików, które są podrzędnymi bieżącego folderu.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFilesByName(name)
Pobiera kolekcję wszystkich plików, które są podrzędne względem bieżącego folderu i mają podaną nazwę.
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa plików do znalezienia. |
Powrót
FileIterator
– kolekcja wszystkich plików, które są podrzędnymi bieżącego folderu i mają określoną nazwę.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFilesByType(mimeType)
Pobiera kolekcję wszystkich plików, które są podrzędnymi bieżącego folderu i mają podany typ MIME.
Parametry
Nazwa | Typ | Opis |
---|---|---|
mimeType | String | Typ MIME plików do znalezienia. |
Powrót
FileIterator
– kolekcja wszystkich plików, które są podrzędnymi bieżącego folderu i mają dany typ MIME.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFolders()
Pobiera kolekcję wszystkich folderów podrzędnych bieżącego folderu.
Powrót
FolderIterator
– kolekcja wszystkich folderów, które są podrzędne bieżącemu folderowi.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFoldersByName(name)
Pobiera kolekcję wszystkich folderów, które są podrzędne względem bieżącego folderu i mają podaną nazwę.
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa folderów do znalezienia. |
Powrót
FolderIterator
– kolekcja wszystkich folderów podrzędnych bieżącego folderu o danej nazwie.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getId()
getLastUpdated()
getName()
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
isStarred()
Określa, czy Folder
zostało oznaczone gwiazdką na Dysku użytkownika.
Powrót
Boolean
– true
, jeśli Folder
ma gwiazdkę na Dysku użytkownika; false
w przeciwnym razie.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isTrashed()
Określa, czy Folder
znajduje się w koszu na Dysku użytkownika.
Powrót
Boolean
– true
, jeśli Folder
znajduje się w koszu na Dysku użytkownika;
false
, jeśli nie
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
moveTo(destination)
Przenosi ten element do podanego folderu docelowego.
Aby przenieść element do folderu docelowego, bieżący użytkownik musi być jego właścicielem lub mieć co najmniej uprawnienia do edycji do bieżącego folderu nadrzędnego elementu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
destination | Folder | Folder, który staje się nowym folderem nadrzędnym. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
removeEditor(emailAddress)
Usunięcie danego użytkownika z listy edytujących w przypadku Folder
. Ta metoda nie blokuje dostępu do Folder
użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder
jest udostępniony całej domenie użytkownika lub jeśli Folder
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
Usunięcie danego użytkownika z listy edytujących w przypadku Folder
. Ta metoda nie blokuje dostępu do Folder
użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder
jest udostępniony całej domenie użytkownika lub jeśli Folder
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika do usunięcia. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
Usunięcie danego użytkownika z listy widzów i komentujących Folder
. Ta metoda nie ma żadnego wpływu, jeśli użytkownik jest edytorem, a nie widzem lub komentatorem. Ta metoda nie blokuje też dostępu do Folder
użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder
jest udostępniony całej domenie użytkownika lub jeśli Folder
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy edytorów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powrót
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
Usunięcie danego użytkownika z listy widzów i komentujących Folder
. Ta metoda nie ma żadnego wpływu, jeśli użytkownik jest edytorem, a nie widzem. Ta metoda nie blokuje też dostępu do Folder
użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład jeśli Folder
jest udostępniony całej domenie użytkownika lub jeśli Folder
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.Folder
W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy edytorów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika do usunięcia. |
Powrót
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
Unieważnia przyznany danemu użytkownikowi dostęp do Folder
. Ta metoda nie blokuje dostępu do Folder
użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder
jest udostępniony całej domenie użytkownika.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, któremu chcesz odebrać dostęp. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
Unieważnia przyznany danemu użytkownikowi dostęp do Folder
. Ta metoda nie blokuje dostępu do Folder
użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Folder
jest udostępniony całej domenie użytkownika.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, którego uprawnienia dostępu należy cofnąć. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
searchFiles(params)
Pobiera kolekcję wszystkich plików, które są podrzędne bieżącego folderu i pasują do podanych kryteriów wyszukiwania. Kryteria wyszukiwania zostały opisane w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z wersji 2 interfejsu Drive API, a niektóre pola zapytania różnią się od wersji 3. Zapoznaj się z różnicami między polami w wersji 2 a 3.
Argument params
to ciąg znaków zapytania, który może zawierać wartości ciągu znaków, więc należy poprawnie stosować znaki cudzysłowe (np. "title contains 'Gulliver\\'s
Travels'"
lub 'title contains "Gulliver\'s Travels"'
).
// Logs the name of every file that are children of the current folder and modified after February 28, // 2022 whose name contains "untitled."" const files = DriveApp.getRootFolder().searchFiles( 'modifiedDate > "2022-02-28" and title contains "untitled"'); while (files.hasNext()) { const file = files.next(); console.log(file.getName()); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
params | String | kryteria wyszukiwania opisane w dokumentacji pakietu SDK Dysku Google. |
Powrót
FileIterator
– zbiór wszystkich plików, które są podrzędnymi bieżącego folderu i spełniają kryteria wyszukiwania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
searchFolders(params)
Pobiera kolekcję wszystkich folderów, które są podfolderami bieżącego folderu i pasują do podanych kryteriów wyszukiwania. Kryteria wyszukiwania zostały opisane w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z wersji 2 interfejsu Drive API, a niektóre pola zapytania różnią się od wersji 3. Zapoznaj się z różnicami między polami w wersji 2 a 3.
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
Nazwa | Typ | Opis |
---|---|---|
params | String | kryteria wyszukiwania opisane w dokumentacji pakietu SDK Dysku Google. |
Powrót
FolderIterator
– zbiór wszystkich folderów podrzędnych bieżącego folderu, które spełniają kryteria wyszukiwania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
setDescription(description)
setName(name)
setOwner(emailAddress)
Zmienia właściciela Folder
. Ta metoda daje również poprzedniemu właścicielowi wyraźny dostęp do edycji Folder
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | adres e-mail użytkownika, który ma zostać nowym właścicielem; |
Powrót
Folder
– ta Folder
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
setOwner(user)
Zmienia właściciela Folder
. Ta metoda daje również poprzedniemu właścicielowi wyraźny dostęp do edycji Folder
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | reprezentacja użytkownika, który ma zostać nowym właścicielem; |
Powrót
Folder
– ta Folder
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
setSecurityUpdateEnabled(enabled)
Określa, czy Folder
wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku. Odpowiednie pliki i foldery są domyślnie włączone.
Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | Określa, czy w przypadku Folder ma być wymagany klucz zasobu. |
Powrót
Folder
– ta Folder
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
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
Nazwa | Typ | Opis |
---|---|---|
accessType | Access | klasa użytkowników, która powinna mieć dostęp do Folder |
permissionType | Permission | uprawnienia, które należy przyznać użytkownikom mającym dostęp do Folder . |
Powrót
Folder
– ta Folder
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
setStarred(starred)
Określa, czy Folder
ma być oznaczone gwiazdką na Dysku użytkownika. Wartość domyślna dla nowych Folder
to false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
starred | Boolean | true , jeśli Folder ma być oznaczone gwiazdką na Dysku użytkownika; false w przeciwnym razie |
Powrót
Folder
– ta Folder
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
Określa, czy Folder
znajduje się w koszu na Dysku użytkownika. Tylko właściciel może przenieść Folder
do kosza. Wartość domyślna dla nowych typów Folder
to false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
trashed | Boolean | true , jeśli Folder ma zostać przeniesiony do kosza na Dysku użytkownika; false , jeśli nie |
Powrót
Folder
– ta Folder
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive