Drive Service

Dysk

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

NazwaKrótki opis
AccessWartość wyliczeniowa przedstawiająca grupy użytkowników, którzy mają dostęp do pliku lub folderu, oraz poszczególnych użytkowników, którym przyznano dostęp.
DriveAppUmożliwia skryptom tworzenie, znajdowanie i modyfikowanie plików oraz folderów na Dysku Google.
FilePlik na Dysku Google.
FileIteratorIterator, który umożliwia skryptom iterację na potencjalnie dużą kolekcję plików.
FolderFolder na Dysku Google.
FolderIteratorObiekt, który umożliwia skryptom iterację nad potencjalnie dużą kolekcją folderów.
PermissionLista wyliczeniowa przedstawiająca uprawnienia użytkownikom, którzy mają dostęp do pliku lub folderu, oraz poszczególnym użytkownikom, którym jednoznacznie przyznano dostęp.
UserUżytkownik powiązany z plikiem na Dysku Google.

Access

Właściwości

WłaściwośćTypOpis
ANYONEEnumKażdy użytkownik internetu może znaleźć ten element i uzyskać do niego dostęp.
ANYONE_WITH_LINKEnumDostęp ma każda osoba mająca link.
DOMAINEnumOsoby w Twojej domenie mogą znajdować i uzyskiwać dostęp.
DOMAIN_WITH_LINKEnumDostęp do plików mają osoby w Twojej domenie mające link.
PRIVATEEnumDostęp mogą uzyskać tylko osoby z uprawnieniami przyznanymi wprost.

DriveApp

Właściwości

WłaściwośćTypOpis
AccessAccessWartość wyliczeniowa przedstawiająca grupy użytkowników, którzy mają dostęp do pliku lub folderu, oraz poszczególnych użytkowników, którym przyznano dostęp.
PermissionPermissionLista wyliczeniowa przedstawiająca uprawnienia użytkownikom, którzy mają dostęp do pliku lub folderu, oraz poszczególnym użytkownikom, którym jednoznacznie przyznano dostęp.

Metody

MetodaZwracany typKrótki opis
continueFileIterator(continuationToken)FileIteratorWznawia iterację pliku za pomocą tokena kontynuacji z poprzedniego iteratora.
continueFolderIterator(continuationToken)FolderIteratorWznawia iterację folderu z użyciem tokena kontynuacji z poprzedniego iteratora.
createFile(blob)FileTworzy plik w katalogu głównym użytkownika na określonym dysku Blob z arbitralnych danych.
createFile(name, content)FileTworzy plik tekstowy w katalogu głównym konta użytkownika z podaną nazwą i treścią.
createFile(name, content, mimeType)FileTworzy plik w katalogu głównym Dysku użytkownika o podanej nazwie, zawartości i typie MIME.
createFolder(name)FolderTworzy folder w katalogu głównym konta użytkownika o podanej nazwie.
createShortcut(targetId)FileTworzy skrót do podanego identyfikatora elementu Dysku i zwraca go.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileTworzy skrót do podanego identyfikatora elementu Dysku i klucza zasobu, a następnie go zwraca.
enforceSingleParent(value)voidWłącza lub wyłącza wymuszanie działania funkcji PojedynczyMata dla wszystkich wywołań dotyczących elementów nadrzędnych elementu.
getFileById(id)FilePobiera plik o podanym identyfikatorze.
getFileByIdAndResourceKey(id, resourceKey)FilePobiera plik o podanym identyfikatorze i kluczu zasobu.
getFiles()FileIteratorPobiera zbiór wszystkich plików na Dysku użytkownika.
getFilesByName(name)FileIteratorPobiera zbiór wszystkich plików na Dysku użytkownika o danej nazwie.
getFilesByType(mimeType)FileIteratorPobiera zbiór wszystkich plików na Dysku użytkownika o określonym typie MIME.
getFolderById(id)FolderPobiera folder o podanym identyfikatorze.
getFolderByIdAndResourceKey(id, resourceKey)FolderPobiera folder o podanym identyfikatorze i kluczu zasobu.
getFolders()FolderIteratorPobiera zbiór wszystkich folderów na Dysku użytkownika.
getFoldersByName(name)FolderIteratorPobiera zbiór wszystkich folderów na Dysku użytkownika o danej nazwie.
getRootFolder()FolderPobiera folder do katalogu głównego Dysku użytkownika.
getStorageLimit()IntegerPobiera liczbę bajtów, które użytkownik może przechowywać na Dysku.
getStorageUsed()IntegerPobiera liczbę bajtów przechowywanych przez użytkownika na Dysku.
getTrashedFiles()FileIteratorPobiera zbiór wszystkich plików z kosza użytkownika na Dysk.
getTrashedFolders()FolderIteratorPobiera zbiór wszystkich folderów do kosza na Dysku użytkownika.
searchFiles(params)FileIteratorPobiera zbiór wszystkich plików na Dysku użytkownika, które spełniają określone kryteria wyszukiwania.
searchFolders(params)FolderIteratorPobiera zbiór wszystkich folderów na Dysku użytkownika, które spełniają podane kryteria wyszukiwania.

File

Metody

MetodaZwracany typKrótki opis
addCommenter(emailAddress)FileDodaj danego użytkownika do listy komentujących w polu File.
addCommenter(user)FileDodaj danego użytkownika do listy komentujących w polu File.
addCommenters(emailAddresses)FileDodaj podany zestaw użytkowników do listy komentujących w polu File.
addEditor(emailAddress)FileDodaje danego użytkownika do listy edytorów File.
addEditor(user)FileDodaje danego użytkownika do listy edytorów File.
addEditors(emailAddresses)FileDodaje daną tablicę użytkowników do listy edytorów File.
addViewer(emailAddress)FileDodaje danego użytkownika do listy widzów na liście File.
addViewer(user)FileDodaje danego użytkownika do listy widzów na liście File.
addViewers(emailAddresses)FileDodaje daną tablicę użytkowników do listy przeglądających File.
getAccess(email)PermissionPobiera uprawnienia przyznane danemu użytkownikowi.
getAccess(user)PermissionPobiera uprawnienia przyznane danemu użytkownikowi.
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane wewnątrz tego obiektu jako blob.
getDateCreated()DatePobiera datę utworzenia File.
getDescription()StringPobiera opis File.
getDownloadUrl()StringPobiera adres URL, którego można użyć do pobrania pliku.
getEditors()User[]Pobiera listę edytorów File.
getId()StringPobiera identyfikator File.
getLastUpdated()DatePobiera datę ostatniej aktualizacji zdarzenia File.
getMimeType()StringPobiera typ MIME pliku.
getName()StringPobiera nazwę File.
getOwner()UserPobiera właściciela elementu File.
getParents()FolderIteratorPobiera zbiór folderów, które są bezpośrednio elementami nadrzędnymi elementu File.
getResourceKey()StringPobiera klucz zasobu File, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.
getSecurityUpdateEligible()BooleanOkreśla, czy File może stosować aktualizację zabezpieczeń, która wymaga dostępu do zasobu za pomocą linku.
getSecurityUpdateEnabled()BooleanPobiera, czy File wymaga klucza dostępu do zasobu, gdy jest udostępniany za pomocą linku.
getSharingAccess()AccessPobiera klasę użytkowników, którzy mają mieć dostęp do File, oprócz poszczególnych użytkowników, którym przyznano dostęp.
getSharingPermission()PermissionPobiera uprawnienia do tych użytkowników, którzy mają dostęp do File, oprócz tych, którzy otrzymali dostęp jawnie.
getSize()IntegerPobiera liczbę bajtów używanych do przechowywania elementu File na Dysku.
getTargetId()StringJeśli jest to skrót, zwraca identyfikator elementu, do którego prowadzi.
getTargetMimeType()StringJeśli jest to skrót, zwraca typ MIME elementu, do którego prowadzi.
getTargetResourceKey()StringJeśli plik jest skrótem, zwraca klucz zasobu elementu, do którego się on odnosi.
getThumbnail()BlobPobiera miniaturę pliku lub null, jeśli nie ma miniatury.
getUrl()StringPobiera 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 komentujących w przypadku: File.
isShareableByEditors()BooleanOkreśla, czy użytkownicy z uprawnieniami do edycji elementu File mogą udostępniać go innym użytkownikom lub zmieniać uprawnienia.
isStarred()BooleanOkreśla, czy element File został oznaczony gwiazdką na Dysku użytkownika.
isTrashed()BooleanOkreśla, czy File znajduje się w koszu na Dysku użytkownika.
makeCopy()FileTworzy kopię pliku.
makeCopy(destination)FileTworzy kopię pliku w katalogu docelowym.
makeCopy(name)FileTworzy kopię pliku i nadaje mu nazwę.
makeCopy(name, destination)FileTworzy kopię pliku w katalogu docelowym i nadaje mu nazwę.
moveTo(destination)FilePrzenosi ten element do podanego folderu docelowego.
removeCommenter(emailAddress)FileUsuwa tego użytkownika z listy komentujących File.
removeCommenter(user)FileUsuwa tego użytkownika z listy komentujących File.
removeEditor(emailAddress)FileDanego użytkownika nie ma na liście edytorów File.
removeEditor(user)FileDanego użytkownika nie ma na liście edytorów File.
removeViewer(emailAddress)FileUsunięcie określonego użytkownika z listy widzów i komentujących mających miejsce w domenie File.
removeViewer(user)FileUsunięcie określonego użytkownika z listy widzów i komentujących mających miejsce w domenie File.
revokePermissions(user)FileUnieważnia dostęp aplikacji File przyznanej użytkownikowi.
revokePermissions(user)FileUnieważnia dostęp aplikacji File przyznanej użytkownikowi.
setContent(content)FileZastępuje zawartość pliku konkretną zamianą.
setDescription(description)FileUstawia opis File.
setName(name)FileUstawia nazwę tagu File.
setOwner(emailAddress)FileZmienia właściciela elementu File.
setOwner(user)FileZmienia właściciela elementu File.
setSecurityUpdateEnabled(enabled)FileOkreśla, czy File wymaga dostępu do klucza po udostępnieniu linku za pomocą linku.
setShareableByEditors(shareable)FileOkreśla, czy użytkownicy z uprawnieniami do edycji File mogą udostępniać je innym użytkownikom lub zmieniać uprawnienia.
setSharing(accessType, permissionType)FileOkreśla grupę użytkowników, którzy mają mieć dostęp do File, i uprawnienia przyznane tym użytkownikom, a nie tylko poszczególnym użytkownikom, którym udzielono dostępu.
setStarred(starred)FileOkreśla, czy element File jest oznaczony gwiazdką na Dysku użytkownika.
setTrashed(trashed)FileOkreśla, czy File znajduje się w koszu na Dysku użytkownika.

FileIterator

Metody

MetodaZwracany typKrótki opis
getContinuationToken()StringPobiera token, który można później wznowić.
hasNext()BooleanOkreśla, czy wywołanie elementu next() spowoduje zwrócenie elementu.
next()FilePobiera następny element ze zbioru plików lub folderów.

Folder

Metody

MetodaZwracany typKrótki opis
addEditor(emailAddress)FolderDodaje danego użytkownika do listy edytorów Folder.
addEditor(user)FolderDodaje danego użytkownika do listy edytorów Folder.
addEditors(emailAddresses)FolderDodaje daną tablicę użytkowników do listy edytorów Folder.
addViewer(emailAddress)FolderDodaje danego użytkownika do listy widzów na liście Folder.
addViewer(user)FolderDodaje danego użytkownika do listy widzów na liście Folder.
addViewers(emailAddresses)FolderDodaje daną tablicę użytkowników do listy przeglądających Folder.
createFile(blob)FileTworzy plik w bieżącym folderze na podstawie określonych danych Blob.
createFile(name, content)FileTworzy w bieżącym folderze plik tekstowy o podanej nazwie i zawartości.
createFile(name, content, mimeType)FileTworzy w bieżącym folderze plik o podanej nazwie, treści i typie MIME.
createFolder(name)FolderTworzy folder w bieżącym folderze o podanej nazwie.
createShortcut(targetId)FileTworzy skrót do podanego identyfikatora elementu Dysku i zwraca go.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileTworzy skrót do podanego identyfikatora elementu Dysku i klucza zasobu, a następnie go zwraca.
getAccess(email)PermissionPobiera uprawnienia przyznane danemu użytkownikowi.
getAccess(user)PermissionPobiera uprawnienia przyznane danemu użytkownikowi.
getDateCreated()DatePobiera datę utworzenia Folder.
getDescription()StringPobiera opis Folder.
getEditors()User[]Pobiera listę edytorów Folder.
getFiles()FileIteratorPobiera zbiór wszystkich plików podrzędnych folderu bieżącego.
getFilesByName(name)FileIteratorPobiera zbiór wszystkich plików podrzędnych bieżącego folderu o podanej nazwie.
getFilesByType(mimeType)FileIteratorPobiera zbiór wszystkich plików podrzędnych bieżącego folderu, które mają określony typ MIME.
getFolders()FolderIteratorPobiera zbiór wszystkich folderów podrzędnych folderu bieżącego.
getFoldersByName(name)FolderIteratorPobiera kolekcję wszystkich folderów podrzędnych bieżącego folderu o podanej nazwie.
getId()StringPobiera identyfikator Folder.
getLastUpdated()DatePobiera datę ostatniej aktualizacji zdarzenia Folder.
getName()StringPobiera nazwę Folder.
getOwner()UserPobiera właściciela elementu Folder.
getParents()FolderIteratorPobiera zbiór folderów, które są bezpośrednio elementami nadrzędnymi elementu 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 stosować aktualizację zabezpieczeń, która wymaga dostępu do zasobu za pomocą linku.
getSecurityUpdateEnabled()BooleanPobiera, czy Folder wymaga klucza dostępu do zasobu, gdy jest udostępniany za pomocą linku.
getSharingAccess()AccessPobiera klasę użytkowników, którzy mają mieć dostęp do Folder, oprócz poszczególnych użytkowników, którym przyznano dostęp.
getSharingPermission()PermissionPobiera uprawnienia do tych użytkowników, którzy mają dostęp do Folder, oprócz tych, którzy otrzymali dostęp jawnie.
getSize()IntegerPobiera liczbę bajtów używanych do przechowywania elementu Folder na Dysku.
getUrl()StringPobiera 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 komentujących w przypadku: Folder.
isShareableByEditors()BooleanOkreśla, czy użytkownicy z uprawnieniami do edycji elementu Folder mogą udostępniać go innym użytkownikom lub zmieniać uprawnienia.
isStarred()BooleanOkreśla, czy element Folder został oznaczony gwiazdką na Dysku użytkownika.
isTrashed()BooleanOkreśla, czy Folder znajduje się w koszu na Dysku użytkownika.
moveTo(destination)FolderPrzenosi ten element do podanego folderu docelowego.
removeEditor(emailAddress)FolderDanego użytkownika nie ma na liście edytorów Folder.
removeEditor(user)FolderDanego użytkownika nie ma na liście edytorów Folder.
removeViewer(emailAddress)FolderUsunięcie określonego użytkownika z listy widzów i komentujących mających miejsce w domenie Folder.
removeViewer(user)FolderUsunięcie określonego użytkownika z listy widzów i komentujących mających miejsce w domenie Folder.
revokePermissions(user)FolderUnieważnia dostęp aplikacji Folder przyznanej użytkownikowi.
revokePermissions(user)FolderUnieważnia dostęp aplikacji Folder przyznanej użytkownikowi.
searchFiles(params)FileIteratorPobiera zbiór wszystkich plików podrzędnych bieżącego folderu, które spełniają określone kryteria wyszukiwania.
searchFolders(params)FolderIteratorPobiera zbiór wszystkich folderów podrzędnych bieżącego folderu, które spełniają określone kryteria wyszukiwania.
setDescription(description)FolderUstawia opis Folder.
setName(name)FolderUstawia nazwę tagu Folder.
setOwner(emailAddress)FolderZmienia właściciela elementu Folder.
setOwner(user)FolderZmienia właściciela elementu Folder.
setSecurityUpdateEnabled(enabled)FolderOkreśla, czy Folder wymaga dostępu do klucza po udostępnieniu linku za pomocą linku.
setShareableByEditors(shareable)FolderOkreśla, czy użytkownicy z uprawnieniami do edycji Folder mogą udostępniać je innym użytkownikom lub zmieniać uprawnienia.
setSharing(accessType, permissionType)FolderOkreśla grupę użytkowników, którzy mają mieć dostęp do Folder, i uprawnienia przyznane tym użytkownikom, a nie tylko poszczególnym użytkownikom, którym udzielono dostępu.
setStarred(starred)FolderOkreśla, czy element Folder jest oznaczony gwiazdką na Dysku użytkownika.
setTrashed(trashed)FolderOkreśla, czy Folder znajduje się w koszu na Dysku użytkownika.

FolderIterator

Metody

MetodaZwracany typKrótki opis
getContinuationToken()StringPobiera token, który można później wznowić.
hasNext()BooleanOkreśla, czy wywołanie elementu next() spowoduje zwrócenie elementu.
next()FolderPobiera następny element ze zbioru plików lub folderów.

Permission

Właściwości

WłaściwośćTypOpis
VIEWEnumUżytkownicy, którzy mają dostęp do pliku lub folderu, mogą go tylko wyświetlić lub skopiować.
EDITEnumUżytkownicy, którzy mają dostęp do pliku lub folderu, mogą go edytować.
COMMENTEnumUżytkownicy, którzy mają dostęp do pliku lub folderu, mogą go tylko wyświetlić, skopiować lub skomentować.
OWNEREnumPlik lub folder należy do użytkownika.
ORGANIZEREnumUżytkownicy, którzy mogą porządkować pliki i foldery na dysku współdzielonym.
FILE_ORGANIZEREnumUżytkownicy, którzy mogą edytować, usuwać i przenosić treści na dysku współdzielonym.
NONEEnumUżytkownik nie ma uprawnień do pliku lub folderu.

User

Metody

MetodaZwracany typKrótki opis
getDomain()StringPobiera nazwę domeny powiązaną z kontem użytkownika.
getEmail()StringPobiera adres e-mail użytkownika.
getName()StringPobiera nazwę użytkownika.
getPhotoUrl()StringPobiera adres URL zdjęcia użytkownika.