Method: revisions.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet die Überarbeitungen einer Datei auf.
HTTP-Anfrage
GET https://www.googleapis.com/drive/v2/files/{fileId}/revisions
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
fileId |
string
Die ID der Datei.
|
Abfrageparameter
| Parameter |
maxResults |
integer
Maximale Anzahl der zurückzugebenden Revisionen.
|
pageToken |
string
Seitentoken für Überarbeitungen. Wenn Sie die nächste Ergebnisseite abrufen möchten, legen Sie diesen Parameter auf den Wert von „nextPageToken“ aus der vorherigen Antwort fest.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste der Überarbeitungen einer Datei.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"items": [
{
object (Revision)
}
],
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string
} |
| Felder |
items[] |
object (Revision)
Die Liste der Überarbeitungen. Wenn „nextPageToken“ ausgefüllt ist, ist diese Liste möglicherweise unvollständig und es sollte eine zusätzliche Seite mit Ergebnissen abgerufen werden.
|
nextPageToken |
string
Das Seitentoken für die nächste Seite mit Überarbeitungen. Dieses Feld ist nicht vorhanden, wenn das Ende der Liste der Überarbeitungen erreicht wurde. Wenn das Token aus irgendeinem Grund abgelehnt wird, sollte es verworfen und die Paginierung mit der ersten Ergebnisseite neu gestartet werden.
|
kind |
string
Dies ist immer drive#revisionList.
|
etag |
string
Das ETag der Liste.
|
selfLink |
string
Ein Link zurück zu dieser Liste.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],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)."]]
