Masukkan ke sampah atau hapus file dan folder

Anda dapat menghapus file dan folder Google Drive dari Drive Saya dan drive bersama. Anda memiliki dua opsi untuk melakukannya: sampah atau hapus.

Anda dapat memindahkan file dan folder ke sampah, lalu memulihkannya (dalam waktu 30 hari setelah file dan folder tersebut dipindahkan ke sampah). Menghapus file dan folder akan menghapusnya secara permanen dari Drive. Jika Anda menghapus, memulihkan, atau menghapus beberapa file atau folder sekaligus secara permanen, mungkin perlu waktu cukup lama sampai Anda melihat perubahannya.

Catatan: Untuk dokumen ini, asumsikan "file" berarti file dan folder. Folder adalah file yang hanya berisi metadata dan dapat digunakan untuk mengatur file di Drive. Secara khusus, folder adalah file dengan jenis MIME application/vnd.google-apps.folder dan tanpa ekstensi. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengisi folder.

Panduan ini menjelaskan cara membuang file di Drive.

Sampah

Untuk menghapus file Drive, Anda dapat memindahkannya ke sampah. File dalam sampah akan otomatis dihapus setelah 30 hari. Anda dapat memulihkan file dari sampah Anda sebelum periode 30 hari.

Hanya pemilik file yang dapat menghapus file ke sampah, dan pengguna lain tidak dapat melihat file di sampah pemilik. Jika Anda mencoba membuang file yang bukan milik Anda, Anda akan menerima error insufficientFilePermissions. Untuk mengetahui informasi selengkapnya, lihat Izin.

Untuk memverifikasi bahwa Anda adalah pemilik file, panggil metode files.get dengan parameter fileId dan fields yang ditetapkan ke kolom ownedByMe boolean. Kolom ownedByMe tidak diisi untuk file di drive bersama karena file tersebut dimiliki oleh drive bersama, bukan pengguna perorangan. Untuk informasi selengkapnya tentang menampilkan kolom menggunakan parameter fields, lihat Menampilkan kolom tertentu untuk file.

Jika Anda bukan pemilik file, tetapi masih menginginkan salinan file yang dihapus, lakukan salah satu hal berikut:

• Buat salinan file.
• Hubungi pemiliknya dan minta dia memulihkan file tersebut dari sampah.

Memindahkan file ke sampah

Untuk memindahkan file ke sampah, gunakan metode files.update dan tetapkan kolom trashed ke True. Untuk membuang file drive bersama ke sampah, Anda juga harus menetapkan parameter kueri supportsAllDrives ke True. Untuk mengetahui informasi selengkapnya, lihat Menerapkan dukungan drive bersama.

Jika berhasil, isi respons akan berisi instance dari resource file.

Catatan: Jika Anda menggunakan Drive API v2 versi sebelumnya, gunakan metode files.trash. Pelajari cara bermigrasi ke Drive API v3.

Contoh kode berikut menunjukkan cara menggunakan fileId untuk menandai file sebagai dibuang:

Python

body_value = {'trashed': True}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': True
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Ganti FILE_ID dengan fileId file yang ingin Anda hapus.

Menentukan properti file yang telah dibuang

Saat file dihapus, Anda dapat mengambil properti files tambahan. Anda dapat menggunakan metode files.get dan menyertakan kolom berikut dalam parameter fields. Untuk informasi selengkapnya, lihat Menampilkan kolom tertentu untuk file.

Kolom berikut diisi untuk semua file:

• trashed: Apakah file dihapus, baik secara eksplisit maupun dari folder induk yang dihapus. Perhatikan bahwa saat menggunakan trashed dengan metode files.update menetapkan status file, metode files.get akan mengambil status file.
• explicitlyTrashed: Apakah file dihapus secara eksplisit, bukan dihapus secara rekursif, dari folder induk.

Kolom berikut hanya diisi untuk file yang berada dalam drive bersama:

• trashedTime: Waktu item dihapus dalam format tanggal-waktu RFC 3339. Jika Anda menggunakan versi Drive API v2 sebelumnya, kolom ini disebut trashedDate.
• trashingUser: Jika file dibuang secara eksplisit, pengguna yang membuangnya.

Memulihkan file dari sampah

Untuk memulihkan file dari sampah, gunakan metode files.update dan tetapkan kolom trashed ke False. Untuk membatalkan penghapusan file drive bersama, Anda juga harus menetapkan parameter kueri supportsAllDrives ke True. Untuk mengetahui informasi selengkapnya, lihat Menerapkan dukungan drive bersama.

Jika berhasil, isi respons akan berisi instance dari resource file.

Catatan: Jika Anda menggunakan versi Drive API v2 sebelumnya, gunakan metode files.untrash. Pelajari cara bermigrasi ke Drive API v3.

Contoh kode berikut menunjukkan cara menggunakan fileId untuk menandai file sebagai tidak dihapus:

Python

body_value = {'trashed': False}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': False
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Ganti FILE_ID dengan fileId untuk file yang ingin Anda hapus dari sampah.

Kosongkan sampah

Anda dapat menghapus permanen semua file Drive yang telah dipindahkan ke sampah oleh pengguna menggunakan metode files.emptyTrash. Untuk mengkosongkan sampah drive bersama, Anda juga harus menetapkan parameter kueri driveId ke ID drive bersama.

Jika berhasil, isi respons akan berisi instance kosong.

Catatan: Jika Anda menggunakan Drive API v2 versi sebelumnya, gunakan metode files.emptyTrash. Pelajari cara bermigrasi ke Drive API v3.

Contoh kode berikut menunjukkan cara menggunakan fileId untuk menghapus semua file di sampah sampah:

Python

response = drive_service.files().emptyTrash().execute()

Node.js

 const response = await drive_service.files.emptyTrash({
    });
    return response;

Hapus

Anda dapat menghapus file Drive secara permanen tanpa memindahkannya ke sampah. Setelah Anda menghapus file, siapa pun yang Anda ajak berbagi file tersebut akan kehilangan akses ke file tersebut. Jika Anda ingin orang lain mempertahankan akses ke file tersebut, Anda dapat mentransfer kepemilikan kepada orang lain sebelum menghapusnya.

Untuk menghapus file drive bersama, pengguna harus memiliki role=organizer di folder induk. Jika Anda menghapus folder, semua turunan yang dimiliki oleh pengguna juga akan dihapus. Untuk mengetahui informasi selengkapnya, lihat Izin.

Untuk menghapus file milik pengguna secara permanen tanpa memindahkannya ke sampah, gunakan metode files.delete. Untuk menghapus file drive bersama, Anda juga harus menetapkan parameter kueri supportsAllDrives ke True. Untuk mengetahui informasi selengkapnya, lihat Menerapkan dukungan drive bersama.

Jika berhasil, isi respons akan berisi instance kosong.

Catatan: Jika Anda menggunakan versi Drive API v2 sebelumnya, gunakan metode files.delete. Pelajari cara bermigrasi ke Drive API v3.

Contoh kode berikut menunjukkan cara menggunakan fileId untuk menghapus file:

Python

response = drive_service.files().delete(fileId="FILE_ID").execute()

Node.js

 const response = await drive_service.files.delete({
      fileId: 'FILE_ID'
    });
    return response;

Ganti FILE_ID dengan fileId untuk file yang ingin Anda hapus.

Izin

Tabel berikut menunjukkan izin peran yang diperlukan untuk melakukan setiap operasi. Untuk mengetahui daftar lengkap peran dan operasi yang diizinkan oleh setiap peran dan operasi, lihat Peran dan izin.

Operasi yang diizinkan	owner	organizer	fileOrganizer	writer	commenter	reader
Memindahkan file dan folder ke sampah	✔	✔	✔
Memulihkan file dan folder dari sampah	✔	✔	✔
Kosongkan sampah	✔	✔
Menghapus file atau folder secara permanen	✔	✔
Menghapus file dan folder di drive bersama ^[*]		✔

[*] Memerlukan peran organizer di induk langsung atau tidak langsung, bukan peran yang ada di item.

Kemampuan

Resource files berisi kumpulan kolom capabilities boolean yang digunakan untuk menunjukkan apakah suatu tindakan dapat dilakukan pada file.

Untuk memeriksa kemampuan, panggil metode files.get dengan parameter fileId dan fields yang ditetapkan ke kolom capabilities. Untuk informasi selengkapnya tentang kolom yang ditampilkan menggunakan parameter fields, lihat Menampilkan kolom tertentu untuk file.

Kolom berikut diisi untuk semua file:

• capabilities.canTrash: Apakah pengguna saat ini dapat memindahkan file ini ke sampah.
• capabilities.canUntrash: Apakah pengguna saat ini dapat memulihkan file ini dari sampah.
• capabilities.canDelete: Apakah pengguna saat ini dapat menghapus file ini.
• capabilities.canRemoveChildren: Apakah pengguna saat ini dapat menghapus turunan dari folder ini. Nilai ini salah jika item bukan folder.

Kolom berikut hanya diisi untuk file yang berada dalam drive bersama:

• capabilities.canTrashChildren: Apakah pengguna saat ini dapat membuang turunan folder ini ke sampah. Nilai ini salah jika item bukan folder.
• capabilities.canDeleteChildren: Apakah pengguna saat ini dapat menghapus turunan folder ini. Nilai ini salah jika item bukan folder.

Batas file dan folder

File dan folder Drive, beserta folder drive bersama, memiliki beberapa batas penyimpanan.

Biasanya, setelah batas item tercapai, satu-satunya cara untuk membuat lebih banyak ruang adalah menghapus secara permanen item atau menggunakan akun lain. Memindahkan file ke sampah tidak cukup untuk mengosongkan ruang penyimpanan.

Untuk informasi selengkapnya tentang batas file dan folder, lihat hal berikut:

• Batas file dan folder dalam file
• Batas file dan folder di drive bersama

Topik terkait

• Menghapus file di Google Drive
• Perbedaan drive bersama versus My Drive API
• Peran dan izin