Api-roll 44: 2017-01-23

discovery/googleapis/drive__v2.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/drive": {
                     "description": "View and manage the files in your Google Drive"
                 },
                 "https://www.googleapis.com/auth/drive.appdata": {
                     "description": "View and manage its own configuration data in your Google Drive"
                 },
@@ skipping 20 matching lines @@
                 }
             }
         }
     },
     "basePath": "/drive/v2/",
     "baseUrl": "https://www.googleapis.com/drive/v2/",
     "batchPath": "batch",
     "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/drive/",
-    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/y_a-CqNzWjAnaHC0v3451Z9D_8M\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/aTsDjhJX4jyEgcQh1bdOjEtV2EI\"",
     "icons": {
         "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png",
         "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png"
     },
     "id": "drive:v2",
     "kind": "discovery#restDescription",
     "name": "drive",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 2599 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/drive",
                         "https://www.googleapis.com/auth/drive.appdata",
                         "https://www.googleapis.com/auth/drive.file"
                     ]
                 }
             }
         }
     },
-    "revision": "20161201",
+    "revision": "20170113",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "About": {
             "description": "An item with user information and settings.",
             "id": "About",
             "properties": {
                 "additionalRoleInfo": {
                     "description": "Information about supported additional roles per file type. The most specific type takes precedence.",
                     "items": {
                         "properties": {
@@ skipping 348 matching lines @@
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "etag": {
                     "description": "The ETag of the list.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "The actual list of apps.",
+                    "description": "The list of apps.",
                     "items": {
                         "$ref": "App"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#appList",
                     "description": "This is always drive#appList.",
                     "type": "string"
                 },
@@ skipping 44 matching lines @@
         },
         "ChangeList": {
             "description": "A list of changes for a user.",
             "id": "ChangeList",
             "properties": {
                 "etag": {
                     "description": "The ETag of the list.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "The actual list of changes.",
+                    "description": "The list of changes. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
                     "items": {
                         "$ref": "Change"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#changeList",
                     "description": "This is always drive#changeList.",
                     "type": "string"
                 },
                 "largestChangeId": {
                     "description": "The current largest change ID.",
                     "format": "int64",
                     "type": "string"
                 },
                 "nextLink": {
                     "description": "A link to the next page of changes.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "The page token for the next page of changes.",
+                    "description": "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.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "A link back to this list.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Channel": {
@@ skipping 51 matching lines @@
         },
         "ChildList": {
             "description": "A list of children of a file.",
             "id": "ChildList",
             "properties": {
                 "etag": {
                     "description": "The ETag of the list.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "The actual list of children.",
+                    "description": "The list of children. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
                     "items": {
                         "$ref": "ChildReference"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#childList",
                     "description": "This is always drive#childList.",
                     "type": "string"
                 },
                 "nextLink": {
                     "description": "A link to the next page of children.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "The page token for the next page of children.",
+                    "description": "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.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "A link back to this list.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ChildReference": {
@@ skipping 112 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "CommentList": {
             "description": "A list of comments on a file in Google Drive.",
             "id": "CommentList",
             "properties": {
                 "items": {
-                    "description": "List of comments.",
+                    "description": "The list of comments. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
                     "items": {
                         "$ref": "Comment"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#commentList",
                     "description": "This is always drive#commentList.",
                     "type": "string"
                 },
                 "nextLink": {
                     "description": "A link to the next page of comments.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "The token to use to request the next page of results.",
+                    "description": "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.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "A link back to this list.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "CommentReply": {
@@ skipping 45 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "CommentReplyList": {
             "description": "A list of replies to a comment on a file in Google Drive.",
             "id": "CommentReplyList",
             "properties": {
                 "items": {
-                    "description": "List of reply.",
+                    "description": "The list of replies. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
                     "items": {
                         "$ref": "CommentReply"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#commentReplyList",
                     "description": "This is always drive#commentReplyList.",
                     "type": "string"
                 },
                 "nextLink": {
                     "description": "A link to the next page of replies.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "The token to use to request the next page of results.",
+                    "description": "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.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "A link back to this list.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "File": {
@@ skipping 391 matching lines @@
                             "type": "string"
                         }
                     },
                     "type": "object"
                 },
                 "thumbnailLink": {
                     "description": "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.",
                     "type": "string"
                 },
                 "thumbnailVersion": {
-                    "description": "The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.",
+                    "description": "The thumbnail version for use in thumbnail cache invalidation.",
                     "format": "int64",
                     "type": "string"
                 },
                 "title": {
                     "description": "The title of this file.",
                     "type": "string"
                 },
                 "userPermission": {
                     "$ref": "Permission",
                     "description": "The permissions for the authenticated user on this file."
@@ skipping 41 matching lines @@
         },
         "FileList": {
             "description": "A list of files.",
             "id": "FileList",
             "properties": {
                 "etag": {
                     "description": "The ETag of the list.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "The actual list of files.",
+                    "description": "The list of files. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
                     "items": {
                         "$ref": "File"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#fileList",
                     "description": "This is always drive#fileList.",
                     "type": "string"
                 },
                 "nextLink": {
                     "description": "A link to the next page of files.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "The page token for the next page of files.",
+                    "description": "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.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "A link back to this list.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "GeneratedIds": {
@@ skipping 21 matching lines @@
         },
         "ParentList": {
             "description": "A list of a file's parents.",
             "id": "ParentList",
             "properties": {
                 "etag": {
                     "description": "The ETag of the list.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "The actual list of parents.",
+                    "description": "The list of parents.",
                     "items": {
                         "$ref": "ParentReference"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#parentList",
                     "description": "This is always drive#parentList.",
                     "type": "string"
                 },
@@ skipping 137 matching lines @@
         },
         "PermissionList": {
             "description": "A list of permissions associated with a file.",
             "id": "PermissionList",
             "properties": {
                 "etag": {
                     "description": "The ETag of the list.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "The actual list of permissions.",
+                    "description": "The list of permissions.",
                     "items": {
                         "$ref": "Permission"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#permissionList",
                     "description": "This is always drive#permissionList.",
                     "type": "string"
                 },
@@ skipping 151 matching lines @@
         },
         "RevisionList": {
             "description": "A list of revisions of a file.",
             "id": "RevisionList",
             "properties": {
                 "etag": {
                     "description": "The ETag of the list.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "The actual list of revisions.",
+                    "description": "The list of revisions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
                     "items": {
                         "$ref": "Revision"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#revisionList",
                     "description": "This is always drive#revisionList.",
                     "type": "string"
                 },
@@ skipping 44 matching lines @@
                     "type": "object"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "drive/v2/",
     "title": "Drive API",
     "version": "v2"
 }