المرجع: الإذن
إذن لملف. يمنح الإذن المستخدم أو المجموعة أو النطاق أو العالم أو العالم الإذن بالوصول إلى ملف أو تسلسل هرمي لمجلد.
تتطلّب بعض طُرق الموارد (مثل 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 } |
الحقول | |
---|---|
id |
النتائج فقط. رقم تعريف هذا الإذن. هذا المعرّف فريد للممنوح له، ويتم نشره في موارد المستخدم على أنّه |
displayName |
النتائج فقط. الاسم "الجميل" لقيمة الإذن. في ما يلي قائمة بأمثلة لكل نوع من الأذونات:
|
type |
نوع المستفيد من المنحة. القيم الصالحة هي:
عند إنشاء إذن، إذا كانت قيمة السمة |
kind |
النتائج فقط. تحدد نوع هذا المورد. القيمة: السلسلة الثابتة |
permissionDetails[] |
النتائج فقط. تفاصيل ما إذا كانت الأذونات في عنصر مساحة التخزين السحابي المشتركة هذا موروثة أو بشكل مباشر على هذا العنصر. هذا حقل للمخرجات فقط لا يتوفّر إلا لعناصر مساحة التخزين السحابي المشتركة. |
permissionDetails[].permissionType |
النتائج فقط. نوع الإذن لهذا المستخدم على الرغم من إمكانية إضافة قيم جديدة في المستقبل، يمكن إجراء ما يلي في الوقت الحالي:
|
permissionDetails[].inheritedFrom |
النتائج فقط. رقم تعريف العنصر الذي يتم اكتساب هذا الإذن منه. هذا حقل للمخرجات فقط. |
permissionDetails[].role |
النتائج فقط. الدور الأساسي لهذا المستخدِم على الرغم من إمكانية إضافة قيم جديدة في المستقبل، يمكن إجراء ما يلي في الوقت الحالي:
|
permissionDetails[].inherited |
النتائج فقط. ما إذا كان هذا الإذن موروثًا. تتم تعبئة هذا الحقل دائمًا. هذا حقل للمخرجات فقط. |
photoLink |
النتائج فقط. رابط إلى صورة الملف الشخصي للمستخدم، إذا كان متاحًا. |
emailAddress |
عنوان البريد الإلكتروني للمستخدم أو المجموعة الذي يشير إليها هذا الإذن. |
role |
الدور الذي تم منحه لهذا الإذن. على الرغم من أنّه قد تتم إتاحة القيم الجديدة في المستقبل، يُسمح بما يلي في الوقت الحالي:
|
allowFileDiscovery |
ما إذا كان الإذن يسمح باكتشاف الملف من خلال البحث. لا ينطبق هذا إلا على الأذونات من النوع |
domain |
النطاق الذي يشير إليه هذا الإذن. |
expirationTime |
الوقت الذي ستنتهي فيه صلاحية هذا الإذن (التاريخ-الوقت RFC 3339). هناك القيود التالية على أوقات انتهاء الصلاحية:
|
teamDrivePermissionDetails[] |
النتائج فقط. مهملة: النتائج فقط. يمكنك استخدام |
teamDrivePermissionDetails[] |
مهملة: النتائج فقط. يمكنك استخدام |
teamDrivePermissionDetails[] |
مهملة: النتائج فقط. يمكنك استخدام |
teamDrivePermissionDetails[] |
مهملة: النتائج فقط. يمكنك استخدام |
teamDrivePermissionDetails[] |
مهملة: النتائج فقط. يمكنك استخدام |
deleted |
النتائج فقط. ما إذا كان قد تم حذف الحساب المرتبط بهذا الإذن يرتبط هذا الحقل بأذونات المستخدمين والمجموعات فقط. |
view |
تشير هذه السمة إلى طريقة العرض لهذا الإذن. تتم تعبئة هذا الحقل فقط للأذونات التي تنتمي إلى ملف شخصي. القيمة "منشورة" هي القيمة الوحيدة المتاحة. |
pendingOwner |
ما إذا كان الحساب المرتبط بهذا الإذن مالكًا غير نهائي تتم تعبئة هذا الحقل فقط لأذونات النوع " |
الطُرق |
|
---|---|
|
ينشئ إذنًا لملف أو مساحة تخزين سحابي مشتركة. |
|
حذف الإذن |
|
يحصل على إذن من خلال مستند تعريف الهوية. |
|
يسرد أذونات ملف أو مساحة تخزين سحابي مشتركة. |
|
تعديل الإذن باستخدام دلالات رموز التصحيح |