File di Google Drive. File dapat diakses atau dibuat dari Drive.
// Trash every untitled spreadsheet that hasn't been updated in a week. const files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { const file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
|---|---|---|
add | File | Tambahkan pengguna tertentu ke daftar pemberi komentar untuk File. |
add | File | Tambahkan pengguna tertentu ke daftar pemberi komentar untuk File. |
add | File | Tambahkan array pengguna tertentu ke daftar pemberi komentar untuk File. |
add | File | Menambahkan pengguna tertentu ke daftar editor untuk File. |
add | File | Menambahkan pengguna tertentu ke daftar editor untuk File. |
add | File | Menambahkan array pengguna tertentu ke daftar editor untuk File. |
add | File | Menambahkan pengguna tertentu ke daftar penonton untuk File. |
add | File | Menambahkan pengguna tertentu ke daftar penonton untuk File. |
add | File | Menambahkan array pengguna tertentu ke daftar penonton untuk File. |
get | Permission | Mendapatkan izin yang diberikan kepada pengguna tertentu. |
get | Permission | Mendapatkan izin yang diberikan kepada pengguna tertentu. |
get | Blob | Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. |
get | Blob | Menampilkan data di dalam objek ini sebagai blob. |
get | Date | Mendapatkan tanggal pembuatan File. |
get | String | Mendapatkan deskripsi untuk File. |
get | String | Mendapatkan URL yang dapat digunakan untuk mendownload file. |
get | User[] | Mendapatkan daftar editor untuk File ini. |
get | String | Mendapatkan ID File. |
get | Date | Mendapatkan tanggal terakhir File diperbarui. |
get | String | Mendapatkan jenis MIME file. |
get | String | Mendapatkan nama File. |
get | User | Mendapatkan pemilik file. |
get | Folder | Mendapatkan kumpulan folder yang merupakan induk langsung dari File. |
get | String | Mendapatkan kunci resource File yang diperlukan untuk mengakses item yang telah dibagikan menggunakan link. |
get | Boolean | Mendapatkan apakah File ini memenuhi syarat untuk menerapkan update keamanan yang memerlukan kunci resource untuk akses saat dibagikan menggunakan link. |
get | Boolean | Mendapatkan apakah File ini memerlukan kunci resource untuk akses saat dibagikan menggunakan link. |
get | Access | Mendapatkan kelas pengguna yang dapat mengakses File, selain pengguna perorangan yang telah diberi akses secara eksplisit. |
get | Permission | Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses File, selain pengguna perorangan yang telah diberi akses secara eksplisit. |
get | Integer | Mendapatkan jumlah byte yang digunakan untuk menyimpan File di Drive. |
get | String | Jika ini adalah Pintasan, menampilkan ID item yang ditujuknya. |
get | String | Jika ini adalah Pintasan, menampilkan jenis MIME item yang ditujuknya. |
get | String | Jika file adalah pintasan, akan menampilkan kunci resource item yang ditujuknya. |
get | Blob|null | Mendapatkan gambar thumbnail untuk file, atau null jika tidak ada thumbnail. |
get | String | Mendapatkan URL yang dapat digunakan untuk membuka File di Aplikasi Google seperti
Drive atau Dokumen. |
get | User[] | Mendapatkan daftar pelihat dan pengomentar untuk File ini. |
is | Boolean | Menentukan apakah pengguna dengan izin edit ke File diizinkan untuk
membagikan kepada pengguna lain atau mengubah izin. |
is | Boolean | Menentukan apakah File telah dibintangi di Drive pengguna. |
is | Boolean | Menentukan apakah File ada di sampah Drive pengguna. |
make | File | Membuat salinan file. |
make | File | Membuat salinan file di direktori tujuan. |
make | File | Membuat salinan file dan menamainya dengan nama yang diberikan. |
make | File | Membuat salinan file di direktori tujuan dan menamainya dengan nama yang diberikan. |
move | File | Memindahkan item ini ke folder tujuan yang ditentukan. |
remove | File | Menghapus pengguna tertentu dari daftar pemberi komentar untuk File. |
remove | File | Menghapus pengguna tertentu dari daftar pemberi komentar untuk File. |
remove | File | Menghapus pengguna tertentu dari daftar editor untuk File. |
remove | File | Menghapus pengguna tertentu dari daftar editor untuk File. |
remove | File | Menghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk File. |
remove | File | Menghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk File. |
revoke | File | Mencabut akses ke File yang diberikan kepada pengguna tertentu. |
revoke | File | Mencabut akses ke File yang diberikan kepada pengguna tertentu. |
set | File | Menimpa konten file dengan penggantian tertentu. |
set | File | Menetapkan deskripsi untuk File. |
set | File | Menetapkan nama File. |
set | File | Mengubah pemilik File. |
set | File | Mengubah pemilik File. |
set | File | Menetapkan apakah File memerlukan kunci resource untuk akses saat dibagikan menggunakan link. |
set | File | Menetapkan apakah pengguna dengan izin edit ke File diizinkan untuk membagikan
kepada pengguna lain atau mengubah izin. |
set | File | Menetapkan kelas pengguna yang dapat mengakses File dan izin yang diberikan kepada pengguna tersebut, selain pengguna perorangan yang telah diberi akses secara eksplisit. |
set | File | Menetapkan apakah File diberi bintang di Drive pengguna. |
set | File | Menetapkan apakah File ada di sampah Drive pengguna. |
Dokumentasi mendetail
add Commenter(emailAddress)
Tambahkan pengguna tertentu ke daftar pemberi komentar untuk File. Jika pengguna sudah ada dalam daftar pelihat, metode ini akan mempromosikan pengguna keluar dari daftar pelihat.
const files = DriveApp.getFilesByName('Test'); // Loops through the files while (files.hasNext()) { const file = files.next(); file.addCommenter('hello@example.com'); }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String | Alamat email pengguna yang akan ditambahkan. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
add Commenter(user)
Tambahkan pengguna tertentu ke daftar pemberi komentar untuk File. Jika pengguna sudah ada dalam daftar pelihat, metode ini akan mempromosikan pengguna keluar dari daftar pelihat.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Adds the active user as a commenter. while (files.hasNext()) { const file = files.next(); file.addCommenter(Session.getActiveUser()); }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
user | User | Representasi pengguna yang akan ditambahkan. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
add Commenters(emailAddresses)
Tambahkan array pengguna tertentu ke daftar pemberi komentar untuk File. Jika ada pengguna yang sudah berada dalam daftar pelihat, metode ini akan mempromosikan mereka keluar dari daftar pelihat.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); while (files.hasNext()) { const file = files.next(); // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and // 'baklavainthebalkans@gmail.com' with the email addresses to add as // commenters. const emails = [ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]; console.log(file.addCommenters(emails)); }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String[] | Array alamat email pengguna yang akan ditambahkan. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
add Editor(emailAddress)
Menambahkan pengguna tertentu ke daftar editor untuk File. Jika pengguna sudah ada dalam daftar penonton, metode ini akan mempromosikan pengguna keluar dari daftar penonton.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String | Alamat email pengguna yang akan ditambahkan. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
add Editor(user)
Menambahkan pengguna tertentu ke daftar editor untuk File. Jika pengguna sudah ada dalam daftar penonton, metode ini akan mempromosikan pengguna keluar dari daftar penonton.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
user | User | Representasi pengguna yang akan ditambahkan. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
add Editors(emailAddresses)
Menambahkan array pengguna tertentu ke daftar editor untuk File. Jika salah satu pengguna sudah ada dalam daftar pelihat, metode ini akan mempromosikannya keluar dari daftar pelihat.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String[] | Array alamat email pengguna yang akan ditambahkan. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
add Viewer(emailAddress)
Menambahkan pengguna tertentu ke daftar penonton untuk File. Jika pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String | Alamat email pengguna yang akan ditambahkan. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
add Viewer(user)
Menambahkan pengguna tertentu ke daftar penonton untuk File. 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
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
add Viewers(emailAddresses)
Menambahkan array pengguna tertentu ke daftar penonton untuk File. Jika salah satu pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh bagi mereka.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String[] | Array alamat email pengguna yang akan ditambahkan. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
get Access(email)
Mendapatkan izin yang diberikan kepada pengguna tertentu. Metode ini tidak mendukung menampilkan izin untuk Google Grup atau izin yang diwarisi melalui Google Grup.
Parameter
| 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
get Access(user)
Mendapatkan izin yang diberikan kepada pengguna tertentu. Metode ini tidak mendukung menampilkan izin untuk Google Grup atau izin yang diwarisi melalui Google Grup.
Parameter
| 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
get As(contentType)
Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Metode ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, fungsi ini mengasumsikan bahwa bagian nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang ada dan harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".
Untuk melihat kuota harian konversi, lihat Kuota untuk Layanan Google. Domain Google Workspace yang baru dibuat mungkin tunduk pada kuota yang lebih ketat untuk sementara.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
content | String | Jenis MIME yang akan dikonversi. Untuk sebagian besar blob, 'application/pdf' adalah
satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, salah satu dari 'image/bmp', 'image/gif', 'image/jpeg', atau 'image/png' juga valid. Untuk dokumen Google Dokumen, 'text/markdown' juga valid. |
Pulang pergi
Blob — Data sebagai blob.
get Blob()
get Date Created()
get Description()
get Download Url()
Mendapatkan URL yang dapat digunakan untuk mendownload file. Hanya pengguna yang memiliki izin untuk membuka file di Google Drive yang dapat mengakses URL. Anda dapat menggunakan URL ini di browser untuk mendownload file, tetapi Anda tidak dapat menggunakannya untuk mengambil file dengan Url. Jika Anda ingin konten
file dalam skrip, gunakan get.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the download URLs to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getDownloadUrl()); }
Pulang pergi
String — URL yang dapat digunakan untuk mendownload file.
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
get Editors()
Mendapatkan daftar editor untuk File ini. Jika pengguna yang menjalankan skrip
tidak memiliki akses edit ke File, metode ini akan menampilkan array kosong.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Adds the email addresses in the array as editors of each file. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' // and 'baklavainthebalkans@gmail.com' with valid email addresses. file.addEditors([ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]); // Gets a list of the file editors. const editors = file.getEditors(); // For each file, logs the editors' email addresses to the console. for (const editor of editors) { console.log(editor.getEmail()); } }
Pulang pergi
User[] — Jika pengguna memiliki akses edit untuk File ini, menampilkan daftar editor. Jika pengguna tidak memiliki akses edit, akan menampilkan array kosong.
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
get Id()
get Last Updated()
get Mime Type()
Mendapatkan jenis MIME file.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the MIME type to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getMimeType()); }
Pulang pergi
String — Jenis MIME file.
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
get Name()
get Owner()
Mendapatkan pemilik file.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the names of the file owners to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getOwner().getName()); }
Pulang pergi
User — Pemilik file.
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
get Parents()
Mendapatkan kumpulan folder yang merupakan induk langsung dari File.
Pulang pergi
Folder — kumpulan folder yang merupakan induk langsung dari File
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
get Resource Key()
Mendapatkan kunci resource File yang diperlukan untuk mengakses item yang telah dibagikan menggunakan link.
Pulang pergi
String — Kunci resource File.
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
get Security Update Eligible()
Mendapatkan apakah File ini memenuhi syarat untuk menerapkan update keamanan yang memerlukan kunci resource untuk akses saat dibagikan menggunakan link.
Drive memerlukan kunci resource untuk mengakses beberapa file atau folder yang telah dibagikan menggunakan link. Perubahan ini adalah bagian dari update keamanan. Update ini diaktifkan secara default untuk file dan folder yang memenuhi syarat. Untuk mengaktifkan atau menonaktifkan persyaratan kunci resource untuk file yang memenuhi syarat, gunakan
set.
Pelajari lebih lanjut Update keamanan untuk Google Drive.
Pulang pergi
Boolean — Apakah persyaratan kunci resource dapat diterapkan untuk File.
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
get Security Update Enabled()
Mendapatkan apakah File 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 File 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
get Sharing Access()
Mendapatkan kelas pengguna yang dapat mengakses File, selain pengguna perorangan yang telah diberi akses secara eksplisit.
Pulang pergi
Access — kelas pengguna mana yang dapat mengakses File
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
get Sharing Permission()
Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses File, selain pengguna perorangan yang telah diberi akses secara eksplisit.
Pulang pergi
Permission — izin yang diberikan kepada pengguna yang dapat mengakses File
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
get Size()
Mendapatkan jumlah byte yang digunakan untuk menyimpan File di Drive. Perhatikan bahwa
file aplikasi Google Workspace tidak mengurangi batas penyimpanan Drive dan dengan demikian menampilkan
0 byte.
Pulang pergi
Integer — jumlah byte yang digunakan untuk menyimpan File 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
get Target Id()
Jika ini adalah Pintasan, menampilkan ID item yang ditujuknya.
Jika tidak, null akan ditampilkan.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the target ID of the shortcut. console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);
Pulang pergi
String — ID item target.
get Target Mime Type()
Jika ini adalah Pintasan, menampilkan jenis MIME item yang ditujuknya.
Jika tidak, null akan ditampilkan.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
Pulang pergi
String — Jenis MIME item target.
get Target Resource Key()
Jika file adalah pintasan, menampilkan kunci resource item yang ditujuknya. Kunci resource adalah parameter tambahan yang perlu Anda teruskan untuk mengakses file yang telah dibagikan menggunakan link.
Jika file bukan pintasan, null akan ditampilkan.
// Gets a file by its ID. // TODO(developer): Replace 'abc123456' with your file ID. const file = DriveApp.getFileById('abc123456'); // If the file is a shortcut, returns the resource key of the file that it // points to. console.log(file.getTargetResourceKey());
Pulang pergi
String — Kunci resource item target atau null jika file bukan pintasan.
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
get Thumbnail()
Mendapatkan gambar thumbnail untuk file, atau null jika tidak ada thumbnail.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Logs the thumbnail image for each file to the console as a blob, // or null if no thumbnail exists. console.log(file.getThumbnail()); }
Pulang pergi
Blob|null — Gambar thumbnail untuk file.
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
get Url()
Mendapatkan URL yang dapat digunakan untuk membuka File di Aplikasi Google seperti
Drive atau Dokumen.
Pulang pergi
String — URL yang dapat digunakan untuk melihat File 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
get Viewers()
Mendapatkan daftar pelihat dan pengomentar untuk File ini. Jika pengguna yang
menjalankan skrip tidak memiliki akses edit ke File, metode ini
akan menampilkan array kosong.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // For each file, logs the viewers' email addresses to the console. const viewers = file.getViewers(); for (const viewer of viewers) { console.log(viewer.getEmail()); } }
Pulang pergi
User[] — Jika pengguna memiliki akses edit untuk File ini, akan menampilkan daftar
pelihat dan pemberi komentar. Jika pengguna tidak memiliki akses edit, akan menampilkan array kosong.
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
is Starred()
Menentukan apakah File telah dibintangi di Drive pengguna.
Pulang pergi
Boolean — true jika File 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
is Trashed()
Menentukan apakah File ada di sampah Drive pengguna.
Pulang pergi
Boolean — true jika File 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
make Copy()
Membuat salinan file.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and logs the file name to the console. console.log(file.makeCopy().getName()); }
Pulang pergi
File — Salinan baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
make Copy(destination)
Membuat salinan file di direktori tujuan.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and adds it to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy(destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
destination | Folder | Direktori tempat file akan disalin. |
Pulang pergi
File — Salinan baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
make Copy(name)
Membuat salinan file dan menamainya dengan nama yang diberikan.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and sets the name to 'Test-Copy.' const filename = file.makeCopy('Test-Copy'); // Logs the copied file's name to the console. console.log(filename.getName()); }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
name | String | Nama file yang akan diterapkan ke salinan baru. |
Pulang pergi
File — Salinan baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
make Copy(name, destination)
Membuat salinan file di direktori tujuan dan menamainya dengan nama yang diberikan.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file, sets the file name, and adds the copied file // to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy('Test-Copy', destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
name | String | Nama file yang akan diterapkan ke salinan baru. |
destination | Folder | Direktori tempat file akan disalin. |
Pulang pergi
File — Salinan baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
move To(destination)
Memindahkan item ini ke folder tujuan yang ditentukan.
Pengguna saat ini harus menjadi pemilik file atau memiliki akses edit ke folder induk saat ini dari item agar dapat memindahkan item ke folder tujuan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
destination | Folder | Folder yang menjadi induk baru. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
remove Commenter(emailAddress)
Menghapus pengguna tertentu dari daftar pemberi komentar untuk File. Metode ini tidak memblokir akses pengguna ke File jika mereka termasuk dalam kelas pengguna yang memiliki akses umum — misalnya, jika File dibagikan dengan seluruh domain pengguna.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. // TODO(developer): Replace the email with the email of the user you want to // remove. file.removeCommenter('cloudysanfrancisco@gmail.com'); }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String | Alamat email pengguna yang akan dihapus. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
remove Commenter(user)
Menghapus pengguna tertentu dari daftar pemberi komentar untuk File. Metode ini tidak memblokir akses pengguna ke File jika mereka termasuk dalam kelas pengguna yang memiliki akses umum — misalnya, jika File dibagikan dengan seluruh domain pengguna.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. console.log(file.removeCommenter(Session.getActiveUser())); }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
user | User | Representasi pengguna yang akan dihapus. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
remove Editor(emailAddress)
Menghapus pengguna tertentu dari daftar editor untuk File. Metode ini tidak
memblokir pengguna mengakses File jika mereka termasuk dalam kelas pengguna yang memiliki
akses umum—misalnya, jika File dibagikan dengan seluruh
domain pengguna, atau jika File berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, tindakan ini juga menghapus pengguna dari daftar pelihat.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String | Alamat email pengguna yang akan dihapus. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
remove Editor(user)
Menghapus pengguna tertentu dari daftar editor untuk File. Metode ini tidak
memblokir pengguna mengakses File jika mereka termasuk dalam kelas pengguna yang memiliki
akses umum—misalnya, jika File dibagikan dengan seluruh
domain pengguna, atau jika File berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, tindakan ini juga menghapus pengguna dari daftar pelihat.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
user | User | Representasi pengguna yang akan dihapus. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
remove Viewer(emailAddress)
Menghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk File. Metode ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat atau pemberi komentar. Metode ini juga tidak memblokir pengguna mengakses File jika mereka termasuk dalam kelas pengguna yang memiliki akses umum—misalnya, jika File dibagikan dengan seluruh domain pengguna, atau jika File berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar editor.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String | Alamat email pengguna yang akan dihapus. |
Pulang pergi
File — File ini untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
remove Viewer(user)
Menghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk File. Metode
ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat. Metode ini juga tidak memblokir
pengguna mengakses File jika mereka termasuk dalam kelas pengguna yang memiliki akses
umum—misalnya, jika File dibagikan dengan seluruh domain pengguna, atau
jika File 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
File — File ini untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
revoke Permissions(emailAddress)
Mencabut akses ke File yang diberikan kepada pengguna tertentu. Metode ini tidak
memblokir pengguna mengakses File jika mereka termasuk dalam kelas pengguna yang
memiliki akses umum — misalnya, jika File dibagikan dengan seluruh domain
pengguna.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String | Alamat email pengguna yang aksesnya harus dicabut. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
revoke Permissions(user)
Mencabut akses ke File yang diberikan kepada pengguna tertentu. Metode ini tidak
memblokir pengguna mengakses File jika mereka termasuk dalam kelas pengguna yang
memiliki akses umum — misalnya, jika File dibagikan dengan seluruh domain
pengguna.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
user | User | Representasi pengguna yang aksesnya harus dicabut. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
set Content(content)
Menimpa konten file dengan penggantian tertentu. Menampilkan pengecualian jika content lebih besar dari 10 MB.
// Creates a text file with the content 'Hello, world!' const file = DriveApp.createFile('New Text File', 'Hello, world!'); // Logs the content of the text file to the console. console.log(file.getBlob().getDataAsString()); // Updates the content of the text file to 'Updated text!' file.setContent('Updated text!'); // Logs content of the text file to the console. console.log(file.getBlob().getDataAsString());
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
content | String | Konten baru untuk file. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
set Description(description)
set Name(name)
set Owner(emailAddress)
Mengubah pemilik File. Metode ini juga memberikan akses pengeditan eksplisit ke File kepada pemilik sebelumnya.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
email | String | alamat email pengguna yang akan menjadi pemilik baru |
Pulang pergi
File — File ini, untuk perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
set Owner(user)
Mengubah pemilik File. Metode ini juga memberikan akses pengeditan eksplisit ke File kepada pemilik sebelumnya.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
user | User | representasi pengguna yang akan menjadi pemilik baru |
Pulang pergi
File — File ini, untuk perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
set Security Update Enabled(enabled)
Menetapkan apakah File 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 File. |
Pulang pergi
File — File ini, untuk pengaitan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
set Sharing(accessType, permissionType)
Menetapkan kelas pengguna yang dapat mengakses File dan izin yang diberikan kepada pengguna tersebut, selain pengguna perorangan yang telah diberi akses secara eksplisit.
// Creates a folder that anyone on the Internet can read from and write to. // (Domain administrators can prohibit this setting for users of a Google // Workspace domain.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
access | Access | kelas pengguna mana yang harus dapat mengakses File |
permission | Permission | izin yang harus diberikan kepada pengguna yang dapat mengakses File |
Pulang pergi
File — File ini, untuk perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
set Starred(starred)
Menetapkan apakah File diberi bintang di Drive pengguna. Default untuk
File baru adalah false.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
starred | Boolean | true jika File harus dibintangi di Drive pengguna; false jika tidak |
Pulang pergi
File — File ini, untuk perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive
set Trashed(trashed)
Menetapkan apakah File ada di sampah Drive pengguna. Hanya pemilik yang dapat menghapus File. Default untuk File baru adalah false.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
trashed | Boolean | true jika File harus dipindahkan ke sampah
Drive pengguna; false jika tidak |
Pulang pergi
File — File ini, untuk perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/drive