Özel dosya özellikleri ekleme

Özel dosya özellikleri, bir 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 tarafından görülebilen ö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, Drive dosyasının veritabanı kimliğini dosyada depolamak için kullanılabilecek tipik bir mülkün 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 özel dosya özellikleriyle ilgili bazı 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 mülkler eklemek veya mevcut mülkleri 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 da bir dosyaya özel özellik ekleyebilirsiniz. Daha fazla bilgi için Özel mülkler 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 dosyanın özel dosya özelliklerini almak üzere files.get yöntemini kullanın.

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

Yanıt, anahtar/değer çiftleri koleksiyonu 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 mülk değerlerini silmek için files.update yöntemini kullanarak files kaynağının properties alanını null olarak ayarlayı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 mülklerde aşağıdaki sınırlamalar geçerlidir:

  • Tüm kaynaklardan toplanan dosya başına maksimum 100 özel mülk.
  • Tüm kaynaklardan toplanan dosya başına en fazla 30 herkese açık mülk.
  • Herhangi bir uygulamadan dosya başına en fazla 30 özel mülk.
  • UTF-8 kodlamasında mülk dizesi başına maksimum 124 bayt (anahtar ve değer dahil). Örneğin, 10 karakter uzunluğunda bir anahtara sahip bir mülkte değer yalnızca 114 karakter uzunluğunda olabilir. Benzer şekilde, değer için 100 karakter gerektiren bir mülk, 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 özel dosya özelliklerine erişme

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 özel mülkleri alabilirsiniz. Özel mülkleri almak için API anahtarı kullanamazsınız.