Özel dosya özellikleri, bir Google Drive dosyası için özel meta verileri (etiketler gibi), 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 dokümanlara 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 kısıtlanmış mülkler 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.
Drive API s3
"appProperties": {
"additionalID": "ID",
}
Drive API s2
{
'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 özelliklerini ekleme veya güncelleme
Tüm uygulamalara görünür olan ö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 özellik ekleme bölümüne bakın.
Özel dosya özelliklerini alma veya listeleme
Tüm uygulamalara görünür olan ö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 çiftlerinin koleksiyonunu içeren bir properties nesnesinden oluşur.
{
"properties": {
"name": "wrench",
"mass": "1.3kg",
"count": "3"
}
}
Özel dosya özelliklerini silme
Tüm uygulamaların görebildiği özellik 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 özellikleriyle ilgili sınırlamalar
Özel mülklerde aşağıdaki sınırlar geçerlidir:
- Dosya başına en fazla 100 özel özellik (tüm kaynaklardan toplanır).
- Dosya başına en fazla 30 herkese açık mülk. Tüm kaynaklardan toplamda 30 tane herkese açık mülk.
- Herhangi bir uygulamadan dosya başına en fazla 30 gizli mülk.
- UTF-8 kodlamasında mülk dizesi (hem anahtar hem de değer dahil) başına maksimum 124 bayt. Ö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.
Gizli özel dosya özelliklerine erişme
Özel mülkleri yalnızca appProperties alanını kullanan ve OAuth 2.0 istemci kimliğiyle edinilmiş bir erişim jetonu kullanan kimliği doğrulanmış bir istek üzerinden alabilirsiniz. Özel mülkleri almak için API anahtarı kullanamazsınız.