검색 개요

Cloud Talent Solution을 사용하면 취업정보 검색의 색인에 저장된 취업정보를 검색할 수 있습니다. 취업정보 검색은 맞춤설정할 수 있도록 설계되었으므로 비즈니스 요구사항에 맞게 변경할 수 있습니다. 이 페이지는 CTS 취업정보 검색에서 사용 가능한 검색 기능에 대한 개요입니다.

검색 요청

취업정보 검색 요청을 만들려면 POST 요청을 jobs:search 엔드포인트로 보내서 검색 데이터를 본문에 전달하십시오.

일반적으로 사용되는 필드(선택사항)

  • JobQuery: JobQuery 객체는 query 문자열과 해당 문자열에 적용된 필터 등 두 부분으로 구성됩니다. 이 기능을 통해 사용자는 하나 이상의 필터(위치, 통근 시간, 보상 등)를 사용하여 쿼리 문자열(예: '통신 지원')을 검색할 수 있습니다. 자세한 정보 및 사용 가능한 필터 옵션 목록은 검색 필터를 참조하십시오.

  • searchMode: 적용할 검색 유형을 지정합니다. 옵션은 다음과 같습니다.

    • JOB_SEARCH(권장): 모든 취업정보 객체를 검색하는 기본 검색 모드입니다. 가장 관련성이 높은 취업정보를 검색어와 관련된 순서대로 사용자에게 반환합니다.
    • FEATURED_JOB_SEARCH: promotionValue가 0을 초과하는 취업정보 객체만 검색합니다. 결과는 가장 높은 promotionValue 순서로 정렬됩니다. 동점인 경우 관련성을 사용하여 위치를 결정합니다. 자세한 내용은 추천 취업정보를 참조하세요.
  • jobView: 일치하는 각 취업정보 객체에 대해 반환되는 필드 수를 정의합니다. JOB_VIEW_SMALL(기본값), JOB_VIEW_MINIMAL 또는 JOB_VIEW_FULL일 수 있습니다. 각 옵션에 대한 설명은 JobView 참조 문서에서 찾을 수 있습니다.

  • orderBy: 반환되는 취업정보 정렬 순서입니다. 허용되는 값의 참조 문서를 확인하세요. 기본값은 관련성에 따른 내림차순(RELEVANCE_DESC) 정렬입니다.

필수 필드

다음은 필수 필드입니다.

  • requestMetadata: 이 검색 요청의 사용자 및 세션 정보를 포함합니다.

RequestMetadata

각 검색 및 히스토그램 요청에는 RequestMetadata 객체가 포함되어야 합니다. 이 객체에는 검색을 시작하는 사용자에 대한 정보가 포함되어 있습니다. 이는 크게 두 가지 이유로 중요합니다.

  • 사용자 일관성: Cloud Talent Solution은 여러 버전의 기본 모델을 동시에 실행하여 검색 관련성을 향상시킵니다. CTS는 userId, sessionId, 도메인에 따라 식별된 구직자에게 일관된 환경을 보장합니다. 이러한 필드는 난독화해야 합니다.

  • 검색 개선사항: 조정 알고리즘은 사용자가 제공하는 구직자 데이터와 함께 RequestMetadata 필드에 제공된 정보를 기반으로 합니다. 이 알고리즘은 검색결과 관련성을 향상시킵니다.

검색 연산자 사용

아래 표의 검색 연산자는 단독으로 또는 조합하여 사용할 수 있습니다.

연산자 설명
( ) 하나 이상의 키워드를 그룹화합니다.
OR 연산자 양쪽에 있는 키워드 또는 키워드 그룹과 관련된 결과를 검색합니다. 예: "software OR java"는 메타데이터에 '소프트웨어' 또는 '자바'가 포함된 취업정보 중 한 쪽을 반환합니다.
연산자 양쪽에 있는 키워드 또는 키워드 그룹과 관련된 결과를 검색합니다. 예: "(software OR java) AND (marketing)"은 '소프트웨어' '마케팅' 모두에 관련된 취업정보 또는 '자바' '마케팅' 모두에 관련된 취업정보 중 한 쪽을 반환합니다.
NOT 연산자 바로 다음에 있는 키워드 또는 키워드 그룹과 관련된 결과를 제외합니다. 키워드 또는 키워드 그룹은 괄호 안에 있어야 합니다.
- 연산자 다음에 있는 키워드 또는 키워드 그룹과 관련된 결과를 제외합니다. 예: "software -java"는 '소프트웨어'와 관련된 취업정보를 반환하지만 '자바'와 관련된 취업정보를 제외합니다.
요청: 지정된 요청 ID를 가진 취업정보를 반환합니다. 예를 들어, req:1234는 요청 ID가 1234인 채용작업을 반환합니다.

구직자 쿼리

검색어는 실제 취업정보 관련 항목으로도 감지될 수 있습니다. 예를 들어, 사용자가 '인턴'을 쿼리하는 경우 Cloud Talent Solution은 이를 고용 유형 INTERN으로 취급하고 EMPLOYMENT_TYPE - INTERN가 지정된 취업정보를 필터링합니다. 따라서 해당 취업정보에 대한 EMPLOYMENT_TYPE 필드가 다른 것으로 설정된 경우 설명에 '인턴'이 있는 Job 객체도 반환되지 않습니다.

문제해결

각 검색 요청은 취업정보 검색 시스템에서 고유 검색 requestID를 생성합니다. 이 값은 해당 검색의 매개변수와 응답을 추적하는 데 사용됩니다. 이 ID는 특정 검색 또는 CRUD 요청과 관련된 문제를 해결하는 데 중요하므로 적절히 로깅되어야 합니다. 검색 응답 본문ResponseMetadata 필드 또는 연관된 CRUD 호출 응답 객체에 requestID가 반환됩니다.

관련성, 검색 문의, 색인 생성 문의 등과 관련된 지원을 요청하려면 관련 requestID 또는 요청 자체를 포함하여 Google 지원팀에 티켓을 제출합니다.

결과 수

결과 수는 구직자에게 검색결과 수를 알리는 데 사용됩니다. 결과 수가 히스토그램 결과 또는 실제 반환된 취업정보 수와 항상 일치하지는 않습니다. 취업정보 검색은 최대 5,000개의 취업정보를 반환합니다.

페이지로 나누기(선택사항)

기본적으로 취업정보 검색은 단일 호출당 100개의 결과를 반환합니다(총 결과 수가 100 미만인 경우 더 적음). 100개를 초과하는 결과를 보려면 페이지로 나누기를 구현할 수 있습니다. 총 결과 수가 최대 5,000을 초과하면 5,000번째 결과를 포함하는 페이지 뒤의 모든 페이지가 공백으로 표시됩니다. 아래 필드는 페이지로 나누기를 제어합니다.

  • pageSize: 반환된 결과 수
  • nextPageToken: 다음 페이지 결과의 시작 위치를 지정하는 각 검색 결과 페이지의 결과와 함께 반환되는 고유 토큰 더 이상 결과가 없으면 이 필드는 비어 있습니다.
  • offset: 해당 페이지의 맨 위에 반환된 취업정보의 관련성 순위와 1(반환된 취업정보 중 가장 관련성이 높은 취업정보) 사이의 오프셋을 지정합니다. 예를 들어 사용자가 검색을 수행하고 pageSize가 10으로 설정되었습니다. 첫 번째 페이지는 맨 위에 1번 취업정보를 반환하므로 이 페이지의 offset 값은 0입니다. 다음 페이지는 맨 위에 11번 취업정보를 반환합니다. 이 페이지의 offset은 10입니다.

페이지로 나누기를 실행하는 두 가지 주요 방법이 있습니다. pageSizenextPageToken을 사용하여 다음 결과 페이지를 직접 가리킬 수 있습니다(각 페이지에는 후속 페이지를 가리키는 새 nextPageToken 값이 있음). 이 방법을 사용하면 항상 결과 상단에서 시작하여 순차적으로 페이지를 통과합니다. 또는 offset과 함께 pageSize를 사용하여 각 페이지 상단에 표시되는 번호가 매겨진 결과를 직접 지정할 수 있습니다. nextPageToken 대신 offest을 사용하면 결과 집합의 어느 지점으로도 이동할 수 있습니다.

지연 시간 문제를 방지하려면 페이지 크기를 20개 결과 이하로 설정하는 것이 좋습니다. 구직자에게 렌더링되는 페이지당 한 번씩 검색을 호출하는 것이 좋습니다. 단일 검색 호출로 다수의 취업정보를 반환하고 클라이언트 측에서 페이지로 나누기를 사용하면 머신러닝 모델이 취업정보 분석 프레임워크를 통해 정확히 학습하지 못할 수 있습니다.

맞춤법 검사

맞춤법 검사는 맞춤법이 틀렸을 가능성이 있는 검색어를 찾아서 수정하고 수정된 쿼리에 따른 결과를 반환하는 CTS 검색 요청의 기능입니다. 예를 들어 맞춤법 검사를 사용 설정한 경우 구직자가 'manager' 대신 'manaer'를 검색하면 CTS는 'manager'에 맞는 취업정보를 반환합니다. 검색 요청의 disableSpellCheck 필드를 설정하여 맞춤법 검사를 사용 설정 또는 중지할 수 있습니다. 맞춤법 검사를 사용 설정한 경우 검색 응답의 spellResult 필드에서 수정된 쿼리를 확인할 수 있습니다.