Class Folder

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addEditor(emailAddress)FolderMenambahkan pengguna tertentu ke daftar editor untuk Folder.
addEditor(user)FolderMenambahkan pengguna tertentu ke daftar editor untuk Folder.
addEditors(emailAddresses)FolderMenambahkan array pengguna yang ditentukan ke daftar editor untuk Folder.
addViewer(emailAddress)FolderMenambahkan pengguna tertentu ke daftar audiens untuk Folder.
addViewer(user)FolderMenambahkan pengguna tertentu ke daftar audiens untuk Folder.
addViewers(emailAddresses)FolderMenambahkan array pengguna yang ditentukan ke daftar audiens untuk Folder.
createFile(blob)FileMembuat file di folder saat ini dari Blob data arbitrer tertentu.
createFile(name, content)FileMembuat file teks di folder saat ini dengan nama dan isi yang diberikan.
createFile(name, content, mimeType)FileMembuat file di folder saat ini dengan nama, isi, dan jenis MIME yang ditentukan.
createFolder(name)FolderMembuat folder di folder saat ini dengan nama yang ditentukan.
createShortcut(targetId)FileMembuat pintasan ke ID item Drive yang diberikan, dan menampilkannya.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileMembuat pintasan ke ID item Drive dan kunci resource yang disediakan, lalu menampilkannya.
getAccess(email)PermissionMendapatkan izin yang diberikan kepada pengguna tertentu.
getAccess(user)PermissionMendapatkan izin yang diberikan kepada pengguna tertentu.
getDateCreated()DateMendapatkan tanggal Folder dibuat.
getDescription()StringMendapatkan deskripsi untuk Folder.
getEditors()User[]Mendapatkan daftar editor untuk Folder ini.
getFiles()FileIteratorMendapatkan koleksi semua file yang merupakan turunan dari folder saat ini.
getFilesByName(name)FileIteratorMendapatkan koleksi semua file yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.
getFilesByType(mimeType)FileIteratorMendapatkan koleksi semua file yang merupakan turunan dari folder saat ini dan memiliki jenis MIME tertentu.
getFolders()FolderIteratorMendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini.
getFoldersByName(name)FolderIteratorMendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.
getId()StringMendapatkan ID Folder.
getLastUpdated()DateMendapatkan tanggal Folder terakhir diperbarui.
getName()StringMendapatkan nama Folder.
getOwner()UserMendapatkan pemilik Folder.
getParents()FolderIteratorMendapatkan koleksi folder yang merupakan induk langsung dari Folder.
getResourceKey()StringMendapatkan kunci resource Folder yang diperlukan untuk mengakses item yang telah dibagikan menggunakan link.
getSecurityUpdateEligible()BooleanMendapatkan apakah Folder ini memenuhi syarat untuk menerapkan update keamanan yang memerlukan kunci resource untuk akses saat dibagikan menggunakan link.
getSecurityUpdateEnabled()BooleanMendapatkan apakah Folder ini memerlukan kunci resource untuk akses saat dibagikan menggunakan link.
getSharingAccess()AccessMendapatkan class pengguna mana yang dapat mengakses Folder, selain setiap pengguna yang telah diberi akses secara eksplisit.
getSharingPermission()PermissionMendapatkan izin yang diberikan kepada pengguna yang dapat mengakses Folder, di samping setiap pengguna yang telah diberi akses secara eksplisit.
getSize()IntegerMendapatkan jumlah byte yang digunakan untuk menyimpan Folder di Drive.
getUrl()StringMendapatkan 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()BooleanMenentukan apakah pengguna dengan izin edit ke Folder diizinkan untuk berbagi dengan pengguna lain atau mengubah izin.
isStarred()BooleanMenentukan apakah Folder telah diberi bintang di Drive pengguna.
isTrashed()BooleanMenentukan apakah Folder ada di sampah Drive pengguna.
moveTo(destination)FolderMemindahkan item ini ke folder tujuan yang disediakan.
removeEditor(emailAddress)FolderMenghapus pengguna yang ditentukan dari daftar editor untuk Folder.
removeEditor(user)FolderMenghapus pengguna yang ditentukan dari daftar editor untuk Folder.
removeViewer(emailAddress)FolderMenghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Folder.
removeViewer(user)FolderMenghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Folder.
revokePermissions(emailAddress)FolderMencabut akses ke Folder yang diberikan kepada pengguna tertentu.
revokePermissions(user)FolderMencabut akses ke Folder yang diberikan kepada pengguna tertentu.
searchFiles(params)FileIteratorMendapatkan koleksi semua file yang merupakan turunan dari folder saat ini, dan cocok dengan kriteria penelusuran yang diberikan.
searchFolders(params)FolderIteratorMendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini dan cocok dengan kriteria penelusuran yang diberikan.
setDescription(description)FolderMenetapkan deskripsi untuk Folder.
setName(name)FolderMenetapkan nama Folder.
setOwner(emailAddress)FolderMengubah pemilik Folder.
setOwner(user)FolderMengubah pemilik Folder.
setSecurityUpdateEnabled(enabled)FolderMenetapkan apakah Folder memerlukan kunci resource untuk diakses saat dibagikan menggunakan link.
setShareableByEditors(shareable)FolderMenetapkan apakah pengguna dengan izin edit ke Folder diizinkan untuk berbagi dengan pengguna lain atau mengubah izin.
setSharing(accessType, permissionType)FolderMenetapkan class pengguna yang dapat mengakses Folder dan izin yang diberikan kepada pengguna tersebut, selain setiap pengguna yang telah diberi akses secara eksplisit.
setStarred(starred)FolderMenetapkan apakah Folder diberi bintang di Drive pengguna.
setTrashed(trashed)FolderMenetapkan apakah Folder ada di sampah Drive pengguna.

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

NamaTypeDeskripsi
emailAddressStringAlamat email pengguna yang akan ditambahkan.

Return

FolderFolder 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

NamaTypeDeskripsi
userUserRepresentasi pengguna yang akan ditambahkan.

Return

FolderFolder 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

NamaTypeDeskripsi
emailAddressesString[]Array alamat email pengguna yang akan ditambahkan.

Return

FolderFolder 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

NamaTypeDeskripsi
emailAddressStringAlamat email pengguna yang akan ditambahkan.

Return

FolderFolder 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

NamaTypeDeskripsi
userUserRepresentasi pengguna yang akan ditambahkan.

Return

FolderFolder 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

NamaTypeDeskripsi
emailAddressesString[]Array alamat email pengguna yang akan ditambahkan.

Return

FolderFolder 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

NamaTypeDeskripsi
blobBlobSourceData 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

NamaTypeDeskripsi
nameStringNama file baru.
contentStringKonten 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

NamaTypeDeskripsi
nameStringNama file baru.
contentStringKonten untuk file baru.
mimeTypeStringJenis 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

NamaTypeDeskripsi
nameStringNama 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

NamaTypeDeskripsi
targetIdStringID 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.

Parameter

NamaTypeDeskripsi
targetIdStringID file atau folder target.
targetResourceKeyStringKunci 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

NamaTypeDeskripsi
emailStringalamat 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

NamaTypeDeskripsi
userUserrepresentasi 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.

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

NamaTypeDeskripsi
nameStringNama 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

NamaTypeDeskripsi
mimeTypeStringJenis 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

NamaTypeDeskripsi
nameStringNama 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.

Return

User — objek User yang mewakili pemilik

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.

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

Booleantrue 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

Booleantrue 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

Booleantrue 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

NamaTypeDeskripsi
destinationFolderFolder yang menjadi induk baru.

Return

FolderFolder 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

NamaTypeDeskripsi
emailAddressStringAlamat email pengguna yang akan dihapus.

Return

FolderFolder 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)

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

NamaTypeDeskripsi
userUserRepresentasi pengguna yang akan dihapus.

Return

FolderFolder 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

NamaTypeDeskripsi
emailAddressStringAlamat email pengguna yang akan dihapus.

Return

FolderFolder 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

NamaTypeDeskripsi
userUserRepresentasi pengguna yang akan dihapus.

Return

FolderFolder 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

NamaTypeDeskripsi
emailAddressStringAlamat email pengguna yang aksesnya harus dicabut.

Return

FolderFolder 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)

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

NamaTypeDeskripsi
userUserRepresentasi pengguna yang aksesnya harus dicabut.

Return

FolderFolder 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

NamaTypeDeskripsi
paramsStringKriteria 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.

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 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

NamaTypeDeskripsi
paramsStringKriteria 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

NamaTypeDeskripsi
descriptionStringdeskripsi baru untuk Folder

Return

FolderFolder 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

NamaTypeDeskripsi
nameStringnama baru Folder

Return

FolderFolder 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

NamaTypeDeskripsi
emailAddressStringalamat email pengguna yang seharusnya menjadi pemilik baru

Return

FolderFolder 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

NamaTypeDeskripsi
userUserrepresentasi pengguna yang akan menjadi pemilik baru

Return

FolderFolder 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

NamaTypeDeskripsi
enabledBooleanApakah akan mengaktifkan persyaratan kunci resource untuk Folder.

Return

FolderFolder 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

NamaTypeDeskripsi
shareableBooleantrue jika pengguna dengan izin edit harus diizinkan untuk berbagi dengan pengguna lain atau mengubah izin; false jika tidak

Return

FolderFolder 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

NamaTypeDeskripsi
accessTypeAccessclass pengguna mana yang harus dapat mengakses Folder
permissionTypePermissionizin yang harus diberikan kepada pengguna yang dapat mengakses Folder

Return

FolderFolder 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

NamaTypeDeskripsi
starredBooleantrue jika Folder harus diberi bintang di Drive pengguna; false jika tidak

Return

FolderFolder 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

NamaTypeDeskripsi
trashedBooleantrue jika Folder harus dipindahkan ke sampah di Drive pengguna; false jika tidak

Return

FolderFolder 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