- 资源:Job
- 方法
资源:招聘信息
招聘信息资源表示招聘信息帖子(也称为“招聘信息列表”或“雇用信息”)。招聘信息属于 Company
,后者是负责提供相应招聘信息的招聘实体。
JSON 表示法 | |
---|---|
{ "name": string, "company": string, "requisitionId": string, "title": string, "description": string, "addresses": [ string ], "applicationInfo": { object ( |
字段 | |
---|---|
name |
更新招聘信息时需要用到此字段。 招聘信息的资源名称。此字段是在创建招聘信息时由服务生成的。 格式为“projects/{projectId}/tenants/{tenantId}/jobs/{job_id}”。例如“projects/foo/tenants/bar/jobs/baz”。 如果未指定租户 ID,则使用默认租户。例如“projects/foo/jobs/bar”。 在招聘信息查询和 API 调用中优先使用此字段,而非 |
company |
必需。发布招聘信息的公司的资源名称。 格式为“projects/{projectId}/tenants/{tenantId}/companies/{company_id}”。例如“projects/foo/tenants/bar/companies/baz”。 如果未指定租户 ID,则使用默认租户。例如“projects/foo/companies/bar”。 |
requisitionId |
必需。雇用信息 ID,也称为帖子 ID,由客户指定以标识招聘信息。此字段供客户使用,用于标识和跟踪帖子。如果存在具有相同 允许的最大字符数为 255。 |
title |
必需。职位的职称,如“软件工程师” 允许的最大字符数为 500。 |
description |
必需。职位的描述,通常包括对公司的多段描述和相关信息。对于 此字段接受 HTML 输入并对其进行清理,也接受粗体、斜体、有序列表和无序列表标记。 允许的最大字符数为 100000。 |
addresses[] |
强烈建议提供,以获得最佳服务体验。 雇主希望为此招聘信息帖子设置的招聘地点。 为招聘地点指定完整的街道地址可以获得更好的 API 结果,尤其在按通勤时间搜索招聘信息时。 为获得最佳搜索结果,最多允许设置 50 个地点。如果某个职位有多个地点,建议将其拆分为多个具有唯一 允许的最大字符数为 500。 |
applicationInfo |
职位申请信息。 |
jobBenefits[] |
此职位包含的福利。 |
compensationInfo |
职位薪酬信息(也称为“工资率”),即向员工支付的薪酬。 |
customAttributes |
所提供的结构化字段未涵盖的可过滤和不可过滤自定义职位属性的字段映射。 映射的键为最多 64 个字节的字符串,并且必须匹配以下格式:[a-zA-Z][a-zA-Z0-9_]*。例如,key0LikeThis 或 KEY_1_LIKE_THIS。 最多支持 100 个可过滤键和 100 个不可过滤键。对于可过滤的 |
degreeTypes[] |
此职位所需的教育水平,如“学士”、“硕士”。 |
department |
公司公开职位所属的部门或职能部门。 允许的最大字符数为 255。 |
employmentTypes[] |
|
incentives |
与职位相关的奖金、佣金和其他薪酬激励的描述,不包括工资或薪水。 允许的最大字符数为 10000。 |
languageCode |
帖子使用的语言。该字段不同于与职位相关的任何流畅性要求。 语言代码必须采用 BCP-47 格式,例如“en-US”或“sr-Latn”。如需了解详情,请参阅标识语言的标记 {: class="external" target="_blank" }。 如果此字段未指定且存在 |
jobLevel |
与职位相关的经验水平,例如“初级”。 |
promotionValue |
由客户确定的职位推广值。该值用于确定使用精选招聘信息搜索调用搜索时返回招聘信息的排序顺序,推广值较高的结果会优先返回,其余结果按照相关性排序来返回。仅在 FEATURED_JOB_SEARCH 中返回 promotionValue >0 的招聘信息。 默认值为 0,负值也视为 0。 |
qualifications |
说明任职所需的资格。建议使用此字段作为更通用的 此字段接受 HTML 输入并对其进行清理,也接受粗体、斜体、有序列表和无序列表标记。 允许的最大字符数为 10000。 |
responsibilities |
职位职责描述。建议使用此字段作为更通用的 此字段接受 HTML 输入并对其进行清理,也接受粗体、斜体、有序列表和无序列表标记。 允许的最大字符数为 10000。 |
postingRegion |
提供招聘信息的 |
visibility |
已弃用。只有所有者才能看到该职位。 招聘信息的可见性。 如果未指定,则默认为 |
jobStartTime |
UTC 时区中的职位开始时间戳。通常,此字段用于签订雇用合同。无效时间戳会被忽略。 |
jobEndTime |
职位的结束时间戳。通常,此字段用于签订雇用合同。无效时间戳会被忽略。 |
postingPublishTime |
此招聘信息帖子最近发布的时间戳。默认值为请求到达服务器的时间。无效时间戳会被忽略。 |
postingExpireTime |
强烈建议提供,以获得最佳服务体验。 招聘信息的过期时间戳。在此时间戳之后,招聘信息将被标记为已过期,并且不再显示在搜索结果中。 过期招聘信息会在我们的系统中保留 90 天。但是,过期职位总数不能超过过去 7 天内空缺职位数量上限的 3 倍。如果超出此阈值,系统会按照最早的到期时间顺序清除已过期的作业。清理完毕后,将无法再访问这些过期招聘信息。 无效时间戳将被忽略并视为未提供过期时间。 如果时间戳早于发出即时请求的时间,则作业在创建时会被视为立即过期。无法更新此类作业。在创建具有过去时间戳的作业时,必须在 如果在创建招聘信息时未提供此值或此值无效,则招聘信息帖子将在招聘信息创建 30 天后过期。例如,如果招聘信息的创建时间为 2017/01/01 13:00AM UTC,并且未指定过期日期,则招聘信息将在 2017/01/31 13:00AM UTC 之后过期。 如果更新招聘信息时未提供此值,则其取决于 |
postingCreateTime |
仅限输出。创建招聘信息帖子时的时间戳。 |
postingUpdateTime |
仅限输出。上次更新此招聘信息帖子的时间戳。 |
companyDisplayName |
仅限输出。用于列出招聘信息的公司的显示名。 |
derivedInfo |
仅限输出。有关招聘信息帖子的详细信息。 |
processingOptions |
招聘信息处理选项。 |
ApplicationInfo
招聘信息帖子中与申请相关的详细信息。
JSON 表示法 | |
---|---|
{ "emails": [ string ], "instruction": string, "uris": [ string ] } |
字段 | |
---|---|
emails[] |
使用此字段指定接收简历或申请的电子邮件地址。 每个条目允许的最大字符数为 255。 |
instruction |
使用此字段提供说明,例如“将您的申请发送至…”,以供候选人按照说明申请职位。 此字段接受 HTML 输入并对其进行清理,也接受粗体、斜体、有序列表和无序列表标记。 允许的最大字符数为 3000。 |
uris[] |
使用此 URI 字段引导申请人访问网站,例如转至在线申请表格页面。 每个条目允许的最大字符数为 2000。 |
JobBenefit
表示职位提供的员工福利的枚举。
枚举 | |
---|---|
JOB_BENEFIT_UNSPECIFIED |
如果未指定类型,则使用默认值。 |
CHILD_CARE |
此职位提供儿童看护计划,如日托。 |
DENTAL |
此职位提供牙科保险计划涵盖的牙科服务。 |
DOMESTIC_PARTNER |
此职位为境内合伙人提供特殊福利。 |
FLEXIBLE_HOURS |
此职位允许弹性工作时间。 |
MEDICAL |
此职位提供医疗保险计划涵盖的医疗服务。 |
LIFE_INSURANCE |
此职位提供由雇主提供或可供雇员购买的人寿保险计划。 |
PARENTAL_LEAVE |
此职位允许父母休假照顾新生儿。 |
RETIREMENT_PLAN |
此职位提供由雇主提供或可供雇员购买的退休计划。 |
SICK_DAYS |
此职位提供带薪病假。 |
VACATION |
此职位提供带薪休假。 |
VISION |
此职位提供眼科保险计划涵盖的眼科服务。 |
CompensationInfo
职位薪酬详细信息。
JSON 表示法 | |
---|---|
{ "entries": [ { object ( |
字段 | |
---|---|
entries[] |
职位薪酬信息。 最多只能有一个条目是 |
annualizedBaseCompensationRange |
仅限输出。年度基本薪酬范围。计算方式为基本薪酬条目的 有关年度薪酬的说明,请参阅 |
annualizedTotalCompensationRange |
仅限输出。年度总薪酬范围。计算方式为所有薪酬条目的 有关年度薪酬的说明,请参阅 |
CompensationEntry
用于表示薪酬的一个组成部分的薪酬条目,例如基本工资、奖金或其他薪酬类型。
按年计:如果一个薪酬条目包含有效的 amount
或 range
,则可以按年化。- 并且其 expectedUnitsPerYear
已设置或可以派生。其年化范围为(amount
或 range
)乘以 expectedUnitsPerYear
。
JSON 表示法 | |
---|---|
{ "type": enum ( |
字段 | ||
---|---|---|
type |
薪酬类型。 |
|
unit |
指定金额的支付频率。 |
|
description |
薪酬说明。例如,可以说明股权条款或为预估奖金提供背景信息。 |
|
expectedUnitsPerYear |
预计每年支付薪酬的单位数量。如果未指定,当 |
|
联合字段 compensation_amount 。薪酬金额。可以是固定金额,也可以是浮动范围。compensation_amount 只能是下列其中一项: |
||
amount |
薪酬金额。 |
|
range |
薪酬范围。 |
CompensationType
薪酬类型。
对于以非货币金额指定的薪酬金额,请在 CompensationEntry.description
中说明薪酬方案。
例如,CompensationEntry.description
中说明了小费格式(例如,“根据客户账单,预计可获得 15-20% 的小费”)。CompensationEntry.amount
或 CompensationEntry.range
中提供的小费估算值(每小时 10 美元)。
例如,CompensationEntry.description
对股权进行了说明(例如,“4 年 1% - 2% 的股权投资,1 年悬崖”),估计价值使用 CompensationEntry.amount
或 CompensationEntry.range
。如果无法估算价值,则单位为 CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED
,然后在 CompensationEntry.description
字段中进一步说明。
枚举 | |
---|---|
COMPENSATION_TYPE_UNSPECIFIED |
默认值。 |
BASE |
基本薪酬:指雇主向雇员支付,作为其工作回报的固定金额。基本薪酬不包括福利、奖金或雇主的任何其他潜在薪酬。 |
BONUS |
奖金。 |
SIGNING_BONUS |
签约奖金。 |
EQUITY |
股权。 |
PROFIT_SHARING |
分红。 |
COMMISSIONS |
佣金。 |
TIPS |
小费。 |
OTHER_COMPENSATION_TYPE |
其他薪酬类型。 |
CompensationUnit
支付频率。
枚举 | |
---|---|
COMPENSATION_UNIT_UNSPECIFIED |
默认值。 |
HOURLY |
按小时。 |
DAILY |
按天。 |
WEEKLY |
按周。 |
MONTHLY |
按月。 |
YEARLY |
按年。 |
ONE_TIME |
一次性。 |
OTHER_COMPENSATION_UNIT |
其他薪酬单位。 |
Money
表示含有货币类型的金额。
JSON 表示法 | |
---|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
字段 | |
---|---|
currencyCode |
ISO 4217 中定义的由三个字母组成的货币代码。 |
units |
金额的整数单位。例如,如果 |
nanos |
金额的纳诺 (10^-9) 单位数。这个值必须在 -999999999(含)和 +999999999(含)之间。如果 |
CompensationRange
薪酬范围。
JSON 表示法 | |
---|---|
{ "maxCompensation": { object ( |
字段 | |
---|---|
maxCompensation |
最高薪酬金额。如果留空,则将其值设置为最大薪酬值,并将货币代码设置为与 minCompensation 的 |
minCompensation |
最低薪酬金额。如果留空,则将其值设置为零,并将货币代码设置为与 maxCompensation 的 |
DegreeType
国际教育标准分类法 (ISCED) 中定义的教育层次。
枚举 | |
---|---|
DEGREE_TYPE_UNSPECIFIED |
默认值。代表没有学位或学前教育。划分为 ISCED 0 级。例如幼儿园教育 |
PRIMARY_EDUCATION |
初等教育通常是义务教育的第一阶段。划分为 ISCED 1 级。例如小学教育 |
LOWER_SECONDARY_EDUCATION |
初级中等教育;中等教育的第一阶段,以初等教育为基础,通常教授更加面向学科的课程。划分为 ISCED 2 级。例如初中教育 |
UPPER_SECONDARY_EDUCATION |
高级中等教育;中等教育的第二/最后阶段,为高等教育做准备,和/或教授与就业相关的技能。教育科目范围和方向通常较广。划分为 ISCED 3 级。例如高中教育 |
ADULT_REMEDIAL_EDUCATION |
成人补习教育;提供以中等教育为基础的学习经验,并为进入劳动力市场和/或进行高等教育做好准备。教育内容比中等教育更广泛,但不像高等教育那么复杂。划分为 ISCED 4 级。 |
ASSOCIATES_OR_EQUIVALENT |
短线高等教育;短线高等教育课程通常基于实用和职定职业,培养学生进入劳动力市场。这些课程也能提供一条通向其他高等教育课程的途径。划分为 ISCED 5 级。 |
BACHELORS_OR_EQUIVALENT |
学士或同等学历;通常为参加者提供中等程度的学术和/或专业知识、技能和能力,使其获得第一学位或同等资格证书。划分为 ISCED 6 级。 |
MASTERS_OR_EQUIVALENT |
硕士或同等学历;通常为参加者提供高等程度的学术和/或专业知识、技能和能力,使其获得第二学位或同等资格证书。划分为 ISCED 7 级。 |
DOCTORAL_OR_EQUIVALENT |
博士或同等学历;主要为获得高级研究资格而设置,通常提交并答辩一篇对各自研究领域的知识有重要贡献的论文或具有发表质量的书面作品。划分为 ISCED 8 级。 |
EmploymentType
表示职位工作性质的枚举。
枚举 | |
---|---|
EMPLOYMENT_TYPE_UNSPECIFIED |
如果未指定工作性质,则为默认值。 |
FULL_TIME |
该职位为全职工作,通常要求每周工作 40 小时或以上。 |
PART_TIME |
该职位为兼职工作,要求的工作时间少于全职工作,通常每周不超过 40 小时。 |
CONTRACTOR |
该职位为合同工,非受薪正式雇员。 |
CONTRACT_TO_HIRE |
该职位为合同工,但在合同期满后将转为全职职位。搜索 EmploymentType.CONTRACTOR 招聘信息也会返回此类型的招聘信息。 |
TEMPORARY |
该职位为临时工,通常为短期雇用。 |
INTERN |
该职位为实习生,是学生或初级求职者获得在职培训的定期机会,通常在夏季提供。 |
VOLUNTEER |
该职位为志愿者,不提供任何薪酬。 |
PER_DIEM |
该职位要求员工按照弹性时间表根据需要工作。 |
FLY_IN_FLY_OUT |
该职位雇用偏远地区的人员并安排他们前往工作地点临时工作,而非永久安置员工及其家属。 |
OTHER_EMPLOYMENT_TYPE |
该职位不属于任何列出的类型。 |
JobLevel
表示职位所需经验水平的枚举。
枚举 | |
---|---|
JOB_LEVEL_UNSPECIFIED |
如果未指定经验水平,则为默认值。 |
ENTRY_LEVEL |
初级员工,通常具有 2 年以下的类似职位工作经验。包括实习生。 |
EXPERIENCED |
经验丰富的员工,通常具有 2 年以上类似职位工作经验。 |
MANAGER |
负责管理员工团队的初级/中级管理人员。 |
DIRECTOR |
负责管理经理团队的高级管理人员。 |
EXECUTIVE |
执行层及以上管理人员,包括高管层职位。 |
PostingRegion
表示招聘信息帖子地区的枚举。在大多数情况下,招聘信息帖子不需要指定地区。如果给定了地区,则招聘信息可以在指定地区中搜索到。
枚举 | |
---|---|
POSTING_REGION_UNSPECIFIED |
如果未指定区域,则仅在作业与 LocationFilter 匹配时才会返回。 |
ADMINISTRATIVE_AREA |
除了精确地点匹配之外,当搜索查询中的 行政区是指一个国家/地区的顶级行政区划。例如,美国的“州”、意大利的“区”、英国的“构成国”和日本的“都”。 |
NATION |
除了精确地点匹配之外,当搜索查询中的 LocationFilter 与此招聘信息位于同一个国家/地区时,将返回该招聘信息。例如,如果设为 NATION_WIDE 的招聘信息在“USA”中发布,则当 LocationFilter 包含“Mountain View”时将返回该招聘信息。 |
TELECOMMUTE |
此职位允许员工远程工作(远程办公)。如果同时提供了营业地点和此值,则该职位被视为具有营业地点,但允许远程办公。 |
视觉障碍
已弃用。只有所有者才能看到所有资源。
表示具有此资源的查看访问权限的枚举。
枚举 | |
---|---|
VISIBILITY_UNSPECIFIED |
默认值。 |
ACCOUNT_ONLY |
此资源仅对拥有它的 GCP 账号可见。 |
SHARED_WITH_GOOGLE |
此资源对所有者可见,并且可能对 Google 的其他应用和进程可见。 |
SHARED_WITH_PUBLIC |
此资源对所有者可见,并且可能对所有其他 API 客户端可见。 |
DerivedInfo
有关招聘信息帖子的详细信息。
JSON 表示法 | |
---|---|
{ "locations": [ { object ( |
字段 | |
---|---|
locations[] |
招聘信息的结构化地点,解析自
|
jobCategories[] |
派生自 |
JobCategory
表示特定角色的分类或主要焦点的枚举。此值和与角色关联的“行业”不同,后者与列出招聘信息的公司的分类相关。
枚举 | |
---|---|
JOB_CATEGORY_UNSPECIFIED |
如果未指定类别,则为默认值。 |
ACCOUNTING_AND_FINANCE |
会计和财务职位,如会计师。 |
ADMINISTRATIVE_AND_OFFICE |
行政和办公室职位,如行政助理。 |
ADVERTISING_AND_MARKETING |
广告和营销职位,如营销经理。 |
ANIMAL_CARE |
动物护理职位,如兽医。 |
ART_FASHION_AND_DESIGN |
艺术、时尚或设计职位,如设计师。 |
BUSINESS_OPERATIONS |
企业运营职位,如企业运营经理。 |
CLEANING_AND_FACILITIES |
清洁和工具设施职位,如保管人员。 |
COMPUTER_AND_IT |
计算机和 IT 职位,如系统管理员。 |
CONSTRUCTION |
建筑职位,如普通工人。 |
CUSTOMER_SERVICE |
客户服务职位,如收银员。 |
EDUCATION |
教育职位,如学校教师。 |
ENTERTAINMENT_AND_TRAVEL |
娱乐和旅行职位,如空乘人员。 |
FARMING_AND_OUTDOORS |
农业或户外职位,如护林员。 |
HEALTHCARE |
医疗保健职位,如注册护士。 |
HUMAN_RESOURCES |
人力资源职位,如人力资源主管。 |
INSTALLATION_MAINTENANCE_AND_REPAIR |
安装、维护或维修职位,如电工。 |
LEGAL |
法律职位,如法律文员。 |
MANAGEMENT |
管理职位,通常与其他类别一起使用,如商店经理。 |
MANUFACTURING_AND_WAREHOUSE |
制造或仓库职位,如装配技师。 |
MEDIA_COMMUNICATIONS_AND_WRITING |
媒体、通信或写作职位,如媒体关系负责人。 |
OIL_GAS_AND_MINING |
石油、天然气或采矿职位,如海上钻井人员。 |
PERSONAL_CARE_AND_SERVICES |
个人护理和服务职位,如发型师。 |
PROTECTIVE_SERVICES |
安保服务职位,如保安。 |
REAL_ESTATE |
房地产职位,如房地产代理人。 |
RESTAURANT_AND_HOSPITALITY |
餐厅和服务职位,如餐厅服务员。 |
SALES_AND_RETAIL |
销售和/或零售职位,如销售助理。 |
SCIENCE_AND_ENGINEERING |
科学和工程职位,如实验室技术员。 |
SOCIAL_SERVICES_AND_NON_PROFIT |
社会服务或非营利性职位,如社会工作者。 |
SPORTS_FITNESS_AND_RECREATION |
体育、健身或休闲娱乐职位,如私人教练。 |
TRANSPORTATION_AND_LOGISTICS |
运输或物流职位,如卡车司机。 |
ProcessingOptions
招聘信息处理选项。
JSON 表示法 | |
---|---|
{
"disableStreetAddressResolution": boolean,
"htmlSanitization": enum ( |
字段 | |
---|---|
disableStreetAddressResolution |
如果设置为 |
htmlSanitization |
招聘信息 HTML 内容清理选项。适用字段如下:
如果未停用清理,则可能会清理掉这些字段中的 HTML 标记。 |
HtmlSanitization
用户输入字段上的 HTML 内容清理选项,例如职位描述。通过设置此选项,用户可以确定是否以及如何对这些字段执行清理。
枚举 | |
---|---|
HTML_SANITIZATION_UNSPECIFIED |
默认值。 |
HTML_SANITIZATION_DISABLED |
停用 HTML 输入清理。 |
SIMPLE_FORMATTING_ONLY |
清理 HTML 输入,仅接受粗体、斜体、有序列表和无序列表标记。 |
方法 |
|
---|---|
|
开始执行批量创建作业操作。 |
|
根据过滤条件删除 Job 列表。 |
|
开始执行批量更新作业操作。 |
|
创建新的招聘信息。 |
|
删除指定的招聘信息。 |
|
检索过去 90 天内状态为“公开”或最近“过期”的指定招聘信息。 |
|
按过滤条件列出招聘信息。 |
|
更新指定的招聘信息。 |
|
使用提供的 SearchJobsRequest 搜索招聘信息。 |
|
使用提供的 SearchJobsRequest 搜索招聘信息。 |