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
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 diberikan ke daftar editor untuk Folder . |
addViewer(emailAddress) | Folder | Menambahkan pengguna yang diberikan ke daftar penonton untuk Folder . |
addViewer(user) | Folder | Menambahkan pengguna yang diberikan ke daftar penonton untuk Folder . |
addViewers(emailAddresses) | Folder | Menambahkan array pengguna yang diberikan ke daftar penonton 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 konten yang diberikan. |
createFile(name, content, mimeType) | File | Membuat file di folder saat ini dengan nama, konten, dan jenis MIME yang diberikan. |
createFolder(name) | Folder | Membuat folder di folder saat ini dengan nama yang diberikan. |
createShortcut(targetId) | File | Membuat pintasan ke ID item Drive yang disediakan, dan menampilkannya. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Membuat pintasan ke ID item Drive dan kunci resource yang diberikan, 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 pembuatan Folder . |
getDescription() | String | Mendapatkan deskripsi untuk Folder . |
getEditors() | User[] | Mendapatkan daftar editor untuk Folder ini. |
getFiles() | FileIterator | Mendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini. |
getFilesByName(name) | FileIterator | Mendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki nama yang diberikan. |
getFilesByType(mimeType) | FileIterator | Mendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki jenis MIME yang diberikan. |
getFolders() | FolderIterator | Mendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini. |
getFoldersByName(name) | FolderIterator | Mendapatkan kumpulan semua folder yang merupakan turunan dari folder saat ini dan memiliki nama yang diberikan. |
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 kumpulan folder yang merupakan induk langsung 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 yang dapat mengakses Folder , selain pengguna
individual yang telah diberi akses secara eksplisit. |
getSharingPermission() | Permission | Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses Folder ,
selain pengguna individu 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
membagikan 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 tertentu dari daftar editor untuk Folder . |
removeEditor(user) | Folder | Menghapus pengguna tertentu dari daftar editor untuk Folder . |
removeViewer(emailAddress) | Folder | Menghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk Folder . |
removeViewer(user) | Folder | Menghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk Folder . |
revokePermissions(emailAddress) | Folder | Membatalkan akses ke Folder yang diberikan kepada pengguna tertentu. |
revokePermissions(user) | Folder | Membatalkan 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 kumpulan 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 akses 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 pengguna individu 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. |
Dokumentasi mendetail
addEditor(emailAddress)
Menambahkan pengguna tertentu ke daftar editor untuk Folder
. Jika pengguna sudah
ada dalam daftar penonton, metode ini akan mempromosikan pengguna dari daftar penonton.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan ditambahkan. |
Pulang pergi
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 penonton, metode ini akan mempromosikan pengguna dari daftar penonton.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan ditambahkan. |
Pulang pergi
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 diberikan ke daftar editor untuk Folder
. Jika ada pengguna yang sudah ada dalam daftar penonton, metode ini akan mempromosikan mereka dari daftar penonton.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddresses | String[] | Array alamat email pengguna yang akan ditambahkan. |
Pulang pergi
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 yang diberikan ke daftar penonton untuk Folder
. Jika pengguna sudah
ada dalam daftar editor, metode ini tidak akan berpengaruh.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan ditambahkan. |
Pulang pergi
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 yang diberikan ke daftar penonton untuk Folder
. Jika pengguna sudah
ada dalam daftar editor, metode ini tidak akan berpengaruh.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan ditambahkan. |
Pulang pergi
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 diberikan ke daftar penonton untuk Folder
. Jika salah satu pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh bagi mereka.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddresses | String[] | Array alamat email pengguna yang akan ditambahkan. |
Pulang pergi
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.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
blob | BlobSource | Data 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 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 | Jenis | Deskripsi |
---|---|---|
name | String | Nama file baru. |
content | String | Konten 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
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama file baru. |
content | String | Konten untuk file baru. |
mimeType | String | Jenis 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)
createShortcut(targetId)
Membuat pintasan ke ID item Drive yang disediakan, dan menampilkannya.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
targetId | String | ID 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
Nama | Jenis | Deskripsi |
---|---|---|
targetId | String | ID file atau folder target. |
targetResourceKey | String | Kunci 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 pengembalian izin untuk Google Grup atau izin yang diwarisi melalui Google Grup.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
email | String | Alamat 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 pengembalian izin untuk Google Grup atau izin yang diwarisi melalui Google Grup.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi 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()
getDescription()
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
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama 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 yang diberikan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
mimeType | String | Jenis 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 koleksi 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
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama 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()
getLastUpdated()
getName()
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
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 Folder
.
Pulang pergi
FolderIterator
— kumpulan folder yang merupakan induk langsung 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 merupakan bagian dari update keamanan. Pembaruan 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 class pengguna yang dapat mengakses Folder
, selain pengguna individual
yang telah diberi akses secara eksplisit.
Pulang pergi
Access
— class 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
getSharingPermission()
Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses Folder
,
selain pengguna individu 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 sehingga 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
isStarred()
Menentukan apakah Folder
telah diberi bintang 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 disediakan.
Pengguna saat ini harus menjadi pemilik file atau setidaknya memiliki akses edit ke folder induk item saat ini untuk memindahkan item ke folder tujuan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
destination | Folder | Folder yang menjadi induk baru. |
Pulang pergi
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 tertentu dari daftar editor untuk Folder
. Metode ini tidak
memblokir pengguna agar tidak 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, tindakan ini juga akan menghapus pengguna dari daftar pelihat.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan dihapus. |
Pulang pergi
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)
Menghapus pengguna tertentu dari daftar editor untuk Folder
. Metode ini tidak
memblokir pengguna agar tidak 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, tindakan ini juga akan menghapus pengguna dari daftar pelihat.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan dihapus. |
Pulang pergi
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 penonton dan pemberi komentar untuk Folder
. Metode
ini tidak berpengaruh jika pengguna adalah editor, bukan penonton 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 ke 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
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan dihapus. |
Pulang pergi
Folder
— Folder
ini untuk pengaitan.
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 penonton. Metode ini juga tidak memblokir
pengguna agar tidak mengakses Folder
jika mereka termasuk dalam kelas 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, tindakan ini juga akan menghapus pengguna dari daftar editor.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan dihapus. |
Pulang pergi
Folder
— Folder
ini untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
Membatalkan akses ke Folder
yang diberikan kepada pengguna tertentu. Metode ini tidak
memblokir pengguna agar tidak mengakses Folder
jika mereka termasuk dalam kelas pengguna yang
memiliki akses umum — misalnya, jika Folder
dibagikan ke seluruh domain
pengguna.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang aksesnya harus dicabut. |
Pulang pergi
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)
Membatalkan akses ke Folder
yang diberikan kepada pengguna tertentu. Metode ini tidak
memblokir pengguna agar tidak mengakses Folder
jika mereka termasuk dalam kelas pengguna yang
memiliki akses umum — misalnya, jika Folder
dibagikan ke seluruh domain
pengguna.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang aksesnya harus dicabut. |
Pulang pergi
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 dijelaskan dalam dokumentasi Google Drive SDK. 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 berhati-hatilah
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."" 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
Nama | Jenis | Deskripsi |
---|---|---|
params | String | Kriteria 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 dalam dokumentasi Google Drive SDK. 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 berhati-hatilah
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. const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners'); while (folders.hasNext()) { const folder = folders.next(); console.log(folder.getName()); }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
params | String | Kriteria 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
Nama | Jenis | Deskripsi |
---|---|---|
description | String | deskripsi baru untuk Folder |
Pulang pergi
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
setName(name)
setOwner(emailAddress)
Mengubah pemilik Folder
. Metode ini juga memberi pemilik sebelumnya
akses edit eksplisit ke Folder
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | alamat email pengguna yang akan menjadi pemilik baru |
Pulang pergi
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
setOwner(user)
Mengubah pemilik Folder
. Metode ini juga memberi pemilik sebelumnya
akses edit eksplisit ke Folder
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | representasi pengguna yang akan menjadi pemilik baru |
Pulang pergi
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
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
Nama | Jenis | Deskripsi |
---|---|---|
enabled | Boolean | Apakah akan mengaktifkan persyaratan kunci resource untuk Folder . |
Pulang pergi
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
setSharing(accessType, permissionType)
Menetapkan class pengguna yang dapat mengakses Folder
dan izin
yang diberikan kepada pengguna tersebut, selain pengguna individu 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
Nama | Jenis | Deskripsi |
---|---|---|
accessType | Access | class pengguna yang dapat mengakses Folder |
permissionType | Permission | izin yang harus diberikan kepada pengguna yang dapat mengakses Folder |
Pulang pergi
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
setStarred(starred)
Menetapkan apakah Folder
diberi bintang di Drive pengguna. Default untuk
Folder
baru adalah false
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
starred | Boolean | true jika Folder harus diberi bintang di Drive
pengguna; false jika tidak |
Pulang pergi
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
setTrashed(trashed)
Menetapkan apakah Folder
ada di sampah Drive pengguna. Hanya pemilik yang dapat menghapus Folder
. Default untuk Folder
baru adalah false
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
trashed | Boolean | true jika Folder harus dipindahkan ke sampah Drive pengguna; false jika tidak |
Pulang pergi
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