Özel dosya özellikleri, bir Google Drive dosyası için özel meta verileri (etiketler gibi), diğer veri depolarından gelen 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 özellikleri 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'sı v3
"appProperties": {
"additionalID": "ID",
}
Drive API'sı v2
{
'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 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 da bir dosyaya özel özellik ekleyebilirsiniz. Daha fazla bilgi için Özel mülk ekleme bölümüne bakın.
Özel dosya özelliklerini alma veya listeleme
Tüm uygulamaların görebildiği özellikleri görüntülemek için dosyanın özel dosya özelliklerini almak amacıyla files.get yöntemini kullanı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.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 files.get yöntemini çağırarak dosyanın properties nesnesini alın.
{
"properties": {
"mass": "1.3kg",
"count": "3"
}
}
Özel dosya özelliklerinin sınırları
Özel mülklerde aşağıdaki sınırlar geçerlidir:
- Dosya başına, tüm kaynaklardan toplanan en fazla 100 özel özellik.
- Dosya başına, tüm kaynaklardan toplanan 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 (hem anahtar hem de değer dahil). Örneğin, 10 karakter uzunluğunda bir anahtara sahip bir özelliğin değeri yalnızca 114 karakter içerebilir. 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 göz atın. Drive API v2 için properties kaynağına bakın.
Gizli özel dosya özelliklerine erişim
Özel mülkleri yalnızca appProperties alanını kullanarak, OAuth 2.0 istemci kimliğiyle alınmış bir erişim jetonu kullanan kimliği doğrulanmış bir istek üzerinden alabilirsiniz. Özel mülkleri almak için API anahtarı kullanamazsınız.