A Cloud Talent Solution permite que os utilizadores pesquisem empregos que armazena no índice de pesquisa de emprego. A pesquisa de empregos foi concebida para ser personalizável e pode ser alterada para satisfazer as necessidades da sua empresa. Esta página apresenta uma vista geral das funções de pesquisa disponíveis na CTS Job Search.
Fazer pedidos de pesquisa
Para fazer um pedido de pesquisa de emprego, envie um pedido POST para o ponto final jobs:search, transmitindo os dados de pesquisa no corpo.
Campos usados frequentemente (opcional)
JobQuery: o objetoJobQueryconsiste em dois componentes, uma stringquerye os filtros aplicados a essa string. Esta funcionalidade permite que os seus utilizadores pesquisem numa string de consulta (como "assistente de comunicações") através de um ou mais filtros (localização, tempo de trajeto, remuneração, etc.). Consulte Filtros de pesquisa para ver mais informações e uma lista das opções de filtro disponíveis.searchMode: especifica o tipo de pesquisa a aplicar. As opções são:JOB_SEARCH(recomendado): este é o modo de pesquisa predefinido, que pesquisa todos os objetos Job. Os trabalhos mais relevantes são devolvidos ao utilizador por ordem de relevância para a consulta de pesquisa.FEATURED_JOB_SEARCH: pesquisa apenas objetos Job com um valor depromotionValuesuperior a 0. Os resultados são ordenados pela classificação mais elevadapromotionValueprimeiro. Em caso de empate, a relevância é usada para decidir a posição. Consulte o artigo Anúncios de emprego em destaque para mais informações.
jobView: Define o número de campos devolvidos para cada objeto Job correspondente. Pode serJOB_VIEW_SMALL(predefinição),JOB_VIEW_MINIMALouJOB_VIEW_FULL. Pode encontrar descrições de cada opção na documentação deJobViewreferência.orderBy: a ordem de ordenação dos trabalhos devolvidos. Consulte a documentação de referência para ver os valores permitidos. A predefinição é ordenar por relevância, por ordem descendente (RELEVANCE_DESC).
Campos obrigatórios
O seguinte campo é obrigatório:
requestMetadata: contém informações do utilizador e da sessão para este pedido de pesquisa.
RequestMetadata
Cada pedido de pesquisa e histograma tem de incluir um objeto
RequestMetadata. Este objeto contém informações sobre o utilizador que inicia a pesquisa.
É importante por dois motivos principais:
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. O CTS garante que um candidato a emprego (identificado por userId, sessionId e domain) tem uma experiência consistente. Estes campos devem ser ofuscados.
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.
Utilizar operadores de pesquisa
Os operadores de pesquisa na tabela abaixo podem ser usados sozinhos ou em combinação.
| Operador | Descrição |
|---|---|
| ( ) | Agrupa uma ou mais palavras-chave. |
| OU | Pesquisa resultados relevantes para as palavras-chave ou os grupos de palavras-chave em qualquer um dos lados do operador. Exemplo: "software OR java" devolve trabalhos com "software" ou "java" nos respetivos metadados. |
| E | Pesquisa resultados relevantes para as palavras-chave ou os grupos de palavras-chave em ambos os lados do operador. Exemplo: "(software OR java) AND (marketing)" devolve trabalhos que são relevantes para "software" e "marketing", ou trabalhos que são relevantes para "java" e "marketing". |
| NÃO | Exclui resultados relevantes para a palavra-chave ou o grupo de palavras-chave imediatamente a seguir ao operador. A palavra-chave ou o grupo de palavras-chave tem de estar entre parênteses. |
| - | Exclui resultados relevantes para a palavra-chave ou o grupo de palavras-chave após o operador. Exemplo: "software -java" devolve trabalhos relevantes para "software", mas exclui trabalhos relevantes para "java". |
| req ou requisition: | Devolve trabalhos com o ID de requisição especificado. Por exemplo, req:1234 devolve trabalhos com o ID de requisição 1234. |
Consultas de candidatos a emprego
Os termos de pesquisa também podem ser detetados como entidades relacionadas com empregos reais. Por exemplo, se um utilizador pesquisar "estágio", o Cloud Talent Solution trata isto como o tipo de emprego INTERN e filtra os trabalhos com a designação EMPLOYMENT_TYPE - INTERN. Por conseguinte, mesmo um objeto Job com "estágio" na respetiva descrição não seria devolvido se o campo EMPLOYMENT_TYPE desse Job estivesse definido para outra coisa.
Resolução de problemas
Cada pedido de pesquisa gera um ID de pesquisa exclusivo no sistema de pesquisa de empregos.requestID Este valor é usado para acompanhar os parâmetros dessa pesquisa, bem como a resposta. Isto é fundamental na resolução de problemas relacionados com pesquisas específicas ou 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 requestIDs relevantes ou os próprios pedidos.
Diagnostique problemas de dados através da consola
Use a página Empregos e empresas na consola do CTS para diagnosticar problemas relacionados com os dados de empregos. Se precisar de resolver problemas de dados, pode ver estatísticas de empregos, pesquisar metadados de empregos específicos e exportar dados por emprego, empresa ou inquilino. Consulte a secção de documentação Dados de empregos e empresas para saber como usar estas ferramentas.
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 (opcional)
Por predefinição, a pesquisa de emprego devolve 100 resultados numa única chamada (ou menos, se o número total de resultados for inferior a 100). Para ver mais de 100 resultados, pode implementar a paginação. Se o número total de resultados exceder o máximo de 5000, todas as páginas após a página que contém o resultado 5000 vão estar em branco. Os campos abaixo controlam a paginação:
pageSize: o número de resultados devolvidos.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.
Existem duas formas principais de implementar a paginação. Pode usar pageSize e nextPageToken para apontar diretamente para a página seguinte de resultados (cada página tem um novo valor nextPageToken que aponta para a página subsequente). Se usar este método, começa sempre na parte superior dos resultados e navega pelas páginas em ordem sequencial. Em alternativa, pode usar pageSize com offset para especificar diretamente que resultado numerado aparece na parte superior de cada página. A utilização de offset em vez de nextPageToken permite-lhe aceder a qualquer ponto no conjunto de resultados.
Recomendamos que 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.
Se usar a paginação, todos os campos no pedido, exceto pageSize,nextPageToken e offset, têm de permanecer iguais. Se estes campos não forem iguais, a ordem das tarefas devolvidas nos resultados pode ser inconsistente.
Verificação ortográfica
A verificação ortográfica é uma funcionalidade opcional de um pedido de pesquisa do CTS. Tem em conta os termos de pesquisa com potenciais 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 CTS devolve empregos para "manager". A verificação ortográfica pode ser ativada/desativada definindo o campo disableSpellCheck do pedido de pesquisa.
Se a verificação ortográfica estiver ativada, a consulta corrigida pode ser encontrada na resposta de pesquisa, no campo spellResult.