Principes de base des recherches (v3)

Cloud Talent Solution permet aux utilisateurs de rechercher des offres d'emploi que vous avez enregistrées dans l'index de Cloud Talent Solution. Ce document vous présente les différentes possibilités de recherche et les fonctionnalités liées de Cloud Talent Solution.

Requêtes de recherche

Pour effectuer une demande de recherche d'emploi, envoyez une requête POST au point de terminaison jobs:search, en transmettant les données de recherche dans le corps de la requête.

Champs obligatoires

Le champ suivant est obligatoire :

• searchMode : indique le type de recherche sur les offres d'emploi à appliquer. Les options sont les suivantes :

  • JOB_SEARCH : il s'agit du mode de recherche par défaut qui est recommandé. La recherche est effectuée sur toutes les offres d'emploi. Les offres les plus pertinentes sont affichées par ordre de pertinence par rapport à la requête de recherche.
  • FEATURED_JOB_SEARCH : recherche uniquement les offres d'emploi dont la valeur promotionValue est supérieure à 0. Les résultats sont classés en premier par valeur promotionValue la plus élevée. En cas d'égalité, la pertinence détermine la position. Pour en savoir plus, consultez la section Sélection d'emplois.

Champs couramment utilisés

• JobQuery : spécifiez les critères d'offres d'emploi à rechercher. Il s'agit du lieu, de la catégorie de poste, du type de poste, des requêtes textuelles, de l'entreprise, etc. Pour en savoir plus, consultez la page Filtres de recherche.

• requestMetadata : contient les informations sur l'utilisateur et la session pour cette requête de recherche. Pour en savoir plus, consultez la section RequestMetadata.

• jobView : définit le nombre de champs renvoyés pour chaque offre d'emploi correspondante. Peut être JOB_VIEW_SMALL (par défaut), JOB_VIEW_MINIMAL ou JOB_VIEW_FULL. Les descriptions de chaque option se trouvent dans la documentation de référence JobView.

• orderBy : ordre de tri des offres d'emploi renvoyées. Pour connaître les valeurs autorisées, consultez la documentation de référence. Le fonctionnement par défaut consiste à trier par pertinence, dans l'ordre décroissant (RELEVANCE_DESC).

Seuil de pertinence et élargissement de la recherche par lieu/catégorie

Pour obtenir un nombre plus élevé d'offres d'emploi pour vos recherches, les deux champs suivants permettent d'alléger les restrictions de pertinence :

• enableBroadening : définir ce paramètre sur true assouplit les limites de localisation et de catégories d'emplois de la requête de recherche afin de renvoyer plus de résultats. Par exemple, si une requête de recherche spécifie des offres d'emploi dans un rayon de 2 kilomètres d'Anytown, WA, définir cette option sur true peut aussi renvoyer les offres de NextTownOver, WA.

• disableKeywordMatch : cette option est définie sur "false" par défaut. Dans ce cas, Cloud Talent Solution ajoute aux offres d'emploi pertinentes de cette requête de recherche des offres d'emploi qui correspondent également à la chaîne de requête exacte contenue dans le titre ou la description.

RequestMetadata

Chaque requête de recherche et d'histogramme doit inclure un objet RequestMetadata. Cet objet contient des informations sur l'utilisateur qui est à l'origine de la recherche.

Cet objet est important pour les raisons suivantes :

• Cohérence au niveau de l'utilisateur. Cloud Talent Solution exécute simultanément plusieurs versions des modèles sous-jacents afin d'améliorer la pertinence de la recherche. Renseignez ce champ pour vous assurer que l'expérience du demandeur d'emploi est cohérente. Cloud Talent Solution s'assure qu'un demandeur d'emploi (identifié par les champs userId, sessionId et domain) a une expérience cohérente. Remarque : Ces champs doivent être obscurcis.

• Amélioration de la recherche : les algorithmes de réglage sont basés sur les informations fournies dans les champs RequestMetadata, ainsi que sur les données des demandeurs d'emploi que vous fournissez. Cela permet d'améliorer la pertinence des résultats de recherche.

Opérateurs de recherche

Opérateur	Description
( )	Regroupe un ou plusieurs mots clés.
ET	Recherche les résultats correspondant aux mots clés ou aux groupes de mots clés de chaque côté de l'opérateur.
OU	Recherche les résultats correspondant au mot clé ou au groupe de mots clés d'un côté ou l'autre de l'opérateur.
NOT	Exclut les résultats correspondant au mot clé ou au groupe de mots clés, entre parenthèses, placés juste après l'opérateur.
-	Exclut les résultats correspondant au mot clé ou au groupe de mots clés ajoutés à l'opérateur.

Exemple :

• "software OR java" affiche les offres d'emploi dont les métadonnées contiennent le terme "software" ou le terme "java".

• "software" -java affiche les offres d'emploi correspondant au terme "software", mais exclut celles correspondant au terme "java".

• "(software OR java) AND (marketing)" affiche les offres d'emploi correspondant au terme "software", mais exclut celles correspondant au terme "java".

Requête du demandeur d'emploi

Les termes de recherche peuvent également être détectés en tant qu'entités liées à une offre d'emploi. Par exemple, si la requête spécifie "intern", Cloud Talent Solution la traite comme type d'emploi "INTERN" et filtre les offres ne contenant que les termes EMPLOYMENT_TYPE - INTERN. Par conséquent, même si le type Intern figure nécessairement dans la description de poste, il est exclu de la recherche si le type d'emploi pour ce poste est défini sur un autre terme.

Il est très important de spécifier le type de poste pour chaque offre d'emploi. À défaut, l'expérience du demandeur d'emploi en serait affectée.

Dépannage

Chaque requête de recherche génère une recherche requestID unique dans notre système, qui permet de suivre les paramètres de cette recherche ainsi que la réponse. Il est indispensable pour résoudre les problèmes liés à une recherche spécifique et aux requêtes CRUD, et doit être consigné de manière appropriée. Le requestId est renvoyé à l'intérieur du champ ResponseMetadata dans le corps de réponse de la recherche. ou l'objet de réponse d'appel CRUD associé.

Pour les problèmes d'assistance liés à la pertinence, aux requêtes de recherche, aux requêtes d'indexation, etc., veuillez déposer une demande auprès de notre équipe d'assistance en y incluant les identifiants de requête pertinents ou la requête elle-même.

Nombre de résultats

Le nombre de résultats de la recherche est communiqué au demandeur d'emploi. Il ne correspond pas toujours aux résultats de l'histogramme ou au nombre réel d'offres d'emploi affichées. Job Search renvoie un maximum de 5 000 offres d'emplois.

Pagination

Par défaut, Job Search renvoie 100 résultats par page (ou moins si le nombre total de résultats est inférieur à 100). Vous pouvez mettre en œuvre la pagination à l'aide des champs associés à cette fonctionnalité.

Remarque :Si le nombre total de résultats dépasse le maximum de 5 000, toutes les pages après celle contenant le 5 000e résultat seront vides.

• pageSize : nombre de résultats renvoyés par page.
• nextPageToken : jeton unique, renvoyé avec les résultats de chaque page de résultats de recherche, qui spécifie la position de départ de la page de résultats suivante. Ce champ est laissé vide s'il n'y a plus de résultats.
• offset : spécifie la valeur du décalage entre le classement de pertinence de l'offre d'emploi affichée en haut d'une page donnée et 1 (offre renvoyée la plus pertinente). Par exemple, un utilisateur effectue une recherche et la valeur pageSize est définie sur 10. La première page renvoie l'offre n° 1 en haut, donc la valeur offset pour cette page est 0. La page suivante renvoie l'offre n° 11 en haut; donc la valeur offset pour cette page est 10.

Définissez la taille de la page sur 20 résultats ou moins pour éviter les problèmes de latence. Il est recommandé d'émettre un appel de recherche distinct par page affichée au demandeur d'emploi (plutôt que d'utiliser un seul appel de recherche permettant d'afficher un plus grand nombre d'offres d'emploi avec une pagination du côté client), pour ne pas entraver la capacité du modèle de machine learning (apprentissage automatique) à apprendre avec précision par le biais du framework d'analyse des offres d'emploi.

Correction orthographique

La fonctionnalité de correction orthographique fait partie de la requête de recherche Cloud Talent Solution. Elle identifie les termes de recherche potentiellement mal orthographiés, les corrige et renvoie les résultats en fonction de la requête corrigée. Par exemple, lorsque la correction orthographique est activée, si un demandeur d'emploi recherche le terme "manaer" au lieu de "manager", Cloud Talent Solution affiche les offres d'emploi correspondant à "manager". La vérification orthographique peut être activée/désactivée en définissant le champ disableSpellCheck de JobQuery. Si la vérification orthographique est activée, la requête corrigée se trouve dans la réponse de recherche, dans le champ spellResult.