Api-roll 48: 2017-04-18

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/k95lUH_zhTckcacGeDVZVmgaiTM\"",
+    "etag": "\"YWOzh2SDasdU84ArJnpYek-OMdg/EbtNcB6XTkXxPp1AxlMf5BZZggs\"",
     "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 1157 matching lines @@
                             "type": "string"
                         },
                         "includeTeamDriveItems": {
                             "default": "false",
                             "description": "Whether Team Drive items should be included in results.",
                             "location": "query",
                             "type": "boolean"
                         },
                         "maxResults": {
                             "default": "100",
-                            "description": "Maximum number of files to return.",
+                            "description": "The maximum number of files to return per page. Partial or empty result pages are possible even before the end of the files list has been reached.",
                             "format": "int32",
                             "location": "query",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "orderBy": {
                             "description": "A comma-separated list of sort keys. Valid keys are 'createdDate', 'folder', 'lastViewedByMeDate', 'modifiedByMeDate', 'modifiedDate', 'quotaBytesUsed', 'recency', 'sharedWithMeDate', 'starred', and 'title'. Each key sorts ascending by default, but may be reversed with the 'desc' modifier. Example usage: ?orderBy=folder,modifiedDate desc,title. Please note that there is a current limitation for users with approximately one million files in which the requested sort order is ignored.",
                             "location": "query",
                             "type": "string"
                         },
@@ skipping 1782 matching lines @@
                     "response": {
                         "$ref": "TeamDrive"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/drive"
                     ]
                 }
             }
         }
     },
-    "revision": "20170320",
+    "revision": "20170406",
     "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 191 matching lines @@
                     "type": "string"
                 },
                 "rootFolderId": {
                     "description": "The id of the root folder.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "A link back to this item.",
                     "type": "string"
                 },
+                "teamDriveThemes": {
+                    "description": "A list of themes that are supported for Team Drives.",
+                    "items": {
+                        "properties": {
+                            "backgroundImageLink": {
+                                "description": "A link to this Team Drive theme's background image.",
+                                "type": "string"
+                            },
+                            "colorRgb": {
+                                "description": "The color of this Team Drive theme as an RGB hex string.",
+                                "type": "string"
+                            },
+                            "id": {
+                                "description": "The ID of the theme.",
+                                "type": "string"
+                            }
+                        },
+                        "type": "object"
+                    },
+                    "type": "array"
+                },
                 "user": {
                     "$ref": "User",
                     "description": "The authenticated user."
                 }
             },
             "type": "object"
         },
         "App": {
             "description": "The apps resource provides a list of the apps that a user has installed, with information about each app's supported MIME types, file extensions, and other details.",
             "id": "App",
@@ skipping 581 matching lines @@
             "properties": {
                 "alternateLink": {
                     "description": "A link for opening the file in a relevant Google editor or viewer.",
                     "type": "string"
                 },
                 "appDataContents": {
                     "description": "Whether this file is in the Application Data folder.",
                     "type": "boolean"
                 },
                 "canComment": {
-                    "description": "Whether the current user can comment on the file. Deprecated: use capabilities/canComment.",
+                    "description": "Deprecated: use capabilities/canComment.",
                     "type": "boolean"
                 },
                 "canReadRevisions": {
-                    "description": "Whether the current user has read access to the Revisions resource of the file. Deprecated: use capabilities/canReadRevisions.",
+                    "description": "Deprecated: use capabilities/canReadRevisions.",
                     "type": "boolean"
                 },
                 "capabilities": {
-                    "description": "Capabilities the current user has on the file. Each capability corresponds to a fine-grained action that a user may take.",
+                    "description": "Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take.",
                     "properties": {
                         "canAddChildren": {
                             "description": "Whether the current user can add children to this folder. This is always false when the item is not a folder.",
                             "type": "boolean"
                         },
                         "canComment": {
-                            "description": "Whether the current user can comment on the file.",
+                            "description": "Whether the current user can comment on this file.",
                             "type": "boolean"
                         },
                         "canCopy": {
-                            "description": "Whether the file can be copied by the current user. For a Team Drive item, whether non-folder descendants of this item, or this item itself if it is not a folder, can be copied.",
+                            "description": "Whether the current user can copy this file. For a Team Drive item, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder.",
                             "type": "boolean"
                         },
                         "canDelete": {
-                            "description": "Whether the file can be deleted by the current user.",
+                            "description": "Whether the current user can delete this file.",
                             "type": "boolean"
                         },
                         "canDownload": {
-                            "description": "Whether the file can be downloaded by the current user.",
+                            "description": "Whether the current user can download this file.",
                             "type": "boolean"
                         },
                         "canEdit": {
-                            "description": "Whether the file can be edited by the current user.",
+                            "description": "Whether the current user can edit this file.",
                             "type": "boolean"
                         },
                         "canListChildren": {
                             "description": "Whether the current user can list the children of this folder. This is always false when the item is not a folder.",
                             "type": "boolean"
                         },
                         "canMoveItemIntoTeamDrive": {
                             "description": "Whether the current user can move this item into a Team Drive. If the item is in a Team Drive, this field is equivalent to canMoveTeamDriveItem.",
                             "type": "boolean"
                         },
                         "canMoveTeamDriveItem": {
                             "description": "Whether the current user can move this Team Drive item by changing its parent. Note that a request to change the parent for this item may still fail depending on the new parent that is being added. Only populated for Team Drive files.",
                             "type": "boolean"
                         },
                         "canReadRevisions": {
-                            "description": "Whether the current user has read access to the Revisions resource of the file. For a Team Drive item, whether revisions of non-folder descendants of this item, or this item itself if it is not a folder, can be read.",
+                            "description": "Whether the current user can read the revisions resource of this file. For a Team Drive item, whether revisions of non-folder descendants of this item, or this item itself if it is not a folder, can be read.",
                             "type": "boolean"
                         },
                         "canReadTeamDrive": {
-                            "description": "Whether the current user has read access to the Team Drive to which this file belongs. Only populated for Team Drive files.",
+                            "description": "Whether the current user can read the Team Drive to which this file belongs. Only populated for Team Drive files.",
                             "type": "boolean"
                         },
                         "canRemoveChildren": {
                             "description": "Whether the current user can remove children from this folder. This is always false when the item is not a folder.",
                             "type": "boolean"
                         },
                         "canRename": {
-                            "description": "Whether the file can be renamed by the current user.",
+                            "description": "Whether the current user can rename this file.",
                             "type": "boolean"
                         },
                         "canShare": {
-                            "description": "Whether the file's sharing settings can be modified by the current user.",
+                            "description": "Whether the current user can modify the sharing settings for this file.",
                             "type": "boolean"
                         },
                         "canTrash": {
-                            "description": "Whether the file can be trashed by the current user.",
+                            "description": "Whether the current user can move this file to trash.",
                             "type": "boolean"
                         },
                         "canUntrash": {
-                            "description": "Whether the file can be restored from the trash by the current user.",
+                            "description": "Whether the current user can restore this file from trash.",
                             "type": "boolean"
                         }
                     },
                     "type": "object"
                 },
                 "copyable": {
-                    "description": "Whether the file can be copied by the current user. Deprecated: use capabilities/canCopy.",
+                    "description": "Deprecated: use capabilities/canCopy.",
                     "type": "boolean"
                 },
                 "createdDate": {
                     "description": "Create time for this file (formatted RFC 3339 timestamp).",
                     "format": "date-time",
                     "type": "string"
                 },
                 "defaultOpenWithLink": {
                     "description": "A link to open this file with the user's default app for this file. Only populated when the drive.apps.readonly scope is used.",
                     "type": "string"
                 },
                 "description": {
                     "description": "A short description of the file.",
                     "type": "string"
                 },
                 "downloadUrl": {
                     "type": "string"
                 },
                 "editable": {
-                    "description": "Whether the file can be edited by the current user. Deprecated: use capabilities/canEdit.",
+                    "description": "Deprecated: use capabilities/canEdit.",
                     "type": "boolean"
                 },
                 "embedLink": {
                     "description": "A link for embedding the file.",
                     "type": "string"
                 },
                 "etag": {
                     "description": "ETag of the file.",
                     "type": "string"
                 },
@@ skipping 301 matching lines @@
                 "quotaBytesUsed": {
                     "description": "The number of quota bytes used by this file.",
                     "format": "int64",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "A link back to this file.",
                     "type": "string"
                 },
                 "shareable": {
-                    "description": "Whether the file's sharing settings can be modified by the current user. Deprecated: use capabilities/canShare.",
+                    "description": "Deprecated: use capabilities/canShare.",
                     "type": "boolean"
                 },
                 "shared": {
                     "description": "Whether the file has been shared. Not populated for Team Drive files.",
                     "type": "boolean"
                 },
                 "sharedWithMeDate": {
                     "description": "Time at which this file was shared with the user (formatted RFC 3339 timestamp).",
                     "format": "date-time",
                     "type": "string"
@@ skipping 225 matching lines @@
                     "description": "Additional roles for this user. Only commenter is currently allowed, though more may be supported in the future.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "authKey": {
                     "description": "The authkey parameter required for this permission.",
                     "type": "string"
                 },
+                "deleted": {
+                    "description": "Whether the account of the permission has been deleted. This field only pertains to user and group permissions.",
+                    "type": "boolean"
+                },
                 "domain": {
                     "description": "The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.",
                     "type": "string"
                 },
                 "emailAddress": {
                     "description": "The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.",
                     "type": "string"
                 },
                 "etag": {
                     "description": "The ETag of the permission.",
@@ skipping 28 matching lines @@
                         ]
                     },
                     "description": "The primary role for this user. While new values may be supported in the future, the following are currently allowed:  \n- organizer \n- owner \n- reader \n- writer",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "A link back to this permission.",
                     "type": "string"
                 },
                 "teamDrivePermissionDetails": {
-                    "description": "Details of whether the Permissions on this Team Drive item are inherited or directly on this item. This is an output-only field which is present only for Team Drive items.",
+                    "description": "Details of whether the permissions on this Team Drive item are inherited or directly on this item. This is an output-only field which is present only for Team Drive items.",
                     "items": {
                         "properties": {
                             "additionalRoles": {
                                 "description": "Additional roles for this user. Only commenter is currently possible, though more may be supported in the future.",
                                 "items": {
                                     "type": "string"
                                 },
                                 "type": "array"
                             },
                             "inherited": {
@@ skipping 272 matching lines @@
                     "description": "The starting page token for listing changes.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TeamDrive": {
             "description": "Representation of a Team Drive.",
             "id": "TeamDrive",
             "properties": {
+                "backgroundImageFile": {
+                    "description": "An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field that can only be set on a drive.teamdrives.update request that does not set themeId. When specified, all fields of the backgroundImageFile must be set.",
+                    "properties": {
+                        "id": {
+                            "description": "The ID of an image file in Drive to use for the background image.",
+                            "type": "string"
+                        },
+                        "width": {
+                            "description": "The width of the cropped image in the closed range of 0 to 1, which is the width of the cropped image divided by the width of the entire image. The height is computed by applying a width to height aspect ratio of 80 to 9. The resulting image must be at least 1280 pixels wide and 144 pixels high.",
+                            "format": "float",
+                            "type": "number"
+                        },
+                        "xCoordinate": {
+                            "description": "The X coordinate of the upper left corner of the cropping area in the background image. This is a value in the closed range of 0 to 1 which is the horizontal distance from the left side of the entire image to the left side of the cropping area divided by the width of the entire image.",
+                            "format": "float",
+                            "type": "number"
+                        },
+                        "yCoordinate": {
+                            "description": "The Y coordinate of the upper left corner of the cropping area in the background image. This is a value in the closed range of 0 to 1 which is the vertical distance from the top side of the entire image to the top side of the cropping area divided by the height of the entire image.",
+                            "format": "float",
+                            "type": "number"
+                        }
+                    },
+                    "type": "object"
+                },
+                "backgroundImageLink": {
+                    "description": "A short-lived link to this Team Drive's background image.",
+                    "type": "string"
+                },
                 "capabilities": {
                     "description": "Capabilities the current user has on this Team Drive.",
                     "properties": {
                         "canAddChildren": {
                             "description": "Whether the current user can add children to folders in this Team Drive.",
                             "type": "boolean"
                         },
+                        "canChangeTeamDriveBackground": {
+                            "description": "Whether the current user can change the background of this Team Drive.",
+                            "type": "boolean"
+                        },
                         "canComment": {
                             "description": "Whether the current user can comment on files in this Team Drive.",
                             "type": "boolean"
                         },
                         "canCopy": {
-                            "description": "Whether files in this Team Drive can be copied by the current user.",
+                            "description": "Whether the current user can copy files in this Team Drive.",
                             "type": "boolean"
                         },
                         "canDeleteTeamDrive": {
-                            "description": "Whether this Team Drive can be deleted by the current user.",
+                            "description": "Whether the current user can delete this Team Drive. Attempting to delete the Team Drive may still fail if there are untrashed items inside the Team Drive.",
                             "type": "boolean"
                         },
                         "canDownload": {
-                            "description": "Whether files in this Team Drive can be downloaded by the current user.",
+                            "description": "Whether the current user can download files in this Team Drive.",
                             "type": "boolean"
                         },
                         "canEdit": {
-                            "description": "Whether files in this Team Drive can be edited by the current user.",
+                            "description": "Whether the current user can edit files in this Team Drive",
                             "type": "boolean"
                         },
                         "canListChildren": {
                             "description": "Whether the current user can list the children of folders in this Team Drive.",
                             "type": "boolean"
                         },
                         "canManageMembers": {
                             "description": "Whether the current user can add members to this Team Drive or remove them or change their role.",
                             "type": "boolean"
                         },
                         "canReadRevisions": {
-                            "description": "Whether the current user has read access to the Revisions resource of files in this Team Drive.",
+                            "description": "Whether the current user can read the revisions resource of files in this Team Drive.",
                             "type": "boolean"
                         },
                         "canRemoveChildren": {
                             "description": "Whether the current user can remove children from folders in this Team Drive.",
                             "type": "boolean"
                         },
                         "canRename": {
-                            "description": "Whether files or folders in this Team Drive can be renamed by the current user.",
+                            "description": "Whether the current user can rename files or folders in this Team Drive.",
                             "type": "boolean"
                         },
                         "canRenameTeamDrive": {
-                            "description": "Whether this Team Drive can be renamed by the current user.",
+                            "description": "Whether the current user can rename this Team Drive.",
                             "type": "boolean"
                         },
                         "canShare": {
                             "description": "Whether the current user can share files or folders in this Team Drive.",
                             "type": "boolean"
                         }
                     },
                     "type": "object"
                 },
+                "colorRgb": {
+                    "description": "The color of this Team Drive as an RGB hex string. It can only be set on a drive.teamdrives.update request that does not set themeId.",
+                    "type": "string"
+                },
                 "id": {
                     "description": "The ID of this Team Drive which is also the ID of the top level folder for this Team Drive.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "drive#teamDrive",
                     "description": "This is always drive#teamDrive",
                     "type": "string"
                 },
                 "name": {
                     "description": "The name of this Team Drive.",
                     "type": "string"
+                },
+                "themeId": {
+                    "description": "The ID of the theme from which the background image and color will be set. The set of possible teamDriveThemes can be retrieved from a drive.about.get response. When not specified on a drive.teamdrives.insert request, a random theme is chosen from which the background image and color are set. This is a write only field that can only be set on a request that does not set colorRgb or backgroundImageFile.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "TeamDriveList": {
             "description": "A list of Team Drives.",
             "id": "TeamDriveList",
             "properties": {
                 "items": {
                     "description": "The list of Team Drives.",
@@ skipping 50 matching lines @@
                     "type": "object"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "drive/v2/",
     "title": "Drive API",
     "version": "v2"
 }