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 dalam folder My Drive 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 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 kumpulan folder yang berpotensi besar. |
Permission | Enum yang mewakili izin yang diberikan kepada pengguna yang dapat mengakses file atau folder, selain setiap pengguna individu 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 setiap pengguna individu yang telah diberi akses secara eksplisit. |
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | Melanjutkan iterasi file menggunakan token lanjutan dari iterator sebelumnya. |
continueFolderIterator(continuationToken) | FolderIterator | Melanjutkan iterasi folder menggunakan token lanjutan 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 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. |
enforceSingleParent(value) | void | Mengaktifkan atau menonaktifkan perilaku enforceSingleParent 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 koleksi semua file di Drive pengguna. |
getFilesByName(name) | FileIterator | Mendapatkan koleksi semua file di Drive pengguna yang memiliki nama yang diberikan. |
getFilesByType(mimeType) | FileIterator | Mendapatkan koleksi semua file di Drive pengguna yang memiliki jenis MIME yang diberikan. |
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 yang diberikan. |
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 kriteria penelusuran yang diberikan. |
searchFolders(params) | FolderIterator | Mendapatkan kumpulan semua folder di Drive pengguna yang cocok dengan kriteria penelusuran yang diberikan. |
File
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addCommenter(emailAddress) | File | Tambahkan pengguna yang diberikan ke daftar pemberi komentar untuk File . |
addCommenter(user) | File | Tambahkan pengguna yang diberikan ke daftar pemberi komentar 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 yang diberikan ke daftar editor untuk File . |
addViewer(emailAddress) | File | Menambahkan pengguna yang diberikan ke daftar penonton untuk File . |
addViewer(user) | File | Menambahkan pengguna yang diberikan ke daftar penonton untuk File . |
addViewers(emailAddresses) | File | Menambahkan array pengguna yang diberikan ke daftar penonton 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 pembuatan File . |
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 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 individual
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, tampilkan ID item yang ditunjuknya. |
getTargetMimeType() | String | Jika ini adalah Pintasan, tampilkan jenis mime item yang ditunjuknya. |
getTargetResourceKey() | String | Jika file adalah pintasan, menampilkan kunci resource item yang ditunjuknya. |
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
membagikan 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 memberi nama dengan nama yang diberikan. |
makeCopy(name, destination) | File | Membuat salinan file di direktori tujuan dan menamainya dengan nama yang diberikan. |
moveTo(destination) | File | Memindahkan item ini ke folder tujuan yang disediakan. |
removeCommenter(emailAddress) | File | Menghapus pengguna tertentu dari daftar pemberi komentar untuk File . |
removeCommenter(user) | File | Menghapus pengguna tertentu dari daftar pemberi komentar 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 penonton dan pemberi komentar untuk File . |
removeViewer(user) | File | Menghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk File . |
revokePermissions(emailAddress) | File | Membatalkan akses ke File yang diberikan kepada pengguna tertentu. |
revokePermissions(user) | File | Membatalkan akses ke File yang diberikan kepada pengguna tertentu. |
setContent(content) | File | Menimpa konten file dengan penggantian 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 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 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 ada 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 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 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 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 kumpulan 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. |
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 memberi komentar pada file atau folder tersebut. |
OWNER | Enum | Pengguna memiliki file atau folder tersebut. |
ORGANIZER | Enum | Pengguna yang dapat mengatur file dan folder dalam drive bersama. |
FILE_ORGANIZER | Enum | Pengguna yang dapat mengedit, menghapus, 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. |