Mengelola metadata file

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

Catatan: Mulai 31 Oktober 2022, teks yang dapat diindeks dapat ditampilkan dalam cuplikan hasil dan akan memengaruhi hasil penelusuran di lebih banyak tempat, termasuk Cloud Search dan overlay penelusuran di Drive dan Gmail.

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.

Penting: Thumbnail menjadi tidak valid setiap kali konten file diubah. Saat memberikan thumbnail, Anda harus mengupload thumbnail baru setiap kali konten diubah. Perubahan metadata tidak membatalkan thumbnail.

Untuk mengetahui informasi lebih lanjut, baca Referensi file.