Une ressource Job (offre d'emploi) représente une offre d'emploi ou une liste d'offres d'emploi (ou encore une "mission" ou une "demande d'ouverture de poste" selon le contexte). Une offre d'emploi appartient à une ressource Company (entreprise) qui est l'entité responsable du recrutement pour ce poste.
Vous pouvez accéder à une offre d'emploi à l'aide des méthodes LIST et GET, et la manipuler au moyen des méthodes CREATE, UPDATE et DELETE. La prise en compte des modifications dans l'index de Cloud Talent Solutions peut prendre plusieurs minutes.
Les offres d'emploi sont délimitées par le champ d'application d'un compte de service. Les données des offres d'emploi ne sont accessibles qu'aux requêtes de recherche authentifiées à l'aide des identifiants du compte de service correspondant.
Pour faciliter la résolution des problèmes et la catégorisation, synchronisez l'index des offres d'emploi de Cloud Talent Solution avec votre propre index, et maintenez une relation entre le nom (name
) généré par Cloud Talent Solution et l'identifiant unique de l'offre dans votre système. La modification et la création d'emplois dans votre système nécessite d'envoyer à Cloud Talent Solution un appel CRUD adéquat en temps réel pour que ces modifications soient immédiatement prises en compte. L'index Cloud Talent Solution doit être ajouté au pipeline existant d'ingestion des emplois.
Créer une tâche
Vous pouvez créer une offre d'emploi à l'aide de l'exemple de code ci-dessous. Consultez la page Démarrage rapide : créer des entreprises et des offres d'emploi pour en savoir plus. Des tutoriels vidéo et des ateliers de programmation interactifs sont également disponibles.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez la page Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Go documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Java documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Node.js documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez la page Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Python documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Champs obligatoires
Les champs suivants doivent être renseignés lors de la création et de la mise à jour d'un objet emploi (Job) :
companyName
: nom de la ressource de l'entreprise proposant l'offre d'emploi. Par exemple,companyName=\"projects/{ProjectId}/companies/{CompanyId}\"
.requisitionId
: ID de l'ouverture de poste, également appelé ID de publication, que vous attribuez pour identifier une offre d'emploi. Vous pouvez utiliser ce champ pour l'identification des clients et le suivi des offres d'emploi. Nombre maximum de caractères autorisés : 225.L'unicité d'une offre d'emploi est déterminée à l'aide d'une combinaison des attributs
requisitionID
,companyName
et de la localisation. Si un poste est créé avec une clé spécifique composée de ces attributs, cette clé est stockée dans l'index de Cloud Talent Solution. Tant que le poste n'est pas supprimé, aucun autre poste comportant ces mêmes champs ne peut être créé.title
: intitulé du poste, par exemple "Ingénieur logiciel". Le nombre maximal de caractères autorisés est de 500Pour résoudre le problème des résultats de recherche manqués du fait d'intitulés de poste non standards, Cloud Talent Solution exploite tous les champs de l'offre d'emploi pour comprendre le contexte et stocker en interne un intitulé "nettoyé". Lorsqu'une requête de recherche est envoyée au service, la requête est également nettoyée puis mappée par les ontologies avec les emplois correspondants.
description
: description de l'offre d'emploi, qui comprend généralement une description de l'entreprise et des informations connexes structurées en plusieurs paragraphes. Des champs distincts sont fournis dans l'objet de l'offre d'emploi pour décrire les responsabilités, les qualifications requises et autres caractéristiques. Il est recommandé de les utiliser.Ce champ accepte et nettoie les saisies au format HTML et autorise l'utilisation de balises de mise en forme (gras, italique, listes numérotées ou listes à puces). Le nombre maximal de caractères autorisés est de 100 000.
Choisissez l'une des options suivantes :
applicationInfo.uris
: URL des pages de candidature.applicationInfo.emails
: adresses e-mail pour l'envoi des CV ou candidatures.applicationInfo.instruction
: instructions pour soumettre une candidature, telles que "Envoyez votre candidature à ...". Ce champ accepte et nettoie les saisies au format HTML et autorise l'utilisation de balises de mise en forme (gras, italique, listes numérotées et listes à puces). Nombre maximum de caractères autorisés : 3 000.
Champs couramment utilisés
postingExpireTime
: heure à laquelle l'offre d'emploi expire, basée sur l'horodatage. Une fois le délai écoulé, l'offre d'emploi est marquée comme expirée et n'apparaît plus dans les résultats de recherche. Cette date doit être antérieure au 31/12/2100 dans le fuseau horaire UTC. Les dates non valides (telles que les dates passées) sont ignorées. La date d'expiration par défaut d'une offre d'emploi est fixée à 30 jours après son heure de création dans le fuseau horaire UTC.Le contenu des offres d'emploi expirées peut toujours être récupéré jusqu'à 90 jours après l'expiration à l'aide de l'opérateur GET. Passé ce délai de 90 jours, l'offre d'emploi n'est plus renvoyée par l'opérateur GET.
addresses
: bureau(x). Il est recommandé de fournir les adresses complètes des lieux de recrutement afin d'améliorer les résultats de Job Search, y compris les recherches d'emploi effectuées en fonction du temps de trajet. Le nombre maximum de caractères autorisés est de 500. De plus amples informations suraddresses
sont disponibles dans la section Bonnes pratiques ci-dessous.promotionValue
: une valeur supérieure à 0 définit l'offre comme une "sélection d'emploi", qui n'est renvoyée qu'à l'occasion de recherches d'emploi de typeFEATURED_JOBS
. Plus la valeur est élevée, plus l'offre apparaît haut dans les résultats de recherche. Pour en savoir plus, consultez la section Offres d'emploi à la une.
Utiliser des champs d'offre d'emploi personnalisés
Cloud Talent Solution comporte plusieurs champs d'offre d'emploi intégrés aux schémas de l'API. Cependant, il se peut que certains champs ne fassent pas partie des champs prédéfinis. Bien que nous vous recommandions d'utiliser les champs prêts à l'emploi dans la mesure du possible, Cloud Talent Solution fournit également des champs customAttributes
pour les offres d'emploi. Ces attributs peuvent être filtrables ou non filtrables. Pour en savoir plus, consultez la documentation sur customAttributes
.
customAttributes
: ce champ stocke jusqu'à 100 attributs personnalisés permettant de stocker les données personnalisées de l'offre d'emploi. Ces champs peuvent être utilisés comme critères de filtrage en spécifiant le champjobQuery
dans la recherche d'emploi. De plus, n'importe lequel de ces champs peut être défini dans l'attributkeywordSearchableJobCustomAttributes
decompany
, donc un terme de recherche ayant une correspondance exacte avec l'un des champs dekeywordSearchableJobCustomAttributes
renvoie les offres d'emploi qui incluent la correspondance.
L'exemple de code suivant montre comment créer une offre d'emploi à l'aide d'un customAttribute
:
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Go documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Java documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez la page Bibliothèques clientes CTS. Pour en savoir plus, consultez la documentation de référence de l'API CTS Node.js.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Python documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Récupérer une offre d'emploi
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Go documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez la documentation de référence de l'API CTS Java.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez la documentation de référence de l'API CTS Node.js.
Pour vous authentifier auprès de CTS, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Python documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Répertorier des tâches
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez la documentation de référence de l'API CTS Go.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez la documentation de référence de l'API CTS Java.
Pour vous authentifier auprès de CTS, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez la documentation de référence de l'API CTS Node.js.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Python documentation de référence.
Pour vous authentifier auprès de CTS, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Supprimer une offre d'emploi
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Go documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Java documentation de référence.
Pour vous authentifier auprès de CTS, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez la documentation de référence de l'API CTS Node.js.
Pour vous authentifier auprès de CTS, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour CTS, consultez Bibliothèques clientes CTS. Pour en savoir plus, consultez les API CTS Python documentation de référence.
Pour vous authentifier auprès de CTS, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Bonnes pratiques
Champs de localisation géographique
Dans la mesure du possible, nous vous recommandons de renseigner l'adresse postale d'un emploi dans le champ addresses
. Vous affinerez ainsi la localisation et la pertinence de l'offre. Si aucune rue ne peut être indiquée, saisissez autant d'informations que possible.
Les adresses sont acceptées jusqu'au niveau du pays. Les références de région (telles que "Nord-Ouest Pacifique") ne sont pas acceptées.
Cloud Talent Solution utilise les données du champ addresses
pour renseigner le champ derivedInfo.locations
(sortie uniquement). En l'absence d'adresse complète, le service utilise d'autres références, telles que le nom de l'entreprise, pour déterminer s'il est possible de déduire une adresse plus précise pour l'offre d'emploi.
Par exemple, si l'emplacement d'une offre d'emploi dans le secteur informatique est défini comme étant Mountain View
et que l'entreprise concernée est Google
, le service analyse l'objet company
correspondant pour identifier si le champ headquartersAddress
comporte une adresse plus précise et si cette adresse est située dans la même ville que l'offre. Si tel est le cas, le service comprend que l'emploi à pourvoir est "probablement" à cette adresse et renseigne le champ derivedInfo.locations
en conséquence.
Si les données d'adresse de l'entreprise ne sont pas disponibles, le service utilise une combinaison de connaissances exclusives et d'informations sur l'emploi/l'entreprise pour renseigner le champ derivedInfo.locations
.
Étant donné que la valeur derivedInfo.locations
représente la meilleure estimation possible, vous pouvez aussi utiliser les données des champs derivedInfo.locations
ou addresses
pour afficher l'adresse de l'offre d'emploi.
Une offre d'emploi ne peut pas être associée à plus de 50 emplacements. Si une offre doit être associée à davantage d'emplacements, vous pouvez créer plusieurs offres d'emploi identiques possédant chacune un attribut requisitionID unique (par exemple, "ReqA", "ReqA-1", "ReqA-2", etc.). En effet, il n'est pas possible de créer plusieurs offres ayant les mêmes attributs requisitionId
, companyName
et languageCode
. Si l'attribut original requisitionId
doit être conservé, définissez un paramètre CustomAttribute
pour le stockage. Il est recommandé de regrouper les emplacements géographiques les plus proches dans la même offre d'emploi pour faciliter la recherche.
Adresses acceptées
Toute adresse reconnue par l'API Google Maps Geocoding (dans le champ formattedAddress
) est acceptée par Cloud Talent Solution. Si vous tentez de créer une offre d'emploi ou d'exécuter une recherche à l'aide d'une adresse non reconnue, le service renvoie une erreur 400.
Si une adresse professionnelle est mal référencée dans l'API Google Maps Geocoding, remplissez un rapport de bug pour le signaler. Comptez jusqu'à cinq jours pour que la correction soit effective.
Saisie semi-automatique des adresses
Cloud Talent Solution ne propose pas de suggestions de saisie semi-automatique pour les emplacements de postes. Utilisez l'API Google Maps Places ou d'autres services de localisation similaires pour alimenter les suggestions de saisie semi-automatique.
Emplois à l'échelle d'un État, d'un pays ou en télétravail
Le champ postingRegion
permet de spécifier si le poste est proposé au niveau de l'État, du pays ou en télétravail.
Les offres d'emploi au niveau
ADMINISTRATIVE_AREA
etNATION
apparaissent dans les résultats des recherches pour lesquelles l'emplacement spécifié existe dans l'État ou le pays définis dans l'offre. Par exemple, si une offre d'emploiADMINISTRATIVE_AREA
est publiée dans "WA, USA", elle est renvoyée si le champLocationFilter
indique "Seattle".Les offres d'emploi
TELECOMMUTE
sont renvoyées dans toute recherche liée à un emplacement, mais elles sont considérées comme moins pertinentes. Elles peuvent être ciblées dans une recherche en définissant l'optiontelecommutePreference
surTELECOMMUTE_ALLOWED
dans le champLocationFilter
de la recherche.