REST Resource: labels.permissions

المورد: LabelPermission

الإذن الذي ينطبق على جهة أساسية (مستخدم أو مجموعة أو جمهور) في تصنيف معيّن

تمثيل JSON
{
  "name": string,
  "email": string,
  "role": enum (LabelRole),

  // Union field principal can be only one of the following:
  "person": string,
  "group": string,
  "audience": string
  // End of list of possible types for union field principal.
}
الحقول
name

string

اسم المورد الخاص بهذا الإذن.

email

string

تحدّد هذه السمة عنوان البريد الإلكتروني الخاص بمستخدم أو مجموعة أساسية. لا تتم تعبئة هذا الحقل لأسماء الجهات الرئيسية للجمهور. لا يمكن إدراج أذونات المستخدمين والمجموعات إلا باستخدام عنوان بريد إلكتروني. في طلبات التعديل، إذا تم تحديد عنوان البريد الإلكتروني، يجب عدم تحديد أي جهة مسؤولة.

role

enum (LabelRole)

الدور الذي يجب أن يكون لدى المستخدم الأساسي.

حقل الدمج principal الجهة الرئيسية التي ينطبق عليها هذا الإذن يجب أن يكون إما بريدًا إلكترونيًا أو مستخدمًا أو مجموعة أو جمهورًا. مثال: * people/12345 * groups/45678 * audiences/default principal يمكن أن تكون إحدى القيم التالية فقط:
person

string

اسم مورد الشخص

group

string

اسم مورد المجموعة.

audience

string

الجمهور الذي سيتم منح دور له. يمكن استخدام القيمة السحرية audiences/default لتطبيق الدور على الجمهور التلقائي في سياق المؤسسة التي تمتلك التصنيف.

LabelRole

تتداخل الأدوار مع الدور التالي.

عمليات التعداد
LABEL_ROLE_UNSPECIFIED دور غير معروف.
READER يمكن للقارئ قراءة التصنيف والبيانات الوصفية المرتبطة به والمطبَّقة على عناصر Drive.
APPLIER يمكن للمطبِّق كتابة بيانات وصفية مرتبطة بعناصر Drive التي لديه أيضًا إذن بالكتابة فيها. يشير إلى READER.
ORGANIZER يمكن للمنظِّم تثبيت هذا التصنيف في مساحات Drive المشتركة التي يديرها وإضافة مستخدمين جدد لتطبيق التصنيف.
EDITOR يمكن للمحرّرين إجراء أي تعديل، بما في ذلك حذف التصنيف الذي يؤدي أيضًا إلى حذف البيانات الوصفية لعنصر Drive المرتبط. يشير إلى APPLIER.

الطُرق

batchDelete

يحذف أذونات التصنيفات.

batchUpdate

تعديل أذونات التصنيفات

create

تعديل أذونات تصنيف

delete

يحذف هذا الإجراء إذن التصنيف.

list

تعرض هذه الطريقة أذونات التصنيف.