Dosya meta verilerini yönetme

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)