משאב: הרשאה
הרשאה לקובץ. הרשאה מעניקה למשתמש, לקבוצה, לדומיין או לעולם גישה לקובץ או להיררכיה של תיקיות.
לשיטות משאבים מסוימות (כמו 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 |
האם החשבון המשויך להרשאה הזו הוא בעלים בהמתנה. השדה מאוכלס רק בהרשאות מסוג |
שיטות |
|
---|---|
|
יצירת הרשאה לקובץ או לאחסון שיתופי. |
|
מחיקת הרשאה. |
|
מקבלת הרשאה לפי מזהה. |
|
בתיבת הדו-שיח הזו מפורטים ההרשאות של הקובץ או של האחסון השיתופי. |
|
מעדכן הרשאה עם סמנטיקה של תיקון. |