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 (deprecated)	boolean הוצא משימוש: כל הבקשות משתמשות בכללי הגישה המורחבים.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

נדרשת אחת מההרשאות הבאות של OAuth:

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

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