בתיבת הדו-שיח הזו מפורטים ההרשאות של הקובץ או של האחסון השיתופי.
בקשת HTTP
GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
fileId |
מזהה הקובץ או האחסון השיתופי. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
pageSize |
מספר ההרשאות המקסימלי שיש להחזיר בכל דף. אם המדיניות לא מוגדרת לקבצים באחסון שיתופי, יוחזרו לכל היותר 100 תוצאות. אם המדיניות לא מוגדרת לקבצים שלא נמצאים באחסון שיתופי, כל הרשימה תוחזר. |
pageToken |
האסימון להמשך בקשה קודמת לרשימה בדף הבא. צריך להגדיר את הערך הזה לערך 'nextPageToken' מהתגובה הקודמת. |
supportsAllDrives |
האם האפליקציה שביקשה תמיכה תומכת גם בתיקייה 'האחסון שלי' וגם בתיקיות אחסון שיתופי. |
supportsTeamDrives |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
useDomainAdminAccess |
שולחים את הבקשה כאדמין של דומיין. אם המדיניות מוגדרת כ-True, מגיש הבקשה יקבל גישה אם הפרמטר של מזהה הקובץ מתייחס לאחסון שיתופי, ומגיש הבקשה הוא אדמין בדומיין שאליו האחסון השיתופי שייך. |
includePermissionsForView |
ההגדרה קובעת אילו הרשאות של תצוגות מפורטות נוספות ייכללו בתגובה. רק הערך 'פורסם' נתמך. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
רשימה של הרשאות לקובץ.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"nextPageToken": string,
"kind": string,
"permissions": [
{
object ( |
שדות | |
---|---|
nextPageToken |
אסימון הדף של דף ההרשאות הבא. השדה הזה לא יופיע אם רשימת ההרשאות תסתיים. אם האסימון יידחה מסיבה כלשהי, יש לבטל אותו ולהתחיל את העימוד מחדש מהדף הראשון של תוצאות החיפוש. אסימון הדף תקף בדרך כלל לכמה שעות. עם זאת, אם מוסיפים או מסירים פריטים חדשים, התוצאות הצפויות עשויות להיות שונות. |
kind |
מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה |
permissions[] |
רשימת ההרשאות. אם השדה nextPageToken מאוכלס, ייתכן שהרשימה הזו לא תהיה מלאה ויש לאחזר דף נוסף של תוצאות. |
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.