Mengelola metadata file

Dokumen ini mencakup pertimbangan penting untuk penamaan {i>file<i} dan bekerja dengan {i>metadata<i} seperti teks dan {i>thumbnail<i} 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 diisi dengan ekstensi yang awalnya ditentukan di properti name. Ketika seorang Pengguna Google Drive meminta untuk mengunduh file, atau saat file diunduh melalui klien sinkronisasi, Drive akan membuat nama file lengkap (dengan ) berdasarkan judul. Jika ekstensi tidak ada, Drive mencoba menentukan ekstensi berdasarkan Jenis MIME.

Menyimpan teks yang dapat diindeks

{i>Drive<i} secara otomatis mengindeks dokumen untuk pencarian ketika mengenali jenis {i>file<i}, 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 {i>string<i} teks yang dapat diindeks <section attribute="value1">Here's some text</section>, lalu "Ini beberapa teks" diindeks, tetapi "value1" tidak. Oleh karena itu, menyimpan XML sebagai dapat diindeks teks tidak sebaik 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 coba mengurutkan teks sesuai urutan kepentingannya karena pengindeks melakukannya secara efisien untuk Anda.
  • Aplikasi Anda harus memperbarui teks yang dapat diindeks setiap kali disimpan.
  • Pastikan teks terkait dengan konten atau metadata file.

Poin terakhir ini mungkin tampak jelas, tetapi ini penting. Tidak baik untuk menambahkan istilah yang sering ditelusuri untuk memaksa file muncul di hasil penelusuran. Ini dapat membuat pengguna frustrasi, dan bahkan memotivasi mereka untuk menghapus file.

Mengupload thumbnail

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

Untuk jenis file yang tidak dapat dibuat oleh Drive dan thumbnail standar Anda dapat menyediakan gambar thumbnail yang dihasilkan oleh aplikasi Anda. Selama pembuatan atau pembaruan file, upload thumbnail dengan menyetel Kolom contentHints.thumbnail pada resource files.

Khususnya:

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

Jika Drive dapat membuat thumbnail dari file, Drive akan menggunakan telah dibuat secara otomatis dan mengabaikan apa pun yang mungkin telah Anda unggah. Jika tidak dapat membuat thumbnail, model akan menggunakan thumbnail yang Anda sediakan.

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.
  • Mereka harus diupdate oleh aplikasi Anda pada setiap penyimpanan.

Untuk mengetahui informasi selengkapnya, lihat referensi files.

Mengambil thumbnail

Anda dapat mengambil metadata, termasuk thumbnail, untuk file Drive. Informasi thumbnail ditempatkan di kolom thumbnailLink halaman Referensi files.

Menampilkan thumbnail spesifik

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

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

Ganti FILE_ID dengan fileId dari file yang ingin Anda temukan.

Jika tersedia, permintaan akan menampilkan URL berumur pendek ke thumbnail file. Biasanya, link berlangsung selama beberapa jam. Kolom ini hanya diisi saat aplikasi yang meminta dapat mengakses konten file. Jika file tidak dibagikan secara publik, URL yang ditampilkan dalam 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 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 tetapkan jenis MIME. Misalnya, contoh kode berikut menunjukkan cara membatasi daftar ke file Google Sheets. Untuk informasi selengkapnya tentang jenis MIME, lihat MIME yang didukung Google Workspace dan Google Drive jenis data.

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