Api-roll 44: 2017-01-23

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 2183 matching lines @@
     }
     if (time != null) {
       _json["time"] = (time).toIso8601String();
     }
     return _json;
   }
 }
 
 /** A list of changes for a user. */
 class ChangeList {
-  /** The page of changes. */
+  /**
+   * The list of changes. If nextPageToken is populated, then this list may be
+   * incomplete and an additional page of results should be fetched.
+   */
   core.List<Change> changes;
   /**
    * 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.
+   * of the changes 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.
    */
   core.String nextPageToken;
 
   ChangeList();
 
   ChangeList.fromJson(core.Map _json) {
     if (_json.containsKey("changes")) {
       changes = _json["changes"].map((value) => new Change.fromJson(value)).toList();
     }
     if (_json.containsKey("kind")) {
@@ skipping 291 matching lines @@
     }
     if (resolved != null) {
       _json["resolved"] = resolved;
     }
     return _json;
   }
 }
 
 /** A list of comments on a file. */
 class CommentList {
-  /** The page of comments. */
+  /**
+   * The list of comments. If nextPageToken is populated, then this list may be
+   * incomplete and an additional page of results should be fetched.
+   */
   core.List<Comment> comments;
   /**
    * 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.
+   * end of the comments 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.
    */
   core.String nextPageToken;
 
   CommentList();
 
   CommentList.fromJson(core.Map _json) {
     if (_json.containsKey("comments")) {
       comments = _json["comments"].map((value) => new Comment.fromJson(value)).toList();
     }
     if (_json.containsKey("kind")) {
@@ skipping 571 matching lines @@
    */
   core.List<core.String> spaces;
   /** Whether the user has starred the file. */
   core.bool starred;
   /**
    * A short-lived link to the file's thumbnail, if available. Typically lasts
    * on the order of hours. Only populated when the requesting app can access
    * the file's content.
    */
   core.String thumbnailLink;
-  /**
-   * The thumbnail version for use in client-contructable thumbnail URLs or
-   * thumbnail cache invalidation.
-   */
+  /** The thumbnail version for use in thumbnail cache invalidation. */
   core.String thumbnailVersion;
   /**
    * Whether the file has been trashed, either explicitly or from a trashed
    * parent folder. Only the owner may trash a file, and other users cannot see
    * files in the owner's trash.
    */
   core.bool trashed;
   /**
    * A monotonically increasing version number for the file. This reflects every
    * change made to the file on the server, even those not visible to the user.
@@ skipping 317 matching lines @@
     }
     if (writersCanShare != null) {
       _json["writersCanShare"] = writersCanShare;
     }
     return _json;
   }
 }
 
 /** A list of files. */
 class FileList {
-  /** The page of files. */
+  /**
+   * The list of files. If nextPageToken is populated, then this list may be
+   * incomplete and an additional page of results should be fetched.
+   */
   core.List<File> files;
   /**
    * 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.
+   * of the files 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.
    */
   core.String nextPageToken;
 
   FileList();
 
   FileList.fromJson(core.Map _json) {
     if (_json.containsKey("files")) {
       files = _json["files"].map((value) => new File.fromJson(value)).toList();
     }
     if (_json.containsKey("kind")) {
@@ skipping 180 matching lines @@
   }
 }
 
 /** A list of permissions for a file. */
 class PermissionList {
   /**
    * Identifies what kind of resource this is. Value: the fixed string
    * "drive#permissionList".
    */
   core.String kind;
-  /** The full list of permissions. */
+  /** The list of permissions. */
   core.List<Permission> permissions;
 
   PermissionList();
 
   PermissionList.fromJson(core.Map _json) {
     if (_json.containsKey("kind")) {
       kind = _json["kind"];
     }
     if (_json.containsKey("permissions")) {
       permissions = _json["permissions"].map((value) => new Permission.fromJson(value)).toList();
@@ skipping 111 matching lines @@
 
 /** A list of replies to a comment on a file. */
 class 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.
+   * of the replies 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.
    */
   core.String nextPageToken;
-  /** The page of replies. */
+  /**
+   * The list of replies. If nextPageToken is populated, then this list may be
+   * incomplete and an additional page of results should be fetched.
+   */
   core.List<Reply> replies;
 
   ReplyList();
 
   ReplyList.fromJson(core.Map _json) {
     if (_json.containsKey("kind")) {
       kind = _json["kind"];
     }
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
@@ skipping 156 matching lines @@
 
 /** A list of revisions of a file. */
 class 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.
+   * 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.
    */
   core.String nextPageToken;
-  /** The full list of revisions. */
+  /**
+   * The list of revisions. If nextPageToken is populated, then this list may be
+   * incomplete and an additional page of results should be fetched.
+   */
   core.List<Revision> revisions;
 
   RevisionList();
 
   RevisionList.fromJson(core.Map _json) {
     if (_json.containsKey("kind")) {
       kind = _json["kind"];
     }
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
@@ skipping 110 matching lines @@
     }
     if (permissionId != null) {
       _json["permissionId"] = permissionId;
     }
     if (photoLink != null) {
       _json["photoLink"] = photoLink;
     }
     return _json;
   }
 }