Dosya meta verilerini yönetme

Bu dokümanda, dosyaları adlandırma ve dosya adlandırma ile ilgili önemli hususlar ele alınmaktadır. Meta veriler (ör. dizine eklenebilir metin ve küçük resimler) Dosya eklemek ve almak için bkz. files kaynağı.

Dosya adlarını ve uzantılarını belirtin

Uygulamalar, dosya eklerken başlık özelliğinde bir dosya uzantısı belirtmelidir. Google Drive API'yi kullanın. Örneğin, bir JPEG dosyası ekleme işlemi meta veride "name": "cat.jpg" gibi bir değer belirtin.

Sonraki GET yanıtları, salt okunur fileExtension özelliğini içerebilir başlangıçta name özelliğinde belirtilen uzantıyla doldurulur. Bir Google Drive kullanıcısı dosya indirme isteğinde bulunduğunda veya dosya indirildiğinde senkronizasyon istemcisi aracılığıyla, Drive tam bir dosya adı oluşturur ( uzantısı) görürsünüz. Uzantının eksik olduğu durumlarda Drive, dosyanın uzantısına göre uzantıyı belirlemeye çalışır MIME türü.

Dizine eklenebilir metni kaydedin

'e dokunun.

Drive, aşağıdaki durumlarda dokümanları arama için otomatik olarak dizine ekler: metin dokümanları, PDF'ler, metin içeren resimler ve yaygın olan başka türlerde de kullanılır. Uygulamanız diğer dosya türlerini (ör. çizimler, video ve kısayollar) sağlanan, sağlayarak keşfedilebilirliği dizine eklenebilir metni dosyanın contentHints.indexableText alanında bulabilirsiniz.

Dizine eklenebilir metin, HTML olarak dizine eklendi. Dizine eklenebilir metin dizesini kaydederseniz <section attribute="value1">Here's some text</section>, ardından " metin" dizine eklenmiş, ancak "value1" değildir. Bu nedenle, XML'in dizine eklenebilir olarak kaydedilmesi metni, HTML'yi kaydetmek kadar yararlı değildir.

indexableText belirtirken aşağıdakileri de 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 çünkü dizinleyici bu sıralamayı yapar. etkili bir yoludur.
  • Uygulamanız her kaydedildiğinde dizine eklenebilir metni güncellemelidir.
  • Metnin, dosyanın içeriğiyle veya meta verileriyle ilgili olduğundan emin olun.

Bu son nokta aşikar görünebilir ancak önemlidir. Trafiğin zirve yaptığı saatlerin bir dosyayı arama sonuçlarında görünmeye zorlamak için yaygın olarak aranan terimleri ekleme. Bu kullanıcıları rahatsız edebilir, hatta dosyayı silmeye teşvik edebilir.

Küçük resim yükleyin

Drive, yaygın olarak kullanılan birçok dosya için otomatik olarak küçük resim oluşturur Google Dokümanlar, E-Tablolar ve Slaytlar gibi çeşitli türlerde kullanılabilir. Küçük resimler, kullanıcının Drive dosyalarını daha iyi tanıması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. Etkinlik sırasında dosya oluşturma veya güncelleme, files kaynağındaki contentHints.thumbnail alanı.

Özellikle:

  • contentHints.thumbnail.image alanını URL ve dosya adı güvenli olarak ayarlayın base64 kodlu görüntü (RFC 4648 bölümüne bakın) 5).
  • contentHints.thumbnail.mimeType alanını uygun MIME türüne ayarlayın seçeceğim.

Drive, dosyadan küçük resim oluşturabiliyorsa otomatik olarak oluşturulan bir etiket oluşturur ve yüklemiş olabileceğiniz dosyaları yok sayar. Yapamazsa sizin sağladığınız küçük resim kullanılı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 kaydedildiğinde uygulamanız tarafından güncellenir.

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

Küçük resimleri alma

Drive dosyalarının küçük resimleri de dahil olmak üzere meta verileri alabilirsiniz. Küçük resim bilgileri, resmin thumbnailLink alanında yer alır. files kaynak.

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

Aşağıdaki kod örneğinde gösterilen Şunu içeren files.get yöntem isteği: thumbnailLink meta verilerini döndürmek için sorgu parametresi olarak birden çok alan seçin. Daha fazla bilgi için Bir dosyası olarak adlandırılır.

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

FILE_ID kısmını, elde etmek istediğiniz dosyanın fileId değeriyle değiştirin bulabilirsiniz.

Varsa istek, dosyanın küçük resmine kısa ömürlü bir URL döndürür. Bağlantı genellikle birkaç saat sürer. Bu alan yalnızca şu durumlarda doldurulur: istekte bulunan uygulama dosyanın içeriğine erişebilir. Dosya paylaşılmıyorsa herkese açık olarak, thumbnailLink içinde döndürülen URL kimlik bilgisi eklenmiş istek.

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

Aşağıdaki kod örneğinde gösterilen Şunu içeren files.list yöntem isteği: thumbnailLink meta verilerini döndürmek için sorgu parametresi olarak birden çok alan bir dosya listesidir. Daha fazla bilgi için Dosya arama ve klasörleri tıklayı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ü ayarlayın. Örneğin, aşağıdaki kod örneğinde, Google E-Tablolar dosyalarına dönüştürmeyi deneyin. MIME türleri hakkında daha fazla bilgi için bkz. Google Workspace ve Google Drive destekli MIME türler olarak tanımlar.

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