Folder na Dysku Google. Dostęp do folderów i możliwość ich tworzenia możesz uzyskać tutaj: DriveApp
.
// Log the name of every folder in the user's Drive. var folders = DriveApp.getFolders(); while (folders.hasNext()) { var folder = folders.next(); Logger.log(folder.getName()); }
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addEditor(emailAddress) | Folder | Dodaje wskazanego użytkownika do listy edytorów w Folder . |
addEditor(user) | Folder | Dodaje wskazanego użytkownika do listy edytorów w Folder . |
addEditors(emailAddresses) | Folder | Dodaje podaną tablicę użytkowników do listy edytorów elementu Folder . |
addViewer(emailAddress) | Folder | Dodaje danego użytkownika do listy przeglądających stronę Folder . |
addViewer(user) | Folder | Dodaje danego użytkownika do listy przeglądających stronę Folder . |
addViewers(emailAddresses) | Folder | Dodaje podaną tablicę użytkowników do listy osób przeglądających element Folder . |
createFile(blob) | File | Tworzy plik w bieżącym folderze na podstawie dowolnych danych Blob . |
createFile(name, content) | File | Tworzy w bieżącym folderze plik tekstowy o podanej nazwie i zawartości. |
createFile(name, content, mimeType) | File | Tworzy w bieżącym folderze plik o podanej nazwie, zawartości i typie MIME. |
createFolder(name) | Folder | Tworzy folder o podanej nazwie w bieżącym folderze. |
createShortcut(targetId) | File | Tworzy skrót do podanego identyfikatora elementu na Dysku, a następnie go zwraca. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Tworzy skrót do podanego identyfikatora elementu na Dysku i klucza zasobu, a następnie go zwraca. |
getAccess(email) | Permission | Pobiera uprawnienia przyznane danemu użytkownikowi. |
getAccess(user) | Permission | Pobiera uprawnienia przyznane danemu użytkownikowi. |
getDateCreated() | Date | Pobiera datę utworzenia Folder . |
getDescription() | String | Pobiera opis obiektu Folder . |
getEditors() | User[] | Pobiera listę edytorów tego elementu (Folder ). |
getFiles() | FileIterator | Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu. |
getFilesByName(name) | FileIterator | Pobiera zbiór wszystkich plików, które są podrzędne wobec bieżącego folderu i mają podaną nazwę. |
getFilesByType(mimeType) | FileIterator | Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu i mających podany typ MIME. |
getFolders() | FolderIterator | Pobiera zbiór wszystkich folderów podrzędnych wobec bieżącego folderu. |
getFoldersByName(name) | FolderIterator | Pobiera zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i mają podaną nazwę. |
getId() | String | Pobiera identyfikator elementu Folder . |
getLastUpdated() | Date | Pobiera datę ostatniej aktualizacji elementu Folder . |
getName() | String | Pobiera nazwę elementu Folder . |
getOwner() | User | Przejmuje właściciela elementu Folder . |
getParents() | FolderIterator | Pobiera zbiór folderów, które są bezpośrednimi elementami nadrzędnymi elementu Folder . |
getResourceKey() | String | Pobiera klucz zasobu Folder , który jest wymagany do uzyskania dostępu do elementów udostępnionych przy użyciu linku. |
getSecurityUpdateEligible() | Boolean | Sprawdza, czy Folder może zastosować aktualizację zabezpieczeń, która wymaga dostępu przy użyciu klucza zasobu, gdy jest on udostępniany przy użyciu linku. |
getSecurityUpdateEnabled() | Boolean | Sprawdza, czy Folder wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany przy użyciu linku. |
getSharingAccess() | Access | Określa, która klasa użytkowników (oprócz poszczególnych użytkowników, którym przyznano dostęp) ma dostęp do Folder . |
getSharingPermission() | Permission | Otrzymuje uprawnienia przyznane tym użytkownikom, którzy mają dostęp do elementu Folder , oprócz wszystkich użytkowników, którym przyznano dostęp wprost. |
getSize() | Integer | Pobiera liczbę bajtów używanych do przechowywania elementu Folder na Dysku. |
getUrl() | String | Pobiera adres URL, za pomocą którego można otworzyć plik Folder w aplikacji Google, takiej jak Dysk czy Dokumenty. |
getViewers() | User[] | Pobiera listę przeglądających i komentujących tego elementu (Folder ). |
isShareableByEditors() | Boolean | Określa, czy użytkownicy z uprawnieniami do edycji elementu Folder mogą udostępniać pliki innym użytkownikom czy zmieniać uprawnienia. |
isStarred() | Boolean | Określa, czy zasób Folder jest oznaczony gwiazdką na Dysku użytkownika. |
isTrashed() | Boolean | Określa, czy zasób Folder znajduje się w koszu na Dysku użytkownika. |
moveTo(destination) | Folder | Przenosi ten element do podanego folderu docelowego. |
removeEditor(emailAddress) | Folder | Usuwa danego użytkownika z listy edytorów Folder . |
removeEditor(user) | Folder | Usuwa danego użytkownika z listy edytorów Folder . |
removeViewer(emailAddress) | Folder | Usuwa danego użytkownika z listy przeglądających i komentujących elementu Folder . |
removeViewer(user) | Folder | Usuwa danego użytkownika z listy przeglądających i komentujących elementu Folder . |
revokePermissions(emailAddress) | Folder | Unieważnia dostęp do uprawnienia Folder przyznanego danemu użytkownikowi. |
revokePermissions(user) | Folder | Unieważnia dostęp do uprawnienia Folder przyznanego danemu użytkownikowi. |
searchFiles(params) | FileIterator | Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu i pasujących do podanych kryteriów wyszukiwania. |
searchFolders(params) | FolderIterator | Pobiera zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i spełniają określone kryteria wyszukiwania. |
setDescription(description) | Folder | Ustawia opis obiektu Folder . |
setName(name) | Folder | Ustawia nazwę: Folder . |
setOwner(emailAddress) | Folder | Zmienia właściciela elementu Folder . |
setOwner(user) | Folder | Zmienia właściciela elementu Folder . |
setSecurityUpdateEnabled(enabled) | Folder | Określa, czy Folder wymaga klucza zasobu w celu uzyskania dostępu, gdy jest udostępniany za pomocą linku. |
setShareableByEditors(shareable) | Folder | Określa, czy użytkownicy z uprawnieniami do edycji elementu Folder mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia. |
setSharing(accessType, permissionType) | Folder | Określa, która klasa użytkowników ma dostęp do elementu Folder i jakie uprawnienia są im przyznane (z wyjątkiem poszczególnych użytkowników, którym przyznano dostęp bezpośrednio). |
setStarred(starred) | Folder | Określa, czy Folder ma być oznaczony gwiazdką na Dysku użytkownika. |
setTrashed(trashed) | Folder | Określa, czy zasób Folder znajduje się w koszu na Dysku użytkownika. |
Szczegółowa dokumentacja
addEditor(emailAddress)
Dodaje wskazanego użytkownika do listy edytorów w Folder
. Jeśli użytkownik był już na liście widzów, ta metoda przesuwa go poza listę widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addEditor(user)
Dodaje wskazanego użytkownika do listy edytorów w Folder
. Jeśli użytkownik był już na liście widzów, ta metoda przesuwa go poza listę widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, który ma zostać dodany. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
Dodaje podaną tablicę użytkowników do listy edytorów elementu Folder
. Jeśli którykolwiek z użytkowników był już na liście widzów, ta metoda przesuwa go poza listę widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddresses | String[] | Tablica adresów e-mail użytkowników do dodania. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
Dodaje danego użytkownika do listy przeglądających stronę Folder
. Jeśli użytkownik był już na liście edytorów, ta metoda nie ma żadnego efektu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addViewer(user)
Dodaje danego użytkownika do listy przeglądających stronę Folder
. Jeśli użytkownik był już na liście edytorów, ta metoda nie ma żadnego efektu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, który ma zostać dodany. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
Dodaje podaną tablicę użytkowników do listy osób przeglądających element Folder
. Jeśli którykolwiek z użytkowników był już na liście edytorów, ta metoda nie będzie działać.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddresses | String[] | Tablica adresów e-mail użytkowników do dodania. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createFile(blob)
Tworzy plik w bieżącym folderze na podstawie dowolnych danych Blob
.
// Create an image file in Google Drive using the Maps service. var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob(); DriveApp.getRootFolder().createFile(blob);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | BlobSource | Dane nowego pliku. |
Powroty
File
– nowy plik.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createFile(name, content)
Tworzy w bieżącym folderze plik tekstowy o podanej nazwie i zawartości. Zwraca wyjątek, jeśli content
ma rozmiar większy niż 50 MB.
// Create a text file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa nowego pliku. |
content | String | Zawartość nowego pliku. |
Powroty
File
– nowy plik.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createFile(name, content, mimeType)
Tworzy w bieżącym folderze plik o podanej nazwie, zawartości i typie MIME. Jeśli rozmiar pliku content
przekracza 10 MB, zgłasza wyjątek.
// Create an HTML file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa nowego pliku. |
content | String | Zawartość nowego pliku. |
mimeType | String | Typ MIME nowego pliku. |
Powroty
File
– nowy plik.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createFolder(name)
createShortcut(targetId)
Tworzy skrót do podanego identyfikatora elementu na Dysku, a następnie go zwraca.
Parametry
Nazwa | Typ | Opis |
---|---|---|
targetId | String | Identyfikator pliku lub folderu docelowego. |
Powroty
File
– nowy skrót.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)
Tworzy skrót do podanego identyfikatora elementu na Dysku i klucza zasobu, a następnie go zwraca. Klucz zasobu to dodatkowy parametr, który trzeba przekazać, by uzyskać dostęp do pliku docelowego lub folderu udostępnionego przy użyciu linku.
// Creates shortcuts for all folders in the user's drive that have a specific name. // TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive. const folders = DriveApp.getFoldersByName('Test-Folder'); // Iterates through all folders named 'Test-Folder'. while (folders.hasNext()) { const folder = folders.next(); // Creates a shortcut to the provided Drive item ID and resource key, and returns it. DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey()); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
targetId | String | Identyfikator pliku lub folderu docelowego. |
targetResourceKey | String | Klucz zasobu docelowego pliku lub folderu. |
Powroty
File
– nowy skrót.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
getAccess(email)
Pobiera uprawnienia przyznane danemu użytkownikowi.
Parametry
Nazwa | Typ | Opis |
---|---|---|
email | String | adres e-mail użytkownika, którego uprawnienia należy sprawdzić |
Powroty
Permission
– uprawnienia przyznane użytkownikowi,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getAccess(user)
Pobiera uprawnienia przyznane danemu użytkownikowi.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | reprezentacja użytkownika, którego uprawnienia należy sprawdzić |
Powroty
Permission
– uprawnienia przyznane użytkownikowi,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getDateCreated()
getDescription()
getEditors()
Pobiera listę edytorów tego elementu (Folder
). Jeśli użytkownik, który wykona skrypt, nie ma uprawnień do edycji elementu Folder
, ta metoda zwraca pustą tablicę.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of editors and logs their names to the console. const editors = folder.getEditors(); for (editor of editors) { console.log(editor.getName()); }
Powroty
User[]
– lista edytorów elementu Folder
, jeśli użytkownik ma uprawnienia do edycji, lub pustej tablicy w innym przypadku.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFiles()
Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu.
Powroty
FileIterator
– zbiór wszystkich plików podrzędnych bieżącego folderu.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFilesByName(name)
Pobiera zbiór wszystkich plików, które są podrzędne wobec bieżącego folderu i mają podaną nazwę.
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwy plików do znalezienia. |
Powroty
FileIterator
– zbiór wszystkich plików podrzędnych bieżącego folderu i o podanej nazwie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFilesByType(mimeType)
Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu i mających podany typ MIME.
Parametry
Nazwa | Typ | Opis |
---|---|---|
mimeType | String | Typ MIME plików do znalezienia. |
Powroty
FileIterator
– zbiór wszystkich plików podrzędnych bieżącego folderu i mających podany typ MIME.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFolders()
Pobiera zbiór wszystkich folderów podrzędnych wobec bieżącego folderu.
Powroty
FolderIterator
– zbiór wszystkich folderów podrzędnych wobec bieżącego folderu.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFoldersByName(name)
Pobiera zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i mają podaną nazwę.
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa folderów do znalezienia. |
Powroty
FolderIterator
– zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i mają określoną nazwę.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getId()
getLastUpdated()
Pobiera datę ostatniej aktualizacji elementu Folder
.
Powroty
Date
– data ostatniej aktualizacji obiektu Folder
,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getName()
getOwner()
Przejmuje właściciela elementu Folder
.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the owner of the folder and logs the name to the console. const folderOwner = folder.getOwner(); console.log(folderOwner.getName());
Powroty
User
– właściciel elementu Folder
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getParents()
Pobiera zbiór folderów, które są bezpośrednimi elementami nadrzędnymi elementu Folder
.
Powroty
FolderIterator
– zbiór folderów, które są bezpośrednimi elementami nadrzędnymi elementu Folder
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getResourceKey()
Pobiera klucz zasobu Folder
, który jest wymagany do uzyskania dostępu do elementów udostępnionych przy użyciu linku.
Powroty
String
– klucz zasobu Folder
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEligible()
Sprawdza, czy Folder
może zastosować aktualizację zabezpieczeń, która wymaga dostępu przy użyciu klucza zasobu, gdy jest on udostępniany przy użyciu linku.
Dysk wymaga klucza zasobu, aby uzyskać dostęp do niektórych plików i folderów udostępnionych przy użyciu linku. Ta zmiana jest częścią aktualizacji zabezpieczeń. Aktualizacja jest domyślnie włączona w przypadku odpowiednich plików i folderów. Aby włączyć lub wyłączyć wymaganie klucza zasobu w przypadku kwalifikujących się plików, użyj setSecurityUpdateEnabled
.
Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.
Powroty
Boolean
– określa, czy wymaganie klucza zasobu może zostać zastosowane do Folder
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEnabled()
Sprawdza, czy Folder
wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany przy użyciu linku. To wymaganie jest domyślnie włączone w przypadku odpowiednich plików i folderów.
Aby włączyć lub wyłączyć wymóg klucza zasobu w przypadku kwalifikujących się plików, użyj
setSecurityUpdateEnabled
.
Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.
Powroty
Boolean
– określa, czy wymaganie klucza zasobu jest włączone dla klucza Folder
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingAccess()
Określa, która klasa użytkowników (oprócz poszczególnych użytkowników, którym przyznano dostęp) ma dostęp do Folder
.
Powroty
Access
– klasa użytkowników mających dostęp do elementu Folder
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingPermission()
Otrzymuje uprawnienia przyznane tym użytkownikom, którzy mają dostęp do elementu Folder
, oprócz wszystkich użytkowników, którym przyznano dostęp wprost.
Powroty
Permission
– uprawnienia przyznane użytkownikom, którzy mają dostęp do: Folder
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSize()
Pobiera liczbę bajtów używanych do przechowywania elementu Folder
na Dysku. Pliki aplikacji Google Workspace nie wliczają się do limitu miejsca na Dysku i dlatego zwracają 0
B.
Powroty
Integer
– liczba bajtów użytych do przechowywania elementu Folder
na Dysku.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getUrl()
Pobiera adres URL, za pomocą którego można otworzyć plik Folder
w aplikacji Google, takiej jak Dysk czy Dokumenty.
Powroty
String
– adres URL, pod którym można wyświetlić ten element (Folder
) w aplikacji Google, takiej jak Dysk czy Dokumenty
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getViewers()
Pobiera listę przeglądających i komentujących tego elementu (Folder
). Jeśli użytkownik, który wykonuje skrypt, nie ma uprawnień do edycji elementu Folder
, ta metoda zwraca pustą tablicę.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of viewers and logs their names to the console. const viewers = folder.getViewers(); for (viewer of viewers) { console.log(viewer.getName()); }
Powroty
User[]
– lista przeglądających i komentujących elementu Folder
, jeśli użytkownik ma uprawnienia do edycji, lub pustą tablicę w innym przypadku.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isStarred()
Określa, czy zasób Folder
jest oznaczony gwiazdką na Dysku użytkownika.
Powroty
Boolean
– true
, jeśli Folder
jest oznaczony gwiazdką na Dysku użytkownika; false
, jeśli nie jest.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isTrashed()
Określa, czy zasób Folder
znajduje się w koszu na Dysku użytkownika.
Powroty
Boolean
– true
, jeśli Folder
znajduje się w koszu na Dysku użytkownika; false
, jeśli nie jest.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
moveTo(destination)
Przenosi ten element do podanego folderu docelowego.
Aby można było przenieść element do folderu docelowego, bieżący użytkownik musi być właścicielem pliku lub mieć co najmniej uprawnienia do edycji bieżącego folderu nadrzędnego danego elementu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
destination | Folder | Folder, który staje się nowym elementem nadrzędnym. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
removeEditor(emailAddress)
Usuwa danego użytkownika z listy edytorów Folder
. Ta metoda nie blokuje użytkownikom dostępu do Folder
, jeśli należą do klasy użytkowników z dostępem ogólnym – na przykład gdy zasób Folder
jest udostępniany całej domenie użytkownika lub gdy Folder
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy osób przeglądających.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
Usuwa danego użytkownika z listy edytorów Folder
. Ta metoda nie blokuje użytkownikom dostępu do Folder
, jeśli należą do klasy użytkowników z dostępem ogólnym – na przykład gdy zasób Folder
jest udostępniany całej domenie użytkownika lub gdy Folder
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy osób przeglądających.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, który ma zostać usunięty. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
Usuwa danego użytkownika z listy przeglądających i komentujących elementu Folder
. Ta metoda nie działa, jeśli użytkownik jest edytującym, a nie przeglądającym lub komentującym. Ta metoda nie blokuje też użytkownikom dostępu do zasobu Folder
, jeśli należą do klasy użytkowników z ogólnymi uprawnieniami dostępu – na przykład gdy Folder
jest udostępniony całej domenie użytkownika lub gdy Folder
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy edytorów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
Usuwa danego użytkownika z listy przeglądających i komentujących elementu Folder
. Ta metoda nie działa, jeśli użytkownik jest edytorem, a nie przeglądającym. Ta metoda nie blokuje też użytkownikom dostępu do Folder
, jeśli należą do klasy użytkowników z ogólnymi uprawnieniami dostępu – na przykład gdy Folder
jest udostępniony całej domenie użytkownika lub Folder
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy edytorów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, który ma zostać usunięty. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
Unieważnia dostęp do uprawnienia Folder
przyznanego danemu użytkownikowi. Ta metoda nie blokuje użytkownikom dostępu do Folder
, jeśli należą do klasy użytkowników z ogólnym dostępem – na przykład gdy Folder
jest udostępniany całej domenie użytkownika.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, któremu chcesz anulować dostęp. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
Unieważnia dostęp do uprawnienia Folder
przyznanego danemu użytkownikowi. Ta metoda nie blokuje użytkownikom dostępu do Folder
, jeśli należą do klasy użytkowników z ogólnym dostępem – na przykład gdy Folder
jest udostępniany całej domenie użytkownika.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, którego dostęp powinien zostać unieważniony. |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
searchFiles(params)
Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu i pasujących do podanych kryteriów wyszukiwania. Szczegółowe informacje na temat kryteriów wyszukiwania znajdziesz w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z interfejsu Drive API w wersji 2, a niektóre pola zapytań różnią się od wersji 3. Zapoznaj się z różnicami między wersją 2 a 3.
Argument params
to ciąg zapytania, który może zawierać wartości w postaci ciągów znaków. Pamiętaj więc, aby prawidłowo zmieniać znaczenie cudzysłowów (np. "title contains 'Gulliver\\'s
Travels'"
lub 'title contains "Gulliver\'s Travels"'
).
// Logs the name of every file that are children of the current folder and modified after February 28, // 2022 whose name contains "untitled."" var files = DriveApp.getRootFolder().searchFiles( 'modifiedDate > "2022-02-28" and title contains "untitled"'); while (files.hasNext()) { var file = files.next(); console.log(file.getName()); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
params | String | Kryteria wyszukiwania zgodnie z dokumentacją pakietu SDK Dysku Google. |
Powroty
FileIterator
– zbiór wszystkich plików, które są podrzędne wobec bieżącego folderu i spełniają kryteria wyszukiwania.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
searchFolders(params)
Pobiera zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i spełniają określone kryteria wyszukiwania. Szczegółowe informacje na temat kryteriów wyszukiwania znajdziesz w dokumentacji pakietu SDK Dysku Google. Pamiętaj, że usługa Dysk korzysta z interfejsu Drive API w wersji 2, a niektóre pola zapytań różnią się od wersji 3. Zapoznaj się z różnicami między wersją 2 a 3.
Argument params
to ciąg zapytania, który może zawierać wartości w postaci ciągów znaków. Pamiętaj więc, aby prawidłowo zmieniać znaczenie cudzysłowów (np. "title contains 'Gulliver\\'s
Travels'"
lub 'title contains "Gulliver\'s Travels"'
).
// Logs the name of every folder that are children of the current folder and you own and is starred. var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners'); while (folders.hasNext()) { var folder = folders.next(); console.log(folder.getName()); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
params | String | Kryteria wyszukiwania zgodnie z dokumentacją pakietu SDK Dysku Google. |
Powroty
FolderIterator
– zbiór wszystkich folderów, które są podrzędne wobec bieżącego folderu i spełniają kryteria wyszukiwania.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
setDescription(description)
setName(name)
setOwner(emailAddress)
Zmienia właściciela elementu Folder
. Ta metoda daje też poprzedniemu właścicielowi uprawnienia do edycji elementu Folder
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | adres e-mail użytkownika, który powinien zostać nowym właścicielem; |
Powroty
Folder
– ten Folder
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
setOwner(user)
Zmienia właściciela elementu Folder
. Ta metoda daje też poprzedniemu właścicielowi uprawnienia do edycji elementu Folder
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | nazwa użytkownika, który powinien zostać nowym właścicielem; |
Powroty
Folder
– ten Folder
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
setSecurityUpdateEnabled(enabled)
Określa, czy Folder
wymaga klucza zasobu w celu uzyskania dostępu, gdy jest udostępniany za pomocą linku. Odpowiednie pliki i foldery są domyślnie włączone.
Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | Określa, czy włączyć wymaganie klucza zasobu dla obiektu Folder . |
Powroty
Folder
– ten element typu Folder
do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
setSharing(accessType, permissionType)
Określa, która klasa użytkowników ma dostęp do elementu Folder
i jakie uprawnienia są im przyznane (z wyjątkiem poszczególnych użytkowników, którym przyznano dostęp bezpośrednio).
// Creates a folder that anyone on the Internet can read from and write to. (Domain // administrators can prohibit this setting for users of a Google Workspace domain.) var folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parametry
Nazwa | Typ | Opis |
---|---|---|
accessType | Access | która klasa użytkowników powinna mieć dostęp do Folder |
permissionType | Permission | uprawnienia, które należy przyznać użytkownikom mającym dostęp do: Folder |
Powroty
Folder
– ten Folder
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
setStarred(starred)
Określa, czy Folder
ma być oznaczony gwiazdką na Dysku użytkownika. Wartością domyślną dla nowych komponentów Folder
jest false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
starred | Boolean | true , jeśli element Folder powinien być oznaczony gwiazdką na Dysku użytkownika; jeśli nie, false |
Powroty
Folder
– ten Folder
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
Określa, czy zasób Folder
znajduje się w koszu na Dysku użytkownika. Tylko właściciel może przenieść do kosza element Folder
. Wartością domyślną nowych Folder
jest false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
trashed | Boolean | true , jeśli element Folder powinien zostać przeniesiony do kosza na Dysku użytkownika; w przeciwnym razie false |
Powroty
Folder
– ten Folder
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/drive