- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Cerca offerte di lavoro utilizzando il SearchJobsRequest
fornito.
Questa chiamata API è destinata al caso d'uso di scegliere come target le persone in cerca di lavoro passiva (ad esempio, coloro che si sono iscritti per ricevere avvisi via email su potenziali opportunità di lavoro) e ha diversi aggiustamenti algoritmici rivolti a chi cerca un lavoro passivo.
Questa chiamata limita il visibility
dei job presenti nel database e restituisce solo i job in cui il chiamante ha l'autorizzazione per eseguire la ricerca.
Richiesta HTTP
POST https://jobs.googleapis.com/v4beta1/{parent=projects/*/tenants/*}/jobs:searchForAlert
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatorio. Il nome della risorsa del tenant in cui eseguire la ricerca. Il formato è "projects/{projectId}/tenants/{tenantId}". Ad esempio, "projects/foo/tenant/bar". Se l'ID tenant non è specificato, viene creato un tenant predefinito. Ad esempio, "projects/foo". |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON | |
---|---|
{ "searchMode": enum ( |
Campi | |
---|---|
searchMode |
Modalità di ricerca. Il valore predefinito è |
requestMetadata |
Obbligatorio. Le meta informazioni raccolte sull'utente che ha cercato lavoro, utilizzate per migliorare la qualità della ricerca del servizio. Gli identificatori (ad esempio |
jobQuery |
Query utilizzata per cercare offerte di lavoro, ad esempio parola chiave, filtri per località e così via. |
enableBroadening |
Consente di stabilire se ampliare la ricerca quando vengono restituiti risultati sparsi. Le query ampliate aggiungono i risultati alla fine dell'elenco dei risultati corrispondenti. Il valore predefinito è false. |
requirePreciseResultSize |
Questo campo è obsoleto. |
histogramQueries[] |
Un'espressione specifica una richiesta a istogramma in base ai job corrispondenti. La sintassi dell'espressione è una chiamata di funzione di aggregazione con facet a istogrammi e altre opzioni. Le chiamate alle funzioni di aggregazione disponibili sono: * Tipi di dati:
Costanti integrate:
Funzioni integrate:
Facet istogrammi delle offerte di lavoro:
Espressioni di esempio:
|
jobView |
Gli attributi del job desiderati restituiti per i job nella risposta della ricerca. Se non viene specificato alcun valore, il valore predefinito è |
offset |
Un numero intero che specifica l'offset corrente (ovvero la posizione iniziale del risultato tra i job ritenuti pertinenti dall'API) nei risultati di ricerca. Questo campo viene preso in considerazione solo se il criterio Il valore massimo consentito è 5000. In caso contrario, viene visualizzato un errore. Ad esempio, 0 significa restituire i risultati a partire dal primo job corrispondente e 10 significa restituire i risultati dall'11° job. Questa funzione può essere usata per l'impaginazione (ad esempio, pageSize = 10 e offset = 10 significa ritorno dalla seconda pagina). |
pageSize |
Un limite al numero di job restituiti nei risultati di ricerca. Aumenta questo valore oltre il valore predefinito di 10 per aumentare il tempo di risposta della ricerca. Il valore può essere compreso tra 1 e 100. |
pageToken |
Il token che specifica l'offset attuale all'interno dei risultati di ricerca. Consulta |
orderBy |
I criteri che determinano l'ordinamento dei risultati di ricerca. Il valore predefinito è Le opzioni supportate sono:
|
diversificationLevel |
Controlla se vengono restituiti lavori molto simili uno accanto all'altro nei risultati di ricerca. Le offerte di lavoro sono identificate come molto simili in base a titoli, categorie di lavoro e località. I risultati molto simili vengono raggruppati in modo tale che a chi cerca l'impiego venga mostrato un solo job rappresentativo del cluster più in alto nei risultati, mentre gli altri job vengono visualizzati più in basso nei risultati. Se non viene specificato alcun valore, il valore predefinito è |
customRankingInfo |
Controlli su come vengono classificati i documenti dell'offerta di lavoro in base al punteggio di pertinenza esistente (determinato dall'algoritmo dell'API). |
disableKeywordMatch |
Consente di stabilire se disattivare la corrispondenza esatta delle parole chiave per Per query come "cloud" che non contengono un'ontologia specifica per titolo o località, le offerte di lavoro con corrispondenze con la parola chiave "cloud" vengono restituite indipendentemente dal valore di questo flag. Utilizza Il valore predefinito è false. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di SearchJobsResponse
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/jobs
https://www.googleapis.com/auth/cloud-platform
Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.