docs: update generated docs (#1053)
Updates for both discovery docs and epydoc API Documentation
Fixes: #1049
diff --git a/docs/dyn/gmail_v1.users.settings.delegates.html b/docs/dyn/gmail_v1.users.settings.delegates.html
index 6eff894..8190809 100644
--- a/docs/dyn/gmail_v1.users.settings.delegates.html
+++ b/docs/dyn/gmail_v1.users.settings.delegates.html
@@ -75,52 +75,38 @@
<h1><a href="gmail_v1.html">Gmail API</a> . <a href="gmail_v1.users.html">users</a> . <a href="gmail_v1.users.settings.html">settings</a> . <a href="gmail_v1.users.settings.delegates.html">delegates</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
+ <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
<code><a href="#create">create(userId, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Adds a delegate with its verification status set directly to</p>
+<p class="firstline">Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. The delegate user must be a member of the same G Suite organization as the delegator user. Gmail imposes limitations on the number of delegates and delegators each user in a G Suite organization can have. These limits depend on your organization, but in general each user can have up to 25 delegates and up to 10 delegators. Note that a delegate user must be referred to by their primary email address, and not an email alias. Also note that when a new delegate is created, there may be up to a one minute delay before the new delegate is available for use. This method is only available to service account clients that have been delegated domain-wide authority.</p>
<p class="toc_element">
<code><a href="#delete">delete(userId, delegateEmail, x__xgafv=None)</a></code></p>
-<p class="firstline">Removes the specified delegate (which can be of any verification status),</p>
+<p class="firstline">Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. Note that a delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.</p>
<p class="toc_element">
<code><a href="#get">get(userId, delegateEmail, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the specified delegate.</p>
+<p class="firstline">Gets the specified delegate. Note that a delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.</p>
<p class="toc_element">
<code><a href="#list">list(userId, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists the delegates for the specified account.</p>
+<p class="firstline">Lists the delegates for the specified account. This method is only available to service account clients that have been delegated domain-wide authority.</p>
<h3>Method Details</h3>
<div class="method">
+ <code class="details" id="close">close()</code>
+ <pre>Close httplib2 connections.</pre>
+</div>
+
+<div class="method">
<code class="details" id="create">create(userId, body=None, x__xgafv=None)</code>
- <pre>Adds a delegate with its verification status set directly to
-`accepted`, without sending any verification email. The
-delegate user must be a member of the same G Suite organization as the
-delegator user.
-
-Gmail imposes limitations on the number of delegates and delegators each
-user in a G Suite organization can have. These limits depend on your
-organization, but in general each user can have up to 25 delegates and
-up to 10 delegators.
-
-Note that a delegate user must be referred to by their primary email
-address, and not an email alias.
-
-Also note that when a new delegate is created, there may be up to a one
-minute delay before the new delegate is available for use.
-
-This method is only available to service account clients that have been
-delegated domain-wide authority.
+ <pre>Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. The delegate user must be a member of the same G Suite organization as the delegator user. Gmail imposes limitations on the number of delegates and delegators each user in a G Suite organization can have. These limits depend on your organization, but in general each user can have up to 25 delegates and up to 10 delegators. Note that a delegate user must be referred to by their primary email address, and not an email alias. Also note that when a new delegate is created, there may be up to a one minute delay before the new delegate is available for use. This method is only available to service account clients that have been delegated domain-wide authority.
Args:
- userId: string, User's email address. The special value "me"
-can be used to indicate the authenticated user. (required)
+ userId: string, User's email address. The special value "me" can be used to indicate the authenticated user. (required)
body: object, The request body.
The object takes the form of:
-{ # Settings for a delegate. Delegates can read, send, and delete messages, as
- # well as view and add contacts, for the delegator's account. See
- # <a href="https://support.google.com/mail/answer/138350">"Set up
- # mail delegation"</a> for more information about delegates.
+{ # Settings for a delegate. Delegates can read, send, and delete messages, as well as view and add contacts, for the delegator's account. See "Set up mail delegation" for more information about delegates.
+ "verificationStatus": "A String", # Indicates whether this address has been verified and can act as a delegate for the account. Read-only.
"delegateEmail": "A String", # The email address of the delegate.
- "verificationStatus": "A String", # Indicates whether this address has been verified and can act as a delegate
- # for the account. Read-only.
}
x__xgafv: string, V1 error format.
@@ -131,30 +117,18 @@
Returns:
An object of the form:
- { # Settings for a delegate. Delegates can read, send, and delete messages, as
- # well as view and add contacts, for the delegator's account. See
- # <a href="https://support.google.com/mail/answer/138350">"Set up
- # mail delegation"</a> for more information about delegates.
+ { # Settings for a delegate. Delegates can read, send, and delete messages, as well as view and add contacts, for the delegator's account. See "Set up mail delegation" for more information about delegates.
+ "verificationStatus": "A String", # Indicates whether this address has been verified and can act as a delegate for the account. Read-only.
"delegateEmail": "A String", # The email address of the delegate.
- "verificationStatus": "A String", # Indicates whether this address has been verified and can act as a delegate
- # for the account. Read-only.
}</pre>
</div>
<div class="method">
<code class="details" id="delete">delete(userId, delegateEmail, x__xgafv=None)</code>
- <pre>Removes the specified delegate (which can be of any verification status),
-and revokes any verification that may have been required for using it.
-
-Note that a delegate user must be referred to by their primary email
-address, and not an email alias.
-
-This method is only available to service account clients that have been
-delegated domain-wide authority.
+ <pre>Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. Note that a delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.
Args:
- userId: string, User's email address. The special value "me"
-can be used to indicate the authenticated user. (required)
+ userId: string, User's email address. The special value "me" can be used to indicate the authenticated user. (required)
delegateEmail: string, The email address of the user to be removed as a delegate. (required)
x__xgafv: string, V1 error format.
Allowed values
@@ -165,19 +139,11 @@
<div class="method">
<code class="details" id="get">get(userId, delegateEmail, x__xgafv=None)</code>
- <pre>Gets the specified delegate.
-
-Note that a delegate user must be referred to by their primary email
-address, and not an email alias.
-
-This method is only available to service account clients that have been
-delegated domain-wide authority.
+ <pre>Gets the specified delegate. Note that a delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.
Args:
- userId: string, User's email address. The special value "me"
-can be used to indicate the authenticated user. (required)
- delegateEmail: string, The email address of the user whose delegate relationship is to be
-retrieved. (required)
+ userId: string, User's email address. The special value "me" can be used to indicate the authenticated user. (required)
+ delegateEmail: string, The email address of the user whose delegate relationship is to be retrieved. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -186,26 +152,18 @@
Returns:
An object of the form:
- { # Settings for a delegate. Delegates can read, send, and delete messages, as
- # well as view and add contacts, for the delegator's account. See
- # <a href="https://support.google.com/mail/answer/138350">"Set up
- # mail delegation"</a> for more information about delegates.
+ { # Settings for a delegate. Delegates can read, send, and delete messages, as well as view and add contacts, for the delegator's account. See "Set up mail delegation" for more information about delegates.
+ "verificationStatus": "A String", # Indicates whether this address has been verified and can act as a delegate for the account. Read-only.
"delegateEmail": "A String", # The email address of the delegate.
- "verificationStatus": "A String", # Indicates whether this address has been verified and can act as a delegate
- # for the account. Read-only.
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(userId, x__xgafv=None)</code>
- <pre>Lists the delegates for the specified account.
-
-This method is only available to service account clients that have been
-delegated domain-wide authority.
+ <pre>Lists the delegates for the specified account. This method is only available to service account clients that have been delegated domain-wide authority.
Args:
- userId: string, User's email address. The special value "me"
-can be used to indicate the authenticated user. (required)
+ userId: string, User's email address. The special value "me" can be used to indicate the authenticated user. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -215,14 +173,10 @@
An object of the form:
{ # Response for the ListDelegates method.
- "delegates": [ # List of the user's delegates (with any verification status).
- { # Settings for a delegate. Delegates can read, send, and delete messages, as
- # well as view and add contacts, for the delegator's account. See
- # <a href="https://support.google.com/mail/answer/138350">"Set up
- # mail delegation"</a> for more information about delegates.
+ "delegates": [ # List of the user's delegates (with any verification status). If an account doesn't have delegates, this field doesn't appear.
+ { # Settings for a delegate. Delegates can read, send, and delete messages, as well as view and add contacts, for the delegator's account. See "Set up mail delegation" for more information about delegates.
+ "verificationStatus": "A String", # Indicates whether this address has been verified and can act as a delegate for the account. Read-only.
"delegateEmail": "A String", # The email address of the delegate.
- "verificationStatus": "A String", # Indicates whether this address has been verified and can act as a delegate
- # for the account. Read-only.
},
],
}</pre>