Cloud Talent Solution consente agli utenti di eseguire ricerche in base alle posizioni archiviate 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 job, 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 job da applicare. Le opzioni sono:JOB_SEARCH: è la modalità di ricerca predefinita e consigliata. Viene eseguita la ricerca di tutti i job. Le offerte di lavoro più pertinenti vengono restituite in ordine di pertinenza rispetto alla query di ricerca.FEATURED_JOB_SEARCH: cerca solo le offerte di lavoro con un valore del campopromotionValuesuperiore a 0. I risultati vengono ordinati in base al valorepromotionValuepiù alto; in caso di parità, la pertinenza viene utilizzata per decidere la posizione. Consulta Offerte di lavoro in primo piano per ulteriori informazioni.
Campi più utilizzati
JobQuery: specifica i criteri del job con cui stabilire una corrispondenza. tra cui località, categorie di prestazioni, tipi di impiego, query di testo, aziende e così via. Per ulteriori informazioni, consulta i filtri di ricerca.requestMetadata: contiene informazioni sull'utente e sulla sessione relative a questa richiesta di ricerca. Per i dettagli, consulta RequestMetadata.jobView: definisce il numero di campi restituiti per ogni job corrispondente. Può essereJOB_VIEW_SMALL(valore predefinito),JOB_VIEW_MINIMALoJOB_VIEW_FULL. Le descrizioni di ciascuna opzione sono disponibili nel riferimentoJobView.orderBy: l'ordinamento dei lavori restituiti. Consulta il riferimento per i valori consentiti. L'impostazione predefinita è l'ordinamento in base alla pertinenza, in ordine decrescente (RELEVANCE_DESC).
Soglia di pertinenza e ampliamento di località/categoria
Per restituire un numero più elevato di offerte di lavoro per le tue ricerche, i seguenti due campi hanno allentato le limitazioni relative alla pertinenza:
enableBroadening: l'impostazione di questa opzione sutrueallenta le limitazioni sulla posizione e sulla categoria del job della richiesta di ricerca, per restituire più risultati. Ad esempio, se una richiesta di ricerca specificava offerte di lavoro entro un raggio di 3 km da Anytown, WA, l'impostazione di questo flag sutruepotrebbe restituire anche lavori da NextTownOver, WA.disableKeywordMatch: questo flag è false per impostazione predefinita. L'impostazione di questo flag su false consente a Cloud Talent Solution di aggiungere le offerte di lavoro pertinenti a questa query di ricerca con offerte che corrispondono anche all'esatta stringa di query 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.
Questo oggetto è importante per diversi motivi:
Coerenza per gli utenti. Cloud Talent Solution esegue contemporaneamente più versioni dei modelli sottostanti, allo scopo di migliorare la pertinenza della ricerca. Compila questo campo per garantire a chi cerca un impiego un'esperienza coerente. Cloud Talent Solution garantisce che la persona in cerca di lavoro (identificata da userId, sessionId e dominio) abbia un'esperienza coerente. Nota: questi campi devono essere offuscati.
Miglioramenti della ricerca.Gli algoritmi di ottimizzazione si basano sulle informazioni fornite nei campi
RequestMetadatae sui dati forniti dalle persone in cerca di lavoro. Ciò migliora la pertinenza dei risultati di ricerca.
Operatori di ricerca
| Operatore | Descrizione |
|---|---|
| ( ) | Raggruppa una o più parole chiave. |
| AND | Cerca risultati pertinenti alle parole chiave o ai gruppi di parole chiave in entrambi i lati dell'operatore. |
| OPPURE | Cerca i risultati pertinenti alla parola chiave o al gruppo di parole chiave in 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 alle parole chiave o al gruppo di parole chiave aggiunti all'operatore. |
Ad esempio:
"software OR java"restituisce job che contengono o "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 i job pertinenti sia a "software" che a "marketing" e a job pertinenti sia a "java" che a "marketing".
Query per la ricerca di un lavoro
I termini di ricerca possono essere rilevati anche come vere entità correlate al lavoro. Ad esempio, se la query riguardava "stagista", Cloud Talent Solution tratterebbe questo tipo di impiego come tipo di impiego "INTERN" e filtrerebbe in base ai lavori che avevano solo EMPLOYMENT_TYPE - INTERN. Di conseguenza, anche se lo stagista era necessariamente nella descrizione dell'offerta di lavoro, non verrebbe restituito se il tipo di impiego per quel lavoro fosse impostato su qualcosa di diverso.
Risoluzione dei problemi
Ogni richiesta di ricerca genera una ricerca requestID univoca nel nostro sistema che viene
utilizzata per monitorare i parametri di quella ricerca e la risposta. Questo è fondamentale per la risoluzione dei problemi relativi a ricerca specifica e richieste CRUD e deve essere registrato in modo appropriato. Il valore requestId viene restituito all'interno del campo ResponseMetadata nel corpo della risposta di ricerca o nell'oggetto di risposta della chiamata CRUD associato.
Per problemi di assistenza relativi a pertinenza, richieste di ricerca, richieste di indicizzazione e così via, invia un ticket al nostro team di assistenza e includi gli ID delle richieste pertinenti o fai una richiesta.
Conteggi dei risultati
Il conteggio dei risultati viene utilizzato per comunicare il numero di risultati di ricerca alla persona in cerca di lavoro. Questo non corrisponde sempre ai risultati dell'istogramma o al numero effettivo di job restituiti. Ricerca lavoro restituisce un massimo di 5000 job.
Impaginazione
Per impostazione predefinita, Ricerca 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 dei risultati successiva. Questo campo viene lasciato vuoto se non ci sono altri risultati.offset: specifica l'offset tra il ranking di pertinenza del job restituito nella parte superiore di una determinata pagina e 1 (il job più pertinente restituito). Ad esempio, un utente esegue una ricerca e il valorepageSizeè impostato su 10. La prima pagina restituisce il job n. 1 nella parte superiore, pertanto il valoreoffsetper questa pagina è 0. La pagina successiva restituisce il job n. 11 in alto;offsetper questa pagina è il 10.
Imposta le dimensioni della pagina su un massimo di 20 risultati per evitare problemi di latenza. Come best practice, esegui una chiamata di ricerca separata per ogni pagina visualizzata da chi cerca lavoro. L'alternativa, una singola chiamata di ricerca per restituire un numero maggiore di job e impaginazione sul lato client, impedisce al modello di machine learning di apprendere in modo preciso tramite il framework di analisi di Jobs.
Controllo ortografico
Il controllo ortografico è una funzionalità della richiesta di ricerca di Cloud Talent Solution che tiene conto dei termini di ricerca che contengono errori ortografici, li corregge e restituisce risultati in base alla query corretta. Ad esempio, quando il controllo ortografico è abilitato, se una persona in cerca di lavoro cerca "manaer" anziché "manager", Cloud Talent Solution restituisce i job per "manager". Il controllo ortografico può essere attivato/disattivato impostando il campo disableSpellCheck di JobQuery. Se il controllo ortografico è abilitato, la query corretta può essere trovata nella risposta di ricerca, nel campo spellResult.