Cloud Talent Solution consente agli utenti di eseguire ricerche tra le 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.
Cerca richieste
Per effettuare una richiesta di ricerca di lavoro, invia una richiesta POST all'endpoint jobs:search,
trasmettendo 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 la ricerca in tutti i job. I lavori più pertinenti vengono restituiti in ordine di pertinenza rispetto alla query di ricerca.FEATURED_JOB_SEARCH: Cerca solo lavori con unpromotionValuemaggiore di 0. I risultati sono ordinati in base alpromotionValuepiù alto; in caso di parità, la pertinenza viene utilizzata per decidere la posizione. Per ulteriori informazioni, consulta la sezione Offerte di lavoro in evidenza.
Campi utilizzati di frequente
JobQuery: specifica i criteri di lavoro da confrontare. Questi includono posizione, categorie di lavoro, tipi di impiego, query di testo, aziende e così via. Per ulteriori informazioni, consulta Filtri di ricerca.requestMetadata: contiene informazioni sull'utente e sulla sessione per questa richiesta di ricerca. Per maggiori dettagli, consulta RequestMetadata.jobView: definisce il numero di campi restituiti per ogni offerta di lavoro corrispondente. Può essereJOB_VIEW_SMALL(il valore predefinito),JOB_VIEW_MINIMALoJOB_VIEW_FULL. Le descrizioni di ogni opzione sono disponibiliJobViewnel riferimento.orderBy: L'ordine di ordinamento per i lavori restituiti. Consulta il 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à/categoria
Per restituire un numero maggiore di job per le tue ricerche, i due campi seguenti allentano le restrizioni sulla pertinenza:
enableBroadening: se imposti questo valore sutrue, le restrizioni relative a località e categoria di lavoro della richiesta di ricerca vengono allentate 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 offerte di lavoro da NextTownOver, WA.disableKeywordMatch: questo flag è impostato su false per impostazione predefinita. Se imposti questo flag su false, Cloud Talent Solution aggiunge ai lavori pertinenti a questa query di ricerca anche quelli che corrispondono esattamente alla 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 degli utenti. Cloud Talent Solution esegue contemporaneamente diverse versioni dei modelli sottostanti nel tentativo di migliorare la pertinenza della ricerca. Compila questo campo per garantire un'esperienza coerente al candidato. Cloud Talent Solution garantisce un'esperienza coerente a un candidato (identificato da userId, sessionId e domain). Nota: questi campi devono essere offuscati.
Miglioramenti della 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.
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 aggiunti all'operatore. |
Ad esempio:
"software OR java"restituisce i job con "software" o "java" nei metadati."software" -javarestituisce lavori pertinenti a "software", ma esclude quelli pertinenti a "java"."(software OR java) AND (marketing)"restituisce lavori pertinenti sia a "software" sia a "marketing", nonché lavori pertinenti sia a "java" sia a "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 era per "stagista", Cloud Talent Solution la tratterebbe come tipo di impiego "INTERN" e filtrerebbe i lavori che avevano solo EMPLOYMENT_TYPE - INTERN. Pertanto, anche se il termine "tirocinante" fosse necessariamente presente nella descrizione del lavoro, non verrebbe restituito se il tipo di impiego per quel lavoro fosse impostato su un altro valore.
Risoluzione dei problemi
Ogni richiesta di ricerca genera un requestID di ricerca univoco nel nostro sistema che viene utilizzato per monitorare i parametri della ricerca e la risposta. Questo è
fondamentale per la risoluzione dei problemi relativi a richieste specifiche di ricerca e CRUD e
deve essere registrato in modo appropriato. requestId viene restituito all'interno del campo
ResponseMetadata
nel corpo della risposta
della ricerca.
o nell'oggetto risposta della chiamata CRUD associata.
Per problemi di assistenza relativi a pertinenza, query di ricerca, richieste di indicizzazione e così via, apri un ticket con il nostro team di assistenza e includi gli ID richiesta o le richieste pertinenti.
Conteggi dei risultati
Il conteggio dei risultati viene utilizzato per comunicare il numero di risultati di ricerca al candidato. Questo valore non corrisponde sempre ai risultati dell'istogramma o al numero effettivo di lavori restituiti. La ricerca di lavoro restituisce un massimo di 5000 job.
Impaginazione
Per impostazione predefinita, la 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 successiva dei risultati. 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 epageSizeè impostato su 10. La prima pagina restituisce l'offerta di lavoro n. 1 in alto, pertanto il valoreoffsetper questa pagina è 0. La pagina successiva restituisce il job n. 11 in alto;offsetper questa pagina è 10.
Imposta le dimensioni della pagina su 20 risultati o meno per evitare problemi di latenza. Come best practice, emetti una chiamata di ricerca separata per ogni pagina visualizzata dal candidato. L'alternativa, una singola chiamata di ricerca per restituire un numero maggiore di job e la paginazione lato client, impedisce al modello di machine learning di apprendere con precisione tramite il framework Jobs Analytics.
Controllo ortografico
Il controllo ortografico è una funzionalità della richiesta di ricerca di Cloud Talent Solution che tiene conto
di termini di ricerca potenzialmente errati, li corregge e restituisce risultati in base
alla query corretta. Ad esempio, quando il controllo ortografico è attivato, se un candidato
cerca "manaer" anziché "manager", Cloud Talent Solution restituisce i lavori per
"manager". Il controllo ortografico può essere attivato/disattivato impostando il
campo disableSpellCheck di JobQuery. Se il controllo ortografico è attivato,
la query corretta si trova nella risposta della ricerca, nel campo spellResult.