Method: permissions.create

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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

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