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

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

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

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

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

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

التصنيف

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

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

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

تصنيف ذو شارة

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

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

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

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

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

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

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

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

نوع التصنيف

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

المشرف

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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