Cloud Talent Solution consente agli utenti di eseguire ricerche in base alle offerte di lavoro che memorizzi nell'indice di ricerca di lavoro. La Ricerca lavoro è progettata per essere personalizzabile e può essere modificata in base alle esigenze della tua attività. Questa pagina fornisce una panoramica delle funzioni di ricerca disponibili in Ricerca di lavoro CTS.
Invio di richieste di ricerca
Per effettuare una richiesta di ricerca di lavoro, invia una richiesta POST all'endpoint
jobs:search
passando i dati di ricerca nel corpo.
(Facoltativo) Campi di uso comune
JobQuery: l'oggettoJobQueryè costituito da due componenti, una stringaquerye i filtri applicati a quella stringa. Questa funzionalità consente ai tuoi utenti di eseguire ricerche su una stringa di query (ad esempio "assistente per le comunicazioni") utilizzando uno o più filtri (posizione, tempo di percorrenza, compenso e così via). Per maggiori informazioni e un elenco delle opzioni di filtro disponibili, consulta Filtri di ricerca.searchMode: specifica il tipo di ricerca da applicare. Le opzioni sono:JOB_SEARCH(consigliato): questa è la modalità di ricerca predefinita, che consente di eseguire ricerche in tutti gli oggetti Job. Le offerte di lavoro più pertinenti vengono restituite all'utente in base all'ordine di pertinenza alla query di ricerca.FEATURED_JOB_SEARCH: vengono cercati solo oggetti Job con un valorepromotionValuemaggiore di 0. I risultati sono ordinati in base al valorepromotionValuepiù alto; in caso di parità, la pertinenza viene utilizzata per decidere la posizione. Per ulteriori informazioni, consulta la sezione Posti di lavoro in primo piano.
jobView: definisce il numero di campi restituiti per ogni oggetto Job corrispondente. Può essereJOB_VIEW_SMALL(predefinito),JOB_VIEW_MINIMALoJOB_VIEW_FULL. Le descrizioni di ogni opzione sono disponibili nella documentazione di riferimento diJobView.orderBy: l'ordinamento dei job restituiti. Consulta la documentazione di riferimento per i valori consentiti. Il valore predefinito è l'ordinamento in base alla pertinenza, in ordine decrescente (RELEVANCE_DESC).
Campi obbligatori
Il seguente campo è obbligatorio:
requestMetadata: contiene informazioni sull'utente e sulla sessione per questa richiesta di ricerca.
RequestMetadata
Ogni richiesta di ricerca e istogramma deve includere un oggetto
RequestMetadata. Questo oggetto contiene informazioni sull'utente che avvia la ricerca.
È importante per due motivi principali:
Coerenza degli utenti: Cloud Talent Solution esegue contemporaneamente diverse versioni dei modelli di base per migliorare la pertinenza della ricerca. CTS garantisce che un candidato (identificato da userId, sessionId e domain) abbia un'esperienza coerente. Questi campi devono essere offuscati.
Miglioramenti alla ricerca: gli algoritmi di ottimizzazione si basano sulle informazioni fornite nei campi
RequestMetadata, nonché sui dati dei candidati che fornisci. In questo modo, la pertinenza dei risultati di ricerca migliora.
Utilizzare gli operatori di ricerca
Gli operatori di ricerca nella tabella seguente possono essere utilizzati singolarmente o in combinazione.
| Operatore | Descrizione |
|---|---|
| ( ) | Raggruppa una o più parole chiave. |
| OPPURE | Cerca risultati pertinenti alle parole chiave o ai gruppi di parole chiave ai lati dell'operatore. Esempio: "software OR java" restituisce i job con "software" o "java" nei metadati. |
| E | Cerca risultati pertinenti alle parole chiave o ai gruppi di parole chiave su entrambi i lati dell'operatore. Esempio: "(software OR java) AND (marketing)" restituisce i job o pertinenti sia per "software" che per "marketing" o i job pertinenti sia per "java" che per "marketing". |
| NOT | Esclude i risultati pertinenti alla parola chiave o al gruppo di parole chiave immediatamente successivo all'operatore. La parola chiave o il gruppo di parole chiave deve essere tra parentesi. |
| - | Esclude i risultati pertinenti alla parola chiave o al gruppo di parole chiave dopo l'operatore. Esempio: "software -java" restituisce i job pertinenti a "software", ma esclude quelli pertinenti a "java". |
| req o requisition: | Restituisce i job con l'ID richiesta specificato. Esempio: req:1234 restituisce i job con l'ID richiesta 1234. |
Query di chi cerca lavoro
I termini di ricerca possono essere rilevati anche come entità correlate al lavoro effettive. Ad esempio, se un utente esegue una query per "stagista", Cloud Talent Solution lo tratta come tipo di impiego INTERN e filtra i lavori con la designazioneEMPLOYMENT_TYPE - INTERN. Pertanto, anche un oggetto Job con "intern" nella descrizione non verrà restituito se il campo EMPLOYMENT_TYPE per quel job è impostato su qualcos'altro.
Risoluzione dei problemi
Ogni richiesta di ricerca genera una ricerca requestID univoca nel sistema di ricerca di lavoro. Questo valore viene utilizzato per monitorare i parametri della ricerca e la risposta. Questo è fondamentale per la risoluzione dei problemi relativi a ricerche specifiche o richieste CRUD e deve essere registrato in modo appropriato. requestID viene fornito nel campo ResponseMetadata nel corpo della risposta della ricerca o nell'oggetto della risposta alla chiamata CRUD associata.
Per problemi di assistenza relativi a pertinenza, richieste di ricerca, richieste di indicizzazione e così via, apri una richiesta con il nostro team di assistenza e includi i requestID pertinenti o le richieste stesse.
Diagnostica i problemi relativi ai dati utilizzando la console
Utilizza la pagina Offerte di lavoro e aziende nella console CTS per diagnosticare i problemi relativi ai dati delle offerte di lavoro. Se devi risolvere i problemi relativi ai dati, visualizza le statistiche dei job, cerca i metadati di job specifici ed esporta i dati per job, azienda o tenant. Per saperne di più su come utilizzare questi strumenti, consulta la sezione della documentazione Dati su aziende e lavori.
Conteggi dei risultati
Il conteggio dei risultati viene utilizzato per comunicare il numero di risultati di ricerca al candidato. Questo non corrisponde sempre ai risultati dell'istogramma o al numero effettivo di job restituiti. La ricerca di lavoro restituisce un massimo di 5000 risultati.
Paginazione (facoltativa)
Per impostazione predefinita, Job Search restituisce 100 risultati in una singola chiamata (o meno, se il numero totale di risultati è inferiore a 100). Per visualizzare più di 100 risultati, puoi implementare la paginazione. Se il numero totale di risultati supera il valore massimo di 5000, tutte le pagine successive a quella contenente il 5000° risultato saranno vuote. I campi riportati di seguito controllano l'impaginazione:
pageSize: il numero di risultati restituiti.nextPageToken: un token univoco restituito con i risultati di ogni pagina dei risultati di ricerca che specifica la posizione iniziale della pagina di risultati successiva. Questo campo viene lasciato vuoto se non ci sono altri risultati.offset: specifica l'offset tra il ranking di pertinenza del job visualizzato nella parte superiore di una determinata pagina e 1 (il job più pertinente restituito). Ad esempio, un utente esegue una ricerca epageSizeè impostato su 10. La prima pagina restituisce il job 1 in alto, pertanto il valoreoffsetper questa pagina è 0. Nella pagina successiva viene visualizzato il job 11 in alto;offsetper questa pagina è 10.
Esistono due modi principali per implementare la paginazione. Puoi utilizzare pageSize e
nextPageToken per fare riferimento direttamente alla pagina di risultati successiva (ogni pagina ha
un nuovo valore nextPageToken che rimanda alla pagina successiva). Se utilizzi questo metodo, inizierai sempre dalla parte superiore dei risultati e passerai da una pagina all'altra in ordine sequenziale. In alternativa, puoi utilizzare pageSize con offset per
specificare direttamente il risultato numerato da visualizzare nella parte superiore di ogni pagina. L'utilizzo di offset anziché nextPageToken ti consente di passare a qualsiasi punto del set di risultati.
Ti consigliamo di impostare la dimensione della pagina su massimo 20 risultati per evitare problemi di latenza. Come best practice, esegui una chiamata di ricerca separata per ogni pagina visualizzata al candidato. L'alternativa, una singola chiamata di ricerca per restituire un numero maggiore di job e la paginazione lato client, impedisce la capacità del modello di machine learning di apprendere con precisione tramite il Jobs Analytics Framework.
Se utilizzi la paginazione, tutti i campi della richiesta diversi da pageSize,
nextPageToken e offset devono rimanere invariati. Se questi campi non sono uguali, l'ordine dei job restituiti nei risultati può essere incoerente.
Controllo ortografico
Il controllo ortografico è una funzionalità facoltativa di una richiesta di ricerca CTS. Tiene conto dei termini di ricerca con potenziali errori ortografici, li corregge e restituisce i risultati in base alla query corretta. Ad esempio, quando la correzione ortografica è attivata, se un candidato cerca "manaer" anziché "manager", il CTS restituisce offerte di lavoro per "manager". Il controllo ortografico può essere attivato/disattivato impostando il campo disableSpellCheck della richiesta di ricerca.
Se la correzione ortografica è attivata, la query corretta è disponibile nella risposta della ricerca, nel campo spellResult.