تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

REST Resource: permissions

المصدر: الإذن
- تمثيل JSON
الطُرق

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

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

بشكلٍ تلقائي، لا تعرض طلبات الأذونات سوى مجموعة فرعية من الحقول. يتم دائمًا عرض نوع الإذن ورقمه ونوعه ودوره. لاسترداد حقول معيّنة، يُرجى الاطّلاع على 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 }

تمثيل 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، مثل "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` النتائج فقط. الدور الأساسي لهذا المستخدم. في حين أنّه قد تتم إضافة قيم جديدة في المستقبل، في ما يلي القيم المتاحة حاليًا: `organizer` `fileOrganizer` `writer` `commenter` `reader`
`permissionDetails[].inherited`	`boolean` النتائج فقط. ما إذا كان هذا الإذن مكتسَبًا تتم تعبئة هذا الحقل دائمًا. هذا حقل للإخراج فقط.
`photoLink`	`string` النتائج فقط. رابط ينقل إلى صورة الملف الشخصي للمستخدم، إذا كانت متاحة
`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`	تعديل إذن باستخدام دلالات التصحيح

REST Resource: permissions

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

الطُرق

`create`

`delete`

`get`

`list`

`update`