نظرة عامة على واجهة برمجة تطبيقات تصنيفات Drive

التصنيفات هي بيانات وصفية تُحدّدها لمساعدة المستخدمين على تنظيم الملفات في 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 لون الخيار المحدَّد لكل ملف حتى يتمكن المستخدمون من فهم حالة الملف وتصنيفه وما إلى ذلك بوضوح. على سبيل المثال، قد يظهر الخيار "أهم سري" للتصنيف الذي يحمل شارة "الحساسية" باللون الأحمر. يمكنك الحصول على تصنيف واحد فقط ذي شارة في كل مرة.

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

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

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

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

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

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

نوع التصنيف

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

المشرف

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • لمعرفة كيفية إعداد وتشغيل تطبيق label API بسيط، جرِّب البدء السريع لاستخدام Python.