- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Niveaux d'accès des autorisations
- Essayer
Recherche des offres d'emploi à l'aide du SearchJobsRequest
fourni.
Cet appel d'API cible les chercheurs d'emploi passifs (par exemple, ceux qui se sont inscrits pour recevoir des alertes par e-mail concernant des postes à pourvoir). Son algorithme prend en compte les spécificités de ce public.
Cet appel limite le visibility
des offres d'emploi présentes dans la base de données et ne renvoie que celles que l'appelant est autorisé à rechercher.
Requête HTTP
POST https://jobs.googleapis.com/v4beta1/{parent=projects/*}/jobs:searchForAlert
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
parent |
Obligatoire. Nom de ressource du locataire dans lequel effectuer la recherche. Le format est "projects/{projectId}/tenants/{tenantId}". Par exemple, "projects/foo/tenant/bar". Si l'ID du locataire n'est pas spécifié, un locataire par défaut est créé. Par exemple, "projects/foo". |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON | |
---|---|
{ "searchMode": enum ( |
Champs | |
---|---|
searchMode |
Mode de recherche. La valeur par défaut est |
requestMetadata |
Obligatoire. Méta-informations recueillies auprès du chercheur d'emploi, qui permettent d'améliorer la qualité de recherche du service. Les identifiants (tels que |
jobQuery |
Requête permettant de rechercher des offres d'emploi, incluant des mots clés, des filtres de lieux, etc. |
enableBroadening |
Détermine si la recherche doit être élargie lorsqu'elle produit peu de résultats. Les recherches élargies ajoutent leurs résultats à la fin de la liste des résultats obtenue initialement. Valeur par défaut : "false". |
requirePreciseResultSize |
Ce champ est obsolète. |
histogramQueries[] |
Une expression spécifie une requête d'histogramme par rapport à des offres d'emploi correspondantes. La syntaxe d'expression est un appel de fonction d'agrégation doté d'attributs d'histogramme et d'autres options. Les appels de fonction d'agrégation disponibles sont les suivants: * Types de données :
Constantes intégrées :
Fonctions intégrées :
Attributs d'histogramme des offres d'emploi :
Exemples d'expressions :
|
jobView |
Attributs d'offre d'emploi souhaités renvoyés dans la réponse de recherche. Si aucune valeur n'est spécifiée, la valeur par défaut est |
offset |
Valeur entière qui spécifie le décalage de la recherche, c'est-à-dire le point de départ choisi parmi les offres d'emploi jugées pertinentes par l'API dans les résultats de recherche. Ce champ n'est pris en compte que si La valeur maximale autorisée est de 5 000. Dans le cas contraire, une erreur est renvoyée. Par exemple, la valeur 0 renvoie les résultats à partir de l'offre la plus pertinente. La valeur 10, quant à elle, renvoie les résultats à partir de la 11e offre d'emploi pertinente. Ce champ peut être utilisé pour la pagination (par exemple, pageSize = 10 et offset = 10 signifie que la requête renvoie les résultats de la deuxième page). |
pageSize |
Limite du nombre d'offres d'emploi renvoyées dans les résultats de recherche. Augmenter cette valeur au-dessus de 10 (la valeur par défaut) peut prolonger le temps de réponse de la recherche. Cette valeur peut être comprise entre 1 et 100. |
pageToken |
Jeton spécifiant le décalage actuel dans les résultats de recherche. Consultez |
orderBy |
Critères déterminant le mode de tri des résultats de recherche. La valeur par défaut est Les options suivantes sont acceptées :
|
diversificationLevel |
Détermine si les offres d'emploi très similaires sont renvoyées côte à côte dans les résultats de recherche. Les offres d'emploi sont identifiées comme très similaires en fonction de leur intitulé, de leur catégorie et du lieu. Les résultats très similaires sont regroupés pour ne proposer au demandeur d'emploi qu'une offre représentative en haut des résultats. Les autres postes à pourvoir sont affichés plus bas dans les résultats. Si aucune valeur n'est spécifiée, la valeur par défaut est |
customRankingInfo |
Définit la façon dont les documents d'offre d'emploi sont classés par rapport au score de pertinence existant (déterminé par un algorithme d'API). |
disableKeywordMatch |
Détermine s'il faut désactiver le mot clé exact pour Pour des requêtes telles que "cloud" qui ne contiennent pas d'ontologie propre à l'intitulé ou au lieu, les offres d'emploi avec des correspondances du mot clé "cloud" sont renvoyées, quelle que soit la valeur de cet indicateur. Utilisez Valeur par défaut : "false". |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de SearchJobsResponse
.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/jobs
https://www.googleapis.com/auth/cloud-platform
Pour en savoir plus, consultez la page Présentation de l'authentification.