list method

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

Lists a file's revisions.

For more information, see Manage file 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.

pageSize - The maximum number of revisions to return per page. Value must be between "1" and "1000".

pageToken - The token for continuing a previous list request on the next page. This should be set 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? pageSize,
  core.String? pageToken,
  core.String? $fields,
}) async {
  final queryParams_ = <core.String, core.List<core.String>>{
    'pageSize': ?pageSize == null ? null : ['${pageSize}'],
    '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>,
  );
}