Class File

Plik

Plik na Dysku Google. Pliki można otwierać i tworzyć w DriveApp.

// Trash every untitled spreadsheet that hasn't been updated in a week.
var files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  var file = files.next();
  if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) {
    file.setTrashed(true);
  }
}

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.

Szczegółowa dokumentacja

addCommenter(emailAddress)

Dodaj danego użytkownika do listy komentujących w polu File. Jeśli użytkownik był już na liście widzów, ta metoda przenosi go z listy widzów.

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz dodać.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

addCommenter(user)

Dodaj danego użytkownika do listy komentujących w polu File. Jeśli użytkownik był już na liście widzów, ta metoda przenosi go z listy widzów.

Parametry

NazwaTypOpis
userUserWskazanie użytkownika do dodania.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

addCommenters(emailAddresses)

Dodaj podany zestaw użytkowników do listy komentujących w polu File. Jeśli któryś z użytkowników znalazł się już na liście widzów, ta metoda spowoduje przeniesienie ich z listy widzów.

Parametry

NazwaTypOpis
emailAddressesString[]Tablica adresów e-mail użytkowników, których chcesz dodać.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

addEditor(emailAddress)

Dodaje danego użytkownika do listy edytorów File. Jeśli użytkownik był już na liście, ta metoda spowoduje, że zniknie on z listy widzów.

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz dodać.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

addEditor(user)

Dodaje danego użytkownika do listy edytorów File. Jeśli użytkownik był już na liście, ta metoda spowoduje, że zniknie on z listy widzów.

Parametry

NazwaTypOpis
userUserWskazanie użytkownika do dodania.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

addEditors(emailAddresses)

Dodaje daną tablicę użytkowników do listy edytorów File. Jeśli któryś z użytkowników znalazł się już na liście widzów, ta metoda spowoduje wykluczenie go z listy widzów.

Parametry

NazwaTypOpis
emailAddressesString[]Tablica adresów e-mail użytkowników, których chcesz dodać.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

addViewer(emailAddress)

Dodaje danego użytkownika do listy widzów na liście File. Jeśli użytkownik był już na liście edytorów, ta metoda nie jest brana pod uwagę.

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz dodać.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

addViewer(user)

Dodaje danego użytkownika do listy widzów na liście File. Jeśli użytkownik był już na liście edytorów, ta metoda nie jest brana pod uwagę.

Parametry

NazwaTypOpis
userUserWskazanie użytkownika do dodania.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

addViewers(emailAddresses)

Dodaje daną tablicę użytkowników do listy przeglądających File. Jeśli któryś z użytkowników znalazł się już na liście edytorów, ta metoda nie będzie miała dla niego zastosowania.

Parametry

NazwaTypOpis
emailAddressesString[]Tablica adresów e-mail użytkowników, których chcesz dodać.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

getAccess(email)

Pobiera uprawnienia przyznane danemu użytkownikowi.

Parametry

NazwaTypOpis
emailStringadres e-mail użytkownika, którego uprawnienia należy sprawdzić;

Zwróć

Permission – uprawnienia przyznane użytkownikowi,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getAccess(user)

Pobiera uprawnienia przyznane danemu użytkownikowi.

Parametry

NazwaTypOpis
userUserreprezentacja użytkownika, którego uprawnienia należy sprawdzić;

Zwróć

Permission – uprawnienia przyznane użytkownikowi,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getAs(contentType)

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „"myfile.pdf&quot”. Zakładamy jednak, że część nazwy pliku po ostatnim okresie (jeśli w ogóle) jest rozszerzeniem, które należy zastąpić. W związku z tym "ShoppingList.12.25.2014" zmienia się w "ShoppingList.12.25.pdf".

Aby sprawdzić dzienne limity konwersji, zobacz Limity usług Google. Nowo utworzone domeny Google Workspace mogą podlegać tymczasowym ograniczeniom.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowane. W większości blobów 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowy jest też każdy z tych formatów: 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'.

Zwróć

Blob – dane jako obiekt blob.


getBlob()

Zwraca dane wewnątrz tego obiektu jako blob.

Zwróć

Blob – dane jako obiekt blob.


getDateCreated()

Pobiera datę utworzenia File.

Zwróć

Date – data utworzenia File,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDescription()

Pobiera opis File.

Zwróć

String – opis elementu File

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDownloadUrl()

Pobiera adres URL, którego można użyć do pobrania pliku. Dostęp do adresu URL mają tylko użytkownicy z uprawnieniami do otwierania pliku na Dysku Google. Możesz pobrać ten adres URL w przeglądarce, ale nie możesz użyć UrlFetchApp. Jeśli chcesz umieścić zawartość pliku w skrypcie, użyj kodu getBlob().

Zwróć

String – adres URL, z którego można pobrać plik.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getEditors()

Pobiera listę edytorów File. Jeśli użytkownik, który wykonuje skrypt, nie ma uprawnień do edycji elementu File, ta metoda zwraca pustą tablicę.

Zwróć

User[] – tablica użytkowników z uprawnieniami do edycji.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getId()

Pobiera identyfikator File.

Zwróć

String – identyfikator elementu File;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getLastUpdated()

Pobiera datę ostatniej aktualizacji zdarzenia File.

Zwróć

Date – data ostatniej aktualizacji wartości File;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getMimeType()

Pobiera typ MIME pliku.

Zwróć

String – typ MIME pliku.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getName()

Pobiera nazwę File.

Zwróć

String – nazwa zasobu File.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getOwner()

Pobiera właściciela elementu File.

Zwróć

User – obiekt User reprezentujący właściciela,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getParents()

Pobiera zbiór folderów, które są bezpośrednio elementami nadrzędnymi elementu File.

Zwróć

FolderIterator – zbiór folderów, które są bezpośrednimi elementami nadrzędnymi folderu File

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getResourceKey()

Pobiera klucz zasobu File, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.

Zwróć

String – klucz zasobu File,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEligible()

Określa, czy File może stosować aktualizację zabezpieczeń, która wymaga dostępu do zasobu za pomocą linku.

Dostęp do niektórych plików lub folderów, które zostały udostępnione przy użyciu linku, wymaga klucza zasobu. Ta zmiana jest częścią aktualizacji zabezpieczeń. Aktualizacja jest domyślnie włączona dla kwalifikujących się plików i folderów. Aby włączyć lub wyłączyć wymaganie klucza zasobu w przypadku odpowiednich plików, użyj setSecurityUpdateEnabled.

Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.

Zwróć

Boolean – określa, czy dla zasobu File można zastosować wymóg dotyczący klucza zasobu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEnabled()

Pobiera, czy File wymaga klucza dostępu do zasobu, gdy jest udostępniany za pomocą linku. To wymaganie jest domyślnie włączone dla kwalifikujących się plików i folderów. Aby włączyć lub wyłączyć wymaganie użycia klucza zasobu w przypadku odpowiednich plików, użyj polecenia setSecurityUpdateEnabled.

Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.

Zwróć

Boolean – określa, czy dla tego zasobu (File) wymagany jest klucz klucza.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingAccess()

Pobiera klasę użytkowników, którzy mają mieć dostęp do File, oprócz poszczególnych użytkowników, którym przyznano dostęp.

Zwróć

Access – liczba użytkowników, którzy mają dostęp do File;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingPermission()

Pobiera uprawnienia do tych użytkowników, którzy mają dostęp do File, oprócz tych, którzy otrzymali dostęp jawnie.

Zwróć

Permission – uprawnienia przyznane użytkownikom, którzy mogą mieć dostęp do File.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSize()

Pobiera liczbę bajtów używanych do przechowywania elementu File na Dysku. Pliki aplikacji Google Workspace nie wliczają się do limitu miejsca na Dysku, więc nie zwracają 0 bajtów.

Zwróć

Integer – liczba bajtów używanych do przechowywania elementu File na Dysku.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getTargetId()

Jeśli jest to skrót, zwraca identyfikator elementu, do którego prowadzi.

W przeciwnym razie zwraca wartość null.

Zwróć

String – identyfikator elementu docelowego;


getTargetMimeType()

Jeśli jest to skrót, zwraca typ MIME elementu, do którego prowadzi.

W przeciwnym razie zwraca wartość null.

Zwróć

String – typ MIME elementu docelowego.


getTargetResourceKey()

Jeśli plik jest skrótem, zwraca klucz zasobu elementu, do którego się on odnosi. Klucze zasobów to dodatkowy parametr, który należy przekazać do plików udostępnionych za pomocą linku.

Jeśli plik nie jest skrótem, zwraca wartość null.

Zwróć

String – klucz zasobu elementu docelowego lub null, jeśli plik nie jest skrótem.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getThumbnail()

Pobiera miniaturę pliku lub null, jeśli nie ma miniatury.

Zwróć

Blob – miniatura pliku.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getUrl()

Pobiera adres URL, którego można użyć do otwarcia elementu File w aplikacji Google, takiej jak Dysk czy Dokumenty.

Zwróć

String – adres URL, którego możesz używać do wyświetlania tego elementu File w aplikacji Google takiej jak Dysk czy Dokumenty.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getViewers()

Pobiera listę widzów i komentujących w przypadku: File. Jeśli użytkownik, który wykonał skrypt, nie ma uprawnień do edycji elementu File, ta metoda zwraca pustą tablicę.

Zwróć

User[] – tablica użytkowników z uprawnieniami do wyświetlania lub komentowania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isShareableByEditors()

Określa, czy użytkownicy z uprawnieniami do edycji elementu File mogą udostępniać go innym użytkownikom lub zmieniać uprawnienia.

Zwróć

Booleantrue, jeśli użytkownicy z uprawnieniami do edycji mogą udostępniać dane innym użytkownikom lub zmieniać uprawnienia – false, jeśli nie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isStarred()

Określa, czy element File został oznaczony gwiazdką na Dysku użytkownika.

Zwróć

Booleantrue, jeśli File jest oznaczony gwiazdką na Dysku użytkownika; false – jeśli nie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isTrashed()

Określa, czy File znajduje się w koszu na Dysku użytkownika.

Zwróć

Booleantrue, jeśli File jest w koszu użytkownika i false, jeśli nie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

makeCopy()

Tworzy kopię pliku.

Zwróć

File – nowa kopia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

makeCopy(destination)

Tworzy kopię pliku w katalogu docelowym.

Parametry

NazwaTypOpis
destinationFolderKatalog, do którego chcesz skopiować plik.

Zwróć

File – nowa kopia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

makeCopy(name)

Tworzy kopię pliku i nadaje mu nazwę.

Parametry

NazwaTypOpis
nameStringNazwa pliku, który ma zostać zastosowany do nowej kopii.

Zwróć

File – nowa kopia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

makeCopy(name, destination)

Tworzy kopię pliku w katalogu docelowym i nadaje mu nazwę.

Parametry

NazwaTypOpis
nameStringNazwa pliku, który ma zostać zastosowany do nowej kopii.
destinationFolderKatalog, do którego chcesz skopiować plik.

Zwróć

File – nowa kopia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

moveTo(destination)

Przenosi ten element do podanego folderu docelowego.

Aby można było przenieść element do folderu docelowego, obecny użytkownik musi być właścicielem pliku lub mieć uprawnienia do edycji bieżącego folderu nadrzędnego.

Parametry

NazwaTypOpis
destinationFolderFolder, który staje się nowym elementem nadrzędnym.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

removeCommenter(emailAddress)

Usuwa tego użytkownika z listy komentujących File. Ta metoda nie blokuje użytkownikom dostępu do jednostki organizacyjnej File, jeśli należą one do grupy użytkowników, którzy mają ogólny dostęp – na przykład gdy File jest udostępniony całej domenie.

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz usunąć.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

removeCommenter(user)

Usuwa tego użytkownika z listy komentujących File. Ta metoda nie blokuje użytkownikom dostępu do jednostki organizacyjnej File, jeśli należą one do grupy użytkowników, którzy mają ogólny dostęp – na przykład gdy File jest udostępniony całej domenie.

Parametry

NazwaTypOpis
userUserPrezentacja użytkownika do usunięcia.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

removeEditor(emailAddress)

Danego użytkownika nie ma na liście edytorów File. Ta metoda nie blokuje użytkownikom dostępu do jednostki organizacyjnej File, jeśli należą one do grupy użytkowników, którzy mają dostęp ogólny – na przykład gdy File jest udostępniony całej domenie użytkownika lub jeśli File jest na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików z Dysku ten użytkownik zostanie też usunięty z listy przeglądających.

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz usunąć.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

removeEditor(user)

Danego użytkownika nie ma na liście edytorów File. Ta metoda nie blokuje użytkownikom dostępu do jednostki organizacyjnej File, jeśli należą one do grupy użytkowników, którzy mają dostęp ogólny – na przykład gdy File jest udostępniony całej domenie użytkownika lub jeśli File jest na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików z Dysku ten użytkownik zostanie też usunięty z listy przeglądających.

Parametry

NazwaTypOpis
userUserPrezentacja użytkownika do usunięcia.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

removeViewer(emailAddress)

Usunięcie określonego użytkownika z listy widzów i komentujących mających miejsce w domenie File. Ta metoda nie działa, jeśli użytkownik jest edytorem, a nie przeglądającym lub komentującym. Ta metoda nie blokuje też dostępu do elementu File, jeśli należą oni do grupy użytkowników, którzy mają dostęp ogólny – na przykład gdy File jest udostępniony całej domenie użytkownika lub jeśli File znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku ta osoba zostanie też usunięta z listy edytorów.

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz usunąć.

Zwróć

File – ten File do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

removeViewer(user)

Usunięcie określonego użytkownika z listy widzów i komentujących mających miejsce w domenie File. Ta metoda nie działa, jeśli użytkownik jest edytorem, a nie przeglądającym. Ta metoda nie blokuje też dostępu do elementu File, jeśli należą oni do grupy użytkowników, którzy mają dostęp ogólny. Na przykład jeśli File jest udostępniony całej domenie użytkownika lub jeśli File jest na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku ta osoba zostanie też usunięta z listy edytorów.

Parametry

NazwaTypOpis
userUserPrezentacja użytkownika do usunięcia.

Zwróć

File – ten File do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

revokePermissions(user)

Unieważnia dostęp aplikacji File przyznanej użytkownikowi. Ta metoda nie blokuje użytkownikom dostępu do jednostki organizacyjnej File, jeśli należą one do grupy użytkowników, którzy mają ogólny dostęp – na przykład gdy File jest udostępniony całej domenie.

Parametry

NazwaTypOpis
userStringadres e-mail użytkownika, któremu chcesz anulować dostęp.

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

revokePermissions(user)

Unieważnia dostęp aplikacji File przyznanej użytkownikowi. Ta metoda nie blokuje użytkownikom dostępu do jednostki organizacyjnej File, jeśli należą one do grupy użytkowników, którzy mają ogólny dostęp – na przykład gdy File jest udostępniony całej domenie.

Parametry

NazwaTypOpis
userUserprzedstawienie użytkownika, którego dostęp powinien zostać unieważniony;

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setContent(content)

Zastępuje zawartość pliku konkretną zamianą. Zwraca wyjątek, jeśli rozmiar pliku content jest większy niż 10 MB.

Parametry

NazwaTypOpis
contentStringNowa zawartość pliku.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setDescription(description)

Ustawia opis File.

Parametry

NazwaTypOpis
descriptionStringNowy opis: File

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setName(name)

Ustawia nazwę tagu File.

Parametry

NazwaTypOpis
nameStringNowa nazwa modułu: File

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setOwner(emailAddress)

Zmienia właściciela elementu File. Ta metoda przyznaje też poprzedniemu właścicielowi uprawnienia do edycji elementu File.

Parametry

NazwaTypOpis
emailAddressStringadres e-mail użytkownika, który powinien zostać nowym właścicielem;

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setOwner(user)

Zmienia właściciela elementu File. Ta metoda przyznaje też poprzedniemu właścicielowi uprawnienia do edycji elementu File.

Parametry

NazwaTypOpis
userUserreprezentacja użytkownika, która powinna zostać nowym właścicielem;

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setSecurityUpdateEnabled(enabled)

Określa, czy File wymaga dostępu do klucza po udostępnieniu linku za pomocą linku. Odpowiednie pliki i foldery są domyślnie włączone.

Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.

Parametry

NazwaTypOpis
enabledBooleanOkreśla, czy włączyć wymóg klucza klucza dla zasobu File.

Zwróć

FileFile do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setShareableByEditors(shareable)

Określa, czy użytkownicy z uprawnieniami do edycji File mogą udostępniać je innym użytkownikom lub zmieniać uprawnienia. Domyślnie nowy identyfikator File to true.

Parametry

NazwaTypOpis
shareableBooleantrue, jeśli użytkownicy z uprawnieniami do edycji powinni mieć możliwość udostępniania innym użytkownikom lub zmieniania uprawnień. Jeśli nie, false

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setSharing(accessType, permissionType)

Okreś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.

// Creates a folder that anyone on the Internet can read from and write to. (Domain
// administrators can prohibit this setting for users of a Google Workspace domain.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametry

NazwaTypOpis
accessTypeAccessktóra klasa użytkowników powinna mieć dostęp do File;
permissionTypePermissionuprawnieniami, które powinny być dostępne dla użytkowników z dostępem do: File

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setStarred(starred)

Określa, czy element File jest oznaczony gwiazdką na Dysku użytkownika. Wartością domyślną w nowych File jest false.

Parametry

NazwaTypOpis
starredBooleantrue, jeśli File ma być oznaczony gwiazdką na Dysku użytkownika. Jeśli nie, false

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive

setTrashed(trashed)

Określa, czy File znajduje się w koszu na Dysku użytkownika. Tylko właściciel może przenieść do kosza plik File. Domyślnie nowe elementy (File) mają wartość false.

Parametry

NazwaTypOpis
trashedBooleantrue jeśli File ma zostać przeniesione do kosza na Dysku użytkownika; false jeśli nie

Zwróć

File – ten File do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/drive