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

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

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

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

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

في ما يلي قائمة بالمصطلحات الشائعة المُستخدَمة في Drive Label 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. يُعرف أيضًا باسم مخطط التسمية.

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

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

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

نسخة سابقة للتصنيف

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

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

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

  • للتعرّف على كيفية ضبط وتشغيل تطبيق بسيط لواجهة برمجة التطبيقات marker API، يمكنك تجربة التشغيل السريع على Python.