A Cloud Talent Solution permite que os utilizadores pesquisem tarefas que armazenou no índice da Cloud Talent Solution. Este documento explica as várias ofertas de pesquisa e relacionadas da Cloud Talent Solution.
Pedidos de pesquisa
Para fazer um pedido de pesquisa de emprego, envie um pedido POST para o ponto final jobs:search, passando os dados de pesquisa no corpo.
Campos obrigatórios
O seguinte campo é obrigatório:
searchMode: especifica o tipo de pesquisa de emprego a aplicar. As opções são:JOB_SEARCH: este é o modo de pesquisa predefinido e recomendado. Todas as ofertas de emprego são pesquisadas. Os trabalhos mais relevantes são devolvidos por ordem de relevância para a consulta de pesquisa.FEATURED_JOB_SEARCH: procura apenas trabalhos com um valorpromotionValuesuperior a 0. Os resultados são ordenados pelapromotionValuemais elevada primeiro; em caso de empate, a relevância é usada para decidir a posição. Consulte a secção Empregos em destaque para mais informações.
Campos usados frequentemente
JobQuery: especifique os critérios da tarefa para correspondência. Estas incluem localização, categorias de emprego, tipos de emprego, consultas de texto, empresas, etc. Consulte os filtros de pesquisa para mais informações.requestMetadata: contém informações do utilizador e da sessão para este pedido de pesquisa. Consulte RequestMetadata para ver detalhes.jobView: Define o número de campos devolvidos para cada tarefa correspondente. Pode serJOB_VIEW_SMALL(a predefinição),JOB_VIEW_MINIMALouJOB_VIEW_FULL. As descrições de cada opção encontram-se naJobViewreferência.orderBy: a ordem de ordenação dos trabalhos devolvidos. Consulte a referência para ver os valores permitidos. A predefinição é ordenar por relevância, ordem decrescente (RELEVANCE_DESC).
Limites de relevância e alargamento da localização/categoria
Para devolver um número mais elevado de trabalhos para as suas pesquisas, os dois campos seguintes relaxam as restrições de relevância:
enableBroadening: se definir este valor comotrue, as restrições relativas à localização e à categoria profissional do pedido de pesquisa são menos rigorosas, de modo a devolver mais resultados. Por exemplo, se um pedido de pesquisa especificou empregos num raio de 3,2 km de Anytown, WA, definir esta flag comotruetambém pode devolver empregos de NextTownOver, WA.disableKeywordMatch: este sinalizador é falso por predefinição. Definir esta flag como false permite que a Cloud Talent Solution anexe os empregos relevantes para esta consulta de pesquisa com empregos que também correspondam à string de consulta exata no título ou na descrição.
RequestMetadata
Cada pedido de pesquisa e histograma deve incluir um objeto
RequestMetadata. Este objeto contém informações sobre o utilizador que inicia a pesquisa.
Existem alguns motivos pelos quais este objeto é importante:
Consistência do utilizador. A Cloud Talent Solution executa várias versões dos modelos subjacentes em simultâneo para melhorar a relevância da pesquisa. Preencha este campo para garantir que um candidato a emprego tem experiências consistentes. A Cloud Talent Solution garante que um candidato a emprego (identificado por userId, sessionId e domain) tem uma experiência consistente. Nota: estes campos devem ser ocultados.
Melhorias na pesquisa.Os algoritmos de otimização baseiam-se nas informações fornecidas nos campos
RequestMetadata, juntamente com os dados dos candidatos que fornece. Isto melhora a relevância dos resultados da pesquisa.
Operadores de pesquisa
| Operador | Descrição |
|---|---|
| ( ) | Agrupa uma ou mais palavras-chave. |
| E | Pesquisa resultados relevantes para as palavras-chave ou os grupos de palavras-chave em ambos os lados do operador. |
| OU | Pesquisa resultados relevantes para a palavra-chave ou o grupo de palavras-chave de qualquer lado do operador. |
| NÃO | Exclui resultados relevantes para a palavra-chave ou o grupo de palavras-chave, entre parênteses, imediatamente a seguir ao operador. |
| - | Exclui resultados relevantes para a palavra-chave ou o grupo de palavras-chave anexado ao operador. |
Por exemplo:
"software OR java"devolve trabalhos com "software" ou "java" nos respetivos metadados."software" -javadevolve empregos relevantes para "software", mas exclui empregos relevantes para "java"."(software OR java) AND (marketing)"devolve trabalhos relevantes para "software" e "marketing", e trabalhos relevantes para "java" e "marketing".
Consulta de candidato a emprego
Os termos de pesquisa também podem ser detetados como entidades reais relacionadas com empregos. Por exemplo, se a consulta fosse para "estagiário", o Cloud Talent Solution trataria isto como o tipo de emprego "ESTAGIÁRIO" e filtraria os trabalhos que só tinham o EMPLOYMENT_TYPE - ESTAGIÁRIO. Por conseguinte, mesmo que o termo estagiário estivesse necessariamente na descrição das funções, não seria devolvido se o tipo de emprego para esse trabalho estivesse definido como algo diferente.
Resolução de problemas
Cada pedido de pesquisa gera uma pesquisa exclusiva requestID no nosso sistema que é usada para acompanhar os parâmetros dessa pesquisa, bem como a resposta. Isto é
crucial na resolução de problemas relacionados com pesquisas específicas, pedidos CRUD e
deve ser registado adequadamente. O requestId é devolvido no campo ResponseMetadata no corpo da resposta de pesquisa ou no objeto de resposta da chamada CRUD associada.
Para problemas de apoio técnico relacionados com a relevância, consultas de pesquisa, consultas de indexação, etc., apresente um pedido à nossa equipa de apoio técnico e inclua os IDs de pedidos relevantes ou os próprios pedidos.
Contagens de resultados
A contagem de resultados é usada para comunicar o número de resultados da pesquisa ao candidato a emprego. Isto nem sempre corresponde aos resultados do histograma ou ao número real de trabalhos devolvidos. A pesquisa de empregos devolve um máximo de 5000 empregos.
Paginação
Por predefinição, a pesquisa de emprego devolve 100 resultados por página (ou menos, se o número total de resultados for inferior a 100). Pode implementar a paginação através dos campos associados a esta funcionalidade.
pageSize: o número de resultados devolvidos por página.nextPageToken: um token único, devolvido com os resultados de cada página de resultados da pesquisa, que especifica a posição inicial da página seguinte de resultados. Este campo fica vazio se não existirem mais resultados.offset: especifica o desvio entre a classificação de relevância do trabalho devolvido na parte superior de uma determinada página e 1 (o trabalho mais relevante devolvido). Por exemplo, um utilizador faz uma pesquisa epageSizeestá definido como 10. A primeira página devolve a tarefa n.º 1 na parte superior. Por conseguinte, o valoroffsetpara esta página é 0. A página seguinte devolve a tarefa n.º 11 na parte superior;offsetpara esta página é 10.
Defina o tamanho da página para 20 resultados ou menos para evitar problemas de latência. Como prática recomendada, emita uma chamada de pesquisa separada por página renderizada ao candidato a emprego. A alternativa, uma única chamada de pesquisa para devolver um número maior de trabalhos e paginar no lado do cliente, impede a capacidade do modelo de aprendizagem automática de aprender com precisão através da estrutura de análise de trabalhos.
Verificação ortográfica
A verificação ortográfica é uma funcionalidade do pedido de pesquisa da Cloud Talent Solution que tem em conta os termos de pesquisa com erros ortográficos, corrige-os e devolve resultados com base na consulta corrigida. Por exemplo, quando a verificação ortográfica está ativada, se um candidato a emprego pesquisar "manaer" em vez de "manager", o Cloud Talent Solution devolve empregos para "manager". A verificação ortográfica pode ser ativada/desativada definindo o campo disableSpellCheck de JobQuery. Se a verificação ortográfica estiver ativada, pode encontrar a consulta corrigida na resposta de pesquisa, no campo spellResult.