Method: cases.search

Busca casos con una consulta.

EJEMPLOS:

cURL:

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

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().search(
    parent="projects/some-project", query="state=OPEN"
)
print(request.execute())

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
parent

string

El nombre del recurso superior en el que se buscarán casos.

Parámetros de búsqueda

Parámetros
query

string

Una expresión que se usa para filtrar casos.

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

  • organization: Es un nombre de organización con el formato organizations/<organizationId>.
  • project: Es un nombre de proyecto con el formato projects/<projectId>.
  • 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

Debes especificar organization o project.

Para buscar en displayName, description y comentarios, usa una restricción global sin palabras clave ni operadores. Por ejemplo, "my search".

Para buscar solo casos actualizados después de una fecha determinada, usa updateTime restringido con esa fecha, hora y zona horaria en particular en el formato de fecha y hora ISO. Por ejemplo, updateTime>"2020-01-01T00:00:00-05:00" updateTime solo admite el operador mayor que (>).

Ejemplos:

  • organization="organizations/123456789"
  • project="projects/my-project-id"
  • project="projects/123456789"
  • organization="organizations/123456789" AND state=CLOSED
  • project="projects/my-project-id" AND creator.email="tester@example.com"
  • project="projects/my-project-id" AND (priority=P0 OR priority=P1)
pageSize

integer

La cantidad máxima de casos recuperados con cada solicitud. El tamaño de página predeterminado 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.search.

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.search 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.