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: hapus ke sampah atau hapus.

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

Panduan ini menjelaskan cara menghapus file di Drive.

Menggunakan parameter kolom

Jika ingin menentukan kolom yang akan ditampilkan dalam respons, Anda dapat menyetel parameter sistem fields dengan metode apa pun dari resource files. Jika Anda menghapus parameter fields, server akan menampilkan kumpulan kolom default yang khusus untuk metode tersebut. Misalnya, metode list hanya menampilkan kolom kind, id, name, mimeType, dan resourceKey untuk setiap file. Untuk menampilkan kolom yang berbeda, lihat Menampilkan kolom tertentu.

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 memindahkan file ke sampah, dan pengguna lain tidak dapat melihat file di sampah pemilik. Jika Anda mencoba membuang file yang bukan milik Anda ke sampah, Anda akan menerima error insufficientFilePermissions. Untuk mengetahui informasi selengkapnya, lihat Izin.

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

Jika Anda bukan pemilik file, tetapi tetap menginginkan salinan file yang dihapus ke sampah, lakukan salah satu tindakan 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 update pada resource files dengan parameter jalur fileId dan tetapkan kolom boolean trashed ke true. Untuk menghapus file drive bersama ke sampah, Anda juga harus menyetel parameter kueri boolean supportsAllDrives ke true. Untuk mengetahui informasi selengkapnya, lihat Menerapkan dukungan drive bersama.

Jika berhasil, isi respons berisi instance resource files.

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

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 ke sampah.

Menentukan properti file yang dibuang

Saat file dihapus ke sampah, Anda dapat mengambil properti file tambahan. Anda dapat menggunakan metode get pada resource files dengan parameter jalur fileId dan menggunakan salah satu kolom yang dihapus berikut dalam parameter fields. Untuk mengetahui informasi selengkapnya tentang parameter fields, lihat Menggunakan parameter kolom.

Kolom berikut diisi untuk semua file:

  • trashed: Apakah file dihapus ke sampah, baik secara eksplisit maupun dari folder induk yang dihapus ke sampah. Perhatikan bahwa saat menggunakan trashed dengan metode update akan menetapkan status file, metode 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 di dalam drive bersama:

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

Memulihkan file dari sampah

Untuk memulihkan file dari sampah, gunakan metode update pada resource files dengan parameter jalur fileId dan tetapkan kolom boolean trashed ke false. Untuk mengurungkan penghapusan file drive bersama, Anda juga harus menyetel parameter kueri boolean supportsAllDrives ke true. Untuk mengetahui informasi selengkapnya, lihat Menerapkan dukungan drive bersama.

Jika berhasil, isi respons berisi instance resource files.

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

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 file yang ingin Anda batalkan penghapusannya.

Kosongkan sampah

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

Jika berhasil, isi respons akan berisi objek JSON kosong.

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

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 tetap dapat mengakses file tersebut, Anda dapat mentransfer kepemilikan kepada orang lain sebelum penghapusan.

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 delete pada resource files. Untuk menghapus file drive bersama, Anda juga harus menetapkan parameter kueri boolean supportsAllDrives ke true. Untuk mengetahui informasi selengkapnya, lihat Menerapkan dukungan drive bersama.

Jika berhasil, isi respons akan berisi objek JSON kosong.

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 file yang ingin Anda hapus.

Izin

Tabel berikut menunjukkan izin peran yang diperlukan untuk memindahkan file dan folder ke sampah atau menghapusnya. Untuk mengetahui daftar lengkap peran dan operasi yang diizinkan oleh setiap peran, 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
Mengosongkan sampah
Menghapus file atau folder
Menghapus file dan folder di drive bersama [*]
Menghapus drive bersama yang kosong

Kemampuan

Resource files berisi kumpulan kolom boolean capabilities yang menunjukkan kemampuan yang dimiliki pengguna pada file ini.

Untuk memeriksa kemampuan, panggil metode get pada resource files dengan parameter jalur fileId dan gunakan salah satu kolom capabilities berikut dalam parameter fields. Untuk mengetahui informasi selengkapnya tentang parameter fields, lihat Menggunakan parameter kolom.

Kolom berikut diisi untuk semua file:

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

Batas file dan folder

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

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

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