Cloud Talent Solution을 사용하면 Cloud Talent Solution의 색인에 저장된 채용정보를 검색할 수 있습니다. 이 문서에서는 Cloud Talent Solution의 여러 가지 검색 방법과 관련 서비스를 설명합니다.
검색 요청
취업정보 검색 요청을 만들려면 POST 요청을 jobs:search 엔드포인트로 보내서 검색 데이터를 본문에 전달하십시오.
필수 필드
다음은 필수 필드입니다.
searchMode: 적용할 취업정보 검색 유형을 지정합니다. 옵션은 다음과 같습니다.JOB_SEARCH: 기본값이며 권장되는 검색 모드입니다. 모든 채용정보를 대상으로 검색합니다. 가장 관련성이 높은 채용정보를 검색어와 관련된 순서대로 반환합니다.FEATURED_JOB_SEARCH:promotionValue가 0보다 큰 취업정보만 검색합니다. 결과는 가장 높은promotionValue순서로 정렬됩니다. 동점인 경우 관련성을 사용하여 위치를 결정합니다. 자세한 내용은 추천 취업정보를 참조하세요.
흔히 사용되는 필드
JobQuery: 검색할 취업정보 기준을 지정합니다. 여기에는 위치, 취업정보 카테고리, 고용 유형, 텍스트 쿼리, 회사 등이 포함됩니다. 자세한 내용은 검색 필터를 참조하세요.requestMetadata: 이 검색 요청의 사용자 및 세션 정보를 포함합니다. 자세한 내용은 RequestMetadata를 참조하세요.jobView: 일치하는 각 취업정보에 대해 반환되는 필드 수를 정의합니다.JOB_VIEW_SMALL(기본값),JOB_VIEW_MINIMAL또는JOB_VIEW_FULL일 수 있습니다. 각 옵션에 대한 설명은JobView참조 문서에 있습니다.orderBy: 반환되는 취업정보 정렬 순서입니다. 허용 값은 참조 문서를 참조하세요. 기본값은 관련성에 따른 내림차순(RELEVANCE_DESC) 정렬입니다.
관련성 임계값 및 위치/카테고리 확장
검색 시 더 많은 채용정보를 반환하려면 다음 두 필드를 사용하여 관련성 제한을 완화합니다.
enableBroadening:true로 설정하면 더 많은 결과를 반환하기 위해 검색 요청의 위치 및 취업정보 범주에 대한 제한이 완화됩니다. 예를 들어 검색 요청이 Anytown, WA 2마일 반경 이내로 취업정보를 지정한 경우 이 플래그를true로 설정하면 NextTownOver, WA에서도 취업정보가 반환될 수 있습니다.disableKeywordMatch: 이 플래그는 기본적으로 false입니다. 이 플래그를 false로 설정하면 Cloud Talent Solution은 직책 또는 설명이 쿼리 문자열과 정확히 일치하는 채용정보뿐만 아니라 검색어와 관련된 채용정보도 추가로 반환합니다.
RequestMetadata
각 검색 및 히스토그램 요청에는 RequestMetadata 객체가 포함되어야 합니다. 이 객체에는 검색을 시작하는 사용자에 대한 정보가 포함되어 있습니다.
이 객체가 중요한 이유는 다음과 같습니다.
사용자 일관성. Cloud Talent Solution은 검색 관련성을 향상시키기 위해 여러 버전의 기본 모델을 동시에 실행합니다. 이 필드를 채우면 구직자에게 일관된 환경을 제공할 수 있습니다. Cloud Talent Solution은 userId, sessionId, 도메인에 따라 식별된 구직자에게 일관된 환경을 보장합니다. 참고: 이러한 필드는 난독화되어야 합니다.
검색 개선사항. 조정 알고리즘은 사용자가 제공하는 구직자 데이터와 함께
RequestMetadata필드에 제공된 정보를 기반으로 합니다. 이 알고리즘은 검색결과 관련성을 향상시킵니다.
검색 연산자
| 연산자 | 설명 |
|---|---|
| ( ) | 하나 이상의 키워드를 그룹화합니다. |
| AND | 연산자 양쪽에 있는 키워드 또는 키워드 그룹과 관련된 결과를 검색합니다. |
| OR | 연산자 양쪽 중 한쪽에 있는 키워드 또는 키워드 그룹과 관련된 결과를 검색합니다. |
| NOT | 연산자 바로 다음 괄호 안에 있는 키워드 또는 키워드 그룹과 관련된 결과를 제외합니다. |
| - | 연산자 다음에 추가된 키워드 또는 키워드 그룹과 관련된 결과를 제외합니다. |
예:
"software OR java"는 메타데이터에 '소프트웨어' 또는 '자바'가 포함된 취업정보를 반환합니다."software" -java는 '소프트웨어'와 관련된 취업정보를 반환하지만 '자바'와 관련된 취업정보를 제외합니다."(software OR java) AND (marketing)"은 소프트웨어'와 '마케팅' 모두에 관련된 취업정보와 'java'와 '마케팅' 모두에 관련된 취업정보를 반환합니다.
구직자 쿼리
검색어는 실제 채용정보 관련 항목으로도 감지될 수 있습니다. 예를 들어 '인턴'에 대한 쿼리인 경우 Cloud Talent Solution 엔진은 이를 고용 유형 'INTERN'으로 취급하여 EMPLOYMENT_TYPE -INTERN인 취업정보만 검색합니다. 따라서 취업정보 설명에 인턴이 포함되어 있어도 취업정보의 고용 유형이 다른 것으로 설정되어 있으면 해당 취업정보는 반환되지 않습니다.
문제해결
각 검색 요청은 Google 시스템에서 해당 검색의 매개변수와 응답을 추적하는 데 사용되는 고유한 검색 requestID를 생성합니다. 이 ID는 특정 검색 및 CRUD 요청과 관련된 문제를 해결하는 데 중요하므로 적절히 로깅되어야 합니다. 검색 응답 본문의 ResponseMetadata 필드 또는 연관된 CRUD 호출 응답 객체에 requestId가 반환됩니다.
관련성, 검색 문의, 색인 생성 문의 등과 관련된 지원을 요청하려면 관련 요청 ID 또는 요청 자체를 포함하여 Google 지원팀에 티켓을 제출합니다.
결과 수
결과 수는 구직자에게 검색결과 수를 알리는 데 사용됩니다. 결과 수가 히스토그램 결과 또는 실제 반환된 취업정보 수와 항상 일치하지는 않습니다. 취업정보 검색은 최대 5,000개의 취업정보를 반환합니다.
페이지 나누기
기본적으로 취업정보 검색은 페이지당 100개의 결과를 반환합니다(총 결과 수가 100 미만인 경우 더 적음). 이 기능과 관련된 필드를 사용하여 페이지로 나누기를 구현할 수 있습니다.
pageSize: 페이지당 반환된 결과 수nextPageToken: 다음 페이지 결과의 시작 위치를 지정하는 각 검색 결과 페이지의 결과와 함께 반환되는 고유 토큰 더 이상 결과가 없으면 이 필드는 비어 있습니다.offset: 해당 페이지의 맨 위에 반환된 취업정보의 관련성 순위와 1(반환된 취업정보 중 가장 관련성이 높은 취업정보) 사이의 오프셋을 지정합니다. 예를 들어 사용자가 검색을 수행하고pageSize가 10으로 설정되었습니다. 첫 번째 페이지는 맨 위에 1번 취업정보를 반환하므로 이 페이지의offset값은 0입니다. 다음 페이지는 맨 위에 11번 취업정보를 반환합니다. 이 페이지의offset은 10입니다.
지연 시간 문제를 방지하려면 페이지 크기를 결과 20개 이하로 설정하십시오. 구직자에게 렌더링되는 페이지당 한 번씩 검색을 호출하는 것이 좋습니다. 단일 검색 호출로 다수의 취업정보를 반환하고 클라이언트 측에서 페이지로 나누기를 사용하면 머신러닝 모델이 취업정보 분석 프레임워크를 통해 정확히 학습하지 못할 수 있습니다.
맞춤법 검사
맞춤법 검사는 맞춤법이 틀렸을 가능성이 있는 검색어를 찾아서 수정하고 수정된 쿼리에 따른 결과를 반환하는 Cloud Talent Solution 검색 요청의 기능입니다. 예를 들어 맞춤법 검사를 사용 설정한 경우 구직자가 'manager' 대신 'manaer'를 검색하면 Cloud Talent Solution은 'manager'에 맞는 채용정보를 반환합니다. JobQuery의 disableSpellCheck 필드를 설정하여 맞춤법 검사를 사용 설정/중지할 수 있습니다. 맞춤법 검사를 사용 설정한 경우 검색 응답의 spellResult 필드에서 수정된 쿼리를 확인할 수 있습니다.