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

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

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

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

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

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

التصنيف

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

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

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

تصنيف ذو شارة

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

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

تصنيف عادي

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

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

يشير ذلك المصطلح إلى مكوِّن فردي بكتابته وقابل للضبط في تصنيف. يمكن أن يحتوي التصنيف على صفر أو أكثر من الحقول المرتبطة به.

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

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

نوع التصنيف

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

المشرف

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

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

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

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

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

    • عنصر Drive: READER
    • التصنيف: READER
الفيديوهات التي تمّت مشاركتها

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

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

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

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

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

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

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

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

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