REST Resource: cases

Risorsa: caso

Una richiesta è un oggetto che contiene i dettagli di una richiesta di assistenza. Contiene i campi relativi all'ora di creazione, alla priorità, alla classificazione e altro ancora. Le richieste di assistenza possono anche includere commenti e allegati che vengono aggiunti nel tempo.

Una richiesta è associata a un'organizzazione o a un progetto Google Cloud.

Le organizzazioni sono identificate da un numero, quindi il nome di un caso associato a un'organizzazione sarebbe simile a questo:

organizations/123/cases/456

I progetti hanno due identificatori univoci, un ID e un numero, e hanno il seguente aspetto:

projects/abc/cases/456

projects/123/cases/456

Puoi utilizzare uno dei due per chiamare l'API. Per saperne di più sugli identificatori di progetto, consulta AIP-2510.

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "classification": {
    object (CaseClassification)
  },
  "timeZone": string,
  "subscriberEmailAddresses": [
    string
  ],
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "creator": {
    object (Actor)
  },
  "contactEmail": string,
  "escalated": boolean,
  "testCase": boolean,
  "languageCode": string,
  "priority": enum (Priority)
}
Campi
name

string

Il nome della risorsa per la richiesta.
displayName

string

Il breve riepilogo del problema segnalato in questo caso.
description

string

Un'ampia descrizione del problema.
classification

object (CaseClassification)

La classificazione del problema applicabile a questo caso.
timeZone

string

Il fuso orario dell'utente che ha creato la richiesta di assistenza. Dovrebbe essere in un formato riconosciuto da IANA: https://www.iana.org/time-zones. Non verrà eseguita alcuna ulteriore convalida dall'API.
subscriberEmailAddresses[]

string

Gli indirizzi email su cui ricevere aggiornamenti su questa richiesta.
state

enum (State)

Solo output. Lo stato attuale della richiesta di assistenza.
createTime

string (Timestamp format)

Solo output. L'ora di creazione di questa richiesta.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento di questa richiesta.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
creator

object (Actor)

L'utente che ha creato la richiesta.

Nota: il nome e l'indirizzo email saranno offuscati se la richiesta è stata creata dall'Assistenza Google.
contactEmail

string

Un indirizzo email fornito dall'utente per cui inviare notifiche di aggiornamento della richiesta. Deve essere utilizzato solo nei flussi BYOID, dove non possiamo dedurre l'indirizzo email dell'utente direttamente dalle sue EUC.
escalated

boolean

Se la richiesta è attualmente riassegnata.
testCase

boolean

Indica se questa richiesta è stata creata per test interni dell'API e non deve essere elaborata dal team di assistenza.
languageCode

string

La lingua in cui l'utente ha richiesto di ricevere assistenza. Deve essere un codice lingua BCP 47 (ad es. "en", "zh-CN", "zh-TW", "ja", "ko"). Se non viene specificata alcuna lingua o se viene specificata una lingua non supportata, in questo campo verrà impostato l'inglese (en) per impostazione predefinita.

La selezione della lingua durante la creazione della richiesta potrebbe influire sulle opzioni di assistenza disponibili. Per un elenco delle lingue supportate e il relativo orario di lavoro dell'assistenza, vedi: https://cloud.google.com/support/docs/language-working-hours
priority

enum (Priority)

La priorità di questo caso.

Stato

Lo stato di una richiesta di assistenza.

Enum
STATE_UNSPECIFIED La richiesta è in uno stato sconosciuto.
NEW La richiesta è stata creata, ma nessuno è ancora assegnato al lavoro.
IN_PROGRESS_GOOGLE_SUPPORT L'Assistenza Google sta gestendo la richiesta.
ACTION_REQUIRED Google sta aspettando una risposta.
SOLUTION_PROVIDED È stata offerta una soluzione per la richiesta, ma non è ancora stata chiusa.
CLOSED La richiesta è stata risolta.

Priorità

La priorità della richiesta. P0 è il livello più urgente e P4 il meno.

Enum
PRIORITY_UNSPECIFIED La priorità non è definita o non è stata ancora impostata.
P0 Impatto estremo su un servizio di produzione. Il servizio non è disponibile.
P1 Impatto critico su un servizio di produzione. Il servizio è attualmente inutilizzabile.
P2 Grave impatto su un servizio di produzione. Il servizio è utilizzabile, ma molto ridotto.
P3 Impatto medio su un servizio di produzione. Il servizio è disponibile, ma con una disabilità moderata.
P4 Domande generali o problemi di minore entità. Il servizio di produzione è completamente disponibile.

Metodi

close

 Chiudi una richiesta.

create

 Crea una nuova richiesta e associala a un account principale.

escalate

 Riassegna una richiesta avviando il processo di gestione della riassegnazione dell'Assistenza Google Cloud.

get

 Recupera una richiesta.

list

 Recupera tutte le richieste di un elemento padre, ma non le relative istanze secondarie.

patch

 Aggiorna una richiesta.
Cerca richieste utilizzando una query.