REST Resource: permissions

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

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

بشكلٍ تلقائي، لا تعرض طلبات الأذونات سوى مجموعة فرعية من الحقول. يتم دائمًا عرض نوع الإذن ورقمه ونوعه ودوره. لاسترداد حقول معيّنة، يُرجى الاطّلاع على https://developers.google.com/drive/api/guides/fields-parameter.

تتطلّب بعض طرق الموارد (مثل 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

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

string

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

  • user: الاسم الكامل للمستخدم، كما هو محدّد في حسابه على Google، مثل "Joe Smith"
  • 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

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

  • 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

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

string

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

published

و

metadata

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

  • published

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

  • metadata

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

    metadata

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

pendingOwner

boolean

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

boolean

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

الطُرق

create

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

delete

 حذف إذن

get

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

list

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

update

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