- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתות
- גוף הבקשה
- גוף התגובה
- היקפי ההרשאות
- AccessProposal
- RoleAndView
- רוצים לנסות?
הצגת רשימה של הצעות הגישה בקובץ. הערה: רק גורמים שאישרו את הבקשה יכולים לצרף בקשות גישה לקובץ. אם המשתמש לא הוא איש האישור, המערכת מחזירה את הערך 403.
בקשת HTTP
GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
file |
חובה. המזהה של הפריט שאליו מתייחסת הבקשה. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
page |
זה שינוי אופציונלי. אסימון ההמשך ברשימת בקשות הגישה. |
page |
זה שינוי אופציונלי. מספר התוצאות בכל דף |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
התשובה לבקשת רשימה של הצעות גישה.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{
"accessProposals": [
{
object ( |
שדות | |
---|---|
access |
רשימה של הצעות גישה. השדה הזה מאוכלס רק בגרסה 3 ובגרסה 3beta. |
next |
אסימון ההמשך של דף התוצאות הבא. השדה הזה לא יופיע אם תגיע לסוף רשימת התוצאות. אם האסימון נדחה מסיבה כלשהי, צריך למחוק אותו ולהתחיל מחדש את העימוד מהדף הראשון של התוצאות. |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/docs
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.readonly
חלק מההיקפים מוגבלים וצריך לבצע בדיקת אבטחה כדי להשתמש בהם באפליקציה. מידע נוסף זמין במדריך ההרשאות.
AccessProposal
המשאב Access Proposal עבור הצעות גישה פתוחות לקובץ
ייצוג ב-JSON |
---|
{
"fileId": string,
"proposalId": string,
"requesterEmailAddress": string,
"recipientEmailAddress": string,
"rolesAndViews": [
{
object ( |
שדות | |
---|---|
file |
מזהה הקובץ שבו נמצאת ההצעה לגישה |
proposal |
המזהה של הצעת הגישה |
requester |
כתובת האימייל של המשתמש ששלח את הבקשה |
recipient |
כתובת האימייל של המשתמש שיקבל את ההרשאות אם הוא יאושר |
roles |
wrapper לתפקיד ולתצוגה של הצעת גישה. |
request |
ההודעה שמגיש הבקשה הוסיף להצעה |
create |
שעת היצירה חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: |
RoleAndView
wrapper לתפקיד ולתצוגה של הצעת גישה.
ייצוג JSON |
---|
{ "role": string, "view": string } |
שדות | |
---|---|
role |
התפקיד שהמגיש הציע. ייתכן שערכים חדשים יתווספו בעתיד, אבל אלה הערכים האפשריים כרגע: * |
view |
מציין את התצוגה של הצעת הגישה הזו. השדה מאוכלס רק בהצעות ששייכות לתצוגה. |