Method: projects.jobs.list

Lista vagas por filtro.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso do locatário em que o job é criado.

O formato é "projects/{projectId}/tenants/{tenantId}". Por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado. Por exemplo, "projects/foo".

Parâmetros de consulta

Parâmetros
filter

string

Obrigatório. A string de filtro especifica as vagas que serão enumeradas.

Operador aceito: =, AND

Os campos qualificados para filtragem são:

  • companyName (obrigatório)
  • requisitionId
  • status Valores disponíveis: OPEN, EXPIRED, ALL. O padrão será OPEN se nenhum valor for especificado.

Consulta de amostra:

  • companyName = "projects/foo/tenants/bar/Companies/baz"
  • empresaName = "projects/foo/tenants/bar/Companies/baz" AND requisitionId = "req-1"
  • empresaName = "projects/foo/tenants/bar/companies/baz" AND status = "EXPIRED"
pageToken

string

O ponto de partida do resultado de uma consulta.
pageSize

integer

O número máximo de vagas a serem retornadas por página de resultados.

Se jobView for definido como JobView.JOB_VIEW_ID_ONLY, o tamanho máximo permitido da página será 1.000. Caso contrário, o tamanho máximo permitido da página será 100.

O padrão é 100, caso vazio, ou um número < 1 é especificado.
jobView

enum (JobView)

Os atributos desejados da vaga retornados para vagas na resposta da pesquisa. O padrão será JobView.JOB_VIEW_FULL se nenhum valor for especificado.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de ListJobsResponse.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.