Method: cases.search

Menelusuri kasus menggunakan kueri.

CONTOH:

{i>cURL<i}:

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())

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Nama resource induk untuk menelusuri kasus di bawah.

Parameter kueri

Parameter
query

string

Ekspresi yang digunakan untuk memfilter kasus.

Ekspresi menggunakan kolom berikut yang dipisahkan dengan AND dan ditentukan dengan =:

  • organization: Nama organisasi dalam formulir organizations/<organizationId>.
  • project: Nama project dalam format projects/<projectId>.
  • state: Dapat berupa OPEN atau CLOSED.
  • priority: Dapat berupa P0, P1, P2, P3, atau P4. Anda dapat menentukan beberapa nilai prioritas menggunakan operator OR. Misalnya, priority=P1 OR priority=P2.
  • creator.email: Alamat email pembuat kasus.

Anda harus menentukan organization atau project.

Untuk menelusuri di displayName, description, dan komentar, gunakan pembatasan global tanpa kata kunci atau operator. Misalnya, "my search".

Untuk menelusuri hanya kasus yang diperbarui setelah tanggal tertentu, gunakan updateTime yang dibatasi dengan tanggal, waktu, dan zona waktu tertentu dalam format tanggal dan waktu ISO. Contoh, updateTime>"2020-01-01T00:00:00-05:00". updateTime hanya mendukung operator lebih besar dari (>).

Contoh:

  • 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

Jumlah maksimum kasus yang diambil dengan setiap permintaan. Ukuran halaman default adalah 10.
pageToken

string

Token yang mengidentifikasi halaman hasil yang akan ditampilkan. Jika tidak ditentukan, halaman pertama akan diambil.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Pesan respons untuk endpoint cases.search.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "cases": [
    {
      object (Case)
    }
  ],
  "nextPageToken": string
}
Kolom
cases[]

object (Case)

Daftar kasus yang terkait dengan induk setelah filter apa pun diterapkan.
nextPageToken

string

Token untuk mengambil halaman hasil berikutnya. Tetapkan nilai ini di kolom pageToken pada permintaan cases.search berikutnya. Jika tidak ditentukan, tidak ada lagi hasil yang akan diambil.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.