التصنيفات هي بيانات وصفية تحدّدها لمساعدة المستخدمين في تنظيم الملفات والبحث عنها وتطبيقها على الملفات في Google Drive. واجهة برمجة تطبيقات تصنيفات Drive هي واجهة برمجة تطبيقات RESTful تدعم عمليات النشاط التجاري عن طريق إرفاق البيانات الوصفية بملفات Drive. الاستخدامات الشائعة لواجهة برمجة التطبيقات هذه هي:
تصنيف المحتوى لاتّباع استراتيجية إدارة المعلومات: يمكنك إنشاء تصنيف لتحديد المحتوى الحسّاس أو البيانات التي تتطلّب معالجة خاصة. على سبيل المثال، يمكنك إنشاء تصنيف ذو شارة (تصنيف بقيم خيارات ذات ترميز لوني) بعنوان "الحساسية" مع قيم "سري جدًا" و"سري" و "عام".
تطبيق السياسة على العناصر في Drive - يمكنك إنشاء تصنيفات لإدارة محتوى Drive طوال مراحله والتأكُّد من التزامه بممارسات الاحتفاظ بالسجلات في مؤسستك. على سبيل المثال، استخدم التصنيفات لإدارة سياسة فقدان البيانات (DLP) حيث لا يمكن تنزيل الملفات ذات التصنيف "حساسية" التي تم تعيينها إلى "سري جدًا" على جهاز الكمبيوتر.
تنظيم الملفات والعثور عليها - يمكنك إنشاء تصنيفات لزيادة إمكانية البحث في محتوى شركتك عن طريق السماح للأشخاص في مؤسستك بالعثور على العناصر بناءً على التصنيفات وحقولها. على سبيل المثال، يمكن لشخص في مؤسستك استخدام خيارات بحث Drive للعثور على جميع العقود التي تنتظر التوقيع بحلول تاريخ محدد.
في ما يلي قائمة بالعبارات الشائعة المُستخدَمة في Drive Labels API:
- التصنيف
تم وضع البيانات الوصفية المنظَّمة في ملف على Drive. يمكن لمستخدمي Drive تعيين التصنيفات وتعيين قيم حقول التصنيفات للملفات. تتألف التصنيفات من:
- اسم التصنيف
- اسم المورد للتصنيف. يشكّل رقم تعريف التصنيف جزءًا من اسم التصنيف. ووفقًا للطلب، يكون الاسم على شكل:
labels/{id}
أوlabels/{id}@{revisionId}
. ولمزيد من المعلومات، يُرجى الاطّلاع على مراجعة التصنيف أدناه. - رقم تعريف التصنيف
- معرّف فريد عالميًا للتصنيف. ويشكّل المعرّف جزءًا من اسم التصنيف، ولكنّه يكون مختلفًا عن الاسم.
هناك نمطان للتصنيفات:
- تصنيف الشارة
تصنيف يتضمن نوع حقل
SelectionOptions
يحتوي على خيارات يمكن ترميزها بالألوان للإشارة إلى مدى الأهمية. ويتم تنفيذ ذلك من خلال ضبطbadgeConfig
من خلالProperties
علىChoice
.يعرض Drive لون الخيار الذي تم اختياره لكل ملف حتى يتمكن المستخدمون من فهم حالة الملف وتصنيفه وما إلى ذلك بوضوح. على سبيل المثال، قد يظهر خيار "سري جدًا" للتصنيف "حساسية" باللون الأحمر. لا يمكنك الحصول إلا على تصنيف واحد ذي شارة في المرة الواحدة.
- التصنيف العادي
تصنيف يحتوي على صفر أو أكثر من أنواع الحقول. قد يكون للعلامة العادية عنوان تصنيف، مثل "مشروع القمر"، ويشير إلى جميع الملفات المرتبطة بالمشروع. قد يحتوي التصنيف القياسي أيضًا على عدة حقول منظمة. على سبيل المثال، يمكن أن يحتوي التصنيف الذي يحمل العنوان "عقد" على حقول "الشركة" و"تاريخ الاستحقاق" و"الحالة" و"الموقِّعات". كل حقل من نوع محدد (نص أو تاريخ أو اختيار أو مستخدم).
|
|
- الحقل
تمثّل هذه الخاصية مكوّنًا فرديًا قابلاً للإعداد وقابلاً للتصنيف. لا يمكن أن يرتبط التصنيف بأي حقل أو أكثر.
- نوع الحقل
- نوع بيانات القيمة المرتبطة بالحقل. قابل للتهيئة كنص أو عدد صحيح أو تاريخ أو مستخدم أو تحديد. في حال ضبط الحقل باستخدام
ListOptions
، يمكنك ضبط حقول المستخدم والاختيار باستخدام قيم متعددة. يؤثر النوع الذي تم اختياره على القيم الصالحة السارية على عناصر Drive وخيارات طلب البحث المتاحة.
- الخيار
من بين الخيارات المتعددة التي يمكن للمستخدم الاختيار من بينها في الحقل
SelectionOptions
.- نوع التصنيف
وتتضمن جميع التصنيفات
LabelType
. هناك نوعان من التصنيفات:- المشرف
لإنشاء تصنيفات مملوكة للمشرف وتعديلها، يجب أن تكون مشرف حساب تمتلك امتياز إدارة التصنيفات.
يمكن للمشرفين مشاركة تصنيفات المشرفين مع أي مستخدم لمنح هذا المستخدم إمكانية الاطّلاع على عناصر Drive وتطبيقها. يتطلب تعديل قيم التصنيفات أو قراءتها في عناصر Drive الحصول على الأذونات التالية:
التعديل: لكي يتمكن المستخدم من تعديل البيانات الوصفية لعنصر Drive ذات الصلة بتسمية مُختارة، يجب أن يمتلك المستخدم مستويات الأذونات المناسبة:
- عنصر Drive:
EDITOR
- التصنيف:
APPLIER
- عنصر Drive:
القراءة: حتى يتمكن المستخدم من قراءة البيانات الوصفية لعنصر Drive ذات الصلة بتصنيف معين أو البحث عنها، يجب أن يمتلك المستخدم مستويات الأذونات المناسبة:
- عنصر Drive:
READER
- التصنيف:
READER
- عنصر Drive:
يمكن للمستخدمين غير المشرفين إنشاء تصنيفات مشتركة يمكن للآخرين تطبيقها على عناصر Drive. يمكن للفِرق إنشاء تصنيفاتها وتنظيمها لاستخدامها داخل الفريق بدون الحاجة إلى مشرف.
- تصنيف التصنيف
حقول التصنيفات المهيأة حاليًا والمتاحة للمستخدمين للتطبيق على ملفات Drive. يُعرف أيضًا باسم مخطط التصنيف.
أمثلة لتصنيفات التصنيفات:
- الحساسية: أحمر أو برتقالي أو أصفر أو أخضر
- الحالة: لم يتم البدء، المسودة، قيد المراجعة، نهائي
- نوع المحتوى: عقد، مستند تصميم، نموذج
- الإدارة - التسويق، الموارد المالية، الموارد البشرية، المبيعات
- تصنيف مراحل النشاط
تخضع التصنيفات لدورة حياة يتم إنشاؤها ونشرها وتحديثها وما إلى ذلك. وبما أنّ العلامة تجتاز دورة حياة المنتج، تتمّ زيادة تاريخ مراجعة التصنيف. ولمزيد من المعلومات، اطلع على دورة حياة التصنيف.
- مراجعة التصنيف
مثال للتصنيف. في أي وقت يتم فيه إنشاء تصنيف أو تحديثه أو نشره أو إيقافه، تتم زيادة مراجعة التصنيف.
- مسودة المراجعة
- رقم النسخة من مثيل المسودة الحالي للتصنيف. يمكنك إجراء عدّة تحديثات على أحد التصنيفات، كل منها مع زيادة مسودة رقم المراجعة بدون التأثير في النسخة المنشورة. تتيح لك القدرة على الحصول على مسودات التصنيفات اختبار تحديثات التصنيفات قبل النشر.
- نسخة منشورة
- رقم مراجعة النُسخة المنشورة من تصنيف. يعتبر التصنيف المنشور مثالاً للتصنيف المتاح حاليًا للمستخدمين.
مواضيع ذات صلة
للتعرُّف على معلومات عن التطوير باستخدام واجهات برمجة التطبيقات في Google Workspace، بما في ذلك التعامل مع المصادقة والتفويض، يُرجى الرجوع إلى بدء استخدام مطوّر برامج Google Workspace.
للتعرّف على كيفية ضبط تطبيق Labels API بسيط وتشغيله، جرِّب البدء السريع للغة Python.