Membuat dan mengelola file

Panduan ini menjelaskan cara membuat dan mengelola file di Google Drive menggunakan Google Drive API.

Buat file

Untuk membuat file di Drive yang tidak berisi metadata atau konten, gunakan metode files.create tanpa parameter. File diberi kind drive.file, id, name "Tidak berjudul", dan mimeType application/octet-stream. uploadType ditandai sebagai wajib diisi, tetapi secara default adalah media, jadi Anda tidak perlu memasukkannya.

Untuk mengetahui informasi selengkapnya tentang batas file Drive, lihat Batas file dan folder.

Membuat file hanya metadata

File hanya metadata tidak berisi konten. Metadata adalah data (seperti name, mimeType, dan createdTime) yang menjelaskan file. Kolom seperti name tidak bergantung pada pengguna dan muncul sama untuk setiap pengguna, sedangkan kolom seperti viewedByMeTime berisi nilai khusus pengguna.

Salah satu contoh file khusus metadata adalah folder dengan jenis MIME application/vnd.google-apps.folder. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengisi folder. Contoh lainnya adalah pintasan yang mengarah ke file lain di Drive dengan jenis MIME application/vnd.google-apps.shortcut. Untuk mengetahui informasi selengkapnya, lihat Membuat pintasan ke file Drive.

Mengelola gambar thumbnail

Thumbnail membantu pengguna mengidentifikasi file Drive. Drive dapat membuat thumbnail secara otomatis untuk jenis file umum atau Anda dapat memberikan gambar thumbnail yang dibuat oleh aplikasi Anda. Untuk mengetahui informasi selengkapnya, lihat Mengupload thumbnail.

Menyalin file yang ada

Untuk menyalin file, dan menerapkan update yang diminta, gunakan metode files.copy. Untuk menemukan fileId yang akan disalin, gunakan metode files.list.

Perhatikan bahwa Anda harus menggunakan cakupan Drive API yang sesuai untuk memberi otorisasi panggilan. Untuk mengetahui informasi selengkapnya tentang cakupan Drive, lihat Memilih cakupan Google Drive API.

Batas dan pertimbangan

Saat Anda bersiap untuk menyalin file, perhatikan batasan dan pertimbangan berikut:

  • Izin:

    • Objek DownloadRestrictionsMetadata dari resource files menentukan siapa yang dapat menyalin file. Untuk mengetahui informasi selengkapnya, lihat Mencegah pengguna mendownload, mencetak, atau menyalin file Anda.
    • Resource kolom capabilities.canCopy menentukan apakah pengguna dapat menyalin file atau tidak. Untuk mengetahui informasi selengkapnya, lihat Memahami kemampuan file.
    • Pengguna yang membuat salinan memiliki file yang disalin. Tidak ada setelan berbagi lain dari file sumber yang direplikasi. Jika salinan dibuat di folder bersama, salinan tersebut akan mewarisi izin folder tersebut.
    • Kepemilikan file yang disalin dapat berubah dan salinan mungkin tidak mewarisi setelan berbagi file asli. Setelan ini mungkin perlu direset.

  • Pengelolaan file:

    • Beberapa file, seperti pintasan pihak ketiga, tidak akan pernah dapat disalin.
    • Anda hanya dapat menyalin file ke dalam satu folder induk. Menentukan beberapa induk tidak didukung. Jika kolom parents tidak ditentukan, file akan mewarisi induk yang dapat ditemukan dari file sumber.
    • Meskipun folder adalah jenis file, Anda tidak dapat menyalin folder. Sebagai gantinya, buat folder tujuan dan tetapkan kolom parents dari file yang ada ke folder tujuan. Kemudian, Anda dapat menghapus folder sumber asli.
    • Kecuali jika nama file baru ditentukan, metode files.copy akan menghasilkan file dengan nama yang sama seperti file aslinya.
    • Penggunaan files.copy yang berlebihan dapat menyebabkan Anda melampaui batas kuota Drive API. Untuk mengetahui informasi selengkapnya, lihat Batas penggunaan.

Berikut beberapa langkah selanjutnya yang dapat Anda coba: