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

REST Resource: permissions

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

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

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

تتطلّب بعض طُرق الموارد (مثل 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، مثل "سامح رضا". `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`