نظرة عامة على 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 يُعرف أيضًا باسم مخطط التصنيف.

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

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

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

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

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

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

  • للتعرّف على تطوير التطبيقات باستخدام Google Workspace API، بما في ذلك كيفية التعامل مع المصادقة والترخيص، يُرجى الرجوع إلى مقالة بدء التطوير باستخدام Google Workspace كمطوّر.

  • للتعرّف على كيفية ضبط تطبيق بسيط باستخدام Labels API وتشغيله، يُرجى تجربة دليل البدء السريع بلغة Python.