JobQuery

La query necessaria per eseguire una query di ricerca.

Rappresentazione JSON 
{
  "query": string,
  "queryLanguageCode": string,
  "companies": [
    string
  ],
  "locationFilters": [
    {
      object (LocationFilter)
    }
  ],
  "jobCategories": [
    enum (JobCategory)
  ],
  "commuteFilter": {
    object (CommuteFilter)
  },
  "companyDisplayNames": [
    string
  ],
  "compensationFilter": {
    object (CompensationFilter)
  },
  "customAttributeFilter": string,
  "disableSpellCheck": boolean,
  "employmentTypes": [
    enum (EmploymentType)
  ],
  "languageCodes": [
    string
  ],
  "publishTimeRange": {
    object (TimestampRange)
  },
  "excludedJobs": [
    string
  ]
}
Campi
query

string

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

Il numero massimo di caratteri consentiti è 255.
queryLanguageCode

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/{projectId}/tenants/{tenantId}/businesses/{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.
locationFilters[]

object (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à.
jobCategories[]

enum (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.
commuteFilter

object (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, locationFilters viene ignorato.

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

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

object (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.
customAttributeFilter

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
disableSpellCheck

boolean

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.
employmentTypes[]

enum (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.
languageCodes[]

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

object (TimestampRange)

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

string

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

Sono consentiti al massimo 400 nomi di job esclusi.

LocationFilter

Regione geografica della ricerca.

Rappresentazione JSON 
{
  "address": string,
  "regionCode": string,
  "latLng": {
    object (LatLng)
  },
  "distanceInMiles": number,
  "telecommutePreference": enum (TelecommutePreference),
  "negated": boolean
}
Campi
address

string

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

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

object (LatLng)

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

number

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

enum (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 latLng 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

boolean

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.

CommuteFilter

Parametri necessari per la ricerca per tragitto giornaliero.

Rappresentazione JSON 
{
  "commuteMethod": enum (CommuteMethod),
  "startCoordinates": {
    object (LatLng)
  },
  "travelDuration": string,
  "allowImpreciseAddresses": boolean,

  // Union field traffic_option can be only one of the following:
  "roadTraffic": enum (RoadTraffic),
  "departureTime": {
    object (TimeOfDay)
  }
  // End of list of possible types for union field traffic_option.
}
Campi
commuteMethod

enum (CommuteMethod)

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

object (LatLng)

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

string (Duration format)

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

Una durata in secondi con un massimo di nove cifre frazionarie, terminata con "s". Esempio: "3.5s".
allowImpreciseAddresses

boolean

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:
roadTraffic

enum (RoadTraffic)

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

object (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.

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.

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.

TimeOfDay

Rappresenta un'ora del giorno. La data e il fuso orario non sono significativi o sono specificati altrove. Un'API può scegliere di consentire secondi intercalari. I tipi correlati sono google.type.Date e google.protobuf.Timestamp.

Rappresentazione JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campi
hours

integer

Ore del giorno nel formato 24 ore. Il valore deve essere compreso tra 0 e 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.
minutes

integer

Minuti di ora del giorno. Il valore deve essere compreso tra 0 e 59.
seconds

integer

Secondi di minuti. Normalmente deve essere compreso tra 0 e 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.
nanos

integer

Frazioni di secondi in nanosecondi. Il valore deve essere compreso tra 0 e 999.999.999.

CompensationFilter

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

Rappresentazione JSON 
{
  "type": enum (FilterType),
  "units": [
    enum (CompensationUnit)
  ],
  "range": {
    object (CompensationRange)
  },
  "includeJobsWithUnspecifiedCompensationRange": boolean
}
Campi
type

enum (FilterType)

Obbligatorio. Tipo di filtro.
units[]

enum (CompensationUnit)

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

object (CompensationRange)

Intervallo di compensazione.
includeJobsWithUnspecifiedCompensationRange

boolean

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.

TimestampRange

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

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string
}
Campi
startTime

string (Timestamp format)

Inizio del periodo (incluso).
endTime

string (Timestamp format)

Fine del periodo (esclusa).