Package google.cloud.talent.v4beta1

索引

• CompanyService（接口）
• Completion（接口）
• EventService（接口）
• JobService（接口）
• TenantService（接口）
• BatchCreateJobsRequest（消息）
• BatchDeleteJobsRequest（消息）
• BatchOperationMetadata（消息）
• BatchOperationMetadata.State（枚举）
• BatchUpdateJobsRequest（消息）
• ClientEvent（消息）
• CommuteFilter（消息）
• CommuteFilter.RoadTraffic（枚举）
• CommuteMethod（枚举）
• Company（消息）
• Company.DerivedInfo（消息）
• CompanySize（枚举）
• CompensationFilter（消息）
• CompensationFilter.FilterType（枚举）
• CompensationInfo（消息）
• CompensationInfo.CompensationEntry（消息）
• CompensationInfo.CompensationRange（消息）
• CompensationInfo.CompensationType（枚举）
• CompensationInfo.CompensationUnit（枚举）
• CompleteQueryRequest（消息）
• CompleteQueryRequest.CompletionScope（枚举）
• CompleteQueryRequest.CompletionType（枚举）
• CompleteQueryResponse（消息）
• CompleteQueryResponse.CompletionResult（消息）
• CreateClientEventRequest（消息）
• CreateCompanyRequest（消息）
• CreateJobRequest（消息）
• CreateTenantRequest（消息）
• CustomAttribute（消息）
• DegreeType（枚举）
• DeleteCompanyRequest（消息）
• DeleteJobRequest（消息）
• DeleteTenantRequest（消息）
• DeviceInfo（消息）
• DeviceInfo.DeviceType（枚举）
• EmploymentType（枚举）
• GetCompanyRequest（消息）
• GetJobRequest（消息）
• GetTenantRequest（消息）
• HistogramQuery（消息）
• HistogramQueryResult（消息）
• HtmlSanitization（枚举）
• Job（消息）
• Job.ApplicationInfo（消息）
• Job.DerivedInfo（消息）
• Job.ProcessingOptions（消息）
• JobBenefit（枚举）
• JobCategory（枚举）
• JobEvent（消息）
• JobEvent.JobEventType（枚举）
• JobLevel（枚举）
• JobOperationResult（消息）
• JobOperationResult.JobResult（消息）
• JobQuery（消息）
• JobView（枚举）
• ListCompaniesRequest（消息）
• ListCompaniesResponse（消息）
• ListJobsRequest（消息）
• ListJobsResponse（消息）
• ListTenantsRequest（消息）
• ListTenantsResponse（消息）
• Location（消息）
• Location.LocationType（枚举）
• LocationFilter（消息）
• LocationFilter.TelecommutePreference（枚举）
• PostingRegion（枚举）
• RequestMetadata（消息）
• ResponseMetadata（消息）
• SearchJobsRequest（消息）
• SearchJobsRequest.CustomRankingInfo（消息）
• SearchJobsRequest.CustomRankingInfo.ImportanceLevel（枚举）
• SearchJobsRequest.DiversificationLevel（枚举）
• SearchJobsRequest.SearchMode（枚举）
• SearchJobsResponse（消息）
• SearchJobsResponse.CommuteInfo（消息）
• SearchJobsResponse.MatchingJob（消息）
• SpellingCorrection（消息）
• Tenant（消息）
• Tenant.DataUsageType（枚举）
• TimestampRange（消息）
• UpdateCompanyRequest（消息）
• UpdateJobRequest（消息）
• UpdateTenantRequest（消息）
• Visibility（枚举）（已弃用）

CompanyService

一项用于处理公司管理（包括 CRUD 和枚举）的服务。

CreateCompany
rpc CreateCompany(CreateCompanyRequest) returns (Company) 创建新的公司实体。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

DeleteCompany
rpc DeleteCompany(DeleteCompanyRequest) returns (Empty) 删除指定的公司。前提条件：该公司没有关联的招聘信息。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GetCompany
rpc GetCompany(GetCompanyRequest) returns (Company) 检索指定的公司。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

ListCompanies
rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse) 列出与项目关联的所有公司。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

UpdateCompany
rpc UpdateCompany(UpdateCompanyRequest) returns (Company) 更新指定的公司。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

完成

服务会处理自动完成。

CompleteQuery
rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse) 使用关键字建议补全指定的前缀。用于招聘信息搜索自动补全搜索框。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

EventService

服务处理客户端事件报告。

CreateClientEvent
rpc CreateClientEvent(CreateClientEventRequest) returns (ClientEvent) 报告最终用户与使用 Cloud Talent Solution 的客户应用交互时发出的事件。您可以在自助服务工具中检查创建的事件。详细了解自助服务工具。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

JobService

服务用于处理作业管理，包括作业 CRUD、枚举和搜索。

BatchCreateJobs
rpc BatchCreateJobs(BatchCreateJobsRequest) returns (Operation) 开始执行批量创建作业操作。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

BatchDeleteJobs
rpc BatchDeleteJobs(BatchDeleteJobsRequest) returns (Empty) 根据过滤条件删除 Job 列表。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

BatchUpdateJobs
rpc BatchUpdateJobs(BatchUpdateJobsRequest) returns (Operation) 开始执行批量更新作业操作。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

CreateJob
rpc CreateJob(CreateJobRequest) returns (Job) 创建新的招聘信息。 通常，招聘信息可在 10 秒内搜索到，最长则可能需要 5 分钟。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

DeleteJob
rpc DeleteJob(DeleteJobRequest) returns (Empty) 删除指定的招聘信息。 通常，招聘信息在 10 秒内会变得无法搜索，最长则可能需要 5 分钟。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GetJob
rpc GetJob(GetJobRequest) returns (Job) 检索过去 90 天内状态为“公开”或最近“过期”的指定招聘信息。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

ListJobs
rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) 按过滤条件列出招聘信息。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

SearchJobs
rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse) 使用提供的 SearchJobsRequest 搜索招聘信息。 此调用会限制数据库中存在的招聘信息的 visibility，并仅返回调用者有权搜索的招聘信息。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

SearchJobsForAlert
rpc SearchJobsForAlert(SearchJobsRequest) returns (SearchJobsResponse) 使用提供的 SearchJobsRequest 搜索招聘信息。 此 API 调用主要用于针对被动求职者（例如，已注册并同意接收有关潜在工作机会的电子邮件提醒的求职者）的使用场景，并针对被动求职者进行不同的算法调整。 此调用会限制数据库中存在的招聘信息的 visibility，并仅返回调用者有权搜索的招聘信息。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

UpdateJob
rpc UpdateJob(UpdateJobRequest) returns (Job) 更新指定的招聘信息。 通常，更新的内容会在 10 秒内在搜索结果中展示，最长则可能需要 5 分钟。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

TenantService

一项用于处理租户管理（包括 CRUD 和枚举）的服务。

CreateTenant
rpc CreateTenant(CreateTenantRequest) returns (Tenant) 创建新的租户实体。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

DeleteTenant
rpc DeleteTenant(DeleteTenantRequest) returns (Empty) 删除指定的租户。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GetTenant
rpc GetTenant(GetTenantRequest) returns (Tenant) 检索指定的租户。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

ListTenants
rpc ListTenants(ListTenantsRequest) returns (ListTenantsResponse) 列出与项目关联的所有租户。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

UpdateTenant
rpc UpdateTenant(UpdateTenantRequest) returns (Tenant) 更新指定的租户。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/jobs https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

BatchCreateJobsRequest

请求创建批量作业。

字段
parent	string 必需。创建作业的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”。例如“projects/foo/tenant/bar”。如果未指定租户 ID，则系统会创建默认租户。例如“projects/foo”。
jobs[]	Job 必需。要创建的作业。

BatchDeleteJobsRequest

批量删除招聘信息请求。

字段
parent	string 必需。创建作业的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”。例如“projects/foo/tenant/bar”。如果未指定租户 ID，则系统会创建默认租户。例如“projects/foo”。
filter	string 必需。指定要删除的招聘信息的过滤字符串。 支持的运算符：=、AND 可用于过滤的字段包括： companyName（必需） requisitionId（必需） 示例查询：companyName = "projects/foo/companies/bar" AND requisitionId = "req-1"

BatchOperationMetadata

用于由 CTS 批处理 API 返回的长时间运行的操作的元数据。它用于替换 google.longrunning.Operation.metadata。

字段
state	State 长时间运行的操作的状态。
state_description	string 有关操作状态的更多详细信息。
success_count	int32 操作中成功项的计数。
failure_count	int32 操作中失败项的计数。
total_count	int32 操作中项总数。
create_time	Timestamp 创建批量操作的时间。
update_time	Timestamp 批量操作状态更新的时间。元数据和 update_time 每分钟刷新一次，否则会返回缓存的数据。
end_time	Timestamp 批量操作完成且 google.longrunning.Operation.done 设置为 true 的时间。

状态

枚举
STATE_UNSPECIFIED	默认值。
INITIALIZING	正在准备批处理操作。
PROCESSING	系统正在处理批量操作。
SUCCEEDED	批量操作已处理，至少一项已成功处理。
FAILED	批量操作已完成，未成功处理任何项。
CANCELLING	调用 google.longrunning.Operations.CancelOperation 后，批量操作正在取消。
CANCELLED	批量操作在调用 google.longrunning.Operations.CancelOperation 后完成。系统会在响应中返回在取消前处理的所有商品。

BatchUpdateJobsRequest

请求更新批量作业。

字段
parent	string 必需。创建作业的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”。例如“projects/foo/tenant/bar”。如果未指定租户 ID，则系统会创建默认租户。例如“projects/foo”。
jobs[]	Job 必需。要更新的作业。
update_mask	FieldMask 强烈建议提供，以获得最佳服务体验。请注意，在检查批量操作的状态时，这也会增加延迟时间。 如果提供了 update_mask，则仅更新 Job 中的指定字段。否则更新所有字段。 限制被更新字段的字段掩码。仅支持 Job 的顶级字段。 如果提供了 update_mask，则 JobResult 内的 Job 将仅包含已更新的字段，以及 Job 的 ID。否则，Job 将包含所有字段，这可能会产生非常大的响应。

ClientEvent

最终用户与使用 Cloud Talent Solution 的应用交互时发出的事件。提供此信息可提高 API 客户端的结果质量，使服务能够以最佳方式运行。发送的事件数必须与客户端向服务发出的其他调用（例如招聘信息搜索）的数量一致。

字段
request_id	string 强烈建议提供，以获得最佳服务体验。 API 响应中生成的唯一 ID。可以在 ResponseMetadata.request_id 中找到。
event_id	string 必需。客户端应用生成的唯一标识符。
create_time	Timestamp 必需。事件的时间戳。
event_notes	string 有关为招聘人员或其他用户提供的活动的说明，例如，有关为个人资料添加书签的原因的反馈。
job_event	JobEvent 求职者与使用 Cloud Talent Solution 的应用交互时发出的事件。

CommuteFilter

通勤搜索所需的参数。

字段
commute_method	CommuteMethod 必需。用于计算通勤时间的交通方法。
start_coordinates	LatLng 必需。用于计算通勤时间的营业地点的纬度和经度。
travel_duration	Duration 必需。最长行程时间，以秒为单位。允许的最大值为 3600s（1 小时）。格式为 123s。
allow_imprecise_addresses	bool 如果为 true，则也可以返回不含街道级别地址的招聘信息。对于城市级别地址，使用市中心。对于州级别和简略地址，使用文本匹配。如果此字段设置为 false 或未指定，则通勤时间搜索仅返回包含街道级别地址的招聘信息。
联合字段 traffic_option。通过通勤搜索时要考虑的交通因素。traffic_option 只能是下列其中一项：
road_traffic	RoadTraffic 指定计算通勤时间时要使用的车流密度。
departure_time	TimeOfDay 用于计算交通影响的出发时间，以当地时区的 google.type.TimeOfDay 表示。 目前，交通模型仅限于小时级别的精确度。

RoadTraffic

计算通勤时间时要使用的交通密度。

枚举
ROAD_TRAFFIC_UNSPECIFIED	未指定道路交通情况。
TRAFFIC_FREE	不考虑任何交通影响的最优通勤时间。
BUSY_HOUR	考虑了交通高峰期影响的通勤时间。

CommuteMethod

通勤方法。

枚举
COMMUTE_METHOD_UNSPECIFIED	未指定通勤方法。
DRIVING	通勤时间根据驾驶时间计算。
TRANSIT	通勤时间根据公交线路（包括公交车、地铁、地铁等）计算得出。
WALKING	通勤时间根据步行时间计算。
CYCLING	通勤时间根据骑行时间计算。

公司

公司资源表示正常运营的公司。公司是拥有招聘信息帖子的实体，即负责雇用职位申请人的招聘单位。

字段
name	string 更新公司时必须填写。 公司的资源名称。此名称是在创建公司时由服务生成的。 格式为“projects/{project_id}/tenants/{tenant_id}/companies/{company_id}”，例如“projects/foo/tenants/bar/companies/baz”。 如果未指定租户 ID，则使用默认租户。例如“projects/foo/companies/bar”。
display_name	string 必需。公司的显示名称，例如“Google LLC”。
external_id	string 必需。客户端公司标识符，用于唯一标识公司。 允许的最大字符数为 255。
size	CompanySize 雇主的公司规模。
headquarters_address	string 公司总部的街道地址，可能与工作地点不同。该服务会尝试对提供的地址进行地理定位，并尽可能在 DerivedInfo.headquarters_location 中填充更具体的位置。
hiring_agency	bool 如果是为其他雇主发布职位的招聘代理机构，则设置为 true。 如果未提供，则默认为 false。
eeo_text	string 与所有招聘信息关联的平等就业机会法律免责声明文本，通常显示在所有角色中。 允许的最大字符数为 500。
website_uri	string 该 URI 表示公司主要网站或主页的网址，例如“https://www.google.com”。 允许的最大字符数为 255。
career_site_uri	string 该 URI 表示雇主招聘网站或雇主网站上的招聘页面的网址，例如“https://careers.google.com”。
image_uri	string 托管雇主公司徽标的 URI。
keyword_searchable_job_custom_attributes[]	string 可过滤 Job.custom_attributes 的键列表，其对应的 string_values 用于关键字搜索。如果有任何值与搜索关键字匹配，则返回这些指定字段键下具有 string_values 的职位。带圆括号、方括号和特殊符号的自定义字段值不能按原样搜索，这些关键字查询必须用引号括起来。
derived_info	DerivedInfo 仅限输出。有关公司的衍生详细信息。
suspended	bool 仅限输出。当公司招聘信息的内容显示为可疑、滥用或垃圾内容时，指示该公司是否被服务标记为暂停向公众开放。

DerivedInfo

有关公司的衍生详细信息。

字段
headquarters_location	Location 公司的结构化总部地点，从 Company.headquarters_address 解析（如果提供）。

CompanySize

表示公司规模的枚举。

枚举
COMPANY_SIZE_UNSPECIFIED	如果未指定规模，则使用默认值。
MINI	该公司员工不足 50 人。
SMALL	该公司拥有 50 至 99 名员工。
SMEDIUM	该公司拥有 100 至 499 名员工。
MEDIUM	该公司拥有 500 至 999 名员工。
BIG	该公司拥有 1000 至 4999 名员工。
BIGGER	该公司拥有 5000 至 9999 名员工。
GIANT	该公司拥有 10000 或更多名员工。

CompensationFilter

过滤职位薪酬类型和金额。

字段
type	FilterType 必需。过滤器类型。
units[]	CompensationUnit 必需。指定所需的 base compensation entry's CompensationInfo.CompensationUnit。
range	CompensationRange 薪酬范围。
include_jobs_with_unspecified_compensation_range	bool 如果设置为 true，则会包含未指定薪酬范围字段的职位。

FilterType

指定过滤类型。

枚举
FILTER_TYPE_UNSPECIFIED	过滤器类型未指定。不应使用 INVALID 职位。
UNIT_ONLY	按base compensation entry's单位过滤。当且仅当招聘信息包含基本 CompensationEntry 并且基本 CompensationEntry 的单位与提供的 units 匹配时，该招聘信息才是匹配项。填充一个或多个 units。 如需了解基本薪酬条目的定义，请参阅 CompensationInfo.CompensationEntry。
UNIT_AND_AMOUNT	按base compensation entry's单位和金额 / 范围过滤。当且仅当招聘信息包含基本 CompensationEntry，并且基本条目的单位与提供的 CompensationUnit 匹配，并且数量或范围与提供的 CompensationRange 重叠时，该招聘信息才是匹配项。 如需了解基本薪酬条目的定义，请参阅 CompensationInfo.CompensationEntry。 请仅设置一个 units 并填充 range。
ANNUALIZED_BASE_AMOUNT	按年度基本薪酬金额和 base compensation entry's 单位过滤。填充 range 以及零个或多个 units。
ANNUALIZED_TOTAL_AMOUNT	按年度总薪酬金额和 base compensation entry's 单位过滤。填充 range 以及零个或多个 units。

CompensationInfo

职位薪酬详细信息。

字段
entries[]	CompensationEntry 职位薪酬信息。 最多只能有一个条目是 CompensationInfo.CompensationType.BASE 类型，称为职位的基本薪酬条目。
annualized_base_compensation_range	CompensationRange 仅限输出。年度基本薪酬范围。计算方式为基本薪酬条目的 CompensationEntry.amount 乘以 CompensationEntry.expected_units_per_year。 有关年度薪酬的说明，请参阅 CompensationEntry。
annualized_total_compensation_range	CompensationRange 仅限输出。年度总薪酬范围。计算方式为所有薪酬条目的 CompensationEntry.amount 乘以 CompensationEntry.expected_units_per_year。 有关年度薪酬的说明，请参阅 CompensationEntry。

CompensationEntry

用于表示薪酬的一个组成部分的薪酬条目，例如基本工资、奖金或其他薪酬类型。

按年计：如果一个薪酬条目包含有效的 amount 或 range，则可以按年化。- 并且其 expected_units_per_year 已设置或可以派生。其年化范围为（amount 或 range）乘以 expected_units_per_year。

字段
type	CompensationType 薪酬类型。 默认值为 CompensationType.COMPENSATION_TYPE_UNSPECIFIED。
unit	CompensationUnit 指定金额的支付频率。 默认值为 CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED。
description	string 薪酬说明。例如，可以说明股权条款或为预估奖金提供背景信息。
expected_units_per_year	DoubleValue 预计每年支付薪酬的单位数量。如果未指定，当 Job.employment_types 为 FULLTIME 时，系统会根据 unit 推断默认值。默认值包括：按小时：2080；按天：260；按周：52；按月：12；按年：1
联合字段 compensation_amount。薪酬金额。可以是固定金额，也可以是浮动范围。compensation_amount 只能是下列其中一项：
amount	Money 薪酬金额。
range	CompensationRange 薪酬范围。

CompensationRange

薪酬范围。

字段
max_compensation	Money 最高薪酬金额。如果留空，则将其值设置为最大薪酬值，并将货币代码设置为与 min_解决办法的 currency code 匹配。
min_compensation	Money 最低薪酬金额。如果留空，则将其值设置为 0，并将货币代码设置为与 max_撞击的 currency code 匹配。

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	其他薪酬单位。

CompleteQueryRequest

自动填充参数。

字段
parent	string 必需。在其中执行补全的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”，例如“projects/foo/tenant/bar”。 如果未指定租户 ID，则系统会使用默认租户，例如“projects/foo”。
query	string 必需。用于生成建议的查询。 允许的最大字符数为 255。
language_codes[]	string 查询的语言列表。此字段为 BCP-47 语言代码，例如“en-US”或“sr-Latn”。如需了解详情，请参阅标识语言的标记。 允许的最大字符数为 255。
page_size	int32 必需。填充结果计数。 允许的最大页面大小为 10。
company	string 如果提供，则限制填充指定公司的信息。 格式为“projects/{project_id}/tenants/{tenant_id}/companies/{company_id}”，例如“projects/foo/tenants/bar/companies/baz”。 如果未指定租户 ID，则系统会使用默认租户，例如“projects/foo”。
scope	CompletionScope 填充范围。默认值为 CompletionScope.PUBLIC。
type	CompletionType 填充主题。默认值为 CompletionType.COMBINED。

CompletionScope

枚举以指定填充的范围。

枚举
COMPLETION_SCOPE_UNSPECIFIED	默认值。
TENANT	建议仅以客户提供的数据为基础。
PUBLIC	建议以系统中客户可见的所有招聘信息数据为基础。

CompletionType

枚举以指定自动填充主题。

枚举
COMPLETION_TYPE_UNSPECIFIED	默认值。
JOB_TITLE	自动填充职位建议。 对于 CompletionType.JOB_TITLE 类型，仅返回具有相同 language_codes 的公开招聘信息。
COMPANY_NAME	为招聘信息自动补全功能建议公司名称。 对于 CompletionType.COMPANY_NAME 类型，仅返回具有相同 language_codes 的公开招聘信息的公司。
COMBINED	为职位自动补全功能建议职位和公司名称。 对于 CompletionType.COMBINED 类型，系统仅返回具有相同 language_codes 的公开招聘信息，或返回具有相同 language_codes 的公开招聘信息。

CompleteQueryResponse

自动填充查询的响应。

字段
completion_results[]	CompletionResult 匹配的职位/公司候选人的结果。
metadata	ResponseMetadata API 调用的其他信息，例如请求跟踪 ID。

CompletionResult

表示填充结果的资源。

字段
suggestion	string 查询的建议。
type	CompletionType 补全主题。
image_uri	string COMPANY_NAME 的公司图片 URI。

CreateClientEventRequest

报告事件请求。

字段
parent	string 必需。创建事件的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”，例如“projects/foo/tenant/bar”。如果未指定租户 ID，则系统会创建默认租户，例如“projects/foo”。
client_event	ClientEvent 必需。最终用户与使用 Cloud Talent Solution 的客户应用交互时发出的事件。

CreateCompanyRequest

CreateCompany 方法的请求。

字段
parent	string 必需。创建公司的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”，例如“projects/foo/tenant/bar”。如果未指定租户 ID，则系统会创建默认租户，例如“projects/foo”。
company	Company 必需。要创建的公司。

CreateJobRequest

创建招聘信息的请求。

字段
parent	string 必需。创建作业的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”。例如“projects/foo/tenant/bar”。如果未指定租户 ID，则系统会创建默认租户。例如“projects/foo”。
job	Job 必需。要创建的招聘信息。

CreateTenantRequest

CreateTenant 方法的请求。

字段
parent	string 必需。在其下创建租户的项目的资源名称。 该名称采用“projects/{project_id}”格式，例如“projects/foo”。
tenant	Tenant 必需。要创建的租户。

CustomAttribute

可过滤或不可过滤的自定义属性值。

字段
string_values[]	string 必须指定 string_values 和 long_values 中的一个。 该字段用于执行字符串匹配（CASE_SENSITIVE_MATCH 或 CASE_INSENSITIVE_MATCH）搜索。对于可过滤的 string_value，总共最多允许 200 个值，每个 string_value 的字节大小不超过 500B。对于不可过滤的 string_values，不可过滤的 string_values 的最大总字节大小为 50KB。 不允许出现空字符串。
long_values[]	int64 必须指定 string_values 和 long_values 中的一个。 该字段用于执行数字范围搜索。通过可过滤的 long_value 使用（EQ、GT、GE、LE、LT）。 目前最多支持 1 个 long_values。
filterable	bool 如果 filterable 标志为 true，自定义字段值可以用于自定义属性过滤条件 JobQuery.custom_attribute_filter。如果为 false，这些值可能不会用于自定义属性过滤条件。 默认值为 false。
keyword_searchable	bool 如果 keyword_searchable 标志为 true，则可以通过关键字匹配搜索自定义字段中的关键字。如果为 false，这些值将无法按关键字匹配搜索。 默认值为 false。

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 级。

DeleteCompanyRequest

删除公司的请求。

字段
name	string 必需。要删除的公司的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}/companies/{company_id}”，例如“projects/foo/tenants/bar/companies/baz”。 如果未指定租户 ID，则系统会使用默认租户，例如“projects/foo/companies/bar”。

DeleteJobRequest

删除招聘信息的请求。

字段
name	string 必需。要删除的招聘信息的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}”。例如“projects/foo/tenants/bar/jobs/baz”。 如果未指定租户 ID，则使用默认租户。例如“projects/foo/jobs/bar”。

DeleteTenantRequest

请求删除租户。

字段
name	string 必需。要删除的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”，例如“projects/foo/tenants/bar”。

DeviceInfo

从求职者、候选人或执行职位搜索的其他实体收集到的设备信息。提供此信息可提高跨设备的搜索结果的质量。

字段
device_type	DeviceType 设备类型。
id	string 设备专属 ID。ID 必须是可将该设备与其他设备区分开的唯一标识符。

DeviceType

描述 API 访问门户和曝光机制的枚举。

枚举
DEVICE_TYPE_UNSPECIFIED	未指定设备类型。
WEB	桌面版网络浏览器，例如 Chrome、Firefox、Safari 或 Internet Explorer。
MOBILE_WEB	移动设备网络浏览器，例如带有 Chrome 浏览器的手机或平板电脑。
ANDROID	Android 设备原生应用。
IOS	iOS 设备原生应用。
BOT	机器人程序，而不是由人类操作的设备，例如网页抓取工具。
OTHER	其他设备类型。

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	该职位不属于任何列出的类型。

GetCompanyRequest

按名称获取公司信息的请求。

字段
name	string 必需。要检索的公司的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}/companies/{company_id}”，例如“projects/api-test-project/tenants/foo/companies/bar”。 如果未指定租户 ID，则使用默认租户，例如“projects/api-test-project/companies/bar”。

GetJobRequest

获取招聘信息的请求。

字段
name	string 必需。要检索的招聘信息的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}”。例如“projects/foo/tenants/bar/jobs/baz”。 如果未指定租户 ID，则使用默认租户。例如“projects/foo/jobs/bar”。

GetTenantRequest

按名称获取租户的请求。

字段
name	string 必需。要检索的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”，例如“projects/foo/tenants/bar”。

HistogramQuery

直方图请求。

字段
histogram_query	string 指定针对匹配搜索资源（例如招聘信息、个人资料）的直方图请求的表达式。 如需详细了解语法，请参阅 SearchJobsRequest.histogram_queries 和 SearchProfilesRequest.histogram_queries。

HistogramQueryResult

与搜索中指定的 HistogramQuery 匹配的直方图结果。

字段
histogram_query	string 请求的直方图表达式。
histogram	map<string, int64> 从与不同值关联的构面的值到具有对应值的匹配条目数的映射。 密钥格式为： 字段中存储的字符串值（对于字符串直方图）。 （对于命名的数字存储桶）bucket() 函数中指定的名称，例如 bucket(0, MAX, "non-negative")，键将为 non-negative。 （针对匿名数字存储桶）格式为 <low>-<high> 的范围，例如 0-1000、MIN-0 和 0-MAX。

HtmlSanitization

用户输入字段上的 HTML 内容清理选项，例如职位描述。通过设置此选项，用户可以确定是否以及如何对这些字段执行清理。

枚举
HTML_SANITIZATION_UNSPECIFIED	默认值。
HTML_SANITIZATION_DISABLED	停用 HTML 输入清理。
SIMPLE_FORMATTING_ONLY	清理 HTML 输入，仅接受粗体、斜体、有序列表和无序列表标记。

Job

招聘信息资源表示招聘信息帖子（也称为“招聘信息列表”或“雇用信息”）。招聘信息属于 Company，后者是负责提供相应招聘信息的招聘实体。

字段
name	string 更新招聘信息时需要用到此字段。 招聘信息的资源名称。此字段是在创建招聘信息时由服务生成的。 格式为“projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}”。例如“projects/foo/tenants/bar/jobs/baz”。 如果未指定租户 ID，则使用默认租户。例如“projects/foo/jobs/bar”。 在招聘信息查询和 API 调用中优先使用此字段，而非 requisition_id，因为此值是唯一的。
company	string 必需。发布招聘信息的公司的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}/companies/{company_id}”。例如“projects/foo/tenants/bar/companies/baz”。 如果未指定租户 ID，则使用默认租户。例如“projects/foo/companies/bar”。
requisition_id	string 必需。雇用信息 ID，也称为帖子 ID，由客户指定以标识招聘信息。此字段供客户使用，用于标识和跟踪帖子。如果存在具有相同 company、language_code 和 requisition_id 的其他作业，则不允许创建该作业。 允许的最大字符数为 255。
title	string 必需。职位的职称，如“软件工程师” 允许的最大字符数为 500。
description	string 必需。职位的描述，通常包括对公司的多段描述和相关信息。对于 responsibilities、qualifications 和其他职位特征，职位对象上提供了单独的字段。建议使用这些单独的字段。 此字段接受 HTML 输入并对其进行清理，也接受粗体、斜体、有序列表和无序列表标记。 允许的最大字符数为 100000。
addresses[]	string 强烈建议提供，以获得最佳服务体验。 雇主希望为此招聘信息帖子设置的招聘地点。 为招聘地点指定完整的街道地址可以获得更好的 API 结果，尤其在按通勤时间搜索招聘信息时。 为获得最佳搜索结果，最多允许设置 50 个地点。如果某个职位有多个地点，建议将其拆分为多个具有唯一 requisition_id 的作业（例如，“ReqA”会变为“ReqA-1”“ReqA-2”等），因为不允许有多个具有相同 company、language_code 和 requisition_id 的作业。如果必须保留原始 requisition_id，则应使用自定义字段进行存储。此外，建议将同一招聘信息中互相靠近的地点分组，以获得更好的搜索体验。 允许的最大字符数为 500。
application_info	ApplicationInfo 职位申请信息。
job_benefits[]	JobBenefit 此职位包含的福利。
compensation_info	CompensationInfo 职位薪酬信息（也称为“工资率”），即向员工支付的薪酬。
custom_attributes	map<string, CustomAttribute> 所提供的结构化字段未涵盖的可过滤和不可过滤自定义职位属性的字段映射。 映射的键为最多 64 个字节的字符串，并且必须匹配以下格式：[a-zA-Z][a-zA-Z0-9_]*。例如，key0LikeThis 或 KEY_1_LIKE_THIS。 最多支持 100 个可过滤键和 100 个不可过滤键。对于可过滤的 string_values，所有键中最多允许 200 个值，每个字符串不超过 255 个字符。对于不可过滤的 string_values，所有键的 string_values 总大小上限为 50KB。
degree_types[]	DegreeType 此职位所需的教育水平，如“学士”、“硕士”。
department	string 公司公开职位所属的部门或职能部门。 允许的最大字符数为 255。
employment_types[]	EmploymentType 职位的工作性质，例如 full time 或 part time。
incentives	string 与职位相关的奖金、佣金和其他薪酬激励的描述，不包括工资或薪水。 允许的最大字符数为 10000。
language_code	string 帖子使用的语言。该字段不同于与职位相关的任何流畅性要求。 语言代码必须采用 BCP-47 格式，例如“en-US”或“sr-Latn”。如需了解详情，请参阅标识语言的标记 {: class="external" target="_blank" }。 如果此字段未指定且存在 Job.description，则系统会根据 Job.description 分配检测到的语言代码，否则默认为“en_US”。
job_level	JobLevel 与职位相关的经验水平，例如“初级”。
promotion_value	int32 由客户确定的职位推广值。该值用于确定使用精选招聘信息搜索调用搜索时返回招聘信息的排序顺序，推广值较高的结果会优先返回，其余结果按照相关性排序来返回。仅在 FEATURED_JOB_SEARCH 中返回 promotionValue >0 的招聘信息。 默认值为 0，负值也视为 0。
qualifications	string 说明任职所需的资格。建议使用此字段作为更通用的 description 字段的替代方案。 此字段接受 HTML 输入并对其进行清理，也接受粗体、斜体、有序列表和无序列表标记。 允许的最大字符数为 10000。
responsibilities	string 职位职责描述。建议使用此字段作为更通用的 description 字段的替代方案。 此字段接受 HTML 输入并对其进行清理，也接受粗体、斜体、有序列表和无序列表标记。 允许的最大字符数为 10000。
posting_region	PostingRegion 提供招聘信息的 PostingRegion 招聘信息（例如州、国家/地区）。如果设置了此字段，且未指定确切地点匹配项，则招聘信息所在地区内的搜索查询中的 LocationFilter 会找到此招聘信息。如果此字段设为 PostingRegion.NATION 或 PostingRegion.ADMINISTRATIVE_AREA，则强烈建议将招聘信息 Job.addresses 设为与此字段相同的地点级别。
visibility (deprecated)	Visibility 此项已弃用！ 已弃用。只有所有者才能看到该职位。 招聘信息的可见性。 如果未指定，则默认为 Visibility.ACCOUNT_ONLY。
job_start_time	Timestamp UTC 时区中的职位开始时间戳。通常，此字段用于签订雇用合同。无效时间戳会被忽略。
job_end_time	Timestamp 职位的结束时间戳。通常，此字段用于签订雇用合同。无效时间戳会被忽略。
posting_publish_time	Timestamp 此招聘信息帖子最近发布的时间戳。默认值为请求到达服务器的时间。无效时间戳会被忽略。
posting_expire_time	Timestamp 强烈建议提供，以获得最佳服务体验。 招聘信息的过期时间戳。在此时间戳之后，招聘信息将被标记为已过期，并且不再显示在搜索结果中。ListJobs API 无法列出已过期的招聘信息，但可以使用 GetJob API 检索该招聘信息或使用 UpdateJob API 进行更新，或使用 DeleteJob API 将其删除。您可以使用未来的到期时间戳更新并再次打开已过期的招聘信息。如果存在另一个具有相同 company、language_code 和 requisition_id 的现有打开作业，则更新已过期的作业会失败。 过期招聘信息会在我们的系统中保留 90 天。但是，过期职位总数不能超过过去 7 天内空缺职位数量上限的 3 倍。如果超出此阈值，系统会按照最早的到期时间顺序清除已过期的作业。清理完毕后，将无法再访问这些过期招聘信息。 无效时间戳将被忽略并视为未提供过期时间。 如果时间戳早于发出即时请求的时间，则作业在创建时会被视为立即过期。无法更新此类作业。在创建具有过去时间戳的作业时，必须在 posting_expire_time 之前设置 posting_publish_time。此功能的目的是允许其他对象（例如 Application）引用在到期之前系统中不存在的作业。如果您想修改在创建时已过期的作业，请将其删除并创建新的作业。 如果在创建招聘信息时未提供此值或此值无效，则招聘信息帖子将在招聘信息创建 30 天后过期。例如，如果招聘信息的创建时间为 2017/01/01 13:00AM UTC，并且未指定过期日期，则招聘信息将在 2017/01/31 13:00AM UTC 之后过期。 如果更新招聘信息时未提供此值，则其取决于 UpdateJobRequest.update_mask 设置的字段掩码。如果字段掩码包含 job_end_time，或者掩码为空，则意味着每个字段都更新，招聘信息帖子将在自职位上次更新之日起 30 天后过期。否则，过期日期不会更新。
posting_create_time	Timestamp 仅限输出。创建招聘信息帖子时的时间戳。
posting_update_time	Timestamp 仅限输出。上次更新此招聘信息帖子的时间戳。
company_display_name	string 仅限输出。用于列出招聘信息的公司的显示名。
derived_info	DerivedInfo 仅限输出。有关招聘信息帖子的详细信息。
processing_options	ProcessingOptions 招聘信息处理选项。

ApplicationInfo

招聘信息帖子中与申请相关的详细信息。

字段
emails[]	string 使用此字段指定接收简历或申请的电子邮件地址。 每个条目允许的最大字符数为 255。
instruction	string 使用此字段提供说明，例如“将您的申请发送至…”，以供候选人按照说明申请职位。 此字段接受 HTML 输入并对其进行清理，也接受粗体、斜体、有序列表和无序列表标记。 允许的最大字符数为 3000。
uris[]	string 使用此 URI 字段引导申请人访问网站，例如转至在线申请表格页面。 每个条目允许的最大字符数为 2000。

DerivedInfo

有关招聘信息帖子的详细信息。

字段
locations[]	Location 招聘信息的结构化地点，解析自 Job.addresses。 locations 与 Job.addresses 的完全匹配顺序相同。
job_categories[]	JobCategory 派生自 Job.title 和 Job.description 的职位类别。

ProcessingOptions

招聘信息处理选项。

字段
disable_street_address_resolution	bool 如果设置为 true，则服务不会尝试解析更精确的作业地址。
html_sanitization	HtmlSanitization 招聘信息 HTML 内容清理选项。适用字段如下： description applicationInfo.instruction incentives qualifications responsibilities 如果未停用清理，则可能会清理掉这些字段中的 HTML 标记。 默认值为 HtmlSanitization.SIMPLE_FORMATTING_ONLY。

JobBenefit

表示职位提供的员工福利的枚举。

枚举
JOB_BENEFIT_UNSPECIFIED	如果未指定类型，则使用默认值。
CHILD_CARE	此职位提供儿童看护计划，如日托。
DENTAL	此职位提供牙科保险计划涵盖的牙科服务。
DOMESTIC_PARTNER	此职位为境内合伙人提供特殊福利。
FLEXIBLE_HOURS	此职位允许弹性工作时间。
MEDICAL	此职位提供医疗保险计划涵盖的医疗服务。
LIFE_INSURANCE	此职位提供由雇主提供或可供雇员购买的人寿保险计划。
PARENTAL_LEAVE	此职位允许父母休假照顾新生儿。
RETIREMENT_PLAN	此职位提供由雇主提供或可供雇员购买的退休计划。
SICK_DAYS	此职位提供带薪病假。
VACATION	此职位提供带薪休假。
VISION	此职位提供眼科保险计划涵盖的眼科服务。

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	运输或物流职位，如卡车司机。

JobEvent

求职者与使用 Cloud Talent Solution 的应用交互时发出的事件。

字段
type	JobEventType 必需。事件的类型（请参阅 JobEventType）。
jobs[]	string 必需。与此事件关联的 job name(s)。例如，如果这是一个 impression 事件，则此字段包含向求职者显示的所有招聘信息的标识符。如果这是一个 view 事件，则此字段包含所查看作业的标识符。 格式为“projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}”，例如“projects/foo/tenants/bar/jobs/baz”。
profile	string 与此客户端事件关联的 profile name。 格式为“projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}”，例如“projects/foo/tenants/bar/profiles/baz”。

JobEventType

归因于最终用户（例如求职者）行为的事件枚举。

枚举
JOB_EVENT_TYPE_UNSPECIFIED	该事件未被所提供的其他值指定。
IMPRESSION	求职者或与服务交互的其他实体已在其视图中呈现一则招聘信息，例如在采用压缩或剪辑格式的搜索结果列表中呈现了此招聘信息。此事件通常与求职者在单个页面上查看招聘信息列表相关。
VIEW	求职者或与服务交互的其他实体已查看一则招聘信息的完整详情，包括完整描述。此事件不适用于查看作为招聘信息搜索结果的一部分出现的招聘信息摘要。查看摘要与 impression 相关联。
VIEW_REDIRECT	求职者或与服务交互的其他实体执行了查看一则招聘信息的操作，并且被重定向到另一个网站进行查看。
APPLICATION_START	求职者或与服务交互的其他实体已启动了申请职位的流程，或者展现出申请某个职位的意图。
APPLICATION_FINISH	求职者或与服务互动的其他实体提交了职位申请。
APPLICATION_QUICK_SUBMISSION	求职者或与服务交互的其他实体仅需点击即可提交求职申请，无需输入信息。如果求职者执行此操作，请仅将此事件发送给服务。请勿同时发送 JobEventType.APPLICATION_START 或 JobEventType.APPLICATION_FINISH 事件。
APPLICATION_REDIRECT	求职者或与服务交互的其他实体执行了申请一个职位的操作，并且他们被重定向到另一个网站去完成申请。
APPLICATION_START_FROM_SEARCH	求职者或与服务互动的其他实体在未查看招聘信息详情的情况下，通过搜索结果页面启动了申请职位的流程，或者展现出申请某个职位的意图。如果系统发送此事件，则不应发送 JobEventType.VIEW 事件。
APPLICATION_REDIRECT_FROM_SEARCH	求职者或与服务交互的其他实体通过点击搜索结果页面执行操作，以申请某个职位（未查看招聘信息的详情），并且被重定向到另一个网站去完成申请。如果候选人执行此操作，请仅将此事件发送给服务。请勿同时发送 JobEventType.APPLICATION_START、JobEventType.APPLICATION_FINISH 或 JobEventType.VIEW 事件。
APPLICATION_COMPANY_SUBMIT	在公司代表求职者提交申请时，应该使用此事件。此事件供想要安排候选人的劳务中介使用。
BOOKMARK	求职者或与服务交互的其他实体通过添加书签或保存的方式展现出对一则招聘信息的兴趣。
NOTIFICATION	此事件向求职者或与服务交互的其他实体发送通知，例如电子邮件提醒或设备通知，通知中包含由服务生成的一份或多份招聘信息列表。
HIRED	招聘实体（雇主）已雇用求职者或与该服务交互的其他实体。只有在求职者先前通过 Cloud Talent Solution 服务执行搜索发起求职申请，并且因此申请而受雇时，系统才会发送此事件。
SENT_CV	招聘人员或劳务中介在与服务进行交互并确定适当的招聘信息后，代表候选人提交申请。
INTERVIEW_GRANTED	招聘实体（雇主）已为与服务交互的实体（例如求职者）安排了初次面试。只有在求职者先前通过 Cloud Talent Solution 服务执行的搜索/提供的推荐发起求职申请，并且因此申请而获得面试机会时，系统才应发送此事件。

JobLevel

表示职位所需经验水平的枚举。

枚举
JOB_LEVEL_UNSPECIFIED	如果未指定经验水平，则为默认值。
ENTRY_LEVEL	初级员工，通常具有 2 年以下的类似职位工作经验。包括实习生。
EXPERIENCED	经验丰富的员工，通常具有 2 年以上类似职位工作经验。
MANAGER	负责管理员工团队的初级/中级管理人员。
DIRECTOR	负责管理经理团队的高级管理人员。
EXECUTIVE	执行层及以上管理人员，包括高管层职位。

JobOperationResult

JobService.BatchCreateJobs 或 JobService.BatchUpdateJobs API 的结果。它用于在成功时替换 google.longrunning.Operation.response。

字段
job_results[]	JobResult 批量转变操作的作业变更结果列表。在操作状态为 FINISHED、FAILED 或 CANCELLED 之前可能会发生变化。

JobResult

作业的变更结果。

字段
job	Job 此处的 Job 仅包含基本信息，包括 name、company、language_code 和 requisition_id，请使用 getJob 方法检索已创建/已更新的作业的详细信息。
status	Status 已处理作业的状态。如果 job 处理失败，系统会填充此字段。

JobQuery

执行搜索查询所需的查询。

字段
query	string 与职位职称、描述和地点字段匹配的查询字符串。 允许的最大字符数为 255。
query_language_code	string query 的语言代码。例如，“en-US”。此字段有助于更好地解读查询。 如果未指定值，系统会自动检测查询语言代码，这可能不准确。 语言代码应采用 BCP-47 格式，例如“en-US”或“sr-Latn”。如需了解详情，请参阅标识语言的标记。
companies[]	string 此过滤器指定要搜索的公司实体。 如果未指定值，则会针对所有公司搜索招聘信息。 如果指定了多个值，则会针对指定的公司搜索招聘信息。 格式为“projects/{project_id}/tenants/{tenant_id}/companies/{company_id}”。例如“projects/foo/tenants/bar/companies/baz”。 如果未指定租户 ID，则使用默认租户。例如“projects/foo/companies/bar”。 最多允许设置 20 个公司过滤器。
location_filters[]	LocationFilter 地点过滤器指定包含要搜索的招聘信息的地理区域。如需了解详情，请访问 LocationFilter。 如果未指定地点值，则将忽略地点，检索满足其他搜索条件的招聘信息。 如果指定了多个值，则从任意指定地点检索招聘信息。如果为 LocationFilter.distance_in_miles 参数指定了不同的值，则系统会为所有营业地点使用所提供的最远距离。 最多允许设置 5 个地点过滤器。
job_categories[]	JobCategory 类别过滤器指定要搜索的招聘信息类别。如需了解详情，请访问 JobCategory。 如果未指定值，则会搜索任意类别的招聘信息。 如果指定了多个值，则会搜索任意指定类别的招聘信息。
commute_filter	CommuteFilter 允许按不同出行方式（例如驾车或公共交通）的通勤时间过滤招聘信息。 注意：此方法仅在您指定 CommuteMethod 时才有效。在本例中，location_filters 会被忽略。 目前不支持按通勤时间排序。
company_display_names[]	string 此过滤器指定要搜索的职位的确切公司 Company.display_name。 如果未指定值，则搜索结果中的招聘信息会关联任意公司。 如果指定了多个值，则搜索结果中的招聘信息可关联任意指定公司。 最多允许设置 20 个公司显示名称过滤器。
compensation_filter	CompensationFilter 此搜索过滤条件仅适用于Job.compensation_info。例如，如果此过滤器指定为“时薪 > $15 的小时工”，则仅搜索满足此条件的招聘信息。如果未定义过滤器，则搜索所有公开招聘信息。
custom_attribute_filter	string 此过滤条件会指定与标记为 filterable 的 Job.custom_attributes 匹配的结构化语法。 此表达式的语法是 SQL 语法的子集。 支持的运算符包括：=、!=、<、<=、> 和 >=，其中运算符左侧是自定义字段键，运算符右侧是数字或带英文引号的字符串。反斜杠 (\) 和引号 (") 字符必须进行转义。 支持的函数包括 LOWER([field_name])（用于执行不区分大小写的匹配）和 EMPTY([field_name])（用于过滤是否存在键）。 布尔表达式 (AND/OR/NOT) 最多支持 3 层嵌套（例如，“((A AND B AND C) OR NOT D) AND E”），表达式中最多可以存在 100 个比较运算符/函数。表达式的长度必须小于 6000 字节。 示例查询：(LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10
disable_spell_check	bool 此标志控制拼写检查功能。如果设为 false，则服务尝试更正拼写错误的查询，例如，“enginee”被更正为“engineer”。 默认值为 false，即执行拼写检查。
employment_types[]	EmploymentType 工作性质过滤器指定要搜索的职位的工作类型，例如 EmploymentType.FULL_TIME。 如果未指定值，则搜索结果中的职位包括所有工作性质。 如果指定了多个值，则搜索结果中的职位包括任意指定的工作性质。
language_codes[]	string 此过滤器指定要搜索的招聘信息的语言区域，例如“en-US”。 如果未指定值，则搜索结果可以包含任何语言环境中的招聘信息。 语言代码应采用 BCP-47 格式，例如“en-US”或“sr-Latn”。如需了解详情，请参阅标识语言的标记。 最多允许设置 10 个语言代码过滤器。
publish_time_range	TimestampRange 搜索在此过滤器指定的日期范围内发布的职位。
excluded_jobs[]	string 此过滤器指定要在搜索期间排除的职位名称列表。 最多允许排除 400 个职位名称。

JobView

一个枚举，用于指定在 MatchingJob.job 或 ListJobsResponse.jobs 字段中返回的职位属性。

枚举
JOB_VIEW_UNSPECIFIED	默认值。
JOB_VIEW_ID_ONLY	作业的仅包含 ID 的视图，具有以下属性：Job.name、Job.requisition_id、Job.language_code。
JOB_VIEW_MINIMAL	作业的极简视图，包含以下属性：Job.name、Job.requisition_id、Job.title、Job.company、Job.DerivedInfo.locations、Job.language_code。
JOB_VIEW_SMALL	招聘信息的小视图，搜索结果中包含以下属性：Job.name、Job.requisition_id、Job.title、Job.company、Job.DerivedInfo.locations、Job.visibility、Job.language_code、Job.description。
JOB_VIEW_FULL	搜索结果中包含所有可用属性。

ListCompaniesRequest

列出客户具有 ACL 可见性的公司。

字段
parent	string 必需。创建公司的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”，例如“projects/foo/tenant/bar”。 如果未指定租户 ID，系统将使用默认租户，例如“projects/foo”。
page_token	string 返回结果的起始指示符。
page_size	int32 返回的最大公司数量，最多 100 个。如果提供负数，则默认值为 100。
require_open_jobs	bool 如果公司要求必须有公开职位，则设置为 true。 默认值为 false。 如果为 true，则最多提取 page_size 的公司，其中仅返回具有公开职位的公司。

ListCompaniesResponse

列出公司的响应对象。

字段
companies[]	Company 当前客户的公司。
next_page_token	string 用于检索下一页结果的令牌。
metadata	ResponseMetadata API 调用的其他信息，例如请求跟踪 ID。

ListJobsRequest

列出招聘信息的请求。

字段
parent	string 必需。创建作业的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”。例如“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"
page_token	string 查询结果的起点。
page_size	int32 每页结果返回的最大招聘信息数。 如果将 job_view 设置为 JobView.JOB_VIEW_ID_ONLY，则允许的页面大小上限为 1000。如果设置为 false，则允许的最大页面大小为 100。 如果为空或指定的数字小于 1，则默认值为 100。
job_view	JobView 为搜索响应中的招聘信息返回所需的职位属性。如果未指定任何值，则默认为 JobView.JOB_VIEW_FULL。

ListJobsResponse

列出招聘信息的响应。

字段
jobs[]	Job 给定公司的招聘信息。 返回项的最大数量取决于请求中提供的限制字段。
next_page_token	string 用于检索下一页结果的令牌。
metadata	ResponseMetadata API 调用的其他信息，例如请求跟踪 ID。

ListTenantsRequest

列出客户端具有 ACL 可见性的租户。

字段
parent	string 必需。在其下创建租户的项目的资源名称。 该名称采用“projects/{project_id}”格式，例如“projects/foo”。
page_token	string 返回结果的起始指示符。
page_size	int32 要返回的租户数量上限，最多为 100 个。如果提供负数，则默认值为 100。

ListTenantsResponse

列出租户响应对象。

字段
tenants[]	Tenant 当前客户的租户。
next_page_token	string 用于检索下一页结果的令牌。
metadata	ResponseMetadata API 调用的其他信息，例如请求跟踪 ID。

位置

表示具有完整地理信息的地点的资源。

字段
location_type	LocationType 营业地点的类型，对应于 google.type.PostalAddress 的地址行字段。例如，“Downtown, Atlanta, GA, USA”的类型为 LocationType.NEIGHBORHOOD，而“Kansas City, KS, USA”的类型为 LocationType.LOCALITY。
postal_address	PostalAddress 包含人类可读信息的地点的邮政地址，例如邮政递送和付款地址。给定邮政地址时，邮政服务可以将物品投递到处所、邮政信箱或其他投递地点。
lat_lng	LatLng 表示纬度/经度对的对象。
radius_miles	double 工作地点的半径（以英里为单位）。此值派生自地点边界框，其中指定半径的圆圈以 google.type.LatLng 为中心，覆盖了与工作地点关联的区域。例如，目前，“Mountain View, CA, USA”的半径为 6.17 英里。

LocationType

表示地点类型的枚举。

枚举
LOCATION_TYPE_UNSPECIFIED	如果未指定类型，则使用默认值。
COUNTRY	国家/地区级别的地点。
ADMINISTRATIVE_AREA	州或同等级别的地点。
SUB_ADMINISTRATIVE_AREA	郡或同等级别的地点。
LOCALITY	城市或同等级别的地点。
POSTAL_CODE	邮政编码级别的地点。
SUB_LOCALITY	子级市行政区是市行政区的一个细分，例如城市自治镇/区、坊或行政区。子级市行政区通常由地方政治当局划分。例如，曼哈顿区和布鲁克林区是由纽约市划分的行政区，因此被归类为子级市行政区。
SUB_LOCALITY_1	区或同等级别的地点。
SUB_LOCALITY_2	较小的区或同等级别的区域。
NEIGHBORHOOD	社区级别的地点。
STREET_ADDRESS	街道地址级别的地点。

LocationFilter

搜索的地理区域。

字段
address	string 地址名称，例如“Mountain View”或“Bay Area”。
region_code	string 地址的国家/地区的 CLDR 地区代码。用于解决用户输入地点模糊的问题，例如“Liverpool”可以指“Liverpool, NY, US”，也可以指“Liverpool, UK”。 设置此字段，使地理位置解析偏向于特定的国家或地区。如果未设置此字段，则默认情况下，应用程序行为偏向于美国。 如需了解详情，请参阅 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。示例：“CH”代表瑞士。请注意，此过滤器不适用于与个人资料搜索相关的查询。
lat_lng	LatLng 要搜索的地理中心的纬度和经度。如果提供了 address，则忽略此字段。
distance_in_miles	double 当搜索的地点为城市或更小的区域时，应用 distance_in_miles。如果要搜索的营业地点是一个州或更大值，则忽略此字段。
telecommute_preference	TelecommutePreference 允许客户返回未设置地点的招聘信息，具体而言，是远程办公职位（服务将远程办公视为特殊地点）。Job.posting_region 表示职位是否允许远程办公。如果此字段设为 TelecommutePreference.TELECOMMUTE_ALLOWED，系统会搜索远程办公职位，并忽略 address 和 lat_lng。如果此政策未设置或设为 TelecommutePreference.TELECOMMUTE_EXCLUDED，系统不会搜索远程办公职位。 此过滤器可以单独用于搜索远程办公职位，也可以与其他地点过滤器结合使用，以搜索职位地点组合，例如“Mountain View”或“telecommuting”职位。但是，当与其他地点过滤器结合使用时，与搜索响应中的其他职位相比，远程办公职位将被视为相关度较低。 此字段仅用于招聘信息搜索请求。
negated	bool 是否对过滤条件应用否定逻辑以排除与过滤条件匹配的个人资料。 目前仅支持搜索个人资料。

TelecommutePreference

指定是否包括远程办公职位。

枚举
TELECOMMUTE_PREFERENCE_UNSPECIFIED	如果未指定远程办公偏好，则为默认值。
TELECOMMUTE_EXCLUDED	排除远程办公职位。
TELECOMMUTE_ALLOWED	允许远程办公职位。

PostingRegion

表示招聘信息帖子地区的枚举。在大多数情况下，招聘信息帖子不需要指定地区。如果给定了地区，则招聘信息可以在指定地区中搜索到。

枚举
POSTING_REGION_UNSPECIFIED	如果未指定区域，则仅在作业与 LocationFilter 匹配时才会返回。
ADMINISTRATIVE_AREA	除了精确地点匹配之外，当搜索查询中的 LocationFilter 与返回的招聘信息帖子位于同一行政区时，系统也会返回该招聘信息。例如，如果设为 ADMINISTRATIVE_AREA 的招聘信息在“CA, USA”中发布，则当 LocationFilter 包含“Mountain View”时，系统会返回该招聘信息。 行政区是指一个国家/地区的顶级行政区划。例如，美国的“州”、意大利的“区”、英国的“构成国”和日本的“都”。
NATION	除了精确地点匹配之外，当搜索查询中的 LocationFilter 与此招聘信息位于同一个国家/地区时，将返回该招聘信息。例如，如果设为 NATION_WIDE 的招聘信息在“USA”中发布，则当 LocationFilter 包含“Mountain View”时将返回该招聘信息。
TELECOMMUTE	此职位允许员工远程工作（远程办公）。如果同时提供了营业地点和此值，则该职位被视为具有营业地点，但允许远程办公。

RequestMetadata

与搜索职位的人或实体相关的元信息。此信息用于改善服务的效果。

字段
domain	string 如果 allow_missing_ids 未设置或 false，则为必需。 由客户定义的服务调用范围或来源，通常为服务已在其上实现并且当前正在运行的网域。 例如，如果运行服务的客户为 Foo, Inc.，其职位平台为 www.foo.com，招聘网站为 www.bar.com，则将此字段设置为“foo.com”可在职位平台上使用服务，设置为“bar.com”可在招聘网站上使用服务。 请注意，针对特定租户网站模型做出的任何改进都依赖于将此字段正确设置为唯一网域。 允许的最大字符数为 255。
session_id	string 如果 allow_missing_ids 未设置或 false，则为必需。 唯一的期间标识字符串。期间是指最终用户在一段时间内与服务交互的持续时间。在将此字段提供给服务之前，请先隐藏此字段以避免隐私问题。 请注意，针对特定租户网站模型做出的任何改进都依赖于将此字段正确设置为唯一的期间 ID。 允许的最大字符数为 255。
user_id	string 如果 allow_missing_ids 未设置或 false，则为必需。 由客户确定的唯一用户标识字符串。要对搜索质量产生最积极的影响，请确保客户级别是唯一的。在将此字段提供给服务之前，请先隐藏此字段以避免隐私问题。 请注意，针对特定租户网站模型做出的任何改进都依赖于将此字段正确设置为唯一的用户 ID。 允许的最大字符数为 255。
allow_missing_ids	bool 仅当 domain、session_id 和 user_id 因某种原因而无法使用时，才设置此字段。为获得最佳服务体验，强烈建议不要设置此字段，并提供准确的 domain、session_id 和 user_id。
device_info	DeviceInfo 求职者在调用服务时使用的设备类型。

ResponseMetadata

返回给客户的其他信息，例如调试信息。

字段
request_id	string 与此调用关联的唯一 ID。此 ID 会被记录以进行跟踪。

SearchJobsRequest

SearchJobs 调用的请求正文。

字段
parent	string 必需。要在其中进行搜索的租户的资源名称。 格式为“projects/{project_id}/tenants/{tenant_id}”。例如“projects/foo/tenant/bar”。如果未指定租户 ID，则系统会创建默认租户。例如“projects/foo”。
search_mode	SearchMode 搜索的模式。 默认值为 SearchMode.JOB_SEARCH。
request_metadata	RequestMetadata 必需。收集到的关于求职者的元信息，用于提高服务的搜索质量。标识符（例如 user_id）由用户提供，并且必须唯一且一致。
job_query	JobQuery 用于搜索招聘信息的查询，例如关键字、地点过滤器等。
enable_broadening	bool 控制在生成稀疏结果时是否扩大搜索范围。扩展查询会将结果附加到匹配结果列表的末尾。 默认值为 false。
require_precise_result_size (deprecated)	bool 此项已弃用！ 此字段已弃用。
histogram_queries[]	HistogramQuery 指定针对匹配招聘信息的直方图请求的表达式。 表达式语法采用包含直方图属性和其他选项的聚合函数调用。 可用的聚合函数调用如下：* count(string_histogram_facet)：计算每个不同属性值的匹配实体的数量。* count(numeric_histogram_facet, list of buckets)：计算每个存储分区内匹配实体的数量。 数据类型： 直方图 Facet：采用 [a-zA-Z][a-zA-Z0-9_]+ 格式的 Facet 名称。 字符串：诸如“any string with backslash escape for quote(")”之类的字符串。 数字：整数和浮点数，如 10、-1 和 -0.01。 列表：用方括号括起并以 (,) 分隔的元素列表，例如 [1, 2, 3] 和 ["one", "two", "three"]。 内置常量： MIN（最小数字，类似于 java Double.MIN_VALUE） MAX（最大数字，类似于 java Double.MAX_VALUE） 内置函数： bucket(start, end[, label])：bucket 内置函数会创建一个范围为 [start, end) 的集合。请注意，end 不包括在内，例如，bucket(1, MAX, "positive number") 或 bucket(1, 10)。 招聘信息直方图 Facet： company_display_name：按 Job.company_display_name 生成直方图。 employment_type：按 Job.employment_types 生成直方图，例如“FULL_TIME”“PART_TIME”。 company_size：按 CompanySize 生成直方图，例如“SMALL”“MEDIUM”“BIG”。 publish_time_in_month：按 Job.posting_publish_time 生成直方图（以月为单位）。必须在 spec 中指定数值集列表。 publish_time_in_year：按 Job.posting_publish_time（以年为单位）生成直方图。必须在 spec 中指定数值集列表。 ° 类型：按 Job.degree_types 生成直方图，例如“学士”、“硕士”。 job_level：按 Job.job_level 生成直方图，例如“初级”。 country：按招聘信息所属的国家/地区代码生成直方图，例如“US”、“FR”。 admin1：按职位的 admin1 代码生成直方图，这是一个全局占位符，表示州、省，或国家用于定义国家/地区级别以下的地理结构的特定字词，例如“CA”、“IL”。 city：按“城市名, admin1 代码”组合生成直方图。例如，“Mountain View, CA”“New York, NY”。 admin1_country：按“admin1 代码, 国家/地区”的组合生成直方图，例如“CA, US”“IL, US”。 City_coordinate：按市中心的 GPS 坐标（纬度和经度）生成直方图，例如，37.4038522,-122.0987765。由于市中心的坐标可能会发生变化，因此客户可能需要定期刷新。 locale：按 Job.language_code 生成直方图，例如“en-US”、“fr-FR”。 language：按 Job.language_code 的语言子标记生成直方图，例如“en”“fr”。 类别：按 JobCategory 生成直方图，例如“COMPUTER_AND_IT”“HEALTHCARE”。 base_ charge_unit：按基本工资的 CompensationInfo.CompensationUnit 生成直方图，例如 "WEEKLY"、"MONTHLY"。 base_compensation：按基本薪资生成直方图。必须指定对结果进行分组所依据的数字存储分区列表。 年度化_base_补贴：按基本年薪生成直方图。必须指定对结果进行分组所依据的数值集列表。 年度化_总薪酬：按年度总工资生成直方图。必须指定对结果进行分组所依据的数值集列表。 string_custom_attribute：按字符串 Job.custom_attributes 生成直方图。可以通过方括号表示法访问值，例如 string_custom_attribute["key1"]。 Digital_custom_attribute：按数字 Job.custom_attributes 生成直方图。可以通过方括号表示法访问值，例如 number_custom_attribute["key1"]。必须指定对结果进行分组所依据的数字存储分区列表。 表达式示例： count(admin1) count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000), bucket(100000, MAX)]) count(string_custom_attribute["some-string-custom-attribute"]) count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])
job_view	JobView 为搜索响应中的招聘信息返回所需的职位属性。如果未指定任何值，则默认为 JobView.JOB_VIEW_SMALL。
offset	int32 指定搜索结果中当前偏移量（即 API 视为相关的职位的起始结果位置）的整数。仅在 page_token 未设置时才会考虑此字段。 允许的最大值为 5000。否则会抛出错误。 例如，0 表示从第一个匹配职位开始返回结果，10 表示从第 11 个职位开始返回。此字段可用于分页（例如，pageSize = 10 且 offset = 10 表示从第二页返回）。
page_size	int32 对搜索结果中返回的职位数量的限制。将此值设为超过默认值 10 可能会增加搜索响应时间。此值介于 1 到 100 之间。
page_token	string 指定搜索结果中当前偏移量的令牌。如需了解如何获取下一组查询结果，请参阅 SearchJobsResponse.next_page_token。
order_by	string 确定搜索结果排序方式的条件。默认值为 "relevance desc"。 支持的选项包括： "relevance desc"：由 API 算法确定，按相关性降序排序。查询结果的相关性阈值仅适用于此排序。 "posting_publish_time desc"：按 Job.posting_publish_time 降序排序。 "posting_update_time desc"：按 Job.posting_update_time 降序排序。 "title"：按 Job.title（升序）。 "title desc"：按 Job.title 降序排序。 "annualized_base_compensation"：按作业的 CompensationInfo.annualized_base_compensation_range 升序。如果未指定职位的年度基本薪酬，则将其放在搜索结果的末尾。 "annualized_base_compensation desc"：按作业的 CompensationInfo.annualized_base_compensation_range（降序）。如果未指定职位的年度基本薪酬，则将其放在搜索结果的末尾。 "annualized_total_compensation"：按作业的 CompensationInfo.annualized_total_compensation_range 升序。如果未指定职位的年度基本薪酬，则将其放在搜索结果的末尾。 "annualized_total_compensation desc"：按作业的 CompensationInfo.annualized_total_compensation_range（降序）。如果未指定职位的年度基本薪酬，则将其放在搜索结果的末尾。 "custom_ranking desc"：按相关性得分调整为 SearchJobsRequest.CustomRankingInfo.ranking_expression，权重因子按 SearchJobsRequest.CustomRankingInfo.importance_level 降序排列。 地点排序：使用特殊语法按距离对招聘信息进行排序： "distance_from('Hawaii')"：按与夏威夷的距离排序。 "distance_from(19.89, 155.5)"：按与坐标的距离排序。 "distance_from('Hawaii'), distance_from('Puerto Rico')"：按多个营业地点排序。详情请参见下文。 "distance_from('Hawaii'), distance_from(19.89, 155.5)"：按多个营业地点排序。详情请参见下文。 ：该字符串最多可包含 256 个字符。如果提供了多个距离中心，则靠近任何距离中心的作业将具有较高的排名。如果任务涉及多个地点，系统会使用距离其中一个距离中心最近的工作地点。没有营业地点的职位将排在底部。距离的计算精确度为 11.3 米（37.4 英尺）。除非在 diversification_level 中明确停用，否则仍会应用多样化策略。
diversification_level	DiversificationLevel 控制是否在搜索结果中以彼此相邻的方式返回高度相似的职位。职位会根据职称、职位类别和地点被标识为高度相似。高度相似的结果会聚类在一起，以便仅将聚类中的一个代表性职位显示给求职者并排在结果的较高位置，而将其他职位排在结果的较低位置。 如果未指定任何值，则默认为 DiversificationLevel.SIMPLE。
custom_ranking_info	CustomRankingInfo 控制职位文档如何基于现有相关性得分（由 API 算法确定）进行排名。
disable_keyword_match	bool 控制是否针对 Job.title、Job.description、Job.company_display_name、Job.addresses、Job.qualifications 停用完全匹配关键字。停用关键字匹配时，关键字匹配会在出现匹配的关键字时返回与给定的类别过滤条件不匹配的职位。例如，针对“项目经理”执行查询时，即使职位发布的职称为“软件开发者”，也会返回一个结果；虽然这个职称并不属于“项目经理”本体，但确实其描述中确实出现了“项目经理”字眼。 如果查询中不包含特定职称或地点本体（例如“cloud”查询），那么无论此标志的值如何，都会返回与“cloud”关键字匹配的职位。 如果需要公司特定的全局匹配的自定义字段/属性字符串值，请使用 Company.keyword_searchable_job_custom_attributes。启用关键字匹配可以改善对后续搜索请求的调用。 默认值为 false。

CustomRankingInfo

SearchJobsRequest 的自定义排名信息。

字段
importance_level	ImportanceLevel 必需。控制 CustomRankingInfo.ranking_expression 的得分对职位的最终排名位置的重要性。 如果未指定此字段，则会抛出错误。
ranking_expression	string 必需。控制职位文档如何基于现有相关性得分（由 API 算法确定）进行排名。系统会结合使用排名表达式和相关性得分来确定职位的最终排名位置。 此表达式的语法是 Google SQL 语法的子集。 支持的运算符包括 +、-、*、/，其中运算符的左侧和右侧可以是数字 Job.custom_attributes 键、整数/双精度值，也可以是计算结果为数字的表达式。 可以通过添加括号来调整计算优先级。表达式的长度必须小于 100 个字符。 如果表达式引用了作业中未填充的自定义属性，或者表达式的结果除以零，该表达式会被视为对作业无效。如果表达式对某个作业无效，则该作业将降级到结果末尾。 示例排名表达式：（年份 + 25）* 0.25 -（新鲜度/ 0.5）

ImportanceLevel

CustomRankingInfo.ranking_expression 的重要性级别。

枚举
IMPORTANCE_LEVEL_UNSPECIFIED	未指定重要性级别时使用默认值。
NONE	职位的最终排名位置由现有相关性得分（由 API 算法确定）控制，而与给定排名表达式无关。
LOW	在对职位的最终排名位置的影响方面，给定排名表达式低于现有相关性得分（由 API 算法确定）。
MILD	在对职位的最终排名位置的影响方面，给定排名表达式略低于现有相关性得分（由 API 算法确定）。
MEDIUM	在对职位的最终排名位置的影响方面，给定排名表达式等同于现有相关性得分（由 API 算法确定）。
HIGH	在对职位的最终排名位置的影响方面，给定排名表达式高于现有相关性得分（由 API 算法确定）。
EXTREME	在对职位的最终排名位置的影响方面，给定排名表达式远高于现有相关性得分（由 API 算法确定），后者可忽略不计。

DiversificationLevel

控制是否在搜索结果中以彼此相邻的方式返回高度相似的职位。职位会根据职称、职位类别和地点被标识为高度相似。高度相似的结果会聚类在一起，以便仅将聚类中的一个代表性职位显示给求职者并排在结果的较高位置，而将其他职位排在结果的较低位置。

枚举
DIVERSIFICATION_LEVEL_UNSPECIFIED	未指定多样化水平。
DISABLED	停用多样化。通常被推送到最后一页的职位不会改变其位置。这可能会导致在搜索结果中按顺序出现高度相似的职位。
SIMPLE	默认的多样化行为。对结果列表进行排序，以便将高度相似的结果推送到搜索结果最后一页的末尾。如果使用 pageToken 对结果集进行分页，延迟时间可能会较短，但我们无法保证返回所有结果。如果使用页面偏移，延迟时间可能会较长，但系统会返回所有结果。

SearchMode

用字符串表示的职位搜索模式的枚举。对于不同的服务模式，服务的运行方式不同。

枚举
SEARCH_MODE_UNSPECIFIED	未指定搜索方法的模式。默认搜索行为与 JOB_SEARCH 搜索行为相同。
JOB_SEARCH	职位搜索匹配所有职位，并且未特别处理精选职位（promotionValue > 0 的职位）。
FEATURED_JOB_SEARCH	职位搜索仅匹配精选职位（promotionValue > 0 的职位）。此方法不返回任何 promotionValue <= 0 的职位。搜索结果顺序由 promotionValue 确定（具有较高 promotionValue 的职位在搜索结果中较前显示），相关性作为决定性属性。

SearchJobsResponse

SearchJob 方法的响应。

字段
matching_jobs[]	MatchingJob 与指定的 SearchJobsRequest 匹配的 Job 实体。
histogram_query_results[]	HistogramQueryResult 与指定的 SearchJobsRequest.histogram_queries 匹配的直方图结果。
next_page_token	string 用于指定下一页结果的起始位置的令牌。如果没有更多结果，则此字段为空。
location_filters[]	Location 服务应用于指定查询的位置过滤条件。如果任何过滤器基于 lat-lng，则 Location.location_type 为 Location.LocationType.LOCATION_TYPE_UNSPECIFIED。
estimated_total_size	int32 与指定查询匹配的预估招聘信息数。 此数字不能保证准确无误。如需获得准确的结果，请参阅 SearchJobsResponse.total_size。
total_size	int32 精确结果计数上限为 100,000。
metadata	ResponseMetadata API 调用的其他信息，例如请求跟踪 ID。
broadened_query_jobs_count	int32 如果启用了查询扩展，我们可能会从扩展的查询中附加其他结果。此数字表示招聘信息字段中返回的招聘信息数量有多少来自扩展查询。这些结果始终位于招聘信息列表的末尾。特别是，值为 0 或者此字段未设置，表示招聘信息列表中的所有招聘信息都来自原始（未扩展）查询。如果此字段不为零，则此结果集之后具有偏移量的后续请求应包含所有扩展结果。
spell_correction	SpellingCorrection 拼写检查结果和更正。

CommuteInfo

与招聘信息相关的通勤信息。

字段
job_location	Location 在通勤计算中用作目的地的位置。
travel_duration	Duration 从查询位置前往工作地点所需的秒数。时长为 0 秒表示在要求的时长内无法到达工作地点，但会作为扩展查询的一部分返回。

MatchingJob

元数据位于 SearchJobsResponse 内的作业条目。

字段
job	Job 与指定的 SearchJobsRequest 匹配的作业资源。
job_summary	string 招聘信息摘要，其中包含在搜索结果列表页面上显示的核心信息。
job_title_snippet	string 包含 Job.title 字段中与搜索查询的关键字最匹配的文本片段（如果有）。匹配的查询关键字包含在 HTML 粗体标记中。
search_text_snippet	string 包含 Job.description 和与搜索查询的关键字最匹配的类似字段中的文本片段（如果有）。在此字段中返回时，原始字段中的所有 HTML 标记都将被删除，匹配的查询关键字将包含在 HTML 粗体标记中。
commute_info	CommuteInfo 根据指定的 CommuteFilter 生成的通勤信息。

SpellingCorrection

拼写检查结果。

字段
corrected	bool 指明拼写检查工具是否更正了查询。
corrected_text	string 更正输出由更正后的关键字字符串组成。
corrected_html	string 使用 html 标记更正输出以突出显示已更正的字词。更正后的字词会用“...”html 标记突出显示。 例如，用户输入查询为“software enginear”，其中第二个单词“enginear”不正确。它应该是“engineer”。启用拼写更正后，此值为“software engineer”。

租户

租户资源代表服务中的租户。租户是一个群组或实体，对个人资料等资源拥有共同的访问权限，并具有特定权限。客户可以创建多个租户，为不同的群组提供数据隔离。

字段
name	string 更新租户期间需要执行此操作。 租户的资源名称。此名称由服务在创建租户时生成。 格式为“projects/{project_id}/tenants/{tenant_id}”，例如“projects/foo/tenants/bar”。
external_id	string 必需。客户端租户标识符，用于唯一标识租户。 允许的最大字符数为 255。
usage_type	DataUsageType 指明此租户所拥有的数据是否可以用于为其他租户提供产品改进。 如果未设置，则默认行为为 DataUsageType.ISOLATED。
keyword_searchable_profile_custom_attributes[]	string 可过滤 Profile.custom_attributes 的键列表，其对应的 string_values 用于关键字搜索。如果有任何值与搜索关键字匹配，则返回这些指定字段键下包含 string_values 的个人资料。带圆括号、方括号和特殊符号的自定义字段值不能按原样搜索，必须用引号括起来。

DataUsageType

表示如何使用租户所拥有的用户数据的枚举。

枚举
DATA_USAGE_TYPE_UNSPECIFIED	默认值。
AGGREGATED	此租户所拥有的数据用于提高跨租户的搜索/推荐质量。
ISOLATED	此租户拥有的数据仅用于提高此租户的搜索/推荐质量。

TimestampRange

表示两个时间戳之间的一段时间的消息。

字段
start_time	Timestamp 时间段的开始时间（含此日期）。
end_time	Timestamp 时段的结束时间（不含边界值）。

UpdateCompanyRequest

更新指定公司的请求。

字段
company	Company 必需。替换系统中当前资源的公司资源。
update_mask	FieldMask 强烈建议提供，以获得最佳服务体验。 如果提供了 update_mask，则仅更新 company 中的指定字段。否则更新所有字段。 用于指定要更新的公司字段的字段掩码。仅支持 Company 的顶级字段。

UpdateJobRequest

更新职位请求。

字段
job	Job 必需。要更新的职位。
update_mask	FieldMask 强烈建议提供，以获得最佳服务体验。 如果提供了 update_mask，则仅更新 job 中的指定字段。否则更新所有字段。 限制被更新字段的字段掩码。仅支持 Job 的顶级字段。

UpdateTenantRequest

请求更新指定租户。

字段
tenant	Tenant 必需。用于替换系统中当前资源的租户资源。
update_mask	FieldMask 强烈建议提供，以获得最佳服务体验。 如果提供了 update_mask，则仅更新 tenant 中的指定字段。否则更新所有字段。 用于指定要更新的租户字段的字段掩码。仅支持 Tenant 的顶级字段。

视觉障碍

此项已弃用！

已弃用。只有所有者才能看到所有资源。

表示具有此资源的查看访问权限的枚举。

枚举
VISIBILITY_UNSPECIFIED	默认值。
ACCOUNT_ONLY	此资源仅对拥有它的 GCP 账号可见。
SHARED_WITH_GOOGLE	此资源对所有者可见，并且可能对 Google 的其他应用和进程可见。
SHARED_WITH_PUBLIC	此资源对所有者可见，并且可能对所有其他 API 客户端可见。