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

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