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

REST Resource: permissions

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

المورد: إذن

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

تمثيل 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`