Api-roll 42: 2016-11-08

discovery/googleapis/drive__v3.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 17 matching lines @@
                 }
             }
         }
     },
     "basePath": "/drive/v3/",
     "baseUrl": "https://www.googleapis.com/drive/v3/",
     "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": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/e4duC-lXcRy9uH0-B5jyFujr7MY\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/N2fY6s5zrwZA-4JC2uCCHKSs7Ys\"",
     "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:v3",
     "kind": "discovery#restDescription",
     "name": "drive",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 1302 matching lines @@
                     "id": "drive.revisions.list",
                     "parameterOrder": [
                         "fileId"
                     ],
                     "parameters": {
                         "fileId": {
                             "description": "The ID of the file.",
                             "location": "path",
                             "required": true,
                             "type": "string"
+                        },
+                        "pageSize": {
+                            "description": "The maximum number of revisions to return per page.",
+                            "format": "int32",
+                            "location": "query",
+                            "minimum": "1",
+                            "type": "integer"
+                        },
+                        "pageToken": {
+                            "description": "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.",
+                            "location": "query",
+                            "type": "string"
                         }
                     },
                     "path": "files/{fileId}/revisions",
                     "response": {
                         "$ref": "RevisionList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/drive",
                         "https://www.googleapis.com/auth/drive.appdata",
                         "https://www.googleapis.com/auth/drive.file",
@@ skipping 34 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/drive",
                         "https://www.googleapis.com/auth/drive.appdata",
                         "https://www.googleapis.com/auth/drive.file"
                     ]
                 }
             }
         }
     },
-    "revision": "20160819",
+    "revision": "20161027",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "About": {
             "description": "Information about the user, the user's Drive, and system capabilities.",
             "id": "About",
             "properties": {
                 "appInstalled": {
                     "description": "Whether the user has installed the requesting app.",
                     "type": "boolean"
                 },
@@ skipping 19 matching lines @@
                         "items": {
                             "type": "string"
                         },
                         "type": "array"
                     },
                     "description": "A map of source MIME type to possible targets for all supported imports.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "drive#about",
-                    "description": "This is always drive#about.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#about\".",
                     "type": "string"
                 },
                 "maxImportSizes": {
                     "additionalProperties": {
                         "format": "int64",
                         "type": "string"
                     },
                     "description": "A map of maximum import sizes by MIME type, in bytes.",
                     "type": "object"
                 },
@@ skipping 42 matching lines @@
                 "file": {
                     "$ref": "File",
                     "description": "The updated state of the file. Present if the file has not been removed."
                 },
                 "fileId": {
                     "description": "The ID of the file which has changed.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "drive#change",
-                    "description": "This is always drive#change.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#change\".",
                     "type": "string"
                 },
                 "removed": {
                     "description": "Whether the file has been removed from the view of the changes list, for example by deletion or lost access.",
                     "type": "boolean"
                 },
                 "time": {
                     "description": "The time of this change (RFC 3339 date-time).",
                     "format": "date-time",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ChangeList": {
             "description": "A list of changes for a user.",
             "id": "ChangeList",
             "properties": {
                 "changes": {
                     "description": "The page of changes.",
                     "items": {
                         "$ref": "Change"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#changeList",
-                    "description": "This is always drive#changeList.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#changeList\".",
                     "type": "string"
                 },
                 "newStartPageToken": {
                     "description": "The starting page token for future changes. This will be present only if the end of the current changes list has been reached.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "The page token for the next page of changes. This will be absent if the end of the current changes list has been reached.",
                     "type": "string"
                 }
@@ skipping 87 matching lines @@
                 "htmlContent": {
                     "description": "The content of the comment with HTML formatting.",
                     "type": "string"
                 },
                 "id": {
                     "description": "The ID of the comment.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "drive#comment",
-                    "description": "This is always drive#comment.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#comment\".",
                     "type": "string"
                 },
                 "modifiedTime": {
                     "description": "The last time the comment or any of its replies was modified (RFC 3339 date-time).",
                     "format": "date-time",
                     "type": "string"
                 },
                 "quotedFileContent": {
                     "description": "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.",
                     "properties": {
@@ skipping 28 matching lines @@
             "properties": {
                 "comments": {
                     "description": "The page of comments.",
                     "items": {
                         "$ref": "Comment"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#commentList",
-                    "description": "This is always drive#commentList.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#commentList\".",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "The page token for the next page of comments. This will be absent if the end of the comments list has been reached.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "File": {
@@ skipping 211 matching lines @@
                         }
                     },
                     "type": "object"
                 },
                 "isAppAuthorized": {
                     "description": "Whether the file was created or opened by the requesting app.",
                     "type": "boolean"
                 },
                 "kind": {
                     "default": "drive#file",
-                    "description": "This is always drive#file.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#file\".",
                     "type": "string"
                 },
                 "lastModifyingUser": {
                     "$ref": "User",
                     "description": "The last user to modify the file."
                 },
                 "md5Checksum": {
                     "description": "The MD5 checksum for the content of the file. This is only applicable to files with binary content in Drive.",
                     "type": "string"
                 },
                 "mimeType": {
                     "description": "The MIME type of the file.\nDrive 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.\nIf 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.",
                     "type": "string"
                 },
+                "modifiedByMe": {
+                    "description": "Whether the file has been modified by this user.",
+                    "type": "boolean"
+                },
                 "modifiedByMeTime": {
                     "description": "The last time the file was modified by the user (RFC 3339 date-time).",
                     "format": "date-time",
                     "type": "string"
                 },
                 "modifiedTime": {
                     "description": "The last time the file was modified by anyone (RFC 3339 date-time).\nNote that setting modifiedTime will also update modifiedByMeTime for the user.",
                     "format": "date-time",
                     "type": "string"
                 },
@@ skipping 139 matching lines @@
             "properties": {
                 "files": {
                     "description": "The page of files.",
                     "items": {
                         "$ref": "File"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#fileList",
-                    "description": "This is always drive#fileList.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#fileList\".",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "The page token for the next page of files. This will be absent if the end of the files list has been reached.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "GeneratedIds": {
             "description": "A list of generated file IDs which can be provided in create requests.",
             "id": "GeneratedIds",
             "properties": {
                 "ids": {
                     "description": "The IDs generated for the requesting user in the specified space.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "drive#generatedIds",
-                    "description": "This is always drive#generatedIds",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#generatedIds\".",
                     "type": "string"
                 },
                 "space": {
                     "description": "The type of file that can be created with these IDs.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Permission": {
@@ skipping 20 matching lines @@
                     "description": "The time at which this permission will expire (RFC 3339 date-time).",
                     "format": "date-time",
                     "type": "string"
                 },
                 "id": {
                     "description": "The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "drive#permission",
-                    "description": "This is always drive#permission.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#permission\".",
                     "type": "string"
                 },
                 "photoLink": {
                     "description": "A link to the user's profile photo, if available.",
                     "type": "string"
                 },
                 "role": {
                     "annotations": {
                         "required": [
                             "drive.permissions.create"
@@ skipping 13 matching lines @@
                 }
             },
             "type": "object"
         },
         "PermissionList": {
             "description": "A list of permissions for a file.",
             "id": "PermissionList",
             "properties": {
                 "kind": {
                     "default": "drive#permissionList",
-                    "description": "This is always drive#permissionList.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#permissionList\".",
                     "type": "string"
                 },
                 "permissions": {
                     "description": "The full list of permissions.",
                     "items": {
                         "$ref": "Permission"
                     },
                     "type": "array"
                 }
             },
@@ skipping 32 matching lines @@
                 "htmlContent": {
                     "description": "The content of the reply with HTML formatting.",
                     "type": "string"
                 },
                 "id": {
                     "description": "The ID of the reply.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "drive#reply",
-                    "description": "This is always drive#reply.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#reply\".",
                     "type": "string"
                 },
                 "modifiedTime": {
                     "description": "The last time the reply was modified (RFC 3339 date-time).",
                     "format": "date-time",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ReplyList": {
             "description": "A list of replies to a comment on a file.",
             "id": "ReplyList",
             "properties": {
                 "kind": {
                     "default": "drive#replyList",
-                    "description": "This is always drive#replyList.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#replyList\".",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "The page token for the next page of replies. This will be absent if the end of the replies list has been reached.",
                     "type": "string"
                 },
                 "replies": {
                     "description": "The page of replies.",
                     "items": {
                         "$ref": "Reply"
@@ skipping 10 matching lines @@
                 "id": {
                     "description": "The ID of the revision.",
                     "type": "string"
                 },
                 "keepForever": {
                     "description": "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.\nThis field is only applicable to files with binary content in Drive.",
                     "type": "boolean"
                 },
                 "kind": {
                     "default": "drive#revision",
-                    "description": "This is always drive#revision.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#revision\".",
                     "type": "string"
                 },
                 "lastModifyingUser": {
                     "$ref": "User",
                     "description": "The last user to modify this revision."
                 },
                 "md5Checksum": {
                     "description": "The MD5 checksum of the revision's content. This is only applicable to files with binary content in Drive.",
                     "type": "string"
                 },
@@ skipping 29 matching lines @@
                 }
             },
             "type": "object"
         },
         "RevisionList": {
             "description": "A list of revisions of a file.",
             "id": "RevisionList",
             "properties": {
                 "kind": {
                     "default": "drive#revisionList",
-                    "description": "This is always drive#revisionList.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#revisionList\".",
+                    "type": "string"
+                },
+                "nextPageToken": {
+                    "description": "The page token for the next page of revisions. This will be absent if the end of the revisions list has been reached.",
                     "type": "string"
                 },
                 "revisions": {
                     "description": "The full list of revisions.",
                     "items": {
                         "$ref": "Revision"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "StartPageToken": {
             "id": "StartPageToken",
             "properties": {
                 "kind": {
                     "default": "drive#startPageToken",
-                    "description": "This is always drive#startPageToken.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#startPageToken\".",
                     "type": "string"
                 },
                 "startPageToken": {
                     "description": "The starting page token for listing changes.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "User": {
             "description": "Information about a Drive user.",
             "id": "User",
             "properties": {
                 "displayName": {
                     "description": "A plain text displayable name for this user.",
                     "type": "string"
                 },
                 "emailAddress": {
                     "description": "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.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "drive#user",
-                    "description": "This is always drive#user.",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"drive#user\".",
                     "type": "string"
                 },
                 "me": {
                     "description": "Whether this user is the requesting user.",
                     "type": "boolean"
                 },
                 "permissionId": {
                     "description": "The user's ID as visible in Permission resources.",
                     "type": "string"
                 },
                 "photoLink": {
                     "description": "A link to the user's profile photo, if available.",
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "drive/v3/",
     "title": "Drive API",
     "version": "v3"
 }