Bu dokümanda, dosya adlandırma ve dizine eklenebilir metin, küçük resim gibi meta verilerle çalışma konusunda dikkat edilmesi gereken önemli noktalar ele alınmaktadır. Dosya eklemek ve almak için files
kaynağına bakın.
Dosya adlarını ve uzantılarını belirtin
Uygulamalar, Google Drive API'yle dosya eklerken başlık özelliğinde bir dosya uzantısı belirtmelidir. Örneğin, bir JPEG dosyası ekleme işlemi meta verilerde "name": "cat.jpg"
gibi bir değer belirtmelidir.
Sonraki GET
yanıtları, başlangıçta name
özelliğinde belirtilen uzantıyla doldurulan salt okunur fileExtension
özelliğini içerebilir. Bir Google Drive kullanıcısı bir dosyayı indirmek istediğinde veya dosya, senkronizasyon istemcisi üzerinden indirildiğinde, Drive başlığa göre tam dosya adı (uzantıyla) oluşturur. Uzantının eksik olduğu durumlarda Drive, uzantıyı dosyanın MIME türüne göre belirlemeye çalışır.
Dizine eklenebilir metni kaydet
Drive; metin dokümanları, PDF'ler, metin içeren resimler ve diğer yaygın türler dahil olmak üzere dosya türünü tanıdığında, arama için dokümanları otomatik olarak dizine ekler. Uygulamanız diğer dosya türlerini (ör. çizim, video ve kısayollar) kaydediyorsa dosyanın contentHints.indexableText
alanına dizine eklenebilir metin sağlayarak bulunabilirliği artırabilirsiniz.
Dizine eklenebilir metin, HTML olarak dizine eklenir. Dizine eklenebilir metin dizesini <section attribute="value1">Here's some text</section>
kaydederseniz "İşte metin" dizine eklenir ancak "değer1" eklenmez. Bu nedenle, XML'yi dizine eklenebilir metin olarak kaydetmek, HTML'yi kaydetmek kadar yararlı değildir.
indexableText
belirtirken şunları da unutmayın:
contentHints.indexableText
için boyut sınırı 128 KB'tır.- Kullanıcının aramasını beklediğiniz anahtar terimleri ve kavramları öğrenin.
- Metinleri önem sırasına göre sıralamaya çalışmayın. Dizine ekleme aracı bu işlemi sizin için verimli bir şekilde yapar.
- Uygulamanız her kaydetme işleminde dizine eklenebilir metni güncellemelidir.
- Metnin, dosyanın içeriği veya meta verileri ile ilişkili olduğundan emin olun.
Bu son nokta gayet açık görünebilir ancak önemlidir. Bir dosyayı arama sonuçlarında görünmeye zorlamak için, sık aranan terimleri eklemek iyi bir fikir değildir. Bu durum kullanıcıları rahatsız edebilir ve hatta onları dosyayı silmeye motive edebilir.
Küçük resim yükleme
Drive; Google Dokümanlar, E-Tablolar ve Slaytlar gibi yaygın olarak kullanılan pek çok dosya türü için otomatik olarak küçük resim oluşturur. Küçük resimler, kullanıcının Drive dosyalarını daha iyi tanımlamasına yardımcı olur.
Drive'ın standart küçük resim oluşturamadığı dosya türleri için uygulamanız tarafından oluşturulan bir küçük resim sağlayabilirsiniz. Dosya oluşturma veya güncelleme sırasında files
kaynağında contentHints.thumbnail
alanını ayarlayarak küçük resim yükleyin.
Özellikle:
contentHints.thumbnail.image
alanını URL ve dosya adı güvenli base64 olarak kodlanmış görüntüye ayarlayın (RFC 4648 bölüm 5'e bakın).contentHints.thumbnail.mimeType
alanını küçük resim için uygun MIME türüne ayarlayın.
Drive, dosyadan küçük resim oluşturabiliyorsa otomatik olarak oluşturulan küçük resmi kullanır ve yüklemiş olabileceğiniz küçük resimleri yoksayar. Küçük resim oluşturamıyorsa sizin sağladığınız küçük resmi kullanır.
Küçük resimler şu kurallara uygun olmalıdır:
- PNG, GIF veya JPG biçimlerinde yüklenebilir.
- Önerilen genişlik 1.600 pikseldir.
- Minimum genişlik 220 pikseldir.
- Maksimum dosya boyutu 2 MB'tır.
- Bunlar, her kaydetme işleminde uygulamanız tarafından güncellenir.
Daha fazla bilgi için files
kaynağına bakın.
Küçük resimleri al
Drive dosyaları için küçük resimler de dahil olmak üzere meta verileri alabilirsiniz.
Küçük resim bilgileri, files
kaynağının thumbnailLink
alanında barındırılır.
Belirli bir küçük resmi döndürme
Aşağıdaki kod örneğinde, belirli bir dosya için thumbnailLink
meta verilerini döndürecek sorgu parametresi olarak birden çok alan içeren bir files.get
yöntemi isteği gösterilmektedir. Daha fazla bilgi için Bir dosya için belirli alanları döndürme bölümüne bakın.
GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink
FILE_ID ifadesinin yerine, bulmak istediğiniz dosyanın fileId
kısmını yazın.
İstek, varsa dosyanın küçük resmine kısa ömürlü bir URL döndürür.
Bağlantının geçerlilik süresi genellikle birkaç saattir. Bu alan yalnızca istekte bulunan uygulama dosya içeriğine erişebildiğinde doldurulur. Dosya herkese açık olarak paylaşılmıyorsa thumbnailLink
içinde döndürülen URL, kimlik bilgisi içeren istek kullanılarak getirilmelidir.
Küçük resim listesini döndür
Aşağıdaki kod örneğinde, bir dosya listesi için thumbnailLink
meta verilerini döndürmek üzere sorgu parametresi olarak birden çok alan içeren bir files.list
yöntemi isteği gösterilmektedir. Daha fazla bilgi için Dosya ve klasör arama bölümüne bakın.
GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)
Arama sonuçlarını belirli bir dosya türüyle kısıtlamak için MIME türünü ayarlamak üzere bir sorgu dizesi uygulayın. Örneğin, aşağıdaki kod örneğinde listenin Google E-Tablolar dosyalarıyla nasıl sınırlandırılacağı gösterilmektedir. MIME türleri hakkında daha fazla bilgi için Google Workspace ve Google Drive tarafından desteklenen MIME türleri başlıklı makaleye göz atın.
GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)