Questa pagina è stata tradotta dall'API Cloud Translation.

REST Resource: projects.tenants.jobs

Risorsa: job
- Rappresentazione JSON
Metodi

Risorsa: 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.

Rappresentazione JSON

Rappresentazione JSON
{ "name": string, "company": string, "requisitionId": string, "title": string, "description": string, "addresses": [ string ], "applicationInfo": { object (`ApplicationInfo`) }, "jobBenefits": [ enum (`JobBenefit`) ], "compensationInfo": { object (`CompensationInfo`) }, "customAttributes": { string: { object (`CustomAttribute`) }, ... }, "degreeTypes": [ enum (`DegreeType`) ], "department": string, "employmentTypes": [ enum (`EmploymentType`) ], "incentives": string, "languageCode": string, "jobLevel": enum (`JobLevel`), "promotionValue": integer, "qualifications": string, "responsibilities": string, "postingRegion": enum (`PostingRegion`), "visibility": enum (`Visibility`), "jobStartTime": string, "jobEndTime": string, "postingPublishTime": string, "postingExpireTime": string, "postingCreateTime": string, "postingUpdateTime": string, "companyDisplayName": string, "derivedInfo": { object (`DerivedInfo`) }, "processingOptions": { object (`ProcessingOptions`) } }

{
  "name": string,
  "company": string,
  "requisitionId": string,
  "title": string,
  "description": string,
  "addresses": [
    string
  ],
  "applicationInfo": {
    object (ApplicationInfo)
  },
  "jobBenefits": [
    enum (JobBenefit)
  ],
  "compensationInfo": {
    object (CompensationInfo)
  },
  "customAttributes": {
    string: {
      object (CustomAttribute)
    },
    ...
  },
  "degreeTypes": [
    enum (DegreeType)
  ],
  "department": string,
  "employmentTypes": [
    enum (EmploymentType)
  ],
  "incentives": string,
  "languageCode": string,
  "jobLevel": enum (JobLevel),
  "promotionValue": integer,
  "qualifications": string,
  "responsibilities": string,
  "postingRegion": enum (PostingRegion),
  "visibility": enum (Visibility),
  "jobStartTime": string,
  "jobEndTime": string,
  "postingPublishTime": string,
  "postingExpireTime": string,
  "postingCreateTime": string,
  "postingUpdateTime": string,
  "companyDisplayName": string,
  "derivedInfo": {
    object (DerivedInfo)
  },
  "processingOptions": {
    object (ProcessingOptions)
  }
}

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/{projectId}/tenants/{tenantId}/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 `requisitionId`, poiché questo valore è univoco.
`company`	`string` Obbligatorio. Il nome della risorsa dell'azienda che pubblica l'elenco del lavoro. 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".
`requisitionId`	`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`, `languageCode` e `requisitionId`. 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 `requisitionId` univoci (ad es. "ReqA" diventa "ReqA-1", "ReqA-2" e così via), poiché non sono consentiti più job con lo stesso `company`, `languageCode` e `requisitionId`. Se è necessario conservare il valore originale `requisitionId`, è 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.
`applicationInfo`	`object (ApplicationInfo)` Informazioni sulla candidatura.
`jobBenefits[]`	`enum (JobBenefit)` I vantaggi inclusi nel lavoro.
`compensationInfo`	`object (CompensationInfo)` Informazioni sulla retribuzione del lavoro (chiamato anche "tasso di retribuzione"), ovvero il compenso che verrà corrisposto al dipendente.
`customAttributes`	`map (key: string, value: object (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 `stringValues` filtrabile, in tutte le chiavi sono consentiti al massimo 200 valori e ogni stringa non può contenere più di 255 caratteri. Per l'opzione `stringValues` non filtrabile, la dimensione totale massima di `stringValues` in tutte le chiavi è 50 kB.
`degreeTypes[]`	`enum (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.
`employmentTypes[]`	`enum (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.
`languageCode`	`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".
`jobLevel`	`enum (JobLevel)` Il livello di esperienza associato al lavoro, ad esempio "Livello base".
`promotionValue`	`integer` 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.
`postingRegion`	`enum (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)`	`enum (Visibility)` Questo elemento è obsoleto. Ritirato. Il job è visibile solo al proprietario. La visibilità del job. Se non specificato, il valore predefinito è `Visibility.ACCOUNT_ONLY`.
`jobStartTime`	`string (Timestamp format)` 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.
`jobEndTime`	`string (Timestamp format)` Il timestamp di fine del job. In genere questo campo viene utilizzato per la stipula di contratti. I timestamp non validi vengono ignorati.
`postingPublishTime`	`string (Timestamp format)` 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.
`postingExpireTime`	`string (Timestamp format)` 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 `jobs.list`, ma può essere recuperato con l'API `jobs.get` o aggiornato con l'API `jobs.patch` oppure eliminato con l'API `jobs.delete`. 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`, `languageCode` e `requisitionId`. 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, `postingPublishTime` deve essere impostato prima del giorno `postingExpireTime`. 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 `jobEndTime` 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.
`postingCreateTime`	`string (Timestamp format)` Solo output. Il timestamp di creazione dell'offerta di lavoro.
`postingUpdateTime`	`string (Timestamp format)` Solo output. Il timestamp dell'ultimo aggiornamento di questa offerta di lavoro.
`companyDisplayName`	`string` Solo output. Nome visualizzato dell'azienda che pubblica l'elenco del lavoro.
`derivedInfo`	`object (DerivedInfo)` Solo output. Dettagli derivati sull'offerta di lavoro.
`processingOptions`	`object (ProcessingOptions)` Opzioni per l'elaborazione del job.

Metodi
`batchCreate`	Avvia l'esecuzione di un'operazione di creazione dei job in batch.
`batchDelete`	Elimina un elenco di `Job` in base al filtro.
`batchUpdate`	Avvia l'esecuzione di un'operazione di job di aggiornamento batch.
`create`	Crea un nuovo job.
`delete`	Elimina il job specificato.
`get`	Recupera il job specificato, il cui stato è APERTO o SCADUTO di recente negli ultimi 90 giorni.
`list`	Elenca i job per filtro.
`patch`	Aggiorna il job specificato.
`search`	Cerca offerte di lavoro utilizzando il `SearchJobsRequest` fornito.
`searchForAlert`	Cerca offerte di lavoro utilizzando il `SearchJobsRequest` fornito.

REST Resource: projects.tenants.jobs

Risorsa: job

Metodi

`batchCreate`

`batchDelete`

`batchUpdate`

`create`

`delete`

`get`

`list`

`patch`

`search`

`searchForAlert`