Method: permissions.create

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

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

פרמטרים של שאילתה

פרמטרים
emailMessage

string

הודעה מותאמת אישית בטקסט ללא עיצוב שתכלול בהודעת האימייל.
enforceSingleParent
(deprecated)

boolean

הוצא משימוש: פרטים נוספים זמינים במאמר moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

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

boolean

האם לשלוח התראה באימייל כשמשתפים עם משתמשים או קבוצות. ברירת המחדל היא True למשתמשים ולקבוצות, ואי אפשר להשתמש בה בבקשות אחרות. אסור להשבית אותה להעברות בעלות.
supportsAllDrives

boolean

האם האפליקציה המבקשת תומכת גם בתיקיות 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives
(deprecated)

boolean

האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-supportsAllDrives.
transferOwnership

boolean

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

boolean

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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