get method

Future<Object> get(
  1. String fileId,
  2. String revisionId, {
  3. bool? acknowledgeAbuse,
  4. String? $fields,
  5. DownloadOptions downloadOptions = commons.DownloadOptions.metadata,
})

Gets a revision's metadata or content by ID.

Request parameters:

fileId - The ID of the file.

revisionId - The ID of the revision.

acknowledgeAbuse - Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the alt parameter is set to media and the user is the owner of the file or an organizer of the shared drive in which the file resides.

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

downloadOptions - Options for downloading. A download can be either a Metadata (default) or Media download. Partial Media downloads are possible as well.

Completes with a

  • Revision for Metadata downloads (see downloadOptions).

  • commons.Media for Media downloads (see downloadOptions).

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<core.Object> get(
  core.String fileId,
  core.String revisionId, {
  core.bool? acknowledgeAbuse,
  core.String? $fields,
  commons.DownloadOptions downloadOptions = commons.DownloadOptions.metadata,
}) async {
  final queryParams_ = <core.String, core.List<core.String>>{
    if (acknowledgeAbuse != null) 'acknowledgeAbuse': ['${acknowledgeAbuse}'],
    if ($fields != null) 'fields': [$fields],
  };

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

  final response_ = await _requester.request(
    url_,
    'GET',
    queryParams: queryParams_,
    downloadOptions: downloadOptions,
  );
  if (downloadOptions.isMetadataDownload) {
    return Revision.fromJson(
        response_ as core.Map<core.String, core.dynamic>);
  } else {
    return response_ as commons.Media;
  }
}