إضافة خصائص ملف مخصصة

خصائص الملف المخصص هي أزواج مفاتيح/قيم تُستخدم لتخزين بيانات وصفية مخصصة ملف Google Drive (مثل العلامات)، وأرقام التعريف من مخازن البيانات الأخرى، والمعلومات المشتركة بين تطبيقات سير العمل، وما إلى ذلك. على سبيل المثال، يمكنك إضافة ملف الأساسية لجميع المستندات التي تم إنشاؤها بواسطة قسم المبيعات في الربع الأول.

لإضافة سمات مرئية لجميع التطبيقات، استخدِم الحقل properties من files المرجع. لإضافة مواقع على تطبيقك، يُرجى استخدام الحقل appProperties من مورد files.

يمكن استخدام الخصائص أيضًا في البحث التعبيرات.

هذه هي بنية خاصية نموذجية يمكن استخدامها لتخزين رقم تعريف قاعدة بيانات ملف Drive على الملف

Drive API v3

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

Drive API v2

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

العمل على خصائص الملفات المخصصة

يوضح القسم كيفية تنفيذ بعض المهام المخصصة ذات الصلة بخصائص الملفات التي تؤثر على جميع التطبيقات.

إضافة خصائص الملفات المخصّصة أو تعديلها

لإضافة أو تعديل الخصائص المرئية لجميع التطبيقات، استخدِم files.update لضبط الحقل properties في files المصدر.

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

يمكنك أيضًا إضافة خاصية مخصصة إلى ملف باستخدام الخيارات المتقدمة خدمة Drive في "برمجة تطبيقات Google". لمزيد من المعلومات، يُرجى مراجعة إضافة خيار مخصّص .

الحصول على خصائص الملفات المخصّصة أو إدراجها

للاطّلاع على الخصائص المرئية لجميع التطبيقات، استخدِم files.get لاسترداد خصائص الملف المخصصة للملف.

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

يتألّف الردّ من كائن properties يحتوي على مجموعة من أزواج المفتاح/القيمة.

{
  "properties": {
    "name": "wrench",
    "mass": "1.3kg",
    "count": "3"
  }
}

حذف خصائص الملف المخصّصة

لحذف قيم الخصائص المرئية لجميع التطبيقات، استخدم files.update لضبط الحقل properties في files المورد إلى قيمة خالية.

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
{
  "name": null
}

للاطّلاع على التغيير، اطلب files.get لاسترداد الكائن properties للملف.

{
  "properties": {
    "mass": "1.3kg",
    "count": "3"
  }
}

حدود خصائص الملف المخصّصة

السمات المخصّصة لها الحدود التالية:

  • 100 خاصية مخصصة كحد أقصى لكل ملف، إجمالاً من جميع المصادر.
  • الحد الأقصى 30 ملكية عامة لكل ملف، إجمالاً من جميع المصادر.
  • الحد الأقصى 30 موقعًا خاصًا لكل ملف من أي تطبيق واحد.
  • 124 بايت كحدٍ أقصى لكل سلسلة موقع (بما في ذلك المفتاح والقيمة) في ترميز UTF-8. على سبيل المثال، الخاصية التي تحتوي على مفتاح طوله 10 أحرف يمكن أن يحتوي على 114 حرفًا فقط في القيمة. وبالمثل، فإن الموقع الذي تتطلب 100 حرف للقيمة يمكن استخدام ما يصل إلى 24 حرفًا المفتاح.

لمزيد من المعلومات، يُرجى الاطّلاع على files. المصدر. بالنسبة إلى Drive API v2، يمكنك الاطّلاع على properties.

الوصول إلى خصائص الملفات المخصصة الخاصة

يمكنك استرداد الخصائص الخاصة فقط باستخدام الحقل appProperties من خلال طلب تمت مصادقته يستخدم رمز دخول تم الحصول عليه من خلال OAuth 2.0 معرِّف العميل. لا يمكنك استخدام مفتاح واجهة برمجة التطبيقات لاسترداد المواقع الخاصة.