Method: projects.jobs.patch

更新指定的招聘信息。

通常,更新的内容会在 10 秒内在搜索结果中展示,最长则可能需要 5 分钟。

HTTP 请求

PATCH https://jobs.googleapis.com/v4beta1/{job.name=projects/*/jobs/*}

网址采用 gRPC 转码语法。

路径参数

参数
job.name

string

更新招聘信息时需要用到此参数。

招聘信息的资源名称。此字段是在创建招聘信息时由服务生成的。

格式为“projects/{projectId}/tenants/{tenantId}/jobs/{job_id}”。例如“projects/foo/tenants/bar/jobs/baz”。

如果未指定租户 ID,则使用默认租户。例如“projects/foo/jobs/bar”。

在招聘信息查询和 API 调用中优先使用此字段,而非 requisitionId,因为此值是唯一的。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "job": {
    "name": string,
    "company": string,
    "requisitionId": string,
    "title": string,
    "description": string,
    "addresses": [
      string
    ],
    "applicationInfo": {
      "emails": [
        string
      ],
      "instruction": string,
      "uris": [
        string
      ]
    },
    "jobBenefits": [
      enum (JobBenefit)
    ],
    "compensationInfo": {
      "entries": [
        {
          object (CompensationEntry)
        }
      ],
      "annualizedBaseCompensationRange": {
        object (CompensationRange)
      },
      "annualizedTotalCompensationRange": {
        object (CompensationRange)
      }
    },
    "customAttributes": {
      string: {
        object (CustomAttribute)
      },
      ...
    },
    "degreeTypes": [
      enum (DegreeType)
    ],
    "department": string,
    "employmentTypes": [
      enum (EmploymentType)
    ],
    "incentives": string,
    "languageCode": string,
    "jobLevel": enum (JobLevel),
    "promotionValue": integer,
    "qualifications": string,
    "responsibilities": string,
    "postingRegion": enum (PostingRegion),
    "visibility": enum (Visibility),
    "jobStartTime": {
      "seconds": string,
      "nanos": integer
    },
    "jobEndTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingPublishTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingExpireTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingCreateTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingUpdateTime": {
      "seconds": string,
      "nanos": integer
    },
    "companyDisplayName": string,
    "derivedInfo": {
      "locations": [
        {
          object (Location)
        }
      ],
      "jobCategories": [
        enum (JobCategory)
      ]
    },
    "processingOptions": {
      "disableStreetAddressResolution": boolean,
      "htmlSanitization": enum (HtmlSanitization)
    }
  },
  "updateMask": string
}
字段
job.company

string

必需。发布招聘信息的公司的资源名称。

格式为“projects/{projectId}/tenants/{tenantId}/companies/{company_id}”。例如“projects/foo/tenants/bar/companies/baz”。

如果未指定租户 ID,则使用默认租户。例如“projects/foo/companies/bar”。

job.requisitionId

string

必需。雇用信息 ID,也称为帖子 ID,由客户指定以标识招聘信息。此字段供客户使用,用于标识和跟踪帖子。如果存在具有相同 companylanguageCoderequisitionId 的其他作业,则不允许创建该作业。

允许的最大字符数为 255。

job.title

string

必需。职位的职称,如“软件工程师”

允许的最大字符数为 500。

job.description

string

必需。职位的描述,通常包括对公司的多段描述和相关信息。对于 responsibilitiesqualifications 和其他职位特征,职位对象上提供了单独的字段。建议使用这些单独的字段。

此字段接受 HTML 输入并对其进行清理,也接受粗体、斜体、有序列表和无序列表标记。

允许的最大字符数为 100000。

job.addresses[]

string

强烈建议提供,以获得最佳服务体验。

雇主希望为此招聘信息帖子设置的招聘地点。

为招聘地点指定完整的街道地址可以获得更好的 API 结果,尤其在按通勤时间搜索招聘信息时。

为获得最佳搜索结果,最多允许设置 50 个地点。如果某个职位有多个地点,建议将其拆分为多个具有唯一 requisitionId 的作业(例如,“ReqA”会变为“ReqA-1”“ReqA-2”等),因为不允许有多个具有相同 companylanguageCoderequisitionId 的作业。如果必须保留原始 requisitionId,则应使用自定义字段进行存储。此外,建议将同一招聘信息中互相靠近的地点分组,以获得更好的搜索体验。

允许的最大字符数为 500。

job.applicationInfo

object (ApplicationInfo)

职位申请信息。

job.jobBenefits[]

enum (JobBenefit)

此职位包含的福利。

job.compensationInfo

object (CompensationInfo)

职位薪酬信息(也称为“工资率”),即向员工支付的薪酬。

job.customAttributes

map (key: string, value: object (CustomAttribute))

所提供的结构化字段未涵盖的可过滤和不可过滤自定义职位属性的字段映射。

映射的键为最多 64 个字节的字符串,并且必须匹配以下格式:[a-zA-Z][a-zA-Z0-9_]*。例如,key0LikeThis 或 KEY_1_LIKE_THIS。

最多支持 100 个可过滤键和 100 个不可过滤键。对于可过滤的 stringValues,所有键中最多允许 200 个值,每个字符串不超过 255 个字符。对于不可过滤的 stringValues,所有键的 stringValues 总大小上限为 50KB。

job.degreeTypes[]

enum (DegreeType)

此职位所需的教育水平,如“学士”、“硕士”。

job.department

string

公司公开职位所属的部门或职能部门。

允许的最大字符数为 255。

job.employmentTypes[]

enum (EmploymentType)

职位的工作性质,例如 full timepart time

job.incentives

string

与职位相关的奖金、佣金和其他薪酬激励的描述,不包括工资或薪水。

允许的最大字符数为 10000。

job.languageCode

string

帖子使用的语言。该字段不同于与职位相关的任何流畅性要求。

语言代码必须采用 BCP-47 格式,例如“en-US”或“sr-Latn”。如需了解详情,请参阅标识语言的标记 {: class="external" target="_blank" }。

如果此字段未指定且存在 Job.description,则系统会根据 Job.description 分配检测到的语言代码,否则默认为“en_US”。

job.jobLevel

enum (JobLevel)

与职位相关的经验水平,例如“初级”。

job.promotionValue

integer

由客户确定的职位推广值。该值用于确定使用精选招聘信息搜索调用搜索时返回招聘信息的排序顺序,推广值较高的结果会优先返回,其余结果按照相关性排序来返回。仅在 FEATURED_JOB_SEARCH 中返回 promotionValue >0 的招聘信息。

默认值为 0,负值也视为 0。

job.qualifications

string

说明任职所需的资格。建议使用此字段作为更通用的 description 字段的替代方案。

此字段接受 HTML 输入并对其进行清理,也接受粗体、斜体、有序列表和无序列表标记。

允许的最大字符数为 10000。

job.responsibilities

string

职位职责描述。建议使用此字段作为更通用的 description 字段的替代方案。

此字段接受 HTML 输入并对其进行清理,也接受粗体、斜体、有序列表和无序列表标记。

允许的最大字符数为 10000。

job.postingRegion

enum (PostingRegion)

提供招聘信息的 PostingRegion 招聘信息(例如州、国家/地区)。如果设置了此字段,且未指定确切地点匹配项,则招聘信息所在地区内的搜索查询中的 LocationFilter 会找到此招聘信息。如果此字段设为 PostingRegion.NATIONPostingRegion.ADMINISTRATIVE_AREA,则强烈建议将招聘信息 Job.addresses 设为与此字段相同的地点级别。

job.visibility
(deprecated)

enum (Visibility)

已弃用。只有所有者才能看到该职位。

招聘信息的可见性。

如果未指定,则默认为 Visibility.ACCOUNT_ONLY

job.jobStartTime

string (Timestamp format)

UTC 时区中的职位开始时间戳。通常,此字段用于签订雇用合同。无效时间戳会被忽略。

job.jobEndTime

string (Timestamp format)

职位的结束时间戳。通常,此字段用于签订雇用合同。无效时间戳会被忽略。

job.postingPublishTime

string (Timestamp format)

此招聘信息帖子最近发布的时间戳。默认值为请求到达服务器的时间。无效时间戳会被忽略。

job.postingExpireTime

string (Timestamp format)

强烈建议提供,以获得最佳服务体验。

招聘信息的过期时间戳。在此时间戳之后,招聘信息将被标记为已过期,并且不再显示在搜索结果中。jobs.list API 无法列出已过期的招聘信息,但可以使用 jobs.get API 检索该招聘信息或使用 jobs.patch API 进行更新,或使用 jobs.delete API 将其删除。您可以使用未来的到期时间戳更新并再次打开已过期的招聘信息。如果存在另一个具有相同 companylanguageCoderequisitionId 的现有打开作业,则更新已过期的作业会失败。

过期招聘信息会在我们的系统中保留 90 天。但是,过期职位总数不能超过过去 7 天内空缺职位数量上限的 3 倍。如果超出此阈值,系统会按照最早的到期时间顺序清除已过期的作业。清理完毕后,将无法再访问这些过期招聘信息。

无效时间戳将被忽略并视为未提供过期时间。

如果时间戳早于发出即时请求的时间,则作业在创建时会被视为立即过期。无法更新此类作业。在创建具有过去时间戳的作业时,必须在 postingExpireTime 之前设置 postingPublishTime。此功能的目的是允许其他对象(例如 Application)引用在到期之前系统中不存在的作业。如果您想修改在创建时已过期的作业,请将其删除并创建新的作业。

如果在创建招聘信息时未提供此值或此值无效,则招聘信息帖子将在招聘信息创建 30 天后过期。例如,如果招聘信息的创建时间为 2017/01/01 13:00AM UTC,并且未指定过期日期,则招聘信息将在 2017/01/31 13:00AM UTC 之后过期。

如果更新招聘信息时未提供此值,则其取决于 UpdateJobRequest.update_mask 设置的字段掩码。如果字段掩码包含 jobEndTime,或者掩码为空,则意味着每个字段都更新,招聘信息帖子将在自职位上次更新之日起 30 天后过期。否则,过期日期不会更新。

job.postingCreateTime

string (Timestamp format)

仅限输出。创建招聘信息帖子时的时间戳。

job.postingUpdateTime

string (Timestamp format)

仅限输出。上次更新此招聘信息帖子的时间戳。

job.companyDisplayName

string

仅限输出。用于列出招聘信息的公司的显示名。

job.derivedInfo

object (DerivedInfo)

仅限输出。有关招聘信息帖子的详细信息。

job.processingOptions

object (ProcessingOptions)

招聘信息处理选项。

updateMask

string (FieldMask format)

强烈建议提供,以获得最佳服务体验。

如果提供了 updateMask,则仅更新 job 中的指定字段。否则更新所有字段。

限制被更新字段的字段掩码。仅支持 Job 的顶级字段。

以逗号分隔的完全限定字段名称列表。示例:"user.displayName,photo"

响应正文

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

授权范围

需要以下 OAuth 范围之一:

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

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