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

היקפי הרשאה מסוימים מוגבלים, ונדרש הערכת אבטחה כדי שהאפליקציה שלכם תוכל להשתמש בהם. מידע נוסף זמין במדריך ההרשאות.