docs: update generated docs (#1053)
Updates for both discovery docs and epydoc API Documentation
Fixes: #1049
diff --git a/docs/dyn/vault_v1.matters.html b/docs/dyn/vault_v1.matters.html
index 01469e4..e409cd1 100644
--- a/docs/dyn/vault_v1.matters.html
+++ b/docs/dyn/vault_v1.matters.html
@@ -97,7 +97,7 @@
<p class="firstline">Closes the specified matter. Returns matter with updated state.</p>
<p class="toc_element">
<code><a href="#create">create(body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a new matter with the given name and description. The initial state</p>
+<p class="firstline">Creates a new matter with the given name and description. The initial state is open, and the owner is the method caller. Returns the created matter with default view.</p>
<p class="toc_element">
<code><a href="#delete">delete(matterId, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes the specified matter. Returns matter with updated state.</p>
@@ -105,7 +105,7 @@
<code><a href="#get">get(matterId, view=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets the specified matter.</p>
<p class="toc_element">
- <code><a href="#list">list(view=None, pageSize=None, pageToken=None, state=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(view=None, pageToken=None, pageSize=None, state=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists matters the user has access to.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -121,7 +121,7 @@
<p class="firstline">Undeletes the specified matter. Returns matter with updated state.</p>
<p class="toc_element">
<code><a href="#update">update(matterId, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates the specified matter.</p>
+<p class="firstline">Updates the specified matter. This updates only the name and description of the matter, identified by matter ID. Changes to any other fields are ignored. Returns the default view of the matter.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="addPermissions">addPermissions(matterId, body=None, x__xgafv=None)</code>
@@ -132,21 +132,13 @@
body: object, The request body.
The object takes the form of:
-{ # Add an account with the permission specified. The role cannot be owner.
- # If an account already has a role in the matter, it will be
- # overwritten.
- "sendEmails": True or False, # True to send notification email to the added account.
- # False to not send notification email.
- "ccMe": True or False, # Only relevant if send_emails is true.
- # True to CC requestor in the email message.
- # False to not CC requestor.
- "matterPermission": { # Currently each matter only has one owner, and all others are collaborators. # The MatterPermission to add.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
+{ # Add an account with the permission specified. The role cannot be owner. If an account already has a role in the matter, it will be overwritten.
+ "matterPermission": { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. # The MatterPermission to add.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
"role": "A String", # The user's role in this matter.
},
+ "sendEmails": True or False, # True to send notification email to the added account. False to not send notification email.
+ "ccMe": True or False, # Only relevant if send_emails is true. True to CC requestor in the email message. False to not CC requestor.
}
x__xgafv: string, V1 error format.
@@ -157,11 +149,8 @@
Returns:
An object of the form:
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
"role": "A String", # The user's role in this matter.
}</pre>
</div>
@@ -188,52 +177,40 @@
{ # Response to a CloseMatterRequest.
"matter": { # Represents a matter. # The updated matter, with state CLOSED.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- },
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+ },
}</pre>
</div>
<div class="method">
<code class="details" id="create">create(body=None, x__xgafv=None)</code>
- <pre>Creates a new matter with the given name and description. The initial state
-is open, and the owner is the method caller. Returns the created matter
-with default view.
+ <pre>Creates a new matter with the given name and description. The initial state is open, and the owner is the method caller. Returns the created matter with default view.
Args:
body: object, The request body.
The object takes the form of:
{ # Represents a matter.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- }
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+}
x__xgafv: string, V1 error format.
Allowed values
@@ -244,22 +221,17 @@
An object of the form:
{ # Represents a matter.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- }</pre>
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+ }</pre>
</div>
<div class="method">
@@ -277,22 +249,17 @@
An object of the form:
{ # Represents a matter.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- }</pre>
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+ }</pre>
</div>
<div class="method">
@@ -302,6 +269,10 @@
Args:
matterId: string, The matter ID. (required)
view: string, Specifies which parts of the Matter to return in the response.
+ Allowed values
+ VIEW_UNSPECIFIED - There is no specified view.
+ BASIC - Response includes the matter_id, name, description, and state. Default choice.
+ FULL - Full representation of matter is returned. Everything above and including MatterPermissions list.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -311,35 +282,37 @@
An object of the form:
{ # Represents a matter.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- }</pre>
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+ }</pre>
</div>
<div class="method">
- <code class="details" id="list">list(view=None, pageSize=None, pageToken=None, state=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(view=None, pageToken=None, pageSize=None, state=None, x__xgafv=None)</code>
<pre>Lists matters the user has access to.
Args:
view: string, Specifies which parts of the matter to return in response.
- pageSize: integer, The number of matters to return in the response.
-Default and maximum are 100.
+ Allowed values
+ VIEW_UNSPECIFIED - There is no specified view.
+ BASIC - Response includes the matter_id, name, description, and state. Default choice.
+ FULL - Full representation of matter is returned. Everything above and including MatterPermissions list.
pageToken: string, The pagination token as returned in the response.
- state: string, If set, list only matters with that specific state. The default is listing
-matters of all states.
+ pageSize: integer, The number of matters to return in the response. Default and maximum are 100.
+ state: string, If set, list only matters with that specific state. The default is listing matters of all states.
+ Allowed values
+ STATE_UNSPECIFIED - The matter has no specified state.
+ OPEN - This matter is open.
+ CLOSED - This matter is closed.
+ DELETED - This matter is deleted.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -349,26 +322,21 @@
An object of the form:
{ # Provides the list of matters.
+ "nextPageToken": "A String", # Page token to retrieve the next page of results in the list.
"matters": [ # List of matters.
{ # Represents a matter.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- },
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+ },
],
- "nextPageToken": "A String", # Page token to retrieve the next page of results in the list.
}</pre>
</div>
@@ -407,15 +375,7 @@
Returns:
An object of the form:
- { # A generic empty message that you can re-use to avoid defining duplicated
- # empty messages in your APIs. A typical example is to use it as the request
- # or the response type of an API method. For instance:
- #
- # service Foo {
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
- # }
- #
- # The JSON representation for `Empty` is empty JSON object `{}`.
+ { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
}</pre>
</div>
@@ -441,22 +401,17 @@
{ # Response to a ReopenMatterRequest.
"matter": { # Represents a matter. # The updated matter, with state OPEN.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- },
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+ },
}</pre>
</div>
@@ -481,30 +436,22 @@
An object of the form:
{ # Represents a matter.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- }</pre>
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+ }</pre>
</div>
<div class="method">
<code class="details" id="update">update(matterId, body=None, x__xgafv=None)</code>
- <pre>Updates the specified matter.
-This updates only the name and description of the matter, identified by
-matter ID. Changes to any other fields are ignored.
-Returns the default view of the matter.
+ <pre>Updates the specified matter. This updates only the name and description of the matter, identified by matter ID. Changes to any other fields are ignored. Returns the default view of the matter.
Args:
matterId: string, The matter ID. (required)
@@ -512,22 +459,17 @@
The object takes the form of:
{ # Represents a matter.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- }
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+}
x__xgafv: string, V1 error format.
Allowed values
@@ -538,22 +480,17 @@
An object of the form:
{ # Represents a matter.
- "name": "A String", # The name of the matter.
- "description": "A String", # The description of the matter.
- "matterId": "A String", # The matter ID which is generated by the server.
- # Should be blank when creating a new matter.
- "state": "A String", # The state of the matter.
- "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer
- # defined limit on the number of permissions a matter can have.
- { # Currently each matter only has one owner, and all others are collaborators.
- # When an account is purged, its corresponding MatterPermission resources
- # cease to exist.
- "accountId": "A String", # The account ID, as provided by <a
- # href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "role": "A String", # The user's role in this matter.
- },
- ],
- }</pre>
+ "description": "A String", # The description of the matter.
+ "matterPermissions": [ # List of users and access to the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
+ { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.
+ "accountId": "A String", # The account ID, as provided by Admin SDK.
+ "role": "A String", # The user's role in this matter.
+ },
+ ],
+ "name": "A String", # The name of the matter.
+ "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter.
+ "state": "A String", # The state of the matter.
+ }</pre>
</div>
</body></html>
\ No newline at end of file