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)