Una risorsa Job rappresenta un'offerta di lavoro (chiamata anche "offerta di lavoro" o "richiesta di lavoro"). Un job appartiene a una Company che è l'entità di assunzione responsabile del job.
Un Job può essere manipolato utilizzando i metodi di creazione, aggiornamento ed eliminazione e vi si accede utilizzando i metodi list e get. L'indice di Cloud Talent Solution può richiedere fino a 5 minuti per riflettere le modifiche.
I job sono contenuti nell'ambito di un account di servizio. Per accedere ai contenuti di questi job è possibile utilizzare solo le richieste di ricerca autenticate con le credenziali di un determinato account di servizio.
Per semplificare la risoluzione dei problemi e la gestione delle priorità, sincronizza l'indice dei job di Cloud Talent Solution con il tuo indice dei job e mantieni una relazione tra il name generato da Cloud Talent Solution e l'identificatore univoco del job nel tuo sistema. Quando i job vengono modificati o introdotti nel tuo sistema, la chiamata CRUD appropriata deve essere inviata a Cloud Talent Solution in tempo reale per garantire che queste modifiche vengano applicate immediatamente. L'indice di Cloud Talent Solution deve essere aggiunto alla pipeline di importazione dei job esistente.
Crea un job
Per creare un job, consulta la guida rapida: crea aziende e job per maggiori dettagli.
Java
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Python
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Campi obbligatori
I seguenti campi sono obbligatori durante la creazione e l'aggiornamento del job:
companyName: il nome della risorsa dell'azienda che pubblica il job, ad esempioprojects/[PROJECT_ID]/companies/[COMPANY_ID].requisitionId: l'ID della richiesta, chiamato anche ID dell'annuncio, assegnato dal cliente per identificare un job. Questo campo è destinato all'utilizzo da parte dei clienti per l'identificazione dei clienti e il monitoraggio delle richieste. Il numero massimo di caratteri consentiti è 225.L'unicità di un'offerta di lavoro è determinata utilizzando una combinazione di
requisitionID,companyNamee le impostazioni internazionali dell'offerta di lavoro. Se viene creato un job con una chiave specifica di questi attributi, questa chiave viene memorizzata nell'indice di Cloud Talent Solution e non è possibile creare altri job con gli stessi campi finché il job non viene eliminato.title: il titolo del job, ad esempio "Ingegnere software". Il numero massimo di caratteri consentiti è 500.Per risolvere il problema dei risultati di ricerca mancanti a causa di titoli di job non standard, Cloud Talent Solution sfrutta tutti i campi forniti nel job per comprendere il contesto del job e memorizzare internamente un titolo "pulito" del job. Quando viene inviata una richiesta di ricerca al servizio, viene pulita anche la query di ricerca e le ontologie vengono utilizzate per mappare la query pulita ai job puliti pertinenti.
description: la descrizione del job, che in genere include una descrizione in più paragrafi dell'azienda e informazioni correlate. Nel job object sono forniti campi separati per responsabilità, qualifiche e altre caratteristiche del job. È consigliabile utilizzare questi campi del job separati.Questo campo accetta e sanifica l'input HTML e accetta i tag di markup per grassetto, corsivo, elenchi puntati ed elenchi numerati. Il numero massimo di caratteri consentiti è 100.000.
Il valore sarà uno dei seguenti:
applicationInfo.uris[]: gli URL delle pagine di candidatura.applicationInfo.emails[]: gli indirizzi email a cui devono essere inviati i curriculum vitae o le candidature.applicationInfo.instruction: le istruzioni per la candidatura, ad esempio "Invia la tua candidatura a ...". Questo campo accetta e sanifica l'input HTML e accetta i tag di markup per grassetto, corsivo, elenchi puntati ed elenchi numerati. Il numero massimo di caratteri consentiti è 3000.
Campi di uso comune
postingExpireTime: l'ora, in base al timestamp, in cui scade l'offerta di lavoro. Una volta trascorso questo periodo, il job viene contrassegnato come scaduto e non viene visualizzato nei risultati di ricerca. Questa data deve essere precedente al 31/12/2100 nel fuso orario UTC. Le date non valide (ad esempio le date passate) vengono ignorate. La data predefinita di scadenza del job è 30 giorni dopo la data di creazione del job nel fuso orario UTC.I contenuti dei job scaduti possono essere recuperati fino a 60 giorni dopo la scadenza del job utilizzando l'operatore GET. Dopo questa scadenza di 60 giorni, il job non verrà restituito tramite un'operazione GET.
addresses[]: le sedi in cui l'azienda sta assumendo per il job. È consigliabile fornire gli indirizzi stradali completi delle sedi di assunzione per consentire risultati API migliori, incluse le ricerche di job in base al tempo di percorrenza. Il numero massimo di caratteri consentiti è 500. Ulteriori informazioni suaddresses[]sono disponibili nella sezione Best practice di seguito.promotionValue: un valore maggiore di 0 definisce questo job come "job in primo piano", che viene restituito solo nelle ricerche di job di tipoFEATURED_JOBS. I valori più elevati vengono restituiti più in alto nei risultati di ricerca in primo piano. Per saperne di più, consulta Job in primo piano.
Campi personalizzati
customAttributes: questo campo memorizza fino a 100 attributi personalizzati utilizzati per memorizzare dati personalizzati sul job. Questi campi possono essere filtrati utilizzando una richiesta di ricerca che specifica il campojobQuerydi una richiesta di ricerca di job. Inoltre, uno qualsiasi di questi campi può essere impostato nell'attributokeywordSearchableJobCustomAttributesdell'azienda, in modo che un termine di ricerca che abbia una corrispondenza esatta in uno qualsiasi dei campi inkeywordSearchableJobCustomAttributesrestituisca qualsiasi job che includa la corrispondenza.
Aggiorna un job
Aggiorna il job senza fieldMask
Java
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Python
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Aggiorna il job con fieldMask
Java
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Python
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Best practice
Campi relativi alla località
Se possibile, ti consigliamo di fornire l'indirizzo stradale di un job nel campo addresses[]. Questo aiuta a rilevare la località e la pertinenza. Quando non è disponibile un indirizzo a livello stradale, inserisci il maggior numero possibile di informazioni.
Gli indirizzi sono supportati fino al livello del paese. Le designazioni delle regioni (ad esempio "Pacific Northwest") non sono supportate.
Cloud Talent Solution utilizza i dati nel campo addresses[] per popolare
il campo derivedInfo.locations[] (solo output). Quando non viene fornito un indirizzo completo, il servizio utilizza altri indicatori, come il nome dell'azienda, per determinare se è possibile dedurre un indirizzo più completo per l'offerta di lavoro.
Ad esempio, se la sede di un job software è specificata come Mountain View e l'azienda a cui è associato il job è Google, il servizio cerca l'oggetto azienda per verificare se nel campo headquartersAddress è fornito un indirizzo stradale migliore e se questo indirizzo stradale si trova nella stessa città dell'offerta di lavoro. In caso affermativo, il servizio comprende che il job è "probabilmente"
a quell'indirizzo stradale e compila il derivedInfo.locations[] campo di conseguenza.
Se i dati dell'indirizzo dell'azienda non sono disponibili, il servizio utilizza una combinazione di conoscenze proprietarie e informazioni sul job/sull'azienda per compilare il campo derivedInfo.locations[].
Poiché il valore derivedInfo.locations[] è una stima, potresti voler utilizzare i dati derivedInfo.locations[] o il campo addresses quando visualizzi l'indirizzo del job.
Un'offerta di lavoro può avere al massimo 50 sedi associate. Se un job ha più sedi, puoi suddividerlo in più job, ognuno con un requisitionId univoco (ad es. "ReqA", "ReqA-1", "ReqA-2" e così via), poiché non è consentito avere più job con lo stesso requisitionId, companyName e languageCode. Se l'originale requisitionId deve essere mantenuto, è necessario utilizzare un CustomAttribute
per l'archiviazione. Per una migliore esperienza di ricerca, ti consigliamo di raggruppare le sedi più vicine nello stesso job.
Indirizzi supportati
Qualsiasi indirizzo riconosciuto dall'API Geocoding di Google Maps (nel campo
formattedAddress) viene accettato da Cloud Talent Solution. Il servizio restituisce un errore 400 se tenti di creare un job o eseguire una ricerca utilizzando un indirizzo non riconosciuto.
Se l'indirizzo di un'attività è elencato in modo errato nell'API Geocoding di Google Maps, segnala un bug per farlo correggere. Le correzioni possono richiedere fino a 5 giorni per avere effetto.
Completamento automatico dell'indirizzo
Cloud Talent Solution non fornisce suggerimenti di completamento automatico per le sedi. Utilizza l'API Places di Google Maps o altri servizi di localizzazione simili per compilare i suggerimenti di completamento automatico.
Job a livello statale, nazionale e di telelavoro
I job possono essere specificati come statali, nazionali o di telelavoro utilizzando il
postingRegion campo della risorsa Job.
I job
ADMINISTRATIVE_AREAeNATIONvengono restituiti per qualsiasi ricerca la cui sede si trovi all'interno dello stato/paese dell'offerta di lavoro. Ad esempio, se un jobADMINISTRATIVE_AREAha una sede "WA, USA", viene restituito per le ricerche in cuiLocationFilterspecifica "Seattle".I job
TELECOMMUTEvengono restituiti in qualsiasi ricerca relativa alla sede, ma sono considerati meno pertinenti. Possono essere targetizzati in una ricerca impostando iltelecommutePreferenceflag suTELECOMMUTE_ALLOWEDinLocationFilterdella ricerca.