Mengelola metadata file

Dokumen ini membahas pertimbangan penting untuk memberi nama file dan menangani metadata seperti teks dan thumbnail yang dapat diindeks. Untuk menyisipkan dan mengambil file, lihat resource 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 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 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 pada 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>, "Berikut ini beberapa teks" akan diindeks, tetapi "value1" tidak akan diindeks. Oleh karena itu, menyimpan XML sebagai teks yang dapat diindeks tidak seberguna menyimpan HTML.

Saat menentukan indexableText, perlu diingat 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 mengupdate teks yang dapat diindeks pada setiap penyimpanan.
  • Pastikan teks terkait dengan konten atau metadata file.

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

Upload thumbnail

Drive otomatis membuat thumbnail untuk berbagai jenis file umum, seperti Google Dokumen, Spreadsheet, dan Slide. Thumbnail membantu pengguna mengidentifikasi file Drive dengan lebih baik.

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

Khususnya:

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

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

Thumbnail harus mematuhi aturan berikut:

  • Dapat diupload dalam format PNG, GIF, atau JPG.
  • Lebar yang direkomendasikan adalah 1600 piksel.
  • Lebar minimum adalah 220 piksel.
  • Ukuran file maksimum adalah 2 MB.
  • Data tersebut harus diperbarui oleh aplikasi Anda setiap kali disimpan.

Untuk informasi selengkapnya, lihat referensi files.

Mengambil thumbnail

Anda dapat mengambil metadata, termasuk thumbnail, untuk file Drive. Informasi thumbnail ditempatkan di kolom thumbnailLink pada 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 mengetahui 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 yang memiliki masa aktif singkat ke thumbnail file. Biasanya, link aktif selama beberapa jam. Kolom ini hanya diisi saat aplikasi yang meminta dapat mengakses konten file. Jika file tidak dibagikan secara publik, URL yang ditampilkan di thumbnailLink harus diambil menggunakan permintaan dengan 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 mengetahui 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 untuk file Google Spreadsheet. Untuk mengetahui 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)