Mengelola metadata file

Dokumen ini mencakup pertimbangan penting untuk penamaan file dan bekerja dengan metadata seperti thumbnail dan teks yang dapat diindeks. Untuk mulai menyisipkan dan mengambil file, lihat Referensi file.

Menentukan ekstensi & nama file

Aplikasi harus menentukan ekstensi file dalam 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 menyertakan properti fileExtension hanya baca yang diisi dengan ekstensi yang awalnya ditentukan dalam 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 serta 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 dalam kolom contentHints.indexableText file.

Teks yang dapat diindeks diindeks sebagai HTML. Jika Anda menyimpan string teks yang dapat diindeks <section attribute="value1">Here's some text</section>, "Berikut beberapa teks" akan diindeks, tetapi "value1" tidak akan diindeks. Karena itu, menyimpan XML sebagai teks yang dapat diindeks tidak seberguna menyimpan HTML.

Saat menentukan indexableText, perhatikan juga:

• Batas ukuran untuk contentHints.indexableText adalah 128 KB.
• Catat istilah dan konsep utama yang Anda harapkan akan ditelusuri pengguna.
• Jangan mencoba mengurutkan teks sesuai urutan kepentingan karena pengindeks akan melakukannya secara efisien untuk Anda.
• Aplikasi Anda harus memperbarui teks yang dapat diindeks dengan setiap penyimpanan.
• Pastikan teks berkaitan dengan konten atau metadata file.

Poin terakhir ini mungkin tampak jelas, tetapi ini penting. Sebaiknya jangan tambahkan istilah yang sering ditelusuri untuk memaksa file muncul di hasil penelusuran. Hal ini dapat membuat pengguna frustrasi, dan bahkan mungkin memotivasi mereka untuk menghapus file.

Mengupload thumbnail

Drive 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 dibuat oleh aplikasi Anda. Upload thumbnail dengan menetapkan properti contentHints.thumbnail di resource File selama panggilan create atau update sebagai berikut:

• Setel contentHints.thumbnail.image ke gambar berenkode Base64 yang aman untuk URL (lihat RFC 4648 bagian 5).
• Setel contentHints.thumbnail.mimeType ke jenis yang sesuai untuk format gambar.

Jika Drive dapat membuat thumbnail dari file, thumbnail yang dibuat akan digunakan dan mengabaikan thumbnail yang telah Anda upload. Jika tidak bisa membuat thumbnail, thumbnail akan selalu menggunakan thumbnail Anda jika disediakan. Hal-hal 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 melakukan penyimpanan.

Penting: Thumbnail menjadi tidak valid setiap kali isi file berubah. Saat memberikan thumbnail, penting untuk mengupload thumbnail baru setiap kali konten diubah. Perubahan metadata tidak membatalkan thumbnail.

Untuk mengetahui informasi selengkapnya, lihat Referensi file.