Method: projects.jobs.list

Muestra una lista de los trabajos por filtro.

Solicitud HTTP

GET https://jobs.googleapis.com/v4beta1/{parent=projects/*}/jobs

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

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El nombre del recurso del usuario con el que se crea el trabajo.

El formato es “projects/{projectId}/tenants/{tenantId}”. Por ejemplo, “projects/foo/tenant/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado. Por ejemplo, “projects/foo”.

Parámetros de búsqueda

Parámetros
filter

string

Obligatorio. La string de filtro especifica los trabajos que se enumerarán.

Operador admitido: =, AND

Estos son los campos aptos para filtrar:

  • companyName (obligatorio)
  • requisitionId
  • status Valores disponibles: OPEN, EXPIRED, ALL. El valor predeterminado es OPEN si no se especifica ningún valor.

Consulta de muestra:

  • nombredeempresa = "proyectos/foo/usuarios/bar/empresas/baz"
  • nombredeempresa = "proyectos/foo/usuarios/bar/empresas/baz" Y requisitionId = "req-1"
  • nombredeempresa = "proyectos/foo/usuarios/bar/empresas/baz" Y estado = "EXPIRADO"
pageToken

string

El punto de partida de los resultados de la búsqueda.

pageSize

integer

La cantidad máxima de trabajos que se mostrarán en cada página de resultados.

Si estableces jobView como JobView.JOB_VIEW_ID_ONLY, el tamaño de página máximo permitido es 1,000. De lo contrario, el tamaño de página máximo permitido es 100.

El valor predeterminado es 100 si está vacío o si se especifica un número menor que 1.

jobView

enum (JobView)

Los atributos de trabajo deseados que se muestran para los trabajos en la respuesta de la búsqueda. El valor predeterminado es JobView.JOB_VIEW_FULL si no se especifica ningún valor.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ListJobsResponse.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

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