Dokumen ini mencakup pertimbangan penting untuk penamaan file dan penanganan metadata seperti thumbnail dan teks yang dapat diindeks. Untuk mulai menyisipkan dan mengambil file, lihat Referensi file.
Menentukan nama & ekstensi file
Aplikasi harus menentukan ekstensi file di properti judul saat menyisipkan file
dengan API. Misalnya, operasi untuk menyisipkan file JPEG harus menentukan
sesuatu seperti "name": "cat.jpg"
dalam metadata.
Respons GET
berikutnya dapat mencakup properti fileExtension
hanya baca
yang diisi dengan ekstensi yang awalnya ditentukan di
properti name
. Saat pengguna Google Drive meminta untuk mendownload
file, atau saat file didownload melalui klien sinkronisasi, Drive akan membuat
nama file lengkap (dengan ekstensi) berdasarkan judul. Jika ekstensi tidak ada, Drive akan mencoba menentukan ekstensi berdasarkan jenis MIME file.
Simpan teks yang dapat diindeks
Drive secara otomatis mengindeks dokumen untuk penelusuran saat mengenali jenis file, termasuk dokumen teks, PDF, gambar dengan teks, dan jenis umum lainnya.
Jika aplikasi Anda menyimpan jenis file lain (seperti gambar, video, dan pintasan),
Anda dapat meningkatkan visibilitas dengan menyediakan teks yang dapat diindeks di
kolom contentHints.indexableText
file tersebut.
Teks yang dapat diindeks diindeks sebagai HTML. Jika Anda menyimpan string teks yang dapat
diindeks <section attribute="value1">Here's some text</section>
, "Inilah beberapa
teks" yang diindeks, tetapi "nilai1" tidak. Oleh karena itu, menyimpan XML sebagai teks yang
dapat diindeks tidaklah berguna seperti menyimpan HTML.
Saat menentukan indexableText
, perlu diingat juga:
- Batas ukuran untuk
contentHints.indexableText
adalah 128 KB. - Tangkap istilah dan konsep utama yang Anda ingin pengguna telusuri.
- Jangan coba mengurutkan teks berdasarkan tingkat kepentingannya karena pengindeks melakukannya secara efisien untuk Anda.
- Aplikasi Anda harus mengupdate teks yang dapat diindeks dengan setiap penyimpanan.
- Pastikan teks terkait dengan konten atau metadata file.
Poin terakhir ini mungkin tampak jelas, tetapi penting. Sebaiknya jangan tambahkan istilah yang sering ditelusuri untuk memaksa file muncul di hasil penelusuran. Situasi ini dapat menyulitkan pengguna, dan bahkan mungkin memotivasi mereka untuk menghapus file.
Unggah gambar mini
Drive secara otomatis membuat thumbnail untuk berbagai jenis file umum. Untuk
pintasan dan jenis file lain yang tidak dapat dirender oleh Drive, Anda dapat memberikan
gambar thumbnail yang dihasilkan oleh aplikasi Anda. Upload thumbnail dengan menetapkan
properti contentHints.thumbnail
pada
resource Files selama panggilan create
atau update
sebagai berikut:
- Setel
contentHints.thumbnail.image
ke gambar berenkode Base64 yang aman untuk URL (lihat RFC 4648 bagian 5). - Tetapkan
contentHints.thumbnail.mimeType
ke jenis yang sesuai untuk format gambar.
Jika Drive dapat membuat thumbnail dari file, Drive akan menggunakan thumbnail yang dihasilkan dan mengabaikan yang telah Anda upload. Jika tidak dapat menghasilkan thumbnail, selalu menggunakan thumbnail tersebut jika Anda menyediakannya. Item yang perlu diperhatikan:
- Thumbnail dapat diupload dalam format PNG, GIF, atau JPG.
- Lebar yang direkomendasikan adalah 1.600 piksel.
- Ukuran file maksimum untuk thumbnail adalah 2 MB.
- Lebar minimum untuk thumbnail adalah 220 piksel.
- Aplikasi Anda harus memperbarui thumbnail setiap kali disimpan.
Untuk mengetahui informasi lebih lanjut, baca Referensi file.