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. Wbudowana usługa Dysku jest łatwiejsza w użyciu, ale ma pewne ograniczenia. Aby korzystać z najnowszych funkcji i pomocy oraz uzyskiwać dostęp do plików i folderów na dyskach współdzielonych, używaj zaawansowanej usługi Dysku.

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

Włącz interfejs Drive API

Poniższy przykładowy kod pokazuje, jak rejestrować nazwy każdego pliku w folderze Mój Dysk 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ć 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 używają usługi Dysku lub zaawansowanej usługi Dysku (nawet jeśli dodatek lub aplikacja internetowa zostały zainstalowane, zanim administrator wyłączył pakiet SDK Dysku).

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

Zajęcia

Nazwa	Krótki opis
`Access`	Wyliczenie reprezentujące klasy użytkowników, którzy mogą uzyskać dostęp do pliku lub folderu, oprócz poszczególnych użytkowników, którym wyraźnie przyznano dostęp.
`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 umożliwia skryptom iterowanie po potencjalnie dużym zbiorze plików.
`Folder`	folder na Dysku Google;
`FolderIterator`	Obiekt, który umożliwia skryptom iterowanie po potencjalnie dużej kolekcji folderów.
`Permission`	Wyliczenie reprezentujące uprawnienia przyznane użytkownikom, którzy mają dostęp do pliku lub folderu, oprócz użytkowników, którym wyraźnie 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.
`ANYONE_WITH_LINK`	`Enum`	Każda osoba mająca link może uzyskać dostęp do tego elementu.
`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`	Wyliczenie reprezentujące klasy użytkowników, którzy mogą uzyskać dostęp do pliku lub folderu, oprócz poszczególnych użytkowników, którym wyraźnie przyznano dostęp.
`Permission`	`Permission`	Wyliczenie reprezentujące uprawnienia przyznane użytkownikom, którzy mają dostęp do pliku lub folderu, oprócz użytkowników, którym wyraźnie przyznano dostęp.

Metody

Metoda	Zwracany typ	Krótki opis
`continueFileIterator(continuationToken)`	`FileIterator`	Wznawia iterację pliku przy użyciu tokena kontynuacji z poprzedniego iteratora.
`continueFolderIterator(continuationToken)`	`FolderIterator`	Wznawia iterację folderu, używając tokena kontynuacji z poprzedniego iteratora.
`createFile(blob)`	`File`	Tworzy plik w folderze głównym na Dysku użytkownika na podstawie podanego `Blob` z dowolnymi danymi.
`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, zawartości i typie MIME.
`createFolder(name)`	`Folder`	Tworzy folder w katalogu głównym na 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 skrót do podanego identyfikatora elementu na Dysku i klucza zasobu, a następnie go zwraca.
`enforceSingleParent(value)`	`void`	Włącza lub wyłącza zachowanie enforceSingleParent w przypadku 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ą podaną 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 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 w koszu na Dysku użytkownika.
`getTrashedFolders()`	`FolderIterator`	Pobiera kolekcję wszystkich folderów 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 spełniają podane kryteria wyszukiwania.

`File`

Metody

Metoda	Zwracany typ	Krótki opis
`addCommenter(emailAddress)`	`File`	Dodaj podanego użytkownika do listy komentujących `File`.
`addCommenter(user)`	`File`	Dodaj podanego użytkownika do listy komentujących `File`.
`addCommenters(emailAddresses)`	`File`	Dodaj podaną tablicę użytkowników do listy komentujących w przypadku elementu `File`.
`addEditor(emailAddress)`	`File`	Dodaje podanego użytkownika do listy edytujących `File`.
`addEditor(user)`	`File`	Dodaje podanego użytkownika do listy edytujących `File`.
`addEditors(emailAddresses)`	`File`	Dodaje podaną tablicę użytkowników do listy edytujących `File`.
`addViewer(emailAddress)`	`File`	Dodaje podanego użytkownika do listy osób, które mogą wyświetlać `File`.
`addViewer(user)`	`File`	Dodaje podanego użytkownika do listy osób, które mogą wyświetlać `File`.
`addViewers(emailAddresses)`	`File`	Dodaje podaną tablicę 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 w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
`getBlob()`	`Blob`	Zwraca dane w tym obiekcie jako obiekt blob.
`getDateCreated()`	`Date`	Pobiera datę utworzenia `File`.
`getDescription()`	`String`	Pobiera opis elementu `File`.
`getDownloadUrl()`	`String`	Pobiera adres URL, który można wykorzystać do pobrania pliku.
`getEditors()`	`User[]`	Pobiera listę edytorów tego `File`.
`getId()`	`String`	Pobiera identyfikator `File`.
`getLastUpdated()`	`Date`	Pobiera datę ostatniej aktualizacji `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 elementami nadrzędnymi elementu `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 ten `File` może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku.
`getSecurityUpdateEnabled()`	`Boolean`	Określa, czy ten `File` wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku.
`getSharingAccess()`	`Access`	Określa, która grupa użytkowników może uzyskać dostęp do `File`, oprócz użytkowników, którym wyraźnie przyznano dostęp.
`getSharingPermission()`	`Permission`	Pobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do `File`, oprócz użytkowników, którym wyraźnie przyznano dostęp.
`getSize()`	`Integer`	Pobiera liczbę bajtów używanych do przechowywania `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\|null`	Pobiera miniaturę pliku lub `null`, jeśli miniatura nie istnieje.
`getUrl()`	`String`	Pobiera adres URL, którego można użyć do otwarcia `File` w aplikacji Google, takiej jak Dysk lub Dokumenty.
`getViewers()`	`User[]`	Pobiera listę przeglądających i komentujących dla tego `File`.
`isShareableByEditors()`	`Boolean`	Określa, czy użytkownicy z uprawnieniami do edycji `File` mogą udostępniać je innym użytkownikom lub zmieniać uprawnienia.
`isStarred()`	`Boolean`	Określa, czy `File` został oznaczony 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 podaną nazwę.
`makeCopy(name, destination)`	`File`	Tworzy kopię pliku w katalogu docelowym i nadaje jej podaną nazwę.
`moveTo(destination)`	`File`	Przenosi ten element do podanego folderu docelowego.
`removeCommenter(emailAddress)`	`File`	Usuwa danego użytkownika z listy komentujących `File`.
`removeCommenter(user)`	`File`	Usuwa danego użytkownika z listy komentujących `File`.
`removeEditor(emailAddress)`	`File`	Usuwa danego użytkownika z listy osób edytujących `File`.
`removeEditor(user)`	`File`	Usuwa danego użytkownika z listy osób edytujących `File`.
`removeViewer(emailAddress)`	`File`	Usuwa danego użytkownika z listy przeglądających i komentujących `File`.
`removeViewer(user)`	`File`	Usuwa danego użytkownika z listy przeglądających i komentujących `File`.
`revokePermissions(emailAddress)`	`File`	Unieważnia dostęp do `File` przyznany danemu użytkownikowi.
`revokePermissions(user)`	`File`	Unieważnia dostęp do `File` przyznany danemu użytkownikowi.
`setContent(content)`	`File`	Zastępuje zawartość pliku podanym tekstem.
`setDescription(description)`	`File`	Ustawia opis elementu `File`.
`setName(name)`	`File`	Ustawia nazwę elementu `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 do uzyskania dostępu, gdy jest udostępniany za pomocą 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óra klasa użytkowników może uzyskać dostęp do `File` i jakie uprawnienia są im przyznawane, oprócz uprawnień przyznanych poszczególnym użytkownikom.
`setStarred(starred)`	`File`	Określa, czy `File` jest oznaczony 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órego można użyć do wznowienia tej iteracji w późniejszym czasie.
`hasNext()`	`Boolean`	Określa, czy wywołanie funkcji `next()` zwróci element.
`next()`	`File`	Pobiera następny element w kolekcji plików lub folderów.

`Folder`

Metody

Metoda	Zwracany typ	Krótki opis
`addEditor(emailAddress)`	`Folder`	Dodaje podanego użytkownika do listy edytujących `Folder`.
`addEditor(user)`	`Folder`	Dodaje podanego użytkownika do listy edytujących `Folder`.
`addEditors(emailAddresses)`	`Folder`	Dodaje podaną tablicę użytkowników do listy edytujących `Folder`.
`addViewer(emailAddress)`	`Folder`	Dodaje podanego użytkownika do listy osób, które mogą wyświetlać `Folder`.
`addViewer(user)`	`Folder`	Dodaje podanego użytkownika do listy osób, które mogą wyświetlać `Folder`.
`addViewers(emailAddresses)`	`Folder`	Dodaje podaną tablicę użytkowników do listy widzów `Folder`.
`createFile(blob)`	`File`	Tworzy w bieżącym folderze plik z podanym `Blob` dowolnych danych.
`createFile(name, content)`	`File`	Tworzy w bieżącym folderze plik tekstowy o podanej nazwie i zawartości.
`createFile(name, content, mimeType)`	`File`	Tworzy w bieżącym folderze plik o podanej nazwie, zawartości i typie MIME.
`createFolder(name)`	`Folder`	Tworzy w bieżącym folderze folder o podanej nazwie.
`createShortcut(targetId)`	`File`	Tworzy skrót do podanego identyfikatora elementu na Dysku i zwraca go.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Tworzy skrót do podanego identyfikatora elementu na Dysku i klucza zasobu, a następnie go zwraca.
`getAccess(email)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getAccess(user)`	`Permission`	Pobiera uprawnienia przyznane konkretnemu użytkownikowi.
`getDateCreated()`	`Date`	Pobiera datę utworzenia `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ą elementami podrzędnymi bieżącego folderu.
`getFilesByName(name)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu i mają podaną nazwę.
`getFilesByType(mimeType)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu i mają podany typ MIME.
`getFolders()`	`FolderIterator`	Pobiera kolekcję wszystkich folderów podrzędnych względem bieżącego folderu.
`getFoldersByName(name)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów podrzędnych względem bieżącego folderu, które mają podaną nazwę.
`getId()`	`String`	Pobiera identyfikator `Folder`.
`getLastUpdated()`	`Date`	Pobiera datę ostatniej aktualizacji `Folder`.
`getName()`	`String`	Pobiera nazwę `Folder`.
`getOwner()`	`User`	Pobiera właściciela tego zasobu `Folder`.
`getParents()`	`FolderIterator`	Pobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnymi elementu `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 ten `Folder` może zastosować aktualizację zabezpieczeń, która wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku.
`getSecurityUpdateEnabled()`	`Boolean`	Określa, czy ten `Folder` wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku.
`getSharingAccess()`	`Access`	Określa, która grupa użytkowników może uzyskać dostęp do `Folder`, oprócz użytkowników, którym wyraźnie przyznano dostęp.
`getSharingPermission()`	`Permission`	Pobiera uprawnienia przyznane użytkownikom, którzy mają dostęp do `Folder`, oprócz użytkowników, którym wyraźnie przyznano dostęp.
`getSize()`	`Integer`	Pobiera liczbę bajtów używanych do przechowywania `Folder` na Dysku.
`getUrl()`	`String`	Pobiera adres URL, którego można użyć do otwarcia `Folder` w aplikacji Google, takiej jak Dysk lub Dokumenty.
`getViewers()`	`User[]`	Pobiera listę przeglądających i komentujących dla tego `Folder`.
`isShareableByEditors()`	`Boolean`	Określa, czy użytkownicy z uprawnieniami do edycji `Folder` mogą udostępniać je innym użytkownikom lub zmieniać uprawnienia.
`isStarred()`	`Boolean`	Określa, czy `Folder` został oznaczony 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`	Usuwa danego użytkownika z listy osób edytujących `Folder`.
`removeEditor(user)`	`Folder`	Usuwa danego użytkownika z listy osób edytujących `Folder`.
`removeViewer(emailAddress)`	`Folder`	Usuwa danego użytkownika z listy przeglądających i komentujących `Folder`.
`removeViewer(user)`	`Folder`	Usuwa danego użytkownika z listy przeglądających i komentujących `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Unieważnia dostęp do `Folder` przyznany danemu użytkownikowi.
`revokePermissions(user)`	`Folder`	Unieważnia dostęp do `Folder` przyznany danemu użytkownikowi.
`searchFiles(params)`	`FileIterator`	Pobiera kolekcję wszystkich plików, które są elementami podrzędnymi bieżącego folderu i spełniają podane kryteria wyszukiwania.
`searchFolders(params)`	`FolderIterator`	Pobiera kolekcję wszystkich folderów, które są elementami podrzędnymi bieżącego folderu i spełniają podane kryteria wyszukiwania.
`setDescription(description)`	`Folder`	Ustawia opis elementu `Folder`.
`setName(name)`	`Folder`	Ustawia nazwę elementu `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 do uzyskania dostępu, gdy jest udostępniany za pomocą 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óra klasa użytkowników może uzyskać dostęp do `Folder` i jakie uprawnienia są im przyznawane, oprócz uprawnień przyznanych poszczególnym użytkownikom.
`setStarred(starred)`	`Folder`	Określa, czy `Folder` jest oznaczony 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órego można użyć do wznowienia tej iteracji w późniejszym czasie.
`hasNext()`	`Boolean`	Określa, czy wywołanie funkcji `next()` zwróci element.
`next()`	`Folder`	Pobiera następny element w 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świetlić lub skopiować.
`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ć, przenosić do kosza 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\|null`	Pobiera nazwę domeny powiązaną z kontem użytkownika.
`getEmail()`	`String\|null`	Pobiera adres e-mail użytkownika.
`getName()`	`String\|null`	Pobiera nazwę użytkownika.
`getPhotoUrl()`	`String\|null`	Pobiera adres URL zdjęcia użytkownika.

Drive Service Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Zajęcia

Właściwości

Właściwości

Metody

Metody

Metody

Metody

Metody

Właściwości

Metody

Drive Service