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 create pada resource files tanpa parameter.

Saat Anda membuat file, metode ini akan menampilkan resource files. File diberi kind drive.file, id, name "Tanpa judul", dan mimeType application/octet-stream. uploadType ditandai sebagai wajib diisi, tetapi secara default adalah media, jadi Anda tidak perlu memberikannya.

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

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.

Membuat ID untuk digunakan dengan file Anda

Metode generateIds pada resource files memungkinkan Anda membuat ID file unik yang telah dibuat sebelumnya dan dapat digunakan saat membuat atau menyalin file dan folder di Drive. Hal ini dapat berguna jika Anda perlu mengontrol ID file dari aplikasi, bukan membiarkan Drive menetapkannya secara otomatis.

Anda dapat menetapkan jumlah ID yang dibuat menggunakan parameter kueri count. Jika count tidak ditetapkan, 10 item akan ditampilkan secara default. Jumlah maksimum ID yang dapat Anda minta adalah 1.000.

Anda juga dapat menetapkan space tempat ID dapat digunakan dan type item yang ID-nya dapat digunakan.

Setelah ID dibuat, ID tersebut dapat diteruskan ke metode create atau copy melalui kolom id. Tindakan ini memastikan bahwa file yang dibuat atau disalin menggunakan ID yang telah ditentukan sebelumnya.

Jika file berhasil dibuat atau disalin, percobaan ulang berikutnya akan menampilkan respons kode status HTTP 409 Conflict dan file duplikat tidak akan dibuat.

Perhatikan bahwa ID yang dibuat sebelumnya tidak didukung untuk pembuatan file Google Workspace, kecuali untuk application/vnd.google-apps.drive-sdk dan application/vnd.google-apps.folder jenis MIME. Demikian pula, upload yang mereferensikan konversi ke format file Google Workspace tidak didukung.

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 copy pada resource files. Untuk menemukan fileId yang akan disalin, gunakan metode list.

Anda dapat menerapkan update melalui semantik patch, yang berarti Anda dapat melakukan modifikasi parsial pada resource. Anda harus secara eksplisit menetapkan kolom yang ingin diubah dalam permintaan Anda. Kolom apa pun yang tidak disertakan dalam permintaan akan mempertahankan nilai yang ada. Untuk mengetahui informasi selengkapnya, lihat Bekerja dengan resource parsial.

Anda dapat menyetel ID file yang disalin sebelumnya menggunakan metode generateIds. Untuk mengetahui informasi selengkapnya, lihat Membuat ID untuk digunakan dengan file Anda.

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. 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 copy akan menghasilkan file dengan nama yang sama seperti file aslinya.
    • Penggunaan 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: