Halaman ini diterjemahkan oleh Cloud Translation API.

Class Folder

Folder di Google Drive. Folder dapat diakses atau dibuat dari DriveApp.

// Log the name of every folder in the user's Drive.
var folders = DriveApp.getFolders();
while (folders.hasNext()) {
  var folder = folders.next();
  Logger.log(folder.getName());
}

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`addEditor(emailAddress)`	`Folder`	Menambahkan pengguna tertentu ke daftar editor untuk `Folder`.
`addEditor(user)`	`Folder`	Menambahkan pengguna tertentu ke daftar editor untuk `Folder`.
`addEditors(emailAddresses)`	`Folder`	Menambahkan array pengguna yang ditentukan ke daftar editor untuk `Folder`.
`addViewer(emailAddress)`	`Folder`	Menambahkan pengguna tertentu ke daftar audiens untuk `Folder`.
`addViewer(user)`	`Folder`	Menambahkan pengguna tertentu ke daftar audiens untuk `Folder`.
`addViewers(emailAddresses)`	`Folder`	Menambahkan array pengguna yang ditentukan ke daftar audiens untuk `Folder`.
`createFile(blob)`	`File`	Membuat file di folder saat ini dari `Blob` data arbitrer tertentu.
`createFile(name, content)`	`File`	Membuat file teks di folder saat ini dengan nama dan isi yang diberikan.
`createFile(name, content, mimeType)`	`File`	Membuat file di folder saat ini dengan nama, isi, dan jenis MIME yang ditentukan.
`createFolder(name)`	`Folder`	Membuat folder di folder saat ini dengan nama yang ditentukan.
`createShortcut(targetId)`	`File`	Membuat pintasan ke ID item Drive yang diberikan, dan menampilkannya.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Membuat pintasan ke ID item Drive dan kunci resource yang disediakan, lalu menampilkannya.
`getAccess(email)`	`Permission`	Mendapatkan izin yang diberikan kepada pengguna tertentu.
`getAccess(user)`	`Permission`	Mendapatkan izin yang diberikan kepada pengguna tertentu.
`getDateCreated()`	`Date`	Mendapatkan tanggal `Folder` dibuat.
`getDescription()`	`String`	Mendapatkan deskripsi untuk `Folder`.
`getEditors()`	`User[]`	Mendapatkan daftar editor untuk `Folder` ini.
`getFiles()`	`FileIterator`	Mendapatkan koleksi semua file yang merupakan turunan dari folder saat ini.
`getFilesByName(name)`	`FileIterator`	Mendapatkan koleksi semua file yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.
`getFilesByType(mimeType)`	`FileIterator`	Mendapatkan koleksi semua file yang merupakan turunan dari folder saat ini dan memiliki jenis MIME tertentu.
`getFolders()`	`FolderIterator`	Mendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini.
`getFoldersByName(name)`	`FolderIterator`	Mendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.
`getId()`	`String`	Mendapatkan ID `Folder`.
`getLastUpdated()`	`Date`	Mendapatkan tanggal `Folder` terakhir diperbarui.
`getName()`	`String`	Mendapatkan nama `Folder`.
`getOwner()`	`User`	Mendapatkan pemilik `Folder` ini.
`getParents()`	`FolderIterator`	Mendapatkan koleksi folder yang merupakan induk langsung dari `Folder`.
`getResourceKey()`	`String`	Mendapatkan kunci resource `Folder` yang diperlukan untuk mengakses item yang telah dibagikan menggunakan link.
`getSecurityUpdateEligible()`	`Boolean`	Mendapatkan apakah `Folder` ini memenuhi syarat untuk menerapkan update keamanan yang memerlukan kunci resource untuk akses saat dibagikan menggunakan link.
`getSecurityUpdateEnabled()`	`Boolean`	Mendapatkan apakah `Folder` ini memerlukan kunci resource untuk akses saat dibagikan menggunakan link.
`getSharingAccess()`	`Access`	Mendapatkan class pengguna mana yang dapat mengakses `Folder`, selain setiap pengguna yang telah diberi akses secara eksplisit.
`getSharingPermission()`	`Permission`	Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses `Folder`, di samping setiap pengguna yang telah diberi akses secara eksplisit.
`getSize()`	`Integer`	Mendapatkan jumlah byte yang digunakan untuk menyimpan `Folder` di Drive.
`getUrl()`	`String`	Mendapatkan URL yang dapat digunakan untuk membuka `Folder` di Aplikasi Google seperti Drive atau Dokumen.
`getViewers()`	`User[]`	Mendapatkan daftar pelihat dan pengomentar untuk `Folder` ini.
`isShareableByEditors()`	`Boolean`	Menentukan apakah pengguna dengan izin edit ke `Folder` diizinkan untuk berbagi dengan pengguna lain atau mengubah izin.
`isStarred()`	`Boolean`	Menentukan apakah `Folder` telah diberi bintang di Drive pengguna.
`isTrashed()`	`Boolean`	Menentukan apakah `Folder` ada di sampah Drive pengguna.
`moveTo(destination)`	`Folder`	Memindahkan item ini ke folder tujuan yang disediakan.
`removeEditor(emailAddress)`	`Folder`	Menghapus pengguna yang ditentukan dari daftar editor untuk `Folder`.
`removeEditor(user)`	`Folder`	Menghapus pengguna yang ditentukan dari daftar editor untuk `Folder`.
`removeViewer(emailAddress)`	`Folder`	Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk `Folder`.
`removeViewer(user)`	`Folder`	Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Mencabut akses ke `Folder` yang diberikan kepada pengguna tertentu.
`revokePermissions(user)`	`Folder`	Mencabut akses ke `Folder` yang diberikan kepada pengguna tertentu.
`searchFiles(params)`	`FileIterator`	Mendapatkan koleksi semua file yang merupakan turunan dari folder saat ini, dan cocok dengan kriteria penelusuran yang diberikan.
`searchFolders(params)`	`FolderIterator`	Mendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini dan cocok dengan kriteria penelusuran yang diberikan.
`setDescription(description)`	`Folder`	Menetapkan deskripsi untuk `Folder`.
`setName(name)`	`Folder`	Menetapkan nama `Folder`.
`setOwner(emailAddress)`	`Folder`	Mengubah pemilik `Folder`.
`setOwner(user)`	`Folder`	Mengubah pemilik `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Menetapkan apakah `Folder` memerlukan kunci resource untuk diakses saat dibagikan menggunakan link.
`setShareableByEditors(shareable)`	`Folder`	Menetapkan apakah pengguna dengan izin edit ke `Folder` diizinkan untuk berbagi dengan pengguna lain atau mengubah izin.
`setSharing(accessType, permissionType)`	`Folder`	Menetapkan class pengguna yang dapat mengakses `Folder` dan izin yang diberikan kepada pengguna tersebut, selain setiap pengguna yang telah diberi akses secara eksplisit.
`setStarred(starred)`	`Folder`	Menetapkan apakah `Folder` diberi bintang di Drive pengguna.
`setTrashed(trashed)`	`Folder`	Menetapkan apakah `Folder` ada di sampah Drive pengguna.

Metode yang tidak digunakan lagi

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`addFile(child)`	`Folder`	Menambahkan file tertentu ke folder saat ini.
`addFolder(child)`	`Folder`	Menambahkan folder tertentu ke folder saat ini.
`removeFile(child)`	`Folder`	Menghapus file tertentu dari folder saat ini.
`removeFolder(child)`	`Folder`	Menghapus folder tertentu dari folder saat ini.

Dokumentasi mendetail

`addEditor(emailAddress)`

Menambahkan pengguna tertentu ke daftar editor untuk Folder. Jika pengguna sudah ada dalam daftar pelihat, metode ini akan mempromosikannya dari daftar pelihat.

Parameter

Nama	Type	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan ditambahkan.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addEditor(user)`

Menambahkan pengguna tertentu ke daftar editor untuk Folder. Jika pengguna sudah ada dalam daftar pelihat, metode ini akan mempromosikannya dari daftar pelihat.

Parameter

Nama	Type	Deskripsi
`user`	`User`	Representasi pengguna yang akan ditambahkan.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addEditors(emailAddresses)`

Menambahkan array pengguna yang ditentukan ke daftar editor untuk Folder. Jika ada pengguna yang sudah ada di daftar audiens, metode ini akan mempromosikannya dari daftar penonton.

Parameter

Nama	Type	Deskripsi
`emailAddresses`	`String[]`	Array alamat email pengguna yang akan ditambahkan.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addViewer(emailAddress)`

Menambahkan pengguna tertentu ke daftar audiens untuk Folder. Jika pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh.

Parameter

Nama	Type	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan ditambahkan.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addViewer(user)`

Menambahkan pengguna tertentu ke daftar audiens untuk Folder. Jika pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh.

Parameter

Nama	Type	Deskripsi
`user`	`User`	Representasi pengguna yang akan ditambahkan.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addViewers(emailAddresses)`

Menambahkan array pengguna yang ditentukan ke daftar audiens untuk Folder. Jika ada pengguna yang sudah ada di daftar editor, metode ini tidak akan berpengaruh bagi mereka.

Parameter

Nama	Type	Deskripsi
`emailAddresses`	`String[]`	Array alamat email pengguna yang akan ditambahkan.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createFile(blob)`

Membuat file di folder saat ini dari Blob data arbitrer tertentu.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().createFile(blob);

Parameter

Nama	Type	Deskripsi
`blob`	`BlobSource`	Data untuk file baru.

Return

File — File baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createFile(name, content)`

Membuat file teks di folder saat ini dengan nama dan isi yang diberikan. Menampilkan pengecualian jika content lebih besar dari 50 MB.

// Create a text file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');

Parameter

Nama	Type	Deskripsi
`name`	`String`	Nama file baru.
`content`	`String`	Konten untuk file baru.

Return

File — File baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createFile(name, content, mimeType)`

Membuat file di folder saat ini dengan nama, isi, dan jenis MIME yang ditentukan. Menampilkan pengecualian jika content lebih besar dari 10 MB.

// Create an HTML file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

Parameter

Nama	Type	Deskripsi
`name`	`String`	Nama file baru.
`content`	`String`	Konten untuk file baru.
`mimeType`	`String`	Jenis MIME dari file baru.

Return

File — File baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createFolder(name)`

Membuat folder di folder saat ini dengan nama yang ditentukan.

Parameter

Nama	Type	Deskripsi
`name`	`String`	Nama folder baru.

Return

Folder — Folder baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createShortcut(targetId)`

Membuat pintasan ke ID item Drive yang diberikan, dan menampilkannya.

Parameter

Nama	Type	Deskripsi
`targetId`	`String`	ID file dari file atau folder target.

Return

File — Pintasan baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

Membuat pintasan ke ID item Drive dan kunci resource yang disediakan, lalu menampilkannya. Kunci resource adalah parameter tambahan yang harus diteruskan untuk mengakses file atau folder target yang telah dibagikan menggunakan link.

// Creates shortcuts for all folders in the user's drive that have a specific name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey());
}

Parameter

Nama	Type	Deskripsi
`targetId`	`String`	ID file atau folder target.
`targetResourceKey`	`String`	Kunci resource file atau folder target.

Return

File — Pintasan baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getAccess(email)`

Mendapatkan izin yang diberikan kepada pengguna tertentu.

Parameter

Nama	Type	Deskripsi
`email`	`String`	alamat email pengguna yang izinnya harus diperiksa

Return

Permission — izin yang diberikan kepada pengguna

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getAccess(user)`

Mendapatkan izin yang diberikan kepada pengguna tertentu.

Parameter

Nama	Type	Deskripsi
`user`	`User`	representasi pengguna yang izinnya harus diperiksa

Return

Permission — izin yang diberikan kepada pengguna

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDateCreated()`

Mendapatkan tanggal Folder dibuat.

Return

Date — tanggal pembuatan Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDescription()`

Mendapatkan deskripsi untuk Folder.

Return

String — deskripsi untuk Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getEditors()`

Mendapatkan daftar editor untuk Folder ini. Jika pengguna yang mengeksekusi skrip tidak memiliki akses edit ke Folder, metode ini akan menampilkan array kosong.

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (editor of editors) {
  console.log(editor.getName());
}

Return

User[] — Daftar editor untuk Folder ini jika pengguna memiliki akses edit atau array kosong.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFiles()`

Mendapatkan koleksi semua file yang merupakan turunan dari folder saat ini.

Return

FileIterator — Kumpulan semua file yang merupakan turunan dari folder saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFilesByName(name)`

Mendapatkan koleksi semua file yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.

Parameter

Nama	Type	Deskripsi
`name`	`String`	Nama file yang akan ditemukan.

Return

FileIterator — Kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFilesByType(mimeType)`

Mendapatkan koleksi semua file yang merupakan turunan dari folder saat ini dan memiliki jenis MIME tertentu.

Parameter

Nama	Type	Deskripsi
`mimeType`	`String`	Jenis file MIME yang akan ditemukan.

Return

FileIterator — Kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki jenis MIME yang diberikan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFolders()`

Mendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini.

Return

FolderIterator — Kumpulan semua folder yang merupakan turunan dari folder saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFoldersByName(name)`

Mendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.

Parameter

Nama	Type	Deskripsi
`name`	`String`	Nama folder yang akan ditemukan.

Return

FolderIterator — Kumpulan semua folder yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getId()`

Mendapatkan ID Folder.

Return

String — ID Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getLastUpdated()`

Mendapatkan tanggal Folder terakhir diperbarui.

Return

Date — tanggal Folder terakhir diperbarui

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getName()`

Mendapatkan nama Folder.

Return

String — nama Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getOwner()`

Mendapatkan pemilik Folder ini.

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

Return

User — Pemilik Folder ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getParents()`

Mendapatkan koleksi folder yang merupakan induk langsung dari Folder.

Return

FolderIterator — kumpulan folder yang merupakan induk langsung dari Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getResourceKey()`

Mendapatkan kunci resource Folder yang diperlukan untuk mengakses item yang telah dibagikan menggunakan link.

Return

String — Kunci resource Folder.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getSecurityUpdateEligible()`

Mendapatkan apakah Folder ini memenuhi syarat untuk menerapkan update keamanan yang memerlukan kunci resource untuk akses saat dibagikan menggunakan link.

Drive memerlukan kunci resource untuk mengakses beberapa file atau folder yang telah dibagikan menggunakan link. Perubahan ini adalah bagian dari update keamanan. Update diaktifkan secara default untuk file dan folder yang memenuhi syarat. Untuk mengaktifkan atau menonaktifkan persyaratan kunci resource bagi file yang memenuhi syarat, gunakan setSecurityUpdateEnabled.

Pelajari lebih lanjut Update keamanan untuk Google Drive.

Return

Boolean — Apakah persyaratan kunci resource dapat diterapkan untuk Folder.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getSecurityUpdateEnabled()`

Mendapatkan apakah Folder ini memerlukan kunci resource untuk akses saat dibagikan menggunakan link. Persyaratan ini diaktifkan secara default untuk file dan folder yang memenuhi syarat. Untuk mengaktifkan atau menonaktifkan persyaratan kunci resource untuk file yang memenuhi syarat, gunakan setSecurityUpdateEnabled.

Pelajari lebih lanjut Update keamanan untuk Google Drive.

Return

Boolean — Apakah persyaratan kunci resource diaktifkan untuk Folder ini atau tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getSharingAccess()`

Mendapatkan class pengguna mana yang dapat mengakses Folder, selain setiap pengguna yang telah diberi akses secara eksplisit.

Return

Access — class pengguna mana yang dapat mengakses Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getSharingPermission()`

Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses Folder, di samping setiap pengguna yang telah diberi akses secara eksplisit.

Return

Permission — izin yang diberikan kepada pengguna yang dapat mengakses Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getSize()`

Mendapatkan jumlah byte yang digunakan untuk menyimpan Folder di Drive. Perlu diperhatikan bahwa file aplikasi Google Workspace tidak diperhitungkan dalam batas penyimpanan Drive, sehingga menampilkan 0 byte.

Return

Integer — jumlah byte yang digunakan untuk menyimpan Folder di Drive

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getUrl()`

Mendapatkan URL yang dapat digunakan untuk membuka Folder di Aplikasi Google seperti Drive atau Dokumen.

Return

String — URL yang dapat digunakan untuk melihat Folder ini di Aplikasi Google seperti Drive atau Dokumen

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getViewers()`

Mendapatkan daftar pelihat dan pengomentar untuk Folder ini. Jika pengguna yang menjalankan skrip tidak memiliki akses edit ke Folder, metode ini akan menampilkan array kosong.

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (viewer of viewers) {
  console.log(viewer.getName());
}

Return

User[] — Daftar pelihat dan pengomentar untuk Folder ini jika pengguna memiliki akses edit atau array kosong.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isShareableByEditors()`

Menentukan apakah pengguna dengan izin edit ke Folder diizinkan untuk berbagi dengan pengguna lain atau mengubah izin.

Return

Boolean — true jika pengguna dengan izin edit diizinkan untuk berbagi dengan pengguna lain atau mengubah izin; false jika tidak

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isStarred()`

Menentukan apakah Folder telah diberi bintang di Drive pengguna.

Return

Boolean — true jika Folder berbintang di Drive pengguna; false jika tidak

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isTrashed()`

Menentukan apakah Folder ada di sampah Drive pengguna.

Return

Boolean — true jika Folder ada di sampah Drive pengguna; false jika tidak

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`moveTo(destination)`

Memindahkan item ini ke folder tujuan yang disediakan.

Pengguna saat ini harus menjadi pemilik file atau memiliki setidaknya akses edit ke folder induk item saat ini agar dapat memindahkan item ke folder tujuan.

Parameter

Nama	Type	Deskripsi
`destination`	`Folder`	Folder yang menjadi induk baru.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`removeEditor(emailAddress)`

Menghapus pengguna yang ditentukan dari daftar editor untuk Folder. Metode ini tidak memblokir pengguna untuk mengakses Folder jika mereka termasuk dalam class pengguna yang memiliki akses umum—misalnya, jika Folder dibagikan ke seluruh domain pengguna, atau jika Folder berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, pengguna juga akan dihapus dari daftar pelihat.

Parameter

Nama	Type	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan dihapus.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`removeEditor(user)`

Untuk file Drive, pengguna juga akan dihapus dari daftar pelihat.

Parameter

Nama	Type	Deskripsi
`user`	`User`	Representasi pengguna yang akan dihapus.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`removeViewer(emailAddress)`

Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Folder. Metode ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat atau pengomentar. Metode ini juga tidak memblokir pengguna untuk mengakses Folder jika mereka termasuk dalam class pengguna yang memiliki akses umum—misalnya, jika Folder dibagikan kepada seluruh domain pengguna, atau jika Folder berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, pengguna juga akan dihapus dari daftar editor.

Parameter

Nama	Type	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan dihapus.

Return

Folder — Folder ini untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`removeViewer(user)`

Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Folder. Metode ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat. Metode ini juga tidak memblokir pengguna untuk mengakses Folder jika mereka termasuk dalam class pengguna yang memiliki akses umum—misalnya, jika Folder dibagikan kepada seluruh domain pengguna, atau jika Folder berada dalam drive bersama yang dapat diakses pengguna.

Untuk file Drive, pengguna juga akan dihapus dari daftar editor.

Parameter

Nama	Type	Deskripsi
`user`	`User`	Representasi pengguna yang akan dihapus.

Return

Folder — Folder ini untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`revokePermissions(emailAddress)`

Mencabut akses ke Folder yang diberikan kepada pengguna tertentu. Metode ini tidak memblokir pengguna untuk mengakses Folder jika mereka termasuk dalam class pengguna yang memiliki akses umum — misalnya, jika Folder dibagikan ke seluruh domain pengguna.

Parameter

Nama	Type	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang aksesnya harus dicabut.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`revokePermissions(user)`

Parameter

Nama	Type	Deskripsi
`user`	`User`	Representasi pengguna yang aksesnya harus dicabut.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`searchFiles(params)`

Mendapatkan koleksi semua file yang merupakan turunan dari folder saat ini, dan cocok dengan kriteria penelusuran yang diberikan. Kriteria penelusuran diuraikan dalam dokumentasi SDK Google Drive. Perhatikan bahwa layanan Drive menggunakan Drive API v2 dan beberapa kolom kueri berbeda dengan v3. Tinjau perbedaan kolom antara v2 dan v3.

Argumen params adalah string kueri yang dapat berisi nilai string. Jadi, pastikan untuk meng-escape tanda kutip dengan benar (misalnya "title contains 'Gulliver\\'s Travels'" atau 'title contains "Gulliver\'s Travels"').

// Logs the name of every file that are children of the current folder and modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Parameter

Nama	Type	Deskripsi
`params`	`String`	Kriteria penelusuran, seperti yang dijelaskan dalam dokumentasi Google Drive SDK.

Return

FileIterator — Kumpulan semua file yang merupakan turunan dari folder saat ini dan cocok dengan kriteria penelusuran.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`searchFolders(params)`

Mendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini dan cocok dengan kriteria penelusuran yang diberikan. Kriteria penelusuran diuraikan dalam dokumentasi SDK Google Drive. Perhatikan bahwa layanan Drive menggunakan Drive API v2 dan beberapa kolom kueri berbeda dengan v3. Tinjau perbedaan kolom antara v2 dan v3.

// Logs the name of every folder that are children of the current folder and you own and is starred.
var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

Parameter

Nama	Type	Deskripsi
`params`	`String`	Kriteria penelusuran, seperti yang dijelaskan dalam dokumentasi Google Drive SDK.

Return

FolderIterator — Kumpulan semua folder yang merupakan turunan dari folder saat ini dan cocok dengan kriteria penelusuran.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setDescription(description)`

Menetapkan deskripsi untuk Folder.

Parameter

Nama	Type	Deskripsi
`description`	`String`	deskripsi baru untuk `Folder`

Return

Folder — Folder ini, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setName(name)`

Menetapkan nama Folder.

Parameter

Nama	Type	Deskripsi
`name`	`String`	nama baru `Folder`

Return

Folder — Folder ini, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setOwner(emailAddress)`

Mengubah pemilik Folder. Metode ini juga memberi pemilik sebelumnya akses edit eksplisit ke Folder.

Parameter

Nama	Type	Deskripsi
`emailAddress`	`String`	alamat email pengguna yang seharusnya menjadi pemilik baru

Return

Folder — Folder ini, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setOwner(user)`

Mengubah pemilik Folder. Metode ini juga memberi pemilik sebelumnya akses edit eksplisit ke Folder.

Parameter

Nama	Type	Deskripsi
`user`	`User`	representasi pengguna yang akan menjadi pemilik baru

Return

Folder — Folder ini, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setSecurityUpdateEnabled(enabled)`

Menetapkan apakah Folder memerlukan kunci resource untuk diakses saat dibagikan menggunakan link. File dan folder yang memenuhi syarat diaktifkan secara default.

Pelajari lebih lanjut Update keamanan untuk Google Drive.

Parameter

Nama	Type	Deskripsi
`enabled`	`Boolean`	Apakah akan mengaktifkan persyaratan kunci resource untuk `Folder`.

Return

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setShareableByEditors(shareable)`

Menetapkan apakah pengguna dengan izin edit ke Folder diizinkan untuk berbagi dengan pengguna lain atau mengubah izin. Default untuk Folder baru adalah true.

Parameter

Nama	Type	Deskripsi
`shareable`	`Boolean`	`true` jika pengguna dengan izin edit harus diizinkan untuk berbagi dengan pengguna lain atau mengubah izin; `false` jika tidak

Return

Folder — Folder ini, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setSharing(accessType, permissionType)`

Menetapkan class pengguna yang dapat mengakses Folder dan izin yang diberikan kepada pengguna tersebut, selain setiap pengguna yang telah diberi akses secara eksplisit.

// 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);

Parameter

Nama	Type	Deskripsi
`accessType`	`Access`	class pengguna mana yang harus dapat mengakses `Folder`
`permissionType`	`Permission`	izin yang harus diberikan kepada pengguna yang dapat mengakses `Folder`

Return

Folder — Folder ini, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setStarred(starred)`

Menetapkan apakah Folder diberi bintang di Drive pengguna. Default untuk Folder baru adalah false.

Parameter

Nama	Type	Deskripsi
`starred`	`Boolean`	`true` jika `Folder` harus diberi bintang di Drive pengguna; `false` jika tidak

Return

Folder — Folder ini, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setTrashed(trashed)`

Menetapkan apakah Folder ada di sampah Drive pengguna. Hanya pemilik yang dapat membuang Folder. Default untuk Folder baru adalah false.

Parameter

Nama	Type	Deskripsi
`trashed`	`Boolean`	`true` jika `Folder` harus dipindahkan ke sampah di Drive pengguna; `false` jika tidak

Return

Folder — Folder ini, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Metode yang tidak digunakan lagi

`addFile(child)`

Tidak digunakan lagi. Sebagai gantinya, gunakan File.moveTo(destination) atau createShortcut(targetId).

Menambahkan file tertentu ke folder saat ini. Metode ini tidak memindahkan file dari folder induk yang sudah ada; file dapat memiliki lebih dari satu induk secara bersamaan.

Parameter

Nama	Type	Deskripsi
`child`	`File`	File turunan yang akan ditambahkan.

Return

Folder — Induk baru file ditambahkan sebagai turunan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addFolder(child)`

Tidak digunakan lagi. Sebagai gantinya, gunakan moveTo(destination) atau createShortcut(targetId).

Menambahkan folder tertentu ke folder saat ini. Metode ini tidak memindahkan folder dari folder induk yang sudah ada; folder dapat memiliki lebih dari satu induk secara bersamaan.

Parameter

Nama	Type	Deskripsi
`child`	`Folder`	Folder turunan yang akan ditambahkan.

Return

Folder — Induk baru folder ditambahkan sebagai turunan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`removeFile(child)`

Tidak digunakan lagi. Sebagai gantinya, gunakan File.moveTo(destination).

Menghapus file tertentu dari folder saat ini. Metode ini tidak menghapus file, tetapi jika file dihapus dari semua induknya, metode ini tidak dapat dilihat di Drive kecuali dengan menelusurinya atau menggunakan tampilan "Semua item".

Parameter

Nama	Type	Deskripsi
`child`	`File`	File turunan yang akan dihapus.

Return

Folder — Orang tua sebelumnya dari anak tersebut.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`removeFolder(child)`

Tidak digunakan lagi. Sebagai gantinya, gunakan moveTo(destination).

Menghapus folder tertentu dari folder saat ini. Metode ini tidak menghapus folder atau kontennya, tetapi jika folder dihapus dari semua induknya, folder tidak dapat dilihat di Drive kecuali dengan menelusurinya atau menggunakan tampilan "Semua item".

Parameter

Nama	Type	Deskripsi
`child`	`Folder`	Folder turunan yang akan dihapus.

Return

Folder — Orang tua sebelumnya dari anak tersebut.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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