plik na Dysku Google, Dostęp do plików można uzyskać lub utworzyć je w panelu Drive.
// Trash every untitled spreadsheet that hasn't been updated in a week. const files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { const file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
add | File | Dodaj podanego użytkownika do listy komentujących File. |
add | File | Dodaj podanego użytkownika do listy komentujących File. |
add | File | Dodaj podaną tablicę użytkowników do listy komentujących w przypadku elementu File. |
add | File | Dodaje podanego użytkownika do listy edytujących File. |
add | File | Dodaje podanego użytkownika do listy edytujących File. |
add | File | Dodaje podaną tablicę użytkowników do listy edytujących File. |
add | File | Dodaje podanego użytkownika do listy osób, które mogą wyświetlać File. |
add | File | Dodaje podanego użytkownika do listy osób, które mogą wyświetlać File. |
add | File | Dodaje podaną tablicę użytkowników do listy widzów File. |
get | Permission | Pobiera uprawnienia przyznane konkretnemu użytkownikowi. |
get | Permission | Pobiera uprawnienia przyznane konkretnemu użytkownikowi. |
get | Blob | Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści. |
get | Blob | Zwraca dane w tym obiekcie jako obiekt blob. |
get | Date | Pobiera datę utworzenia File. |
get | String | Pobiera opis elementu File. |
get | String | Pobiera adres URL, który można wykorzystać do pobrania pliku. |
get | User[] | Pobiera listę edytorów tego File. |
get | String | Pobiera identyfikator File. |
get | Date | Pobiera datę ostatniej aktualizacji File. |
get | String | Pobiera typ MIME pliku. |
get | String | Pobiera nazwę File. |
get | User | Pobiera właściciela pliku. |
get | Folder | Pobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnymi elementu File. |
get | String | Pobiera klucz zasobu File, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku. |
get | 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. |
get | Boolean | Określa, czy ten File wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku. |
get | 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. |
get | 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. |
get | Integer | Pobiera liczbę bajtów używanych do przechowywania File na Dysku. |
get | String | Jeśli jest to skrót, zwraca identyfikator elementu, do którego prowadzi. |
get | String | Jeśli jest to skrót, zwraca typ MIME elementu, do którego prowadzi. |
get | String | Jeśli plik jest skrótem, zwraca klucz zasobu elementu, do którego prowadzi. |
get | Blob|null | Pobiera miniaturę pliku lub null, jeśli miniatura nie istnieje. |
get | String | Pobiera adres URL, którego można użyć do otwarcia File w aplikacji Google, takiej jak Dysk lub Dokumenty. |
get | User[] | Pobiera listę przeglądających i komentujących dla tego File. |
is | Boolean | Określa, czy użytkownicy z uprawnieniami do edycji File mogą udostępniać je innym użytkownikom lub zmieniać uprawnienia. |
is | Boolean | Określa, czy File został oznaczony gwiazdką na Dysku użytkownika. |
is | Boolean | Określa, czy File znajduje się w koszu na Dysku użytkownika. |
make | File | Tworzy kopię pliku. |
make | File | Tworzy kopię pliku w katalogu docelowym. |
make | File | Tworzy kopię pliku i nadaje jej podaną nazwę. |
make | File | Tworzy kopię pliku w katalogu docelowym i nadaje jej podaną nazwę. |
move | File | Przenosi ten element do podanego folderu docelowego. |
remove | File | Usuwa danego użytkownika z listy komentujących File. |
remove | File | Usuwa danego użytkownika z listy komentujących File. |
remove | File | Usuwa danego użytkownika z listy osób edytujących File. |
remove | File | Usuwa danego użytkownika z listy osób edytujących File. |
remove | File | Usuwa danego użytkownika z listy przeglądających i komentujących File. |
remove | File | Usuwa danego użytkownika z listy przeglądających i komentujących File. |
revoke | File | Unieważnia dostęp do File przyznany danemu użytkownikowi. |
revoke | File | Unieważnia dostęp do File przyznany danemu użytkownikowi. |
set | File | Zastępuje zawartość pliku podanym tekstem. |
set | File | Ustawia opis elementu File. |
set | File | Ustawia nazwę elementu File. |
set | File | Zmienia właściciela File. |
set | File | Zmienia właściciela File. |
set | File | Określa, czy File wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku. |
set | File | Określa, czy użytkownicy z uprawnieniami do edycji File mogą udostępniać pliki innym użytkownikom lub zmieniać uprawnienia. |
set | 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. |
set | File | Określa, czy File jest oznaczony gwiazdką na Dysku użytkownika. |
set | File | Określa, czy File znajduje się w koszu na Dysku użytkownika. |
Szczegółowa dokumentacja
add Commenter(emailAddress)
Dodaj podanego użytkownika do listy komentujących File. Jeśli użytkownik był już na liście widzów, ta metoda usuwa go z tej listy.
const files = DriveApp.getFilesByName('Test'); // Loops through the files while (files.hasNext()) { const file = files.next(); file.addCommenter('hello@example.com'); }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powrót
File – ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
add Commenter(user)
Dodaj podanego użytkownika do listy komentujących File. Jeśli użytkownik był już na liście widzów, ta metoda usuwa go z tej listy.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Adds the active user as a commenter. while (files.hasNext()) { const file = files.next(); file.addCommenter(Session.getActiveUser()); }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
user | User | Reprezentacja użytkownika, którego chcesz dodać. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
add Commenters(emailAddresses)
Dodaj podaną tablicę użytkowników do listy komentujących w przypadku elementu File. Jeśli którykolwiek z użytkowników był już na liście widzów, ta metoda usuwa go z tej listy.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); while (files.hasNext()) { const file = files.next(); // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and // 'baklavainthebalkans@gmail.com' with the email addresses to add as // commenters. const emails = [ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]; console.log(file.addCommenters(emails)); }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String[] | Tablica adresów e-mail użytkowników, których chcesz dodać. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
add Editor(emailAddress)
Dodaje podanego użytkownika do listy edytujących File. Jeśli użytkownik był już na liście widzów, ta metoda usuwa go z tej listy.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
add Editor(user)
Dodaje podanego użytkownika do listy edytujących File. Jeśli użytkownik był już na liście widzów, ta metoda usuwa go z tej listy.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
user | User | Reprezentacja użytkownika, którego chcesz dodać. |
Powrót
File – ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
add Editors(emailAddresses)
Dodaje podaną tablicę użytkowników do listy edytujących File. Jeśli któryś z użytkowników był już na liście widzów, ta metoda usuwa go z tej listy.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String[] | Tablica adresów e-mail użytkowników, których chcesz dodać. |
Powrót
File – ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
add Viewer(emailAddress)
Dodaje podanego użytkownika do listy osób, które mogą wyświetlać File. Jeśli użytkownik był już na liście edytujących, ta metoda nie ma wpływu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
add Viewer(user)
Dodaje podanego użytkownika do listy osób, które mogą wyświetlać File. Jeśli użytkownik był już na liście edytujących, ta metoda nie ma wpływu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
user | User | Reprezentacja użytkownika, którego chcesz dodać. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
add Viewers(emailAddresses)
Dodaje podaną tablicę użytkowników do listy widzów File. Jeśli któryś z użytkowników był już na liście edytujących, ta metoda nie będzie miała na niego wpływu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String[] | Tablica adresów e-mail użytkowników, których chcesz dodać. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
get Access(email)
Pobiera uprawnienia przyznane konkretnemu użytkownikowi. Ta metoda nie obsługuje zwracania uprawnień dla grupy dyskusyjnej Google ani uprawnień dziedziczonych przez grupy dyskusyjne Google.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String | Adres e-mail użytkownika, którego uprawnienia mają zostać sprawdzone. Grupy dyskusyjne Google nie są obsługiwane. |
Powrót
Permission – uprawnienia przyznane użytkownikowi.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Access(user)
Pobiera uprawnienia przyznane konkretnemu użytkownikowi. Ta metoda nie obsługuje zwracania uprawnień dla grupy dyskusyjnej Google ani uprawnień dziedziczonych przez grupy dyskusyjne Google.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
user | User | Reprezentacja użytkownika, którego uprawnienia mają zostać sprawdzone. |
Powrót
Permission – uprawnienia przyznane użytkownikowi.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get As(contentType)
Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, np. „mójplik.pdf”. Zakłada jednak, że część nazwy pliku, która następuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W konsekwencji nazwa „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.
Aby wyświetlić dzienne limity konwersji, zapoznaj się z artykułem Limity usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
content | String | Typ MIME, na który ma zostać przekonwertowany plik. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf'. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są też znaki 'image/bmp', 'image/gif', 'image/jpeg' i 'image/png'. W przypadku dokumentu Google 'text/markdown' jest również prawidłowy. |
Powrót
Blob – dane w formie obiektu blob.
get Blob()
get Date Created()
get Description()
get Download Url()
Pobiera adres URL, który można wykorzystać do pobrania pliku. Dostęp do adresu URL mają tylko użytkownicy, którzy mają uprawnienia do otwierania pliku na Dysku Google. Możesz użyć tego adresu URL w przeglądarce, aby pobrać plik, ale nie możesz go użyć do pobrania pliku za pomocą Url. Jeśli chcesz, aby w skrypcie znalazła się zawartość pliku, użyj get.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the download URLs to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getDownloadUrl()); }
Powrót
String – adres URL, za pomocą którego można pobrać plik.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Editors()
Pobiera listę edytorów tego File. Jeśli użytkownik, który wykonuje skrypt, nie ma uprawnień do edytowania File, ta metoda zwraca pustą tablicę.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Adds the email addresses in the array as editors of each file. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' // and 'baklavainthebalkans@gmail.com' with valid email addresses. file.addEditors([ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]); // Gets a list of the file editors. const editors = file.getEditors(); // For each file, logs the editors' email addresses to the console. for (const editor of editors) { console.log(editor.getEmail()); } }
Powrót
User[] – jeśli użytkownik ma uprawnienia do edytowania tego File, zwraca listę edytujących. Jeśli użytkownik nie ma uprawnień do edycji, zwraca pustą tablicę.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Id()
get Last Updated()
get Mime Type()
Pobiera typ MIME pliku.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the MIME type to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getMimeType()); }
Powrót
String – typ MIME pliku.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Name()
get Owner()
Pobiera właściciela pliku.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the names of the file owners to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getOwner().getName()); }
Powrót
User – właściciel pliku.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Parents()
Pobiera kolekcję folderów, które są bezpośrednimi elementami nadrzędnymi elementu File.
Powrót
Folder – zbiór folderów, które są bezpośrednimi folderami nadrzędnymi elementu File.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Resource Key()
Pobiera klucz zasobu File, który jest wymagany do uzyskania dostępu do elementów udostępnionych za pomocą linku.
Powrót
String – klucz zasobu File.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Security Update Eligible()
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.
Dysk wymaga klucza zasobu, aby uzyskać dostęp do niektórych plików lub folderów udostępnionych za pomocą linku. Ta zmiana jest częścią aktualizacji zabezpieczeń. Aktualizacja jest domyślnie włączona w przypadku kwalifikujących się plików i folderów. Aby włączyć lub wyłączyć wymaganie klucza zasobu w przypadku kwalifikujących się plików, użyj
set.
Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.
Powrót
Boolean – czy wymaganie dotyczące klucza zasobu można zastosować w przypadku File.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Security Update Enabled()
Określa, czy ten File wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku. To wymaganie jest domyślnie włączone w przypadku kwalifikujących się plików i folderów.
Aby włączyć lub wyłączyć wymaganie klucza zasobu w przypadku kwalifikujących się plików, użyj ikony
setSecurityUpdateEnabled.
Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.
Powrót
Boolean – czy wymaganie dotyczące klucza zasobu jest włączone w przypadku tego File.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Sharing 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.
Powrót
Access – która grupa użytkowników może uzyskać dostęp do File
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Sharing 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.
Powrót
Permission – uprawnienia przyznane użytkownikom, którzy mają dostęp do File
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Size()
Pobiera liczbę bajtów używanych do przechowywania File na Dysku. Pamiętaj, że pliki aplikacji Google Workspace nie są wliczane do limitu miejsca na Dysku, dlatego zwracają 0 bajtów.
Powrót
Integer – liczba bajtów użytych do przechowywania File na Dysku.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Target Id()
Jeśli jest to skrót, zwraca identyfikator elementu, do którego prowadzi.
W przeciwnym razie zwraca wartość null.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the target ID of the shortcut. console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);
Powrót
String – identyfikator produktu docelowego.
get Target Mime Type()
Jeśli jest to skrót, zwraca typ MIME elementu, do którego prowadzi.
W przeciwnym razie zwraca wartość null.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
Powrót
String – typ MIME elementu docelowego.
get Target Resource Key()
Jeśli plik jest skrótem, zwraca klucz zasobu elementu, do którego prowadzi. Klucz zasobu to dodatkowy parametr, który musisz przekazać, aby uzyskać dostęp do plików udostępnionych za pomocą linku.
Jeśli plik nie jest skrótem, zwraca wartość null.
// Gets a file by its ID. // TODO(developer): Replace 'abc123456' with your file ID. const file = DriveApp.getFileById('abc123456'); // If the file is a shortcut, returns the resource key of the file that it // points to. console.log(file.getTargetResourceKey());
Powrót
String – klucz zasobu elementu docelowego lub null, jeśli plik nie jest skrótem.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Thumbnail()
Pobiera miniaturę pliku lub null, jeśli miniatura nie istnieje.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Logs the thumbnail image for each file to the console as a blob, // or null if no thumbnail exists. console.log(file.getThumbnail()); }
Powrót
Blob|null – miniatura pliku.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Url()
Pobiera adres URL, którego można użyć do otwarcia File w aplikacji Google, takiej jak Dysk lub Dokumenty.
Powrót
String – adres URL, którego można użyć do wyświetlenia tego File w aplikacji Google, takiej jak Dysk lub Dokumenty.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Viewers()
Pobiera listę przeglądających i komentujących dla tego File. Jeśli użytkownik, który wykonuje skrypt, nie ma dostępu do edycji File, ta metoda zwraca pustą tablicę.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // For each file, logs the viewers' email addresses to the console. const viewers = file.getViewers(); for (const viewer of viewers) { console.log(viewer.getEmail()); } }
Powrót
User[] – jeśli użytkownik ma uprawnienia do edycji tego File, zwraca listę przeglądających i komentujących. Jeśli użytkownik nie ma uprawnień do edycji, zwraca pustą tablicę.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
is Starred()
Określa, czy File został oznaczony gwiazdką na Dysku użytkownika.
Powrót
Boolean – true, jeśli File jest oznaczony gwiazdką na Dysku użytkownika; false, jeśli nie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
is Trashed()
Określa, czy File znajduje się w koszu na Dysku użytkownika.
Powrót
Boolean – true, jeśli File znajduje się w koszu na Dysku użytkownika;false w przeciwnym razie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
make Copy()
Tworzy kopię pliku.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and logs the file name to the console. console.log(file.makeCopy().getName()); }
Powrót
File – nowy tekst.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
make Copy(destination)
Tworzy kopię pliku w katalogu docelowym.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and adds it to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy(destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
destination | Folder | Katalog, do którego chcesz skopiować plik. |
Powrót
File – nowy tekst.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
make Copy(name)
Tworzy kopię pliku i nadaje jej podaną nazwę.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and sets the name to 'Test-Copy.' const filename = file.makeCopy('Test-Copy'); // Logs the copied file's name to the console. console.log(filename.getName()); }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
name | String | Nazwa pliku, która ma zostać zastosowana do nowej kopii. |
Powrót
File – nowy tekst.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
make Copy(name, destination)
Tworzy kopię pliku w katalogu docelowym i nadaje jej podaną nazwę.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file, sets the file name, and adds the copied file // to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy('Test-Copy', destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
name | String | Nazwa pliku, która ma zostać zastosowana do nowej kopii. |
destination | Folder | Katalog, do którego chcesz skopiować plik. |
Powrót
File – nowy tekst.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
move To(destination)
Przenosi ten element do podanego folderu docelowego.
Aby przenieść element do folderu docelowego, bieżący użytkownik musi być właścicielem pliku lub mieć co najmniej uprawnienia do edycji bieżącego folderu nadrzędnego elementu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
destination | Folder | Folder, który stanie się nowym folderem nadrzędnym. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
remove Commenter(emailAddress)
Usuwa danego użytkownika z listy komentujących File. Ta metoda nie blokuje dostępu do File użytkownikom, którzy należą do klasy użytkowników mających ogólny dostęp, np. jeśli File jest udostępniony całej domenie użytkownika.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. // TODO(developer): Replace the email with the email of the user you want to // remove. file.removeCommenter('cloudysanfrancisco@gmail.com'); }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
remove Commenter(user)
Usuwa danego użytkownika z listy komentujących File. Ta metoda nie blokuje dostępu do File użytkownikom, którzy należą do klasy użytkowników mających ogólny dostęp, np. jeśli File jest udostępniony całej domenie użytkownika.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. console.log(file.removeCommenter(Session.getActiveUser())); }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
user | User | Reprezentacja użytkownika do usunięcia. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
remove Editor(emailAddress)
Usuwa danego użytkownika z listy osób edytujących File. Ta metoda nie blokuje użytkownikom dostępu do File, jeśli należą oni do klasy użytkowników, którzy mają ogólny dostęp, np. jeśli 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 spowoduje to również usunięcie użytkownika z listy osób, które mogą je wyświetlać.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powrót
File – ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
remove Editor(user)
Usuwa danego użytkownika z listy osób edytujących File. Ta metoda nie blokuje użytkownikom dostępu do File, jeśli należą oni do klasy użytkowników, którzy mają ogólny dostęp, np. jeśli 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 spowoduje to również usunięcie użytkownika z listy osób, które mogą je wyświetlać.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
user | User | Reprezentacja użytkownika do usunięcia. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
remove Viewer(emailAddress)
Usuwa danego użytkownika z listy przeglądających i komentujących File. Ta metoda nie ma wpływu, jeśli użytkownik jest edytującym, a nie przeglądającym lub komentującym. Ta metoda nie blokuje też dostępu do File użytkownikom, którzy należą do grupy użytkowników mających ogólny dostęp, np. jeśli 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 spowoduje to również usunięcie użytkownika z listy edytujących.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powrót
File – ten znak File służy do łączenia.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
remove Viewer(user)
Usuwa danego użytkownika z listy przeglądających i komentujących File. Ta metoda nie ma wpływu, jeśli użytkownik jest edytującym, a nie przeglądającym. Ta metoda nie blokuje też dostępu do File użytkownikom, którzy należą do klasy użytkowników mających ogólny dostęp, np. jeśli 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 spowoduje to również usunięcie użytkownika z listy edytujących.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
user | User | Reprezentacja użytkownika do usunięcia. |
Powrót
File – ten znak File służy do łączenia.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
revoke Permissions(emailAddress)
Unieważnia dostęp do File przyznany danemu użytkownikowi. Ta metoda nie blokuje użytkownikom dostępu do File, jeśli należą oni do klasy użytkowników, którzy mają ogólny dostęp, np. jeśli File jest udostępniony całej domenie użytkownika.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String | Adres e-mail użytkownika, któremu należy odebrać dostęp. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
revoke Permissions(user)
Unieważnia dostęp do File przyznany danemu użytkownikowi. Ta metoda nie blokuje użytkownikom dostępu do File, jeśli należą oni do klasy użytkowników, którzy mają ogólny dostęp, np. jeśli File jest udostępniony całej domenie użytkownika.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
user | User | Reprezentacja użytkownika, którego dostęp powinien zostać cofnięty. |
Powrót
File – ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
set Content(content)
Zastępuje zawartość pliku podanym tekstem. Zgłasza wyjątek, jeśli rozmiar pliku content przekracza 10 MB.
// Creates a text file with the content 'Hello, world!' const file = DriveApp.createFile('New Text File', 'Hello, world!'); // Logs the content of the text file to the console. console.log(file.getBlob().getDataAsString()); // Updates the content of the text file to 'Updated text!' file.setContent('Updated text!'); // Logs content of the text file to the console. console.log(file.getBlob().getDataAsString());
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
content | String | Nowa zawartość pliku. |
Powrót
File — ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
set Description(description)
set Name(name)
set Owner(emailAddress)
Zmienia właściciela File. Ta metoda przyznaje też poprzedniemu właścicielowi wyraźne uprawnienia do edycji File.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
email | String | adres e-mail użytkownika, który ma zostać nowym właścicielem; |
Powrót
File – ten File, do tworzenia łańcuszków
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
set Owner(user)
Zmienia właściciela File. Ta metoda przyznaje też poprzedniemu właścicielowi wyraźne uprawnienia do edycji File.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
user | User | reprezentację użytkownika, który ma zostać nowym właścicielem; |
Powrót
File – ten File, do tworzenia łańcuszków
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
set Security Update Enabled(enabled)
Określa, czy File wymaga klucza zasobu do uzyskania dostępu, gdy jest udostępniany za pomocą linku. Odpowiednie pliki i foldery są domyślnie włączone.
Dowiedz się więcej o aktualizacji zabezpieczeń Dysku Google.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
enabled | Boolean | Określa, czy w przypadku File ma być wymagany klucz zasobu. |
Powrót
File – ten File do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
set Sharing(accessType, permissionType)
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.
// 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.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
access | Access | która grupa użytkowników powinna mieć dostęp do File. |
permission | Permission | uprawnienia, które powinny zostać przyznane użytkownikom mającym dostęp do File; |
Powrót
File – ten File, do tworzenia łańcuszków
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
set Starred(starred)
Określa, czy File jest oznaczony gwiazdką na Dysku użytkownika. Wartość domyślna dla nowych File to false.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
starred | Boolean | true, jeśli File ma być oznaczony gwiazdką na Dysku użytkownika; false, jeśli nie. |
Powrót
File – ten File, do tworzenia łańcuszków
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive
set Trashed(trashed)
Określa, czy File znajduje się w koszu na Dysku użytkownika. Tylko właściciel może przenieść File do kosza. Wartość domyślna nowych File to false.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
trashed | Boolean | true – jeśli File ma zostać przeniesiony do kosza na Dysku użytkownika; false – w przeciwnym razie. |
Powrót
File – ten File, do tworzenia łańcuszków
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/drive