تمت ترجمة هذه الصفحة بواسطة 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` النتائج فقط. أغنية "pretty" (جميلة) اسم قيمة الإذن. في ما يلي قائمة بأمثلة لكل نوع من الأذونات: `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`