Api-roll 44: 2017-01-23

generated/googleapis/lib/drive/v2.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.drive.v2;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert_1;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 4257 matching lines @@
  * access to Google Drive.
  */
 class AppList {
   /**
    * List of app IDs that the user has specified to use by default. The list is
    * in reverse-priority order (lowest to highest).
    */
   core.List<core.String> defaultAppIds;
   /** The ETag of the list. */
   core.String etag;
-  /** The actual list of apps. */
+  /** The list of apps. */
   core.List<App> items;
   /** This is always drive#appList. */
   core.String kind;
   /** A link back to this list. */
   core.String selfLink;
 
   AppList();
 
   AppList.fromJson(core.Map _json) {
     if (_json.containsKey("defaultAppIds")) {
@@ skipping 103 matching lines @@
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
 /** A list of changes for a user. */
 class ChangeList {
   /** The ETag of the list. */
   core.String etag;
-  /** The actual list 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> items;
   /** This is always drive#changeList. */
   core.String kind;
   /** The current largest change ID. */
   core.String largestChangeId;
   /** A link to the next page of changes. */
   core.String nextLink;
-  /** The page token for the next page of changes. */
+  /**
+   * The page token for the next page of changes. This will be absent if the end
+   * 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;
   /** A link back to this list. */
   core.String selfLink;
 
   ChangeList();
 
   ChangeList.fromJson(core.Map _json) {
     if (_json.containsKey("etag")) {
       etag = _json["etag"];
     }
@@ skipping 147 matching lines @@
       _json["type"] = type;
     }
     return _json;
   }
 }
 
 /** A list of children of a file. */
 class ChildList {
   /** The ETag of the list. */
   core.String etag;
-  /** The actual list of children. */
+  /**
+   * The list of children. If nextPageToken is populated, then this list may be
+   * incomplete and an additional page of results should be fetched.
+   */
   core.List<ChildReference> items;
   /** This is always drive#childList. */
   core.String kind;
   /** A link to the next page of children. */
   core.String nextLink;
-  /** The page token for the next page of children. */
+  /**
+   * The page token for the next page of children. This will be absent if the
+   * end of the children 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;
   /** A link back to this list. */
   core.String selfLink;
 
   ChildList();
 
   ChildList.fromJson(core.Map _json) {
     if (_json.containsKey("etag")) {
       etag = _json["etag"];
     }
@@ skipping 263 matching lines @@
     }
     if (status != null) {
       _json["status"] = status;
     }
     return _json;
   }
 }
 
 /** A list of comments on a file in Google Drive. */
 class CommentList {
-  /** List 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> items;
   /** This is always drive#commentList. */
   core.String kind;
   /** A link to the next page of comments. */
   core.String nextLink;
-  /** The token to use to request the next page of results. */
+  /**
+   * The page token for the next page of comments. This will be absent if the
+   * 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;
   /** A link back to this list. */
   core.String selfLink;
 
   CommentList();
 
   CommentList.fromJson(core.Map _json) {
     if (_json.containsKey("items")) {
       items = _json["items"].map((value) => new Comment.fromJson(value)).toList();
     }
@@ skipping 127 matching lines @@
     }
     if (verb != null) {
       _json["verb"] = verb;
     }
     return _json;
   }
 }
 
 /** A list of replies to a comment on a file in Google Drive. */
 class CommentReplyList {
-  /** List of reply. */
+  /**
+   * 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<CommentReply> items;
   /** This is always drive#commentReplyList. */
   core.String kind;
   /** A link to the next page of replies. */
   core.String nextLink;
-  /** The token to use to request the next page of results. */
+  /**
+   * The page token for the next page of replies. This will be absent if the end
+   * 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;
   /** A link back to this list. */
   core.String selfLink;
 
   CommentReplyList();
 
   CommentReplyList.fromJson(core.Map _json) {
     if (_json.containsKey("items")) {
       items = _json["items"].map((value) => new CommentReply.fromJson(value)).toList();
     }
@@ skipping 611 matching lines @@
    * A thumbnail for the file. This will only be used if Drive cannot generate a
    * standard thumbnail.
    */
   FileThumbnail thumbnail;
   /**
    * A short-lived link to the file's thumbnail. 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;
   /** The title of this file. */
   core.String title;
   /** The permissions for the authenticated user on this file. */
   Permission userPermission;
   /**
    * 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
    * requesting user.
    */
@@ skipping 382 matching lines @@
       _json["writersCanShare"] = writersCanShare;
     }
     return _json;
   }
 }
 
 /** A list of files. */
 class FileList {
   /** The ETag of the list. */
   core.String etag;
-  /** The actual list 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> items;
   /** This is always drive#fileList. */
   core.String kind;
   /** A link to the next page of files. */
   core.String nextLink;
-  /** The page token for the next page of files. */
+  /**
+   * The page token for the next page of files. This will be absent if the end
+   * 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;
   /** A link back to this list. */
   core.String selfLink;
 
   FileList();
 
   FileList.fromJson(core.Map _json) {
     if (_json.containsKey("etag")) {
       etag = _json["etag"];
     }
@@ skipping 73 matching lines @@
       _json["space"] = space;
     }
     return _json;
   }
 }
 
 /** A list of a file's parents. */
 class ParentList {
   /** The ETag of the list. */
   core.String etag;
-  /** The actual list of parents. */
+  /** The list of parents. */
   core.List<ParentReference> items;
   /** This is always drive#parentList. */
   core.String kind;
   /** A link back to this list. */
   core.String selfLink;
 
   ParentList();
 
   ParentList.fromJson(core.Map _json) {
     if (_json.containsKey("etag")) {
@@ skipping 274 matching lines @@
       _json["kind"] = kind;
     }
     return _json;
   }
 }
 
 /** A list of permissions associated with a file. */
 class PermissionList {
   /** The ETag of the list. */
   core.String etag;
-  /** The actual list of permissions. */
+  /** The list of permissions. */
   core.List<Permission> items;
   /** This is always drive#permissionList. */
   core.String kind;
   /** A link back to this list. */
   core.String selfLink;
 
   PermissionList();
 
   PermissionList.fromJson(core.Map _json) {
     if (_json.containsKey("etag")) {
@@ skipping 330 matching lines @@
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
 /** A list of revisions of a file. */
 class RevisionList {
   /** The ETag of the list. */
   core.String etag;
-  /** The actual 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> items;
   /** This is always drive#revisionList. */
   core.String kind;
   /**
    * The page token for the next page of revisions. This field will be absent if
    * the 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;
@@ skipping 120 matching lines @@
     }
     if (permissionId != null) {
       _json["permissionId"] = permissionId;
     }
     if (picture != null) {
       _json["picture"] = (picture).toJson();
     }
     return _json;
   }
 }