Retrieve valid classifications to use when creating a support case.
Classifications are hierarchical. Each classification is a string containing all levels of the hierarchy separated by " > "
. For example, "Technical Issue > Compute > Compute Engine"
.
Classification IDs returned by this endpoint are valid for at least six months. When a classification is deactivated, this endpoint immediately stops returning it. After six months, case.create
requests using the classification will fail.
EXAMPLES:
cURL:
curl \
--header "Authorization: Bearer $(gcloud auth print-access-token)" \
'https://cloudsupport.googleapis.com/v2/caseClassifications:search?query=displayName:"*Compute%20Engine*"'
Python:
import googleapiclient.discovery
supportApiService = googleapiclient.discovery.build(
serviceName="cloudsupport",
version="v2",
discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version=v2",
)
request = supportApiService.caseClassifications().search(
query='displayName:"*Compute Engine*"'
)
print(request.execute())
HTTP request
GET https://cloudsupport.googleapis.com/v2/caseClassifications:search
The URL uses gRPC Transcoding syntax.
Query parameters
| Parameters | |
|---|---|
query
|
An expression used to filter case classifications. If it's an empty string, then no filtering happens. Otherwise, case classifications will be returned that match the filter. |
pageSize
|
The maximum number of classifications fetched with each request. |
pageToken
|
A token identifying the page of results to return. If unspecified, the first page is retrieved. |
Request body
The request body must be empty.
Response body
The response message for caseClassifications.search endpoint.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"caseClassifications"
:
[
{
object (
|
| Fields | |
|---|---|
caseClassifications[]
|
The classifications retrieved. |
nextPageToken
|
A token to retrieve the next page of results. Set this in the |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/cloudsupport -
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .

