Method: projects.jobs.list

按过滤条件列出招聘信息。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。创建作业的租户的资源名称。

格式为“projects/{projectId}/tenants/{tenantId}”。例如“projects/foo/tenant/bar”。如果未指定租户 ID,则系统会创建默认租户。例如“projects/foo”。

查询参数

参数
filter

string

必需。指定要枚举的招聘信息的过滤字符串。

支持的运算符:=、AND

可用于过滤的字段包括:

  • companyName(必需)
  • requisitionId
  • status 可用值:OPEN、EXPIRED、ALL。如果未指定值,则默认为 OPEN。

示例查询:

  • companyName =“projects/foo/tenants/bar/companies/baz”
  • companyName = "projects/foo/tenants/bar/companies/baz" AND requisitionId = "req-1"
  • companyName = "projects/foo/tenants/bar/companies/baz" AND 状态 = "EXPIRED"
pageToken

string

查询结果的起点。

pageSize

integer

每页结果返回的最大招聘信息数。

如果将 jobView 设置为 JobView.JOB_VIEW_ID_ONLY,则允许的页面大小上限为 1000。如果设置为 false,则允许的最大页面大小为 100。

如果为空或指定的数字小于 1,则默认值为 100。

jobView

enum (JobView)

为搜索响应中的招聘信息返回所需的职位属性。如果未指定任何值,则默认为 JobView.JOB_VIEW_FULL

请求正文

请求正文必须为空。

响应正文

如果成功,则响应正文包含一个 ListJobsResponse 实例。

授权范围

需要以下 OAuth 范围之一:

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

如需了解详情,请参阅身份验证概览