Layanan ini memungkinkan skrip membuat, menemukan, dan mengubah file serta 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 ke dalam log pada folder Drive Saya milik pengguna:// 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 pengguna individu 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 berpotensi besar. |
Folder | Folder di Google Drive. |
FolderIterator | Objek yang memungkinkan skrip melakukan iterasi pada sekumpulan folder yang berpotensi berukuran besar. |
Permission | Enum yang mewakili izin yang diberikan kepada pengguna yang dapat mengakses file atau folder, selain pengguna individual 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 pengguna individu yang telah diberi akses secara eksplisit. |
Permission | Permission | Enum yang mewakili izin yang diberikan kepada pengguna yang dapat mengakses file atau folder, selain pengguna individual 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 tertentu. |
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 diberikan. |
createFolder(name) | Folder | Membuat folder di root Drive pengguna dengan nama yang ditentukan. |
createShortcut(targetId) | File | Membuat pintasan ke ID item Drive yang diberikan, lalu menampilkannya. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Membuat pintasan ke ID item Drive dan kunci resource yang disediakan, lalu menampilkannya. |
enforceSingleParent(value) | void | Mengaktifkan atau menonaktifkan perilaku penerapan SingleParent 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 dalam Drive pengguna. |
getFilesByName(name) | FileIterator | Mendapatkan kumpulan semua file di Drive pengguna yang memiliki nama tertentu. |
getFilesByType(mimeType) | FileIterator | Mendapatkan kumpulan semua file dalam Drive pengguna yang memiliki jenis MIME yang ditentukan. |
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 oleh pengguna di Drive. |
getStorageUsed() | Integer | Mendapatkan jumlah byte yang saat ini disimpan pengguna di Drive. |
getTrashedFiles() | FileIterator | Mendapatkan kumpulan semua file dalam sampah Drive pengguna. |
getTrashedFolders() | FolderIterator | Mendapatkan koleksi semua folder di sampah Drive pengguna. |
searchFiles(params) | FileIterator | Mendapatkan kumpulan semua file di Drive pengguna yang cocok dengan kriteria penelusuran yang ditentukan. |
searchFolders(params) | FolderIterator | Mendapatkan kumpulan semua folder di Drive pengguna yang cocok dengan kriteria penelusuran yang ditentukan. |
File
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addCommenter(emailAddress) | File | Tambahkan pengguna yang ditentukan ke daftar pengomentar untuk File . |
addCommenter(user) | File | Tambahkan pengguna yang ditentukan ke daftar pengomentar untuk File . |
addCommenters(emailAddresses) | File | Tambahkan array pengguna yang diberikan ke daftar pemberi komentar 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 tertentu 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 tertentu ke daftar pelihat untuk File . |
getAccess(email) | Permission | Mendapatkan izin yang diberikan kepada pengguna tertentu. |
getAccess(user) | Permission | Mendapatkan izin yang diberikan kepada 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 koleksi folder yang merupakan induk langsung dari File . |
getResourceKey() | String | Mendapatkan kunci resource File yang diperlukan untuk mengakses item yang telah dibagikan menggunakan link. |
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 link. |
getSharingAccess() | Access | Mendapatkan class pengguna yang dapat mengakses File , selain pengguna
individu mana pun yang telah diberi akses secara eksplisit. |
getSharingPermission() | Permission | Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses File ,
selain setiap pengguna yang telah diberi akses secara eksplisit. |
getSize() | Integer | Mendapatkan jumlah byte yang digunakan untuk menyimpan File di Drive. |
getTargetId() | String | Jika ini adalah Pintasan, tampilkan ID item yang ditunjuk. |
getTargetMimeType() | String | Jika ini adalah Pintasan, menampilkan jenis mime item yang ditunjuk. |
getTargetResourceKey() | String | Jika file berupa pintasan, tampilkan kunci resource item yang ditunjuk olehnya. |
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. |
isStarred() | Boolean | Menentukan apakah File telah diberi bintang di Drive pengguna. |
isTrashed() | Boolean | Menentukan apakah File ada 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 diberikan. |
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 | Menimpa konten file dengan pengganti yang diberikan. |
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 link. |
setShareableByEditors(shareable) | File | Menetapkan apakah pengguna dengan izin edit ke File diizinkan untuk berbagi
dengan pengguna lain atau mengubah izin. |
setSharing(accessType, permissionType) | File | Menetapkan class pengguna yang dapat mengakses File dan izin
yang diberikan kepada pengguna tersebut, selain setiap pengguna yang telah diberi akses secara eksplisit. |
setStarred(starred) | File | Menetapkan apakah File dibintangi 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 kumpulan 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 tertentu 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 tertentu 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 di folder saat ini dengan nama dan konten 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 yang diberikan. |
createShortcut(targetId) | File | Membuat pintasan ke ID item Drive yang diberikan, lalu menampilkannya. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Membuat pintasan ke ID item Drive dan kunci resource yang disediakan, lalu menampilkannya. |
getAccess(email) | Permission | Mendapatkan izin yang diberikan kepada pengguna tertentu. |
getAccess(user) | Permission | Mendapatkan izin yang diberikan kepada pengguna tertentu. |
getDateCreated() | Date | Mendapatkan tanggal Folder dibuat. |
getDescription() | String | Mendapatkan deskripsi untuk Folder . |
getEditors() | User[] | Mendapatkan daftar editor untuk Folder ini. |
getFiles() | FileIterator | Mendapatkan koleksi semua file yang merupakan turunan dari folder saat ini. |
getFilesByName(name) | FileIterator | Mendapatkan 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 koleksi semua folder yang merupakan turunan dari folder saat ini. |
getFoldersByName(name) | FolderIterator | Mendapatkan koleksi semua folder yang merupakan turunan dari folder saat ini dan memiliki nama tertentu. |
getId() | String | Mendapatkan ID Folder . |
getLastUpdated() | Date | Mendapatkan tanggal Folder terakhir diperbarui. |
getName() | String | Mendapatkan nama Folder . |
getOwner() | User | Mendapatkan pemilik Folder ini. |
getParents() | FolderIterator | Mendapatkan koleksi folder yang merupakan induk langsung dari Folder . |
getResourceKey() | String | Mendapatkan kunci resource Folder yang diperlukan untuk mengakses item yang telah dibagikan menggunakan link. |
getSecurityUpdateEligible() | Boolean | Mendapatkan apakah Folder ini memenuhi syarat untuk menerapkan update keamanan yang
memerlukan kunci resource untuk akses saat dibagikan menggunakan link. |
getSecurityUpdateEnabled() | Boolean | Mendapatkan apakah Folder ini memerlukan kunci resource untuk akses saat
dibagikan menggunakan link. |
getSharingAccess() | Access | Mendapatkan class pengguna yang dapat mengakses Folder , selain pengguna
individu mana pun yang telah diberi akses secara eksplisit. |
getSharingPermission() | Permission | Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses Folder ,
selain setiap pengguna yang telah diberi akses secara eksplisit. |
getSize() | Integer | Mendapatkan jumlah byte yang digunakan untuk menyimpan Folder di Drive. |
getUrl() | String | Mendapatkan URL yang dapat digunakan untuk membuka Folder di Aplikasi Google seperti
Drive atau Dokumen. |
getViewers() | User[] | Mendapatkan daftar pelihat dan pengomentar untuk Folder ini. |
isShareableByEditors() | Boolean | Menentukan apakah pengguna dengan izin edit ke Folder diizinkan untuk
berbagi dengan pengguna lain atau mengubah izin. |
isStarred() | Boolean | Menentukan apakah Folder telah diberi bintang di Drive pengguna. |
isTrashed() | Boolean | Menentukan apakah Folder ada di sampah Drive pengguna. |
moveTo(destination) | Folder | Memindahkan item ini ke folder tujuan yang diberikan. |
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 kriteria penelusuran yang ditentukan. |
searchFolders(params) | FolderIterator | Mendapatkan kumpulan semua folder yang merupakan turunan dari folder saat ini dan cocok dengan kriteria penelusuran yang ditentukan. |
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 setiap pengguna yang telah diberi akses secara eksplisit. |
setStarred(starred) | Folder | Menetapkan apakah Folder dibintangi 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 kumpulan 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 mengomentarinya. |
OWNER | Enum | Pengguna adalah pemilik file atau folder. |
ORGANIZER | Enum | Pengguna yang dapat mengelola 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. |