Ta usługa umożliwia skryptom tworzenie, znajdowanie i modyfikowanie plików oraz folderów na Dysku Google.
// Log the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
Logger.log(file.getName());
}
Zajęcia
Nazwa | Krótki opis |
---|---|
Access | wyliczenie przedstawiające klasy użytkowników, którzy mogą mieć dostęp do pliku lub folderu, oprócz wszystkich użytkowników, którym przyznano dostęp wprost. |
DriveApp | Umożliwia skryptom tworzenie, znajdowanie i modyfikowanie plików oraz folderów na Dysku Google. |
File | Plik na Dysku Google. |
FileIterator | iterator, który pozwala skryptom na iterację nad potencjalnie dużym zbiorem plików. |
Folder | Folder na Dysku Google. |
FolderIterator | Obiekt, który pozwala skryptom na iterację nad potencjalnie dużą kolekcją folderów. |
Permission | wyliczenie reprezentujące uprawnienia użytkowników z dostępem do pliku lub folderu oprócz poszczególnych użytkowników, którym przyznano dostęp wprost; |
User | Użytkownik powiązany z plikiem na Dysku Google. |
Access
Usługi
Właściwość | Typ | Opis |
---|---|---|
ANYONE | Enum | Każdy użytkownik internetu może znajdować te treści i uzyskiwać do nich dostęp. |
ANYONE_WITH_LINK | Enum | Każda osoba mająca link może uzyskiwać dostęp. |
DOMAIN | Enum | Osoby w Twojej domenie mogą znajdować i uzyskiwać dostęp. |
DOMAIN_WITH_LINK | Enum | Osoby w Twojej domenie, które mają link, mogą uzyskiwać dostęp. |
PRIVATE | Enum | Dostęp mogą uzyskać tylko osoby z uprawnieniami przyznanymi wprost. |
DriveApp
Usługi
Właściwość | Typ | Opis |
---|---|---|
Access | Access | wyliczenie przedstawiające klasy użytkowników, którzy mogą mieć dostęp do pliku lub folderu, oprócz wszystkich użytkowników, którym przyznano dostęp wprost. |
Permission | Permission | wyliczenie reprezentujące uprawnienia użytkowników z dostępem do pliku lub folderu oprócz poszczególnych użytkowników, którym przyznano dostęp wprost; |
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | Wznawia iterację pliku za pomocą tokena kontynuacji z poprzedniego iteratora. |
continueFolderIterator(continuationToken) | FolderIterator | Wznawia iterację folderu przy użyciu tokena kontynuacji z poprzedniego iteratora. |
createFile(blob) | File | Tworzy plik w katalogu głównym Dysku użytkownika na podstawie Blob dowolnych danych. |
createFile(name, content) | File | Tworzy plik tekstowy w katalogu głównym Dysku użytkownika o podanej nazwie i zawartości. |
createFile(name, content, mimeType) | File | Tworzy plik w katalogu głównym Dysku użytkownika o podanej nazwie, treści i typie MIME. |
createFolder(name) | Folder | Tworzy folder w katalogu głównym Dysku użytkownika o podanej nazwie. |
createShortcut(targetId) | File | Powoduje utworzenie skrótu do podanego identyfikatora elementu na Dysku i zwraca go. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Tworzy skrót do identyfikatora elementu Dysku i klucza zasobu oraz zwraca go. |
enforceSingleParent(value) | void | Włącza lub wyłącza wymuszanie zachowania funkcji PojedynczyRodzic nad wszystkimi wywołaniami dotyczącymi elementów nadrzędnych elementu. |
getFileById(id) | File | Pobiera plik o podanym identyfikatorze. |
getFileByIdAndResourceKey(id, resourceKey) | File | Pobiera plik o podanym identyfikatorze i kluczu zasobu. |
getFiles() | FileIterator | Pobiera kolekcję wszystkich plików na Dysku użytkownika. |
getFilesByName(name) | FileIterator | Pobiera zbiór wszystkich plików na Dysku użytkownika o określonej nazwie. |
getFilesByType(mimeType) | FileIterator | Pobiera zbiór wszystkich plików na Dysku użytkownika o danym typie MIME. |
getFolderById(id) | Folder | Pobiera folder o podanym identyfikatorze. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | Pobiera folder o podanym identyfikatorze i kluczu zasobu. |
getFolders() | FolderIterator | Pobiera kolekcję wszystkich folderów na Dysku użytkownika. |
getFoldersByName(name) | FolderIterator | Pobiera kolekcję wszystkich folderów na Dysku użytkownika o określonej nazwie. |
getRootFolder() | Folder | Pobiera folder z poziomu katalogu głównego Dysku użytkownika. |
getStorageLimit() | Integer | Pobiera liczbę bajtów, które użytkownik może przechowywać na Dysku. |
getStorageUsed() | Integer | Pobiera liczbę bajtów, które użytkownik obecnie przechowuje na Dysku. |
getTrashedFiles() | FileIterator | Pobiera zbiór wszystkich plików znajdujących się w koszu na Dysku użytkownika. |
getTrashedFolders() | FolderIterator | Pobiera kolekcję wszystkich folderów w koszu Dysku użytkownika. |
searchFiles(params) | FileIterator | Pobiera na Dysku użytkownika kolekcję wszystkich plików, które spełniają podane kryteria wyszukiwania. |
searchFolders(params) | FolderIterator | Pobiera zbiór wszystkich folderów na Dysku użytkownika, które spełniają określone kryteria wyszukiwania. |
File
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addCommenter(emailAddress) | File | Dodaj danego użytkownika do listy komentujących, aby dodać File . |
addCommenter(user) | File | Dodaj danego użytkownika do listy komentujących, aby dodać File . |
addCommenters(emailAddresses) | File | Dodaj daną tablicę użytkowników do listy komentujących File . |
addEditor(emailAddress) | File | Dodaje wybranego użytkownika do listy edytorów File . |
addEditor(user) | File | Dodaje wybranego użytkownika do listy edytorów File . |
addEditors(emailAddresses) | File | Dodaje określoną tablicę użytkowników do listy edytorów File . |
addViewer(emailAddress) | File | Dodaje danego użytkownika do listy widzów elementu File . |
addViewer(user) | File | Dodaje danego użytkownika do listy widzów elementu File . |
addViewers(emailAddresses) | File | Dodaje określoną tablicę użytkowników do listy widzów elementu File . |
getAccess(email) | Permission | Pobiera uprawnienia przyznane użytkownikowi. |
getAccess(user) | Permission | Pobiera uprawnienia przyznane użytkownikowi. |
getAs(contentType) | Blob | Zwraca dane wewnątrz tego obiektu w postaci obiektu blob przekonwertowanego na określony typ treści. |
getBlob() | Blob | Zwróć dane wewnątrz tego obiektu jako obiekt blob. |
getDateCreated() | Date | Pobiera datę utworzenia zasobu File . |
getDescription() | String | Pobiera opis File . |
getDownloadUrl() | String | Pobiera adres URL, którego można użyć do pobrania pliku. |
getEditors() | User[] | Pobiera listę edytorów tego pliku (File ). |
getId() | String | Pobiera identyfikator File . |
getLastUpdated() | Date | Pobiera datę ostatniej aktualizacji zasobu File . |
getMimeType() | String | Pobiera typ MIME pliku. |
getName() | String | Pobiera nazwę File . |
getOwner() | User | Pobiera właściciela zasobu File . |
getParents() | FolderIterator | Pobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnym folderu File . |
getResourceKey() | String | Pobiera klucz zasobu File wymagany do uzyskania dostępu do elementów, które zostały udostępnione za pomocą linku. |
getSecurityUpdateEligible() | Boolean | Określa, czy File może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu w celu udostępnienia go przy użyciu linku. |
getSecurityUpdateEnabled() | Boolean | Określa, czy File wymaga klucza dostępu do zasobu, gdy jest udostępniany za pomocą linku. |
getSharingAccess() | Access | Pobiera klasę użytkowników, która pozwala uzyskać dostęp do zasobu File , wraz z użytkownikami, którym przyznano dostęp wprost. |
getSharingPermission() | Permission | Pobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do elementu File , oprócz wszystkich użytkowników, którym jawnie przyznano dostęp. |
getSize() | Integer | Pobiera liczbę bajtów używanych do przechowywania pliku File na Dysku. |
getTargetId() | String | Jeśli jest to skrót, zwraca identyfikator elementu, do którego prowadzi. |
getTargetMimeType() | String | Jeśli jest to skrót, zwraca typ MIME elementu, do którego prowadzi. |
getTargetResourceKey() | String | Jeśli plik jest skrótem, zwraca klucz zasobu elementu, do którego prowadzi. |
getThumbnail() | Blob | Pobiera miniaturę pliku lub null , jeśli nie ma żadnej miniatury. |
getUrl() | String | Pobiera adres URL, którego można użyć do otwarcia elementu File w aplikacji Google, takiej jak Dysk czy Dokumenty. |
getViewers() | User[] | Pobiera listę widzów i komentarzy do filmu File . |
isShareableByEditors() | Boolean | Określa, czy użytkownicy z uprawnieniami do edycji File mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia. |
isStarred() | Boolean | Określa, czy element File został oznaczony gwiazdką na Dysku użytkownika. |
isTrashed() | Boolean | Określa, czy plik File znajduje się w koszu na Dysku użytkownika. |
makeCopy() | File | Tworzy kopię pliku. |
makeCopy(destination) | File | Tworzy kopię pliku w katalogu docelowym. |
makeCopy(name) | File | Tworzy kopię pliku i nadaje mu nazwę. |
makeCopy(name, destination) | File | Tworzy kopię pliku w katalogu docelowym i nadaje mu nazwę. |
moveTo(destination) | File | Przenosi ten element do podanego folderu docelowego. |
removeCommenter(emailAddress) | File | Usunięcie użytkownika z listy komentujących dotyczącą elementu File . |
removeCommenter(user) | File | Usunięcie użytkownika z listy komentujących dotyczącą elementu File . |
removeEditor(emailAddress) | File | Usunięcie użytkownika z listy edytorów File . |
removeEditor(user) | File | Usunięcie użytkownika z listy edytorów File . |
removeViewer(emailAddress) | File | Usunięcie użytkownika z listy widzów i komentujących: File . |
removeViewer(user) | File | Usunięcie użytkownika z listy widzów i komentujących: File . |
revokePermissions(emailAddress) | File | Cofnie dostęp do File przyznane danemu użytkownikowi. |
revokePermissions(user) | File | Cofnie dostęp do File przyznane danemu użytkownikowi. |
setContent(content) | File | Zastępuje treść pliku przy danej zmianie. |
setDescription(description) | File | Ustawia opis elementu File . |
setName(name) | File | Ustawia nazwę tagu File . |
setOwner(emailAddress) | File | Zmienia właściciela File . |
setOwner(user) | File | Zmienia właściciela File . |
setSecurityUpdateEnabled(enabled) | File | Określa, czy File wymaga klucza zasobu w celu udostępnienia go przy użyciu linku. |
setShareableByEditors(shareable) | File | Określa, czy użytkownicy z uprawnieniami do edycji File mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia. |
setSharing(accessType, permissionType) | File | Określa, którzy użytkownicy mają dostęp do File i jakie uprawnienia otrzymują, a także dla poszczególnych użytkowników, którym jawnie przyznano dostęp. |
setStarred(starred) | File | Określa, czy element File jest oznaczony gwiazdką na Dysku użytkownika. |
setTrashed(trashed) | File | Określa, czy element File znajduje się w koszu na Dysku użytkownika. |
FileIterator
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getContinuationToken() | String | Pobiera token, którego można później użyć do wznowienia tej iteracji. |
hasNext() | Boolean | Określa, czy wywołanie next() spowoduje zwrócenie elementu. |
next() | File | Pobiera następny element ze zbioru plików lub folderów. |
Folder
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addEditor(emailAddress) | Folder | Dodaje wybranego użytkownika do listy edytorów Folder . |
addEditor(user) | Folder | Dodaje wybranego użytkownika do listy edytorów Folder . |
addEditors(emailAddresses) | Folder | Dodaje określoną tablicę użytkowników do listy edytorów Folder . |
addViewer(emailAddress) | Folder | Dodaje danego użytkownika do listy widzów elementu Folder . |
addViewer(user) | Folder | Dodaje danego użytkownika do listy widzów elementu Folder . |
addViewers(emailAddresses) | Folder | Dodaje określoną tablicę użytkowników do listy widzów elementu Folder . |
createFile(blob) | File | Tworzy plik w bieżącym folderze na podstawie Blob dowolnych danych. |
createFile(name, content) | File | Tworzy plik tekstowy w bieżącym folderze o podanej nazwie i zawartości. |
createFile(name, content, mimeType) | File | Tworzy w bieżącym folderze plik o podanej nazwie, treści i typie MIME. |
createFolder(name) | Folder | Tworzy folder w bieżącym folderze o podanej nazwie. |
createShortcut(targetId) | File | Powoduje utworzenie skrótu do podanego identyfikatora elementu na Dysku i zwraca go. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Tworzy skrót do identyfikatora elementu Dysku i klucza zasobu oraz zwraca go. |
getAccess(email) | Permission | Pobiera uprawnienia przyznane użytkownikowi. |
getAccess(user) | Permission | Pobiera uprawnienia przyznane użytkownikowi. |
getDateCreated() | Date | Pobiera datę utworzenia zasobu Folder . |
getDescription() | String | Pobiera opis Folder . |
getEditors() | User[] | Pobiera listę edytorów tego pliku (Folder ). |
getFiles() | FileIterator | Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu. |
getFilesByName(name) | FileIterator | Pobiera kolekcję wszystkich plików podrzędnych wobec bieżącego folderu o danej nazwie. |
getFilesByType(mimeType) | FileIterator | Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu i mających określony typ MIME. |
getFolders() | FolderIterator | Pobiera kolekcję wszystkich folderów podrzędnych bieżącego folderu. |
getFoldersByName(name) | FolderIterator | Pobiera kolekcję wszystkich folderów podrzędnych wobec bieżącego folderu i o danej nazwie. |
getId() | String | Pobiera identyfikator Folder . |
getLastUpdated() | Date | Pobiera datę ostatniej aktualizacji zasobu Folder . |
getName() | String | Pobiera nazwę Folder . |
getOwner() | User | Pobiera właściciela zasobu Folder . |
getParents() | FolderIterator | Pobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnym folderu Folder . |
getResourceKey() | String | Pobiera klucz zasobu Folder wymagany do uzyskania dostępu do elementów, które zostały udostępnione za pomocą linku. |
getSecurityUpdateEligible() | Boolean | Określa, czy Folder może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu w celu udostępnienia go przy użyciu linku. |
getSecurityUpdateEnabled() | Boolean | Określa, czy Folder wymaga klucza dostępu do zasobu, gdy jest udostępniany za pomocą linku. |
getSharingAccess() | Access | Pobiera klasę użytkowników, która pozwala uzyskać dostęp do zasobu Folder , wraz z użytkownikami, którym przyznano dostęp wprost. |
getSharingPermission() | Permission | Pobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do elementu Folder , oprócz wszystkich użytkowników, którym jawnie przyznano dostęp. |
getSize() | Integer | Pobiera liczbę bajtów używanych do przechowywania pliku Folder na Dysku. |
getUrl() | String | Pobiera adres URL, którego można użyć do otwarcia elementu Folder w aplikacji Google, takiej jak Dysk czy Dokumenty. |
getViewers() | User[] | Pobiera listę widzów i komentarzy do filmu Folder . |
isShareableByEditors() | Boolean | Określa, czy użytkownicy z uprawnieniami do edycji Folder mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia. |
isStarred() | Boolean | Określa, czy element Folder został oznaczony gwiazdką na Dysku użytkownika. |
isTrashed() | Boolean | Określa, czy plik Folder znajduje się w koszu na Dysku użytkownika. |
moveTo(destination) | Folder | Przenosi ten element do podanego folderu docelowego. |
removeEditor(emailAddress) | Folder | Usunięcie użytkownika z listy edytorów Folder . |
removeEditor(user) | Folder | Usunięcie użytkownika z listy edytorów Folder . |
removeViewer(emailAddress) | Folder | Usunięcie użytkownika z listy widzów i komentujących: Folder . |
removeViewer(user) | Folder | Usunięcie użytkownika z listy widzów i komentujących: Folder . |
revokePermissions(emailAddress) | Folder | Cofnie dostęp do Folder przyznane danemu użytkownikowi. |
revokePermissions(user) | Folder | Cofnie dostęp do Folder przyznane danemu użytkownikowi. |
searchFiles(params) | FileIterator | Pobiera zbiór wszystkich plików podrzędnych bieżącego folderu, które spełniają określone kryteria wyszukiwania. |
searchFolders(params) | FolderIterator | Pobiera kolekcję wszystkich folderów podrzędnych tego folderu, które spełniają określone kryteria wyszukiwania. |
setDescription(description) | Folder | Ustawia opis elementu Folder . |
setName(name) | Folder | Ustawia nazwę tagu 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 w celu udostępnienia go przy użyciu linku. |
setShareableByEditors(shareable) | Folder | Określa, czy użytkownicy z uprawnieniami do edycji Folder mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia. |
setSharing(accessType, permissionType) | Folder | Określa, którzy użytkownicy mają dostęp do Folder i jakie uprawnienia otrzymują, a także dla poszczególnych użytkowników, którym jawnie przyznano dostęp. |
setStarred(starred) | Folder | Określa, czy element Folder jest oznaczony gwiazdką na Dysku użytkownika. |
setTrashed(trashed) | Folder | Określa, czy element Folder znajduje się w koszu na Dysku użytkownika. |
FolderIterator
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getContinuationToken() | String | Pobiera token, którego można później użyć do wznowienia tej iteracji. |
hasNext() | Boolean | Określa, czy wywołanie next() spowoduje zwrócenie elementu. |
next() | Folder | Pobiera następny element ze zbioru plików lub folderów. |
Permission
Usługi
Właściwość | Typ | Opis |
---|---|---|
VIEW | Enum | Użytkownicy, którzy mają dostęp do pliku lub folderu, mogą tylko go wyświetlać i kopiować. |
EDIT | Enum | Użytkownicy, którzy mają dostęp do pliku lub folderu, mogą go edytować. |
COMMENT | Enum | Użytkownicy, którzy mają dostęp do pliku lub folderu, mogą tylko go wyświetlać, kopiować i komentować. |
OWNER | Enum | Użytkownik jest właścicielem pliku lub folderu. |
ORGANIZER | Enum | Użytkownicy, którzy mogą porządkować pliki i foldery na dysku współdzielonym. |
FILE_ORGANIZER | Enum | Użytkownicy, którzy mogą edytować, usuwać i przenosić treści na dysku współdzielonym. |
NONE | Enum | Użytkownik nie ma żadnych uprawnień do pliku lub folderu. |
User
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getDomain() | String | Pobiera nazwę domeny powiązaną z kontem użytkownika. |
getEmail() | String | Pobiera adres e-mail użytkownika. |
getName() | String | Pobiera nazwę użytkownika. |
getPhotoUrl() | String | Pobiera adres URL zdjęcia użytkownika. |