تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
التصنيفات هي بيانات وصفية تحدِّدها لمساعدة المستخدمين في تنظيم الملفات والبحث عنها وتطبيق السياسات عليها في Google Drive. Drive Labels API هي واجهة برمجة تطبيقات RESTful تتوافق مع العمليات التجارية من خلال إرفاق البيانات الوصفية بملفات Drive. تشمل الاستخدامات الشائعة لواجهة برمجة التطبيقات هذه ما يلي:
تصنيف المحتوى لاتّباع استراتيجية إدارة المعلومات: يمكنك إنشاء تصنيف لتحديد المحتوى الحسّاس أو البيانات التي تتطلب معالجة خاصة.
على سبيل المثال، يمكنك إنشاء تصنيف مزوّد بشارة (تصنيف يتضمّن قيم خيارات مرمّزة بالألوان) بعنوان "الحساسية" مع القيم "سري للغاية" و"سري" و "علني".
تطبيق السياسة على العناصر في Drive: يمكنك إنشاء تصنيفات لإدارة محتوى Drive خلال مراحله المختلفة وضمان التزامه بممارسات الاحتفاظ بالسجلات في مؤسستك. على سبيل المثال، استخدِم التصنيفات لإدارة سياسة منع فقدان البيانات (DLP) التي لا تسمح بتنزيل الملفات التي تم ضبط تصنيف "الحساسية" فيها على "سرّي للغاية" إلى جهاز كمبيوتر.
تنظيم الملفات والعثور عليها: يمكنك إنشاء تصنيفات تُزيد من سهولة البحث في محتوى شركتك من خلال السماح للمستخدمين في مؤسستك بالعثور على الملفات استنادًا إلى التصنيفات والحقول. على سبيل المثال، يمكن لأحد موظفي مؤسستك استخدام خيارات البحث في Drive للعثور على جميع العقود التي تنتظر التوقيع بحلول تاريخ معيّن.
في ما يلي قائمة بالمصطلحات الشائعة الاستخدام في Drive Labels API:
البيانات الوصفية المنظَّمة الموضوعة في ملف Drive
يمكن لمستخدمي Drive تعيين التصنيفات وضبط قيم حقول التصنيفات للملفات. تتألف التصنيفات من:
اسم التصنيف
اسم المورد الخاص بالتصنيف. يشكّل معرّف التصنيف جزءًا من اسم التصنيف. استنادًا إلى الطلب، يكون الاسم على النحو التالي:
labels/{id} أو labels/{id}@{revisionId}. لمزيد من المعلومات، يُرجى الاطّلاع على مراجعة التصنيف أدناه.
معرّف التصنيف
معرّف فريد عالميًا للتصنيف. يشكّل المعرّف جزءًا من اسم التصنيف، ولكن على عكس الاسم، يكون المعرّف متسقًا بين المراجعات.
يعرض Drive لون الخيار المحدّد لكل ملف حتى يتمكّن المستخدمون من فهم حالة الملف وتصنيفه وغير ذلك بوضوح.
على سبيل المثال، قد يظهر الخيار "سرّي للغاية" للتصنيف الذي يحمل شارة "الحساسية" باللون الأحمر. يمكنك الحصول على تصنيف واحد يحمل شارة في كل مرة.
التصنيف العادي
تصنيف يحتوي على صفر أو أكثر من أنواع الحقول قد يتضمّن التصنيف العادي عنوانًا، مثل "مشروع Moonshot"، ويشير إلى جميع الملفات ذات الصلة بالمشروع. قد يتضمّن التصنيف العادي أيضًا عدة حقول مهيكلة. على سبيل المثال، قد يحتوي تصنيف بعنوان "عقد" على حقول "الشركة" و"تاريخ الاستحقاق" و"الحالة" و"الموقّعون". كل حقل هو من نوع معيّن (نص أو تاريخ أو مجموعة اختيارات أو مستخدم).
تمثّل هذه السمة جزءًا فرديًا من التصنيف يمكن ضبطه. يمكن أن يحتوي التصنيف على صفر أو أكثر من الحقول المرتبطة به.
نوع الحقل
نوع البيانات الخاص بالقيمة المرتبطة بالحقل يمكن ضبطها كنص أو عدد صحيح أو تاريخ أو مستخدم أو اختيار. إذا ضبطت الحقل باستخدام
ListOptions، يمكنك ضبط حقلَي المستخدم والتحديد باستخدام قيم متعددة. يؤثر النوع الذي تم اختياره في كل من القيم الصالحة التي تنطبق على عناصر Drive وخيارات طلب البحث المتاحة.
تتضمّن جميع التصنيفات LabelType. هناك نوعان من التصنيفات:
المشرف
لإنشاء تصنيفات يملكها المشرف وتعديلها، يجب أن تكون مشرف حساب ولديك امتياز إدارة التصنيفات.
يمكن للمشرفين مشاركة تصنيفات المشرفين مع أي مستخدم لمنحه إذن عرضها وتطبيقها على عناصر Drive. يتطلّب تعديل قيم التصنيفات أو قراءتها في عناصر Drive الأذونات التالية:
التعديل: لكي يتمكّن مستخدم من تعديل بيانات وصفية خاصة بعنصر في Drive ومرتبطة بتصنيف معيّن، يجب أن يمتلك مستويات الأذونات المناسبة:
ملف Drive: EDITOR
التصنيف: APPLIER
القراءة: لكي يتمكّن المستخدم من قراءة بيانات وصفية لعنصر في Drive أو البحث عنها ذات صلة بتصنيف معيّن، يجب أن تتوفّر لديه مستويات الأذونات المناسبة:
ملف Drive: READER
التصنيف: READER
المشاركة
يمكن للمستخدمين غير المشرفين إنشاء تصنيفات مشتركة يمكن للمستخدمين الآخرين تطبيقها على عناصر Drive. يمكن للفرق إنشاء تصنيفات خاصة بها وتنظيمها لاستخدامها داخل الفريق بدون الحاجة إلى مشرف.
تصنيف التصنيفات
حقول التصنيف التي تم إعدادها حاليًا والمتاحة للمستخدمين لتطبيقها على ملفات Drive يُعرف أيضًا باسم مخطط التصنيف.
أمثلة على تصنيفات التسميات:
الحساسية: أحمر، برتقالي، أصفر، أخضر
الحالة: "لم يتم البدء" أو "مسودة" أو "قيد المراجعة" أو "نهائي"
نوع المحتوى: "تعاقد"، "مستند تصميم"، "نموذج طبق الأصل"
تمر التصنيفات بدورة حياة يتم خلالها إنشاؤها ونشرها وتعديلها وما إلى ذلك. عندما يمر التصنيف بدورة حياته، يتم زيادة مراجعة التصنيف. لمزيد من المعلومات، يُرجى الاطّلاع على دورة حياة التصنيف.
مراجعة التصنيف
مثيل للتصنيف في كل مرة يتم فيها إنشاء تصنيف أو تعديله أو نشره أو إيقافه نهائيًا، يزداد رقم مراجعة التصنيف.
مراجعة مسودّة
رقم مراجعة مسودة التصنيف الحالية. يمكنك إجراء عدّة تعديلات على تصنيف، مع زيادة رقم مراجعة المسودة في كل مرة، بدون التأثير في المراجعة المنشورة. تتيح لك ميزة إنشاء مسودات للتصنيفات اختبار التعديلات على التصنيفات قبل نشرها.
النسخة السابقة المنشورة
رقم المراجعة للإصدار المنشور من التصنيف التصنيف المنشور هو نسخة التصنيف المتاحة حاليًا للمستخدمين.
مواضيع ذات صلة
للتعرّف على كيفية التطوير باستخدام واجهات Google Workspace API، بما في ذلك كيفية التعامل مع المصادقة والتفويض، يُرجى الرجوع إلى بدء استخدام Google Workspace كمطوّر.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Drive Labels API overview\n\n*Labels* are metadata that you define to help users organize, find, and apply\npolicy to files in Google Drive. The Drive Labels API is a RESTful API that\nsupports business processes by attaching metadata to your Drive\nfiles. Common uses for this API are:\n\n- **Classify content to follow an information governance strategy**---Create a\n label to identify sensitive content or data that requires special handling.\n For example, you might create a badged label (a label with color-coded\n option values) titled \"Sensitivity\" with the values of \"Top Secret,\"\n \"Confidential,\" and \"Public.\"\n\n- **Apply policy to items in Drive**---Create labels to manage\n Drive content throughout its lifecycle and ensure it adheres\n to your organization's record keeping practices. For example, use labels to\n manage a data loss policy (DLP) whereby files with a \"Sensitivity\" label set\n to \"Top Secret\" can't be downloaded to a computer.\n\n- **Curate and find files**---Create labels to increase searchability of your\n company's content by letting people in your organization find items based on\n labels and their fields. For example, someone in your organization could use\n Drive search options to find all contracts awaiting signature\n by a specific date.\n\nBelow is a list of common terms used in the Drive Labels API:\n\n[*Label*](/workspace/drive/labels/reference/rest/v2/labels#resource:-label)\n\n: Structured metadata placed on a Drive file.\n Drive users can assign labels and set label field values for\n files. Labels are composed of:\n\n *Label name*\n : The resource name of the label. The *label ID* makes up part of the\n Label name. Depending on the request, the name is in the form of either:\n `labels/{id}` or `labels/{id}@{revisionId}`. For more information, see\n [Label revision](#revision) below.\n\n *Label ID*\n : A globally unique identifier for the label. The ID makes up part of the\n label name, but unlike the name, it's consistent between revisions.\n\n There are 2 styles of labels:\n\n *Badged label*\n\n : A label with a\n [`SelectionOptions`](/workspace/drive/labels/reference/rest/v2/labels#selectionoptions)\n field type containing *choices* that can be color-coded to indicate\n importance. This is done by setting\n [`badgeConfig`](/workspace/drive/labels/reference/rest/v2/labels#BadgeConfig)\n through the\n [`Properties`](/workspace/drive/labels/reference/rest/v2/labels#properties_1) of a\n [`Choice`](/workspace/drive/labels/reference/rest/v2/labels#choice).\n\n Drive displays the color of the chosen option for each file so users\n clearly understand the status, classification, and so on, of the file.\n For example, the \"Top Secret\" option for the \"Sensitivity\" badged label\n might display in red. You can only have one badged label at a time.\n\n *Standard label*\n\n : A label containing zero or more *field type*s. A standard label might\n have a label title, such as \"Project Moonshot,\" and indicate all files\n related to the project. A standard label might also have several\n structured fields. For example, a label with the title \"Contract\" might\n contain the fields for \"Company,\" \"Due Date,\" \"Status,\" and\n \"Signatories.\" Each field is of a specific type (text, date,\n selection, or user).\n\n|----------------------------|------------------------------|\n| **Figure 1.** Badged label | **Figure 2.** Standard label |\n\n[*Field*](/workspace/drive/labels/reference/rest/v2/labels#field)\n\n: An individual typed, settable component of a label. A label can have zero or\n more fields associated with it.\n\n *Field type*\n : The data type of the value associated with the *field* . Configurable as\n text, integer, date, user, or selection. If you configure the field with\n `ListOptions`, you can set the user and selection fields with multiple\n values. The type chosen impacts both the valid values applicable to\n Drive items and the search query options available.\n\n[*Choice*](/workspace/drive/labels/reference/rest/v2/labels#choice)\n\n: One of several options a user can choose from within a `SelectionOptions`\n field.\n\n[*Label type*](/workspace/drive/labels/reference/rest/v2/labels#labeltype)\n\n: All labels include a `LabelType`. There are 2 types of labels:\n\n *Admin*\n\n : To create and edit admin-owned labels, you must be an account\n administrator with the\n [Manage Labels](https://support.google.com/a/answer/1219251#drive_and_docs)\n privilege.\n\n Admins can share admin labels with any user to grant that user the\n ability to view and apply them to Drive items. Modifying or reading\n label values on Drive items requires the following permissions:\n\n - Modifying---For a user to modify the Drive item metadata related to a\n given label, the user must have the appropriate permission levels:\n\n - Drive item: `EDITOR`\n - Label: `APPLIER`\n - Reading---For a user to read or search for the Drive item metadata\n related to a given label, the user must have the appropriate\n permission levels:\n\n - Drive item: `READER`\n - Label: `READER`\n\n *Shared*\n\n : Non-administrator users can create shared labels that others can apply\n to Drive items. Teams can create and organize their own labels for use\n within the team without requiring an administrator.\n\n | **Note:** Shared labels are only available in a closed beta that isn't currently accepting new customers.\n\n*Label taxonomy*\n\n: The currently configured label fields available to users for application to\n Drive files. Also known as the label schema.\n\n Example label taxonomies:\n\n - Sensitivity---Red, Orange, Yellow, Green\n - Status---Not Started, Draft, In Review, Final\n - Content type---Contract, Design Doc, Mockup\n - Department---Marketing, Finance, Human Resources, Sales\n\n[*Label lifecycle*](/workspace/drive/labels/reference/rest/v2/labels#lifecycle)\n\n: Labels go through a lifecycle where they're created, published, updated, and\n so on. As a label makes it through the lifecycle, its *label revision* is\n incremented. For more information, see [Label lifecycle](/workspace/drive/labels/guides/label-lifecycle).\n\n*Label revision*\n\n: An instance of the label. Anytime a label is created, updated, published, or\n deprecated, the label revision increments.\n\n *Draft revision*\n : The revision number of the current draft instance of the label. You can\n make several updates to a label, each incrementing its draft revision\n number, without affecting the published revision. The ability to have\n draft labels lets you test label updates before publishing.\n\n *Published revision*\n : The revision number of the published version of a label. The published\n label is the instance of the label currently available to users.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Get started as a\n Google Workspace\n developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Labels API app, try the\n [Python quickstart](/workspace/drive/labels/quickstart/python)."]]
