| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 1 | <html><body> |
| 2 | <style> |
| 3 | |
| 4 | body, h1, h2, h3, div, span, p, pre, a { |
| 5 | margin: 0; |
| 6 | padding: 0; |
| 7 | border: 0; |
| 8 | font-weight: inherit; |
| 9 | font-style: inherit; |
| 10 | font-size: 100%; |
| 11 | font-family: inherit; |
| 12 | vertical-align: baseline; |
| 13 | } |
| 14 | |
| 15 | body { |
| 16 | font-size: 13px; |
| 17 | padding: 1em; |
| 18 | } |
| 19 | |
| 20 | h1 { |
| 21 | font-size: 26px; |
| 22 | margin-bottom: 1em; |
| 23 | } |
| 24 | |
| 25 | h2 { |
| 26 | font-size: 24px; |
| 27 | margin-bottom: 1em; |
| 28 | } |
| 29 | |
| 30 | h3 { |
| 31 | font-size: 20px; |
| 32 | margin-bottom: 1em; |
| 33 | margin-top: 1em; |
| 34 | } |
| 35 | |
| 36 | pre, code { |
| 37 | line-height: 1.5; |
| 38 | font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| 39 | } |
| 40 | |
| 41 | pre { |
| 42 | margin-top: 0.5em; |
| 43 | } |
| 44 | |
| 45 | h1, h2, h3, p { |
| 46 | font-family: Arial, sans serif; |
| 47 | } |
| 48 | |
| 49 | h1, h2, h3 { |
| 50 | border-bottom: solid #CCC 1px; |
| 51 | } |
| 52 | |
| 53 | .toc_element { |
| 54 | margin-top: 0.5em; |
| 55 | } |
| 56 | |
| 57 | .firstline { |
| 58 | margin-left: 2 em; |
| 59 | } |
| 60 | |
| 61 | .method { |
| 62 | margin-top: 1em; |
| 63 | border: solid 1px #CCC; |
| 64 | padding: 1em; |
| 65 | background: #EEE; |
| 66 | } |
| 67 | |
| 68 | .details { |
| 69 | font-weight: bold; |
| 70 | font-size: 14px; |
| 71 | } |
| 72 | |
| 73 | </style> |
| 74 | |
| 75 | <h1><a href="vault_v1.html">G Suite Vault API</a> . <a href="vault_v1.matters.html">matters</a></h1> |
| 76 | <h2>Instance Methods</h2> |
| 77 | <p class="toc_element"> |
| 78 | <code><a href="vault_v1.matters.exports.html">exports()</a></code> |
| 79 | </p> |
| 80 | <p class="firstline">Returns the exports Resource.</p> |
| 81 | |
| 82 | <p class="toc_element"> |
| 83 | <code><a href="vault_v1.matters.holds.html">holds()</a></code> |
| 84 | </p> |
| 85 | <p class="firstline">Returns the holds Resource.</p> |
| 86 | |
| 87 | <p class="toc_element"> |
| 88 | <code><a href="vault_v1.matters.savedQueries.html">savedQueries()</a></code> |
| 89 | </p> |
| 90 | <p class="firstline">Returns the savedQueries Resource.</p> |
| 91 | |
| 92 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 93 | <code><a href="#addPermissions">addPermissions(matterId, body=None, x__xgafv=None)</a></code></p> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 94 | <p class="firstline">Adds an account as a matter collaborator.</p> |
| 95 | <p class="toc_element"> |
| 96 | <code><a href="#close">close(matterId, body=None, x__xgafv=None)</a></code></p> |
| 97 | <p class="firstline">Closes the specified matter. Returns matter with updated state.</p> |
| 98 | <p class="toc_element"> |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 99 | <code><a href="#count">count(matterId, body=None, x__xgafv=None)</a></code></p> |
| 100 | <p class="firstline">Counts the artifacts within the context of a matter and returns a detailed breakdown of metrics.</p> |
| 101 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 102 | <code><a href="#create">create(body=None, x__xgafv=None)</a></code></p> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 103 | <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> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 104 | <p class="toc_element"> |
| 105 | <code><a href="#delete">delete(matterId, x__xgafv=None)</a></code></p> |
| 106 | <p class="firstline">Deletes the specified matter. Returns matter with updated state.</p> |
| 107 | <p class="toc_element"> |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 108 | <code><a href="#get">get(matterId, view=None, x__xgafv=None)</a></code></p> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 109 | <p class="firstline">Gets the specified matter.</p> |
| 110 | <p class="toc_element"> |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 111 | <code><a href="#list">list(pageSize=None, view=None, state=None, pageToken=None, x__xgafv=None)</a></code></p> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 112 | <p class="firstline">Lists matters the user has access to.</p> |
| 113 | <p class="toc_element"> |
| 114 | <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> |
| 115 | <p class="firstline">Retrieves the next page of results.</p> |
| 116 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 117 | <code><a href="#removePermissions">removePermissions(matterId, body=None, x__xgafv=None)</a></code></p> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 118 | <p class="firstline">Removes an account as a matter collaborator.</p> |
| 119 | <p class="toc_element"> |
| 120 | <code><a href="#reopen">reopen(matterId, body=None, x__xgafv=None)</a></code></p> |
| 121 | <p class="firstline">Reopens the specified matter. Returns matter with updated state.</p> |
| 122 | <p class="toc_element"> |
| 123 | <code><a href="#undelete">undelete(matterId, body=None, x__xgafv=None)</a></code></p> |
| 124 | <p class="firstline">Undeletes the specified matter. Returns matter with updated state.</p> |
| 125 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 126 | <code><a href="#update">update(matterId, body=None, x__xgafv=None)</a></code></p> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 127 | <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> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 128 | <h3>Method Details</h3> |
| 129 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 130 | <code class="details" id="addPermissions">addPermissions(matterId, body=None, x__xgafv=None)</code> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 131 | <pre>Adds an account as a matter collaborator. |
| 132 | |
| 133 | Args: |
| 134 | matterId: string, The matter ID. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 135 | body: object, The request body. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 136 | The object takes the form of: |
| 137 | |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 138 | { # 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. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 139 | "sendEmails": True or False, # True to send notification email to the added account. False to not send notification email. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 140 | "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. |
| 141 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 142 | "role": "A String", # The user's role in this matter. |
| 143 | }, |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 144 | "ccMe": True or False, # Only relevant if send_emails is true. True to CC requestor in the email message. False to not CC requestor. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 145 | } |
| 146 | |
| 147 | x__xgafv: string, V1 error format. |
| 148 | Allowed values |
| 149 | 1 - v1 error format |
| 150 | 2 - v2 error format |
| 151 | |
| 152 | Returns: |
| 153 | An object of the form: |
| 154 | |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 155 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 156 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 157 | "role": "A String", # The user's role in this matter. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 158 | }</pre> |
| 159 | </div> |
| 160 | |
| 161 | <div class="method"> |
| 162 | <code class="details" id="close">close(matterId, body=None, x__xgafv=None)</code> |
| 163 | <pre>Closes the specified matter. Returns matter with updated state. |
| 164 | |
| 165 | Args: |
| 166 | matterId: string, The matter ID. (required) |
| 167 | body: object, The request body. |
| 168 | The object takes the form of: |
| 169 | |
| 170 | { # Close a matter by ID. |
| 171 | } |
| 172 | |
| 173 | x__xgafv: string, V1 error format. |
| 174 | Allowed values |
| 175 | 1 - v1 error format |
| 176 | 2 - v2 error format |
| 177 | |
| 178 | Returns: |
| 179 | An object of the form: |
| 180 | |
| 181 | { # Response to a CloseMatterRequest. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 182 | "matter": { # Represents a matter. # The updated matter, with state CLOSED. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 183 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 184 | "description": "A String", # The description of the matter. |
| 185 | "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. |
| 186 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 187 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 188 | "role": "A String", # The user's role in this matter. |
| 189 | }, |
| 190 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 191 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 192 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 193 | }, |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 194 | }</pre> |
| 195 | </div> |
| 196 | |
| 197 | <div class="method"> |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 198 | <code class="details" id="count">count(matterId, body=None, x__xgafv=None)</code> |
| 199 | <pre>Counts the artifacts within the context of a matter and returns a detailed breakdown of metrics. |
| 200 | |
| 201 | Args: |
| 202 | matterId: string, The matter ID. (required) |
| 203 | body: object, The request body. |
| 204 | The object takes the form of: |
| 205 | |
| 206 | { # Count artifacts request. |
| 207 | "view": "A String", # Specifies the granularity of the count result returned in response. |
| 208 | "query": { # A query definition relevant for search & export. # The search query. |
| 209 | "dataScope": "A String", # The data source to search from. |
| 210 | "timeZone": "A String", # The time zone name. It should be an IANA TZ name, such as "America/Los_Angeles". For more information, see Time Zone. |
| 211 | "driveOptions": { # Drive search advanced options # For Drive search, specify more options in this field. |
| 212 | "includeSharedDrives": True or False, # Set to true to include shared drive. |
| 213 | "versionDate": "A String", # Search the versions of the Drive file as of the reference date. These timestamps are in GMT and rounded down to the given date. |
| 214 | "includeTeamDrives": True or False, # Set to true to include Team Drive. |
| 215 | }, |
| 216 | "hangoutsChatInfo": { # Accounts to search # When 'ROOM' is chosen as search method, hangout_chats_info needs to be specified. (read-only) |
| 217 | "roomId": [ # A set of rooms to search. |
| 218 | "A String", |
| 219 | ], |
| 220 | }, |
| 221 | "hangoutsChatOptions": { # Hangouts chat search advanced options # For hangouts chat search, specify more options in this field. (read-only) |
| 222 | "includeRooms": True or False, # Set to true to include rooms. |
| 223 | }, |
| 224 | "teamDriveInfo": { # Team Drives to search # When 'TEAM_DRIVE' is chosen as search method, team_drive_info needs to be specified. |
| 225 | "teamDriveIds": [ # List of Team Drive IDs, as provided by Drive API. |
| 226 | "A String", |
| 227 | ], |
| 228 | }, |
| 229 | "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date. |
| 230 | "searchMethod": "A String", # The search method to use. |
| 231 | "terms": "A String", # The corpus-specific search operators used to generate search results. |
| 232 | "accountInfo": { # Accounts to search # When 'ACCOUNT' is chosen as search method, account_info needs to be specified. |
| 233 | "emails": [ # A set of accounts to search. |
| 234 | "A String", |
| 235 | ], |
| 236 | }, |
| 237 | "orgUnitInfo": { # Org Unit to search # When 'ORG_UNIT' is chosen as as search method, org_unit_info needs to be specified. |
| 238 | "orgUnitId": "A String", # Org unit to search, as provided by the Admin SDK Directory API. |
| 239 | }, |
| 240 | "corpus": "A String", # The corpus to search. |
| 241 | "mailOptions": { # Mail search advanced options # For mail search, specify more options in this field. |
| 242 | "excludeDrafts": True or False, # Set to true to exclude drafts. |
| 243 | }, |
| 244 | "method": "A String", # The search method to use. This field is similar to the search_method field but is introduced to support shared drives. It supports all search method types. In case the search_method is TEAM_DRIVE the response of this field will be SHARED_DRIVE only. |
| 245 | "sharedDriveInfo": { # Shared drives to search # When 'SHARED_DRIVE' is chosen as search method, shared_drive_info needs to be specified. |
| 246 | "sharedDriveIds": [ # List of Shared drive IDs, as provided by Drive API. |
| 247 | "A String", |
| 248 | ], |
| 249 | }, |
| 250 | "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date. |
| 251 | }, |
| 252 | } |
| 253 | |
| 254 | x__xgafv: string, V1 error format. |
| 255 | Allowed values |
| 256 | 1 - v1 error format |
| 257 | 2 - v2 error format |
| 258 | |
| 259 | Returns: |
| 260 | An object of the form: |
| 261 | |
| 262 | { # This resource represents a long-running operation that is the result of a network API call. |
| 263 | "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any. |
| 264 | "a_key": "", # Properties of the object. Contains field @type with type URL. |
| 265 | }, |
| 266 | "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation. |
| 267 | "code": 42, # The status code, which should be an enum value of google.rpc.Code. |
| 268 | "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. |
| 269 | "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use. |
| 270 | { |
| 271 | "a_key": "", # Properties of the object. Contains field @type with type URL. |
| 272 | }, |
| 273 | ], |
| 274 | }, |
| 275 | "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. |
| 276 | "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. |
| 277 | "a_key": "", # Properties of the object. Contains field @type with type URL. |
| 278 | }, |
| 279 | "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`. |
| 280 | }</pre> |
| 281 | </div> |
| 282 | |
| 283 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 284 | <code class="details" id="create">create(body=None, x__xgafv=None)</code> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 285 | <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. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 286 | |
| 287 | Args: |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 288 | body: object, The request body. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 289 | The object takes the form of: |
| 290 | |
| 291 | { # Represents a matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 292 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 293 | "description": "A String", # The description of the matter. |
| 294 | "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. |
| 295 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 296 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 297 | "role": "A String", # The user's role in this matter. |
| 298 | }, |
| 299 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 300 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 301 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 302 | } |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 303 | |
| 304 | x__xgafv: string, V1 error format. |
| 305 | Allowed values |
| 306 | 1 - v1 error format |
| 307 | 2 - v2 error format |
| 308 | |
| 309 | Returns: |
| 310 | An object of the form: |
| 311 | |
| 312 | { # Represents a matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 313 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 314 | "description": "A String", # The description of the matter. |
| 315 | "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. |
| 316 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 317 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 318 | "role": "A String", # The user's role in this matter. |
| 319 | }, |
| 320 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 321 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 322 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 323 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 324 | </div> |
| 325 | |
| 326 | <div class="method"> |
| 327 | <code class="details" id="delete">delete(matterId, x__xgafv=None)</code> |
| 328 | <pre>Deletes the specified matter. Returns matter with updated state. |
| 329 | |
| 330 | Args: |
| 331 | matterId: string, The matter ID (required) |
| 332 | x__xgafv: string, V1 error format. |
| 333 | Allowed values |
| 334 | 1 - v1 error format |
| 335 | 2 - v2 error format |
| 336 | |
| 337 | Returns: |
| 338 | An object of the form: |
| 339 | |
| 340 | { # Represents a matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 341 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 342 | "description": "A String", # The description of the matter. |
| 343 | "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. |
| 344 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 345 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 346 | "role": "A String", # The user's role in this matter. |
| 347 | }, |
| 348 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 349 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 350 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 351 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 352 | </div> |
| 353 | |
| 354 | <div class="method"> |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 355 | <code class="details" id="get">get(matterId, view=None, x__xgafv=None)</code> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 356 | <pre>Gets the specified matter. |
| 357 | |
| 358 | Args: |
| 359 | matterId: string, The matter ID. (required) |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 360 | view: string, Specifies which parts of the Matter to return in the response. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 361 | Allowed values |
| 362 | VIEW_UNSPECIFIED - There is no specified view. |
| 363 | BASIC - Response includes the matter_id, name, description, and state. Default choice. |
| 364 | FULL - Full representation of matter is returned. Everything above and including MatterPermissions list. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 365 | x__xgafv: string, V1 error format. |
| 366 | Allowed values |
| 367 | 1 - v1 error format |
| 368 | 2 - v2 error format |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 369 | |
| 370 | Returns: |
| 371 | An object of the form: |
| 372 | |
| 373 | { # Represents a matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 374 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 375 | "description": "A String", # The description of the matter. |
| 376 | "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. |
| 377 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 378 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 379 | "role": "A String", # The user's role in this matter. |
| 380 | }, |
| 381 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 382 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 383 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 384 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 385 | </div> |
| 386 | |
| 387 | <div class="method"> |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 388 | <code class="details" id="list">list(pageSize=None, view=None, state=None, pageToken=None, x__xgafv=None)</code> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 389 | <pre>Lists matters the user has access to. |
| 390 | |
| 391 | Args: |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 392 | pageSize: integer, The number of matters to return in the response. Default and maximum are 100. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 393 | view: string, Specifies which parts of the matter to return in response. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 394 | Allowed values |
| 395 | VIEW_UNSPECIFIED - There is no specified view. |
| 396 | BASIC - Response includes the matter_id, name, description, and state. Default choice. |
| 397 | FULL - Full representation of matter is returned. Everything above and including MatterPermissions list. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 398 | state: string, If set, list only matters with that specific state. The default is listing matters of all states. |
| 399 | Allowed values |
| 400 | STATE_UNSPECIFIED - The matter has no specified state. |
| 401 | OPEN - This matter is open. |
| 402 | CLOSED - This matter is closed. |
| 403 | DELETED - This matter is deleted. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 404 | pageToken: string, The pagination token as returned in the response. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 405 | x__xgafv: string, V1 error format. |
| 406 | Allowed values |
| 407 | 1 - v1 error format |
| 408 | 2 - v2 error format |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 409 | |
| 410 | Returns: |
| 411 | An object of the form: |
| 412 | |
| 413 | { # Provides the list of matters. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 414 | "nextPageToken": "A String", # Page token to retrieve the next page of results in the list. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 415 | "matters": [ # List of matters. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 416 | { # Represents a matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 417 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 418 | "description": "A String", # The description of the matter. |
| 419 | "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. |
| 420 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 421 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 422 | "role": "A String", # The user's role in this matter. |
| 423 | }, |
| 424 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 425 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 426 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 427 | }, |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 428 | ], |
| 429 | }</pre> |
| 430 | </div> |
| 431 | |
| 432 | <div class="method"> |
| 433 | <code class="details" id="list_next">list_next(previous_request, previous_response)</code> |
| 434 | <pre>Retrieves the next page of results. |
| 435 | |
| 436 | Args: |
| 437 | previous_request: The request for the previous page. (required) |
| 438 | previous_response: The response from the request for the previous page. (required) |
| 439 | |
| 440 | Returns: |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 441 | A request object that you can call 'execute()' on to request the next |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 442 | page. Returns None if there are no more items in the collection. |
| 443 | </pre> |
| 444 | </div> |
| 445 | |
| 446 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 447 | <code class="details" id="removePermissions">removePermissions(matterId, body=None, x__xgafv=None)</code> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 448 | <pre>Removes an account as a matter collaborator. |
| 449 | |
| 450 | Args: |
| 451 | matterId: string, The matter ID. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 452 | body: object, The request body. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 453 | The object takes the form of: |
| 454 | |
| 455 | { # Remove an account as a matter collaborator. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 456 | "accountId": "A String", # The account ID. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 457 | } |
| 458 | |
| 459 | x__xgafv: string, V1 error format. |
| 460 | Allowed values |
| 461 | 1 - v1 error format |
| 462 | 2 - v2 error format |
| 463 | |
| 464 | Returns: |
| 465 | An object of the form: |
| 466 | |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 467 | { # 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 `{}`. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 468 | }</pre> |
| 469 | </div> |
| 470 | |
| 471 | <div class="method"> |
| 472 | <code class="details" id="reopen">reopen(matterId, body=None, x__xgafv=None)</code> |
| 473 | <pre>Reopens the specified matter. Returns matter with updated state. |
| 474 | |
| 475 | Args: |
| 476 | matterId: string, The matter ID. (required) |
| 477 | body: object, The request body. |
| 478 | The object takes the form of: |
| 479 | |
| 480 | { # Reopen a matter by ID. |
| 481 | } |
| 482 | |
| 483 | x__xgafv: string, V1 error format. |
| 484 | Allowed values |
| 485 | 1 - v1 error format |
| 486 | 2 - v2 error format |
| 487 | |
| 488 | Returns: |
| 489 | An object of the form: |
| 490 | |
| 491 | { # Response to a ReopenMatterRequest. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 492 | "matter": { # Represents a matter. # The updated matter, with state OPEN. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 493 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 494 | "description": "A String", # The description of the matter. |
| 495 | "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. |
| 496 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 497 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 498 | "role": "A String", # The user's role in this matter. |
| 499 | }, |
| 500 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 501 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 502 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 503 | }, |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 504 | }</pre> |
| 505 | </div> |
| 506 | |
| 507 | <div class="method"> |
| 508 | <code class="details" id="undelete">undelete(matterId, body=None, x__xgafv=None)</code> |
| 509 | <pre>Undeletes the specified matter. Returns matter with updated state. |
| 510 | |
| 511 | Args: |
| 512 | matterId: string, The matter ID. (required) |
| 513 | body: object, The request body. |
| 514 | The object takes the form of: |
| 515 | |
| 516 | { # Undelete a matter by ID. |
| 517 | } |
| 518 | |
| 519 | x__xgafv: string, V1 error format. |
| 520 | Allowed values |
| 521 | 1 - v1 error format |
| 522 | 2 - v2 error format |
| 523 | |
| 524 | Returns: |
| 525 | An object of the form: |
| 526 | |
| 527 | { # Represents a matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 528 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 529 | "description": "A String", # The description of the matter. |
| 530 | "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. |
| 531 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 532 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 533 | "role": "A String", # The user's role in this matter. |
| 534 | }, |
| 535 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 536 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 537 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 538 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 539 | </div> |
| 540 | |
| 541 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 542 | <code class="details" id="update">update(matterId, body=None, x__xgafv=None)</code> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 543 | <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. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 544 | |
| 545 | Args: |
| 546 | matterId: string, The matter ID. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 547 | body: object, The request body. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 548 | The object takes the form of: |
| 549 | |
| 550 | { # Represents a matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 551 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 552 | "description": "A String", # The description of the matter. |
| 553 | "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. |
| 554 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 555 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 556 | "role": "A String", # The user's role in this matter. |
| 557 | }, |
| 558 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 559 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 560 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 561 | } |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 562 | |
| 563 | x__xgafv: string, V1 error format. |
| 564 | Allowed values |
| 565 | 1 - v1 error format |
| 566 | 2 - v2 error format |
| 567 | |
| 568 | Returns: |
| 569 | An object of the form: |
| 570 | |
| 571 | { # Represents a matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 572 | "name": "A String", # The name of the matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 573 | "description": "A String", # The description of the matter. |
| 574 | "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. |
| 575 | { # Currently each matter only has one owner, and all others are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist. |
| 576 | "accountId": "A String", # The account ID, as provided by Admin SDK. |
| 577 | "role": "A String", # The user's role in this matter. |
| 578 | }, |
| 579 | ], |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 580 | "state": "A String", # The state of the matter. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 581 | "matterId": "A String", # The matter ID which is generated by the server. Should be blank when creating a new matter. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 582 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 583 | </div> |
| 584 | |
| 585 | </body></html> |