Dosya meta verilerini yönetme

Bu dokümanda, dosya adlandırma ve dizine eklenebilir metin ve küçük resimler gibi meta verilerle çalışmayla ilgili önemli noktalar ele alınmaktadır. Dosya eklemek ve almak için files kaynağına bakın.

Dosya adlarını ve uzantılarını belirtme

Uygulamalar, Google Drive API ile dosya eklerken başlık mülkünde bir dosya uzantısı belirtmelidir. Örneğin, JPEG dosyası ekleme işlemi meta verilerde "name": "cat.jpg" gibi bir şey belirtmelidir.

Sonraki GET yanıtları, name mülkünde başlangıçta belirtilen uzantıyla doldurulan salt okunur fileExtension mülkünü içerebilir. Bir Google Drive kullanıcısı dosya indirme isteğinde bulunduğunda veya dosya senkronizasyon istemcisi aracılığıyla indirildiğinde Drive, başlığa göre tam dosya adını (uzantıyla birlikte) 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 kaydetme

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 dokümanları arama için otomatik olarak dizine ekler. Uygulamanız başka dosya türleri (ör. çizimler, videolar ve kısayollar) kaydediyorsa dosyanın contentHints.indexableText alanına dizine eklenebilir metin ekleyerek keşfedilebilirliği artırabilirsiniz.

Dizine eklenebilir metin, HTML olarak dizine eklenir. Dizine eklenebilir metin dizesini <section attribute="value1">Here's some text</section> kaydederseniz "Burada bazı metinler var" dizesi dizine eklenir ancak "değer1" dizesi dizine eklenmez. Bu nedenle, XML'i dizine eklenebilir metin olarak kaydetmek HTML kaydetmek kadar yararlı değildir.

indexableText değerini belirtirken aşağıdakileri de göz önünde bulundurun:

  • contentHints.indexableText için boyut sınırı 128 KB'tır.
  • Kullanıcıların aramasını beklediğiniz anahtar terimleri ve kavramları yakalayın.
  • Dizine ekleyen, metni sizin için verimli bir şekilde önem sırasına göre sıralar. Bu nedenle, metni önem sırasına göre sıralamaya çalışmayın.
  • Uygulamanız, her kayıtta dizine eklenebilir metni güncellemelidir.
  • Metnin, dosyanın içeriği veya meta verileriyle alakalı olduğundan emin olun.

Bu son nokta, aşikar görünse de önemlidir. Bir dosyanın arama sonuçlarında görünmesini sağlamak için sık aranan terimler eklemek iyi bir fikir değildir. Bu durum kullanıcıları rahatsız edebilir ve hatta dosyayı silmeye teşvik edebilir.

Küçük resim yükleme

Drive, Google Dokümanlar, E-Tablolar ve Slaytlar gibi yaygın dosya türleri için otomatik olarak küçük resimler oluşturur. Küçük resimler, kullanıcıları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ştururken veya güncellerken files kaynağındaki contentHints.thumbnail alanını ayarlayarak küçük resim yükleyin.

Özellikle:

  • contentHints.thumbnail.image alanını, URL ve dosya adı için güvenli Base64 olarak kodlanmış resme 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şturamazsa sağladığınız küçük resmi kullanır.

Küçük resimler aşağıdaki kurallara uygun olmalıdır:

  • PNG, GIF veya JPG biçimlerinde yüklenmelidir.
  • Önerilen genişlik 1.600 pikseldir.
  • Minimum genişlik 220 pikseldir.
  • Maksimum dosya boyutu 2 MB'tır.
  • Bu veriler, her kayıt işleminde uygulamanız tarafından güncellenmelidir.

Daha fazla bilgi için files kaynağına bakın.

Küçük resimleri alma

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 yer alır.

Belirli bir küçük resmi döndürme

Aşağıdaki kod örneğinde, belirli bir dosyanın thumbnailLink meta verilerini döndürmek için sorgu parametresi olarak birden fazla alan içeren bir files.get yöntem isteği gösterilmektedir. Daha fazla bilgi için Bir dosya için belirli alanları döndürme başlıklı makaleyi inceleyin.

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

FILE_ID yerine, bulmak istediğiniz dosyanın fileId değerini yazın.

Mevcutsa istek, dosyanın küçük resminin kısa süreli URL'sini döndürür. Bağlantı genellikle birkaç saat sürer. Alan yalnızca istek gönderen uygulama dosyanın 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 isteğinde bulunarak getirilmelidir.

Küçük resimlerin listesini döndürme

Aşağıdaki kod örneğinde, bir dosya listesinin thumbnailLink meta verilerini döndürmek için sorgu parametresi olarak birden fazla alan içeren bir files.list yöntem isteği gösterilmektedir. Daha fazla bilgi için Dosya ve klasör arama başlıklı makaleyi inceleyin.

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

Arama sonuçlarını belirli bir dosya türüyle sınırlamak 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'ın desteklediği MIME türleri başlıklı makaleyi inceleyin.

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