REST Resource: permissions

المرجع: الإذن

إذن لملف يمنح الإذن مستخدمًا أو مجموعة أو نطاقًا أو الجميع إذن الوصول إلى ملف أو تسلسل هرمي للمجلدات.

تتطلّب بعض طرق الموارد (مثل permissions.update) استخدام permissionId. استخدِم الطريقة permissions.list لاسترداد رقم تعريف ملف أو مجلد أو مساحة تخزين سحابي مشتركة.

تمثيل JSON 
{
  "id": string,
  "name": string,
  "type": string,
  "role": string,
  "additionalRoles": [
    string
  ],
  "authKey": string,
  "value": string,
  "kind": string,
  "withLink": boolean,
  "photoLink": string,
  "selfLink": string,
  "emailAddress": string,
  "domain": string,
  "etag": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "expirationDate": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean,
  "inheritedPermissionsDisabled": boolean
}
الحقول
id

string

رقم تعريف المستخدم الذي يشير إليه هذا الإذن، وهو مطابق لرقم التعريف permissionId في موردَي "لمحة" و"الملفات" عند تقديم طلب drive.permissions.insert، يجب تحديد حقل واحد بالضبط من الحقلين id أو value ما لم يكن نوع الإذن هو anyone، وفي هذه الحالة يتم تجاهل الحقلين id وvalue.
name

string

النتائج فقط. اسم هذا الإذن
type

string

نوع الحساب القيم المسموح بها هي:

  • user
  • group
  • domain
  • anyone
role

string

الدور الأساسي لهذا المستخدم. على الرغم من أنّه قد يتمّ السماح بقيم جديدة في المستقبل، فيُسمح حاليًا بالقيم التالية:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
additionalRoles[]

string

أدوار إضافية لهذا المستخدم يُسمح حاليًا باستخدام commenter فقط، ولكن قد تتوفّر المزيد من الخيارات في المستقبل.
authKey
(deprecated)

string

النتائج فقط. تمّ الإيقاف.
value

string

عنوان البريد الإلكتروني أو اسم النطاق للكيان يُستخدَم هذا الحقل أثناء عمليات الإدراج ولا يتم تعبئته في الردود. عند تقديم طلب drive.permissions.insert، يجب تحديد حقل واحد بالضبط من الحقلين id أو value ما لم يكن نوع الإذن هو anyone، وفي هذه الحالة يتم تجاهل الحقلين id وvalue.
kind

string

النتائج فقط. يكون هذا الخيار دائمًا drive#permission.
emailAddress

string

النتائج فقط. عنوان البريد الإلكتروني للمستخدم أو المجموعة التي يشير إليها هذا الإذن هذا حقل للإخراج فقط يظهر عندما يكون نوع الإذن هو user أو group.
domain

string

النتائج فقط. اسم النطاق الخاص بالكيان الذي يشير إليه هذا الإذن هذا حقل للإخراج فقط يظهر عندما يكون نوع الإذن هو user أو group أو domain.
etag

string

النتائج فقط. علامة ETag للإذن
permissionDetails[]

object

النتائج فقط. تفاصيل حول ما إذا كانت الأذونات في هذا العنصر مكتسَبة أو مباشرةً في هذا العنصر
permissionDetails[].permissionType

string

النتائج فقط. نوع الإذن لهذا المستخدم. في حين أنّه قد تتم إضافة قيم جديدة في المستقبل، في ما يلي القيم المتاحة حاليًا:

  • file
  • member
permissionDetails[].role

string

النتائج فقط. الدور الأساسي لهذا المستخدم. في حين أنّه قد تتم إضافة قيم جديدة في المستقبل، في ما يلي القيم المتاحة حاليًا:

  • organizer
  • fileOrganizer
  • writer
  • reader
permissionDetails[].additionalRoles[]

string

النتائج فقط. أدوار إضافية لهذا المستخدم يمكن حاليًا استخدام commenter فقط، ولكن قد تتوفّر المزيد من اللغات في المستقبل.
permissionDetails[].inheritedFrom

string

النتائج فقط. معرّف العنصر الذي يتم اكتساب هذا الإذن منه لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة.
permissionDetails[].inherited

boolean

النتائج فقط. ما إذا كان هذا الإذن مكتسَبًا تتم تعبئة هذا الحقل دائمًا.
expirationDate

string

الوقت الذي ستنتهي فيه صلاحية هذا الإذن (بتنسيق التاريخ والوقت RFC 3339) تنطبق القيود التالية على تواريخ انتهاء الصلاحية:

  • ولا يمكن ضبطها إلا على أذونات المستخدمين والمجموعات.
  • يجب أن يكون التاريخ في المستقبل.
  • لا يمكن أن يكون التاريخ بعد أكثر من عام في المستقبل.
teamDrivePermissionDetails[]
(deprecated)

object

النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام permissionDetails بدلاً منها.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام permissionDetails/permissionType بدلاً منها.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام permissionDetails/role بدلاً منها.
teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام permissionDetails/additionalRoles بدلاً منها.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام permissionDetails/inheritedFrom بدلاً منها.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام permissionDetails/inherited بدلاً منها.
deleted

boolean

النتائج فقط. ما إذا تم حذف الحساب المرتبط بهذا الإذن لا يرتبط هذا الحقل إلا بأذونات المستخدمين والمجموعات.
view

string

يشير إلى طريقة عرض هذا الإذن. لا تتم تعبئة هذا الحقل إلا للأذونات التي تنتمي إلى عرض.

published

و

metadata

هي القيم الوحيدة المسموح بها.

  • published

    : دور الإذن هو published_reader.

  • metadata

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

    metadata

    لا تتوفّر هذه الميزة حاليًا إلا في المجلدات.

pendingOwner

boolean

ما إذا كان الحساب المرتبط بهذا الإذن مالكًا في انتظار المراجعة. لا يتم ملء هذا الحقل إلا لأذونات النوع user للملفات التي لا تكون في مساحة تخزين سحابي مشتركة.
inheritedPermissionsDisabled

boolean

عندما يكون هذا الحقل صحيحًا، لا يمكن الوصول إلى العنصر إلا من قِبل المنظِّمين والمالكين والمستخدمين الذين لديهم أذونات تمت إضافتها مباشرةً على العنصر.

الطُرق

delete

 لحذف إذن من ملف أو مساحة تخزين سحابي مشتركة

get

 الحصول على إذن حسب رقم التعريف

getIdForEmail

 عرض رقم تعريف الإذن لعنوان بريد إلكتروني

insert

 تُدرج إذنًا لملف أو مساحة تخزين سحابي مشترَكة.

list

 يسرد أذونات ملف أو مساحة تخزين سحابي مشتركة.

patch

 تعديل إذن باستخدام دلالات تصحيح الأخطاء

update

 تعديل إذن