Method: permissions.insert

הוספת הרשאה לקובץ או לאחסון שיתופי.

אזהרה: שינויים מקבילים בהרשאות (כמו עדכון או מחיקה) באותו קובץ, תיקייה או אחסון שיתופי לא נתמכים אצל אף משתמש או לקוח. רק העדכון האחרון יחול.

בקשת HTTP

POST https://www.googleapis.com/drive/v2/files/{fileId}/permissions

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
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
(deprecated)

boolean

הוצא משימוש: כל הבקשות משתמשות בכללי הגישה המורחבים.

גוף הבקשה

גוף הבקשה מכיל מופע של Permission.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Permission.

היקפי הרשאות

נדרשת אחת מההרשאות הבאות של OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

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