المرجع: الإذن
إذن لملف. يمنح الإذن المستخدم أو المجموعة أو النطاق أو العالم أو العالم الإذن بالوصول إلى ملف أو تسلسل هرمي لمجلد.
تتطلّب بعض طُرق الموارد (مثل permissions.update
) السمة permissionId
. يمكنك استخدام الطريقة permissions.list
لاسترداد رقم التعريف لملف أو مجلد أو مساحة تخزين سحابي مشتركة.
تمثيل JSON |
---|
{ "id": string, "name": string, "type": string, "role": string, "additionalRoles": [ string ], "authKey": string, "value": string, "kind": string, "withLink": boolean, "photoLink": string, "selfLink": string, "emailAddress": string, "domain": string, "etag": string, "permissionDetails": [ { "permissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "expirationDate": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
الحقول | |
---|---|
id |
معرِّف المستخدم الذي يشير إليه هذا الإذن ويتطابق مع |
name |
النتائج فقط. اسم هذا الإذن |
type |
نوع الحساب القيم المسموح بها هي:
|
role |
الدور الأساسي لهذا المستخدِم على الرغم من أنّه قد تتم إتاحة القيم الجديدة في المستقبل، يُسمح بما يلي في الوقت الحالي:
|
additionalRoles[] |
الأدوار الإضافية لهذا المستخدم يُسمح حاليًا باستخدام |
authKey |
النتائج فقط. تمّ الإيقاف. |
value |
عنوان البريد الإلكتروني أو اسم النطاق للكيان ويتم استخدام هذه البيانات أثناء عمليات الإدراج ولا تتم تعبئتها في الردود. عند تقديم طلب |
kind |
النتائج فقط. دائمًا ما تكون |
withLink |
ما إذا كان الرابط مطلوبًا لهذا الإذن. |
photoLink |
النتائج فقط. رابط إلى صورة الملف الشخصي، إذا توفَّر. |
selfLink |
النتائج فقط. رابط يؤدّي إلى هذا الإذن |
emailAddress |
النتائج فقط. عنوان البريد الإلكتروني للمستخدم أو المجموعة الذي يشير إليه هذا الإذن. هذا الحقل للمخرجات فقط، ويظهر عندما يكون نوع الإذن |
domain |
النتائج فقط. اسم النطاق للكيان الذي يشير إليه هذا الإذن. هذا الحقل للمخرجات فقط، ويظهر عندما يكون نوع الإذن |
etag |
النتائج فقط. علامة ETag للإذن. |
permissionDetails[] |
النتائج فقط. تفاصيل ما إذا كانت الأذونات في عنصر مساحة التخزين السحابي المشتركة هذا موروثة أو بشكل مباشر على هذا العنصر. هذا حقل للمخرجات فقط لا يتوفّر إلا لعناصر مساحة التخزين السحابي المشتركة. |
permissionDetails[].permissionType |
النتائج فقط. نوع الإذن لهذا المستخدم على الرغم من إمكانية إضافة قيم جديدة في المستقبل، يمكن إجراء ما يلي في الوقت الحالي:
|
permissionDetails[].role |
النتائج فقط. الدور الأساسي لهذا المستخدِم على الرغم من إمكانية إضافة قيم جديدة في المستقبل، يمكن إجراء ما يلي في الوقت الحالي:
|
permissionDetails[].additionalRoles[] |
النتائج فقط. الأدوار الإضافية لهذا المستخدم يمكن حاليًا استخدام |
permissionDetails[].inheritedFrom |
النتائج فقط. رقم تعريف العنصر الذي يتم اكتساب هذا الإذن منه. هذا حقل للمخرجات فقط. |
permissionDetails[].inherited |
النتائج فقط. ما إذا كان هذا الإذن موروثًا. تتم تعبئة هذا الحقل دائمًا. هذا حقل للمخرجات فقط. |
expirationDate |
الوقت الذي ستنتهي فيه صلاحية هذا الإذن (التاريخ-الوقت RFC 3339). تخضع تواريخ انتهاء الصلاحية للقيود التالية:
|
teamDrivePermissionDetails[] |
النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام |
teamDrivePermissionDetails[] |
النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام |
teamDrivePermissionDetails[] |
النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام |
teamDrivePermissionDetails[] |
النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام |
teamDrivePermissionDetails[] |
النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام |
teamDrivePermissionDetails[] |
النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام |
deleted |
النتائج فقط. ما إذا كان قد تم حذف الحساب المرتبط بهذا الإذن يرتبط هذا الحقل بأذونات المستخدمين والمجموعات فقط. |
view |
تشير هذه السمة إلى طريقة العرض لهذا الإذن. تتم تعبئة هذا الحقل فقط للأذونات التي تنتمي إلى ملف شخصي. القيمة |
pendingOwner |
ما إذا كان الحساب المرتبط بهذا الإذن مالكًا غير نهائي تتم تعبئة هذا الحقل فقط لأذونات النوع " |
الطُرق |
|
---|---|
|
حذف إذن من ملف أو مساحة تخزين سحابي مشتركة |
|
يحصل على إذن من خلال مستند تعريف الهوية. |
|
يعرض رقم تعريف الإذن لعنوان بريد إلكتروني. |
|
يدرج إذنًا لملف أو مساحة تخزين سحابي مشتركة. |
|
يسرد أذونات ملف أو مساحة تخزين سحابي مشتركة. |
|
تعديل الإذن باستخدام دلالات رموز التصحيح |
|
تعديل إذن |