Halaman ini diterjemahkan oleh Cloud Translation API.

Class Folder

Folder di Google Drive. Folder dapat diakses atau dibuat dari DriveApp.

// Log the name of every folder in the user's Drive.
var folders = DriveApp.getFolders();
while (folders.hasNext()) {
  var folder = folders.next();
  Logger.log(folder.getName());
}

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`addEditor(emailAddress)`	`Folder`	Menambahkan pengguna tertentu ke daftar editor untuk `Folder`.
`addEditor(user)`	`Folder`	Menambahkan pengguna tertentu ke daftar editor untuk `Folder`.
`addEditors(emailAddresses)`	`Folder`	Menambahkan array pengguna yang diberikan ke daftar editor untuk `Folder`.
`addViewer(emailAddress)`	`Folder`	Menambahkan pengguna 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.

Metode yang tidak digunakan lagi

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`addFile(child)`	`Folder`	Menambahkan file yang diberikan ke folder saat ini.
`addFolder(child)`	`Folder`	Menambahkan folder yang diberikan ke folder saat ini.
`removeFile(child)`	`Folder`	Menghapus file yang ditentukan dari folder saat ini.
`removeFolder(child)`	`Folder`	Menghapus folder yang ditentukan dari folder saat ini.

Dokumentasi mendetail

`addEditor(emailAddress)`

Menambahkan pengguna tertentu ke daftar editor untuk Folder. Jika pengguna sudah pada daftar penonton, metode ini mempromosikan pengguna tersebut dari daftar penonton.

Parameter

Nama	Jenis	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`addEditor(user)`

Menambahkan pengguna tertentu ke daftar editor untuk Folder. Jika pengguna sudah pada daftar penonton, metode ini mempromosikan pengguna tersebut dari daftar penonton.

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	Representasi pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`addEditors(emailAddresses)`

Menambahkan array pengguna yang diberikan ke daftar editor untuk Folder. Jika salah satu pengguna sudah ada di daftar, metode ini mempromosikan mereka dari daftar penonton.

Parameter

Nama	Jenis	Deskripsi
`emailAddresses`	`String[]`	Array alamat email pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`addViewer(emailAddress)`

Menambahkan pengguna tertentu ke daftar pelihat untuk Folder. Jika pengguna sudah pada daftar editor, metode ini tidak berpengaruh.

Parameter

Nama	Jenis	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`addViewer(user)`

Menambahkan pengguna tertentu ke daftar pelihat untuk Folder. Jika pengguna sudah pada daftar editor, metode ini tidak berpengaruh.

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	Representasi pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`addViewers(emailAddresses)`

Menambahkan array pengguna yang diberikan ke daftar pelihat untuk Folder. Jika salah satu pengguna sudah ada di daftar editor, metode ini tidak berpengaruh bagi mereka.

Parameter

Nama	Jenis	Deskripsi
`emailAddresses`	`String[]`	Array alamat email pengguna yang akan ditambahkan.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`createFile(blob)`

Membuat file dalam folder saat ini dari Blob data arbitrer tertentu.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().createFile(blob);

Parameter

Nama	Jenis	Deskripsi
`blob`	`BlobSource`	Data untuk file baru.

Pulang pergi

File — File baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`createFile(name, content)`

Membuat file teks dalam folder saat ini dengan nama dan isi yang diberikan. Menampilkan pengecualian jika content lebih besar dari 50 MB.

// Create a text file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama file baru.
`content`	`String`	Konten untuk file baru.

Pulang pergi

File — File baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`createFile(name, content, mimeType)`

Membuat file dalam folder saat ini dengan nama, konten, dan jenis MIME yang diberikan. Menampilkan pengecualian jika content lebih besar dari 10 MB.

// Create an HTML file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama file baru.
`content`	`String`	Konten untuk file baru.
`mimeType`	`String`	Jenis MIME file baru.

Pulang pergi

File — File baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`createFolder(name)`

Membuat folder di folder saat ini dengan nama tertentu.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama folder baru.

Pulang pergi

Folder — Folder baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`createShortcut(targetId)`

Membuat pintasan ke ID item Drive yang diberikan, dan menampilkannya.

Parameter

Nama	Jenis	Deskripsi
`targetId`	`String`	ID file dari file atau folder target.

Pulang pergi

File — Pintasan baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

Membuat pintasan ke ID item Drive dan kunci resource yang diberikan, lalu menampilkannya. Resource adalah parameter tambahan yang perlu diteruskan untuk mengakses file atau folder target yang telah dibagikan menggunakan tautan.

// Creates shortcuts for all folders in the user's drive that have a specific name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey());
}

Parameter

Nama	Jenis	Deskripsi
`targetId`	`String`	ID file atau folder target.
`targetResourceKey`	`String`	Kunci resource file atau folder target.

Pulang pergi

File — Pintasan baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`getAccess(email)`

Mendapatkan izin yang diberikan ke pengguna tertentu.

Parameter

Nama	Jenis	Deskripsi
`email`	`String`	alamat email 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

`getAccess(user)`

Mendapatkan izin yang diberikan ke pengguna tertentu.

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	representasi pengguna yang izinnya harus diperiksa

Pulang pergi

Permission — izin yang diberikan kepada pengguna

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getDateCreated()`

Mendapatkan tanggal Folder dibuat.

Pulang pergi

Date — tanggal Folder dibuat

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

`getDescription()`

Mendapatkan deskripsi untuk Folder.

Pulang pergi

String — deskripsi untuk Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getEditors()`

Mendapatkan daftar editor untuk Folder ini. Jika pengguna yang menjalankan skrip tidak memiliki akses edit ke Folder, metode ini menampilkan array kosong.

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (editor of editors) {
  console.log(editor.getName());
}

Pulang pergi

User[] — Daftar editor untuk Folder ini jika pengguna memiliki akses edit atau {i>array<i} kosong jika sebaliknya.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFiles()`

Mendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini.

Pulang pergi

FileIterator — Kumpulan semua file yang merupakan turunan dari folder saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFilesByName(name)`

Mendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama file yang akan ditemukan.

Pulang pergi

FileIterator — Kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFilesByType(mimeType)`

Mendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki jenis MIME yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`mimeType`	`String`	Jenis MIME file yang akan ditemukan.

Pulang pergi

FileIterator — Kumpulan semua file yang merupakan turunan dari folder saat ini dan memiliki MIME yang ditentukan .

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFolders()`

Mendapatkan kumpulan semua folder yang merupakan turunan dari folder saat ini.

Pulang pergi

FolderIterator — Kumpulan semua folder yang merupakan turunan dari folder saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFoldersByName(name)`

Mendapatkan kumpulan semua folder yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama folder yang akan ditemukan.

Pulang pergi

FolderIterator — Kumpulan semua folder yang merupakan turunan dari folder saat ini dan memiliki nama tertentu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getId()`

Mendapatkan ID Folder.

Pulang pergi

String — ID Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getLastUpdated()`

Mendapatkan tanggal Folder terakhir diperbarui.

Pulang pergi

Date — tanggal Folder terakhir diperbarui

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

`getName()`

Mendapatkan nama Folder.

Pulang pergi

String — nama Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getOwner()`

Mendapatkan pemilik Folder ini.

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

Pulang pergi

User — Pemilik Folder ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getParents()`

Mendapatkan kumpulan folder yang merupakan induk langsung dari Folder.

Pulang pergi

FolderIterator — kumpulan folder yang merupakan induk langsung dari Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getResourceKey()`

Mendapatkan kunci resource Folder yang diperlukan untuk mengakses item yang telah dibagikan menggunakan tautan.

Pulang pergi

String — Kunci resource Folder.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSecurityUpdateEligible()`

Mendapatkan apakah Folder ini memenuhi syarat untuk menerapkan update keamanan yang memerlukan kunci resource untuk akses saat dibagikan menggunakan link.

Drive memerlukan kunci resource untuk mengakses beberapa file atau folder yang telah dibagikan menggunakan tautan. Perubahan ini adalah bagian dari update keamanan. Update diaktifkan secara default untuk kolom yang memenuhi syarat {i>file<i} dan {i>folder<i}. Untuk mengaktifkan atau menonaktifkan persyaratan kunci resource untuk file yang memenuhi syarat, gunakan setSecurityUpdateEnabled.

Pelajari lebih lanjut Update keamanan untuk Google Drive.

Pulang pergi

Boolean — Apakah persyaratan kunci resource dapat diterapkan untuk Folder.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSecurityUpdateEnabled()`

Mendapatkan apakah Folder ini memerlukan kunci resource untuk akses saat dibagikan menggunakan tautan. Persyaratan ini diaktifkan secara default untuk file dan folder yang memenuhi syarat. Untuk mengaktifkan atau menonaktifkan persyaratan kunci resource untuk file yang memenuhi syarat, gunakan setSecurityUpdateEnabled.

Pelajari lebih lanjut Update keamanan untuk Google Drive.

Pulang pergi

Boolean — Apakah persyaratan kunci resource diaktifkan untuk Folder ini atau 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

`getSharingAccess()`

Mendapatkan class pengguna mana yang dapat mengakses Folder, selain individu mana pun pengguna yang telah diberi akses secara eksplisit.

Pulang pergi

Access — class pengguna mana yang dapat mengakses Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSharingPermission()`

Mendapatkan izin yang diberikan kepada pengguna yang dapat mengakses Folder, selain pengguna individu yang telah diberi akses secara eksplisit.

Pulang pergi

Permission — izin yang diberikan kepada pengguna yang dapat mengakses Folder

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSize()`

Mendapatkan jumlah byte yang digunakan untuk menyimpan Folder di Drive. Perlu diketahui bahwa File aplikasi Google Workspace tidak mengurangi batas penyimpanan Drive dan akan dikembalikan 0 byte.

Pulang pergi

Integer — jumlah byte yang digunakan untuk menyimpan Folder di Drive

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getUrl()`

Mendapatkan URL yang dapat digunakan untuk membuka Folder di Aplikasi Google seperti Drive atau Dokumen.

Pulang pergi

String — URL yang dapat digunakan untuk melihat Folder ini di Aplikasi Google seperti Drive atau Dokumen

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getViewers()`

Mendapatkan daftar pelihat dan pengomentar untuk Folder ini. Jika pengguna yang mengeksekusi skrip tidak memiliki akses edit ke Folder, metode ini mengembalikan {i>array<i} kosong.

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (viewer of viewers) {
  console.log(viewer.getName());
}

Pulang pergi

User[] — Daftar pelihat dan pengomentar untuk Folder ini jika pengguna telah mengeditnya akses atau {i>array<i} 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

`isShareableByEditors()`

Menentukan apakah pengguna dengan izin edit ke Folder diizinkan untuk berbagi dengan pengguna lain atau mengubah izin akses.

Pulang pergi

Boolean — true jika pengguna dengan izin edit diizinkan untuk berbagi dengan pengguna lain atau mengubah izin akses; 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

`isStarred()`

Menentukan apakah Folder telah dibintangi di Drive pengguna.

Pulang pergi

Boolean — true jika Folder dibintangi di Drive pengguna; false jika tidak

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isTrashed()`

Menentukan apakah Folder berada di sampah Drive pengguna.

Pulang pergi

Boolean — true jika Folder berada di sampah Drive pengguna; false jika tidak

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`moveTo(destination)`

Memindahkan item ini ke folder tujuan yang disediakan.

Pengguna saat ini harus merupakan pemilik file atau setidaknya memiliki akses edit ke file folder induk saat ini untuk memindahkan item ke folder tujuan.

Parameter

Nama	Jenis	Deskripsi
`destination`	`Folder`	Folder yang menjadi induk baru.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`removeEditor(emailAddress)`

Menghapus pengguna tertentu dari daftar editor untuk Folder. Metode ini tidak blokir pengguna agar tidak mengakses Folder jika mereka termasuk dalam kelas pengguna yang telah akses umum—misalnya, jika Folder dibagikan ke seluruh isi pengguna domain publik, atau jika Folder berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.

Parameter

Nama	Jenis	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan dihapus.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`removeEditor(user)`

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	Representasi pengguna yang akan dihapus.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`removeViewer(emailAddress)`

Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Folder. Ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat atau pengomentar. Metode ini juga tidak akan memblokir pengguna agar tidak mengakses Folder jika mereka termasuk dalam kelas pengguna yang memiliki akses umum—misalnya, jika Folder dibagikan ke seluruh domain, atau jika Folder berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar editor.

Parameter

Nama	Jenis	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan dihapus.

Pulang pergi

Folder — Folder ini untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`removeViewer(user)`

Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Folder. Ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat. Metode ini juga tidak memblokir pengguna agar tidak mengakses Folder jika mereka termasuk dalam kelas pengguna yang memiliki akses—misalnya, jika Folder dibagikan ke seluruh domain pengguna, atau jika Folder berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar editor.

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	Representasi pengguna yang akan dihapus.

Pulang pergi

Folder — Folder ini untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`revokePermissions(emailAddress)`

Mencabut akses ke Folder yang diberikan kepada pengguna tertentu. Metode ini tidak blokir pengguna agar tidak mengakses Folder jika mereka termasuk dalam kelas pengguna yang memiliki akses umum — misalnya, jika Folder dibagikan ke seluruh domain.

Parameter

Nama	Jenis	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang aksesnya harus dicabut.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`revokePermissions(user)`

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	Representasi pengguna yang aksesnya harus dicabut.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`searchFiles(params)`

Mendapatkan kumpulan semua file yang merupakan turunan dari folder saat ini dan cocok dengan penelusuran yang diberikan kriteria. Kriteria penelusuran dijelaskan secara mendetail di dokumentasi SDK Google Drive. Perhatikan bahwa Drive menggunakan Drive API v2 dan beberapa kolom kueri berbeda dengan v3. Tinjau kolom perbedaan antara v2 dan v3.

Argumen params adalah string kueri yang dapat berisi nilai string, jadi berhati-hatilah. untuk meng-escape tanda kutip dengan benar (misalnya, "title contains 'Gulliver\\'s Travels'" atau 'title contains "Gulliver\'s Travels"').

// Logs the name of every file that are children of the current folder and modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Parameter

Nama	Jenis	Deskripsi
`params`	`String`	Kriteria penelusuran, seperti yang dijelaskan dalam dokumentasi SDK Google Drive.

Pulang pergi

FileIterator — Kumpulan semua file yang merupakan turunan dari folder saat ini dan cocok dengan penelusuran kriteria.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`searchFolders(params)`

Mendapatkan kumpulan semua folder yang merupakan turunan dari folder saat ini dan cocok dengan penelusuran yang diberikan kriteria. Kriteria penelusuran dijelaskan secara mendetail di dokumentasi SDK Google Drive. Perhatikan bahwa Drive menggunakan Drive API v2 dan beberapa kolom kueri berbeda dengan v3. Tinjau kolom perbedaan antara v2 dan v3.

// Logs the name of every folder that are children of the current folder and you own and is starred.
var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

Parameter

Nama	Jenis	Deskripsi
`params`	`String`	Kriteria penelusuran, seperti yang dijelaskan dalam dokumentasi SDK Google Drive.

Pulang pergi

FolderIterator — Kumpulan semua folder yang merupakan turunan dari folder saat ini dan cocok dengan penelusuran kriteria.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`setDescription(description)`

Menetapkan deskripsi untuk Folder.

Parameter

Nama	Jenis	Deskripsi
`description`	`String`	deskripsi baru untuk `Folder`

Pulang pergi

Folder — Folder ini, untuk perantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`setName(name)`

Menetapkan nama Folder.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	nama baru `Folder`

Pulang pergi

Folder — Folder ini, untuk perantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`setOwner(emailAddress)`

Mengubah pemilik Folder. Metode ini juga memberi pemilik sebelumnya akses edit eksplisit ke Folder.

Parameter

Nama	Jenis	Deskripsi
`emailAddress`	`String`	alamat email pengguna yang akan menjadi pemilik baru

Pulang pergi

Folder — Folder ini, untuk perantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`setOwner(user)`

Mengubah pemilik Folder. Metode ini juga memberi pemilik sebelumnya akses edit eksplisit ke Folder.

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	representasi pengguna yang seharusnya menjadi pemilik baru

Pulang pergi

Folder — Folder ini, untuk perantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`setSecurityUpdateEnabled(enabled)`

Menetapkan apakah Folder memerlukan kunci resource untuk akses saat dibagikan menggunakan tautan. File dan folder yang memenuhi syarat diaktifkan secara default.

Pelajari lebih lanjut Update keamanan untuk Google Drive.

Parameter

Nama	Jenis	Deskripsi
`enabled`	`Boolean`	Apakah akan mengaktifkan persyaratan kunci resource untuk `Folder`.

Pulang pergi

Folder — Folder ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`setShareableByEditors(shareable)`

Menetapkan apakah pengguna dengan izin edit pada Folder diizinkan untuk berbagi dengan pengguna lain atau mengubah izin akses. Default untuk Folder baru adalah true.

Parameter

Nama	Jenis	Deskripsi
`shareable`	`Boolean`	`true` jika pengguna yang memiliki izin edit harus diizinkan untuk berbagi dengan pengguna lain atau mengubah izin akses; `false` jika tidak

Pulang pergi

Folder — Folder ini, untuk perantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`setSharing(accessType, permissionType)`

Menetapkan class pengguna yang dapat mengakses Folder dan izin apa pengguna tersebut diberikan, selain pengguna individu yang telah diberi akses secara eksplisit.

// Creates a folder that anyone on the Internet can read from and write to. (Domain
// administrators can prohibit this setting for users of a Google Workspace domain.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parameter

Nama	Jenis	Deskripsi
`accessType`	`Access`	class pengguna mana yang harus dapat mengakses `Folder`
`permissionType`	`Permission`	izin yang harus diberikan kepada pengguna yang dapat mengakses `Folder`

Pulang pergi

Folder — Folder ini, untuk perantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`setStarred(starred)`

Menetapkan apakah Folder diberi bintang di Drive pengguna. Default untuk Folder baru adalah false.

Parameter

Nama	Jenis	Deskripsi
`starred`	`Boolean`	`true` jika `Folder` harus diberi bintang dalam {i>Drive<i}; `false` jika tidak

Pulang pergi

Folder — Folder ini, untuk perantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`setTrashed(trashed)`

Menetapkan apakah Folder berada di sampah Drive pengguna. Hanya pemilik dapat membuang Folder. Default untuk Folder baru adalah false.

Parameter

Nama	Jenis	Deskripsi
`trashed`	`Boolean`	`true` jika `Folder` harus dipindahkan ke sampah {i>Drive<i} pengguna; `false` jika tidak

Pulang pergi

Folder — Folder ini, untuk perantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

Metode yang tidak digunakan lagi

`addFile(child)`

Tidak digunakan lagi. Sebagai gantinya, gunakan File.moveTo(destination) atau createShortcut(targetId).

Menambahkan file yang diberikan ke folder saat ini. Metode ini tidak memindahkan file dari folder induk yang ada; sebuah file dapat memiliki lebih dari satu induk secara bersamaan.

Parameter

Nama	Jenis	Deskripsi
`child`	`File`	File turunan yang akan ditambahkan.

Pulang pergi

Folder — Induk baru dari file yang ditambahkan sebagai turunan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`addFolder(child)`

Tidak digunakan lagi. Sebagai gantinya, gunakan moveTo(destination) atau createShortcut(targetId).

Menambahkan folder yang diberikan ke folder saat ini. Metode ini tidak memindahkan folder dari folder induknya; sebuah folder dapat memiliki lebih dari satu induk secara bersamaan.

Parameter

Nama	Jenis	Deskripsi
`child`	`Folder`	Folder turunan yang akan ditambahkan.

Pulang pergi

Folder — Induk baru dari folder yang ditambahkan sebagai turunan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`removeFile(child)`

Tidak digunakan lagi. Sebagai gantinya, gunakan File.moveTo(destination).

Menghapus file yang ditentukan dari folder saat ini. Metode ini tidak menghapus file, tetapi jika file dihapus dari semua induknya, file tidak dapat dilihat di Drive kecuali dengan menelusuri atau menggunakan opsi "All items" {i>view<i}.

Parameter

Nama	Jenis	Deskripsi
`child`	`File`	File turunan yang akan dihapus.

Pulang pergi

Folder — Orang tua sebelumnya dari turunan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive

`removeFolder(child)`

Tidak digunakan lagi. Sebagai gantinya, gunakan moveTo(destination).

Menghapus folder yang ditentukan dari folder saat ini. Metode ini tidak menghapus folder atau kontennya, tetapi jika folder dihapus dari semua induknya, folder tidak dapat dilihat di Drive kecuali dengan menelusurinya atau menggunakan tombol "Semua item" {i>view<i}.

Parameter

Nama	Jenis	Deskripsi
`child`	`Folder`	Folder turunan yang akan dihapus.

Pulang pergi

Folder — Orang tua sebelumnya dari turunan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/drive