Özel dosya özellikleri ekleme

Özel dosya özellikleri, bir dosyaya özel meta verileri depolamak için kullanılan anahtar/değer çiftleridir. Google Drive dosyası (etiketler gibi), diğer veri depolarındaki kimlikler, bilgiler ve iş akışı uygulamaları arasında paylaştırılır. Örneğin, açılış sayfasına özelliklerini 1. çeyrekte satış departmanı tarafından oluşturulan tüm belgelere gönderebilirsiniz.

Tüm uygulamalar tarafından görülebilen özellikler eklemek içinproperties files kaynak. Mülk eklemek için uygulamanızla sınırlıysa files kaynağının appProperties alanını kullanın.

Özellikler, aramada da kullanılabilir ifadeleri için geçerli değildir.

Bu, bir öğeyi depolamak için kullanılabilecek tipik bir mülkün yapısıdır Drive dosyasının dosyadaki veritabanı kimliği.

Drive API s3

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

Drive API s2

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

Özel dosya özellikleriyle çalışma

Bu bölümde, özel dosya özelliğiyle ilgili bazı görevlerin uygulamaları etkiler.

Ö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 öğesinin properties alanı gösterir.

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

Ayrıca bir dosyaya özel özellik eklemek için gelişmiş Google Apps Komut Dosyası'nda Drive hizmeti. Daha fazla bilgi için bkz. Özel ekleme özellikleri hakkında daha fazla bilgi edinin.

Ö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 kullanma özel dosya özelliklerini kullanabilirsiniz.

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

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

{
  "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 öğesinin properties alanı kaynağı 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 kullanma Dosya için properties nesnesi.

{
  "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.
  • Mülk dizesi (hem anahtar hem de değer dahil) başına maksimum 124 bayt UTF-8 kodlaması. Örneğin, 10 karakter uzunluğunda bir anahtarı olan bir mülk. değer yalnızca 114 karakter içerebilir. Benzer şekilde, 100 karakter kullanılmasını gerektirir, değer için en fazla 24 karakter kullanabilir tuşuna basın.

Daha fazla bilgi için files başlıklı makaleyi inceleyin. gösterir. Drive API v2 için properties kaynağı.

Gizli özel dosya özelliklerine erişme

Özel mülkleri yalnızca şurasını kullanarak alabilirsiniz: appProperties OAuth 2.0 ile alınmış bir erişim jetonunu kullanan kimliği doğrulanmış istek girin. Özel mülkleri almak için API anahtarı kullanamazsınız.