Package google.cloud.talent.v4beta1

Indice

CompanyService

Un servizio che gestisce la gestione dell'azienda, inclusi CRUD ed enumerazione.

CreateCompany

rpc CreateCompany(CreateCompanyRequest) returns (Company)

Crea una nuova entità aziendale.

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.

DeleteCompany

rpc DeleteCompany(DeleteCompanyRequest) returns (Empty)

Elimina l'azienda specificata. Prerequisito: l'azienda non ha nessun lavoro associato.

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.

GetCompany

rpc GetCompany(GetCompanyRequest) returns (Company)

Recupera l'azienda specificata.

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.

ListCompanies

rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse)

Elenca tutte le aziende associate al progetto.

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.

UpdateCompany

rpc UpdateCompany(UpdateCompanyRequest) returns (Company)

Aggiorna l'azienda specificata.

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.

Completamento

Un servizio gestisce il completamento automatico.

CompleteQuery

rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse)

Completa il prefisso specificato con le parole chiave suggerite. Destinato a essere utilizzato da una casella di ricerca con completamento automatico per la ricerca lavoro.

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.

EventService

Un servizio gestisce il report sugli eventi del client.

CreateClientEvent

rpc CreateClientEvent(CreateClientEventRequest) returns (ClientEvent)

Segnala gli eventi generati quando l'utente finale interagisce con l'applicazione del cliente che utilizza Cloud Talent Solution. Puoi controllare gli eventi creati negli strumenti self-service. Scopri di più sugli strumenti self-service.

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.

JobService

Un servizio gestisce la gestione dei job, inclusi i job CRUD, l'enumerazione e la ricerca.

BatchCreateJobs

rpc BatchCreateJobs(BatchCreateJobsRequest) returns (Operation)

Avvia l'esecuzione di un'operazione di creazione dei job in batch.

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.

BatchDeleteJobs

rpc BatchDeleteJobs(BatchDeleteJobsRequest) returns (Empty)

Elimina un elenco di Job in base al filtro.

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.

BatchUpdateJobs

rpc BatchUpdateJobs(BatchUpdateJobsRequest) returns (Operation)

Avvia l'esecuzione di un'operazione di job di aggiornamento batch.

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.

CreateJob

rpc CreateJob(CreateJobRequest) returns (Job)

Crea un nuovo job.

In genere, il job diventa disponibile per la ricerca entro 10 secondi, ma potrebbero essere necessari fino a 5 minuti.

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.

DeleteJob

rpc DeleteJob(DeleteJobRequest) returns (Empty)

Elimina il job specificato.

In genere, il job non può essere ricercato entro 10 secondi, ma potrebbero essere necessari fino a 5 minuti.

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.

GetJob

rpc GetJob(GetJobRequest) returns (Job)

Recupera il job specificato, il cui stato è APERTO o SCADUTO di recente negli ultimi 90 giorni.

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.

ListJobs

rpc ListJobs(ListJobsRequest) returns (ListJobsResponse)

Elenca i job per filtro.

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.

SearchJobs

rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse)

Cerca offerte di lavoro utilizzando il SearchJobsRequest fornito.

Questa chiamata limita il visibility dei job presenti nel database e restituisce solo i job in base ai quali il chiamante è autorizzato a eseguire ricerche.

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.

SearchJobsForAlert

rpc SearchJobsForAlert(SearchJobsRequest) returns (SearchJobsResponse)

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.

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.

UpdateJob

rpc UpdateJob(UpdateJobRequest) returns (Job)

Aggiorna il job specificato.

In genere, i contenuti aggiornati diventano visibili nei risultati di ricerca entro 10 secondi, ma potrebbero essere necessari fino a 5 minuti.

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.

TenantService

Un servizio che gestisce la gestione dei tenant, inclusi CRUD ed enumerazione.

CreateTenant

rpc CreateTenant(CreateTenantRequest) returns (Tenant)

Crea una nuova entità tenant.

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.

DeleteTenant

rpc DeleteTenant(DeleteTenantRequest) returns (Empty)

Elimina il tenant specificato.

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.

GetTenant

rpc GetTenant(GetTenantRequest) returns (Tenant)

Recupera il tenant specificato.

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.

ListTenants

rpc ListTenants(ListTenantsRequest) returns (ListTenantsResponse)

Elenca tutti i tenant associati al progetto.

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.

UpdateTenant

rpc UpdateTenant(UpdateTenantRequest) returns (Tenant)

Aggiorna il tenant specificato.

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.

BatchCreateJobsRequest

Richiesta di creazione di un batch di job.

Campi
parent

string

Obbligatorio. Il nome della risorsa del tenant con cui viene creato il job.

Il formato è "projects/{project_id}/tenants/{tenant_id}". Ad esempio, "projects/foo/tenant/bar". Se l'ID tenant non è specificato, viene creato un tenant predefinito. Ad esempio, "projects/foo".

jobs[]

Job

Obbligatorio. I job da creare.

BatchDeleteJobsRequest

Richiesta di eliminazione in batch dei job.

Campi
parent

string

Obbligatorio. Il nome della risorsa del tenant con cui viene creato il job.

Il formato è "projects/{project_id}/tenants/{tenant_id}". Ad esempio, "projects/foo/tenant/bar". Se l'ID tenant non è specificato, viene creato un tenant predefinito. Ad esempio, "projects/foo".

filter

string

Obbligatorio. La stringa di filtro specifica i job da eliminare.

Operatore supportato: =, AND

I campi idonei per il filtro sono:

  • companyName (obbligatorio)
  • requisitionId (obbligatorio)

Esempio di query: companyName = "projects/foo/businesses/bar" AND requisitionId = "req-1"

BatchOperationMetadata

Metadati utilizzati per operazioni a lunga esecuzione restituite dalle API batch CTS. Viene utilizzato per sostituire google.longrunning.Operation.metadata.

Campi
state

State

Lo stato di un'operazione a lunga esecuzione.

state_description

string

Informazioni più dettagliate sullo stato dell'operazione.

success_count

int32

Conteggio degli elementi riusciti all'interno di un'operazione.

failure_count

int32

Conteggio degli elementi non riusciti all'interno di un'operazione.

total_count

int32

Conteggio degli elementi totali all'interno di un'operazione.

create_time

Timestamp

L'ora in cui viene creata l'operazione batch.

update_time

Timestamp

L'ora in cui viene aggiornato lo stato dell'operazione collettiva. I metadati e il update_time vengono aggiornati ogni minuto, altrimenti vengono restituiti i dati memorizzati nella cache.

end_time

Timestamp

L'ora in cui l'operazione collettiva è terminata e google.longrunning.Operation.done è impostato su true.

Stato

Enum
STATE_UNSPECIFIED Valore predefinito.
INITIALIZING L'operazione batch è in fase di preparazione per l'elaborazione.
PROCESSING L'operazione batch è in fase di elaborazione.
SUCCEEDED L'operazione batch è stata elaborata ed è stato elaborato correttamente almeno un elemento.
FAILED L'operazione batch è stata completata e nessun elemento è stato elaborato correttamente.
CANCELLING L'operazione batch è in fase di annullamento dopo la chiamata di google.longrunning.Operations.CancelOperation.
CANCELLED L'operazione batch viene eseguita dopo la chiamata a google.longrunning.Operations.CancelOperation. Tutti gli articoli elaborati prima dell'annullamento vengono restituiti nella risposta.

BatchUpdateJobsRequest

Richiesta di aggiornamento di un batch di job.

Campi
parent

string

Obbligatorio. Il nome della risorsa del tenant con cui viene creato il job.

Il formato è "projects/{project_id}/tenants/{tenant_id}". Ad esempio, "projects/foo/tenant/bar". Se l'ID tenant non è specificato, viene creato un tenant predefinito. Ad esempio, "projects/foo".

jobs[]

Job

Obbligatorio. I job da aggiornare.

update_mask

FieldMask

Fortemente consigliato per un'esperienza di servizio ottimale. Tieni presente che aumenterà la latenza anche quando si controlla lo stato di un'operazione batch.

Se viene fornito il valore update_mask, vengono aggiornati solo i campi specificati in Job. In caso contrario, tutti i campi vengono aggiornati.

Una maschera di campo per limitare i campi aggiornati. Sono supportati solo i campi di primo livello di Job.

Se viene fornito update_mask, l'elemento Job all'interno di JobResult conterrà solo i campi aggiornati, più l'ID del job. In caso contrario, Job includerà tutti i campi, il che può generare una risposta di dimensioni molto grandi.

ClientEvent

Un evento emesso quando un utente finale interagisce con l'applicazione che implementa Cloud Talent Solution. Queste informazioni migliorano la qualità dei risultati per i client API, consentendo al servizio di funzionare in modo ottimale. Il numero di eventi inviati deve essere coerente con le altre chiamate, ad esempio le ricerche di lavoro, inviate al servizio dal client.

Campi
request_id

string

Fortemente consigliato per un'esperienza di servizio ottimale.

Un ID univoco generato nelle risposte dell'API. Lo puoi trovare in ResponseMetadata.request_id.

event_id

string

Obbligatorio. Un identificatore univoco generato dall'applicazione client.

create_time

Timestamp

Obbligatorio. Il timestamp dell'evento.

event_notes

string

Note sull'evento fornite dai reclutatori o da altri utenti, ad esempio, feedback sul motivo per cui un profilo è stato aggiunto ai preferiti.

job_event

JobEvent

Un evento emesso quando una persona in cerca di lavoro interagisce con l'applicazione che implementa Cloud Talent Solution.

CommuteFilter

Parametri necessari per la ricerca per tragitto giornaliero.

Campi
commute_method

CommuteMethod

Obbligatorio. Il metodo di trasporto per il quale calcolare la durata del tragitto giornaliero.

start_coordinates

LatLng

Obbligatorio. La latitudine e la longitudine della posizione da cui calcolare il tempo di percorrenza del tragitto giornaliero.

travel_duration

Duration

Obbligatorio. Il tempo di percorrenza massimo in secondi. Il valore massimo consentito è 3600s (un'ora). Il formato è 123s.

allow_imprecise_addresses

bool

Se true, possono essere restituite anche lavori senza indirizzi a livello stradale. Per gli indirizzi a livello di città, viene utilizzato il centro città. Per gli indirizzi di stato e di livello più approssimativo, viene utilizzata la corrispondenza del testo. Se questo campo viene impostato su false o non viene specificato, solo le offerte di lavoro che includono indirizzi a livello stradale verranno restituite dalla ricerca per tragitto giornaliero.

Campo di unione traffic_option. Fattore di traffico da prendere in considerazione quando effettui una ricerca in base al tragitto giornaliero. traffic_option può essere solo uno dei seguenti:
road_traffic

RoadTraffic

Specifica la densità del traffico da utilizzare per il calcolo della durata del tragitto giornaliero.

departure_time

TimeOfDay

L'ora di partenza utilizzata per calcolare l'impatto sul traffico, espressa come google.type.TimeOfDay nel fuso orario locale.

Attualmente il modello di traffico è limitato alla risoluzione a livello di ora.

RoadTraffic

La densità del traffico da utilizzare per il calcolo della durata del tragitto giornaliero.

Enum
ROAD_TRAFFIC_UNSPECIFIED La situazione del traffico stradale non è specificata.
TRAFFIC_FREE Tempo di percorrenza ottimale senza considerare l'impatto sul traffico.
BUSY_HOUR Il calcolo della durata del tragitto giornaliero tiene conto dell'impatto dei picchi sul traffico.

CommuteMethod

Metodo di tragitto giornaliero.

Enum
COMMUTE_METHOD_UNSPECIFIED Il metodo del tragitto giornaliero non è specificato.
DRIVING Il tempo del tragitto giornaliero è calcolato in base al tempo di guida.
TRANSIT La durata del tragitto giornaliero viene calcolata in base al trasporto pubblico, inclusi autobus, metropolitana, metropolitana e così via.
WALKING La durata del tragitto giornaliero viene calcolata in base al tempo di percorrenza a piedi.
CYCLING La durata del tragitto giornaliero viene calcolata in base al tempo trascorso in bici.

Azienda

Una risorsa Azienda rappresenta un'azienda nel servizio. Una società è l'entità che possiede le offerte di lavoro, ovvero l'entità responsabile dell'assunzione dei candidati per la posizione lavorativa.

Campi
name

string

Obbligatorio durante l'aggiornamento dell'azienda.

Il nome della risorsa per un'azienda. Questo viene generato dal servizio al momento della creazione di un'azienda.

Il formato è "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}", ad esempio "projects/foo/tenants/bar/businesses/baz".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito. Ad esempio, "projects/foo/offers/bar".

display_name

string

Obbligatorio. Il nome visualizzato dell'azienda, ad esempio "Google LLC".

external_id

string

Obbligatorio. Identificatore azienda lato client, utilizzato per identificare in modo univoco l'azienda.

Il numero massimo di caratteri consentiti è 255.

size

CompanySize

Le dimensioni dell'azienda del datore di lavoro.

headquarters_address

string

L'indirizzo della sede principale dell'azienda, che può essere diverso dalla località del lavoro. Il servizio tenta di geolocalizzare l'indirizzo fornito e compila una località più specifica quando possibile in DerivedInfo.headquarters_location.

hiring_agency

bool

Imposta su true se è l'agenzia che carica le offerte di lavoro per altri datori di lavoro.

Se non viene specificato, il valore predefinito è false.

eeo_text

string

Testo del disclaimer legale per le pari opportunità di lavoro da associare a tutte le offerte di lavoro e che generalmente deve essere visualizzato in tutti i ruoli.

Il numero massimo di caratteri consentiti è 500.

website_uri

string

L'URI che rappresenta la home page o il sito web principale dell'azienda, ad esempio "https://www.google.com".

Il numero massimo di caratteri consentiti è 255.

career_site_uri

string

L'URI al sito delle offerte di lavoro o alla pagina delle offerte di lavoro del datore di lavoro sul sito web del datore di lavoro, ad esempio "https://careers.google.com".

image_uri

string

Un URI che ospita il logo dell'azienda del datore di lavoro.

keyword_searchable_job_custom_attributes[]

string

Un elenco di chiavi di Job.custom_attributes filtrabili, le cui string_values corrispondenti vengono utilizzate nelle ricerche di parole chiave. I job con string_values sotto queste chiavi dei campi specificati vengono restituiti se uno qualsiasi dei valori corrisponde alla parola chiave per la ricerca. I valori dei campi personalizzati con parentesi, parentesi e simboli speciali non sono disponibili per la ricerca così come sono e le query basate su parole chiave devono essere racchiuse tra virgolette.

derived_info

DerivedInfo

Solo output. Dettagli derivati sull'azienda.

suspended

bool

Solo output. Indica se una società è contrassegnata come sospesa dalla disponibilità pubblica dal servizio quando i contenuti relativi a offerte di lavoro sembrano sospetti, illeciti o contenenti spam.

DerivedInfo

Dettagli derivati sull'azienda.

Campi
headquarters_location

Location

Una sede strutturata della sede centrale dell'azienda, risolta a partire da Company.headquarters_address, se fornita.

CompanySize

Un'enumerazione che rappresenta le dimensioni dell'azienda.

Enum
COMPANY_SIZE_UNSPECIFIED Valore predefinito se la dimensione non è specificata.
MINI L'azienda ha meno di 50 dipendenti.
SMALL L'azienda ha tra 50 e 99 dipendenti.
SMEDIUM L'azienda ha tra 100 e 499 dipendenti.
MEDIUM L'azienda ha tra 500 e 999 dipendenti.
BIG L'azienda ha tra 1.000 e 4.999 dipendenti.
BIGGER L'azienda ha tra 5.000 e 9.999 dipendenti.
GIANT L'azienda ha 10.000 o più dipendenti.

CompensationFilter

Filtra in base al tipo e all'importo di compensazione del lavoro.

Campi
type

FilterType

Obbligatorio. Tipo di filtro.

units[]

CompensationUnit

Obbligatorio. Specifica l'CompensationInfo.CompensationUnit base compensation entry's desiderato.

range

CompensationRange

Intervallo di compensazione.

include_jobs_with_unspecified_compensation_range

bool

Se impostato su true, vengono inclusi i job con campi di intervallo di compensazione non specificati.

FilterType

Specifica il tipo di filtro.

Enum
FILTER_TYPE_UNSPECIFIED Tipo di filtro non specificato. Il segnaposto della posizione NON VALIDO non deve mai essere utilizzato.
UNIT_ONLY

Filtra per unità base compensation entry's. Un job è una corrispondenza solo se contiene una CompensationEntry di base e l'unità di CompensationEntry di base corrisponde a quella indicata con units. Compila uno o più units.

Consulta CompensationInfo.CompensationEntry per la definizione della voce di compensazione di base.

UNIT_AND_AMOUNT

Filtra per base compensation entry's unità e quantità / intervallo. Un job è una corrispondenza solo se contiene una voce CompensationEntry di base e se l'unità della voce di base corrisponde a quella fornita con CompensationUnit e se la quantità o l'intervallo si sovrappone a quella fornita con CompensationRange.

Consulta CompensationInfo.CompensationEntry per la definizione della voce di compensazione di base.

Imposta un solo valore units e compila il campo range.

ANNUALIZED_BASE_AMOUNT

Filtra per importo della compensazione di base annuale e unità base compensation entry's. Compila range e zero o più units.

ANNUALIZED_TOTAL_AMOUNT

Filtra per importo totale della compensazione annuale e base compensation entry's unità . Compila range e zero o più units.

CompensationInfo

Dettagli della retribuzione del lavoro.

Campi
entries[]

CompensationEntry

Informazioni sulla retribuzione del lavoro.

Al massimo una voce può essere di tipo CompensationInfo.CompensationType.BASE, indicata come voce di compensazione di base per il lavoro.

annualized_base_compensation_range

CompensationRange

Solo output. Intervallo di compensazione di base annualizzato. Calcolato come valore della voce di compensazione di base CompensationEntry.amount per CompensationEntry.expected_units_per_year.

Consulta CompensationEntry per spiegazioni sull'annualizzazione della retribuzione.

annualized_total_compensation_range

CompensationRange

Solo output. Intervallo di retribuzione totale annualizzato. Calcolato come CompensationEntry.amount per CompensationEntry.expected_units_per_year di tutte le voci di compensazione.

Consulta CompensationEntry per spiegazioni sull'annualizzazione della retribuzione.

CompensationEntry

Una voce di compenso che rappresenta un componente del compenso, come la paga base, il bonus o un altro tipo di compenso.

Annualizzazione: una voce di compensazione può essere annualizzata se contiene amount o range validi. - e il relativo expected_units_per_year è impostato o può essere ricavato. L'intervallo annuale è determinato da (amount o range) volte expected_units_per_year.

Campi
type

CompensationType

Tipo di compensazione.

Il valore predefinito è CompensationType.COMPENSATION_TYPE_UNSPECIFIED.

unit

CompensationUnit

Frequenza dell'importo specificato.

Il valore predefinito è CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.

description

string

Descrizione della retribuzione. Ad esempio, potrebbe indicare termini azionari o fornire un contesto aggiuntivo su un bonus stimato.

expected_units_per_year

DoubleValue

Numero previsto di unità pagate ogni anno. Se non specificato, quando Job.employment_types è FULLTIME, viene dedotto un valore predefinito in base al valore unit. Valori predefiniti: - ORARIO: 2080 - GIORNALIERO: 260 - SETTIMANALE: 52 - MENSILE: 12 - ANNUALE: 1

Campo di unione compensation_amount. Importo del compenso. Può essere un importo fisso o un intervallo mobile. compensation_amount può essere solo uno dei seguenti:
amount

Money

Importo del compenso.

range

CompensationRange

Intervallo di compensazione.

CompensationRange

Intervallo di compensazione.

Campi
max_compensation

Money

L'importo massimo del compenso. Se il campo viene lasciato vuoto, il valore viene impostato su un valore di compensazione massimo e il codice valuta viene impostato in modo che corrisponda al valore currency code di min_compensation.

min_compensation

Money

L'importo minimo del compenso. Se viene lasciato vuoto, il valore viene impostato su zero e il codice valuta viene impostato in modo che corrisponda al valore currency code di max_compensation.

CompensationType

Il tipo di risarcimento.

Per gli importi di compensazione specificati in importi non monetari, descrivere il regime di compensazione nel CompensationEntry.description.

Ad esempio, il formato delle mance è descritto in CompensationEntry.description (ad esempio, "prevedi il 15-20% di suggerimenti in base alla fattura del cliente") e una stima dei suggerimenti forniti in CompensationEntry.amount o CompensationEntry.range (10 $ l'ora).

Ad esempio, il capitale azionario è descritto in CompensationEntry.description (ad esempio, "1% - 2% quota di capitale vesting in 4 anni, 1 anno di cliff") e il valore stimato in CompensationEntry.amount o CompensationEntry.range. Se non è possibile effettuare una stima del valore, le unità sono CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED e vengono ulteriormente chiarite nel campo CompensationEntry.description.

Enum
COMPENSATION_TYPE_UNSPECIFIED Valore predefinito.
BASE Retribuzione di base: si riferisce all'importo fisso pagato da un datore di lavoro a un dipendente in cambio del lavoro svolto. La retribuzione di base non include benefici, bonus o qualsiasi altra retribuzione potenziale da parte di un datore di lavoro.
BONUS Bonus.
SIGNING_BONUS Bonus di firma.
EQUITY Equità.
PROFIT_SHARING Condivisione dei profitti.
COMMISSIONS Commissione.
TIPS Suggerimenti.
OTHER_COMPENSATION_TYPE Altro tipo di compensazione.

CompensationUnit

Frequenza di pagamento.

Enum
COMPENSATION_UNIT_UNSPECIFIED Valore predefinito.
HOURLY Ogni ora.
DAILY Ogni giorno.
WEEKLY Settimanale
MONTHLY Mensile.
YEARLY Ogni anno.
ONE_TIME Una volta.
OTHER_COMPENSATION_UNIT Altre unità di compensazione.

CompleteQueryRequest

Parametri per il completamento automatico.

Campi
parent

string

Obbligatorio. Nome risorsa del tenant in cui viene eseguito il completamento.

Il formato è "projects/{project_id}/tenants/{tenant_id}", ad esempio "projects/foo/tenant/bar".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito, ad esempio "projects/foo".

query

string

Obbligatorio. La query utilizzata per generare suggerimenti.

Il numero massimo di caratteri consentiti è 255.

language_codes[]

string

L'elenco di lingue della query. Si tratta del codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta la sezione Tag per l'identificazione delle lingue.

Il numero massimo di caratteri consentiti è 255.

page_size

int32

Obbligatorio. Conteggio dei risultati del completamento.

Le dimensioni massime consentite per le pagine sono 10.

company

string

Se fornito, limita il completamento all'azienda specificata.

Il formato è "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}", ad esempio "projects/foo/tenants/bar/businesses/baz".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito, ad esempio "projects/foo".

scope

CompletionScope

L'ambito del completamento. Il valore predefinito è CompletionScope.PUBLIC.

type

CompletionType

L'argomento del completamento. Il valore predefinito è CompletionType.COMBINED.

CompletionScope

Enum per specificare l'ambito del completamento.

Enum
COMPLETION_SCOPE_UNSPECIFIED Valore predefinito.
TENANT I suggerimenti si basano solo sui dati forniti dal cliente.
PUBLIC I suggerimenti si basano su tutti i dati dei job nel sistema visibili al client

CompletionType

Enum per specificare gli argomenti per il completamento automatico.

Enum
COMPLETION_TYPE_UNSPECIFIED Valore predefinito.
JOB_TITLE

Suggerisci qualifiche per il completamento automatico dei job.

Per il tipo CompletionType.JOB_TITLE, vengono restituiti solo i job aperti con lo stesso language_codes.

COMPANY_NAME

Suggerisci nomi di aziende per il completamento automatico dei job.

Per il tipo CompletionType.COMPANY_NAME, vengono restituite solo le aziende con offerte di lavoro aperte con lo stesso language_codes.

COMBINED

Suggerisci sia le qualifiche che i nomi delle aziende per il completamento automatico dei lavori.

Per il tipo CompletionType.COMBINED, vengono restituite solo le offerte di lavoro aperte con lo stesso language_codes o le aziende con offerte di lavoro disponibili con lo stesso language_codes.

CompleteQueryResponse

Risposta della query a completamento automatico.

Campi
completion_results[]

CompletionResult

Risultati dei candidati dell'offerta di lavoro o dell'azienda corrispondenti.

metadata

ResponseMetadata

Informazioni aggiuntive per la chiamata all'API, ad esempio l'ID monitoraggio della richiesta.

CompletionResult

Risorsa che rappresenta i risultati di completamento.

Campi
suggestion

string

Il suggerimento per la query.

type

CompletionType

L'argomento del completamento.

image_uri

string

L'URI dell'immagine dell'azienda per COMPANY_NAME.

CreateClientEventRequest

La richiesta dell'evento del report.

Campi
parent

string

Obbligatorio. Nome risorsa del tenant con cui viene creato l'evento.

Il formato è "projects/{project_id}/tenants/{tenant_id}", ad esempio "projects/foo/tenant/bar". Se l'ID tenant non è specificato, viene creato un tenant predefinito, ad esempio "projects/foo".

client_event

ClientEvent

Obbligatorio. Eventi emessi quando l'utente finale interagisce con l'applicazione del cliente che utilizza Cloud Talent Solution.

CreateCompanyRequest

La richiesta del metodo CreateCompany.

Campi
parent

string

Obbligatorio. Nome risorsa del tenant con cui viene creata l'azienda.

Il formato è "projects/{project_id}/tenants/{tenant_id}", ad esempio "projects/foo/tenant/bar". Se l'ID tenant non è specificato, viene creato un tenant predefinito, ad esempio "projects/foo".

company

Company

Obbligatorio. L'azienda da creare.

CreateJobRequest

Richiesta di creazione di un job.

Campi
parent

string

Obbligatorio. Il nome della risorsa del tenant con cui viene creato il job.

Il formato è "projects/{project_id}/tenants/{tenant_id}". Ad esempio, "projects/foo/tenant/bar". Se l'ID tenant non è specificato, viene creato un tenant predefinito. Ad esempio, "projects/foo".

job

Job

Obbligatorio. Il job da creare.

CreateTenantRequest

La richiesta del metodo CreateTenant.

Campi
parent

string

Obbligatorio. Nome della risorsa del progetto in cui viene creato il tenant.

Il formato è "projects/{project_id}", ad esempio "projects/foo".

tenant

Tenant

Obbligatorio. Il tenant da creare.

CustomAttribute

Valori degli attributi personalizzati filtrabili o non filtrabili.

Campi
string_values[]

string

È necessario specificare esattamente uno tra string_values o long_values.

Questo campo viene utilizzato per eseguire una ricerca con corrispondenza stringa (CASE_SENSITIVE_MATCH o CASE_INSENSITIVE_MATCH). Per i string_value filtrabili, è consentito un numero totale massimo di 200 valori, ciascuno dei quali string_value ha una dimensione in byte non superiore a 500 miliardi. Per l'string_values non filtrabile, la dimensione massima in byte totale dell'string_values non filtrabile è 50 kB.

Non è consentita una stringa vuota.

long_values[]

int64

È necessario specificare esattamente uno tra string_values o long_values.

Questo campo viene utilizzato per eseguire la ricerca per intervallo di numeri. (EQ, GT, GE, LE, LT) oltre a long_value filtrabili.

Attualmente è supportato al massimo 1 long_values.

filterable

bool

Se il flag filterable è true, è possibile utilizzare i valori del campo personalizzato per i filtri degli attributi personalizzati JobQuery.custom_attribute_filter. Se il valore è false, questi valori non possono essere utilizzati per i filtri degli attributi personalizzati.

Il valore predefinito è false.

keyword_searchable

bool

Se il flag keyword_searchable è true, le parole chiave nei campi personalizzati sono disponibili per la ricerca in base alla corrispondenza delle parole chiave. Se il valore è false, i valori non sono disponibili per la ricerca in base alla corrispondenza delle parole chiave.

Il valore predefinito è false.

DegreeType

Titolo di studio definito nella International Standard Classification of Education (ISCED).

Enum
DEGREE_TYPE_UNSPECIFIED Valore predefinito. Non rappresenta alcun titolo di studio o istruzione della prima infanzia. Mappa al codice ISCED 0. Es) Asilo
PRIMARY_EDUCATION Istruzione primaria, che in genere costituisce la prima fase dell'istruzione dell'obbligo. Codice ISCED 1. Es) Scuola elementare
LOWER_SECONDARY_EDUCATION Istruzione secondaria inferiore; prima fase dell'istruzione secondaria che si basa sull'istruzione primaria, in genere con un programma più orientato alle materie. Codice ISCED 2. Es. scuola media
UPPER_SECONDARY_EDUCATION Istruzione media; seconda/ultima fase dell'istruzione secondaria: preparazione per l'istruzione terziaria e/o fornitura di competenze pertinenti all'occupazione. Di solito con una gamma più ampia di argomenti e stream. Codice ISCED 3. Es) Scuola superiore
ADULT_REMEDIAL_EDUCATION Istruzione di recupero per adulti; programmi che offrono esperienze di apprendimento che si basano sull'istruzione secondaria e preparano all'ingresso nel mercato del lavoro e/o all'istruzione terziaria. I contenuti sono più ampi rispetto a quelli di livello secondario, ma non sono complessi come quelli dell'istruzione terziaria. Codice ISCED 4.
ASSOCIATES_OR_EQUIVALENT Associate o equivalente: programmi terziari brevi di primo livello che sono in genere basati sulla pratica, sono specifici sul lavoro e sono preparati per l'ingresso nel mercato del lavoro. Questi programmi possono anche fornire un percorso per altri programmi terziari. Codice ISCED 5.
BACHELORS_OR_EQUIVALENT Laurea o equivalente; programmi concepiti per fornire conoscenze, abilità e competenze accademiche e/o professionali intermedie per raggiungere la laurea di primo livello o una qualifica equivalente. Codice ISCED 6.
MASTERS_OR_EQUIVALENT Master o equivalenti; programmi concepiti per fornire conoscenze, abilità e competenze accademiche e/o professionali avanzate per il conseguimento di un secondo grado di istruzione terziaria o di una qualifica equivalente. Codice ISCED 7.
DOCTORAL_OR_EQUIVALENT Dottorato o equivalente; programmi concepiti principalmente per portare a una qualifica di ricerca avanzata, che in genere si concludono con l'invio e la difesa di una tesi sostanziale di qualità pubblicabile basata su ricerche originali. Codice ISCED 8.

DeleteCompanyRequest

Richiesta di eliminazione di un'azienda.

Campi
name

string

Obbligatorio. Il nome della risorsa dell'azienda da eliminare.

Il formato è "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}", ad esempio "projects/foo/tenants/bar/businesses/baz".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito, ad esempio "projects/foo/businesses/bar".

DeleteJobRequest

Elimina richiesta di job.

Campi
name

string

Obbligatorio. Il nome della risorsa del job da eliminare.

Il formato è "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Ad esempio, "projects/foo/tenants/bar/jobs/baz".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito. Ad esempio, "projects/foo/jobs/bar".

DeleteTenantRequest

Richiedi l'eliminazione di un tenant.

Campi
name

string

Obbligatorio. Il nome della risorsa del tenant da eliminare.

Il formato è "projects/{project_id}/tenants/{tenant_id}", ad esempio "projects/foo/tenants/bar".

DeviceInfo

Informazioni sul dispositivo raccolte dalla persona alla ricerca di lavoro, dal candidato o da un'altra entità che esegue la ricerca di lavoro. Queste informazioni migliorano la qualità dei risultati di ricerca su tutti i dispositivi.

Campi
device_type

DeviceType

Tipo di dispositivo.

id

string

Un ID specifico del dispositivo. L'ID deve essere un identificatore univoco che distingue il dispositivo dagli altri dispositivi.

DeviceType

Un'enumerazione che descrive un portale di accesso all'API e un meccanismo di esposizione.

Enum
DEVICE_TYPE_UNSPECIFIED Il tipo di dispositivo non è specificato.
WEB Un browser web desktop, come Chrome, Firefox, Safari o Internet Explorer.
MOBILE_WEB Un browser web di dispositivi mobili, ad esempio uno smartphone o un tablet con browser Chrome.
ANDROID Un'applicazione nativa del dispositivo Android.
IOS Un'applicazione nativa del dispositivo iOS.
BOT Un bot, a differenza di un dispositivo gestito da esseri umani, come un web crawler.
OTHER Altri tipi di dispositivi.

EmploymentType

Un'enumerazione che rappresenta il tipo di impiego di un lavoro.

Enum
EMPLOYMENT_TYPE_UNSPECIFIED Il valore predefinito se il tipo di impiego non è specificato.
FULL_TIME Il lavoro richiede un certo numero di ore che costituiscono un impiego a tempo pieno, in genere almeno 40 ore alla settimana.
PART_TIME Il lavoro comporta meno ore di lavoro rispetto a un lavoro a tempo pieno, in genere meno di 40 ore a settimana.
CONTRACTOR Il lavoro viene offerto come posizione a contratto, anziché come dipendente retribuito.
CONTRACT_TO_HIRE Il lavoro viene offerto come posizione a contratto con la conversione in una posizione a tempo pieno alla fine del contratto. I job di questo tipo vengono restituiti anche dalla ricerca di EmploymentType.CONTRACTOR job.
TEMPORARY Il lavoro viene offerto come opportunità di impiego temporaneo, di solito a breve termine.
INTERN Il lavoro è un'opportunità a tempo determinato per studenti o persone in cerca di lavoro principianti di ottenere una formazione sul campo, generalmente offerta come posizione estiva.
VOLUNTEER Si tratta di un'opportunità per una persona di fare volontariato, senza alcuna aspettativa di compenso per i servizi forniti.
PER_DIEM Il lavoro richiede che un dipendente lavori in base alle necessità con un orario flessibile.
FLY_IN_FLY_OUT Il lavoro consiste nell'assumere persone in zone remote e trasferirle temporaneamente al luogo di lavoro, anziché trasferire definitivamente i dipendenti e le loro famiglie.
OTHER_EMPLOYMENT_TYPE Il job non rientra negli altri tipi elencati.

GetCompanyRequest

Richiesta di ottenere un'azienda per nome.

Campi
name

string

Obbligatorio. Il nome della risorsa dell'azienda da recuperare.

Il formato è "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}", ad esempio "projects/api-test-project/tenants/foo/businesses/bar".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito, ad esempio "projects/api-test-project/businesses/bar".

GetJobRequest

Ottieni richiesta di job.

Campi
name

string

Obbligatorio. Il nome della risorsa del job da recuperare.

Il formato è "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Ad esempio, "projects/foo/tenants/bar/jobs/baz".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito. Ad esempio, "projects/foo/jobs/bar".

GetTenantRequest

Richiesta di ottenere un tenant per nome.

Campi
name

string

Obbligatorio. Il nome della risorsa del tenant da recuperare.

Il formato è "projects/{project_id}/tenants/{tenant_id}", ad esempio "projects/foo/tenants/bar".

HistogramQuery

La richiesta dell'istogramma.

Campi
histogram_query

string

Un'espressione specifica una richiesta a istogramma in base alle risorse corrispondenti (ad esempio job, profili) per le ricerche.

Per informazioni dettagliate sulla sintassi, consulta SearchJobsRequest.histogram_queries e SearchProfilesRequest.histogram_queries.

HistogramQueryResult

Risultato dell'istogramma che corrisponde a HistogramQuery specificato nelle ricerche.

Campi
histogram_query

string

Espressione istogramma richiesta.

histogram

map<string, int64>

Una mappa dai valori del facet associati a valori distinti al numero di voci corrispondenti con il valore corrispondente.

Il formato della chiave è:

  • (per l'istogramma di stringhe) i valori stringa memorizzati nel campo.
  • (per il bucket numerico denominato) specificato nella funzione bucket(), come per bucket(0, MAX, "non-negative"), la chiave sarà non-negative.
  • (per il bucket numerico anonimo) formattato come <low>-<high>, ad esempio 0-1000, MIN-0 e 0-MAX.

HtmlSanitization

Opzione per la sanitizzazione dei contenuti HTML nei campi di input utente, ad esempio la descrizione del lavoro. Impostando questa opzione, l'utente può determinare se e come verrà eseguita la sanitizzazione su questi campi.

Enum
HTML_SANITIZATION_UNSPECIFIED Valore predefinito.
HTML_SANITIZATION_DISABLED Disattiva la sanitizzazione dell'input HTML.
SIMPLE_FORMATTING_ONLY Sanitizza l'input HTML, accetta solo i tag di markup in grassetto, corsivo, elenchi ordinati ed elenchi non ordinati.

Job

Una risorsa di lavoro rappresenta un'offerta di lavoro (nota anche come "elenco offerte di lavoro" o "richiesta di lavoro"). Un lavoro appartiene a Company, che è l'entità che assume responsabile del lavoro.

Campi
name

string

Obbligatorio durante l'aggiornamento del job.

Il nome della risorsa per il job. Viene generato dal servizio quando viene creato un job.

Il formato è "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Ad esempio, "projects/foo/tenants/bar/jobs/baz".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito. Ad esempio, "projects/foo/jobs/bar".

È preferibile utilizzare questo campo nelle query dei job e nelle chiamate API rispetto all'uso di requisition_id, poiché questo valore è univoco.

company

string

Obbligatorio. Il nome della risorsa dell'azienda che pubblica l'elenco del lavoro.

Il formato è "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}". Ad esempio, "projects/foo/tenants/bar/Companies/baz".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito. Ad esempio, "projects/foo/offers/bar".

requisition_id

string

Obbligatorio. L'ID richiesta, chiamato anche ID pubblicazione, viene assegnato dal cliente per identificare un lavoro. Questo campo è destinato ai clienti per l'identificazione e il monitoraggio delle pubblicazioni. Non è possibile creare un job se esiste un altro job con gli stessi company, language_code e requisition_id.

Il numero massimo di caratteri consentiti è 255.

title

string

Obbligatorio. Il titolo del lavoro, ad esempio "Ingegnere informatico"

Il numero massimo di caratteri consentiti è 500.

description

string

Obbligatorio. La descrizione del lavoro, che in genere include una descrizione in più paragrafi dell'azienda e delle informazioni correlate. Nell'oggetto job vengono forniti campi separati per responsibilities, qualifications e altre caratteristiche del job. Si consiglia di utilizzare questi campi separati del job.

Questo campo accetta e sanitizza l'input HTML e accetta anche grassetto, corsivo, tag di elenchi ordinati ed elenchi non ordinati.

Il numero massimo di caratteri consentiti è 100.000.

addresses[]

string

Fortemente consigliato per un'esperienza di servizio ottimale.

Località in cui il datore di lavoro vuole assumere per questa offerta di lavoro.

La specifica degli indirizzi completi della sede di assunzione consente di ottenere risultati API migliori, in particolare le ricerche di lavoro in base ai tempi di percorrenza del tragitto giornaliero.

Per ottenere il miglior rendimento possibile sulla rete di ricerca, sono consentite al massimo 50 località. Se un job ha più località, si consiglia di suddividerlo in più job con requisition_id univoci (ad es. "ReqA" diventa "ReqA-1", "ReqA-2" e così via), poiché non sono consentiti più job con lo stesso company, language_code e requisition_id. Se è necessario conservare il valore originale requisition_id, è necessario utilizzare un campo personalizzato per l'archiviazione. Viene inoltre suggerito di raggruppare le sedi che si trovano più vicine tra loro nello stesso lavoro per migliorare l'esperienza di ricerca.

Il numero massimo di caratteri consentiti è 500.

application_info

ApplicationInfo

Informazioni sulla candidatura.

job_benefits[]

JobBenefit

I vantaggi inclusi nel lavoro.

compensation_info

CompensationInfo

Informazioni sulla retribuzione del lavoro (chiamato anche "tasso di retribuzione"), ovvero il compenso che verrà corrisposto al dipendente.

custom_attributes

map<string, CustomAttribute>

Una mappa di campi in cui inserire attributi di offerte di lavoro personalizzate filtrabili e non filtrabili che non sono coperti dai campi strutturati forniti.

Le chiavi della mappa sono stringhe con una dimensione massima di 64 byte e devono corrispondere al pattern: [a-zA-Z][a-zA-Z0-9_]*. Ad esempio key0likeThis o KEY_1_LIKE_THIS.

Sono supportate al massimo 100 chiavi filtrabili e al massimo 100 non filtrate. Per l'oggetto string_values filtrabile, in tutte le chiavi sono consentiti al massimo 200 valori e ogni stringa non può contenere più di 255 caratteri. Per l'opzione string_values non filtrabile, la dimensione totale massima di string_values in tutte le chiavi è 50 kB.

degree_types[]

DegreeType

I titoli di studio desiderati per il lavoro, ad esempio Lauree o Master.

department

string

Il reparto o l'area funzionale all'interno dell'azienda con la posizione aperta.

Il numero massimo di caratteri consentiti è 255.

employment_types[]

EmploymentType

I tipi di impiego di un lavoro, ad esempio full time o part time.

incentives

string

Una descrizione di bonus, commissioni e altri incentivi retributivi associati al lavoro senza includere lo stipendio o la retribuzione.

Il numero massimo di caratteri consentiti è 10.000.

language_code

string

La lingua in cui è pubblicato il post. Questo campo è diverso da tutti i requisiti di fluidità associati al job.

I codici lingua devono essere nel formato BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta la sezione Tag per l'identificazione delle lingue{: class="external" target="_blank" }.

Se questo campo non viene specificato e è presente Job.description, viene assegnato il codice lingua rilevato in base a Job.description, altrimenti il valore predefinito è "en_US".

job_level

JobLevel

Il livello di esperienza associato al lavoro, ad esempio "Livello base".

promotion_value

int32

Un valore promozionale del lavoro, come determinato dal cliente. Il valore determina l'ordinamento delle offerte di lavoro restituite durante la ricerca di offerte di lavoro utilizzando la chiamata di ricerca di offerte di lavoro in primo piano, con i valori promozionali più elevati restituiti per primi e i legami risolti dall'ordinamento di pertinenza. Vengono restituiti solo i job con promotionValue > 0 in FEATURED_JOB_SEARCH.

Il valore predefinito è 0 e i valori negativi vengono trattati come 0.

qualifications

string

Una descrizione delle qualifiche richieste per svolgere il lavoro. Si consiglia di utilizzare questo campo in alternativa al campo description più generale.

Questo campo accetta e sanitizza l'input HTML e accetta anche grassetto, corsivo, tag di elenchi ordinati ed elenchi non ordinati.

Il numero massimo di caratteri consentiti è 10.000.

responsibilities

string

Una descrizione delle responsabilità lavorative. Si consiglia di utilizzare questo campo in alternativa al campo description più generale.

Questo campo accetta e sanitizza l'input HTML e accetta anche grassetto, corsivo, tag di elenchi ordinati ed elenchi non ordinati.

Il numero massimo di caratteri consentiti è 10.000.

posting_region

PostingRegion

Il lavoro PostingRegion (ad esempio stato, paese) per cui è disponibile il lavoro. Se questo campo viene impostato, un LocationFilter in una query di ricerca all'interno della regione dell'offerta di lavoro trova questa offerta di lavoro se non viene specificata una corrispondenza esatta della località. Se questo campo viene impostato su PostingRegion.NATION o PostingRegion.ADMINISTRATIVE_AREA, ti consigliamo vivamente di impostare il job Job.addresses allo stesso livello di località di questo campo.

visibility
(deprecated)

Visibility

Ritirato. Il job è visibile solo al proprietario.

La visibilità del job.

Se non specificato, il valore predefinito è Visibility.ACCOUNT_ONLY.

job_start_time

Timestamp

Il timestamp di inizio del job espresso nel fuso orario UTC. In genere questo campo viene utilizzato per la stipula di contratti. I timestamp non validi vengono ignorati.

job_end_time

Timestamp

Il timestamp di fine del job. In genere questo campo viene utilizzato per la stipula di contratti. I timestamp non validi vengono ignorati.

posting_publish_time

Timestamp

Il timestamp dell'ultima pubblicazione di questa offerta di lavoro. Il valore predefinito è l'ora in cui la richiesta arriva al server. I timestamp non validi vengono ignorati.

posting_expire_time

Timestamp

Fortemente consigliato per un'esperienza di servizio ottimale.

Il timestamp di scadenza del job. Dopo questo timestamp, il job viene contrassegnato come scaduto e non viene più visualizzato nei risultati di ricerca. Il job scaduto non può essere elencato dall'API ListJobs, ma può essere recuperato con l'API GetJob o aggiornato con l'API UpdateJob oppure eliminato con l'API DeleteJob. Un job scaduto può essere aggiornato e aperto di nuovo utilizzando un timestamp di scadenza futuro. L'aggiornamento di un job scaduto non va a buon fine se è già presente un altro job aperto con gli stessi company, language_code e requisition_id.

Le offerte scadute vengono conservate nel nostro sistema per 90 giorni. Tuttavia, il numero complessivo di lavori scaduti non può superare il triplo del numero massimo di lavori aperti nei sette giorni precedenti. Se questa soglia viene superata, i job scaduti vengono eliminati in ordine di scadenza. I job scaduti non sono più accessibili dopo l'eliminazione dei dati.

I timestamp non validi vengono ignorati e trattati come scadenza non specificata.

Se il timestamp precede la richiesta istantanea, il job viene considerato come scaduto immediatamente al momento della creazione. Impossibile aggiornare questo tipo di lavoro. Inoltre, quando crei un job con timestamp passato, posting_publish_time deve essere impostato prima del giorno posting_expire_time. Lo scopo di questa funzionalità è consentire ad altri oggetti, come Application, di fare riferimento a un job che non esisteva nel sistema prima della scadenza. Se vuoi modificare un job scaduto al momento della creazione, eliminalo e creane uno nuovo.

Se questo valore non viene fornito al momento della creazione del lavoro o non è valido, l'offerta scade dopo 30 giorni dalla data di creazione del lavoro. Ad esempio, se il job è stato creato l'1/01/2017 alle ore 13:00 UTC con una data di scadenza non specificata, scade dopo il 31/01/2017 alle ore 13:00 UTC.

Se questo valore non viene fornito al momento dell'aggiornamento del job, dipende dalle maschere di campo impostate da UpdateJobRequest.update_mask. Se le maschere del campo includono job_end_time o se le maschere sono vuote, il che significa che ogni campo viene aggiornato, l'offerta di lavoro scade dopo 30 giorni dall'ora dell'ultimo aggiornamento del lavoro. In caso contrario, la data di scadenza non viene aggiornata.

posting_create_time

Timestamp

Solo output. Il timestamp di creazione dell'offerta di lavoro.

posting_update_time

Timestamp

Solo output. Il timestamp dell'ultimo aggiornamento di questa offerta di lavoro.

company_display_name

string

Solo output. Nome visualizzato dell'azienda che pubblica l'elenco del lavoro.

derived_info

DerivedInfo

Solo output. Dettagli derivati sull'offerta di lavoro.

processing_options

ProcessingOptions

Opzioni per l'elaborazione del job.

ApplicationInfo

Dettagli relativi alla candidatura di un'offerta di lavoro.

Campi
emails[]

string

Utilizza questo campo per specificare gli indirizzi email a cui è possibile inviare i curricula o le applicazioni.

Il numero massimo di caratteri consentiti per ogni voce è 255.

instruction

string

Utilizza questo campo per fornire istruzioni, ad esempio "Invia la tua candidatura a ...", che un candidato può seguire per candidarsi per la posizione.

Questo campo accetta e sanitizza l'input HTML e accetta anche grassetto, corsivo, tag di elenchi ordinati ed elenchi non ordinati.

Il numero massimo di caratteri consentiti è 3.000.

uris[]

string

Utilizza questo campo URI per indirizzare il richiedente a un sito web, ad esempio per inserire un link a un modulo di richiesta online.

Il numero massimo di caratteri consentiti per ogni voce è 2000.

DerivedInfo

Dettagli derivati sull'offerta di lavoro.

Campi
locations[]

Location

Posizioni strutturate del lavoro, risolte da Job.addresses.

locations corrispondono esattamente a Job.addresses nello stesso ordine.

job_categories[]

JobCategory

Categorie di lavoro derivate da Job.title e Job.description.

ProcessingOptions

Opzioni per l'elaborazione del job.

Campi
disable_street_address_resolution

bool

Se viene impostato su true, il servizio non tenta di risolvere un indirizzo più preciso per il job.

html_sanitization

HtmlSanitization

Opzione per la sanitizzazione dei contenuti HTML del lavoro. I campi applicati sono:

  • description
  • applicationInfo.instruction
  • incentivi
  • qualifiche
  • responsabilità

I tag HTML in questi campi potrebbero essere rimossi se la sanitizzazione non è disattivata.

Il valore predefinito è HtmlSanitization.SIMPLE_FORMATTING_ONLY.

JobBenefit

Un'enumerazione che rappresenta i vantaggi per i dipendenti inclusi nel lavoro.

Enum
JOB_BENEFIT_UNSPECIFIED Valore predefinito se il tipo non è specificato.
CHILD_CARE Il lavoro include l'accesso a programmi di assistenza all'infanzia, come l'asilo nido.
DENTAL Il lavoro include servizi odontoiatrici coperti da un piano di assicurazione dentistica.
DOMESTIC_PARTNER Il lavoro offre vantaggi specifici ai partner domestici.
FLEXIBLE_HOURS Il lavoro consente un programma di lavoro flessibile.
MEDICAL Questo lavoro include servizi sanitari coperti da un piano di assicurazione medica.
LIFE_INSURANCE Il lavoro include un piano di assicurazione sulla vita fornito dal datore di lavoro o disponibile per l'acquisto da parte del dipendente.
PARENTAL_LEAVE Il lavoro prevede un congedo per assenze di un genitore per prendersi cura di un neonato.
RETIREMENT_PLAN Il lavoro include un piano di pensionamento sul posto di lavoro fornito dal datore di lavoro o disponibile per l'acquisto da parte del dipendente.
SICK_DAYS Il lavoro prevede permessi retribuiti per malattia.
VACATION Il lavoro include permessi retribuiti per le ferie.
VISION Il lavoro include servizi di visione artificiale coperti da un piano assicurativo per la visione artificiale.

JobCategory

Un'enumerazione che rappresenta la categorizzazione o l'obiettivo principale di un ruolo specifico. Questo valore è diverso dal "settore" associato a un ruolo, correlato alla classificazione dell'azienda che elenca il lavoro.

Enum
JOB_CATEGORY_UNSPECIFIED Il valore predefinito se la categoria non è specificata.
ACCOUNTING_AND_FINANCE Un'offerta di lavoro nel settore contabile e finanziario, ad esempio un commercialista.
ADMINISTRATIVE_AND_OFFICE Un lavoro d'ufficio e amministrativo, ad esempio un assistente amministrativo.
ADVERTISING_AND_MARKETING Un'offerta di lavoro nel settore pubblicitario e marketing, ad esempio il responsabile del marketing.
ANIMAL_CARE Un lavoro nella cura degli animali, ad esempio veterinario.
ART_FASHION_AND_DESIGN Un lavoro nel campo dell'arte, della moda o del design, ad esempio il designer.
BUSINESS_OPERATIONS Un lavoro in questo ambito, ad esempio Business Operations Manager.
CLEANING_AND_FACILITIES Un lavoro nelle pulizie e nelle strutture, ad esempio Responsabile del personale.
COMPUTER_AND_IT Un lavoro informatico e IT, ad esempio Amministratore di sistema.
CONSTRUCTION Un lavoro edile, ad esempio Generale Operaio.
CUSTOMER_SERVICE Un lavoro nell'assistenza clienti, come è cassiere.
EDUCATION Un lavoro nel campo dell'istruzione, ad esempio Insegnante scolastico.
ENTERTAINMENT_AND_TRAVEL Un lavoro nel settore dell'intrattenimento e dei viaggi, ad esempio assistente di volo.
FARMING_AND_OUTDOORS Un lavoro nell'agricoltura o all'aperto, come ad esempio il Park Ranger.
HEALTHCARE Un'offerta di lavoro nel settore sanitario, ad esempio Infermiere registrato.
HUMAN_RESOURCES Un lavoro delle risorse umane, ad esempio il direttore delle risorse umane.
INSTALLATION_MAINTENANCE_AND_REPAIR Un lavoro di installazione, manutenzione o riparazione, ad esempio un elettricista.
LEGAL Un lavoro legale, ad esempio Impiegato legale.
MANAGEMENT Un job di gestione, spesso utilizzato insieme a un'altra categoria, come Store Manager.
MANUFACTURING_AND_WAREHOUSE Un lavoro nel settore manifatturiero o di magazzino, ad esempio un tecnico dell'assemblaggio.
MEDIA_COMMUNICATIONS_AND_WRITING Un lavoro nei media, nella comunicazione o nella scrittura, ad esempio nei rapporti con i media.
OIL_GAS_AND_MINING Un lavoro nel settore petrolifero, del gas o dell'estrazione mineraria, ad esempio trivellatore offshore.
PERSONAL_CARE_AND_SERVICES Un lavoro nella cura della persona e nei servizi, ad esempio parrucchiere.
PROTECTIVE_SERVICES Un job di servizi di protezione, ad esempio Security Guard.
REAL_ESTATE Un lavoro nel settore immobiliare, ad esempio Agente acquirente.
RESTAURANT_AND_HOSPITALITY Un lavoro nel settore della ristorazione e alberghiero, ad esempio il server di un ristorante.
SALES_AND_RETAIL Un'offerta di lavoro nel settore vendite e/o vendita al dettaglio, ad esempio un addetto alle vendite.
SCIENCE_AND_ENGINEERING Un lavoro nel campo della scienza e dell'ingegneria, come nel caso di un tecnico di laboratorio.
SOCIAL_SERVICES_AND_NON_PROFIT Un'offerta di lavoro non profit o di servizi sociali, ad esempio Case Worker.
SPORTS_FITNESS_AND_RECREATION Un lavoro in ambito sportivo, fitness o ricreativo, ad esempio un personal trainer.
TRANSPORTATION_AND_LOGISTICS Un lavoro nel settore dei trasporti o della logistica, ad esempio "autista di camion".

JobEvent

Un evento emesso quando una persona in cerca di lavoro interagisce con l'applicazione che implementa Cloud Talent Solution.

Campi
type

JobEventType

Obbligatorio. Il tipo di evento (vedi JobEventType).

jobs[]

string

Obbligatorio. job name(s) associato a questo evento. Ad esempio, se si tratta di un evento impression, questo campo contiene gli identificatori di tutti i job mostrati a chi cerca il lavoro. Se si tratta di un evento view, questo campo contiene l'identificatore del job visualizzato.

Il formato è "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", ad esempio "projects/foo/tenants/bar/jobs/baz".

profile

string

profile name associato a questo evento client.

Il formato è "projects/{project_id}/tenants/{tenant_id}/profile/{profile_id}", ad esempio "projects/foo/tenants/bar/profile/baz".

JobEventType

L'enumerazione di un evento attribuito al comportamento dell'utente finale, ad esempio una persona in cerca di lavoro.

Enum
JOB_EVENT_TYPE_UNSPECIFIED L'evento non è specificato da altri valori forniti.
IMPRESSION La persona in cerca di lavoro o altra entità che interagisce con il servizio è stata visualizzata nella sua visualizzazione, ad esempio in un elenco di risultati di ricerca in formato compresso o ritagliato. Questo evento è generalmente associato alla visualizzazione di un elenco di lavori su una singola pagina da parte di chi cerca un impiego.
VIEW La persona in cerca di lavoro, o altra entità che interagisce con il servizio, ha visualizzato i dettagli del lavoro, inclusa la descrizione completa. Questo evento non si applica alla visualizzazione di uno snippet di un'offerta di lavoro che appare nei risultati di ricerca delle offerte di lavoro. La visualizzazione di uno snippet è associata a un impression).
VIEW_REDIRECT La persona in cerca di lavoro o un'altra entità che interagisce con il servizio ha eseguito un'azione per visualizzare un lavoro ed è stata reindirizzata a un altro sito web.
APPLICATION_START La persona in cerca di lavoro o altra persona giuridica che interagisce con il servizio ha avviato il processo o ha dimostrato l'intenzione di candidarsi per un lavoro.
APPLICATION_FINISH La persona in cerca di lavoro o altra entità che interagisce con il servizio ha presentato una domanda per un lavoro.
APPLICATION_QUICK_SUBMISSION La persona in cerca di lavoro o altra entità che interagisce con il servizio ha inviato una richiesta per un lavoro con un solo clic senza inserire informazioni. Se chi cerca lavoro esegue questa azione, invia solo questo evento al servizio. Non inviare anche eventi JobEventType.APPLICATION_START o JobEventType.APPLICATION_FINISH.
APPLICATION_REDIRECT La persona in cerca di lavoro o altra persona giuridica che interagisce con il servizio ha eseguito un'azione per presentare domanda di lavoro ed è stata reindirizzata a un altro sito web per completare la richiesta.
APPLICATION_COMPANY_SUBMIT Questo evento deve essere utilizzato quando un'azienda invia una candidatura per conto di chi cerca un impiego. Questo evento è destinato alle agenzie di collocamento che cercano di inserire candidati.
BOOKMARK La persona in cerca di lavoro o altra entità che interagisce con il servizio ha dimostrato interesse per un lavoro aggiungendolo ai preferiti o salvandolo.
NOTIFICATION Alla persona in cerca di lavoro o altra entità che interagisce con il servizio è stata inviata una notifica, ad esempio un avviso via email o un avviso sul dispositivo, contenente uno o più annunci di lavoro generati dal servizio.
HIRED La persona in cerca di lavoro o altra persona giuridica che interagisce con il servizio è stata assunta dall'entità che assume (datore di lavoro). Invia questo evento solo se la persona in cerca di lavoro è stata assunta tramite un'applicazione avviata da una ricerca condotta tramite il servizio Cloud Talent Solution.
SENT_CV Un reclutatore o un'agenzia di collocamento ha presentato una domanda per conto del candidato dopo aver interagito con il servizio per identificare un'offerta di lavoro adeguata.
INTERVIEW_GRANTED All'entità che interagisce con il servizio (ad esempio la persona in cerca di lavoro) è stato concesso un colloquio iniziale da parte dell'entità che assume (datore di lavoro). Questo evento deve essere inviato solo se alla persona in cerca di lavoro è stato concesso un colloquio nell'ambito di una candidatura avviata tramite una ricerca condotta tramite un suggerimento fornito dal servizio Cloud Talent Solution.

JobLevel

Un'enumerazione che rappresenta il livello di esperienza richiesto per il job.

Enum
JOB_LEVEL_UNSPECIFIED Il valore predefinito se il livello non è specificato.
ENTRY_LEVEL Collaboratori individuali di livello base, in genere con meno di 2 anni di esperienza in un ruolo simile. Include gli stagisti.
EXPERIENCED Collaboratori singoli esperti, in genere con più di 2 anni di esperienza nello stesso ruolo.
MANAGER Manager di livello base o di livello medio responsabile della gestione di un team di persone.
DIRECTOR Dirigenti di livello superiore responsabili della gestione dei team di manager.
EXECUTIVE Dirigenti di livello esecutivo e superiori, inclusi ruoli di alto livello.

JobOperationResult

Il risultato delle API JobService.BatchCreateJobs o JobService.BatchUpdateJobs. Viene utilizzato per sostituire google.longrunning.Operation.response in caso di esito positivo.

Campi
job_results[]

JobResult

Elenco dei risultati di mutazione del job da un'operazione di modifica in batch. Può cambiare fino a quando lo stato dell'operazione non risulta FINISHED, FAILED o CANCELLED.

JobResult

Risultato della mutazione di un job.

Campi
job

Job

Qui Job contiene solo informazioni di base tra cui name, company, language_code e requisition_id; utilizza il metodo getJob per recuperare informazioni dettagliate sul job creato/aggiornato.

status

Status

Lo stato del job elaborato. Questo campo viene compilato se l'elaborazione del job non va a buon fine.

JobQuery

La query necessaria per eseguire una query di ricerca.

Campi
query

string

La stringa di query che corrisponde ai campi relativi a qualifica, descrizione e località.

Il numero massimo di caratteri consentiti è 255.

query_language_code

string

Il codice lingua di query. Ad esempio, "it-IT". Questo campo consente di interpretare meglio la query.

Se non viene specificato un valore, il codice lingua della query viene rilevato automaticamente, che potrebbe non essere preciso.

Il codice lingua deve essere in formato BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta la sezione Tag per l'identificazione delle lingue.

companies[]

string

Questo filtro specifica le entità aziendali in base a cui eseguire la ricerca.

Se non viene specificato un valore, vengono cercate offerte di lavoro in base a tutte le aziende.

Se vengono specificati più valori, viene eseguita la ricerca dei job in base alle aziende specificate.

Il formato è "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}". Ad esempio, "projects/foo/tenants/bar/Companies/baz".

Se l'ID tenant non è specificato, viene utilizzato il tenant predefinito. Ad esempio, "projects/foo/offers/bar".

Sono consentiti al massimo 20 filtri aziendali.

location_filters[]

LocationFilter

Il filtro della località specifica le aree geografiche contenenti i job in base a cui eseguire la ricerca. Consulta la pagina LocationFilter per saperne di più.

Se non viene specificato un valore per la località, le offerte che soddisfano gli altri criteri di ricerca vengono recuperate indipendentemente da dove si trovano.

Se vengono specificati più valori, i job vengono recuperati da una qualsiasi delle località specificate. Se vengono specificati valori diversi per il parametro LocationFilter.distance_in_miles, viene utilizzata la distanza massima fornita per tutte le località.

Sono consentiti al massimo 5 filtri di località.

job_categories[]

JobCategory

Il filtro per categoria specifica le categorie di job in base a cui eseguire la ricerca. Consulta la pagina JobCategory per saperne di più.

Se non viene specificato un valore, vengono cercati i lavori di qualsiasi categoria.

Se vengono specificati più valori, la ricerca viene eseguita in base ai job di una qualsiasi delle categorie specificate.

commute_filter

CommuteFilter

Consente di filtrare i lavori in base al tempo di percorrenza del tragitto giornaliero con metodi di viaggio diversi (ad esempio in auto o con il trasporto pubblico).

Nota: funziona solo se specifichi un CommuteMethod. In questo caso, location_filters viene ignorato.

Al momento non supportiamo l'ordinamento in base alla durata del tragitto giornaliero.

company_display_names[]

string

Questo filtro specifica l'azienda esatta Company.display_name dei job in base a cui eseguire la ricerca.

Se non viene specificato un valore, le offerte di lavoro visualizzate nei risultati di ricerca sono associate a qualsiasi azienda.

Se vengono specificati più valori, le offerte di lavoro all'interno dei risultati di ricerca potrebbero essere associate a una qualsiasi delle aziende specificate.

Sono consentiti al massimo 20 filtri per il nome visualizzato dell'azienda.

compensation_filter

CompensationFilter

Questo filtro di ricerca è applicato solo a Job.compensation_info. Ad esempio, se il filtro è specificato come "Lavoro orario con compensazione per ora > 15 $", vengono cercate solo le offerte che soddisfano questi criteri. Se non viene definito un filtro, la ricerca viene eseguita in tutti i job aperti.

custom_attribute_filter

string

Questo filtro specifica una sintassi strutturata per creare una corrispondenza con il Job.custom_attributes contrassegnato come filterable.

La sintassi di questa espressione è un sottoinsieme della sintassi SQL.

Gli operatori supportati sono: =, !=, <, <=, > e >=, dove la sinistra dell'operatore è una chiave di campo personalizzato e la destra dell'operatore è un numero o una stringa tra virgolette. Devi eseguire l'escape dei caratteri della barra rovesciata (\) e delle virgolette (").

Le funzioni supportate sono LOWER([field_name]) per eseguire una corrispondenza senza distinzione tra maiuscole e minuscole e EMPTY([field_name]) per filtrare in base all'esistenza di una chiave.

Le espressioni booleane (AND/OR/NOT) sono supportate fino a 3 livelli di nidificazione (per esempio "((A AND B AND C) OR NOT D) AND E"), nell'espressione sono consentiti massimo 100 confronti o funzioni. L'espressione deve avere una lunghezza inferiore a 6000 byte.

Esempio di query: (LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10

disable_spell_check

bool

Questo flag consente di controllare la funzionalità di controllo ortografico. Se il valore è false, il servizio tenta di correggere una query con errori ortografici, ad esempio "enginee" viene corretto in "engineer".

Il valore predefinito è false: viene eseguito un controllo ortografico.

employment_types[]

EmploymentType

Il filtro per tipo di impiego specifica il tipo di impiego delle offerte di lavoro in base a cui eseguire la ricerca, ad esempio EmploymentType.FULL_TIME.

Se non viene specificato un valore, le offerte di lavoro nei risultati di ricerca includono qualsiasi tipo di impiego.

Se vengono specificati più valori, le offerte di lavoro nei risultati di ricerca includeranno uno qualsiasi dei tipi di impiego specificati.

language_codes[]

string

Questo filtro specifica le impostazioni internazionali dei job in base a cui eseguire la ricerca, ad esempio "en-US".

Se non viene specificato un valore, i risultati di ricerca possono contenere job in qualsiasi lingua.

I codici lingua devono essere nel formato BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta la sezione Tag per l'identificazione delle lingue.

Sono consentiti al massimo 10 filtri per i codici lingua.

publish_time_range

TimestampRange

La ricerca viene eseguita in base ai job pubblicati in un intervallo specificato da questo filtro.

excluded_jobs[]

string

Questo filtro specifica un elenco di nomi di job da escludere durante la ricerca.

Sono consentiti al massimo 400 nomi di job esclusi.

JobView

Un'enumerazione che specifica gli attributi del job restituiti nei campi MatchingJob.job o ListJobsResponse.jobs.

Enum
JOB_VIEW_UNSPECIFIED Valore predefinito.
JOB_VIEW_ID_ONLY Una visualizzazione del job solo con ID, con i seguenti attributi: Job.name, Job.requisition_id, Job.language_code.
JOB_VIEW_MINIMAL Una vista minima del job, con i seguenti attributi: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations, Job.language_code.
JOB_VIEW_SMALL Una piccola visualizzazione del job, con i seguenti attributi nei risultati di ricerca: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations, Job.visibility, Job.language_code, Job.description.
JOB_VIEW_FULL Tutti gli attributi disponibili sono inclusi nei risultati di ricerca.

ListCompaniesRequest

Elenca le società per cui il cliente ha visibilità sull'ACL.

Campi
parent

string

Obbligatorio. Nome risorsa del tenant con cui viene creata l'azienda.

Il formato è "projects/{project_id}/tenants/{tenant_id}", ad esempio "projects/foo/tenant/bar".

Se l'ID tenant non è specificato, verrà utilizzato il tenant predefinito, ad esempio "projects/foo".

page_token

string

L'indicatore iniziale da cui restituire i risultati.

page_size

int32

Il numero massimo di aziende da restituire, al massimo 100. Il valore predefinito è 100 se viene fornito un numero non positivo.

require_open_jobs

bool

Imposta il valore su true se le aziende richieste devono avere offerte di lavoro aperte.

Il valore predefinito è false.

Se il valore è true, viene recuperato al massimo page_size delle aziende, tra cui vengono restituite solo quelle con offerte di lavoro aperte.

ListCompaniesResponse

Oggetto risposta Elenco aziende.

Campi
companies[]

Company

Aziende del cliente corrente.

next_page_token

string

Un token per recuperare la pagina dei risultati successiva.

metadata

ResponseMetadata

Informazioni aggiuntive per la chiamata all'API, ad esempio l'ID monitoraggio della richiesta.

ListJobsRequest

Richiesta di elenco di job.

Campi
parent

string

Obbligatorio. Il nome della risorsa del tenant con cui viene creato il job.

Il formato è "projects/{project_id}/tenants/{tenant_id}". Ad esempio, "projects/foo/tenant/bar". Se l'ID tenant non è specificato, viene creato un tenant predefinito. Ad esempio, "projects/foo".

filter

string

Obbligatorio. La stringa di filtro specifica i job da enumerare.

Operatore supportato: =, AND

I campi idonei per il filtro sono:

  • companyName (obbligatorio)
  • requisitionId
  • status Valori disponibili: OPEN, EXPIRED, ALL. Se non viene specificato alcun valore, il valore predefinito è OPEN.

Esempio di query:

  • companyName = "projects/foo/tenants/bar/Companies/baz"
  • companyName = "projects/foo/tenants/bar/businesses/baz" AND requisitionId = "req-1"
  • companyName = "projects/foo/tenants/bar/supportate/baz" AND stato = "SCADUTO"
page_token

string

Il punto iniziale del risultato di una query.

page_size

int32

Il numero massimo di job da restituire per pagina di risultati.

Se il criterio job_view è impostato su JobView.JOB_VIEW_ID_ONLY, la dimensione massima consentita per la pagina è 1000. In caso contrario, le dimensioni massime consentite per le pagine sono 100.

Il valore predefinito è 100 se il campo è vuoto o se è specificato un numero inferiore a 1.

job_view

JobView

Gli attributi del job desiderati restituiti per i job nella risposta della ricerca. Se non viene specificato alcun valore, il valore predefinito è JobView.JOB_VIEW_FULL.

ListJobsResponse

Risposta dell'elenco dei job.

Campi
jobs[]

Job

Le offerte di lavoro per una determinata azienda.

Il numero massimo di articoli restituiti si basa sul campo limite specificato nella richiesta.

next_page_token

string

Un token per recuperare la pagina dei risultati successiva.

metadata

ResponseMetadata

Informazioni aggiuntive per la chiamata all'API, ad esempio l'ID monitoraggio della richiesta.

ListTenantsRequest

Elenca i tenant per i quali il client ha visibilità sull'ACL.

Campi
parent

string

Obbligatorio. Nome della risorsa del progetto in cui viene creato il tenant.

Il formato è "projects/{project_id}", ad esempio "projects/foo".

page_token

string

L'indicatore iniziale da cui restituire i risultati.

page_size

int32

Il numero massimo di tenant da restituire, al massimo 100. Il valore predefinito è 100 se viene fornito un numero non positivo.

ListTenantsResponse

L'oggetto di risposta List tenants.

Campi
tenants[]

Tenant

Inquilini per il cliente attuale.

next_page_token

string

Un token per recuperare la pagina dei risultati successiva.

metadata

ResponseMetadata

Informazioni aggiuntive per la chiamata all'API, ad esempio l'ID monitoraggio della richiesta.

Località

Una risorsa che rappresenta una località con informazioni geografiche complete.

Campi
location_type

LocationType

Il tipo di località, che corrisponde al campo delle righe dell'indirizzo di google.type.PostalAddress. Ad esempio, "Centro, Atlanta, GA, Stati Uniti" ha un tipo di LocationType.NEIGHBORHOOD, mentre "Kansas City, KS, USA" ha un tipo di LocationType.LOCALITY.

postal_address

PostalAddress

Indirizzo postale della località che include informazioni leggibili, come gli indirizzi di consegna postale e per i pagamenti. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a una sede, una casella postale o un'altra località di consegna.

lat_lng

LatLng

Un oggetto che rappresenta una coppia latitudine/longitudine.

radius_miles

double

Raggio in miglia dalla località del lavoro. Questo valore deriva dal riquadro di delimitazione della località in cui un cerchio con il raggio specificato centrato a partire da google.type.LatLng copre l'area associata alla località del lavoro. Ad esempio, attualmente "Mountain View, CA, USA" ha un raggio di 6, 17 miglia.

LocationType

Un'enumerazione che rappresenta il tipo di località.

Enum
LOCATION_TYPE_UNSPECIFIED Valore predefinito se il tipo non è specificato.
COUNTRY Una località a livello di paese.
ADMINISTRATIVE_AREA Una località di livello statale o equivalente.
SUB_ADMINISTRATIVE_AREA Una località di contea o di livello equivalente.
LOCALITY Una città o una località di livello equivalente.
POSTAL_CODE Una località a livello di codice postale.
SUB_LOCALITY Una circoscrizione è una suddivisione di una località, ad esempio un quartiere, un distretto o un arrondissement. I quartieri sono in genere riconosciuti da un'autorità politica locale. Ad esempio, Manhattan e Brooklyn sono riconosciuti come quartieri dalla città di New York e, di conseguenza, sono modellati come quartieri.
SUB_LOCALITY_1 Un distretto o una località di livello equivalente.
SUB_LOCALITY_2 Un distretto più piccolo o una visualizzazione di livello equivalente.
NEIGHBORHOOD Una località a livello di quartiere.
STREET_ADDRESS Una località a livello di indirizzo.

LocationFilter

Regione geografica della ricerca.

Campi
address

string

Il nome dell'indirizzo, ad esempio "Mountain View" o "Bay Area".

region_code

string

Codice regione CLDR del paese o della regione dell'indirizzo. Questo viene utilizzato per risolvere l'ambiguità della località inserita dall'utente, ad esempio "Liverpool" rispetto a "Liverpool, NY, US" o "Liverpool, Regno Unito".

Imposta questo campo per polarizzare la risoluzione della località verso un paese o un territorio specifico. Se questo campo non viene configurato, per impostazione predefinita il comportamento dell'applicazione è influenzato dagli Stati Uniti.

Per maggiori dettagli, visita la pagina https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera. Tieni presente che questo filtro non è applicabile alle query correlate a Ricerca profilo.

lat_lng

LatLng

La latitudine e la longitudine del centro geografico da cui eseguire la ricerca. Questo campo viene ignorato se viene specificato address.

distance_in_miles

double

La distanza in miglia viene applicata quando la località cercata è identificata come città o più piccola. Questo campo viene ignorato se la località cercata è uno stato o superiore.

telecommute_preference

TelecommutePreference

Consente al cliente di restituire lavori senza una posizione impostata, in particolare lavori relativi al telelavoro (il telelavoro è considerato dal servizio come un luogo speciale. Job.posting_region indica se un lavoro consente il lavoro da remoto. Se questo campo viene impostato su TelecommutePreference.TELECOMMUTE_ALLOWED, viene eseguita la ricerca dei job di telelavoro, mentre i job address e lat_lng vengono ignorati. Se non viene configurato o se viene impostato su TelecommutePreference.TELECOMMUTE_EXCLUDED, il job di telelavoro non viene cercato.

Questo filtro può essere utilizzato da solo per cercare esclusivamente offerte di lavoro da remoto oppure può essere combinato con un altro filtro di località per cercare una combinazione di località di lavoro, ad esempio offerte di lavoro "Mountain View" o "telelavoro". Tuttavia, se utilizzati in combinazione con altri filtri di località, i lavori relativi al telelavoro possono essere trattati come meno pertinenti di altri lavori nella risposta della ricerca.

Questo campo viene utilizzato solo per le richieste di ricerca job.

negated

bool

Indica se applicare la negazione al filtro in modo da escludere i profili che corrispondono al filtro.

Attualmente supportata solo nella ricerca del profilo.

TelecommutePreference

Specifica se includere job di telelavoro.

Enum
TELECOMMUTE_PREFERENCE_UNSPECIFIED Valore predefinito se la preferenza di telelavoro non è specificata.
TELECOMMUTE_EXCLUDED Escludi i job di telelavoro.
TELECOMMUTE_ALLOWED Consenti job di telelavoro.

PostingRegion

Un'enumerazione che rappresenta la regione dell'offerta di lavoro. Nella maggior parte dei casi, per le offerte di lavoro non è necessario specificare una regione. Se viene indicata una regione, le offerte di lavoro sono idonee per le ricerche nella regione specificata.

Enum
POSTING_REGION_UNSPECIFIED Se la regione non è specificata, il job viene restituito solo se corrisponde a LocationFilter.
ADMINISTRATIVE_AREA

Oltre alla corrispondenza esatta della località, l'offerta di lavoro viene restituita quando il LocationFilter nella query di ricerca si trova nella stessa area amministrativa dell'offerta di lavoro restituita. Ad esempio, se un'offerta di lavoro in ADMINISTRATIVE_AREA viene pubblicata in"CA, USA", viene restituita se LocationFilter ha "Mountain View".

Per area amministrativa si intende la suddivisione amministrativa di primo livello del paese. Ad esempio, stato USA, regione IT, nazione costitutiva del Regno Unito e prefettura giapponese.

NATION Oltre alla corrispondenza esatta della località, il lavoro viene restituito quando LocationFilter nella query di ricerca si trova nello stesso paese di questo lavoro. Ad esempio, se un'offerta di lavoro NATION_WIDE viene pubblicata in"Stati Uniti", viene restituita se LocationFilter ha "Mountain View".
TELECOMMUTE Il lavoro consente ai dipendenti di lavorare da remoto (telelavoro). Se con questo valore vengono fornite le località, il lavoro viene considerato con una posizione, ma è consentito il telelavoro.

RequestMetadata

Metadati relative all'utente o all'entità che ha eseguito la ricerca di lavoro. Queste informazioni vengono utilizzate per migliorare le prestazioni del servizio.

Campi
domain

string

Obbligatorio se allow_missing_ids non è impostato o false.

L'ambito o l'origine definiti dal client della chiamata al servizio, che in genere corrisponde al dominio su cui il servizio è stato implementato ed è attualmente in esecuzione.

Ad esempio, se il servizio è gestito dal cliente Foo, Inc., sulla bacheca degli annunci di lavoro www.foo.com e sul sito per l'impiego www.bar.com, questo campo è impostato su "foo.com" per l'utilizzo nella bacheca degli annunci di lavoro e su "bar.com" per l'utilizzo sul sito dedicato alle offerte di lavoro.

Tieni presente che eventuali miglioramenti al modello per un particolare sito tenant si basano sul fatto che questo campo sia impostato correttamente su un dominio univoco.

Il numero massimo di caratteri consentiti è 255.

session_id

string

Obbligatorio se allow_missing_ids non è impostato o false.

Una stringa di identificazione della sessione univoca. Per sessione si intende la durata dell'interazione di un utente finale con il servizio in un determinato periodo. Offusca questo campo per problemi di privacy prima di fornirlo al servizio.

Tieni presente che eventuali miglioramenti al modello per un particolare sito tenant si basano sul fatto che questo campo sia impostato correttamente su un ID sessione univoco.

Il numero massimo di caratteri consentiti è 255.

user_id

string

Obbligatorio se allow_missing_ids non è impostato o false.

Una stringa di identificazione dell'utente univoco, come determinato dal cliente. Per ottenere il massimo impatto positivo sulla qualità della ricerca, assicurati che il livello di cliente sia unico. Offusca questo campo per problemi di privacy prima di fornirlo al servizio.

Tieni presente che eventuali miglioramenti al modello per un particolare sito tenant si basano sulla corretta impostazione di questo campo su un ID utente unico.

Il numero massimo di caratteri consentiti è 255.

allow_missing_ids

bool

Impostato solo quando domain, session_id e user_id non sono disponibili per un motivo non determinato. Ti consigliamo vivamente di non impostare questo campo e di fornire domain, session_id e user_id accurati per una migliore esperienza di servizio.

device_info

DeviceInfo

Il tipo di dispositivo utilizzato da chi cerca l'impiego al momento della chiamata al servizio.

ResponseMetadata

Informazioni aggiuntive restituite al cliente, ad esempio informazioni di debug.

Campi
request_id

string

Un ID univoco associato a questa chiamata. Questo ID viene registrato a scopo di monitoraggio.

SearchJobsRequest

Il corpo della richiesta della chiamata SearchJobs.

Campi
parent

string

Obbligatorio. Il nome della risorsa del tenant in cui eseguire la ricerca.

Il formato è "projects/{project_id}/tenants/{tenant_id}". Ad esempio, "projects/foo/tenant/bar". Se l'ID tenant non è specificato, viene creato un tenant predefinito. Ad esempio, "projects/foo".

search_mode

SearchMode

Modalità di ricerca.

Il valore predefinito è SearchMode.JOB_SEARCH.

request_metadata

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 user_id) sono forniti dagli utenti e devono essere univoci e coerenti.

job_query

JobQuery

Query utilizzata per cercare offerte di lavoro, ad esempio parola chiave, filtri per località e così via.

enable_broadening

bool

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.

require_precise_result_size
(deprecated)

bool

Questo campo è obsoleto.

histogram_queries[]

HistogramQuery

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: * count(string_histogram_facet): conteggiano il numero di entità corrispondenti per ogni valore di attributo distinto. * count(numeric_histogram_facet, list of buckets): conteggia il numero di entità corrispondenti all'interno di ciascun bucket.

Tipi di dati:

  • Facet istogramma: nomi dei facet con formato [a-zA-Z][a-zA-Z0-9_]+.
  • Stringa: stringa come "qualsiasi stringa con escape barra rovesciata per virgolette(")."
  • Numero: numero intero e numero in virgola mobile come 10, -1 e -0,01.
  • Elenco: elenco di elementi con separatore virgola(,) racchiuso tra parentesi quadre, ad esempio [1, 2, 3] e ["one", "due", "tre"].

Costanti integrate:

  • MIN (numero minimo simile a java Double.MIN_VALUE)
  • MAX (numero massimo simile a Java DoubleClick.MAX_VALUE)

Funzioni integrate:

  • bucket(start, end[, label]): la funzione integrata di bucket crea un bucket con intervallo [start, end). Tieni presente che la fine è esclusiva, ad esempio bucket(1, MAX, "numero positivo") o bucket(1, 10).

Facet istogrammi delle offerte di lavoro:

  • company_display_name: istogramma per Job.company_display_name.
  • Employ_type: istogramma per Job.employment_types, ad esempio "FULL_TIME", "PART_TIME".
  • company_size: istogramma per CompanySize, ad esempio "PICCOLO", "MEDIA", "BIG".
  • publish_time_in_month: istogramma per Job.posting_publish_time in mesi. Devi specificare l'elenco di bucket numerici nelle specifiche.
  • publish_time_in_year: istogramma per Job.posting_publish_time in anni. Devi specificare l'elenco di bucket numerici nelle specifiche.
  • grad_types: istogramma del Job.degree_types, ad esempio "Bachelors", "Masters".
  • job_level: istogramma del Job.job_level, ad esempio "Livello base".
  • country: istogramma in base al codice paese dei lavori, ad esempio "US", "FR".
  • admin1: istogramma per il codice admin1 dei job, ovvero un segnaposto globale che fa riferimento allo stato, alla provincia o al termine specifico utilizzato da un paese per definire la struttura geografica sotto il livello paese, ad esempio "CA", "IL".
  • city: istogramma in base a una combinazione di "nome città, codice admin1". Ad esempio, "Mountain View, CA", "New York, NY".
  • admin1_country: istogramma in base a una combinazione di "codice admin1, paese", ad esempio "CA, US", "IL, US".
  • city_coordinate: istogramma in base alle coordinate GPS del centro città (latitudine e longitudine), ad esempio 37.4038522,-122.0987765. Poiché le coordinate di un centro città possono cambiare, i clienti potrebbero dover aggiornare periodicamente.
  • locale: istogramma del Job.language_code, ad esempio "en-US", "fr-FR".
  • language: istogramma in base al sottotag della lingua di Job.language_code, ad esempio "en", "fr".
  • categoria: istogramma in base a JobCategory, ad esempio "COMPUTER_AND_IT", "HEALTHCARE".
  • base_compensation_unit: istogramma in base al CompensationInfo.CompensationUnit della retribuzione base, ad esempio "WEEKLY", "MONTH".
  • base_compensation: istogramma per retribuzione base. Devi specificare un elenco di bucket numerici in base a cui raggruppare i risultati.
  • annualized_base_compensation: istogramma per lo stipendio annuale di base. Devi specificare un elenco di bucket numerici in base a cui raggruppare i risultati.
  • annualized_total_compensation: istogramma per lo stipendio annuo totale. Devi specificare un elenco di bucket numerici in base a cui raggruppare i risultati.
  • string_custom_attribute: istogramma per stringa Job.custom_attributes. È possibile accedere ai valori tramite parentesi quadre, ad esempio string_custom_attribute["key1"].
  • numeric_custom_attribute: istogramma per valore numerico Job.custom_attributes. È possibile accedere ai valori mediante parentesi quadre, ad esempio numeric_custom_attribute["key1"]. Devi specificare un elenco di bucket numerici in base a cui raggruppare i risultati.

Espressioni di esempio:

  • count(admin1)
  • count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000), bucket(100000, MAX)])
  • count(string_custom_attribute["some-string-custom-attribute"])
  • count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])
job_view

JobView

Gli attributi del job desiderati restituiti per i job nella risposta della ricerca. Se non viene specificato alcun valore, il valore predefinito è JobView.JOB_VIEW_SMALL.

offset

int32

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 page_token non è impostato.

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).

page_size

int32

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.

page_token

string

Il token che specifica l'offset attuale all'interno dei risultati di ricerca. Consulta SearchJobsResponse.next_page_token per una spiegazione di come ottenere il successivo insieme di risultati della query.

order_by

string

I criteri che determinano l'ordinamento dei risultati di ricerca. Il valore predefinito è "relevance desc".

Le opzioni supportate sono:

  • "relevance desc": per pertinenza (ordine decrescente), come determinato dagli algoritmi dell'API. La soglia di pertinenza dei risultati delle query è disponibile solo con questo ordine.
  • "posting_publish_time desc": per Job.posting_publish_time (ordine decrescente).
  • "posting_update_time desc": per Job.posting_update_time (ordine decrescente).
  • "title": di Job.title (ordine crescente).
  • "title desc": per Job.title (ordine decrescente).
  • "annualized_base_compensation": in base al valore CompensationInfo.annualized_base_compensation_range (ordine crescente) del job. Le offerte di lavoro per cui non è specificato un compenso base annuale vengono posizionati alla fine dei risultati di ricerca.
  • "annualized_base_compensation desc": per CompensationInfo.annualized_base_compensation_range (ordine decrescente) del job. Le offerte di lavoro per cui non è specificato un compenso base annuale vengono posizionati alla fine dei risultati di ricerca.
  • "annualized_total_compensation": in base al valore CompensationInfo.annualized_total_compensation_range (ordine crescente) del job. Le offerte di lavoro per cui non è specificato un compenso base annuale vengono posizionati alla fine dei risultati di ricerca.
  • "annualized_total_compensation desc": per CompensationInfo.annualized_total_compensation_range (ordine decrescente) del job. Le offerte di lavoro per cui non è specificato un compenso base annuale vengono posizionati alla fine dei risultati di ricerca.
  • "custom_ranking desc": con il punteggio di pertinenza modificato in SearchJobsRequest.CustomRankingInfo.ranking_expression con un fattore di ponderazione assegnato da SearchJobsRequest.CustomRankingInfo.importance_level in ordine decrescente.
  • Ordinamento delle località: utilizza la sintassi speciale per ordinare i lavori per distanza:
    "distance_from('Hawaii')": ordina i lavori in base alla distanza dalle Hawaii.
    "distance_from(19.89, 155.5)": ordina in base alla distanza da una coordinata.
    "distance_from('Hawaii'), distance_from('Puerto Rico')": ordina in base a più sedi. Vedi i dettagli più avanti.
    "distance_from('Hawaii'), distance_from(19.89, 155.5)": ordina in base a più sedi. Vedi i dettagli più avanti.
    La stringa può contenere un massimo di 256 caratteri. Quando vengono forniti più centri di distanza, un lavoro nelle vicinanze di uno qualsiasi dei centri di distanza avrà un ranking elevato. Quando un lavoro ha più sedi, verrà utilizzata la località del lavoro più vicina a uno dei centri di distanza. Le offerte di lavoro senza località verranno classificate in basso. La distanza viene calcolata con una precisione di 11,3 metri (37,4 piedi). La strategia di diversificazione viene comunque applicata, a meno che non venga disattivata esplicitamente in diversification_level.
diversification_level

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 è DiversificationLevel.SIMPLE.

custom_ranking_info

CustomRankingInfo

Controlli su come vengono classificati i documenti dell'offerta di lavoro in base al punteggio di pertinenza esistente (determinato dall'algoritmo dell'API).

disable_keyword_match

bool

Consente di stabilire se disattivare la corrispondenza esatta delle parole chiave per Job.title, Job.description, Job.company_display_name, Job.addresses e Job.qualifications. Quando disattivi la corrispondenza delle parole chiave è disattivata, una corrispondenza della parola chiave restituisce le offerte di lavoro che non corrispondono a determinati filtri di categoria quando sono presenti parole chiave corrispondenti. Ad esempio, per la query "program manager", viene restituito un risultato anche se l'offerta di lavoro ha il titolo "sviluppatore software", che non rientra nell'ontologia "program manager", ma include "program manager" nella descrizione.

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 Company.keyword_searchable_job_custom_attributes se sono necessari valori stringa di attributi/campi personalizzati specifici dell'azienda a livello globale. L'attivazione della corrispondenza delle parole chiave migliora il richiamo delle successive richieste di ricerca.

Il valore predefinito è false.

CustomRankingInfo

Informazioni sul ranking personalizzato per SearchJobsRequest.

Campi
importance_level

ImportanceLevel

Obbligatorio. Controlli sull'importanza di applicare il punteggio di CustomRankingInfo.ranking_expression alla posizione in classifica finale del lavoro.

Se non specificato, viene generato un errore.

ranking_expression

string

Obbligatorio. Controlli su come vengono classificati i documenti dell'offerta di lavoro in base al punteggio di pertinenza esistente (determinato dall'algoritmo dell'API). Una combinazione dell'espressione di ranking e del punteggio di pertinenza viene utilizzata per determinare la posizione finale nel ranking del job.

La sintassi di questa espressione è un sottoinsieme della sintassi SQL di Google.

Gli operatori supportati sono: +, -, *, /, dove il lato sinistro e destro dell'operatore è una chiave numerica Job.custom_attributes, un valore intero/doppio o un'espressione che può essere valutata come numero.

Le parentesi sono supportate per regolare la precedenza del calcolo. L'espressione deve contenere meno di 100 caratteri.

L'espressione non è considerata valida per un job se fa riferimento ad attributi personalizzati non compilati nel job o se genera una divisione per zero. Se un'espressione non è valida per un job, il job viene retrocesso alla fine dei risultati.

Espressione di ranking del campione (anno + 25) * 0,25 - (aggiornamento / 0,5)

ImportanceLevel

Il livello di importanza per CustomRankingInfo.ranking_expression.

Enum
IMPORTANCE_LEVEL_UNSPECIFIED Valore predefinito se il livello di importanza non è specificato.
NONE L'espressione di ranking specificata è di importanza Nessuna; il punteggio di pertinenza esistente (determinato dall'algoritmo dell'API) domina la posizione finale del ranking del job.
LOW L'espressione di ranking specificata è di scarsa importanza in termini di posizione nel ranking finale del job rispetto al punteggio di pertinenza esistente (determinato dall'algoritmo dell'API).
MILD L'espressione di ranking specificata ha un'importanza minima in termini di posizione nel ranking finale del lavoro rispetto al punteggio di pertinenza esistente (determinato dall'algoritmo dell'API).
MEDIUM L'espressione di ranking specificata ha un'importanza media in termini di posizione nel ranking finale del job rispetto al punteggio di pertinenza esistente (determinato dall'algoritmo dell'API).
HIGH L'espressione di ranking specificata è di elevata importanza in termini di posizione finale nel ranking del job rispetto al punteggio di pertinenza esistente (determinato dall'algoritmo dell'API).
EXTREME L'espressione di ranking specificata è di estrema importanza e domina la posizione finale del ranking del job con il punteggio di pertinenza esistente (determinato dall'algoritmo dell'API) ignorato.

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.

Enum
DIVERSIFICATION_LEVEL_UNSPECIFIED Il livello di diversificazione non è specificato.
DISABLED Disattiva la diversificazione. Le posizioni dei job che in genere vengono inviati all'ultima pagina non vengono modificate. Di conseguenza, offerte di lavoro molto simili potrebbero essere visualizzate in sequenza nei risultati di ricerca.
SIMPLE Comportamento diversificante predefinito. L'elenco dei risultati viene ordinato in modo che risultati molto simili vengano spostati alla fine dell'ultima pagina dei risultati di ricerca. Se utilizzi pageToken per sfogliare il set di risultati, la latenza potrebbe essere inferiore, ma non possiamo garantire che vengano restituiti tutti i risultati. Se utilizzi l'offset di pagina, la latenza potrebbe essere superiore, ma vengono restituiti tutti i risultati.

SearchMode

Un'enumerazione della modalità di ricerca job rappresentata da una stringa. Il servizio funziona in modo diverso a seconda della modalità.

Enum
SEARCH_MODE_UNSPECIFIED La modalità del metodo di ricerca non è specificata. Il comportamento della ricerca predefinito è identico al comportamento della ricerca JOB_SEARCH.

SearchJobsResponse

Risposta per il metodo SearchJob.

Campi
matching_jobs[]

MatchingJob

Le entità Job che corrispondono al valore SearchJobsRequest specificato.

histogram_query_results[]

HistogramQueryResult

I risultati dell'istogramma che corrispondono al valore SearchJobsRequest.histogram_queries specificato.

next_page_token

string

Il token che specifica la posizione iniziale della pagina dei risultati successiva. Questo campo è vuoto se non ci sono altri risultati.

location_filters[]

Location

I filtri di località che il servizio ha applicato alla query specificata. Se ci sono filtri basati su lat-lng, Location.location_type è Location.LocationType.LOCATION_TYPE_UNSPECIFIED.

estimated_total_size

int32

Una stima del numero di job corrispondenti alla query specificata.

Non è garantito che questo numero sia preciso. Per risultati precisi, consulta SearchJobsResponse.total_size.

total_size

int32

Il conteggio preciso dei risultati con limite di 100.000.

metadata

ResponseMetadata

Informazioni aggiuntive per la chiamata all'API, ad esempio l'ID monitoraggio della richiesta.

broadened_query_jobs_count

int32

Se l'ampliamento delle query è abilitato, potremmo aggiungere ulteriori risultati dalla query ampliata. Questo numero indica quanti job restituiti nel campo dei job provengono dalla query ampliata. Questi risultati si trovano sempre alla fine dell'elenco dei job. In particolare, se il valore è pari a 0 oppure se il campo non è impostato, tutti i job nell'elenco dei job provengono dalla query originale (senza ampliare). Se questo campo è diverso da zero, le richieste successive con offset dopo questo set di risultati devono contenere tutti i risultati ampliati.

spell_correction

SpellingCorrection

Il risultato del controllo ortografico e la correzione.

CommuteInfo

Dettagli del tragitto giornaliero relativi a questo job.

Campi
job_location

Location

Posizione utilizzata come destinazione nel calcolo del tragitto giornaliero.

travel_duration

Duration

Il numero di secondi necessari per raggiungere la località del lavoro dalla località della query. Una durata di 0 secondi indica che il job non è raggiungibile entro la durata richiesta, ma è stato restituito come parte di una query espansa.

MatchingJob

Voce del job con metadati all'interno di SearchJobsResponse.

Campi
job

Job

Risorsa job corrispondente al valore SearchJobsRequest specificato.

job_summary

string

Un riepilogo del job con informazioni principali visualizzate nella pagina dei risultati di ricerca.

job_title_snippet

string

Contiene snippet di testo del campo Job.title che corrispondono il più possibile alle parole chiave di una query di ricerca, se disponibili. Le parole chiave della query corrispondenti sono racchiuse tra tag HTML in grassetto.

search_text_snippet

string

Contiene snippet di testo tratti da Job.description e da campi simili che corrispondono il più possibile alle parole chiave di una query di ricerca, se disponibili. Tutti i tag HTML nei campi originali vengono rimossi quando vengono restituiti in questo campo e le parole chiave della query corrispondenti sono racchiuse tra tag HTML in grassetto.

commute_info

CommuteInfo

Informazioni sul tragitto giornaliero generate in base a CommuteFilter specificato.

SpellingCorrection

Risultato del controllo ortografico.

Campi
corrected

bool

Indica se la query è stata corretta dal controllo ortografico.

corrected_text

string

Output della correzione costituito dalla stringa della parola chiave corretta.

corrected_html

string

Output corretto con tag HTML per evidenziare le parole corrette. Le parole corrette vengono richiamate con i tag HTML "...".

Ad esempio, la query di input utente è "software Enginear", dove la seconda parola, "enginear", non è corretta. Dovrebbe essere "ingegnere". Quando la correzione ortografica è attiva, questo valore è "ingegnera software".

Tenant

Una risorsa tenant rappresenta un tenant nel servizio. Un tenant è un gruppo o un'entità che condivide l'accesso comune con privilegi specifici per risorse come i profili. Il cliente può creare più tenant per fornire l'isolamento dei dati per gruppi diversi.

Campi
name

string

Obbligatorio durante l'aggiornamento del tenant.

Il nome della risorsa per un tenant. Viene generato dal servizio al momento della creazione di un tenant.

Il formato è "projects/{project_id}/tenants/{tenant_id}", ad esempio "projects/foo/tenants/bar".

external_id

string

Obbligatorio. Identificatore tenant lato client, utilizzato per identificare in modo univoco il tenant.

Il numero massimo di caratteri consentiti è 255.

usage_type

DataUsageType

Indica se i dati di proprietà di questo tenant possono essere utilizzati per fornire miglioramenti del prodotto in altri tenant.

Se non viene configurato, il comportamento predefinito è DataUsageType.ISOLATED.

keyword_searchable_profile_custom_attributes[]

string

Un elenco di chiavi di Profile.custom_attributes filtrabili, le cui string_values corrispondenti vengono utilizzate nelle ricerche di parole chiave. I profili con string_values sotto queste chiavi di campo specificate vengono restituiti se uno qualsiasi dei valori corrisponde alla parola chiave per la ricerca. I valori dei campi personalizzati con parentesi, parentesi e simboli speciali non sono disponibili per la ricerca così come sono e devono essere racchiusi tra virgolette.

DataUsageType

Enum che rappresenta il modo in cui vengono utilizzati i dati utente di proprietà del tenant.

Enum
DATA_USAGE_TYPE_UNSPECIFIED Valore predefinito.
AGGREGATED I dati di proprietà di questo tenant vengono utilizzati per migliorare la qualità della ricerca e dei suggerimenti tra i tenant.
ISOLATED I dati di proprietà di questo tenant vengono utilizzati per migliorare la qualità della ricerca e dei suggerimenti solo per questo tenant.

TimestampRange

Messaggio che rappresenta un periodo di tempo compreso tra due timestamp.

Campi
start_time

Timestamp

Inizio del periodo (incluso).

end_time

Timestamp

Fine del periodo (esclusa).

UpdateCompanyRequest

Richiesta di aggiornamento di un'azienda specificata.

Campi
company

Company

Obbligatorio. La risorsa aziendale per sostituire la risorsa attuale nel sistema.

update_mask

FieldMask

Fortemente consigliato per un'esperienza di servizio ottimale.

Se viene fornito il valore update_mask, vengono aggiornati solo i campi specificati in company. In caso contrario, tutti i campi vengono aggiornati.

Una maschera dei campi per specificare i campi dell'azienda da aggiornare. Sono supportati solo i campi di primo livello di Company.

UpdateJobRequest

Richiesta di aggiornamento del lavoro.

Campi
job

Job

Obbligatorio. Il job da aggiornare.

update_mask

FieldMask

Fortemente consigliato per un'esperienza di servizio ottimale.

Se viene fornito il valore update_mask, vengono aggiornati solo i campi specificati in job. In caso contrario, tutti i campi vengono aggiornati.

Una maschera di campo per limitare i campi aggiornati. Sono supportati solo i campi di primo livello di Job.

UpdateTenantRequest

Richiesta di aggiornamento di un tenant specificato.

Campi
tenant

Tenant

Obbligatorio. La risorsa tenant per sostituire la risorsa attuale nel sistema.

update_mask

FieldMask

Fortemente consigliato per un'esperienza di servizio ottimale.

Se viene fornito il valore update_mask, vengono aggiornati solo i campi specificati in tenant. In caso contrario, tutti i campi vengono aggiornati.

Una maschera dei campi per specificare i campi del tenant da aggiornare. Sono supportati solo i campi di primo livello di Tenant.

Visibilità

Ritirato. Tutte le risorse sono visibili solo al proprietario.

Un'enumerazione che rappresenta chi ha accesso in visualizzazione alla risorsa.

Enum
VISIBILITY_UNSPECIFIED Valore predefinito.
ACCOUNT_ONLY La risorsa è visibile solo all'account Google Cloud che la possiede.
SHARED_WITH_GOOGLE La risorsa è visibile al proprietario e potrebbe essere visibile ad altre applicazioni e processi in Google.
SHARED_WITH_PUBLIC La risorsa è visibile al proprietario e può essere visibile a tutti gli altri client API.