Ö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 özelliğin yapısıdır.

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

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

Özel dosya özellikleriyle çalışma

Bu bölümde, tüm uygulamaları etkileyen özel dosya özelliğiyle 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 özellikleri eklemek veya güncellemek için files.update yöntemini kullanarak files kaynağının properties alanını ayarlayı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 bir ö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 dosyaya ait 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 anahtarı olan bir özelliğin değeri yalnızca 114 karaktere sahip 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 ö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.