REST Resource: cases

Ressource: Case

Une demande est un objet qui contient les détails d'une demande d'assistance. Il contient des champs concernant l'heure de sa création, sa priorité, sa classification, etc. Les demandes peuvent également comporter des commentaires et des pièces jointes qui sont ajoutés au fil du temps.

Un cas est apparenté à une organisation ou à un projet Google Cloud.

Les organisations sont identifiées par un numéro. Le nom d'un dossier parent par une organisation se présente donc comme suit:

organizations/123/cases/456

Les projets possèdent deux identifiants uniques, un ID et un numéro. Ils se présentent comme suit:

projects/abc/cases/456

projects/123/cases/456

Vous pouvez utiliser l'un ou l'autre lorsque vous appelez l'API. Pour en savoir plus sur les identifiants de projet, consultez la page AIP-2510.

Représentation 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)
}
Champs
name

string

Nom de la ressource pour la demande.
displayName

string

Bref résumé du problème signalé dans ce cas.
description

string

Une description générale du problème.
classification

object (CaseClassification)

Classification du problème applicable à ce cas.
timeZone

string

Fuseau horaire de l'utilisateur qui a créé la demande d'assistance. Il doit être dans un format reconnu par l'IANA: https://www.iana.org/time-zones. Aucune validation supplémentaire n'est effectuée par l'API.
subscriberEmailAddresses[]

string

Adresses e-mail auxquelles envoyer des informations sur cette demande.
state

enum (State)

Uniquement en sortie. État actuel de la demande d'assistance.
createTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle cette demande a été créée.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Uniquement en sortie. Date et heure de la dernière mise à jour de cette demande.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
creator

object (Actor)

Utilisateur à l'origine de la demande.

Remarque: Le nom et l'adresse e-mail seront obscurcis si la demande a été créée par l'assistance Google.
contactEmail

string

Adresse e-mail fournie par l'utilisateur pour laquelle envoyer les notifications de mise à jour de la demande. Elle ne doit être utilisée que dans les flux BYOID, où nous ne pouvons pas déduire l'adresse e-mail de l'utilisateur directement à partir de son EUC.
escalated

boolean

Indique si la demande est actuellement escaladée.
testCase

boolean

Indique si la demande a été créée pour des tests d'API internes et si elle ne doit pas être traitée par l'équipe d'assistance.
languageCode

string

Langue dans laquelle l'utilisateur a demandé à bénéficier d'une assistance. Il doit s'agir d'un code de langue BCP 47 (par exemple, "en", "zh-CN", "zh-TW", "ja", "ko"). Si aucune langue ou une langue non acceptée n'est spécifiée, la valeur par défaut de ce champ est l'anglais (en).

Le choix de la langue lors de la création de la demande peut affecter les options d'assistance disponibles. Pour consulter la liste des langues prises en charge et leurs horaires d'assistance, accédez à https://cloud.google.com/support/docs/language-working-hours.
priority

enum (Priority)

Priorité de ce dossier.

État

État d'une demande d'assistance.

Enums
STATE_UNSPECIFIED La demande est dans un état inconnu.
NEW La demande a été créée, mais personne n'est chargé d'y travailler pour le moment.
IN_PROGRESS_GOOGLE_SUPPORT Cette demande est actuellement traitée par l'assistance Google.
ACTION_REQUIRED Google attend votre réponse.
SOLUTION_PROVIDED Une solution a été proposée pour cette demande, mais celle-ci n'est pas encore clôturée.
CLOSED L'incident a été résolu.

Priorité

La priorité du cas. P0 est le plus urgent et P4 le moins.

Enums
PRIORITY_UNSPECIFIED La priorité n'est pas définie ou n'a pas encore été définie.
P0 Impact extrême sur un service de production. Le service est hors service.
P1 Impact critique sur un service de production. Le service est actuellement inutilisable.
P2 Impact grave sur un service de production. Le service est utilisable, mais très altéré.
P3 Impact moyen sur un service de production. Le service est disponible, mais modérément perturbé.
P4 Questions d'ordre général ou problèmes mineurs Le service de production est entièrement disponible.

Méthodes

close

 Clôturez une demande.

create

 Créez une demande et associez-la à un parent.

escalate

 Escalader une demande, en lançant le processus de gestion des escalades à l'assistance Google Cloud

get

 Récupérez une demande.

list

 Permet de récupérer toutes les demandes d'un parent, mais pas ses enfants.

patch

 Modifier une demande
Recherchez des cas à l'aide d'une requête.