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

Drive Service

Ta usługa umożliwia tworzenie, znajdowanie i modyfikowanie plików oraz folderów na Dysku Google.

Jeśli skrypt używa standardowego projektu Cloud zamiast domyślnego projektu Cloud, musisz ręcznie włączyć interfejs Drive API. W standardowym projekcie Cloud włącz interfejs Drive API:

Włącz interfejs Drive API

Poniższy przykładowy kod pokazuje, jak rejestrować nazwy plików w folderze Moje Dysku użytkownika:

// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

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

Jeśli jednak dodatek korzystający z usługi Dysk został opublikowany do instalacji w całej domenie i został zainstalowany przez administratora dla niektórych lub wszystkich użytkowników w domenie albo jeśli skrypt ma klienta OAuth na liście dozwolonych przez administratora domeny, dodatek będzie działać dla tych użytkowników, nawet jeśli interfejs API Dysku jest wyłączony w domenie.

Zajęcia

Nazwa	Krótki opis
`Access`	Typ enum reprezentujący klasy użytkowników, którzy mogą uzyskać dostęp do pliku lub folderu, oprócz poszczególnych użytkowników, którzy uzyskali dostęp.
`DriveApp`	Umożliwia skryptom tworzenie, znajdowanie i modyfikowanie plików oraz folderów na Dysku Google.
`File`	plik na Dysku Google,
`FileIterator`	Ćwiczenie, które umożliwia skryptom przeszukiwanie potencjalnie dużej kolekcji plików.
`Folder`	folder na Dysku Google,
`FolderIterator`	Obiekt, który umożliwia skryptom iterowanie przez potencjalnie dużą kolekcję folderów.
`Permission`	Typ enumeracji reprezentujący uprawnienia przyznane użytkownikom, którzy mogą uzyskać dostęp do pliku lub folderu, z wyłączeniem poszczególnych użytkowników, którym przyznano dostęp.
`User`	Użytkownik powiązany z plikiem na Dysku Google.

`Access`

Właściwości

Właściwość	Typ	Opis
`ANYONE`	`Enum`	Każdy użytkownik internetu może znajdować i uzyskiwać dostęp do tych treści.
`ANYONE_WITH_LINK`	`Enum`	Dostęp ma każda osoba mająca link.
`DOMAIN`	`Enum`	Osoby w Twojej domenie mogą znajdować i uzyskiwać dostęp.
`DOMAIN_WITH_LINK`	`Enum`	Osoby w domenie, które mają link, mogą uzyskiwać dostęp.
`PRIVATE`	`Enum`	Dostęp mogą uzyskać tylko osoby z uprawnieniami przyznanymi wprost.

`DriveApp`

Właściwości

Właściwość	Typ	Opis
`Access`	`Access`	Typ enum reprezentujący klasy użytkowników, którzy mogą uzyskać dostęp do pliku lub folderu, oprócz poszczególnych użytkowników, którzy uzyskali dostęp.
`Permission`	`Permission`	Typ enumeracji reprezentujący uprawnienia przyznane użytkownikom, którzy mogą uzyskać dostęp do pliku lub folderu, z wyłączeniem poszczególnych użytkowników, którym przyznano dostęp.

Metody

Metoda	Zwracany typ	Krótki opis
`continueFileIterator(continuationToken)`	`FileIterator`	Wznowienie iteracji pliku za pomocą tokena kontynuacji z poprzedniego iteratora.
`continueFolderIterator(continuationToken)`	`FolderIterator`	Wznawia iterację folderu za pomocą tokena kontynuacji z poprzedniego iteratora.
`createFile(blob)`	`File`	Tworzy plik w katalogu głównym Dysku użytkownika na podstawie dowolnych danych z danego `Blob`.
`createFile(name, content)`	`File`	Tworzy plik tekstowy w folderze głównym Dysku użytkownika o określonej nazwie i zawartości.
`createFile(name, content, mimeType)`	`File`	Tworzy plik w katalogu głównym Dysku użytkownika z podaną nazwą, treścią i typem MIME.
`createFolder(name)`	`Folder`	Tworzy folder w katalogu głównym Dysku użytkownika o podanej nazwie.
`createShortcut(targetId)`	`File`	Tworzy skrót do podanego identyfikatora elementu na Dysku i zwraca go.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Tworzy i zwraca skrót do podanego identyfikatora elementu i klucza zasobu na Dysku.
`enforceSingleParent(value)`	`void`	Włącza lub wyłącza zachowanie enforceSingleParent dla wszystkich wywołań wpływających na elementy nadrzędne.
`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 kolekcję wszystkich plików na Dysku użytkownika, które mają daną nazwę.
`getFilesByType(mimeType)`	`FileIterator`	Pobiera kolekcję wszystkich plików na Dysku użytkownika, które mają podany typ 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, które mają podaną nazwę.
`getRootFolder()`	`Folder`	Pobiera folder znajdujący się w katalogu głównym 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 kolekcję wszystkich plików znajdujących się w koszu na Dysku użytkownika.
`getTrashedFolders()`	`FolderIterator`	Pobiera kolekcję wszystkich folderów znajdujących się w koszu na Dysku użytkownika.
`searchFiles(params)`	`FileIterator`	Pobiera kolekcję wszystkich plików na Dysku użytkownika, które pasują do podanych kryteriów wyszukiwania.
`searchFolders(params)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów na Dysku użytkownika, które pasują do podanych kryteriów wyszukiwania.

`File`

Metody

Metoda	Zwracany typ	Krótki opis
`addCommenter(emailAddress)`	`File`	Dodaj danego użytkownika do listy komentujących `File`.
`addCommenter(user)`	`File`	Dodaj danego użytkownika do listy komentujących `File`.
`addCommenters(emailAddresses)`	`File`	Dodaj podany tablicowy zbiór użytkowników do listy komentujących w ramach `File`.
`addEditor(emailAddress)`	`File`	Dodaje danego użytkownika do listy edytujących `File`.
`addEditor(user)`	`File`	Dodaje danego użytkownika do listy edytujących `File`.
`addEditors(emailAddresses)`	`File`	Dodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku `File`.
`addViewer(emailAddress)`	`File`	Dodaje danego użytkownika do listy widzów `File`.
`addViewer(user)`	`File`	Dodaje danego użytkownika do listy widzów `File`.
`addViewers(emailAddresses)`	`File`	Dodaje podany tablicowy zbiór użytkowników do listy widzów `File`.
`getAccess(email)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getAccess(user)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getAs(contentType)`	`Blob`	Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści.
`getBlob()`	`Blob`	Zwraca dane z tego obiektu jako blob.
`getDateCreated()`	`Date`	Pobiera datę utworzenia elementu `File`.
`getDescription()`	`String`	Pobiera opis elementu `File`.
`getDownloadUrl()`	`String`	Pobiera adres URL, którego można użyć do pobrania pliku.
`getEditors()`	`User[]`	Pobiera listę edytorów tego `File`.
`getId()`	`String`	Pobiera identyfikator `File`.
`getLastUpdated()`	`Date`	Pobiera datę ostatniej aktualizacji elementu `File`.
`getMimeType()`	`String`	Pobiera typ MIME pliku.
`getName()`	`String`	Pobiera nazwę `File`.
`getOwner()`	`User`	Pobiera właściciela pliku.
`getParents()`	`FolderIterator`	Pobiera kolekcję folderów, które są bezpośrednimi folderami nadrzędnymi folderu `File`.
`getResourceKey()`	`String`	Pobiera klucz zasobu `File`, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.
`getSecurityUpdateEligible()`	`Boolean`	Określa, czy `File` może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniana za pomocą linku.
`getSecurityUpdateEnabled()`	`Boolean`	Pobiera informację, czy ten `File` wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku.
`getSharingAccess()`	`Access`	Pobiera informacje o klasie użytkowników, którzy mogą uzyskać dostęp do `File`, z wyjątkiem użytkowników, którzy mają wyraźnie przyznany dostęp.
`getSharingPermission()`	`Permission`	Pobiera uprawnienia przyznane użytkownikom, którzy mogą uzyskać dostęp do `File`, z wyjątkiem pojedynczych użytkowników, którym dostęp został wyraźnie przyznany.
`getSize()`	`Integer`	Pobiera liczbę bajtów użytych do przechowywania `File` na Dysku.
`getTargetId()`	`String`	Jeśli jest to skrót, zwraca identyfikator elementu, do którego się odwołuje.
`getTargetMimeType()`	`String`	Jeśli jest to skrót, zwraca typ MIME elementu, do którego się odwołuje.
`getTargetResourceKey()`	`String`	Jeśli plik jest skrótem, zwraca klucz zasobu elementu, do którego się odwołuje.
`getThumbnail()`	`Blob`	Pobiera miniaturę pliku lub `null`, jeśli miniatura nie istnieje.
`getUrl()`	`String`	Pobiera adres URL, za pomocą którego można otworzyć `File` w aplikacji Google, takiej jak Dysk lub Dokumenty.
`getViewers()`	`User[]`	Pobiera listę osób, które oglądały lub komentowały ten `File`.
`isShareableByEditors()`	`Boolean`	Określa, czy użytkownicy z uprawnieniami do edycji w `File` mogą udostępniać inne uprawnienia innym użytkownikom lub zmieniać uprawnienia.
`isStarred()`	`Boolean`	Określa, czy `File` zostało oznaczone gwiazdką na Dysku użytkownika.
`isTrashed()`	`Boolean`	Określa, czy `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 jej podany w prośbie nazwę.
`makeCopy(name, destination)`	`File`	Tworzy kopię pliku w katalogu docelowym i nadaje mu podany w parametrze nazwę.
`moveTo(destination)`	`File`	Przenosi ten element do podanego folderu docelowego.
`removeCommenter(emailAddress)`	`File`	Usuwa danego użytkownika z listy komentujących w przypadku `File`.
`removeCommenter(user)`	`File`	Usuwa danego użytkownika z listy komentujących w przypadku `File`.
`removeEditor(emailAddress)`	`File`	Usunięcie danego użytkownika z listy edytujących w przypadku `File`.
`removeEditor(user)`	`File`	Usunięcie danego użytkownika z listy edytujących w przypadku `File`.
`removeViewer(emailAddress)`	`File`	Usunięcie danego użytkownika z listy widzów i komentujących `File`.
`removeViewer(user)`	`File`	Usunięcie danego użytkownika z listy widzów i komentujących `File`.
`revokePermissions(emailAddress)`	`File`	Unieważnia przyznany danemu użytkownikowi dostęp do `File`.
`revokePermissions(user)`	`File`	Unieważnia przyznany danemu użytkownikowi dostęp do `File`.
`setContent(content)`	`File`	Zastępuje zawartość pliku podanym tekstem.
`setDescription(description)`	`File`	Ustawia opis `File`.
`setName(name)`	`File`	Ustawia nazwę `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, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku.
`setShareableByEditors(shareable)`	`File`	Określa, czy użytkownicy z uprawnieniami do edycji `File` mogą udostępniać innym użytkownikom lub zmieniać uprawnienia.
`setSharing(accessType, permissionType)`	`File`	Określa, które grupy użytkowników mogą uzyskać dostęp do `File` i jakie uprawnienia zostaną im przyznane, oprócz użytkowników indywidualnych, którzy uzyskali dostęp.
`setStarred(starred)`	`File`	Określa, czy `File` ma być oznaczone gwiazdką na Dysku użytkownika.
`setTrashed(trashed)`	`File`	Określa, czy `File` znajduje się w koszu na Dysku użytkownika.

`FileIterator`

Metody

Metoda	Zwracany typ	Krótki opis
`getContinuationToken()`	`String`	Pobiera token, który można wykorzystać do wznowienia tej iteracji w późniejszym czasie.
`hasNext()`	`Boolean`	Określa, czy wywołanie `next()` spowoduje zwrot produktu.
`next()`	`File`	Pobiera następny element z kolekcji plików lub folderów.

`Folder`

Metody

Metoda	Zwracany typ	Krótki opis
`addEditor(emailAddress)`	`Folder`	Dodaje danego użytkownika do listy edytujących `Folder`.
`addEditor(user)`	`Folder`	Dodaje danego użytkownika do listy edytujących `Folder`.
`addEditors(emailAddresses)`	`Folder`	Dodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku `Folder`.
`addViewer(emailAddress)`	`Folder`	Dodaje danego użytkownika do listy widzów `Folder`.
`addViewer(user)`	`Folder`	Dodaje danego użytkownika do listy widzów `Folder`.
`addViewers(emailAddresses)`	`Folder`	Dodaje podany tablicowy zbiór użytkowników do listy widzów `Folder`.
`createFile(blob)`	`File`	Tworzy plik w bieżącym folderze na podstawie dowolnych danych z podanego zbioru danych `Blob`.
`createFile(name, content)`	`File`	Tworzy plik tekstowy w bieżącym folderze o podanej nazwie i treści.
`createFile(name, content, mimeType)`	`File`	Tworzy plik w bieżącym folderze z podaną nazwą, treścią i typem MIME.
`createFolder(name)`	`Folder`	Tworzy folder w bieżącym folderze o podanej nazwie.
`createShortcut(targetId)`	`File`	Tworzy skrót do podanego identyfikatora elementu na Dysku i zwraca go.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Tworzy i zwraca skrót do podanego identyfikatora elementu i klucza zasobu na Dysku.
`getAccess(email)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getAccess(user)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getDateCreated()`	`Date`	Pobiera datę utworzenia elementu `Folder`.
`getDescription()`	`String`	Pobiera opis elementu `Folder`.
`getEditors()`	`User[]`	Pobiera listę edytorów tego `Folder`.
`getFiles()`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są podrzędnymi bieżącego folderu.
`getFilesByName(name)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są podrzędne względem bieżącego folderu i mają podaną nazwę.
`getFilesByType(mimeType)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są podrzędnymi bieżącego folderu i mają podany typ MIME.
`getFolders()`	`FolderIterator`	Pobiera kolekcję wszystkich folderów podrzędnych bieżącego folderu.
`getFoldersByName(name)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów, które są podrzędne względem bieżącego folderu i mają podaną nazwę.
`getId()`	`String`	Pobiera identyfikator `Folder`.
`getLastUpdated()`	`Date`	Pobiera datę ostatniej aktualizacji elementu `Folder`.
`getName()`	`String`	Pobiera nazwę `Folder`.
`getOwner()`	`User`	Pobiera właściciela tego `Folder`.
`getParents()`	`FolderIterator`	Pobiera kolekcję folderów, które są bezpośrednimi folderami nadrzędnymi folderu `Folder`.
`getResourceKey()`	`String`	Pobiera klucz zasobu `Folder`, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.
`getSecurityUpdateEligible()`	`Boolean`	Określa, czy `Folder` może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniana za pomocą linku.
`getSecurityUpdateEnabled()`	`Boolean`	Pobiera informację, czy ten `Folder` wymaga klucza zasobu, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku.
`getSharingAccess()`	`Access`	Pobiera informacje o tym, którzy użytkownicy mają dostęp do `Folder`, z wyjątkiem użytkowników, którzy mają dostęp indywidualny.
`getSharingPermission()`	`Permission`	Pobiera uprawnienia przyznane użytkownikom, którzy mogą uzyskać dostęp do `Folder`, z wyjątkiem pojedynczych użytkowników, którym dostęp został wyraźnie przyznany.
`getSize()`	`Integer`	Pobiera liczbę bajtów użytych do przechowywania `Folder` na Dysku.
`getUrl()`	`String`	Pobiera adres URL, za pomocą którego można otworzyć `Folder` w aplikacji Google, takiej jak Dysk lub Dokumenty.
`getViewers()`	`User[]`	Pobiera listę osób, które oglądały lub komentowały ten `Folder`.
`isShareableByEditors()`	`Boolean`	Określa, czy użytkownicy z uprawnieniami do edycji `Folder` mogą udostępniać inne uprawnienia innym użytkownikom lub zmieniać uprawnienia.
`isStarred()`	`Boolean`	Określa, czy `Folder` zostało oznaczone gwiazdką na Dysku użytkownika.
`isTrashed()`	`Boolean`	Określa, czy `Folder` znajduje się w koszu na Dysku użytkownika.
`moveTo(destination)`	`Folder`	Przenosi ten element do podanego folderu docelowego.
`removeEditor(emailAddress)`	`Folder`	Usunięcie danego użytkownika z listy edytujących w przypadku `Folder`.
`removeEditor(user)`	`Folder`	Usunięcie danego użytkownika z listy edytujących w przypadku `Folder`.
`removeViewer(emailAddress)`	`Folder`	Usunięcie danego użytkownika z listy widzów i komentujących `Folder`.
`removeViewer(user)`	`Folder`	Usunięcie danego użytkownika z listy widzów i komentujących `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Unieważnia przyznany danemu użytkownikowi dostęp do `Folder`.
`revokePermissions(user)`	`Folder`	Unieważnia przyznany danemu użytkownikowi dostęp do `Folder`.
`searchFiles(params)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są podrzędne bieżącego folderu i pasują do podanych kryteriów wyszukiwania.
`searchFolders(params)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów, które są podfolderami bieżącego folderu i pasują do podanych kryteriów wyszukiwania.
`setDescription(description)`	`Folder`	Ustawia opis `Folder`.
`setName(name)`	`Folder`	Ustawia nazwę `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, aby uzyskać dostęp, gdy jest udostępniany za pomocą linku.
`setShareableByEditors(shareable)`	`Folder`	Określa, czy użytkownicy z uprawnieniami do edycji `Folder` mogą udostępniać innym użytkownikom lub zmieniać uprawnienia.
`setSharing(accessType, permissionType)`	`Folder`	Określa, które grupy użytkowników mogą uzyskać dostęp do `Folder` i jakie uprawnienia zostaną im przyznane, z wyłączeniem użytkowników indywidualnych, którzy uzyskali dostęp wprost.
`setStarred(starred)`	`Folder`	Określa, czy `Folder` ma być oznaczone gwiazdką na Dysku użytkownika.
`setTrashed(trashed)`	`Folder`	Określa, czy `Folder` znajduje się w koszu na Dysku użytkownika.

`FolderIterator`

Metody

Metoda	Zwracany typ	Krótki opis
`getContinuationToken()`	`String`	Pobiera token, który można wykorzystać do wznowienia tej iteracji w późniejszym czasie.
`hasNext()`	`Boolean`	Określa, czy wywołanie `next()` spowoduje zwrot produktu.
`next()`	`Folder`	Pobiera następny element z kolekcji plików lub folderów.

`Permission`

Właściwości

Właściwość	Typ	Opis
`VIEW`	`Enum`	Użytkownicy, którzy mają dostęp do pliku lub folderu, mogą go tylko wyświetlać lub 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ą go tylko wyświetlać, kopiować lub 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 ani folderu.

`User`

Metody

Metoda	Zwracany typ	Krótki opis
`getDomain()`	`String`	Pobiera nazwę domeny powiązanej 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.