Method: projects.jobs.patch

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.

Richiesta HTTP

PATCH https://jobs.googleapis.com/v4beta1/{job.name=projects/*/jobs/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
job.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.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "job": {
    "name": string,
    "company": string,
    "requisitionId": string,
    "title": string,
    "description": string,
    "addresses": [
      string
    ],
    "applicationInfo": {
      "emails": [
        string
      ],
      "instruction": string,
      "uris": [
        string
      ]
    },
    "jobBenefits": [
      enum (JobBenefit)
    ],
    "compensationInfo": {
      "entries": [
        {
          object (CompensationEntry)
        }
      ],
      "annualizedBaseCompensationRange": {
        object (CompensationRange)
      },
      "annualizedTotalCompensationRange": {
        object (CompensationRange)
      }
    },
    "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": {
      "seconds": string,
      "nanos": integer
    },
    "jobEndTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingPublishTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingExpireTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingCreateTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingUpdateTime": {
      "seconds": string,
      "nanos": integer
    },
    "companyDisplayName": string,
    "derivedInfo": {
      "locations": [
        {
          object (Location)
        }
      ],
      "jobCategories": [
        enum (JobCategory)
      ]
    },
    "processingOptions": {
      "disableStreetAddressResolution": boolean,
      "htmlSanitization": enum (HtmlSanitization)
    }
  },
  "updateMask": string
}
Campi
job.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".

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

job.title

string

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

Il numero massimo di caratteri consentiti è 500.

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

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

job.applicationInfo

object (ApplicationInfo)

Informazioni sulla candidatura.

job.jobBenefits[]

enum (JobBenefit)

I vantaggi inclusi nel lavoro.

job.compensationInfo

object (CompensationInfo)

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

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

job.degreeTypes[]

enum (DegreeType)

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

job.department

string

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

Il numero massimo di caratteri consentiti è 255.

job.employmentTypes[]

enum (EmploymentType)

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

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

job.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".

job.jobLevel

enum (JobLevel)

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

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

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

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

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

job.visibility
(deprecated)

enum (Visibility)

Ritirato. Il job è visibile solo al proprietario.

La visibilità del job.

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

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

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

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

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

job.postingCreateTime

string (Timestamp format)

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

job.postingUpdateTime

string (Timestamp format)

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

job.companyDisplayName

string

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

job.derivedInfo

object (DerivedInfo)

Solo output. Dettagli derivati sull'offerta di lavoro.

job.processingOptions

object (ProcessingOptions)

Opzioni per l'elaborazione del job.

updateMask

string (FieldMask format)

Fortemente consigliato per un'esperienza di servizio ottimale.

Se viene fornito il valore updateMask, 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.

Un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Job.

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.