1<html><body> 2<style> 3 4body, 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 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, 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="cloudsupport_v2beta.html">Google Cloud Support API</a> . <a href="cloudsupport_v2beta.cases.html">cases</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="cloudsupport_v2beta.cases.attachments.html">attachments()</a></code> 79</p> 80<p class="firstline">Returns the attachments Resource.</p> 81 82<p class="toc_element"> 83 <code><a href="cloudsupport_v2beta.cases.comments.html">comments()</a></code> 84</p> 85<p class="firstline">Returns the comments Resource.</p> 86 87<p class="toc_element"> 88 <code><a href="#close">close(name, body=None, x__xgafv=None)</a></code></p> 89<p class="firstline">Close the specified case.</p> 90<p class="toc_element"> 91 <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p> 92<p class="firstline">Create a new case and associate it with the given Cloud resource.</p> 93<p class="toc_element"> 94 <code><a href="#escalate">escalate(name, body=None, x__xgafv=None)</a></code></p> 95<p class="firstline">Escalate a case. Escalating a case will initiate the Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations.</p> 96<p class="toc_element"> 97 <code><a href="#get">get(name, x__xgafv=None)</a></code></p> 98<p class="firstline">Retrieve the specified case.</p> 99<p class="toc_element"> 100 <code><a href="#list">list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p> 101<p class="firstline">Retrieve all cases under the specified parent.</p> 102<p class="toc_element"> 103 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 104<p class="firstline">Retrieves the next page of results.</p> 105<p class="toc_element"> 106 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p> 107<p class="firstline">Update the specified case. Only a subset of fields (display_name, description, time_zone, subscriber_email_addresses, related_resources, severity, primary_contact, and labels) can be updated.</p> 108<p class="toc_element"> 109 <code><a href="#search">search(pageSize=None, pageToken=None, query=None, x__xgafv=None)</a></code></p> 110<p class="firstline">Search cases using the specified query.</p> 111<p class="toc_element"> 112 <code><a href="#search_next">search_next(previous_request, previous_response)</a></code></p> 113<p class="firstline">Retrieves the next page of results.</p> 114<h3>Method Details</h3> 115<div class="method"> 116 <code class="details" id="close">close(name, body=None, x__xgafv=None)</code> 117 <pre>Close the specified case. 118 119Args: 120 name: string, Required. The fully qualified name of the case resource to be closed. (required) 121 body: object, The request body. 122 The object takes the form of: 123 124{ # The request message for the CloseCase endpoint. 125} 126 127 x__xgafv: string, V1 error format. 128 Allowed values 129 1 - v1 error format 130 2 - v2 error format 131 132Returns: 133 An object of the form: 134 135 { # A support case. 136 "classification": { # A classification object with a product type and value. # The issue classification applicable to this case. 137 "displayName": "A String", # The display name of the classification. 138 "id": "A String", # The unique ID for a classification. Must be specified for case creation. 139 }, 140 "createTime": "A String", # Output only. The time this case was created. 141 "creator": { # An object containing information about the effective user and authenticated principal responsible for an action. # The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. 142 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 143 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 144 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 145 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 146 }, 147 "description": "A String", # A broad description of the issue. 148 "displayName": "A String", # The short summary of the issue reported in this case. 149 "escalated": True or False, # Whether the case is currently escalated. 150 "name": "A String", # The resource name for the case. 151 "severity": "A String", # The severity of this case. 152 "state": "A String", # Output only. The current status of the support case. 153 "subscriberEmailAddresses": [ # The email addresses to receive updates on this case. 154 "A String", 155 ], 156 "testCase": True or False, # Whether this case was created for internal API testing and should not be acted on by the support team. 157 "timeZone": "A String", # The timezone of the user who created the support case. It should be in a format IANA recognizes: https://www.iana.org/time-zones. There is no additional validation done by the API. 158 "updateTime": "A String", # Output only. The time this case was last updated. 159}</pre> 160</div> 161 162<div class="method"> 163 <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code> 164 <pre>Create a new case and associate it with the given Cloud resource. 165 166Args: 167 parent: string, Required. The name of the Cloud resource under which the case should be created. (required) 168 body: object, The request body. 169 The object takes the form of: 170 171{ # A support case. 172 "classification": { # A classification object with a product type and value. # The issue classification applicable to this case. 173 "displayName": "A String", # The display name of the classification. 174 "id": "A String", # The unique ID for a classification. Must be specified for case creation. 175 }, 176 "createTime": "A String", # Output only. The time this case was created. 177 "creator": { # An object containing information about the effective user and authenticated principal responsible for an action. # The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. 178 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 179 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 180 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 181 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 182 }, 183 "description": "A String", # A broad description of the issue. 184 "displayName": "A String", # The short summary of the issue reported in this case. 185 "escalated": True or False, # Whether the case is currently escalated. 186 "name": "A String", # The resource name for the case. 187 "severity": "A String", # The severity of this case. 188 "state": "A String", # Output only. The current status of the support case. 189 "subscriberEmailAddresses": [ # The email addresses to receive updates on this case. 190 "A String", 191 ], 192 "testCase": True or False, # Whether this case was created for internal API testing and should not be acted on by the support team. 193 "timeZone": "A String", # The timezone of the user who created the support case. It should be in a format IANA recognizes: https://www.iana.org/time-zones. There is no additional validation done by the API. 194 "updateTime": "A String", # Output only. The time this case was last updated. 195} 196 197 x__xgafv: string, V1 error format. 198 Allowed values 199 1 - v1 error format 200 2 - v2 error format 201 202Returns: 203 An object of the form: 204 205 { # A support case. 206 "classification": { # A classification object with a product type and value. # The issue classification applicable to this case. 207 "displayName": "A String", # The display name of the classification. 208 "id": "A String", # The unique ID for a classification. Must be specified for case creation. 209 }, 210 "createTime": "A String", # Output only. The time this case was created. 211 "creator": { # An object containing information about the effective user and authenticated principal responsible for an action. # The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. 212 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 213 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 214 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 215 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 216 }, 217 "description": "A String", # A broad description of the issue. 218 "displayName": "A String", # The short summary of the issue reported in this case. 219 "escalated": True or False, # Whether the case is currently escalated. 220 "name": "A String", # The resource name for the case. 221 "severity": "A String", # The severity of this case. 222 "state": "A String", # Output only. The current status of the support case. 223 "subscriberEmailAddresses": [ # The email addresses to receive updates on this case. 224 "A String", 225 ], 226 "testCase": True or False, # Whether this case was created for internal API testing and should not be acted on by the support team. 227 "timeZone": "A String", # The timezone of the user who created the support case. It should be in a format IANA recognizes: https://www.iana.org/time-zones. There is no additional validation done by the API. 228 "updateTime": "A String", # Output only. The time this case was last updated. 229}</pre> 230</div> 231 232<div class="method"> 233 <code class="details" id="escalate">escalate(name, body=None, x__xgafv=None)</code> 234 <pre>Escalate a case. Escalating a case will initiate the Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations. 235 236Args: 237 name: string, Required. The fully qualified name of the Case resource to be escalated. (required) 238 body: object, The request body. 239 The object takes the form of: 240 241{ # The request message for the EscalateCase endpoint. 242 "escalation": { # An escalation of a support case. # The escalation object to be sent with the escalation request. 243 "actor": { # An object containing information about the effective user and authenticated principal responsible for an action. # Output only. The user or Google Support agent initiated this escalation. 244 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 245 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 246 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 247 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 248 }, 249 "createTime": "A String", # Output only. The time when this escalation event was created. 250 "justification": "A String", # Required. A free text description to accompany the `reason` field above. Provides additional context on why the case is being escalated. 251 "name": "A String", # Output only. The resource name for the escalation event. 252 "reason": "A String", # Required. The reason why the Case is being escalated. 253 }, 254} 255 256 x__xgafv: string, V1 error format. 257 Allowed values 258 1 - v1 error format 259 2 - v2 error format 260 261Returns: 262 An object of the form: 263 264 { # A support case. 265 "classification": { # A classification object with a product type and value. # The issue classification applicable to this case. 266 "displayName": "A String", # The display name of the classification. 267 "id": "A String", # The unique ID for a classification. Must be specified for case creation. 268 }, 269 "createTime": "A String", # Output only. The time this case was created. 270 "creator": { # An object containing information about the effective user and authenticated principal responsible for an action. # The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. 271 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 272 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 273 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 274 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 275 }, 276 "description": "A String", # A broad description of the issue. 277 "displayName": "A String", # The short summary of the issue reported in this case. 278 "escalated": True or False, # Whether the case is currently escalated. 279 "name": "A String", # The resource name for the case. 280 "severity": "A String", # The severity of this case. 281 "state": "A String", # Output only. The current status of the support case. 282 "subscriberEmailAddresses": [ # The email addresses to receive updates on this case. 283 "A String", 284 ], 285 "testCase": True or False, # Whether this case was created for internal API testing and should not be acted on by the support team. 286 "timeZone": "A String", # The timezone of the user who created the support case. It should be in a format IANA recognizes: https://www.iana.org/time-zones. There is no additional validation done by the API. 287 "updateTime": "A String", # Output only. The time this case was last updated. 288}</pre> 289</div> 290 291<div class="method"> 292 <code class="details" id="get">get(name, x__xgafv=None)</code> 293 <pre>Retrieve the specified case. 294 295Args: 296 name: string, Required. The fully qualified name of a case to be retrieved. (required) 297 x__xgafv: string, V1 error format. 298 Allowed values 299 1 - v1 error format 300 2 - v2 error format 301 302Returns: 303 An object of the form: 304 305 { # A support case. 306 "classification": { # A classification object with a product type and value. # The issue classification applicable to this case. 307 "displayName": "A String", # The display name of the classification. 308 "id": "A String", # The unique ID for a classification. Must be specified for case creation. 309 }, 310 "createTime": "A String", # Output only. The time this case was created. 311 "creator": { # An object containing information about the effective user and authenticated principal responsible for an action. # The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. 312 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 313 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 314 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 315 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 316 }, 317 "description": "A String", # A broad description of the issue. 318 "displayName": "A String", # The short summary of the issue reported in this case. 319 "escalated": True or False, # Whether the case is currently escalated. 320 "name": "A String", # The resource name for the case. 321 "severity": "A String", # The severity of this case. 322 "state": "A String", # Output only. The current status of the support case. 323 "subscriberEmailAddresses": [ # The email addresses to receive updates on this case. 324 "A String", 325 ], 326 "testCase": True or False, # Whether this case was created for internal API testing and should not be acted on by the support team. 327 "timeZone": "A String", # The timezone of the user who created the support case. It should be in a format IANA recognizes: https://www.iana.org/time-zones. There is no additional validation done by the API. 328 "updateTime": "A String", # Output only. The time this case was last updated. 329}</pre> 330</div> 331 332<div class="method"> 333 <code class="details" id="list">list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</code> 334 <pre>Retrieve all cases under the specified parent. 335 336Args: 337 parent: string, Required. The fully qualified name of parent resource to list cases under. (required) 338 filter: string, An expression written in the Cloud filter language. If non-empty, then only cases whose fields match the filter are returned. If empty, then no messages are filtered out. Filter strings can use the following fields: - status (Accepted values: OPEN or CLOSED) - severity (Accepted values: S0, S1, S2, S3, or S4) - creator.email with the operators equals (=) and AND. Additionally, a global restriction (with no operator) can be used to search across displayName, description, and comments (e.g. "my search"). 339 orderBy: string, A comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case-insensitive, default sorting order is ascending, redundant space characters are insignificant. Example: `name asc,update_time, create_time desc` 340 pageSize: integer, The maximum number of cases fetched with each request. Defaults to 10. 341 pageToken: string, A token identifying the page of results to return. If unspecified, the first page is retrieved. 342 x__xgafv: string, V1 error format. 343 Allowed values 344 1 - v1 error format 345 2 - v2 error format 346 347Returns: 348 An object of the form: 349 350 { # The response message for the ListCases endpoint. 351 "cases": [ # The list of cases associated with the cloud resource, after any filters have been applied. 352 { # A support case. 353 "classification": { # A classification object with a product type and value. # The issue classification applicable to this case. 354 "displayName": "A String", # The display name of the classification. 355 "id": "A String", # The unique ID for a classification. Must be specified for case creation. 356 }, 357 "createTime": "A String", # Output only. The time this case was created. 358 "creator": { # An object containing information about the effective user and authenticated principal responsible for an action. # The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. 359 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 360 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 361 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 362 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 363 }, 364 "description": "A String", # A broad description of the issue. 365 "displayName": "A String", # The short summary of the issue reported in this case. 366 "escalated": True or False, # Whether the case is currently escalated. 367 "name": "A String", # The resource name for the case. 368 "severity": "A String", # The severity of this case. 369 "state": "A String", # Output only. The current status of the support case. 370 "subscriberEmailAddresses": [ # The email addresses to receive updates on this case. 371 "A String", 372 ], 373 "testCase": True or False, # Whether this case was created for internal API testing and should not be acted on by the support team. 374 "timeZone": "A String", # The timezone of the user who created the support case. It should be in a format IANA recognizes: https://www.iana.org/time-zones. There is no additional validation done by the API. 375 "updateTime": "A String", # Output only. The time this case was last updated. 376 }, 377 ], 378 "nextPageToken": "A String", # A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `ListCasesRequest` message that is issued. If unspecified, there are no more results to retrieve. 379}</pre> 380</div> 381 382<div class="method"> 383 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 384 <pre>Retrieves the next page of results. 385 386Args: 387 previous_request: The request for the previous page. (required) 388 previous_response: The response from the request for the previous page. (required) 389 390Returns: 391 A request object that you can call 'execute()' on to request the next 392 page. Returns None if there are no more items in the collection. 393 </pre> 394</div> 395 396<div class="method"> 397 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code> 398 <pre>Update the specified case. Only a subset of fields (display_name, description, time_zone, subscriber_email_addresses, related_resources, severity, primary_contact, and labels) can be updated. 399 400Args: 401 name: string, The resource name for the case. (required) 402 body: object, The request body. 403 The object takes the form of: 404 405{ # A support case. 406 "classification": { # A classification object with a product type and value. # The issue classification applicable to this case. 407 "displayName": "A String", # The display name of the classification. 408 "id": "A String", # The unique ID for a classification. Must be specified for case creation. 409 }, 410 "createTime": "A String", # Output only. The time this case was created. 411 "creator": { # An object containing information about the effective user and authenticated principal responsible for an action. # The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. 412 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 413 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 414 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 415 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 416 }, 417 "description": "A String", # A broad description of the issue. 418 "displayName": "A String", # The short summary of the issue reported in this case. 419 "escalated": True or False, # Whether the case is currently escalated. 420 "name": "A String", # The resource name for the case. 421 "severity": "A String", # The severity of this case. 422 "state": "A String", # Output only. The current status of the support case. 423 "subscriberEmailAddresses": [ # The email addresses to receive updates on this case. 424 "A String", 425 ], 426 "testCase": True or False, # Whether this case was created for internal API testing and should not be acted on by the support team. 427 "timeZone": "A String", # The timezone of the user who created the support case. It should be in a format IANA recognizes: https://www.iana.org/time-zones. There is no additional validation done by the API. 428 "updateTime": "A String", # Output only. The time this case was last updated. 429} 430 431 updateMask: string, A field that represents attributes of a case object that should be updated as part of this request. Supported values are severity, display_name, and subscriber_email_addresses. If no fields are specified, all supported fields will be updated. WARNING: If you do not provide a field mask then you may accidentally clear some fields. For example, if you leave field mask empty and do not provide a value for subscriber_email_addresses then subscriber_email_addresses will be updated to empty. 432 x__xgafv: string, V1 error format. 433 Allowed values 434 1 - v1 error format 435 2 - v2 error format 436 437Returns: 438 An object of the form: 439 440 { # A support case. 441 "classification": { # A classification object with a product type and value. # The issue classification applicable to this case. 442 "displayName": "A String", # The display name of the classification. 443 "id": "A String", # The unique ID for a classification. Must be specified for case creation. 444 }, 445 "createTime": "A String", # Output only. The time this case was created. 446 "creator": { # An object containing information about the effective user and authenticated principal responsible for an action. # The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. 447 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 448 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 449 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 450 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 451 }, 452 "description": "A String", # A broad description of the issue. 453 "displayName": "A String", # The short summary of the issue reported in this case. 454 "escalated": True or False, # Whether the case is currently escalated. 455 "name": "A String", # The resource name for the case. 456 "severity": "A String", # The severity of this case. 457 "state": "A String", # Output only. The current status of the support case. 458 "subscriberEmailAddresses": [ # The email addresses to receive updates on this case. 459 "A String", 460 ], 461 "testCase": True or False, # Whether this case was created for internal API testing and should not be acted on by the support team. 462 "timeZone": "A String", # The timezone of the user who created the support case. It should be in a format IANA recognizes: https://www.iana.org/time-zones. There is no additional validation done by the API. 463 "updateTime": "A String", # Output only. The time this case was last updated. 464}</pre> 465</div> 466 467<div class="method"> 468 <code class="details" id="search">search(pageSize=None, pageToken=None, query=None, x__xgafv=None)</code> 469 <pre>Search cases using the specified query. 470 471Args: 472 pageSize: integer, The maximum number of cases fetched with each request. The default page size is 10. 473 pageToken: string, A token identifying the page of results to return. If unspecified, the first page is retrieved. 474 query: string, An expression written in the Cloud filter language. Filter strings can use the following fields: - organization (A name of the form organizations/) - project (A name of the form projects/) - customer (A name of the form customers/) - state (Accepted values: OPEN or CLOSED) - severity (Accepted values: S0, S1, S2, S3, or S4) - creator.email with the operators equals (=) and AND. Additionally, a global restriction (with no key/operator) can be used to search across display_name, description, and comments (e.g. "my search"). One of organization, project, or customer field must be specified. 475 x__xgafv: string, V1 error format. 476 Allowed values 477 1 - v1 error format 478 2 - v2 error format 479 480Returns: 481 An object of the form: 482 483 { # The response message for the SearchCases endpoint. 484 "cases": [ # The list of Case associated with the cloud resource, after any filters have been applied. 485 { # A support case. 486 "classification": { # A classification object with a product type and value. # The issue classification applicable to this case. 487 "displayName": "A String", # The display name of the classification. 488 "id": "A String", # The unique ID for a classification. Must be specified for case creation. 489 }, 490 "createTime": "A String", # Output only. The time this case was created. 491 "creator": { # An object containing information about the effective user and authenticated principal responsible for an action. # The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. 492 "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. 493 "email": "A String", # The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. 494 "googleSupport": True or False, # Output only. Whether the actor is a Google support actor. 495 "principalId": "A String", # Output only. An ID representing the user that was authenticated when the corresponding action was taken. This will be an email address, if one is available, or some other unique ID. See https://cloud.google.com/docs/authentication for more information on types of authentication. 496 }, 497 "description": "A String", # A broad description of the issue. 498 "displayName": "A String", # The short summary of the issue reported in this case. 499 "escalated": True or False, # Whether the case is currently escalated. 500 "name": "A String", # The resource name for the case. 501 "severity": "A String", # The severity of this case. 502 "state": "A String", # Output only. The current status of the support case. 503 "subscriberEmailAddresses": [ # The email addresses to receive updates on this case. 504 "A String", 505 ], 506 "testCase": True or False, # Whether this case was created for internal API testing and should not be acted on by the support team. 507 "timeZone": "A String", # The timezone of the user who created the support case. It should be in a format IANA recognizes: https://www.iana.org/time-zones. There is no additional validation done by the API. 508 "updateTime": "A String", # Output only. The time this case was last updated. 509 }, 510 ], 511 "nextPageToken": "A String", # A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `SearchCaseRequest` message that is issued. If unspecified, there are no more results to retrieve. 512}</pre> 513</div> 514 515<div class="method"> 516 <code class="details" id="search_next">search_next(previous_request, previous_response)</code> 517 <pre>Retrieves the next page of results. 518 519Args: 520 previous_request: The request for the previous page. (required) 521 previous_response: The response from the request for the previous page. (required) 522 523Returns: 524 A request object that you can call 'execute()' on to request the next 525 page. Returns None if there are no more items in the collection. 526 </pre> 527</div> 528 529</body></html>