Gültige Klassifizierungen abrufen, die beim Erstellen einer Supportanfrage verwendet werden sollen
Klassifizierungen sind hierarchisch. Jede Klassifizierung ist ein String, der alle Hierarchieebenen enthält, die durch " > "
getrennt sind. Beispiel: "Technical Issue > Compute > Compute Engine"
.
Die von diesem Endpunkt zurückgegebenen Klassifizierungs-IDs sind mindestens sechs Monate lang gültig. Wenn eine Klassifizierung deaktiviert wird, gibt dieser Endpunkt sie nicht mehr zurück. Nach sechs Monaten schlagen case.create
-Anfragen, die diese Klassifizierung verwenden, fehl.
BEISPIELE:
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-Anfrage
GET https://cloudsupport.googleapis.com/v2/caseClassifications:search
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
query |
Ein Ausdruck, der zum Filtern von Groß- und Kleinschreibung verwendet wird. Bei einem leeren String erfolgt keine Filterung. Andernfalls werden Fallklassifizierungen zurückgegeben, die dem Filter entsprechen. |
pageSize |
Die maximale Anzahl der Klassifizierungen, die mit jeder Anfrage abgerufen werden. |
pageToken |
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 „caseClassifications.search“.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"caseClassifications": [
{
object ( |
Felder | |
---|---|
caseClassifications[] |
Die abgerufenen Klassifizierungen. |
nextPageToken |
Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Legen Sie dies im Feld |
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.