Method: permissions.update

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

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

המזהה של הקובץ או האחסון השיתופי.
permissionId

string

מזהה ההרשאה.

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

פרמטרים
removeExpiration

boolean

האם להסיר את תאריך התפוגה.
supportsAllDrives

boolean

האם האפליקציה ששולחת את הבקשה תומכת גם בתיקיית 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives
(deprecated)

boolean

הוצא משימוש: במקומו צריך להשתמש ב-supportsAllDrives.
transferOwnership

boolean

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

boolean

שולחים את הבקשה כאדמין בדומיין.

אם הערך מוגדר כ-true, והתנאים הנוספים הבאים מתקיימים, מבקש הגישה מקבל גישה:

  1. פרמטר מזהה הקובץ מתייחס לאחסון שיתופי.
  2. השולח הוא אדמין בדומיין שאליו שייך האחסון השיתופי.

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

boolean

האם הבקשה צריכה לאכוף כללי גישה נרחבים.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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