Nozioni di base sul job (v3)

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.

/** Create a job. */
public static Job createJob(Job jobToBeCreated) throws IOException {
  try {
    CreateJobRequest createJobRequest = new CreateJobRequest().setJob(jobToBeCreated);

    Job jobCreated =
        talentSolutionClient
            .projects()
            .jobs()
            .create(DEFAULT_PROJECT_ID, createJobRequest)
            .execute();
    System.out.println("Job created: " + jobCreated);
    return jobCreated;
  } catch (IOException e) {
    System.out.println("Got exception while creating job");
    throw e;
  }
}

Python

Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.

def create_job(client_service, job_to_be_created):
    try:
        request = {"job": job_to_be_created}
        job_created = (
            client_service.projects()
            .jobs()
            .create(parent=parent, body=request)
            .execute()
        )
        print("Job created: %s" % job_created)
        return job_created
    except Error as e:
        print("Got exception while creating job")
        raise e

Go

Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.


// createJob create a job as given.
func createJob(w io.Writer, projectID string, jobToCreate *talent.Job) (*talent.Job, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	parent := "projects/" + projectID
	req := &talent.CreateJobRequest{
		Job: jobToCreate,
	}
	job, err := service.Projects.Jobs.Create(parent, req).Do()
	if err != nil {
		return nil, fmt.Errorf("Failed to create job %q, Err: %w", jobToCreate.RequisitionId, err)
	}
	return job, err
}

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 esempio projects/[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, companyName e 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 su addresses[] 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 tipo FEATURED_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 campo jobQuery di una richiesta di ricerca di job. Inoltre, uno qualsiasi di questi campi può essere impostato nell'attributo keywordSearchableJobCustomAttributes dell'azienda, in modo che un termine di ricerca che abbia una corrispondenza esatta in uno qualsiasi dei campi in keywordSearchableJobCustomAttributes restituisca 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.

/** Update a job. */
public static Job updateJob(String jobName, Job jobToBeUpdated) throws IOException {
  try {
    UpdateJobRequest updateJobRequest = new UpdateJobRequest().setJob(jobToBeUpdated);
    Job jobUpdated =
        talentSolutionClient.projects().jobs().patch(jobName, updateJobRequest).execute();
    System.out.println("Job updated: " + jobUpdated);
    return jobUpdated;
  } catch (IOException e) {
    System.out.println("Got exception while updating job");
    throw e;
  }
}

Python

Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.

def update_job(client_service, job_name, job_to_be_updated):
    try:
        request = {"job": job_to_be_updated}
        job_updated = (
            client_service.projects()
            .jobs()
            .patch(name=job_name, body=request)
            .execute()
        )
        print("Job updated: %s" % job_updated)
        return job_updated
    except Error as e:
        print("Got exception while updating job")
        raise e

Go

Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.


// updateJob update a job with all fields except name.
func updateJob(w io.Writer, jobName string, jobToUpdate *talent.Job) (*talent.Job, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	req := &talent.UpdateJobRequest{
		Job: jobToUpdate,
	}
	job, err := service.Projects.Jobs.Patch(jobName, req).Do()
	if err != nil {
		return nil, fmt.Errorf("Failed to update job %s: %w", jobName, err)
	}

	return job, err
}

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.

/** Update a job. */
public static Job updateJobWithFieldMask(String jobName, String fieldMask, Job jobToBeUpdated)
    throws IOException {
  try {
    UpdateJobRequest updateJobRequest =
        new UpdateJobRequest().setUpdateMask(fieldMask).setJob(jobToBeUpdated);
    Job jobUpdated =
        talentSolutionClient.projects().jobs().patch(jobName, updateJobRequest).execute();
    System.out.println("Job updated: " + jobUpdated);
    return jobUpdated;
  } catch (IOException e) {
    System.out.println("Got exception while updating job");
    throw e;
  }
}

Python

Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.

def update_job_with_field_mask(client_service, job_name, job_to_be_updated, field_mask):
    try:
        request = {"job": job_to_be_updated, "update_mask": field_mask}
        job_updated = (
            client_service.projects()
            .jobs()
            .patch(name=job_name, body=request)
            .execute()
        )
        print("Job updated: %s" % job_updated)
        return job_updated
    except Error as e:
        print("Got exception while updating job with field mask")
        raise e

Go

Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.


// updateJobWithMask updates a job by name with specific fields.
// mask is a comma separated list top-level fields of talent.Job.
func updateJobWithMask(w io.Writer, jobName string, mask string, jobToUpdate *talent.Job) (*talent.Job, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	req := &talent.UpdateJobRequest{
		Job:        jobToUpdate,
		UpdateMask: mask,
	}
	job, err := service.Projects.Jobs.Patch(jobName, req).Do()
	if err != nil {
		log.Fatalf("Failed to update job %s with field mask %s, Err: %v", jobName, mask, err)
	}

	return job, err
}

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_AREA e NATION vengono restituiti per qualsiasi ricerca la cui sede si trovi all'interno dello stato/paese dell'offerta di lavoro. Ad esempio, se un job ADMINISTRATIVE_AREA ha una sede "WA, USA", viene restituito per le ricerche in cui LocationFilter specifica "Seattle".

  • I job TELECOMMUTE vengono restituiti in qualsiasi ricerca relativa alla sede, ma sono considerati meno pertinenti. Possono essere targetizzati in una ricerca impostando il telecommutePreference flag su TELECOMMUTE_ALLOWED in LocationFilter della ricerca.