Method: cases.list

Rufen Sie alle Fälle unter einem übergeordneten Element ab, aber nicht seine untergeordneten Elemente.

Wenn Sie beispielsweise Fälle unter einer Organisation auflisten, werden nur die Anfragen zurückgegeben, die dieser Organisation direkt übergeordnet sind. Zum Abrufen von Anfragen in einer Organisation und ihren Projekten verwenden Sie cases.search.

BEISPIELE:

cURL:

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

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().list(parent="projects/some-project")
print(request.execute())

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Name des übergeordneten Elements, unter dem Fälle aufgelistet werden sollen.

Abfrageparameter

Parameter
filter

string

Ein Ausdruck, der zum Filtern von Fällen verwendet wird.

Bei einem leeren String erfolgt keine Filterung. Andernfalls gibt der Endpunkt die Fälle zurück, die dem Filter entsprechen.

Für Ausdrücke werden die folgenden durch AND getrennten Felder verwendet, die mit = angegeben werden:

  • state: Kann OPEN oder CLOSED sein.
  • priority: Kann P0, P1, P2, P3 oder P4 sein. Mit dem Operator OR können Sie mehrere Werte für die Priorität angeben. z. B. priority=P1 OR priority=P2.
  • creator.email: Die E-Mail-Adresse des Erstellers der Anfrage.

BEISPIELE:

  • state=CLOSED
  • state=OPEN AND creator.email="tester@example.com"
  • state=OPEN AND (priority=P0 OR priority=P1)
pageSize

integer

Die maximale Anzahl der Fälle, die mit jeder Anfrage abgerufen werden. Der Standardwert ist 10.
pageToken

string

Ein Token, das die Ergebnisseite identifiziert, die zurückgegeben werden soll. Wenn keine Angabe erfolgt, wird die erste Seite abgerufen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwortnachricht für den Endpunkt „case.list“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "cases": [
    {
      object (Case)
    }
  ],
  "nextPageToken": string
}
Felder
cases[]

object (Case)

Die Liste der Fälle, die dem übergeordneten Element zugeordnet sind, nachdem alle Filter angewendet wurden.
nextPageToken

string

Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Legen Sie dies im Feld pageToken der nachfolgenden cases.list-Anfragen fest. Wenn keine Angabe erfolgt, sind keine weiteren Ergebnisse zum Abrufen vorhanden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.