Mengelola metadata file

Dokumen ini membahas pertimbangan penting untuk memberi nama file dan menggunakan metadata seperti teks dan thumbnail yang dapat diindeks. Untuk menyisipkan dan mengambil file, lihat referensi files.

Menentukan nama dan ekstensi file

Aplikasi harus menentukan ekstensi file di properti judul saat menyisipkan file dengan Google Drive 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.

Menyimpan 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 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.

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. Oleh 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 berdasarkan tingkat kepentingan karena pengindeksan melakukannya secara efisien untuk Anda.
• Aplikasi Anda harus memperbarui 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 menambahkan 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 banyak jenis file umum, seperti Google Dokumen, Spreadsheet, dan Slide. Thumbnail membantu pengguna mengidentifikasi file Drive dengan lebih baik.

Untuk jenis file yang tidak dapat dibuat thumbnail standarnya oleh Drive, Anda dapat memberikan gambar thumbnail yang dihasilkan oleh aplikasi Anda. Selama pembuatan atau pembaruan file, upload thumbnail dengan menetapkan kolom contentHints.thumbnail pada resource files.

Khususnya:

• Tetapkan kolom contentHints.thumbnail.image ke gambar berenkode base64 yang aman bagi URL dan nama file (lihat RFC 4648 bagian 5).
• Tetapkan kolom contentHints.thumbnail.mimeType ke jenis MIME yang sesuai untuk thumbnail.

Jika Drive dapat membuat thumbnail dari file, Drive akan menggunakan thumbnail yang dibuat secara otomatis dan mengabaikan thumbnail yang mungkin telah Anda upload. Jika tidak dapat membuat thumbnail, video akan menggunakan thumbnail yang Anda berikan.

Thumbnail harus mematuhi aturan berikut:

• Dapat diupload dalam format PNG, GIF, atau JPG.
• Lebar yang direkomendasikan adalah 1.600 piksel.
• Lebar minimum adalah 220 piksel.
• Ukuran file maksimum adalah 2 MB.
• Nilai ini harus diperbarui oleh aplikasi Anda dengan setiap penyimpanan.

Penting: Thumbnail akan menjadi tidak valid setiap kali konten file berubah. Saat menyediakan thumbnail, penting untuk mengupload thumbnail baru setiap kali konten diubah. Perubahan metadata tidak akan membuat thumbnail menjadi tidak valid.

Untuk informasi selengkapnya, lihat resource files.

Mengambil thumbnail

Anda dapat mengambil metadata, termasuk thumbnail, untuk file Drive. Informasi thumbnail disimpan di kolom thumbnailLink dari resource files.

Menampilkan thumbnail tertentu

Contoh kode berikut menunjukkan permintaan metode files.get dengan beberapa kolom sebagai parameter kueri untuk menampilkan metadata thumbnailLink untuk file tertentu. Untuk informasi selengkapnya, lihat Menampilkan kolom tertentu untuk file.

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink

Ganti FILE_ID dengan fileId file yang ingin Anda temukan.

Jika tersedia, permintaan akan menampilkan URL berumur pendek ke thumbnail file. Biasanya, link ini aktif selama beberapa jam. Kolom ini hanya diisi jika aplikasi yang meminta dapat mengakses konten file. Jika file tidak dibagikan secara publik, URL yang ditampilkan di thumbnailLink harus diambil menggunakan permintaan kredensial.

Menampilkan daftar thumbnail

Contoh kode berikut menunjukkan permintaan metode files.list dengan beberapa kolom sebagai parameter kueri untuk menampilkan metadata thumbnailLink untuk daftar file. Untuk informasi selengkapnya, lihat Menelusuri file dan folder.

GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)

Untuk membatasi hasil penelusuran ke jenis file tertentu, terapkan string kueri untuk menetapkan jenis MIME. Misalnya, contoh kode berikut menunjukkan cara membatasi daftar ke file Google Spreadsheet. Untuk informasi selengkapnya tentang jenis MIME, lihat jenis MIME yang didukung Google Workspace dan Google Drive.

GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)