REST Resource: cases

Recurso: Case

Un caso es un objeto que contiene los detalles de un caso de asistencia. Contiene campos para el momento en que se creó, su prioridad, su clasificación y mucho más. Los casos también pueden incluir comentarios y archivos adjuntos que se agregan con el tiempo.

Una organización o proyecto de Google Cloud prioriza un caso.

Las organizaciones se identifican con un número, de modo que el nombre de un caso en el que se basa una organización debería verse así:

organizations/123/cases/456

Los proyectos tienen dos identificadores únicos, un ID y un número, y se ven de la siguiente manera:

projects/abc/cases/456
projects/123/cases/456

Puedes usar cualquiera de ellos cuando llames a la API. Para obtener más información sobre los identificadores de proyectos, consulta AIP-2510.

Representación 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

El nombre del recurso para el caso.

displayName

string

Es un breve resumen del problema informado en este caso.

description

string

Una descripción amplia del problema.

classification

object (CaseClassification)

La clasificación de problemas aplicable a este caso.

timeZone

string

La zona horaria del usuario que creó el caso de asistencia. Debe estar en un formato que la IANA reconozca: https://www.iana.org/time-zones. La API no realiza validaciones adicionales.

subscriberEmailAddresses[]

string

Las direcciones de correo electrónico para recibir actualizaciones sobre este caso.

state

enum (State)

Solo salida. El estado actual del caso de asistencia.

createTime

string (Timestamp format)

Solo salida. La hora en la que se creó este caso.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. Hora en la que se actualizó este caso por última vez.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

creator

object (Actor)

El usuario que creó el caso.

Nota: Si el equipo de Atención al cliente de Google creó el caso, el nombre y el correo electrónico aparecerán ofuscados.

contactEmail

string

Una dirección de correo electrónico proporcionada por el usuario para la que se deben enviar notificaciones de actualizaciones de casos. Solo se debe usar en flujos de BYOID, en los que no podemos inferir la dirección de correo electrónico del usuario directamente a partir de sus EUCs.

escalated

boolean

Si el caso se deriva o no.

testCase

boolean

Si este caso se creó para pruebas internas de API y el equipo de asistencia al cliente no debe tomar medidas al respecto.

languageCode

string

El idioma en el que el usuario solicitó recibir asistencia. Debe ser un código de idioma BCP 47 (p.ej., "en", "zh-CN", "zh-TW", "ja" y "ko"). Si no se especifica un idioma o no se especifica uno, el valor predeterminado de este campo es inglés (en).

La selección de idioma durante la creación del caso puede afectar las opciones de asistencia disponibles. Para obtener una lista de los idiomas compatibles y su horario laboral de asistencia, consulta https://cloud.google.com/support/docs/language-working-hours

priority

enum (Priority)

La prioridad de este caso.

Estado

Es el estado de un caso de asistencia.

Enums
STATE_UNSPECIFIED El caso se encuentra en un estado desconocido.
NEW Se creó el caso, pero aún no hay nadie asignado para trabajar en él.
IN_PROGRESS_GOOGLE_SUPPORT Actualmente, el equipo de Atención al cliente de Google se encarga del caso.
ACTION_REQUIRED Google está esperando una respuesta.
SOLUTION_PROVIDED Se ofreció una solución para el caso, pero aún no se cerró.
CLOSED El caso se resolvió.

Prioridad

La prioridad del caso P0 es el más urgente y P4 el menos.

Enums
PRIORITY_UNSPECIFIED La prioridad no está definida o aún no se estableció.
P0 Impacto extremo en un servicio de producción El servicio está inactivo.
P1 Impacto crítico en un servicio de producción. En este momento, el servicio no se puede usar.
P2 Impacto grave en un servicio de producción. El servicio es utilizable, pero se ve afectado en gran medida.
P3 Impacto medio en un servicio de producción El servicio está disponible, pero tiene discapacidades moderadas.
P4 Preguntas generales o problemas menores. El servicio de producción está completamente disponible.

Métodos

close

Cierra un caso.

create

Crea un caso nuevo y asócialo con un superior.

escalate

Derivar un caso a partir del proceso de administración de derivaciones de la Asistencia de Google Cloud

get

Recupera un caso.

list

Recupera todos los casos de un elemento superior, pero no sus elementos secundarios.

patch

Actualiza un caso.
Busca casos con una consulta.