Ta strona została przetłumaczona przez Cloud Translation API.

Drive Service

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());
}

Uwaga: administratorzy domen Google Workspace mogą wyłączyć pakiet SDK Dysku dla swojej domeny, co uniemożliwia użytkownikom instalowanie i używanie aplikacji Dysku Google. To ustawienie uniemożliwi też użytkownikom korzystanie ze skryptów Apps Script, aplikacji internetowych i dodatków, które używają usługi Dysk lub zaawansowanych usług Dysku (nawet jeśli odpowiedni dodatek lub aplikacja internetowa zostały zainstalowane przed wyłączeniem pakietu SDK Dysku).

Jeśli jednak dodatek utworzony przy użyciu usługi Dysk jest opublikowany w całej domenie i zainstalowany przez administratora dla niektórych lub wszystkich użytkowników domeny albo dowolnego skryptu Apps Script, który znajdował się na liście dozwolonych klientów OAuth przez administratora domeny, dodatek będzie działać na jego kontach nawet wtedy, gdy pakiet SDK SDK jest wyłączony w domenie.

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.