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
(deprecated)

boolean

הוצא משימוש: כל הבקשות משתמשות בכללי הגישה המורחבים.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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