Api-roll 42: 2016-11-08

generated/googleapis/lib/drive/v3.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.drive.v3;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 1874 matching lines @@
     }
   }
 
   /**
    * Lists a file's revisions.
    *
    * Request parameters:
    *
    * [fileId] - The ID of the file.
    *
+   * [pageSize] - The maximum number of revisions to return per page.
+   *
+   * [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.
+   *
    * 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.
    */
-  async.Future<RevisionList> list(core.String fileId) {
+  async.Future<RevisionList> list(core.String fileId, {core.int pageSize, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (fileId == null) {
       throw new core.ArgumentError("Parameter fileId is required.");
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
 
     _url = 'files/' + commons.Escaper.ecapeVariable('$fileId') + '/revisions';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 111 matching lines @@
   /**
    * A map of source MIME type to possible targets for all supported exports.
    */
   core.Map<core.String, core.List<core.String>> exportFormats;
   /** The currently supported folder colors as RGB hex strings. */
   core.List<core.String> folderColorPalette;
   /**
    * A map of source MIME type to possible targets for all supported imports.
    */
   core.Map<core.String, core.List<core.String>> importFormats;
-  /** This is always drive#about. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#about".
+   */
   core.String kind;
   /** A map of maximum import sizes by MIME type, in bytes. */
   core.Map<core.String, core.String> maxImportSizes;
   /** The maximum upload size in bytes. */
   core.String maxUploadSize;
   /**
    * The user's storage quota limits and usage. All fields are measured in
    * bytes.
    */
   AboutStorageQuota storageQuota;
@@ skipping 66 matching lines @@
 }
 
 /** A change to a file. */
 class Change {
   /**
    * The updated state of the file. Present if the file has not been removed.
    */
   File file;
   /** The ID of the file which has changed. */
   core.String fileId;
-  /** This is always drive#change. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#change".
+   */
   core.String kind;
   /**
    * Whether the file has been removed from the view of the changes list, for
    * example by deletion or lost access.
    */
   core.bool removed;
   /** The time of this change (RFC 3339 date-time). */
   core.DateTime time;
 
   Change();
@@ skipping 34 matching lines @@
       _json["time"] = (time).toIso8601String();
     }
     return _json;
   }
 }
 
 /** A list of changes for a user. */
 class ChangeList {
   /** The page of changes. */
   core.List<Change> changes;
-  /** This is always drive#changeList. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#changeList".
+   */
   core.String kind;
   /**
    * The starting page token for future changes. This will be present only if
    * the end of the current changes list has been reached.
    */
   core.String newStartPageToken;
   /**
    * The page token for the next page of changes. This will be absent if the end
    * of the current changes list has been reached.
    */
@@ skipping 194 matching lines @@
   /** The time at which the comment was created (RFC 3339 date-time). */
   core.DateTime createdTime;
   /**
    * Whether the comment has been deleted. A deleted comment has no content.
    */
   core.bool deleted;
   /** The content of the comment with HTML formatting. */
   core.String htmlContent;
   /** The ID of the comment. */
   core.String id;
-  /** This is always drive#comment. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#comment".
+   */
   core.String kind;
   /**
    * The last time the comment or any of its replies was modified (RFC 3339
    * date-time).
    */
   core.DateTime modifiedTime;
   /**
    * The file content to which the comment refers, typically within the anchor
    * region. For a text file, for example, this would be the text at the
    * location of the comment.
@@ skipping 84 matching lines @@
       _json["resolved"] = resolved;
     }
     return _json;
   }
 }
 
 /** A list of comments on a file. */
 class CommentList {
   /** The page of comments. */
   core.List<Comment> comments;
-  /** This is always drive#commentList. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#commentList".
+   */
   core.String kind;
   /**
    * The page token for the next page of comments. This will be absent if the
    * end of the comments list has been reached.
    */
   core.String nextPageToken;
 
   CommentList();
 
   CommentList.fromJson(core.Map _json) {
@@ skipping 477 matching lines @@
    */
   core.String headRevisionId;
   /** A static, unauthenticated link to the file's icon. */
   core.String iconLink;
   /** The ID of the file. */
   core.String id;
   /** Additional metadata about image media, if available. */
   FileImageMediaMetadata imageMediaMetadata;
   /** Whether the file was created or opened by the requesting app. */
   core.bool isAppAuthorized;
-  /** This is always drive#file. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#file".
+   */
   core.String kind;
   /** The last user to modify the file. */
   User lastModifyingUser;
   /**
    * The MD5 checksum for the content of the file. This is only applicable to
    * files with binary content in Drive.
    */
   core.String md5Checksum;
   /**
    * The MIME type of the file.
    * Drive will attempt to automatically detect an appropriate value from
    * uploaded content if no value is provided. The value cannot be changed
    * unless a new revision is uploaded.
    * If a file is created with a Google Doc MIME type, the uploaded content will
    * be imported if possible. The supported import formats are published in the
    * About resource.
    */
   core.String mimeType;
+  /** Whether the file has been modified by this user. */
+  core.bool modifiedByMe;
   /** The last time the file was modified by the user (RFC 3339 date-time). */
   core.DateTime modifiedByMeTime;
   /**
    * The last time the file was modified by anyone (RFC 3339 date-time).
    * Note that setting modifiedTime will also update modifiedByMeTime for the
    * user.
    */
   core.DateTime modifiedTime;
   /** The name of the file. This is not necessarily unique within a folder. */
   core.String name;
@@ skipping 149 matching lines @@
     }
     if (_json.containsKey("lastModifyingUser")) {
       lastModifyingUser = new User.fromJson(_json["lastModifyingUser"]);
     }
     if (_json.containsKey("md5Checksum")) {
       md5Checksum = _json["md5Checksum"];
     }
     if (_json.containsKey("mimeType")) {
       mimeType = _json["mimeType"];
     }
+    if (_json.containsKey("modifiedByMe")) {
+      modifiedByMe = _json["modifiedByMe"];
+    }
     if (_json.containsKey("modifiedByMeTime")) {
       modifiedByMeTime = core.DateTime.parse(_json["modifiedByMeTime"]);
     }
     if (_json.containsKey("modifiedTime")) {
       modifiedTime = core.DateTime.parse(_json["modifiedTime"]);
     }
     if (_json.containsKey("name")) {
       name = _json["name"];
     }
     if (_json.containsKey("originalFilename")) {
@@ skipping 116 matching lines @@
     }
     if (lastModifyingUser != null) {
       _json["lastModifyingUser"] = (lastModifyingUser).toJson();
     }
     if (md5Checksum != null) {
       _json["md5Checksum"] = md5Checksum;
     }
     if (mimeType != null) {
       _json["mimeType"] = mimeType;
     }
+    if (modifiedByMe != null) {
+      _json["modifiedByMe"] = modifiedByMe;
+    }
     if (modifiedByMeTime != null) {
       _json["modifiedByMeTime"] = (modifiedByMeTime).toIso8601String();
     }
     if (modifiedTime != null) {
       _json["modifiedTime"] = (modifiedTime).toIso8601String();
     }
     if (name != null) {
       _json["name"] = name;
     }
     if (originalFilename != null) {
@@ skipping 66 matching lines @@
       _json["writersCanShare"] = writersCanShare;
     }
     return _json;
   }
 }
 
 /** A list of files. */
 class FileList {
   /** The page of files. */
   core.List<File> files;
-  /** This is always drive#fileList. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#fileList".
+   */
   core.String kind;
   /**
    * The page token for the next page of files. This will be absent if the end
    * of the files list has been reached.
    */
   core.String nextPageToken;
 
   FileList();
 
   FileList.fromJson(core.Map _json) {
@@ skipping 20 matching lines @@
       _json["nextPageToken"] = nextPageToken;
     }
     return _json;
   }
 }
 
 /** A list of generated file IDs which can be provided in create requests. */
 class GeneratedIds {
   /** The IDs generated for the requesting user in the specified space. */
   core.List<core.String> ids;
-  /** This is always drive#generatedIds */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#generatedIds".
+   */
   core.String kind;
   /** The type of file that can be created with these IDs. */
   core.String space;
 
   GeneratedIds();
 
   GeneratedIds.fromJson(core.Map _json) {
     if (_json.containsKey("ids")) {
       ids = _json["ids"];
     }
@@ skipping 38 matching lines @@
    * The email address of the user or group to which this permission refers.
    */
   core.String emailAddress;
   /** The time at which this permission will expire (RFC 3339 date-time). */
   core.DateTime expirationTime;
   /**
    * The ID of this permission. This is a unique identifier for the grantee, and
    * is published in User resources as permissionId.
    */
   core.String id;
-  /** This is always drive#permission. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#permission".
+   */
   core.String kind;
   /** A link to the user's profile photo, if available. */
   core.String photoLink;
   /**
    * The role granted by this permission. Valid values are:
    * - owner
    * - writer
    * - commenter
    * - reader
    */
@@ skipping 73 matching lines @@
     }
     if (type != null) {
       _json["type"] = type;
     }
     return _json;
   }
 }
 
 /** A list of permissions for a file. */
 class PermissionList {
-  /** This is always drive#permissionList. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#permissionList".
+   */
   core.String kind;
   /** The full list of permissions. */
   core.List<Permission> permissions;
 
   PermissionList();
 
   PermissionList.fromJson(core.Map _json) {
     if (_json.containsKey("kind")) {
       kind = _json["kind"];
     }
@@ skipping 31 matching lines @@
    */
   core.String content;
   /** The time at which the reply was created (RFC 3339 date-time). */
   core.DateTime createdTime;
   /** Whether the reply has been deleted. A deleted reply has no content. */
   core.bool deleted;
   /** The content of the reply with HTML formatting. */
   core.String htmlContent;
   /** The ID of the reply. */
   core.String id;
-  /** This is always drive#reply. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#reply".
+   */
   core.String kind;
   /** The last time the reply was modified (RFC 3339 date-time). */
   core.DateTime modifiedTime;
 
   Reply();
 
   Reply.fromJson(core.Map _json) {
     if (_json.containsKey("action")) {
       action = _json["action"];
     }
@@ skipping 51 matching lines @@
     }
     if (modifiedTime != null) {
       _json["modifiedTime"] = (modifiedTime).toIso8601String();
     }
     return _json;
   }
 }
 
 /** A list of replies to a comment on a file. */
 class ReplyList {
-  /** This is always drive#replyList. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#replyList".
+   */
   core.String kind;
   /**
    * The page token for the next page of replies. This will be absent if the end
    * of the replies list has been reached.
    */
   core.String nextPageToken;
   /** The page of replies. */
   core.List<Reply> replies;
 
   ReplyList();
@@ skipping 30 matching lines @@
   /** The ID of the revision. */
   core.String id;
   /**
    * Whether to keep this revision forever, even if it is no longer the head
    * revision. If not set, the revision will be automatically purged 30 days
    * after newer content is uploaded. This can be set on a maximum of 200
    * revisions for a file.
    * This field is only applicable to files with binary content in Drive.
    */
   core.bool keepForever;
-  /** This is always drive#revision. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#revision".
+   */
   core.String kind;
   /** The last user to modify this revision. */
   User lastModifyingUser;
   /**
    * The MD5 checksum of the revision's content. This is only applicable to
    * files with binary content in Drive.
    */
   core.String md5Checksum;
   /** The MIME type of the revision. */
   core.String mimeType;
@@ skipping 102 matching lines @@
     }
     if (size != null) {
       _json["size"] = size;
     }
     return _json;
   }
 }
 
 /** A list of revisions of a file. */
 class RevisionList {
-  /** This is always drive#revisionList. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#revisionList".
+   */
   core.String kind;
+  /**
+   * The page token for the next page of revisions. This will be absent if the
+   * end of the revisions list has been reached.
+   */
+  core.String nextPageToken;
   /** The full list of revisions. */
   core.List<Revision> revisions;
 
   RevisionList();
 
   RevisionList.fromJson(core.Map _json) {
     if (_json.containsKey("kind")) {
       kind = _json["kind"];
     }
+    if (_json.containsKey("nextPageToken")) {
+      nextPageToken = _json["nextPageToken"];
+    }
     if (_json.containsKey("revisions")) {
       revisions = _json["revisions"].map((value) => new Revision.fromJson(value)).toList();
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (kind != null) {
       _json["kind"] = kind;
     }
+    if (nextPageToken != null) {
+      _json["nextPageToken"] = nextPageToken;
+    }
     if (revisions != null) {
       _json["revisions"] = revisions.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 class StartPageToken {
-  /** This is always drive#startPageToken. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#startPageToken".
+   */
   core.String kind;
   /** The starting page token for listing changes. */
   core.String startPageToken;
 
   StartPageToken();
 
   StartPageToken.fromJson(core.Map _json) {
     if (_json.containsKey("kind")) {
       kind = _json["kind"];
     }
@@ skipping 16 matching lines @@
 
 /** Information about a Drive user. */
 class User {
   /** A plain text displayable name for this user. */
   core.String displayName;
   /**
    * The email address of the user. This may not be present in certain contexts
    * if the user has not made their email address visible to the requester.
    */
   core.String emailAddress;
-  /** This is always drive#user. */
+  /**
+   * Identifies what kind of resource this is. Value: the fixed string
+   * "drive#user".
+   */
   core.String kind;
   /** Whether this user is the requesting user. */
   core.bool me;
   /** The user's ID as visible in Permission resources. */
   core.String permissionId;
   /** A link to the user's profile photo, if available. */
   core.String photoLink;
 
   User();
 
@@ skipping 34 matching lines @@
     }
     if (permissionId != null) {
       _json["permissionId"] = permissionId;
     }
     if (photoLink != null) {
       _json["photoLink"] = photoLink;
     }
     return _json;
   }
 }