Method: permissions.create
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יוצר הרשאה לקובץ או לאחסון שיתופי.
אזהרה: אין תמיכה בפעולות הרשאה בו-זמניות באותו קובץ. רק העדכון האחרון יחול.
בקשת HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
fileId |
string
המזהה של הקובץ או האחסון השיתופי.
|
פרמטרים של שאילתה
| פרמטרים |
emailMessage |
string
הודעה בהתאמה אישית בטקסט פשוט שתצורף לאימייל עם ההתראה.
|
enforceSingleParent
(deprecated) |
boolean
הוצאה משימוש: פרטים נוספים מופיעים בכתובת moveToNewOwnersRoot.
|
moveToNewOwnersRoot |
boolean
הפרמטר הזה ישפיע רק אם הפריט לא נמצא באחסון שיתופי והבקשה מנסה להעביר את הבעלות על הפריט. אם בוחרים באפשרות true, הפריט יועבר לתיקיית הבסיס 'האחסון שלי' של הבעלים החדשים וכל תיקיות האב הקודמות יוסרו. אם ההגדרה היא false, ההורים לא משתנים.
|
sendNotificationEmail |
boolean
האם לשלוח אימייל עם התראה כשמשתפים עם משתמשים או קבוצות. ערך ברירת המחדל הוא true למשתמשים ולקבוצות, והוא לא מותר לבקשות אחרות. אסור שהיא תהיה מושבתת להעברות בעלות.
|
supportsAllDrives |
boolean
האם האפליקציה ששולחת את הבקשה תומכת גם בתיקיית 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
|
supportsTeamDrives
(deprecated) |
boolean
יצא משימוש: במקומו צריך להשתמש ב-supportsAllDrives.
|
transferOwnership |
boolean
האם להעביר את הבעלות למשתמש שצוין ולשדרג לאחור את הבעלים הנוכחי לסטטוס של משתמש עם הרשאת כתיבה. חובה לכלול את הפרמטר הזה כדי לאשר את תופעת הלוואי.
|
useDomainAdminAccess |
boolean
הבקשה מוגשת כאדמין בדומיין. אם הערך מוגדר כ-true, השולח יקבל גישה אם פרמטר מזהה הקובץ מתייחס לאחסון שיתופי והשולח הוא אדמין בדומיין שאליו שייך האחסון השיתופי.
|
enforceExpansiveAccess |
boolean
האם הבקשה צריכה לאכוף כללי גישה נרחבים.
|
גוף הבקשה
גוף הבקשה מכיל מופע של Permission.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Permission.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
יש היקפי הרשאות מוגבלים שנדרשת הערכת אבטחה כדי להשתמש בהם באפליקציה. מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-27 (שעון UTC)."],[],[],null,["# Method: permissions.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a permission for a file or shared drive.\n\n**Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------|\n| `fileId` | `string` The ID of the file or shared drive. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `emailMessage` | `string` A plain text custom message to include in the notification email. |\n| `enforceSingleParent` **(deprecated)** | `boolean` Deprecated: See `moveToNewOwnersRoot` for details. |\n| `moveToNewOwnersRoot` | `boolean` This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to `true`, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents are not changed. |\n| `sendNotificationEmail` | `boolean` Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `transferOwnership` | `boolean` Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. |\n| `useDomainAdminAccess` | `boolean` Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. |\n| `enforceExpansiveAccess` | `boolean` Whether the request should enforce expansive access rules. |\n\n### Request body\n\nThe request body contains an instance of [Permission](/workspace/drive/api/reference/rest/v3/permissions#Permission).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Permission](/workspace/drive/api/reference/rest/v3/permissions#Permission).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
