Layanan ini memungkinkan skrip membuat, menemukan, dan mengubah file dan folder di Google Drive.
Jika skrip Anda menggunakan project Cloud standar bukan project Cloud default, Anda harus mengaktifkan Drive API secara manual. Di project Cloud standar, aktifkan Drive API:
Contoh kode berikut menunjukkan cara mencatat nama setiap file di Folder Drive Saya:// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
console.log(file.getName());
}
Class
Nama | Deskripsi singkat |
---|---|
Access | Enum yang mewakili class pengguna yang dapat mengakses file atau folder, selain individu pengguna yang telah diberi akses secara eksplisit. |
DriveApp | Mengizinkan skrip untuk membuat, menemukan, dan mengubah file serta folder di Google Drive. |
File | File di Google Drive. |
FileIterator | Iterator yang memungkinkan skrip melakukan iterasi pada kumpulan file yang mungkin berukuran besar. |
Folder | Folder di Google Drive. |
FolderIterator | Objek yang memungkinkan skrip melakukan iterasi pada kumpulan folder yang mungkin berukuran besar. |
Permission | Enum yang mewakili izin yang diberikan kepada pengguna yang dapat mengakses file atau folder, selain setiap pengguna yang telah diberi akses secara eksplisit. |
User | Pengguna yang terkait dengan file di Google Drive. |
Access
Properti
Properti | Jenis | Deskripsi |
---|---|---|
ANYONE | Enum | Siapa saja di Internet dapat menemukan dan mengakses. |
ANYONE_WITH_LINK | Enum | Siapa saja yang memiliki link dapat mengakses. |
DOMAIN | Enum | Orang di domain Anda dapat menemukan dan mengakses. |
DOMAIN_WITH_LINK | Enum | Orang di domain Anda yang memiliki link dapat mengakses. |
PRIVATE | Enum | Hanya orang yang diberi izin secara tegas yang dapat mengakses. |
DriveApp
Properti
Properti | Jenis | Deskripsi |
---|---|---|
Access | Access | Enum yang mewakili class pengguna yang dapat mengakses file atau folder, selain individu pengguna yang telah diberi akses secara eksplisit. |
Permission | Permission | Enum yang mewakili izin yang diberikan kepada pengguna yang dapat mengakses file atau folder, selain setiap pengguna yang telah diberi akses secara eksplisit. |
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | Melanjutkan iterasi file menggunakan token kelanjutan dari iterator sebelumnya. |
continueFolderIterator(continuationToken) | FolderIterator | Melanjutkan iterasi folder menggunakan token kelanjutan dari iterator sebelumnya. |
createFile(blob) | File | Membuat file di root Drive pengguna dari Blob data arbitrer yang ditentukan. |
createFile(name, content) | File | Membuat file teks di root Drive pengguna dengan nama dan konten yang diberikan. |
createFile(name, content, mimeType) | File | Membuat file di root Drive pengguna dengan nama, konten, dan jenis MIME yang ditetapkan. |
createFolder(name) | Folder | Membuat folder di root Drive pengguna dengan nama yang diberikan. |
createShortcut(targetId) | File | Membuat pintasan ke ID item Drive yang diberikan, dan menampilkannya. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Membuat pintasan ke ID item Drive dan kunci resource yang diberikan, lalu menampilkannya. |
enforceSingleParent(value) | void | Mengaktifkan atau menonaktifkan perilaku penerapanSingleParent untuk semua panggilan yang memengaruhi induk item. |
getFileById(id) | File | Mendapatkan file dengan ID yang diberikan. |
getFileByIdAndResourceKey(id, resourceKey) | File | Mendapatkan file dengan ID dan kunci resource yang diberikan. |
getFiles() | FileIterator | Mendapatkan kumpulan semua file di Drive pengguna. |
getFilesByName(name) | FileIterator | Mendapatkan kumpulan semua file di Drive pengguna yang memiliki nama tertentu. |
getFilesByType(mimeType) | FileIterator | Mendapatkan kumpulan semua file di Drive pengguna yang memiliki jenis MIME tertentu. |
getFolderById(id) | Folder | Mendapatkan folder dengan ID yang diberikan. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | Mendapatkan folder dengan ID dan kunci resource yang diberikan. |
getFolders() | FolderIterator | Mendapatkan kumpulan semua folder di Drive pengguna. |
getFoldersByName(name) | FolderIterator | Mendapatkan kumpulan semua folder di Drive pengguna yang memiliki nama tertentu. |
getRootFolder() | Folder | Mendapatkan folder di root Drive pengguna. |
getStorageLimit() | Integer | Mendapatkan jumlah byte yang diizinkan untuk disimpan pengguna di Drive. |
getStorageUsed() | Integer | Mendapatkan jumlah byte yang saat ini disimpan pengguna di Drive. |
getTrashedFiles() | FileIterator | Mendapatkan kumpulan semua file di sampah Drive pengguna. |
getTrashedFolders() | FolderIterator | Mendapatkan kumpulan semua folder di sampah Drive pengguna. |
searchFiles(params) | FileIterator | Mendapatkan kumpulan semua file di Drive pengguna yang cocok dengan penelusuran yang ditentukan kriteria. |
searchFolders(params) | FolderIterator | Mendapatkan kumpulan semua folder di Drive pengguna yang cocok dengan penelusuran yang ditentukan kriteria. |
File
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addCommenter(emailAddress) | File | Menambahkan pengguna tertentu ke daftar pengomentar untuk File . |
addCommenter(user) | File | Menambahkan pengguna tertentu ke daftar pengomentar untuk File . |
addCommenters(emailAddresses) | File | Tambahkan array pengguna yang diberikan ke daftar pengomentar untuk File . |
addEditor(emailAddress) | File | Menambahkan pengguna tertentu ke daftar editor untuk File . |
addEditor(user) | File | Menambahkan pengguna tertentu ke daftar editor untuk File . |
addEditors(emailAddresses) | File | Menambahkan array pengguna yang diberikan ke daftar editor untuk File . |
addViewer(emailAddress) | File | Menambahkan pengguna tertentu ke daftar pelihat untuk File . |
addViewer(user) | File | Menambahkan pengguna tertentu ke daftar pelihat untuk File . |
addViewers(emailAddresses) | File | Menambahkan array pengguna yang diberikan ke daftar pelihat untuk File . |
getAccess(email) | Permission | Mendapatkan izin yang diberikan ke pengguna tertentu. |
getAccess(user) | Permission | Mendapatkan izin yang diberikan ke pengguna tertentu. |
getAs(contentType) | Blob | Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. |
getBlob() | Blob | Menampilkan data di dalam objek ini sebagai blob. |
getDateCreated() | Date | Mendapatkan tanggal File dibuat. |
getDescription() | String | Mendapatkan deskripsi untuk File . |
getDownloadUrl() | String | Mendapatkan URL yang dapat digunakan untuk mendownload file. |
getEditors() | User[] | Mendapatkan daftar editor untuk File ini. |
getId() | String | Mendapatkan ID File . |
getLastUpdated() | Date | Mendapatkan tanggal File terakhir diperbarui. |
getMimeType() | String | Mendapatkan jenis MIME file. |
getName() | String | Mendapatkan nama File . |
getOwner() | User | Mendapatkan pemilik file. |
getParents() | FolderIterator | Mendapatkan kumpulan folder yang merupakan induk langsung dari File . |
getResourceKey() | String | Mendapatkan kunci resource File yang diperlukan untuk mengakses item yang
telah dibagikan menggunakan tautan. |
getSecurityUpdateEligible() | Boolean | Mendapatkan apakah File ini memenuhi syarat untuk menerapkan update keamanan yang
memerlukan kunci resource untuk akses saat dibagikan menggunakan link. |
getSecurityUpdateEnabled() | Boolean | Mendapatkan apakah File ini memerlukan kunci resource untuk akses saat
dibagikan menggunakan tautan. |
getSharingAccess() | Access | Mendapatkan class pengguna mana yang dapat mengakses File , selain individu mana pun
pengguna yang telah
diberi akses secara eksplisit. |
getSharingPermission() | Permission | Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses File ,
selain pengguna individu yang telah
diberi akses secara eksplisit. |
getSize() | Integer | Mendapatkan jumlah byte yang digunakan untuk menyimpan File di Drive. |
getTargetId() | String | Jika ini adalah Pintasan, akan menampilkan ID item yang dituju oleh ID tersebut. |
getTargetMimeType() | String | Jika ini adalah Pintasan, menampilkan jenis mime item yang ditunjuk. |
getTargetResourceKey() | String | Jika file adalah pintasan, menampilkan kunci resource dari item yang ditunjuk oleh file tersebut. |
getThumbnail() | Blob | Mendapatkan gambar thumbnail untuk file, atau null jika tidak ada thumbnail. |
getUrl() | String | Mendapatkan URL yang dapat digunakan untuk membuka File di Aplikasi Google seperti
Drive atau Dokumen. |
getViewers() | User[] | Mendapatkan daftar pelihat dan pengomentar untuk File ini. |
isShareableByEditors() | Boolean | Menentukan apakah pengguna dengan izin edit ke File diizinkan untuk
berbagi dengan pengguna lain
atau mengubah izin akses. |
isStarred() | Boolean | Menentukan apakah File telah dibintangi di Drive pengguna. |
isTrashed() | Boolean | Menentukan apakah File berada di sampah Drive pengguna. |
makeCopy() | File | Membuat salinan file. |
makeCopy(destination) | File | Membuat salinan file di direktori tujuan. |
makeCopy(name) | File | Membuat salinan file dan memberinya nama dengan nama yang diberikan. |
makeCopy(name, destination) | File | Membuat salinan file di direktori tujuan dan memberinya nama dengan nama yang diberikan. |
moveTo(destination) | File | Memindahkan item ini ke folder tujuan yang disediakan. |
removeCommenter(emailAddress) | File | Menghapus pengguna tertentu dari daftar pengomentar untuk File . |
removeCommenter(user) | File | Menghapus pengguna tertentu dari daftar pengomentar untuk File . |
removeEditor(emailAddress) | File | Menghapus pengguna tertentu dari daftar editor untuk File . |
removeEditor(user) | File | Menghapus pengguna tertentu dari daftar editor untuk File . |
removeViewer(emailAddress) | File | Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk File . |
removeViewer(user) | File | Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk File . |
revokePermissions(emailAddress) | File | Mencabut akses ke File yang diberikan kepada pengguna tertentu. |
revokePermissions(user) | File | Mencabut akses ke File yang diberikan kepada pengguna tertentu. |
setContent(content) | File | Timpa konten file dengan pengganti tertentu. |
setDescription(description) | File | Menetapkan deskripsi untuk File . |
setName(name) | File | Menetapkan nama File . |
setOwner(emailAddress) | File | Mengubah pemilik File . |
setOwner(user) | File | Mengubah pemilik File . |
setSecurityUpdateEnabled(enabled) | File | Menetapkan apakah File memerlukan kunci resource untuk akses saat
dibagikan menggunakan tautan. |
setShareableByEditors(shareable) | File | Menetapkan apakah pengguna dengan izin edit pada File diizinkan untuk berbagi
dengan pengguna lain atau
mengubah izin akses. |
setSharing(accessType, permissionType) | File | Menetapkan class pengguna yang dapat mengakses File dan izin apa
pengguna tersebut diberikan, selain pengguna
individu yang telah diberi akses secara eksplisit. |
setStarred(starred) | File | Menetapkan apakah File diberi bintang di Drive pengguna. |
setTrashed(trashed) | File | Menetapkan apakah File berada di sampah Drive pengguna. |
FileIterator
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getContinuationToken() | String | Mendapatkan token yang dapat digunakan untuk melanjutkan iterasi ini di lain waktu. |
hasNext() | Boolean | Menentukan apakah memanggil next() akan menampilkan item. |
next() | File | Mendapatkan item berikutnya dalam koleksi file atau folder. |
Folder
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 tertentu ke daftar pelihat untuk Folder . |
addViewer(user) | Folder | Menambahkan pengguna tertentu ke daftar pelihat untuk Folder . |
addViewers(emailAddresses) | Folder | Menambahkan array pengguna yang diberikan ke daftar pelihat untuk Folder . |
createFile(blob) | File | Membuat file dalam folder saat ini dari Blob data arbitrer tertentu. |
createFile(name, content) | File | Membuat file teks dalam folder saat ini dengan nama dan isi yang diberikan. |
createFile(name, content, mimeType) | File | Membuat file dalam folder saat ini dengan nama, konten, dan jenis MIME yang diberikan. |
createFolder(name) | Folder | Membuat folder di folder saat ini dengan nama tertentu. |
createShortcut(targetId) | File | Membuat pintasan ke ID item Drive yang diberikan, dan menampilkannya. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Membuat pintasan ke ID item Drive dan kunci resource yang diberikan, lalu menampilkannya. |
getAccess(email) | Permission | Mendapatkan izin yang diberikan ke pengguna tertentu. |
getAccess(user) | Permission | Mendapatkan izin yang diberikan ke pengguna tertentu. |
getDateCreated() | Date | Mendapatkan tanggal Folder dibuat. |
getDescription() | String | Mendapatkan deskripsi untuk Folder . |
getEditors() | User[] | Mendapatkan daftar editor untuk Folder ini. |
getFiles() | FileIterator | Mendapatkan 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 tertentu. |
getFilesByType(mimeType) | FileIterator | Mendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki jenis MIME yang ditentukan. |
getFolders() | FolderIterator | Mendapatkan kumpulan 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 tertentu. |
getId() | String | Mendapatkan ID Folder . |
getLastUpdated() | Date | Mendapatkan tanggal Folder terakhir diperbarui. |
getName() | String | Mendapatkan nama Folder . |
getOwner() | User | Mendapatkan pemilik Folder ini. |
getParents() | FolderIterator | Mendapatkan kumpulan folder yang merupakan induk langsung dari Folder . |
getResourceKey() | String | Mendapatkan kunci resource Folder yang diperlukan untuk mengakses item yang
telah dibagikan menggunakan tautan. |
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 tautan. |
getSharingAccess() | Access | Mendapatkan class pengguna mana yang dapat mengakses Folder , selain individu mana pun
pengguna 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
berbagi dengan pengguna lain
atau mengubah izin akses. |
isStarred() | Boolean | Menentukan apakah Folder telah dibintangi di Drive pengguna. |
isTrashed() | Boolean | Menentukan apakah Folder berada 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 pelihat dan pengomentar untuk Folder . |
removeViewer(user) | Folder | Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Folder . |
revokePermissions(emailAddress) | Folder | Mencabut akses ke Folder yang diberikan kepada pengguna tertentu. |
revokePermissions(user) | Folder | Mencabut akses ke Folder yang diberikan kepada pengguna tertentu. |
searchFiles(params) | FileIterator | Mendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini dan cocok dengan penelusuran yang diberikan kriteria. |
searchFolders(params) | FolderIterator | Mendapatkan kumpulan semua folder yang merupakan turunan dari folder saat ini dan cocok dengan penelusuran yang diberikan kriteria. |
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 tautan. |
setShareableByEditors(shareable) | Folder | Menetapkan apakah pengguna dengan izin edit pada Folder diizinkan untuk berbagi
dengan pengguna lain atau
mengubah izin akses. |
setSharing(accessType, permissionType) | Folder | Menetapkan class pengguna yang dapat mengakses Folder dan izin apa
pengguna tersebut diberikan, 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 berada di sampah Drive pengguna. |
FolderIterator
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getContinuationToken() | String | Mendapatkan token yang dapat digunakan untuk melanjutkan iterasi ini di lain waktu. |
hasNext() | Boolean | Menentukan apakah memanggil next() akan menampilkan item. |
next() | Folder | Mendapatkan item berikutnya dalam koleksi file atau folder. |
Permission
Properti
Properti | Jenis | Deskripsi |
---|---|---|
VIEW | Enum | Pengguna yang dapat mengakses file atau folder hanya dapat melihat atau menyalinnya. |
EDIT | Enum | Pengguna yang dapat mengakses file atau folder dapat mengeditnya. |
COMMENT | Enum | Pengguna yang dapat mengakses file atau folder hanya dapat melihat, menyalin, atau mengomentari file atau folder tersebut. |
OWNER | Enum | Pengguna adalah pemilik file atau folder. |
ORGANIZER | Enum | Pengguna yang dapat mengatur file dan folder dalam drive bersama. |
FILE_ORGANIZER | Enum | Pengguna yang dapat mengedit, memindahkan ke sampah, dan memindahkan konten dalam drive bersama. |
NONE | Enum | Pengguna tidak memiliki izin apa pun untuk file atau folder. |
User
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getDomain() | String | Mendapatkan nama domain yang terkait dengan akun pengguna. |
getEmail() | String | Mendapatkan alamat email pengguna. |
getName() | String | Mendapatkan nama pengguna. |
getPhotoUrl() | String | Mendapatkan URL untuk foto pengguna. |