Cloud Talent Solution을 사용하면 제공된 검색과 연관된 작업 수에 대한 히스토그램 표현을 가져올 수 있습니다. 히스토그램 검색을 수행하면 특정 쿼리와 일치하는 모든 채용정보 수가 요청된 SearchMode별로 구분되어 반환됩니다.
예를 들어 히스토그램 검색은 특정 지역에 존재하는 고용 유형별(전일제, 시간제 등) 채용정보 수를 반환할 수 있습니다.
히스토그램은 일반적으로 동일한 JobQuery 및 requestMetadata를 사용하여 검색 호출과 동시에 실행됩니다.
히스토그램은 단일 문자열 표현식인 histogramQuery 필드로 정의합니다. 히스토그램 쿼리에 사용할 수 있는 기능에 대한 자세한 내용은 histogramQuery 문서를 참조하세요.
히스토그램 검색
다음 코드 샘플은 히스토그램 결과를 반환합니다.
Go
import (
"context"
"fmt"
"io"
talent "cloud.google.com/go/talent/apiv4beta1"
"google.golang.org/api/iterator"
talentpb "google.golang.org/genproto/googleapis/cloud/talent/v4beta1"
)
// histogramSearch searches for jobs with histogram queries.
func histogramSearch(w io.Writer, projectID, companyID string) error {
ctx := context.Background()
// Initialize a jobService client.
c, err := talent.NewJobClient(ctx)
if err != nil {
fmt.Printf("talent.NewJobClient: %v\n", err)
return err
}
// Construct a searchJobs request.
req := &talentpb.SearchJobsRequest{
Parent: fmt.Sprintf("projects/%s", projectID),
// Make sure to set the RequestMetadata the same as the associated
// search request.
RequestMetadata: &talentpb.RequestMetadata{
// Make sure to hash your userId.
UserId: "HashedUsrID",
// Make sure to hash the sessionId.
SessionId: "HashedSessionID",
// Domain of the website where the search is conducted.
Domain: "www.googlesample.com",
},
HistogramQueries: []*talentpb.HistogramQuery{
{
// More info on histogram facets, constants, and built-in functions:
// https://godoc.org/google.golang.org/genproto/googleapis/cloud/talent/v4beta1#SearchJobsRequest
HistogramQuery: "count(base_compensation, [bucket(12, 20)])",
},
},
}
if companyID != "" {
req.JobQuery = &talentpb.JobQuery{
CompanyNames: []string{fmt.Sprintf("projects/%s/companies/%s", projectID, companyID)},
}
}
it := c.SearchJobs(ctx, req)
for {
resp, err := it.Next()
if err == iterator.Done {
return nil
}
if err != nil {
fmt.Printf("it.Next: %v\n", err)
return err
}
fmt.Fprintf(w, "Job: %q\n", resp.Job.GetName())
}
}
Java
Cloud Talent Solution 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Talent Solution 클라이언트 라이브러리를 참조하세요.
import com.google.cloud.talent.v4beta1.HistogramQuery;
import com.google.cloud.talent.v4beta1.Job;
import com.google.cloud.talent.v4beta1.JobServiceClient;
import com.google.cloud.talent.v4beta1.RequestMetadata;
import com.google.cloud.talent.v4beta1.SearchJobsRequest;
import com.google.cloud.talent.v4beta1.SearchJobsResponse;
import com.google.cloud.talent.v4beta1.TenantName;
import java.io.IOException;
public class HistogramSearchJobs {
public static void searchJobs() throws IOException {
// TODO(developer): Replace these variables before running the sample.
String projectId = "your-project-id";
String tenantId = "your-tenant-id";
String query = "count(base_compensation, [bucket(12, 20)])";
searchJobs(projectId, tenantId, query);
}
// Search Jobs with histogram queries.
public static void searchJobs(String projectId, String tenantId, String query)
throws IOException {
// Initialize client that will be used to send requests. This client only needs to be created
// once, and can be reused for multiple requests. After completing all of your requests, call
// the "close" method on the client to safely clean up any remaining background resources.
try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
TenantName parent = TenantName.of(projectId, tenantId);
String domain = "http://www.jobUrl.com";
String sessionId = "Hashed session identifier";
String userId = "Hashed user identifier";
RequestMetadata requestMetadata =
RequestMetadata.newBuilder()
.setDomain(domain)
.setSessionId(sessionId)
.setUserId(userId)
.build();
HistogramQuery histogramQueriesElement =
HistogramQuery.newBuilder().setHistogramQuery(query).build();
SearchJobsRequest request =
SearchJobsRequest.newBuilder()
.setParent(parent.toString())
.setRequestMetadata(requestMetadata)
.addHistogramQueries(histogramQueriesElement)
.build();
for (SearchJobsResponse.MatchingJob responseItem :
jobServiceClient.searchJobs(request).iterateAll()) {
System.out.format("Job summary: %s%n", responseItem.getJobSummary());
System.out.format("Job title snippet: %s%n", responseItem.getJobTitleSnippet());
Job job = responseItem.getJob();
System.out.format("Job name: %s%n", job.getName());
System.out.format("Job title: %s%n", job.getTitle());
}
}
}
}Python
Cloud Talent Solution 클라이언트 설치 및 만들기에 대한 자세한 내용은 Cloud Talent Solution 클라이언트 라이브러리를 참조하세요.
from google.cloud import talent
import six
def search_jobs(project_id, tenant_id, query):
"""
Search Jobs with histogram queries
Args:
query Histogram query
More info on histogram facets, constants, and built-in functions:
https://godoc.org/google.golang.org/genproto/googleapis/cloud/talent/v4beta1#SearchJobsRequest
"""
client = talent.JobServiceClient()
# project_id = 'Your Google Cloud Project ID'
# tenant_id = 'Your Tenant ID (using tenancy is optional)'
# query = 'count(base_compensation, [bucket(12, 20)])'
if isinstance(project_id, six.binary_type):
project_id = project_id.decode("utf-8")
if isinstance(tenant_id, six.binary_type):
tenant_id = tenant_id.decode("utf-8")
if isinstance(query, six.binary_type):
query = query.decode("utf-8")
parent = f"projects/{project_id}/tenants/{tenant_id}"
domain = "www.example.com"
session_id = "Hashed session identifier"
user_id = "Hashed user identifier"
request_metadata = {"domain": domain, "session_id": session_id, "user_id": user_id}
histogram_queries_element = {"histogram_query": query}
histogram_queries = [histogram_queries_element]
# Iterate over all results
results = []
request = talent.SearchJobsRequest(
parent=parent,
request_metadata=request_metadata,
histogram_queries=histogram_queries,
)
for response_item in client.search_jobs(request=request).matching_jobs:
print("Job summary: {response_item.job_summary}")
print("Job title snippet: {response_item.job_title_snippet}")
job = response_item.job
results.append(job)
print("Job name: {job.name}")
print("Job title: {job.title}")
return results
관련성 임곗값
히스토그램 요청은 관련성 임곗값을 사용하지 않습니다. 히스토그램 검색과 동일한 채용정보 검색 간에 개수가 일치하도록 하려면 채용정보 검색의 disableKeywordMatch가 false여야 합니다.