Method: cases.list

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

Por ejemplo, si se enumeran los casos en una organización, solo se devuelven aquellos casos en los que esa organización supervisa directamente. Para recuperar casos en una organización y sus proyectos, usa cases.search.

EJEMPLOS:

cURL:

parent="projects/some-project"
curl \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://cloudsupport.googleapis.com/v2/$parent/cases"

Python:

import googleapiclient.discovery

apiVersion = "v2"
supportApiService = googleapiclient.discovery.build(
    serviceName="cloudsupport",
    version=apiVersion,
    discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={apiVersion}",
)

request =
  supportApiService.cases().list(parent="projects/some-project")
print(request.execute())

Solicitud HTTP

GET https://cloudsupport.googleapis.com/v2/{parent=*/*}/cases

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el nombre del elemento superior en el que se enumerarán los casos.

Parámetros de búsqueda

Parámetros
filter

string

Una expresión que se usa para filtrar casos.

Si es una string vacía, no se aplica ningún filtro. De lo contrario, el extremo muestra los casos que coinciden con el filtro.

Las expresiones usan los siguientes campos separados por AND y especificados con =:

  • state: Puede ser OPEN o CLOSED.
  • priority: Puede ser P0, P1, P2, P3 o P4. Puedes especificar varios valores de prioridad con el operador OR. Por ejemplo, priority=P1 OR priority=P2.
  • creator.email: La dirección de correo electrónico del creador del caso

EJEMPLOS:

  • state=CLOSED
  • state=OPEN AND creator.email="tester@example.com"
  • state=OPEN AND (priority=P0 OR priority=P1)
pageSize

integer

La cantidad máxima de casos recuperados con cada solicitud. La configuración predeterminada es 10.
pageToken

string

Un token que identifica la página de resultados que se mostrará. Si no se especifica, se recupera la primera página.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

El mensaje de respuesta para el extremo sentencias.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "cases": [
    {
      object (Case)
    }
  ],
  "nextPageToken": string
}
Campos
cases[]

object (Case)

Es la lista de casos asociados con el elemento superior después de aplicar los filtros.
nextPageToken

string

Un token para recuperar los resultados de la página siguiente. Establece esto en el campo pageToken de las solicitudes cases.list posteriores. Si no se especifica, no hay más resultados para recuperar.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/cloudsupport
  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Descripción general de la autenticación.