招聘信息基础知识 (v3)

招聘信息资源表示招聘信息帖子（也称为“职位列表”或“雇用信息”）。招聘信息属于公司，公司是负责该招聘信息的雇用实体。

招聘信息可通过 create、update 和 deletion 方法操控，并使用 list 和 get 方法访问。如果发生更改，Cloud Talent Solution 索引最长可能需要 5 分钟才能反映这些更改。

职位包含在服务账号的范围内。只有使用特定服务账号的凭据经过身份验证的搜索请求，才能用于访问这些招聘信息的内容。

为了便于排查问题和分类，请将 Cloud Talent Solution 职位索引与您自己的职位索引同步，并维护 Cloud Talent Solution 生成的 name 与系统中唯一的职位标识符之间的关系。当招聘信息发生变更或是被引入您的系统时，应将相应的 CRUD 调用实时发送到 Cloud Talent Solution，以确保这些变更能够立即反映。必须将 Cloud Talent Solution 索引添加到现有招聘信息提取管道。

创建职位

要创建招聘信息，请参阅快速入门：创建公司和招聘信息指南获取详情。

Java

如需详细了解如何安装和创建 Cloud Talent Solution 客户端，请参阅 Cloud Talent Solution 客户端库。 


/** Create a job. */
public static Job createJob(Job jobToBeCreated) throws IOException {
  try {
    CreateJobRequest createJobRequest = new CreateJobRequest().setJob(jobToBeCreated);

    Job jobCreated =
        talentSolutionClient
            .projects()
            .jobs()
            .create(DEFAULT_PROJECT_ID, createJobRequest)
            .execute();
    System.out.println("Job created: " + jobCreated);
    return jobCreated;
  } catch (IOException e) {
    System.out.println("Got exception while creating job");
    throw e;
  }
}

Python

如需详细了解如何安装和创建 Cloud Talent Solution 客户端，请参阅 Cloud Talent Solution 客户端库。 

def create_job(client_service, job_to_be_created):
    try:
        request = {"job": job_to_be_created}
        job_created = (
            client_service.projects()
            .jobs()
            .create(parent=parent, body=request)
            .execute()
        )
        print("Job created: %s" % job_created)
        return job_created
    except Error as e:
        print("Got exception while creating job")
        raise e

Go

如需详细了解如何安装和创建 Cloud Talent Solution 客户端，请参阅 Cloud Talent Solution 客户端库。 


// createJob create a job as given.
func createJob(w io.Writer, projectID string, jobToCreate *talent.Job) (*talent.Job, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	parent := "projects/" + projectID
	req := &talent.CreateJobRequest{
		Job: jobToCreate,
	}
	job, err := service.Projects.Jobs.Create(parent, req).Do()
	if err != nil {
		return nil, fmt.Errorf("Failed to create job %q, Err: %w", jobToCreate.RequisitionId, err)
	}
	return job, err
}

必填字段

创建和更新招聘信息期间必须填写以下字段：

  • companyName：用于列出招聘信息的公司的资源名称，例如 projects/[PROJECT_ID]/companies/[COMPANY_ID]。

  • requisitionId：雇用信息 ID，也称为帖子 ID，由客户指定以标识招聘信息。客户使用此字段来标识自己并跟踪申请。允许的字符数上限为 225。

    招聘信息的 requisitionID、companyName 和语言区域的组合确定了招聘信息帖子的唯一性。如果使用这些属性的特定键创建职位，则该键将存储在 Cloud Talent Solution 索引中。在该职位删除之前，无法使用这些相同的字段创建其他职位。

  • title：职位的职称，如“软件工程师”允许的字符数上限为 500。

    为了解决因招聘信息名称不标准而漏掉搜索结果的问题，Cloud Talent Solution 利用招聘信息中提供的所有字段来理解招聘信息的背景，并在内部存储招聘信息的“干净”名称。在向服务发送搜索请求时，系统也会清理搜索查询，并使用本体将清理后的查询映射到相关的清理版职位。

  • description：职位的描述，通常包括对公司的多段描述和相关信息。对于职位对象，还提供了单独的字段，如职责、资质和其他职位特性等。建议使用这些单独的字段。

    此字段接受并清理 HTML 输入，也接受粗体、斜体、有序列表和无序列表标识标记。 允许的最大字符数为 100000。

如下所示：

常用字段

  • postingExpireTime：招聘信息到期的时间，以时间戳为准。到期后，招聘信息将标记为已过期，并且不会在搜索结果中显示。 此日期应早于世界协调时间 (UTC) 时区的 2100/12/31。 无效日期（例如过去的日期）将被忽略。 招聘信息的默认到期日期是创建后的 30 天，采用世界协调时间 (UTC) 时区。

    在招聘信息到期后的 60 天内，仍然可以通过 GET 运算符检索其内容。60 天截止日期之后，便无法再通过 GET 操作检索到该招聘信息。

  • addresses[]：职位的雇用地点。建议提供雇用地点的完整街道地址，以获得更好的 API 结果，包括按通勤时间搜索招聘信息。允许的字符数上限为 500。如需详细了解 addresses[]，请参阅下面的最佳做法部分。

  • promotionValue：设置大于 0 的值会将此职位定义为“精选职位”，此类职位仅在类型为 FEATURED_JOBS 的职位搜索中返回。返回的值越大，该职位在精选职位搜索结果中的位置就越靠前。如需了解详情，请参阅精选职位。

自定义字段

  • customAttributes：此字段最多可存储 100 个自定义属性，用于存储职位的自定义数据。可以在招聘信息搜索请求中指定 jobQuery 字段来过滤这些字段。此外，任何一个字段都可以在公司的 keywordSearchableJobCustomAttributes 属性中设置，以便在搜索字词与 keywordSearchableJobCustomAttributes 中的任何字段完全匹配时，返回所有包含此匹配项的职位。

更新招聘信息

更新不含 fieldMask 的招聘信息

Java

如需详细了解如何安装和创建 Cloud Talent Solution 客户端，请参阅 Cloud Talent Solution 客户端库。 


/** Update a job. */
public static Job updateJob(String jobName, Job jobToBeUpdated) throws IOException {
  try {
    UpdateJobRequest updateJobRequest = new UpdateJobRequest().setJob(jobToBeUpdated);
    Job jobUpdated =
        talentSolutionClient.projects().jobs().patch(jobName, updateJobRequest).execute();
    System.out.println("Job updated: " + jobUpdated);
    return jobUpdated;
  } catch (IOException e) {
    System.out.println("Got exception while updating job");
    throw e;
  }
}

Python

如需详细了解如何安装和创建 Cloud Talent Solution 客户端，请参阅 Cloud Talent Solution 客户端库。 

def update_job(client_service, job_name, job_to_be_updated):
    try:
        request = {"job": job_to_be_updated}
        job_updated = (
            client_service.projects()
            .jobs()
            .patch(name=job_name, body=request)
            .execute()
        )
        print("Job updated: %s" % job_updated)
        return job_updated
    except Error as e:
        print("Got exception while updating job")
        raise e

Go

如需详细了解如何安装和创建 Cloud Talent Solution 客户端，请参阅 Cloud Talent Solution 客户端库。 


// updateJob update a job with all fields except name.
func updateJob(w io.Writer, jobName string, jobToUpdate *talent.Job) (*talent.Job, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	req := &talent.UpdateJobRequest{
		Job: jobToUpdate,
	}
	job, err := service.Projects.Jobs.Patch(jobName, req).Do()
	if err != nil {
		return nil, fmt.Errorf("Failed to update job %s: %w", jobName, err)
	}

	return job, err
}

更新含 fieldMask 的招聘信息

Java

如需详细了解如何安装和创建 Cloud Talent Solution 客户端，请参阅 Cloud Talent Solution 客户端库。 


/** Update a job. */
public static Job updateJobWithFieldMask(String jobName, String fieldMask, Job jobToBeUpdated)
    throws IOException {
  try {
    UpdateJobRequest updateJobRequest =
        new UpdateJobRequest().setUpdateMask(fieldMask).setJob(jobToBeUpdated);
    Job jobUpdated =
        talentSolutionClient.projects().jobs().patch(jobName, updateJobRequest).execute();
    System.out.println("Job updated: " + jobUpdated);
    return jobUpdated;
  } catch (IOException e) {
    System.out.println("Got exception while updating job");
    throw e;
  }
}

Python

如需详细了解如何安装和创建 Cloud Talent Solution 客户端，请参阅 Cloud Talent Solution 客户端库。 

def update_job_with_field_mask(client_service, job_name, job_to_be_updated, field_mask):
    try:
        request = {"job": job_to_be_updated, "update_mask": field_mask}
        job_updated = (
            client_service.projects()
            .jobs()
            .patch(name=job_name, body=request)
            .execute()
        )
        print("Job updated: %s" % job_updated)
        return job_updated
    except Error as e:
        print("Got exception while updating job with field mask")
        raise e

Go

如需详细了解如何安装和创建 Cloud Talent Solution 客户端，请参阅 Cloud Talent Solution 客户端库。 


// updateJobWithMask updates a job by name with specific fields.
// mask is a comma separated list top-level fields of talent.Job.
func updateJobWithMask(w io.Writer, jobName string, mask string, jobToUpdate *talent.Job) (*talent.Job, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	req := &talent.UpdateJobRequest{
		Job:        jobToUpdate,
		UpdateMask: mask,
	}
	job, err := service.Projects.Jobs.Patch(jobName, req).Do()
	if err != nil {
		log.Fatalf("Failed to update job %s with field mask %s, Err: %v", jobName, mask, err)
	}

	return job, err
}

最佳做法

地点字段

我们建议您尽可能在 addresses[] 字段中提供职位的街道地址。这有助于位置检测和相关性匹配。如果无法提供街道地址，请输入尽可能多的信息。 最高支持国家/地区级别的地址。 不支持区域名称（例如“太平洋西北地区”）。

Cloud Talent Solution 使用 addresses[] 字段中的数据填充（仅限输出）derivedInfo.locations[] 字段。如果未提供完整地址，则服务会通过其他信息（例如公司名称）来确定是否能为招聘信息帖子推断出更完整的地址。

例如，如果软件职位的地点被指定为 Mountain View，并且与该职位相关联的公司是 Google，该服务会查找公司对象，以查看在 headquartersAddress 字段中是否提供了更好的街道地址，以及该街道地址是否与招聘信息位于同一个城市。如果是，服务会理解为该职位的工作地点“可能”是在该街道地址并相应地填写 derivedInfo.locations[] 字段。

如果公司地址数据不可用，服务会结合专有知识和招聘信息/公司信息来填写 derivedInfo.locations[] 字段。

由于 derivedInfo.locations[] 值是尽力猜测出的结果，因此在显示职位地址时，您可能需要使用 derivedInfo.locations[] 数据或 addresses 字段。

招聘信息帖子的关联位置不得超过 50 个。如果超过这个限制，您可以将招聘信息拆分为多个，每个分配一个唯一的 requisition_id（例如“ReqA”、“ReqA-1”、“ReqA-2”等），因为系统不允许多个招聘信息使用相同的 requisitionId、companyName 和 languageCode。如果必须保留原始 requisitionId，则应使用 CustomAttribute 进行存储。建议您将距离最近的位置组合归入同一招聘信息，以提供更好的搜索体验。

支持的地址

Cloud Talent Solution 接受 Google Maps Geocoding API 可识别的任何地址（在 formattedAddress 字段中）。如果您尝试使用无法识别的地址创建职位或执行搜索，服务会返回 400 错误。

如果 Google Maps Geocoding API 中所列的办公地址不正确，请提交错误以便相关人员更正。更正的地址可能需要 5 天才能生效。

地址自动填充

Cloud Talent Solution 不提供位置的自动填充建议。 使用 Google Maps Places API 或其他类似的位置服务来填充自动填充建议。

全州、全国和远程办公招聘信息

可以使用招聘信息资源的 postingRegion 字段指定全州、全国或远程办公。

  • 如果搜索的工作地点在招聘信息帖子的州/国家范围内，系统将返回 ADMINISTRATIVE_AREA 和 NATION 招聘信息。例如，如果搜索时将 LocationFilter 指定为“西雅图”，则返回结果中也会包含工作地点为“美国华盛顿州”的 ADMINISTRATIVE_AREA 职位。

  • 所有与位置相关的搜索都会返回 TELECOMMUTE 职位，但这些职位会被视为相关性较低。可以通过在搜索的 LocationFilter 中将 telecommutePreference 标志设置为 TELECOMMUTE_ALLOWED 来搜索这类职位。