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
}
الحقول
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 هي القيمة الوحيدة المسموح بها.
pendingOwner

boolean

ما إذا كان الحساب المرتبط بهذا الإذن مالكًا غير نهائي تتم تعبئة هذا الحقل فقط لأذونات النوع "user" للملفات التي ليست في مساحة تخزين سحابي مشتركة.

الطُرق

delete

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

get

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

getIdForEmail

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

insert

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

list

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

patch

 تعديل الإذن باستخدام دلالات رموز التصحيح

update

 تعديل إذن