Method: permissions.insert

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

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

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

בקשת HTTP

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

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

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

פרמטרים
fileId	string המזהה של הקובץ או של האחסון השיתופי.

פרמטרים של שאילתה

פרמטרים
emailMessage	string הודעה מותאמת אישית בטקסט ללא עיצוב, שתוכלל בהודעות באימייל.
enforceSingleParent (deprecated)	boolean הוצא משימוש: פרטים נוספים זמינים במאמר moveToNewOwnersRoot.
moveToNewOwnersRoot	boolean הפרמטר הזה ייכנס לתוקף רק אם הפריט לא נמצא באחסון שיתופי והבקשה היא להעביר את הבעלות על הפריט. אם הערך יהיה true, הפריט יועבר לתיקיית השורש של 'האחסון שלי' של הבעלים החדש, וכל תיקיות האם הקודמות יוסרו. אם הערך מוגדר כ-false, ההורים לא משתנים.
sendNotificationEmails	boolean האם לשלוח אימיילים עם התראות כשמשתפים עם משתמשים או קבוצות. המערכת מתעלמת מהפרמטר הזה, והיא שולחת אימייל אם הערך של role הוא owner.
supportsAllDrives	boolean האם האפליקציה המבקשת תומכת גם בתיקיות 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives (deprecated)	boolean האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-supportsAllDrives.
useDomainAdminAccess	boolean שליחת הבקשה כאדמין דומיין. אם הערך מוגדר כ-true, מבצע הבקשה יקבל גישה אם הפרמטר של מזהה הקובץ מתייחס לאחסון שיתופי, ומבצע הבקשה הוא אדמין של הדומיין שאליו שייך האחסון השיתופי.
enforceExpansiveAccess	boolean אם הבקשה צריכה לאכוף כללי גישה נרחבים.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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