Una risorsa Job rappresenta un singolo annuncio di lavoro (chiamato anche "annuncio di lavoro" o "richiesta di lavoro"). Un job appartiene a una risorsa Company che rappresenta l'entità di assunzione responsabile del job.
Puoi accedere a un job utilizzando i metodi LIST e GET e manipolarlo utilizzando i metodi CREATE, UPDATE e DELETE. Potrebbero essere necessari alcuni minuti prima che l'indice di Cloud Talent Solution rifletta 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 utilizzando 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 cambiano o vengono introdotti nel tuo sistema, la chiamata CRUD appropriata deve essere inviata a CTS in tempo reale per garantire che queste modifiche vengano applicate immediatamente. L'indice CTS deve essere aggiunto alla pipeline di importazione dei job esistente.
Crea un job
Puoi creare un job utilizzando l'esempio di codice riportato di seguito. Per maggiori dettagli, consulta la guida rapida: crea aziende e job. Sono disponibili anche video tutorial e codelab interattivi.
Go
Per scoprire come installare e utilizzare la libreria client per CTS, consulta la sezione Librerie client CTS. Per saperne di più, consulta la documentazione di riferimento dell'API CTS Go.
Per eseguire l'autenticazione in CTS, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
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.
Campi obbligatori
I seguenti campi sono obbligatori durante la creazione e l'aggiornamento dei job:
companyName: il nome della risorsa dell'azienda proprietaria del job, ad esempiocompanyName=\"projects/{ProjectId}/companies/{CompanyId}\".requisitionId: l'ID della richiesta, chiamato anche ID dell'annuncio, è un valore che assegni per identificare un job. Puoi utilizzare questo campo per l'identificazione del cliente e il monitoraggio delle richieste. Il numero massimo di caratteri consentiti è 225.L'unicità di un annuncio di lavoro è determinata utilizzando una combinazione di
requisitionID,companyNamee località. 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 informatico". 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 dei job per comprendere il contesto del job e memorizzare internamente un titolo di job "pulito". 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. Nell'oggetto Job sono forniti campi separati per responsabilità, qualifiche e altre caratteristiche del job. È consigliabile utilizzare questi campi 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'annuncio di lavoro. Dopo questo orario, 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 l'ora 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 del job. È consigliabile fornire gli indirizzi stradali completi delle sedi di assunzione per ottenere risultati migliori nella ricerca di job, incluse le ricerche per tempo di percorrenza. Il numero massimo di caratteri consentiti è 500. Ulteriori informazioni suaddressessono 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 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.
Utilizzare i campi dei job personalizzati
Cloud Talent Solution include diversi campi dei job integrati negli schemi delle API. Tuttavia, potresti aver bisogno di campi aggiuntivi non presenti nelle opzioni predefinite. Sebbene ti consigliamo di utilizzare i campi predefiniti, se possibile, Cloud Talent Solution fornisce anche alcuni campi customAttributes per un job. Questi possono essere filtrabili o non filtrabili. Per saperne di più, consulta la
customAttributes
documentazione per più informazioni.
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 campojobQuery. Inoltre, uno qualsiasi di questi campi può essere impostato nell'attributokeywordSearchableJobCustomAttributesdicompany, in modo che un termine di ricerca che abbia una corrispondenza esatta in uno qualsiasi dei campi inkeywordSearchableJobCustomAttributesrestituisca qualsiasi job che includa la corrispondenza.
L'esempio di codice riportato di seguito mostra come creare un job con un customAttribute:
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
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.
Recupera un job
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
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.
Elenca job
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
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.
Elimina un job
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
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.
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 una posizione software è specificata come Mountain View e l'azienda a cui è associato il job è Google, il servizio cerca l'oggetto company per verificare se nel campo headquartersAddress è fornito un indirizzo stradale migliore e se l'indirizzo stradale si trova nella stessa città dell'offerta di lavoro. In caso affermativo, il servizio comprende che il job si trova "probabilmente"
all'indirizzo stradale e compila il derivedInfo.locations campo in modo appropriato.
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 annuncio 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 esempio, "ReqA", "ReqA-1", "ReqA-2" e così via). Non è consentito avere più job con lo stesso requisitionId, companyName e languageCode. Se l'requisitionId originale deve essere conservato, è 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
Cloud Talent Solution accetta qualsiasi indirizzo riconosciuto dall'API Geocoding di Google Maps (nel campo
formattedAddress). 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à viene visualizzato in modo errato nell'API Geocoding di Google Maps, segnala un bug per correggerlo. Le correzioni potrebbero richiedere fino a 5 giorni per essere applicate.
Completamento automatico dell'indirizzo
Cloud Talent Solution non fornisce suggerimenti di completamento automatico per le località. Utilizza l'API Places di Google Maps o altri servizi di localizzazione simili per popolare i suggerimenti di completamento automatico.
Job a livello statale, nazionale e di telelavoro
I job possono essere specificati come a livello statale, nazionale o di telelavoro utilizzando il
postingRegion campo.
I job
ADMINISTRATIVE_AREAeNATIONvengono restituiti per qualsiasi ricerca con una località specificata all'interno dello stato/paese dell'offerta di lavoro. Ad esempio, se un jobADMINISTRATIVE_AREAha una località "WA, USA", viene restituito per le ricerche conLocationFilterche specifica "Seattle".I job
TELECOMMUTEvengono restituiti in qualsiasi ricerca relativa alla località, ma sono considerati meno pertinenti. Possono essere targetizzati in una ricerca impostando iltelecommutePreferenceflag suTELECOMMUTE_ALLOWEDinLocationFilterdella ricerca.