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

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