Una risorsa Job rappresenta una singola offerta di lavoro (indicata anche come "elenco di offerte di lavoro" o "richiesta di lavoro"). Un job appartiene Società risorsa che rappresenta l'entità di assunzione responsabile del lavoro.
Puoi accedere a un job utilizzando i metodi LIST e GET e manipolarlo utilizzando i metodi CREATE, UPDATE ed DELETE. Potrebbero essere necessari diversi minuti l'indice di Cloud Talent Solution per riflettere i cambiamenti.
I job sono contenuti nell'ambito di un account di servizio. Solo le richieste di ricerca autenticate utilizzando le credenziali di un determinato account di servizio possono essere utilizzate per accedere ai contenuti di questi job.
Per risolvere facilmente i problemi e assegnare priorità, sincronizza l'indice dei job di Cloud Talent Solution
con il tuo indice di job e mantieni una relazione tra name
generati da Cloud Talent Solution e dall'identificatore univoco del job nel sistema. Man mano che i job cambiano o vengono introdotti nel 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
una pipeline esistente di importazione dei job.
Crea un job
Puoi creare un job utilizzando il codice di esempio riportato di seguito. Per ulteriori dettagli, consulta la guida rapida: crea aziende e offerte di lavoro. Sono inoltre disponibili tutorial video e codelab interattivi.
Go
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta API Go di CTS documentazione di riferimento.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per ulteriori informazioni, consulta API Java di CTS documentazione di riferimento.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Node.js.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Python.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Campi obbligatori
I seguenti campi sono obbligatori durante la creazione e l'aggiornamento del job:
companyName
: il nome della risorsa dell'azienda proprietaria del lavoro, ad esempiocompanyName=\"projects/{ProjectId}/companies/{CompanyId}\"
.requisitionId
: l'ID richiesta, noto anche come ID pubblicazione, è un valore che assegni per identificare un lavoro. Puoi utilizzare questo campo per l'identificazione del cliente e il monitoraggio delle richieste. Il valore massimo di caratteri consentiti è 225.L'unicità di un'offerta di lavoro viene determinata utilizzando una combinazione di
requisitionID
,companyName
e località. Se un job viene creata con una chiave specifica di questi attributi, questa chiave viene archiviata Impossibile creare l'indice di Cloud Talent Solution e non è possibile creare altri job con questi stessi campi fino all'eliminazione del job.title
: il titolo del lavoro, ad esempio "Ingegnere informatico". Il valore massimo di caratteri consentiti è 500.Per risolvere il problema dei risultati di ricerca mancanti a causa di titoli professionali non standard, Cloud Talent Solution sfrutta tutti i campi delle offerte di lavoro per comprendere il contesto della posizione e memorizzare internamente un titolo professionale "pulito". Quando una richiesta di ricerca viene inviata al servizio, viene pulita anche la query di ricerca e le ontologie vengono utilizzate per mappare la query pulita ai job di pulizia pertinenti.
description
: la descrizione del lavoro, che in genere include un descrizione in più paragrafi dell'azienda e informazioni correlate. Nell'oggetto Job sono disponibili campi distinti per responsabilità, qualifiche e altre caratteristiche del lavoro. Si consiglia di utilizzare questi campi separati.Questo campo accetta e sanitizza l'input HTML e accetta grassetto, corsivo tag di markup per elenco ordinato ed elenco non ordinato. Il numero massimo di caratteri consentiti è 100.000.
Il valore sarà uno dei seguenti:
applicationInfo.uris
: gli URL delle pagine dell'applicazione.applicationInfo.emails
: indirizzi email a cui il curriculum o le domande di adesione deve essere inviato.applicationInfo.instruction
: istruzioni per la richiesta, ad esempio "Invia la tua richiesta all'indirizzo ...". Questo campo accetta e convalida l'input HTML e i tag markup in grassetto, corsivo, elenco ordinato ed elenco non ordinato. Il numero massimo di caratteri consentiti è 3000.
Campi di uso comune
postingExpireTime
: l'ora, in base al timestamp, alla scadenza dell'offerta di lavoro. Dopo questo periodo di tempo, 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 es. 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 90 giorni dopo la scadenza del job utilizzando l'operatore GET. Dopo questa scadenza di 90 giorni, il job non verrà restituito tramite un'operazione GET.
addresses
: località del lavoro. Indicare l'indirizzo completo l'indirizzo o gli indirizzi della sede di assunzione sono consigliati per una migliore ricerca lavoro tra cui le ricerche per tempo di percorrenza del tragitto giornaliero. Il numero massimo consentito 500 caratteri. Ulteriori informazioni suaddresses
sono disponibili in Best practice di seguito.promotionValue
: un valore maggiore di 0 definisce questo job come "job in evidenza", che viene restituito solo nelle ricerche di tipoFEATURED_JOBS
. Superiore vengono restituiti più in alto nei risultati di ricerca in primo piano. Per ulteriori informazioni, consulta la sezione Posti di lavoro in primo piano.
Utilizzo dei campi personalizzati del job
Cloud Talent Solution include diversi campi di lavoro integrati negli schemi della sua API. Tuttavia, potresti aver bisogno di campi aggiuntivi non presenti nelle opzioni predefinite. Anche se consigliamo di usare le impostazioni predefinite,
campi quando possibile, Cloud Talent Solution offre anche alcuni customAttributes
campi per un job. Possono essere filtrabili o non filtrabili. Consulta
customAttributes
documentazione per ulteriori informazioni.
customAttributes
: questo campo memorizza fino a 100 attributi personalizzati utilizzati per archiviare dati personalizzati sul job. Questi campi possono essere filtrati usando una richiesta di ricerca che specifica il campojobQuery
. Inoltre, uno qualsiasi di questi campi può essere impostato nelkeywordSearchableJobCustomAttributes
dell'attributocompany
, quindi un termine di ricerca con una corrispondenza esatta in uno qualsiasi di i campi inkeywordSearchableJobCustomAttributes
restituiscono qualsiasi job che include la corrispondenza.
L'esempio di codice seguente mostra come creare un job con customAttribute
:
Go
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per ulteriori informazioni, consulta API Go di CTS documentazione di riferimento.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per ulteriori informazioni, consulta API Java di CTS documentazione di riferimento.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Node.js.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Python.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Recupera un job
Go
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta API Go di CTS documentazione di riferimento.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Java.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Node.js.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per ulteriori informazioni, consulta API Python di CTS documentazione di riferimento.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Elenca job
Go
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per ulteriori informazioni, consulta API Go di CTS documentazione di riferimento.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta API Java di CTS documentazione di riferimento.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Node.js.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta API Python di CTS documentazione di riferimento.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Elimina un job
Go
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per ulteriori informazioni, consulta API Go di CTS documentazione di riferimento.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta API Java di CTS documentazione di riferimento.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Node.js.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta API Python di CTS documentazione di riferimento.
Per autenticarti a CTS, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Best practice
Campi posizione
Se possibile, ti consigliamo di fornire l'indirizzo di un job nel
addresses
campo. Ciò contribuisce al rilevamento della posizione e alla pertinenza. Se non è disponibile un indirizzo al piano terra, inserisci il maggior numero possibile di informazioni.
Gli indirizzi sono supportati fino al livello di paese. Le designazioni delle regioni (ad esempio
"Pacifico nord-occidentale") non sono supportate.
Cloud Talent Solution utilizza i dati nel campo addresses
per compilare
nel campo (solo output) derivedInfo.locations
. 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 la scheda di lavoro.
Ad esempio, se la posizione di una posizione software è specificata come Mountain View
e l'azienda a cui è associato il lavoro è Google
, il servizio cerca l'oggetto company
per verificare se è fornito un indirizzo migliore nel campo headquartersAddress
e se questo indirizzo si trova nella stessa città della pubblicazione di lavoro. In questo caso, il servizio comprende che il lavoro è "probabilmente" situato all'indirizzo stradale specificato e compila il campo derivedInfo.locations
di conseguenza.
Se i dati dell'indirizzo dell'azienda non sono disponibili, il servizio utilizza una combinazione di
conoscenze proprietarie e informazioni sul lavoro/sull'azienda per informare il derivedInfo.locations
.
Poiché il valore derivedInfo.locations
è una stima approssimativa, ti consigliamo di utilizzare i dati derivedInfo.locations
o il campo addresses
quando mostri l'indirizzo del job.
A un'offerta di lavoro non possono essere associate più di 50 località. Se un job
ha più sedi da cui è possibile suddividere il lavoro in più job, ognuno con un
requisitionId (ad esempio, 'ReqA' , 'ReqA-1', 'ReqA-2' e così via). Avere più persone
i job con gli stessi valori requisitionId
, , companyName
e languageCode
non sono
consentito. Se è necessario conservare il requisitionId
originale, per l'archiviazione deve essere utilizzato un CustomAttribute
. Per una migliore esperienza di ricerca, ti consigliamo di raggruppare le sedi più vicine tra loro nello stesso job.
Indirizzi supportati
Qualsiasi indirizzo riconosciuto dall'API Geocoding di Google Maps (nel
formattedAddress
) è accettata da Cloud Talent Solution. Il servizio
restituisce un errore 400 se provi a creare un job o a eseguire una ricerca
utilizzando un indirizzo non riconosciuto.
Se l'indirizzo di un'attività è elencato in modo errato nell'API Geocoding di Google Maps, segnalare un bug per richiederne la correzione. L'applicazione delle correzioni potrebbe richiedere fino a 5 giorni.
Completamento automatico degli indirizzi
Cloud Talent Solution non fornisce suggerimenti di completamento automatico per le località. Utilizza l'API Google Maps Places o altri servizi di geolocalizzazione simili per compilare suggerimenti di completamento automatico.
Offerte di lavoro a livello statale, nazionale e telelavoro
I lavori possono essere specificati a livello di stato, nazionale o telelavoro utilizzando
postingRegion
.
Le offerte di lavoro
ADMINISTRATIVE_AREA
eNATION
vengono restituite per qualsiasi ricerca con una località specificata all'interno dello stato/del paese dell'annuncio di lavoro. Ad esempio, se un jobADMINISTRATIVE_AREA
ha come località "WA, USA", viene visualizzato per le ricerche conADMINISTRATIVE_AREA
che specifica "Seattle".TELECOMMUTE
job vengono restituiti in qualsiasi ricerca correlata alla località, ma sono considerati meno rilevanti. Possono essere scelti come target in una ricerca impostando il flagtelecommutePreference
suTELECOMMUTE_ALLOWED
inLocationFilter
della ricerca.