نظرة عامة على 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 وخيارات طلبات البحث المتاحة.
Choice

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

نوع التصنيف

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

المشرف

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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