Özel dosya özellikleri ekleme

Özel dosya özellikleri, Google Drive dosyası için özel meta verileri (ör. etiketler), diğer veri depolarındaki kimlikleri, iş akışı uygulamaları arasında paylaşılan bilgileri vb. depolamak için kullanılan anahtar-değer çiftleridir. Örneğin, 1. çeyrekte satış departmanı tarafından oluşturulan tüm belgelere dosya özellikleri ekleyebilirsiniz.

Tüm uygulamaların görebileceği özellikler eklemek için files kaynağının properties alanını kullanın. Uygulamanızla sınırlı özellikler eklemek için files kaynağının appProperties alanını kullanın.

Özellikler arama ifadelerinde de kullanılabilir.

Bu, bir Drive dosyasının veritabanı kimliğini dosyada depolamak için kullanılabilecek tipik bir özelliğin yapısıdır.

Drive API v3

"appProperties": {
  "additionalID": "ID",
}

Drive API v2

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

Özel dosya özellikleriyle çalışma

Bu bölümde, tüm uygulamaları etkileyen bazı özel dosya özelliğiyle ilgili görevlerin nasıl gerçekleştirileceği açıklanmaktadır.

Özel dosya özellikleri ekleme veya güncelleme

Tüm uygulamalar tarafından görülebilen özellikleri eklemek veya güncellemek için files kaynağının properties alanını ayarlamak üzere files.update yöntemini kullanın.

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
 
{
  "properties": {
    "name": "wrench",
    "mass": "1.3kg",
    "count": "3"
  }
}

Google Apps Komut Dosyası'ndaki gelişmiş Drive hizmetini kullanarak bir dosyaya özel özellik de ekleyebilirsiniz. Daha fazla bilgi için Özel özellikler ekleme başlıklı makaleyi inceleyin.

Özel dosya özelliklerini alma veya listeleme

Tüm uygulamalar tarafından görülebilen özellikleri görüntülemek için files.get yöntemini kullanarak dosyanın özel dosya özelliklerini alın.

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=properties

Yanıt, anahtar/değer çiftleri koleksiyonunu içeren bir properties nesnesinden oluşur.

{
  "properties": {
    "name": "wrench",
    "mass": "1.3kg",
    "count": "3"
  }
}

Özel dosya özelliklerini silme

Tüm uygulamalar tarafından görülebilen özellik değerlerini silmek için files kaynağının properties alanını null olarak ayarlamak üzere files.update yöntemini kullanın.

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
 
{
  "name": null
}

Değişikliği görüntülemek için dosyanın properties nesnesini almak üzere files.get yöntemini çağırın.

{
  "properties": {
    "mass": "1.3kg",
    "count": "3"
  }
}

Özel dosya özelliklerinin sınırları

Özel özelliklerle ilgili aşağıdaki sınırlar geçerlidir:

  • Tüm kaynaklardan toplamda dosya başına en fazla 100 özel özellik.
  • Tüm kaynaklardan toplamda dosya başına en fazla 30 genel özellik.
  • Herhangi bir uygulamadan gelen dosya başına en fazla 30 özel özellik.
  • UTF-8 kodlamasında özellik dizesi başına (hem anahtar hem de değer dahil) en fazla 124 bayt. Örneğin, anahtarı 10 karakter uzunluğunda olan bir özelliğin değerinde yalnızca 114 karakter olabilir. Benzer şekilde, değer için 100 karakter gerektiren bir özellik, anahtar için en fazla 24 karakter kullanabilir.

Daha fazla bilgi için files kaynağına bakın. Drive API v2 için properties kaynağına bakın.

Özel dosya özelliklerine erişme

Özel özellikleri yalnızca OAuth 2.0 istemci kimliğiyle elde edilen bir erişim jetonu kullanan kimliği doğrulanmış bir istek aracılığıyla appProperties alanını kullanarak alabilirsiniz. Özel mülkleri almak için API anahtarı kullanamazsınız.