نظرة عامة على Drive labels API

التصنيفات هي بيانات وصفية تحدِّدها لمساعدة المستخدمين في تنظيم الملفات والبحث عنها وتطبيق السياسات عليها في Google Drive. ‫Drive Labels API هي واجهة برمجة تطبيقات RESTful تتوافق مع العمليات التجارية من خلال إرفاق البيانات الوصفية بملفات Drive. تشمل الاستخدامات الشائعة لواجهة برمجة التطبيقات هذه ما يلي:

  • تصنيف المحتوى لاتّباع استراتيجية إدارة المعلومات: يمكنك إنشاء تصنيف لتحديد المحتوى الحسّاس أو البيانات التي تتطلب معالجة خاصة. على سبيل المثال، يمكنك إنشاء تصنيف مزوّد بشارة (تصنيف يتضمّن قيم خيارات مرمّزة بالألوان) بعنوان "الحساسية" مع القيم "سري للغاية" و"سري" و "عام".

  • تطبيق السياسة على العناصر في Drive: يمكنك إنشاء تصنيفات لإدارة محتوى Drive خلال مراحله المختلفة وضمان التزامه بممارسات الاحتفاظ بالسجلات في مؤسستك. على سبيل المثال، استخدِم التصنيفات لإدارة سياسة منع فقدان البيانات (DLP) التي لا تسمح بتنزيل الملفات التي تم ضبط تصنيف "الحساسية" فيها على "سرّي للغاية" إلى جهاز كمبيوتر.

  • تنظيم الملفات والعثور عليها: يمكنك إنشاء تصنيفات تُزيد من سهولة البحث في محتوى شركتك من خلال السماح للمستخدمين في مؤسستك بالعثور على الملفات استنادًا إلى التصنيفات والحقول. على سبيل المثال، يمكن لأحد موظفي مؤسستك استخدام خيارات البحث في Drive للعثور على جميع العقود التي تنتظر التوقيع بحلول تاريخ معيّن.

في ما يلي قائمة بالمصطلحات الشائعة الاستخدام في Drive Labels API:

التصنيف

البيانات الوصفية المنظَّمة الموضوعة في ملف Drive يمكن لمستخدمي Drive تعيين تصنيفات وضبط قيم حقول التصنيفات للملفات. تتألف التصنيفات من:

اسم التصنيف
اسم المورد الخاص بالتصنيف. يشكّل معرّف التصنيف جزءًا من اسم التصنيف. استنادًا إلى الطلب، يكون الاسم على النحو التالي: labels/{id} أو labels/{id}@{revisionId}. لمزيد من المعلومات، يُرجى الاطّلاع على قسم مراجعة التصنيف أدناه.
معرّف التصنيف
معرّف فريد عالميًا للتصنيف. يشكّل المعرّف جزءًا من اسم التصنيف، ولكن على عكس الاسم، يكون المعرّف متسقًا بين المراجعات.

هناك نمطان من التصنيفات:

تصنيف ذو شارة

تصنيف بنوع حقل SelectionOptions يحتوي على خيارات يمكن ترميزها بالألوان للإشارة إلى الأهمية. يتم ذلك من خلال ضبط badgeConfig باستخدام Properties في Choice.

يعرض Drive لون الخيار المحدّد لكل ملف حتى يتمكّن المستخدمون من فهم حالة الملف وتصنيفه وغير ذلك بوضوح. على سبيل المثال، قد يظهر الخيار "سرّي للغاية" للتصنيف الذي يحمل شارة "الحساسية" باللون الأحمر. يمكنك الحصول على تصنيف واحد يحمل شارة في كل مرة.

التصنيف العادي

تصنيف يحتوي على صفر أو أكثر من أنواع الحقول قد يتضمّن التصنيف العادي عنوانًا، مثل "مشروع Moonshot"، ويشير إلى جميع الملفات ذات الصلة بالمشروع. قد يتضمّن التصنيف العادي أيضًا عدة حقول مهيكلة. على سبيل المثال، قد يتضمّن تصنيف بعنوان "عقد" حقولاً خاصة بـ "الشركة" و"تاريخ الاستحقاق" و"الحالة" و"الموقّعين". كل حقل هو من نوع معيّن (نص أو تاريخ أو مجموعة اختيارات أو مستخدم).

مخطّط التصنيف ذي الشارة
الشكل 1. تصنيف ذو شارة
مخطط التصنيف العادي
الشكل 2. التصنيف العادي
الحقل

تمثّل هذه السمة جزءًا فرديًا من التصنيف يمكن ضبطه. يمكن أن يحتوي التصنيف على صفر أو أكثر من الحقول المرتبطة به.

نوع الحقل
نوع البيانات الخاص بالقيمة المرتبطة بالحقل يمكن ضبطها على شكل نص أو عدد صحيح أو تاريخ أو مستخدم أو اختيار. في حال ضبط الحقل باستخدام ListOptions، يمكنك ضبط حقلَي المستخدم والتحديد باستخدام قيم متعددة. يؤثر النوع الذي تختاره في القيم الصالحة التي تنطبق على عناصر Drive وخيارات طلب البحث المتاحة.
الاختيار

أحد الخيارات المتعدّدة التي يمكن للمستخدم الاختيار من بينها ضمن SelectionOptionsحقل

نوع التصنيف

تتضمّن جميع التصنيفات LabelType. هناك نوعان من التصنيفات:

المشرف

لإنشاء تصنيفات يملكها المشرف وتعديلها، يجب أن تكون مشرف حساب ولديك امتياز إدارة التصنيفات.

يمكن للمشرفين مشاركة تصنيفات المشرفين مع أي مستخدم لمنحه إمكانية عرضها وتطبيقها على عناصر Drive. يتطلّب تعديل قيم التصنيفات أو قراءتها في عناصر Drive الأذونات التالية:

  • التعديل: لكي يتمكّن مستخدم من تعديل بيانات وصفية خاصة بعنصر في Drive ومرتبطة بتصنيف معيّن، يجب أن يمتلك مستويات الأذونات المناسبة:

    • ملف Drive: EDITOR
    • التصنيف: APPLIER

  • القراءة: لكي يتمكّن المستخدم من قراءة بيانات وصفية لعنصر Drive أو البحث عنها ذات صلة بتصنيف معيّن، يجب أن تتوفّر لديه مستويات الأذونات المناسبة:

    • ملف Drive: READER
    • التصنيف: READER
المستندات المشترَكة

يمكن للمستخدمين غير المشرفين إنشاء تصنيفات مشترَكة يمكن للمستخدمين الآخرين تطبيقها على عناصر Drive. يمكن للفرق إنشاء تصنيفات خاصة بها وتنظيمها لاستخدامها داخل الفريق بدون الحاجة إلى مشرف.

تصنيف التصنيفات

حقول التصنيف التي تم ضبطها حاليًا والمتاحة للمستخدمين لتطبيقها على ملفات Drive يُعرف أيضًا باسم مخطط التصنيف.

أمثلة على تصنيفات التسميات:

  • مستوى الحساسية: أحمر، برتقالي، أصفر، أخضر
  • الحالة: لم يتم البدء، مسودة، قيد المراجعة، نهائي
  • نوع المحتوى: "تعاقد"، "مستند تصميم"، "نموذج طبق الأصل"
  • القسم: التسويق، والمالية، والموارد البشرية، والمبيعات
دورة حياة التصنيف

تمر التصنيفات بدورة حياة يتم فيها إنشاؤها ونشرها وتعديلها وما إلى ذلك. عندما تمرّ التسمية بدورة الحياة، يتم زيادة مراجعة التسمية. لمزيد من المعلومات، يُرجى الاطّلاع على دورة حياة التصنيف.

مراجعة التصنيف

مثيل للتصنيف في كل مرة يتم فيها إنشاء تصنيف أو تعديله أو نشره أو إيقافه نهائيًا، يزداد رقم مراجعة التصنيف.

مراجعة مسودّة
رقم مراجعة مسودة التصنيف الحالية. يمكنك إجراء عدّة تعديلات على تصنيف، مع زيادة رقم مراجعة المسودة في كل مرة، بدون التأثير في المراجعة المنشورة. تتيح لك ميزة استخدام تصنيفات مسودّة اختبار تعديلات التصنيفات قبل نشرها.
النسخة السابقة المنشورة
رقم المراجعة للإصدار المنشور من التصنيف. التصنيف المنشور هو نسخة التصنيف المتاحة حاليًا للمستخدمين.