Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13183063.3 KB
cases

Create a new case and associate it with a parent. It must have the following fields set: display_name, description, classification, and priority. If you're just testing the API and don't want to route your case to an agent, set testCase=true. EXAMPLES: cURL: shell parent="projects/some-project" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header 'Content-Type: application/json' \ --data '{ "display_name": "Test case created by me.", "description": "a random test case, feel free to close", "classification": { "id": "100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8" }, "time_zone": "-07:00", "subscriber_email_addresses": [ "foo@domain.com", "bar@domain.com" ], "testCase": true, "priority": "P3" }' \ "https://cloudsupport.googleapis.com/v2/$parent/cases" Python: python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().create( parent="projects/some-project", body={ "displayName": "A Test Case", "description": "This is a test case.", "testCase": True, "priority": "P2", "classification": { "id": "100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8" }, }, ) print(request.execute())

post/v2/{+parent}/cases

Path parameters

parentstring required

Required. The name of the parent under which the case should be created.

Request body

displayNamestring

The short summary of the issue reported in this case.

state'STATE_UNSPECIFIED' | 'NEW' | 'IN_PROGRESS_GOOGLE_SUPPORT' | 'ACTION_REQUIRED' | 'SOLUTION_PROVIDED' | 'CLOSED'

Output only. The current status of the support case.

descriptionstring

A broad description of the issue.

contactEmailstring

A user-supplied email address to send case update notifications for. This should only be used in BYOID flows, where we cannot infer the user's email address directly from their EUCs.

escalatedboolean

Whether the case is currently escalated.

testCaseboolean

Whether this case was created for internal API testing and should not be acted on by the support team.

createTimestring google-datetime

Output only. The time this case was created.

namestring

Identifier. The resource name for the case.

priority'PRIORITY_UNSPECIFIED' | 'P0' | 'P1' | 'P2' | 'P3' | 'P4'

The priority of this case.

updateTimestring google-datetime

Output only. The time this case was last updated.

languageCodestring

The language the user has requested to receive support in. This should be a BCP 47 language code (e.g., "en", "zh-CN", "zh-TW", "ja", "ko"). If no language or an unsupported language is specified, this field defaults to English (en). Language selection during case creation may affect your available support options. For a list of supported languages and their support working hours, see: https://cloud.google.com/support/docs/language-working-hours

subscriberEmailAddressesstring[]

The email addresses to receive updates on this case.

timeZonestring

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.

Response

Successful response