Method: cases.search

쿼리를 사용하여 케이스를 검색합니다.

예:

cURL:

parent="projects/some-project"
curl \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://cloudsupport.googleapis.com/v2/$parent/cases:search"

Python

import googleapiclient.discovery


apiVersion = "v2"
supportApiService = googleapiclient.discovery.build(
    serviceName="cloudsupport",
    version=apiVersion,
    discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={apiVersion}",
)
request = supportApiService.cases().search(
    parent="projects/some-project", query="state=OPEN"
)
print(request.execute())

HTTP 요청

GET https://cloudsupport.googleapis.com/v2/{parent=*/*}/cases:search

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

케이스를 검색할 상위 리소스의 이름입니다.

쿼리 매개변수

매개변수
query

string

케이스를 필터링하는 데 사용되는 표현식입니다.

표현식에는 AND로 구분되고 =가 지정된 다음 필드가 사용됩니다.

  • organization: organizations/<organizationId> 형식의 조직 이름입니다.
  • project: projects/<projectId> 형식의 프로젝트 이름입니다.
  • state: OPEN 또는 CLOSED일 수 있습니다.
  • priority: P0, P1, P2, P3 또는 P4일 수 있습니다. OR 연산자를 사용하여 우선순위에 여러 값을 지정할 수 있습니다. 예를 들면 priority=P1 OR priority=P2입니다.
  • creator.email: 케이스 생성자의 이메일 주소입니다.

organization 또는 project를 지정해야 합니다.

displayName, description, 댓글을 검색하려면 키워드 또는 연산자 없이 전역 제한을 사용합니다. 예를 들면 "my search"입니다.

특정 날짜 이후에 업데이트된 케이스만 검색하려면 ISO 날짜/시간 형식의 특정 날짜, 시간, 시간대로 제한된 updateTime을 사용합니다. 예를 들면 updateTime>"2020-01-01T00:00:00-05:00"입니다. updateTime은 초과 연산자(>)만 지원합니다.

예:

  • organization="organizations/123456789"
  • project="projects/my-project-id"
  • project="projects/123456789"
  • organization="organizations/123456789" AND state=CLOSED
  • project="projects/my-project-id" AND creator.email="tester@example.com"
  • project="projects/my-project-id" AND (priority=P0 OR priority=P1)
pageSize

integer

요청별로 가져올 수 있는 최대 케이스 수입니다. 기본 페이지 크기는 10입니다.

pageToken

string

반환할 결과 페이지를 식별하는 토큰입니다. 지정하지 않으면 첫 번째 페이지가 검색됩니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

cases.search 엔드포인트의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "cases": [
    {
      object (Case)
    }
  ],
  "nextPageToken": string
}
필드
cases[]

object (Case)

필터가 적용된 후 상위 요소와 연결된 케이스의 목록입니다.

nextPageToken

string

결과의 다음 페이지를 검색하는 토큰입니다. 이후 cases.search 요청의 pageToken 필드에 이를 설정합니다. 지정하지 않으면 더 이상 검색할 결과가 없습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.