Method: permissions.create

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התשובה
• היקפי הרשאה
• כדאי לנסות!

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

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

בקשת 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

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