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.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
  const folder = folders.next();
  Logger.log(folder.getName());
}

Metode

MetodeJenis nilai 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 tertentu ke daftar editor untuk Folder.
addViewer(emailAddress)FolderMenambahkan pengguna tertentu ke daftar penonton untuk Folder.
addViewer(user)FolderMenambahkan pengguna tertentu ke daftar penonton untuk Folder.
addViewers(emailAddresses)FolderMenambahkan array pengguna tertentu ke daftar penonton untuk Folder.
createFile(blob)FileMembuat file di folder saat ini dari Blob data arbitrer yang diberikan.
createFile(name, content)FileMembuat file teks di folder saat ini dengan nama dan konten yang ditentukan.
createFile(name, content, mimeType)FileMembuat file di folder saat ini dengan nama, konten, dan jenis MIME yang diberikan.
createFolder(name)FolderMembuat folder di folder saat ini dengan nama yang diberikan.
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 diberikan, lalu menampilkannya.
getAccess(email)PermissionMendapatkan izin yang diberikan kepada pengguna tertentu.
getAccess(user)PermissionMendapatkan izin yang diberikan kepada pengguna tertentu.
getDateCreated()DateMendapatkan tanggal pembuatan Folder.
getDescription()StringMendapatkan deskripsi untuk Folder.
getEditors()User[]Mendapatkan daftar editor untuk Folder ini.
getFiles()FileIteratorMendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini.
getFilesByName(name)FileIteratorMendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki nama yang diberikan.
getFilesByType(mimeType)FileIteratorMendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki jenis MIME tertentu.
getFolders()FolderIteratorMendapatkan kumpulan semua folder yang merupakan turunan dari folder saat ini.
getFoldersByName(name)FolderIteratorMendapatkan kumpulan semua folder yang merupakan turunan dari folder saat ini dan memiliki nama yang diberikan.
getId()StringMendapatkan ID Folder.
getLastUpdated()DateMendapatkan tanggal terakhir Folder diperbarui.
getName()StringMendapatkan nama Folder.
getOwner()UserMendapatkan pemilik Folder ini.
getParents()FolderIteratorMendapatkan kumpulan 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 kelas pengguna yang dapat mengakses Folder, selain pengguna perorangan yang telah diberi akses secara eksplisit.
getSharingPermission()PermissionMendapatkan izin yang diberikan kepada pengguna yang dapat mengakses Folder, selain pengguna perorangan 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 membagikan kepada pengguna lain atau mengubah izin.
isStarred()BooleanMenentukan apakah Folder telah dibintangi di Drive pengguna.
isTrashed()BooleanMenentukan apakah Folder ada di sampah Drive pengguna.
moveTo(destination)FolderMemindahkan item ini ke folder tujuan yang ditentukan.
removeEditor(emailAddress)FolderMenghapus pengguna tertentu dari daftar editor untuk Folder.
removeEditor(user)FolderMenghapus pengguna tertentu dari daftar editor untuk Folder.
removeViewer(emailAddress)FolderMenghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk Folder.
removeViewer(user)FolderMenghapus pengguna tertentu dari daftar penonton dan pemberi komentar 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 kumpulan semua file yang merupakan turunan dari folder saat ini dan cocok dengan kriteria penelusuran yang diberikan.
searchFolders(params)FolderIteratorMendapatkan kumpulan 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 akses saat dibagikan menggunakan link.
setShareableByEditors(shareable)FolderMenetapkan apakah pengguna dengan izin edit ke Folder diizinkan untuk membagikan kepada pengguna lain atau mengubah izin.
setSharing(accessType, permissionType)FolderMenetapkan kelas pengguna yang dapat mengakses Folder dan izin yang diberikan kepada pengguna tersebut, selain pengguna perorangan 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 penonton, metode ini akan mempromosikan pengguna keluar dari daftar penonton.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 penonton, metode ini akan mempromosikan pengguna keluar dari daftar penonton.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 tertentu ke daftar editor untuk Folder. Jika salah satu pengguna sudah ada dalam daftar pelihat, metode ini akan mempromosikannya keluar dari daftar pelihat.

Parameter

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

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 penonton untuk Folder. Jika pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 penonton untuk Folder. Jika pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 tertentu ke daftar penonton untuk Folder. Jika salah satu pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh bagi mereka.

Parameter

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

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 yang diberikan.

Parameter

NamaJenisDeskripsi
blobBlobSourceData untuk file baru.

Pulang pergi

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 konten yang ditentukan. 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

NamaJenisDeskripsi
nameStringNama file baru.
contentStringKonten untuk file baru.

Pulang pergi

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, konten, dan jenis MIME yang diberikan. 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

NamaJenisDeskripsi
nameStringNama file baru.
contentStringKonten untuk file baru.
mimeTypeStringJenis MIME file baru.

Pulang pergi

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

Parameter

NamaJenisDeskripsi
nameStringNama folder baru.

Pulang pergi

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

NamaJenisDeskripsi
targetIdStringID file dari file atau folder target.

Pulang pergi

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 diberikan, lalu menampilkannya. Kunci resource adalah parameter tambahan yang perlu 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

NamaJenisDeskripsi
targetIdStringID file atau folder target.
targetResourceKeyStringKunci resource file atau folder target.

Pulang pergi

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. Metode ini tidak mendukung menampilkan izin untuk Google Grup atau izin yang diwarisi melalui Google Grup.

Parameter

NamaJenisDeskripsi
emailStringAlamat email pengguna yang izinnya harus diperiksa. Google Grup tidak didukung.

Pulang pergi

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. Metode ini tidak mendukung menampilkan izin untuk Google Grup atau izin yang diwarisi melalui Google Grup.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang izinnya harus diperiksa.

Pulang pergi

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 pembuatan Folder.

Pulang pergi

Date — tanggal Folder dibuat

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.

Pulang pergi

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 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 editors and logs their names to the console.
const editors = folder.getEditors();
for (const editor of editors) {
  console.log(editor.getName());
}

Pulang pergi

User[] — Daftar editor untuk Folder ini jika pengguna memiliki akses edit atau array kosong 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

getFiles()

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

Pulang pergi

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 kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki nama yang diberikan.

Parameter

NamaJenisDeskripsi
nameStringNama file yang akan ditemukan.

Pulang pergi

FileIterator — Kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki nama 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

getFilesByType(mimeType)

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

Parameter

NamaJenisDeskripsi
mimeTypeStringJenis MIME file yang akan ditemukan.

Pulang pergi

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 kumpulan semua folder yang merupakan turunan dari folder saat ini.

Pulang pergi

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 kumpulan semua folder yang merupakan turunan dari folder saat ini dan memiliki nama yang diberikan.

Parameter

NamaJenisDeskripsi
nameStringNama folder yang akan ditemukan.

Pulang pergi

FolderIterator — Kumpulan semua folder yang merupakan turunan dari folder saat ini dan memiliki nama 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

getId()

Mendapatkan ID Folder.

Pulang pergi

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 terakhir Folder diperbarui.

Pulang pergi

Date — tanggal terakhir Folder 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.

Pulang pergi

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

Pulang pergi

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 kumpulan folder yang merupakan induk langsung dari Folder.

Pulang pergi

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.

Pulang pergi

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

Pulang pergi

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.

Pulang pergi

Boolean — Apakah persyaratan kunci resource diaktifkan untuk 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

getSharingAccess()

Mendapatkan kelas pengguna yang dapat mengakses Folder, selain pengguna perorangan yang telah diberi akses secara eksplisit.

Pulang pergi

Access — kelas 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, selain pengguna perorangan yang telah diberi akses secara eksplisit.

Pulang pergi

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. Perhatikan bahwa file aplikasi Google Workspace tidak mengurangi batas penyimpanan Drive dan dengan demikian menampilkan 0 byte.

Pulang pergi

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.

Pulang pergi

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 (const viewer of viewers) {
  console.log(viewer.getName());
}

Pulang pergi

User[] — Daftar pelihat dan pemberi komentar untuk Folder ini jika pengguna memiliki akses edit atau array kosong 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

isShareableByEditors()

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

Pulang pergi

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 dibintangi di Drive pengguna.

Pulang pergi

Boolean — true jika Folder diberi bintang 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.

Pulang pergi

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

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

Parameter

NamaJenisDeskripsi
destinationFolderFolder yang menjadi induk baru.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

Otorisasi

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

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

removeEditor(emailAddress)

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

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan dihapus.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

Otorisasi

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

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

removeEditor(user)

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

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang akan dihapus.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 penonton dan pemberi komentar untuk Folder. Metode ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat atau pemberi komentar. Metode ini juga tidak memblokir pengguna agar tidak mengakses Folder jika mereka termasuk dalam kelas pengguna yang memiliki akses umum—misalnya, jika Folder dibagikan dengan seluruh domain pengguna, atau jika Folder berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar editor.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan dihapus.

Pulang pergi

Folder — Folder ini untuk merangkai.

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 penonton dan pemberi komentar untuk Folder. Metode ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat. Metode ini juga tidak memblokir pengguna mengakses Folder jika mereka termasuk dalam kelas pengguna yang memiliki akses umum—misalnya, jika Folder dibagikan dengan seluruh domain pengguna, atau jika Folder berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar editor.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang akan dihapus.

Pulang pergi

Folder — Folder ini untuk merangkai.

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 mengakses Folder jika mereka termasuk dalam kelas pengguna yang memiliki akses umum — misalnya, jika Folder dibagikan dengan seluruh domain pengguna.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang aksesnya harus dicabut.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 mengakses Folder jika mereka termasuk dalam kelas pengguna yang memiliki akses umum — misalnya, jika Folder dibagikan dengan seluruh domain pengguna.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang aksesnya harus dicabut.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

Otorisasi

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

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

searchFiles(params)

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

Argumen params adalah string kueri yang dapat berisi nilai string, jadi berhati-hatilah untuk melakukan escape pada 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.""
const files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getName());
}

Parameter

NamaJenisDeskripsi
paramsStringKriteria penelusuran, seperti yang dijelaskan dalam dokumentasi Google Drive SDK.

Pulang pergi

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 kumpulan semua folder yang merupakan turunan dari folder saat ini dan cocok dengan kriteria penelusuran yang diberikan. Kriteria penelusuran dijelaskan secara mendetail dalam dokumentasi Google Drive SDK. Perhatikan bahwa layanan Drive menggunakan Drive API v2 dan beberapa kolom kueri berbeda dari v3. Tinjau perbedaan kolom antara v2 dan v3.

Argumen params adalah string kueri yang dapat berisi nilai string, jadi berhati-hatilah untuk melakukan escape pada 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.
const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  const folder = folders.next();
  console.log(folder.getName());
}

Parameter

NamaJenisDeskripsi
paramsStringKriteria penelusuran, seperti yang dijelaskan dalam dokumentasi Google Drive SDK.

Pulang pergi

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

NamaJenisDeskripsi
descriptionStringdeskripsi baru untuk Folder

Pulang pergi

Folder — Folder ini, untuk merangkai

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

NamaJenisDeskripsi
nameStringnama baru Folder

Pulang pergi

Folder — Folder ini, untuk merangkai

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 memberikan akses pengeditan eksplisit ke Folder kepada pemilik sebelumnya.

Drive tidak mendukung perubahan kepemilikan untuk item yang dimiliki oleh akun gmail.com; perubahan kepemilikan didukung untuk akun Workspace.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan menjadi pemilik baru.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 memberikan akses pengeditan eksplisit ke Folder kepada pemilik sebelumnya.

Drive tidak mendukung perubahan kepemilikan untuk item yang dimiliki oleh akun gmail.com; perubahan kepemilikan didukung untuk akun Workspace.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang akan menjadi pemilik baru.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 akses saat dibagikan menggunakan link. File dan folder yang memenuhi syarat diaktifkan secara default.

Pelajari lebih lanjut Update keamanan untuk Google Drive.

Parameter

NamaJenisDeskripsi
enabledBooleanApakah akan mengaktifkan persyaratan kunci resource untuk Folder.

Pulang pergi

Folder — Folder ini, untuk dirangkaikan.

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 membagikan kepada pengguna lain atau mengubah izin. Nilai default untuk Folder baru adalah true.

Parameter

NamaJenisDeskripsi
shareableBooleantrue jika pengguna dengan izin edit harus diizinkan untuk membagikan kepada pengguna lain atau mengubah izin; false jika tidak

Pulang pergi

Folder — Folder ini, untuk merangkai

Otorisasi

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

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

setSharing(accessType, permissionType)

Menetapkan kelas pengguna yang dapat mengakses Folder dan izin yang diberikan kepada pengguna tersebut, selain pengguna perorangan 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.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parameter

NamaJenisDeskripsi
accessTypeAccesskelas pengguna mana yang harus dapat mengakses Folder
permissionTypePermissionizin yang harus diberikan kepada pengguna yang dapat mengakses Folder

Pulang pergi

Folder — Folder ini, untuk merangkai

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

NamaJenisDeskripsi
starredBooleantrue jika Folder harus dibintangi di Drive pengguna; false jika tidak

Pulang pergi

Folder — Folder ini, untuk merangkai

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 menghapus Folder. Default untuk Folder baru adalah false.

Parameter

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

Pulang pergi

Folder — Folder ini, untuk merangkai

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