REST Resource: cases

Recurso: caso

Um caso é um objeto que contém os detalhes de um caso de suporte. Ele contém campos para o horário em que foi criado, a prioridade, a classificação e muito mais. Os casos também podem conter comentários e anexos que são adicionados ao longo do tempo.

Um caso tem origem em uma organização ou projeto do Google Cloud.

As organizações são identificadas por um número, portanto, o nome de um caso pai de uma organização seria assim:

organizations/123/cases/456

Os projetos têm dois identificadores exclusivos, um ID e um número, e têm esta aparência:

projects/abc/cases/456

projects/123/cases/456

É possível usar qualquer um deles ao chamar a API. Para saber mais sobre os identificadores de projetos, consulte AIP-2510 (em inglês).

Representação 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)
}
Campos
name

string

O nome do recurso do caso.
displayName

string

O breve resumo do problema relatado neste caso.
description

string

Uma descrição ampla do problema.
classification

object (CaseClassification)

A classificação do problema aplicável no caso.
timeZone

string

O fuso horário do usuário que criou o caso de suporte. Ela precisa estar em um formato reconhecido pela IANA: https://www.iana.org/time-zones (em inglês). Não há validação adicional feita pela API.
subscriberEmailAddresses[]

string

Os endereços de e-mail para receber atualizações sobre este caso.
state

enum (State)

Apenas saída. O status atual do caso de suporte.
createTime

string (Timestamp format)

Apenas saída. Hora em que o caso foi criado.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Apenas saída. A hora em que este caso foi atualizado pela última vez.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
creator

object (Actor)

O usuário que criou o caso.

Observação: o nome e o e-mail serão ofuscados se o caso tiver sido criado pelo Suporte do Google.
contactEmail

string

Um endereço de e-mail fornecido pelo usuário para enviar notificações de atualização de casos. Essa opção só deve ser usada em fluxos do BYOID, em que não podemos inferir o endereço de e-mail do usuário diretamente dos EUCs.
escalated

boolean

Se o caso está sendo encaminhado para um supervisor.
testCase

boolean

Indica se o caso foi criado para teste interno da API e não deve ser resolvido pela equipe de suporte.
languageCode

string

O idioma em que o usuário solicitou suporte. Precisa ser um código de idioma BCP 47 (por exemplo, "en", "zh-CN", "zh-TW", "ja", "ko"). Se nenhum idioma ou um idioma incompatível for especificado, o padrão deste campo será inglês (en).

A seleção do idioma durante a criação do caso pode afetar as opções de suporte disponíveis. Para conferir uma lista de idiomas com suporte e o horário de trabalho de suporte, acesse: https://cloud.google.com/support/docs/language-working-hours
priority

enum (Priority)

A prioridade do caso.

Estado

O status de um caso de suporte.

Enums
STATE_UNSPECIFIED O caso está em um estado desconhecido.
NEW O caso foi criado, mas ninguém foi designado para trabalhar nele ainda.
IN_PROGRESS_GOOGLE_SUPPORT O caso está sendo tratado pelo Suporte do Google.
ACTION_REQUIRED O Google está aguardando uma resposta.
SOLUTION_PROVIDED Uma solução foi oferecida para o caso, mas ele ainda não foi encerrado.
CLOSED O caso foi resolvido.

Prioridade

A prioridade do caso. O P0 é o mais urgente e o P4 o menos.

Enums
PRIORITY_UNSPECIFIED A prioridade é indefinida ou ainda não foi definida.
P0 Impacto extremo em um serviço de produção. O serviço está difícil.
P1 Impacto crítico em um serviço de produção. O serviço não pode ser usado no momento.
P2 impacto severo em um serviço de produção; O serviço é utilizável, mas muito prejudicado.
P3 Impacto médio em um serviço de produção. Serviço disponível, mas com problemas moderados.
P4 Perguntas gerais ou problemas menores. O serviço Production está totalmente disponível.

Métodos

close

 Encerre um caso.

create

 Crie um novo caso e o associe a um familiar responsável.

escalate

 Encaminhar um caso para um supervisor do Google Cloud, iniciando o processo de gerenciamento.

get

 Recuperar um caso.

list

 Recuperar todos os casos de um pai, mas não dos filhos dele.

patch

 Atualizar um caso.
Pesquisar casos usando uma consulta.