REST Resource: permissions

المورد: إذن

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

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

تمثيل JSON
{
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}
الحقول
id

string

الإخراج فقط. رقم تعريف هذا الإذن. تمثّل هذه السمة معرّفًا فريدًا للمستلِم، ويتم نشره في موارد المستخدم باسم permissionId. يجب التعامل مع أرقام التعريف على أنّها قيم مبهمة.

displayName

string

الإخراج فقط. الاسم "الجميلة" لقيمة الإذن. في ما يلي قائمة بأمثلة لكل نوع من الأذونات:

  • user - الاسم الكامل للمستخدم، على النحو المحدّد لحسابه على Google، مثل "يوسف كمال"
  • group - اسم مجموعة Google، مثل "مشرفي الشركة"
  • domain: اسم نطاق السلسلة، مثل "thecompany.com"
  • anyone - لا يوجد displayName.
type

string

نوع المستفيد القيم الصالحة هي:

  • user
  • group
  • domain
  • anyone

عند إنشاء إذن، إذا كان type هو user أو group، يجب توفير emailAddress للمستخدم أو المجموعة. عندما تكون قيمة type هي domain، يجب توفير domain. ما مِن معلومات إضافية مطلوبة لنوع anyone.

kind

string

الإخراج فقط. يحدّد نوع هذا المورد. القيمة: السلسلة الثابتة "drive#permission".

permissionDetails[]

object

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

permissionDetails[].permissionType

string

الإخراج فقط. نوع الإذن لهذا المستخدم. وعلى الرغم من إمكانية إضافة قيم جديدة في المستقبل، يمكن إجراء ما يلي حاليًا:

  • file
  • member
permissionDetails[].inheritedFrom

string

الإخراج فقط. رقم تعريف العنصر الذي تم اكتساب هذا الإذن منه هذا حقل للإخراج فقط.

permissionDetails[].role

string

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

  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inherited

boolean

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

emailAddress

string

عنوان البريد الإلكتروني للمستخدم أو المجموعة التي يشير إليها هذا الإذن.

role

string

الدور الذي تم منحه بواسطة هذا الإذن قد تكون القيم الجديدة متاحة في المستقبل، ولكن يُسمح حاليًا بما يلي:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
allowFileDiscovery

boolean

يحدّد هذا الإعداد ما إذا كان الإذن يسمح باكتشاف الملف من خلال البحث. وينطبق ذلك فقط على الأذونات من النوع domain أو anyone.

domain

string

النطاق الذي يشير إليه هذا الإذن.

expirationTime

string

تمثّل هذه السمة الوقت الذي ستنتهي فيه صلاحية هذا الإذن (الوقت والتاريخ في معيار RFC 3339). تخضع أوقات انتهاء الصلاحية للقيود التالية:

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

object

الإخراج فقط. متوقفة: الإخراج فقط. يمكنك استخدام permissionDetails كبديل.

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

متوقفة: الإخراج فقط. يمكنك استخدام permissionDetails/permissionType كبديل.

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

متوقفة: الإخراج فقط. يمكنك استخدام permissionDetails/inheritedFrom كبديل.

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

متوقفة: الإخراج فقط. يمكنك استخدام permissionDetails/role كبديل.

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

متوقفة: الإخراج فقط. يمكنك استخدام permissionDetails/inherited كبديل.

deleted

boolean

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

view

string

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

pendingOwner

boolean

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

الطُرق

create

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

delete

حذف إذن

get

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

list

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

update

تعدِّل إذنًا باستخدام الدلالات الدلالية.