Method: permissions.insert
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הוספת הרשאה לקובץ או לאחסון שיתופי.
אזהרה: אין תמיכה בפעולות הרשאות בו-זמניות באותו קובץ. רק העדכון האחרון מיושם.
בקשת HTTP
POST https://www.googleapis.com/drive/v2/files/{fileId}/permissions
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
fileId |
string
המזהה של הקובץ או של האחסון השיתופי.
|
פרמטרים של שאילתה
| פרמטרים |
emailMessage |
string
הודעה מותאמת אישית בטקסט ללא עיצוב, שתוכלל בהודעות באימייל.
|
enforceSingleParent
(deprecated) |
boolean
הוצא משימוש: פרטים נוספים זמינים במאמר moveToNewOwnersRoot.
|
moveToNewOwnersRoot |
boolean
הפרמטר הזה ייכנס לתוקף רק אם הפריט לא נמצא באחסון שיתופי והבקשה היא להעביר את הבעלות על הפריט. אם הערך יהיה true, הפריט יועבר לתיקיית השורש של 'האחסון שלי' של הבעלים החדש, וכל תיקיות האם הקודמות יוסרו. אם הערך מוגדר כ-false, ההורים לא משתנים.
|
sendNotificationEmails |
boolean
האם לשלוח אימיילים עם התראות כשמשתפים עם משתמשים או קבוצות. המערכת מתעלמת מהפרמטר הזה, והיא שולחת אימייל אם הערך של role הוא owner.
|
supportsAllDrives |
boolean
האם האפליקציה המבקשת תומכת גם בתיקיות 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
|
supportsTeamDrives
(deprecated) |
boolean
האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-supportsAllDrives.
|
useDomainAdminAccess |
boolean
שליחת הבקשה כאדמין דומיין. אם הערך מוגדר כ-true, מבצע הבקשה יקבל גישה אם הפרמטר של מזהה הקובץ מתייחס לאחסון שיתופי, ומבצע הבקשה הוא אדמין של הדומיין שאליו שייך האחסון השיתופי.
|
enforceExpansiveAccess |
boolean
אם הבקשה צריכה לאכוף כללי גישה נרחבים.
|
גוף הבקשה
גוף הבקשה מכיל מופע של Permission.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Permission.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/docs
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-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],null,["# Method: permissions.insert\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\nInserts 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/v2/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 for the file or shared drive. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `emailMessage` | `string` A plain text custom message to include in notification emails. |\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| `sendNotificationEmails` | `boolean` Whether to send notification emails when sharing to users or groups. This parameter is ignored and an email is sent if the `role` is `owner`. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\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/v2/permissions#Permission).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Permission](/workspace/drive/api/reference/rest/v2/permissions#Permission).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\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)."]]
