Updated docs.
diff --git a/docs/dyn/drive_v2.permissions.html b/docs/dyn/drive_v2.permissions.html
new file mode 100644
index 0000000..9a1743b
--- /dev/null
+++ b/docs/dyn/drive_v2.permissions.html
@@ -0,0 +1,411 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+ margin: 0;
+ padding: 0;
+ border: 0;
+ font-weight: inherit;
+ font-style: inherit;
+ font-size: 100%;
+ font-family: inherit;
+ vertical-align: baseline;
+}
+
+body {
+ font-size: 13px;
+ padding: 1em;
+}
+
+h1 {
+ font-size: 26px;
+ margin-bottom: 1em;
+}
+
+h2 {
+ font-size: 24px;
+ margin-bottom: 1em;
+}
+
+h3 {
+ font-size: 20px;
+ margin-bottom: 1em;
+ margin-top: 1em;
+}
+
+pre, code {
+ line-height: 1.5;
+ font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+ margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+ font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+ border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+ margin-top: 0.5em;
+}
+
+.firstline {
+ margin-left: 2 em;
+}
+
+.method {
+ margin-top: 1em;
+ border: solid 1px #CCC;
+ padding: 1em;
+ background: #EEE;
+}
+
+.details {
+ font-weight: bold;
+ font-size: 14px;
+}
+
+</style>
+
+<h1><a href="drive_v2.html">Drive API</a> . <a href="drive_v2.permissions.html">permissions</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+ <code><a href="#delete">delete(fileId, permissionId)</a></code></p>
+<p class="firstline">Deletes a permission from a file.</p>
+<p class="toc_element">
+ <code><a href="#get">get(fileId, permissionId)</a></code></p>
+<p class="firstline">Gets a permission by ID.</p>
+<p class="toc_element">
+ <code><a href="#getIdForEmail">getIdForEmail(email)</a></code></p>
+<p class="firstline">Returns the permission ID for an email address.</p>
+<p class="toc_element">
+ <code><a href="#insert">insert(fileId, body, sendNotificationEmails=None, emailMessage=None)</a></code></p>
+<p class="firstline">Inserts a permission for a file.</p>
+<p class="toc_element">
+ <code><a href="#list">list(fileId)</a></code></p>
+<p class="firstline">Lists a file's permissions.</p>
+<p class="toc_element">
+ <code><a href="#patch">patch(fileId, permissionId, body, transferOwnership=None)</a></code></p>
+<p class="firstline">Updates a permission. This method supports patch semantics.</p>
+<p class="toc_element">
+ <code><a href="#update">update(fileId, permissionId, body, transferOwnership=None)</a></code></p>
+<p class="firstline">Updates a permission.</p>
+<h3>Method Details</h3>
+<div class="method">
+ <code class="details" id="delete">delete(fileId, permissionId)</code>
+ <pre>Deletes a permission from a file.
+
+Args:
+ fileId: string, The ID for the file. (required)
+ permissionId: string, The ID for the permission. (required)
+</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="get">get(fileId, permissionId)</code>
+ <pre>Gets a permission by ID.
+
+Args:
+ fileId: string, The ID for the file. (required)
+ permissionId: string, The ID for the permission. (required)
+
+Returns:
+ An object of the form:
+
+ { # A permission for a file.
+ "withLink": True or False, # Whether the link is required for this permission.
+ "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is populated when the permission type is "user", "group" or "domain".
+ "name": "A String", # The name for this permission.
+ "kind": "drive#permission", # This is always drive#permission.
+ "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "authKey": "A String", # The authkey parameter required for this permission.
+ "etag": "A String", # The ETag of the permission.
+ "emailAddress": "A String", # The email address of the user this permission refers to. This is an output-only field which is populated when the permission type is "user" and the given user's Google+ profile privacy settings allow exposing their email address.
+ "photoLink": "A String", # A link to the profile photo, if available.
+ "role": "A String", # The primary role for this user. Allowed values are:
+ # - owner
+ # - reader
+ # - writer
+ "type": "A String", # The account type. Allowed values are:
+ # - user
+ # - group
+ # - domain
+ # - anyone
+ "additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
+ "A String",
+ ],
+ "selfLink": "A String", # A link back to this permission.
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="getIdForEmail">getIdForEmail(email)</code>
+ <pre>Returns the permission ID for an email address.
+
+Args:
+ email: string, The email address for which to return a permission ID (required)
+
+Returns:
+ An object of the form:
+
+ { # An ID for a user or group as seen in Permission items.
+ "kind": "drive#permissionId", # This is always drive#permissionId.
+ "id": "A String", # The permission ID.
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="insert">insert(fileId, body, sendNotificationEmails=None, emailMessage=None)</code>
+ <pre>Inserts a permission for a file.
+
+Args:
+ fileId: string, The ID for the file. (required)
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{ # A permission for a file.
+ "withLink": True or False, # Whether the link is required for this permission.
+ "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is populated when the permission type is "user", "group" or "domain".
+ "name": "A String", # The name for this permission.
+ "kind": "drive#permission", # This is always drive#permission.
+ "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "authKey": "A String", # The authkey parameter required for this permission.
+ "etag": "A String", # The ETag of the permission.
+ "emailAddress": "A String", # The email address of the user this permission refers to. This is an output-only field which is populated when the permission type is "user" and the given user's Google+ profile privacy settings allow exposing their email address.
+ "photoLink": "A String", # A link to the profile photo, if available.
+ "role": "A String", # The primary role for this user. Allowed values are:
+ # - owner
+ # - reader
+ # - writer
+ "type": "A String", # The account type. Allowed values are:
+ # - user
+ # - group
+ # - domain
+ # - anyone
+ "additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
+ "A String",
+ ],
+ "selfLink": "A String", # A link back to this permission.
+}
+
+ sendNotificationEmails: boolean, Whether to send notification emails when sharing to users or groups.
+ emailMessage: string, A custom message to include in notification emails.
+
+Returns:
+ An object of the form:
+
+ { # A permission for a file.
+ "withLink": True or False, # Whether the link is required for this permission.
+ "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is populated when the permission type is "user", "group" or "domain".
+ "name": "A String", # The name for this permission.
+ "kind": "drive#permission", # This is always drive#permission.
+ "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "authKey": "A String", # The authkey parameter required for this permission.
+ "etag": "A String", # The ETag of the permission.
+ "emailAddress": "A String", # The email address of the user this permission refers to. This is an output-only field which is populated when the permission type is "user" and the given user's Google+ profile privacy settings allow exposing their email address.
+ "photoLink": "A String", # A link to the profile photo, if available.
+ "role": "A String", # The primary role for this user. Allowed values are:
+ # - owner
+ # - reader
+ # - writer
+ "type": "A String", # The account type. Allowed values are:
+ # - user
+ # - group
+ # - domain
+ # - anyone
+ "additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
+ "A String",
+ ],
+ "selfLink": "A String", # A link back to this permission.
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="list">list(fileId)</code>
+ <pre>Lists a file's permissions.
+
+Args:
+ fileId: string, The ID for the file. (required)
+
+Returns:
+ An object of the form:
+
+ { # A list of permissions associated with a file.
+ "items": [ # The actual list of permissions.
+ { # A permission for a file.
+ "withLink": True or False, # Whether the link is required for this permission.
+ "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is populated when the permission type is "user", "group" or "domain".
+ "name": "A String", # The name for this permission.
+ "kind": "drive#permission", # This is always drive#permission.
+ "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "authKey": "A String", # The authkey parameter required for this permission.
+ "etag": "A String", # The ETag of the permission.
+ "emailAddress": "A String", # The email address of the user this permission refers to. This is an output-only field which is populated when the permission type is "user" and the given user's Google+ profile privacy settings allow exposing their email address.
+ "photoLink": "A String", # A link to the profile photo, if available.
+ "role": "A String", # The primary role for this user. Allowed values are:
+ # - owner
+ # - reader
+ # - writer
+ "type": "A String", # The account type. Allowed values are:
+ # - user
+ # - group
+ # - domain
+ # - anyone
+ "additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
+ "A String",
+ ],
+ "selfLink": "A String", # A link back to this permission.
+ },
+ ],
+ "kind": "drive#permissionList", # This is always drive#permissionList.
+ "etag": "A String", # The ETag of the list.
+ "selfLink": "A String", # A link back to this list.
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="patch">patch(fileId, permissionId, body, transferOwnership=None)</code>
+ <pre>Updates a permission. This method supports patch semantics.
+
+Args:
+ fileId: string, The ID for the file. (required)
+ permissionId: string, The ID for the permission. (required)
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{ # A permission for a file.
+ "withLink": True or False, # Whether the link is required for this permission.
+ "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is populated when the permission type is "user", "group" or "domain".
+ "name": "A String", # The name for this permission.
+ "kind": "drive#permission", # This is always drive#permission.
+ "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "authKey": "A String", # The authkey parameter required for this permission.
+ "etag": "A String", # The ETag of the permission.
+ "emailAddress": "A String", # The email address of the user this permission refers to. This is an output-only field which is populated when the permission type is "user" and the given user's Google+ profile privacy settings allow exposing their email address.
+ "photoLink": "A String", # A link to the profile photo, if available.
+ "role": "A String", # The primary role for this user. Allowed values are:
+ # - owner
+ # - reader
+ # - writer
+ "type": "A String", # The account type. Allowed values are:
+ # - user
+ # - group
+ # - domain
+ # - anyone
+ "additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
+ "A String",
+ ],
+ "selfLink": "A String", # A link back to this permission.
+}
+
+ transferOwnership: boolean, Whether changing a role to 'owner' should also downgrade the current owners to writers.
+
+Returns:
+ An object of the form:
+
+ { # A permission for a file.
+ "withLink": True or False, # Whether the link is required for this permission.
+ "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is populated when the permission type is "user", "group" or "domain".
+ "name": "A String", # The name for this permission.
+ "kind": "drive#permission", # This is always drive#permission.
+ "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "authKey": "A String", # The authkey parameter required for this permission.
+ "etag": "A String", # The ETag of the permission.
+ "emailAddress": "A String", # The email address of the user this permission refers to. This is an output-only field which is populated when the permission type is "user" and the given user's Google+ profile privacy settings allow exposing their email address.
+ "photoLink": "A String", # A link to the profile photo, if available.
+ "role": "A String", # The primary role for this user. Allowed values are:
+ # - owner
+ # - reader
+ # - writer
+ "type": "A String", # The account type. Allowed values are:
+ # - user
+ # - group
+ # - domain
+ # - anyone
+ "additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
+ "A String",
+ ],
+ "selfLink": "A String", # A link back to this permission.
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="update">update(fileId, permissionId, body, transferOwnership=None)</code>
+ <pre>Updates a permission.
+
+Args:
+ fileId: string, The ID for the file. (required)
+ permissionId: string, The ID for the permission. (required)
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{ # A permission for a file.
+ "withLink": True or False, # Whether the link is required for this permission.
+ "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is populated when the permission type is "user", "group" or "domain".
+ "name": "A String", # The name for this permission.
+ "kind": "drive#permission", # This is always drive#permission.
+ "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "authKey": "A String", # The authkey parameter required for this permission.
+ "etag": "A String", # The ETag of the permission.
+ "emailAddress": "A String", # The email address of the user this permission refers to. This is an output-only field which is populated when the permission type is "user" and the given user's Google+ profile privacy settings allow exposing their email address.
+ "photoLink": "A String", # A link to the profile photo, if available.
+ "role": "A String", # The primary role for this user. Allowed values are:
+ # - owner
+ # - reader
+ # - writer
+ "type": "A String", # The account type. Allowed values are:
+ # - user
+ # - group
+ # - domain
+ # - anyone
+ "additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
+ "A String",
+ ],
+ "selfLink": "A String", # A link back to this permission.
+}
+
+ transferOwnership: boolean, Whether changing a role to 'owner' should also downgrade the current owners to writers.
+
+Returns:
+ An object of the form:
+
+ { # A permission for a file.
+ "withLink": True or False, # Whether the link is required for this permission.
+ "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is populated when the permission type is "user", "group" or "domain".
+ "name": "A String", # The name for this permission.
+ "kind": "drive#permission", # This is always drive#permission.
+ "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of 'id' or 'value' fields must be specified.
+ "authKey": "A String", # The authkey parameter required for this permission.
+ "etag": "A String", # The ETag of the permission.
+ "emailAddress": "A String", # The email address of the user this permission refers to. This is an output-only field which is populated when the permission type is "user" and the given user's Google+ profile privacy settings allow exposing their email address.
+ "photoLink": "A String", # A link to the profile photo, if available.
+ "role": "A String", # The primary role for this user. Allowed values are:
+ # - owner
+ # - reader
+ # - writer
+ "type": "A String", # The account type. Allowed values are:
+ # - user
+ # - group
+ # - domain
+ # - anyone
+ "additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
+ "A String",
+ ],
+ "selfLink": "A String", # A link back to this permission.
+ }</pre>
+</div>
+
+</body></html>
\ No newline at end of file