Drive Service

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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
Accesswyliczenie 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.
DriveAppUmożliwia skryptom tworzenie, znajdowanie i modyfikowanie plików oraz folderów na Dysku Google.
FilePlik na Dysku Google.
FileIteratoriterator, który pozwala skryptom na iterację nad potencjalnie dużym zbiorem plików.
FolderFolder na Dysku Google.
FolderIteratorObiekt, który pozwala skryptom na iterację nad potencjalnie dużą kolekcją folderów.
Permissionwyliczenie 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;
UserUżytkownik powiązany z plikiem na Dysku Google.

Access

Usługi

WłaściwośćTypOpis
ANYONEEnumKażdy użytkownik internetu może znajdować te treści i uzyskiwać do nich dostęp.
ANYONE_WITH_LINKEnumKażda osoba mająca link może uzyskiwać dostęp.
DOMAINEnumOsoby w Twojej domenie mogą znajdować i uzyskiwać dostęp.
DOMAIN_WITH_LINKEnumOsoby w Twojej domenie, które mają link, mogą uzyskiwać dostęp.
PRIVATEEnumDostęp mogą uzyskać tylko osoby z uprawnieniami przyznanymi wprost.

DriveApp

Usługi

WłaściwośćTypOpis
AccessAccesswyliczenie 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.
PermissionPermissionwyliczenie 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

MetodaZwracany typKrótki opis
continueFileIterator(continuationToken)FileIteratorWznawia iterację pliku za pomocą tokena kontynuacji z poprzedniego iteratora.
continueFolderIterator(continuationToken)FolderIteratorWznawia iterację folderu przy użyciu tokena kontynuacji z poprzedniego iteratora.
createFile(blob)FileTworzy plik w katalogu głównym Dysku użytkownika na podstawie Blob dowolnych danych.
createFile(name, content)FileTworzy plik tekstowy w katalogu głównym Dysku użytkownika o podanej nazwie i zawartości.
createFile(name, content, mimeType)FileTworzy plik w katalogu głównym Dysku użytkownika o podanej nazwie, treści i typie MIME.
createFolder(name)FolderTworzy folder w katalogu głównym Dysku użytkownika o podanej nazwie.
createShortcut(targetId)FilePowoduje utworzenie skrótu do podanego identyfikatora elementu na Dysku i zwraca go.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileTworzy skrót do identyfikatora elementu Dysku i klucza zasobu oraz zwraca go.
enforceSingleParent(value)voidWłącza lub wyłącza wymuszanie zachowania funkcji PojedynczyRodzic nad wszystkimi wywołaniami dotyczącymi 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 kolekcję wszystkich plików na Dysku użytkownika.
getFilesByName(name)FileIteratorPobiera zbiór wszystkich plików na Dysku użytkownika o określonej nazwie.
getFilesByType(mimeType)FileIteratorPobiera zbiór wszystkich plików na Dysku użytkownika o danym typie MIME.
getFolderById(id)FolderPobiera folder o podanym identyfikatorze.
getFolderByIdAndResourceKey(id, resourceKey)FolderPobiera folder o podanym identyfikatorze i kluczu zasobu.
getFolders()FolderIteratorPobiera kolekcję wszystkich folderów na Dysku użytkownika.
getFoldersByName(name)FolderIteratorPobiera kolekcję wszystkich folderów na Dysku użytkownika o określonej nazwie.
getRootFolder()FolderPobiera folder z poziomu 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, które użytkownik obecnie przechowuje na Dysku.
getTrashedFiles()FileIteratorPobiera zbiór wszystkich plików znajdujących się w koszu na Dysku użytkownika.
getTrashedFolders()FolderIteratorPobiera kolekcję wszystkich folderów w koszu Dysku użytkownika.
searchFiles(params)FileIteratorPobiera na Dysku użytkownika kolekcję wszystkich plików, które spełniają podane kryteria wyszukiwania.
searchFolders(params)FolderIteratorPobiera zbiór wszystkich folderów na Dysku użytkownika, które spełniają określone kryteria wyszukiwania.

File

Metody

MetodaZwracany typKrótki opis
addCommenter(emailAddress)FileDodaj danego użytkownika do listy komentujących, aby dodać File.
addCommenter(user)FileDodaj danego użytkownika do listy komentujących, aby dodać File.
addCommenters(emailAddresses)FileDodaj daną tablicę użytkowników do listy komentujących File.
addEditor(emailAddress)FileDodaje wybranego użytkownika do listy edytorów File.
addEditor(user)FileDodaje wybranego użytkownika do listy edytorów File.
addEditors(emailAddresses)FileDodaje określoną tablicę użytkowników do listy edytorów File.
addViewer(emailAddress)FileDodaje danego użytkownika do listy widzów elementu File.
addViewer(user)FileDodaje danego użytkownika do listy widzów elementu File.
addViewers(emailAddresses)FileDodaje określoną tablicę użytkowników do listy widzów elementu File.
getAccess(email)PermissionPobiera uprawnienia przyznane użytkownikowi.
getAccess(user)PermissionPobiera uprawnienia przyznane użytkownikowi.
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu w postaci obiektu blob przekonwertowanego na określony typ treści.
getBlob()BlobZwróć dane wewnątrz tego obiektu jako obiekt blob.
getDateCreated()DatePobiera datę utworzenia zasobu File.
getDescription()StringPobiera opis File.
getDownloadUrl()StringPobiera adres URL, którego można użyć do pobrania pliku.
getEditors()User[]Pobiera listę edytorów tego pliku (File).
getId()StringPobiera identyfikator File.
getLastUpdated()DatePobiera datę ostatniej aktualizacji zasobu File.
getMimeType()StringPobiera typ MIME pliku.
getName()StringPobiera nazwę File.
getOwner()UserPobiera właściciela zasobu File.
getParents()FolderIteratorPobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnym folderu File.
getResourceKey()StringPobiera klucz zasobu File wymagany do uzyskania dostępu do elementów, które zostały udostępnione za pomocą linku.
getSecurityUpdateEligible()BooleanOkreśla, czy File może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu w celu udostępnienia go przy użyciu linku.
getSecurityUpdateEnabled()BooleanOkreśla, czy File wymaga klucza dostępu do zasobu, gdy jest udostępniany za pomocą linku.
getSharingAccess()AccessPobiera klasę użytkowników, która pozwala uzyskać dostęp do zasobu File, wraz z użytkownikami, którym przyznano dostęp wprost.
getSharingPermission()PermissionPobiera 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()IntegerPobiera liczbę bajtów używanych do przechowywania pliku 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 prowadzi.
getThumbnail()BlobPobiera miniaturę pliku lub null, jeśli nie ma żadnej 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 komentarzy do filmu File.
isShareableByEditors()BooleanOkreśla, czy użytkownicy z uprawnieniami do edycji File mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia.
isStarred()BooleanOkreśla, czy element File został oznaczony gwiazdką na Dysku użytkownika.
isTrashed()BooleanOkreśla, czy plik 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)FileUsunięcie użytkownika z listy komentujących dotyczącą elementu File.
removeCommenter(user)FileUsunięcie użytkownika z listy komentujących dotyczącą elementu File.
removeEditor(emailAddress)FileUsunięcie użytkownika z listy edytorów File.
removeEditor(user)FileUsunięcie użytkownika z listy edytorów File.
removeViewer(emailAddress)FileUsunięcie użytkownika z listy widzów i komentujących: File.
removeViewer(user)FileUsunięcie użytkownika z listy widzów i komentujących: File.
revokePermissions(emailAddress)FileCofnie dostęp do File przyznane danemu użytkownikowi.
revokePermissions(user)FileCofnie dostęp do File przyznane danemu użytkownikowi.
setContent(content)FileZastępuje treść pliku przy danej zmianie.
setDescription(description)FileUstawia opis elementu File.
setName(name)FileUstawia nazwę tagu File.
setOwner(emailAddress)FileZmienia właściciela File.
setOwner(user)FileZmienia właściciela File.
setSecurityUpdateEnabled(enabled)FileOkreśla, czy File wymaga klucza zasobu w celu udostępnienia go przy użyciu linku.
setShareableByEditors(shareable)FileOkreśla, czy użytkownicy z uprawnieniami do edycji File mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia.
setSharing(accessType, permissionType)FileOkreś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)FileOkreśla, czy element File jest oznaczony gwiazdką na Dysku użytkownika.
setTrashed(trashed)FileOkreśla, czy element File znajduje się w koszu na Dysku użytkownika.

FileIterator

Metody

MetodaZwracany typKrótki opis
getContinuationToken()StringPobiera token, którego można później użyć do wznowienia tej iteracji.
hasNext()BooleanOkreśla, czy wywołanie 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 wybranego użytkownika do listy edytorów Folder.
addEditor(user)FolderDodaje wybranego użytkownika do listy edytorów Folder.
addEditors(emailAddresses)FolderDodaje określoną tablicę użytkowników do listy edytorów Folder.
addViewer(emailAddress)FolderDodaje danego użytkownika do listy widzów elementu Folder.
addViewer(user)FolderDodaje danego użytkownika do listy widzów elementu Folder.
addViewers(emailAddresses)FolderDodaje określoną tablicę użytkowników do listy widzów elementu Folder.
createFile(blob)FileTworzy plik w bieżącym folderze na podstawie Blob dowolnych danych.
createFile(name, content)FileTworzy plik tekstowy w bieżącym folderze 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)FilePowoduje utworzenie skrótu do podanego identyfikatora elementu na Dysku i zwraca go.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileTworzy skrót do identyfikatora elementu Dysku i klucza zasobu oraz zwraca go.
getAccess(email)PermissionPobiera uprawnienia przyznane użytkownikowi.
getAccess(user)PermissionPobiera uprawnienia przyznane użytkownikowi.
getDateCreated()DatePobiera datę utworzenia zasobu Folder.
getDescription()StringPobiera opis Folder.
getEditors()User[]Pobiera listę edytorów tego pliku (Folder).
getFiles()FileIteratorPobiera zbiór wszystkich plików podrzędnych bieżącego folderu.
getFilesByName(name)FileIteratorPobiera kolekcję wszystkich plików podrzędnych wobec bieżącego folderu o danej nazwie.
getFilesByType(mimeType)FileIteratorPobiera zbiór wszystkich plików podrzędnych bieżącego folderu i mających określony typ MIME.
getFolders()FolderIteratorPobiera kolekcję wszystkich folderów podrzędnych bieżącego folderu.
getFoldersByName(name)FolderIteratorPobiera kolekcję wszystkich folderów podrzędnych wobec bieżącego folderu i o danej nazwie.
getId()StringPobiera identyfikator Folder.
getLastUpdated()DatePobiera datę ostatniej aktualizacji zasobu Folder.
getName()StringPobiera nazwę Folder.
getOwner()UserPobiera właściciela zasobu Folder.
getParents()FolderIteratorPobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnym folderu Folder.
getResourceKey()StringPobiera klucz zasobu Folder wymagany do uzyskania dostępu do elementów, które zostały udostępnione za pomocą linku.
getSecurityUpdateEligible()BooleanOkreśla, czy Folder może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu w celu udostępnienia go przy użyciu linku.
getSecurityUpdateEnabled()BooleanOkreśla, czy Folder wymaga klucza dostępu do zasobu, gdy jest udostępniany za pomocą linku.
getSharingAccess()AccessPobiera klasę użytkowników, która pozwala uzyskać dostęp do zasobu Folder, wraz z użytkownikami, którym przyznano dostęp wprost.
getSharingPermission()PermissionPobiera 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()IntegerPobiera liczbę bajtów używanych do przechowywania pliku 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 komentarzy do filmu Folder.
isShareableByEditors()BooleanOkreśla, czy użytkownicy z uprawnieniami do edycji Folder mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia.
isStarred()BooleanOkreśla, czy element Folder został oznaczony gwiazdką na Dysku użytkownika.
isTrashed()BooleanOkreśla, czy plik Folder znajduje się w koszu na Dysku użytkownika.
moveTo(destination)FolderPrzenosi ten element do podanego folderu docelowego.
removeEditor(emailAddress)FolderUsunięcie użytkownika z listy edytorów Folder.
removeEditor(user)FolderUsunięcie użytkownika z listy edytorów Folder.
removeViewer(emailAddress)FolderUsunięcie użytkownika z listy widzów i komentujących: Folder.
removeViewer(user)FolderUsunięcie użytkownika z listy widzów i komentujących: Folder.
revokePermissions(emailAddress)FolderCofnie dostęp do Folder przyznane danemu użytkownikowi.
revokePermissions(user)FolderCofnie dostęp do Folder przyznane danemu 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 kolekcję wszystkich folderów podrzędnych tego folderu, które spełniają określone kryteria wyszukiwania.
setDescription(description)FolderUstawia opis elementu Folder.
setName(name)FolderUstawia nazwę tagu Folder.
setOwner(emailAddress)FolderZmienia właściciela Folder.
setOwner(user)FolderZmienia właściciela Folder.
setSecurityUpdateEnabled(enabled)FolderOkreśla, czy Folder wymaga klucza zasobu w celu udostępnienia go przy użyciu linku.
setShareableByEditors(shareable)FolderOkreśla, czy użytkownicy z uprawnieniami do edycji Folder mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia.
setSharing(accessType, permissionType)FolderOkreś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)FolderOkreśla, czy element Folder jest oznaczony gwiazdką na Dysku użytkownika.
setTrashed(trashed)FolderOkreśla, czy element Folder znajduje się w koszu na Dysku użytkownika.

FolderIterator

Metody

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

Permission

Usługi

WłaściwośćTypOpis
VIEWEnumUżytkownicy, którzy mają dostęp do pliku lub folderu, mogą tylko go wyświetlać i kopiować.
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ą tylko go wyświetlać, kopiować i komentować.
OWNEREnumUżytkownik jest właścicielem pliku lub folderu.
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 żadnych 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.