Method: revisions.list
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
ویرایش های یک فایل را فهرست می کند.
درخواست HTTP
GET https://www.googleapis.com/drive/v2/files/{fileId}/revisions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
fileId | string شناسه فایل |
پارامترهای پرس و جو
پارامترها |
---|
maxResults | integer حداکثر تعداد بازبینی برای بازگشت. |
pageToken | string نشانه صفحه برای بازبینی برای دریافت صفحه بعدی نتایج، این پارامتر را روی مقدار "nextPageToken" از پاسخ قبلی تنظیم کنید. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
لیستی از ویرایش های یک فایل
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"items": [
{
object (Revision )
}
],
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string
} |
فیلدها |
---|
items[] | object ( Revision ) لیست تجدید نظرها اگر nextPageToken پر شده باشد، این لیست ممکن است ناقص باشد و یک صفحه اضافی از نتایج باید واکشی شود. |
nextPageToken | string نشانه صفحه برای صفحه بعدی بازبینی ها. در صورت رسیدن به انتهای لیست اصلاحات، این قسمت وجود ندارد. اگر توکن به هر دلیلی رد شد، باید آن را دور انداخته و صفحه بندی را از صفحه اول نتایج مجدداً شروع کنید. |
kind | string این همیشه drive#revisionList است. |
etag | string ETag لیست. |
selfLink | string پیوند بازگشت به این لیست |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/docs
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.appdata
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/drive.meet.readonly
-
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
برخی از دامنه ها محدود هستند و برای استفاده از برنامه شما به ارزیابی امنیتی نیاز دارند. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: revisions.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.RevisionList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists a file's revisions.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v2/files/{fileId}/revisions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------|\n| `fileId` | `string` The ID of the file. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` Maximum number of revisions to return. |\n| `pageToken` | `string` Page token for revisions. To get the next page of results, set this parameter to the value of \"nextPageToken\" from the previous response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of revisions of a file.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"items\": [ { object (/workspace/drive/api/reference/rest/v2/revisions#Revision) } ], \"nextPageToken\": string, \"kind\": string, \"etag\": string, \"selfLink\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `items[]` | `object (`[Revision](/workspace/drive/api/reference/rest/v2/revisions#Revision)`)` The list of revisions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. |\n| `nextPageToken` | `string` The page token for the next page of revisions. This field will be absent if the end of the revisions 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| `kind` | `string` This is always `drive#revisionList`. |\n| `etag` | `string` The ETag of the list. |\n| `selfLink` | `string` A link back to this list. |\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.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\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.photos.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)."]]