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