list method

Future<RevisionList> list(
  1. String fileId, {
  2. int? maxResults,
  3. String? pageToken,
  4. String? $fields,
})

Lists a file's revisions.

Important: The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides. Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision. The revision history visible in the Workspace editor user interface might be more complete than the list returned by the API.

Request parameters:

fileId - The ID of the file.

maxResults - Maximum number of revisions to return. Value must be between "1" and "1000".

pageToken - Page token for revisions. To get the next page of results, set this parameter to the value of "nextPageToken" from the previous response.

$fields - Selector specifying which fields to include in a partial response.

Completes with a RevisionList.

Completes with a commons.ApiRequestError if the API endpoint returned an error.

If the used http.Client completes with an error when making a REST call, this method will complete with the same error.

Implementation

async.Future<RevisionList> list(
  core.String fileId, {
  core.int? maxResults,
  core.String? pageToken,
  core.String? $fields,
}) async {
  final queryParams_ = <core.String, core.List<core.String>>{
    'maxResults': ?maxResults == null ? null : ['${maxResults}'],
    'pageToken': ?pageToken == null ? null : [pageToken],
    'fields': ?$fields == null ? null : [$fields],
  };

  final url_ = 'files/' + commons.escapeVariable('$fileId') + '/revisions';

  final response_ = await _requester.request(
    url_,
    'GET',
    queryParams: queryParams_,
  );
  return RevisionList.fromJson(
    response_ as core.Map<core.String, core.dynamic>,
  );
}