خصائص الملف المخصص هي أزواج مفاتيح/قيم تُستخدم لتخزين بيانات وصفية مخصصة ملف 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
معرِّف العميل. لا يمكنك استخدام مفتاح واجهة برمجة التطبيقات لاسترداد المواقع الخاصة.