Method: accessproposals.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הצגת רשימת AccessProposals בקובץ. הערה: רק גורמים שאישרו את הבקשה יכולים לרשום בקשות גישה בקובץ. אם המשתמש לא הוא איש האישור, המערכת מחזירה את הערך 403.
בקשת HTTP
GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
fileId |
string
חובה. המזהה של הפריט שאליו מתייחסת הבקשה.
|
פרמטרים של שאילתה
פרמטרים |
pageToken |
string
אופציונלי. אסימון ההמשך ברשימת בקשות הגישה.
|
pageSize |
integer
אופציונלי. מספר התוצאות בכל דף
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
התשובה לבקשת רשימה של הצעות גישה.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
{
"accessProposals": [
{
object (AccessProposal )
}
],
"nextPageToken": string
} |
שדות |
accessProposals[] |
object (AccessProposal )
רשימת ההצעות לגישה. השדה הזה מאוכלס רק בגרסה 3 ובגרסה 3beta.
|
nextPageToken |
string
אסימון ההמשך לדף התוצאות הבא. השדה הזה לא יופיע אם הגעתם לסוף רשימת התוצאות. אם האסימון נדחה מסיבה כלשהי, צריך להשליך אותו ולהתחיל מחדש את חלוקת הדפים מדף התוצאות הראשון.
|
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של 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
היקפי הרשאה מסוימים מוגבלים, ונדרש הערכת אבטחה כדי שהאפליקציה שלכם תוכל להשתמש בהם. מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],null,["# Method: accessproposals.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAccessProposalsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList the AccessProposals on a file. Note: Only approvers are able to list AccessProposals on a file. If the user is not an approver, returns a 403.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------|\n| `fileId` | `string` Required. The id of the item the request is on. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------|\n| `pageToken` | `string` Optional. The continuation token on the list of access requests. |\n| `pageSize` | `integer` Optional. The number of results per page |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response to an Access Proposal list request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"accessProposals\": [ { object (/workspace/drive/api/reference/rest/v3/accessproposals#AccessProposal) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accessProposals[]` | `object (`[AccessProposal](/workspace/drive/api/reference/rest/v3/accessproposals#AccessProposal)`)` The list of Access Proposals. This field is only populated in v3 and v3beta. |\n| `nextPageToken` | `string` The continuation token for the next page of results. This will be absent if the end of the results list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]