REST Resource: permissions

المورد: الإذن

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

تلقائيًا، لا تعرض طلبات الأذونات سوى مجموعة فرعية من الحقول. يتم دائمًا عرض kind وID وtype وrole للإذن. لاسترداد حقول معيّنة، يُرجى الاطّلاع على مقالة عرض حقول معيّنة.

تتطلب بعض طرق الموارد (مثل 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,
  "inheritedPermissionsDisabled": boolean
}
الحقول
id

string

النتائج فقط. رقم تعريف هذا الإذن. هذا المعرّف هو معرّف فريد للمستفيد من المنحة، ويتم نشره في الـ User resource باسم permissionId. يجب التعامل مع أرقام التعريف كقيم مبهمة.
displayName

string

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

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

string

نوع المستفيد من المنحة. تشمل القيم المتاحة ما يلي:

  • user
  • group
  • domain
  • anyone

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

string

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

object

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

string

النتائج فقط. نوع إذن هذا المستخدم تشمل القيم المتاحة ما يلي:

  • file
  • member
permissionDetails[].inheritedFrom

string

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

string

النتائج فقط. الدور الأساسي لهذا المستخدم تشمل القيم المتاحة ما يلي:

  • owner
  • 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

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

string

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

القيمتان المتاحتان فقط هما published وmetadata:

  • published: دور الإذن هو publishedReader.
  • metadata: لا يظهر العنصر إلا في طريقة العرض metadata لأنّ الوصول إلى العنصر محدود، ويملك النطاق إذن الوصول للقراءة على الأقل إلى العنصر الرئيسي. لا تتوفّر طريقة العرض metadata إلا في المجلدات.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة طرق العرض.
pendingOwner

boolean

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

boolean

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

الطُرق

create

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

delete

 يحذف إذنًا.

get

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

list

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

update

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