Method: permissions.insert

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

אזהרה:אין תמיכה בפעולות של הרשאות בו-זמנית באותו קובץ. רק העדכון האחרון מיושם.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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, מגיש הבקשה יקבל גישה אם הפרמטר של מזהה הקובץ מתייחס לאחסון שיתופי, ומגיש הבקשה הוא אדמין בדומיין שאליו האחסון השיתופי שייך.

גוף הבקשה

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

גוף התגובה

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

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

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

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