Cloud Talent Solution consente agli utenti di eseguire ricerche in base alle offerte di lavoro che hai archiviato nell'indice di Cloud Talent Solution. Questo documento illustra le varie offerte di ricerca e correlate di Cloud Talent Solution.
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.
Campi obbligatori
Il seguente campo è obbligatorio:
searchMode: specifica il tipo di ricerca di lavoro da applicare. Le opzioni sono:JOB_SEARCH: questa è la modalità di ricerca predefinita e consigliata. Viene eseguita una ricerca in tutti i job. Le offerte di lavoro più pertinenti vengono restituite nell'ordine di pertinenza rispetto alla query di ricerca.FEATURED_JOB_SEARCH: vengono cercati solo i job con un valorepromotionValuesuperiore a 0. I risultati vengono ordinati in base al valorepromotionValuepiù alto; in caso di parità, la pertinenza viene utilizzata per decidere la posizione. Per ulteriori informazioni, consulta la sezione Offerte in primo piano.
Campi di uso comune
JobQuery: specifica i criteri di lavoro in base ai quali eseguire la ricerca. ad esempio località, categorie di lavoro, tipi di impiego, query di testo, aziende e così via. Per maggiori informazioni, consulta Filtri di ricerca.requestMetadata: contiene informazioni sull'utente e sulla sessione per questa richiesta di ricerca. Per informazioni dettagliate, consulta RequestMetadata.jobView: definisce il numero di campi restituiti per ogni lavoro corrispondente. Può essereJOB_VIEW_SMALL(il valore predefinito),JOB_VIEW_MINIMALoJOB_VIEW_FULL. Le descrizioni di ogni opzione sono riportate nelJobViewdocumento di riferimento.orderBy: l'ordinamento dei job restituiti. Consulta la documentazione di riferimento per i valori consentiti. Per impostazione predefinita, l'ordinamento avviene in base alla pertinenza, in ordine decrescente (RELEVANCE_DESC).
Soglia di pertinenza e ampliamento di località/categorie
Per restituire un numero maggiore di offerte di lavoro per le tue ricerche, i seguenti due campi attenuano le limitazioni alla pertinenza:
enableBroadening: se imposti questo valore sutrue, le limitazioni relative alla località e alla categoria di lavoro della richiesta di ricerca vengono allentate per restituire più risultati. Ad esempio, se una richiesta di ricerca ha specificato offerte di lavoro nel raggio di 3,2 km da Anytown, WA, l'impostazione di questo flag sutruepotrebbe restituire anche offerte di lavoro da NextTownOver, WA.disableKeywordMatch: questo flag è false per impostazione predefinita. L'impostazione di questo indicatore su false consente a Cloud Talent Solution di aggiungere le offerte pertinenti per questa query di ricerca con quelle che corrispondono anche alla stringa di query esatta nel titolo o nella descrizione.
RequestMetadata
Ogni richiesta di ricerca e istogramma deve includere un oggetto
RequestMetadata. Questo oggetto contiene informazioni sull'utente che avvia la ricerca.
Ecco alcuni motivi per cui questo oggetto è importante:
Coerenza degli utenti. Cloud Talent Solution esegue contemporaneamente diverse versioni dei modelli di base per migliorare la pertinenza della ricerca. Compila questo campo per garantire un'esperienza coerente ai candidati. Cloud Talent Solution garantisce che un candidato (identificato da userId, sessionId e domain) abbia un'esperienza coerente. Nota: questi campi devono essere offuscati.
Miglioramenti alla ricerca.Gli algoritmi di ottimizzazione si basano sulle informazioni fornite nei campi
RequestMetadata, insieme ai dati dei candidati che fornisci. In questo modo, la pertinenza dei risultati di ricerca migliora.
Operatori di ricerca
| Operatore | Descrizione |
|---|---|
| ( ) | Raggruppa una o più parole chiave. |
| E | Cerca risultati pertinenti alle parole chiave o ai gruppi di parole chiave su entrambi i lati dell'operatore. |
| OPPURE | Cerca risultati pertinenti alla parola chiave o al gruppo di parole chiave su entrambi i lati dell'operatore. |
| NOT | Esclude i risultati pertinenti alla parola chiave o al gruppo di parole chiave, tra parentesi, immediatamente dopo l'operatore. |
| - | Esclude i risultati pertinenti alla parola chiave o al gruppo di parole chiave aggiunte all'operatore. |
Ad esempio:
"software OR java"restituisce i job con uno dei valori "software" o "java" nei metadati."software" -javarestituisce i job pertinenti a "software", ma esclude i job pertinenti a "java"."(software OR java) AND (marketing)"restituisce job pertinenti sia per "software" sia per "marketing", nonché job pertinenti sia per "java" sia per "marketing".
Query di chi cerca lavoro
I termini di ricerca possono essere rilevati anche come entità effettive correlate al lavoro. Ad esempio, se la query riguardava "stagista", Cloud Talent Solution lo considerava come il tipo di impiego "INTERN" e filtrava le offerte di lavoro che avevano solo EMPLOYMENT_TYPE - INTERN. Pertanto, anche se la parola stagista fosse obbligatoria nella descrizione del lavoro, non verrà restituita se il tipo di impiego per quel lavoro è impostato su qualcos'altro.
Risoluzione dei problemi
Ogni richiesta di ricerca genera una ricerca requestID univoca nel nostro sistema che viene utilizzata per monitorare i parametri della ricerca e la risposta. Questo è
fondamentale per la risoluzione dei problemi relativi a ricerche specifiche, richieste CRUD e deve essere registrato in modo appropriato. requestId viene restituito all'interno del campo ResponseMetadata nel corpo della risposta di 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 un ticket con il nostro team di assistenza e includi gli ID richiesta pertinenti o le richieste stesse.
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.
Impaginazione
Per impostazione predefinita, Ricerca di lavoro restituisce 100 risultati per pagina (o meno, se il numero totale di risultati è inferiore a 100). Puoi implementare la paginazione utilizzando i campi associati a questa funzionalità.
pageSize: il numero di risultati restituiti per pagina.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. La pagina successiva restituisce il job 11 in alto;offsetper questa pagina è 10.
Imposta 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.
Controllo ortografico
Il controllo ortografico è una funzionalità della richiesta di ricerca di Cloud Talent Solution che 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 alla ricerca di lavoro cerca "manaer" anziché "manager", Cloud Talent Solution restituisce le offerte di lavoro per "manager". Il controllo ortografico può essere attivato/disattivato impostando il campodisableSpellCheck di JobQuery. Se la correzione ortografica è attivata,
la query corretta è disponibile nella risposta alla ricerca, nel campo spellResult.