Method: caseClassifications.search

检索在创建支持请求时使用的有效分类。

分类是分层的。每个分类都是一个字符串,其中包含层次结构的所有级别,以 " > " 分隔。例如 "Technical Issue > Compute > Compute Engine"

此端点返回的分类 ID 的有效期至少为六个月。停用分类后,此端点会立即停止返回分类。六个月后,使用分类的 case.create 请求将失败。

示例:

c网址:

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 请求

GET https://cloudsupport.googleapis.com/v2/caseClassifications:search

网址采用 gRPC 转码语法。

查询参数

参数
query

string

用于过滤案例分类的表达式。

如果它是空字符串,则不会进行任何过滤。否则,系统将返回与过滤条件匹配的案例分类。

pageSize

integer

随每个请求提取的分类数量上限。

pageToken

string

标识要返回的结果页面的令牌。如果未指定,则检索第一个页面。

请求正文

请求正文必须为空。

响应正文

caseClassifications.search 端点的响应消息。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "caseClassifications": [
    {
      object (CaseClassification)
    }
  ],
  "nextPageToken": string
}
字段
caseClassifications[]

object (CaseClassification)

检索到的分类。

nextPageToken

string

用于检索下一页结果的令牌。在后续 caseClassifications.list 请求的 pageToken 字段中设置此字段。如果未指定,则无需再检索更多结果。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/cloudsupport
  • https://www.googleapis.com/auth/cloud-platform

如需了解详情,请参阅身份验证概览