Method: permissions.create

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

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

בקשת HTTP

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

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

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

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

boolean

האם הבקשה צריכה לאכוף כללי גישה נרחבים.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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