히스토그램(v3)

제공된 검색과 관련된 채용정보 수를 히스토그램으로 표현할 수 있습니다. 히스토그램 속성이 설정된 검색 요청은 검색결과 및 특정 쿼리와 일치하는 모든 채용정보 수를 요청된 searchType에 따라 구분하여 반환합니다.

예를 들어 히스토그램 검색은 고객의 채용정보 세트에서 고용 유형별(전일제, 시간제 등) 채용정보 수를 반환할 수 있습니다.

Cloud Talent Solution 베타 출시 버전(v3p1beta1)을 사용하면 덜 구조화되고 더 유연하며 더 직관적인 방식으로 히스토그램을 정의할 수 있습니다. 히스토그램 표현은 변경되지 않습니다.

장점

히스토그램 쿼리의 새로운 구조는 개발자가 히스토그램 요청을 더 직관적인 방법으로 정의할 수 있게 해줄 뿐 아니라 버킷, 범위 등을 더 명확히 정의할 수 있게 해 줍니다.

용도

이전의 히스토그램을 정의하는 구조화된 필드가 검색어의 새로운 히스토그램 부분으로 대체됩니다.

코드 샘플

다음 코드 샘플은 히스토그램 결과를 반환합니다.

histogramQuery 필드는 이제 히스토그램을 정의하는 표현식인 단일 문자열 필드입니다. 히스토그램 쿼리에 사용할 수 있는 함수에 대한 자세한 내용은 HistogramQuery를 참조하세요.

자바

Cloud Talent Solution 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Talent Solution 클라이언트 라이브러리를 참조하세요. 


/**
 * New histogram search
 */
public static void newHistogramSearch(String companyName) throws IOException {
  // Make sure to set the requestMetadata the same as the associated search request
  RequestMetadata requestMetadata =
      new RequestMetadata()
          // Make sure to hash your userID
          .setUserId("HashedUserId")
          // Make sure to hash the sessionID
          .setSessionId("HashedSessionID")
          // Domain of the website where the search is conducted
          .setDomain(
              "www.google.com");

  HistogramQuery companyIdHistogramQuery = new HistogramQuery()
      .setHistogramQuery("count(company_id)");
  HistogramQuery customFieldHistogramQuery = new HistogramQuery()
      .setHistogramQuery("count(string_custom_attribute[\"someFieldName1\"])");

  // conducted.
  SearchJobsRequest searchJobsRequest =
      new SearchJobsRequest()
          .setRequestMetadata(requestMetadata)
          .setHistogramQueries(Arrays.asList(companyIdHistogramQuery, customFieldHistogramQuery));
  if (companyName != null) {
    searchJobsRequest.setJobQuery(new JobQuery().setCompanyNames(Arrays.asList(companyName)));
  }

  SearchJobsResponse searchJobsResponse =
      talentSolutionClient
          .projects()
          .jobs()
          .search(DEFAULT_PROJECT_ID, searchJobsRequest)
          .execute();

  System.out.println(searchJobsResponse);
}

Python

Cloud Talent Solution 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Talent Solution 클라이언트 라이브러리를 참조하세요. 

def new_histogram_search(client_service, company_name):
    request_metadata = {
        'user_id': 'HashedUserId',
        'session_id': 'HashedSessionId',
        'domain': 'www.google.com'
    }
    company_id_histogram_query = {
        'histogram_query': 'count(company_id)'
    }
    custom_field_histogram_query = {
        'histogram_query': 'count(string_custom_attribute["someFieldName1"])'
    }
    request = {
        'search_mode': 'JOB_SEARCH',
        'request_metadata': request_metadata,
        'histogram_queries': [company_id_histogram_query, custom_field_histogram_query]
    }
    if company_name is not None:
        request.update({'job_query': {'company_names': [company_name]}})
    response = client_service.projects().jobs().search(
        parent=parent, body=request).execute()
    print(response)