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)