Una risorsa Azienda nell'API Cloud Talent Solution rappresenta una singola azienda. Qualsiasi lavoro appartenente a quell'azienda fa riferimento a un annuncio di lavoro creato per una posizione aperta in quell'azienda. Contiene informazioni come il nome e l'indirizzo dell'azienda, nonché campi interni che collegano la risorsa nel servizio Cloud Talent Solution ai tuoi database interni.
Creare un'azienda
Per creare una società, invia una richiesta POST all'endpoint companies
, specificando almeno i due campi obbligatori. Per informazioni dettagliate su come creare un'azienda, consulta la pagina Guida rapida: crea aziende e offerte di lavoro.
Java
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Python
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Campi obbligatori
I seguenti campi sono obbligatori nelle richieste di creazione/aggiornamento:
displayName
: il nome del datore di lavoro visualizzato con la posizione, ad esempio "Google LLC".externalId
: Il tuo ID interno per questa azienda. Questo campo ti consente di mappare gli identificatori interni all'azienda nel sistema di Google. Se l'azienda non ha un identificativo interno distinto, imposta questo campo sul valoredisplayName
.
Campi di uso comune
headquartersAddress
: l'indirizzo della sede principale dell'azienda, che può essere diversa dalla sede di lavoro. Cloud Talent Solution accetta una sola sede centrale per società. Il servizio tenta di geolocalizzare l'indirizzo e, se possibile, compila una località più specifica inderivedInfo.headquartersLocation
(che è solo di output).size
: un valore del bucket che rappresenta le dimensioni dell'azienda in termini di numero di dipendenti, daMINI
aGIANT
. Consulta la documentazione di riferimento disize
per gli enum e le relative definizioni.eeoText
: una stringa contenente il testo del disclaimer legale relativo alle pari opportunità lavorative da associare a tutti i lavori per questa azienda.keywordSearchableJobCustomAttributes
: specifica qualecustomAttributes
per le offerte di lavoro di questa azienda deve essere indicizzato e disponibile per la ricerca tramite parole chiave generali.
Aggiornare una società
Per aggiornare un'azienda, invia una richiesta PATCH al seguente endpoint:
PATCH https://jobs.googleapis.com/v3/COMPANY_NAME
dove COMPANY_NAME
è il valore del campo name
per l'azienda. name
è l'identificatore univoco dell'azienda che viene fornito al momento della creazione e anche dalle richieste company.get
e list
.
Il corpo della richiesta deve contenere l'intera risorsa, inclusi i campi non aggiornati. Questi campi possono essere impostati in updateMask
. Se i campi sono impostati in updateMask
, vengono aggiornati solo questi campi e gli aggiornamenti di altri campi vengono ignorati. Se updateMask
non è impostato, vengono aggiornati tutti i campi.
Java
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Python
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Aggiornare la società con updateMask
Java
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Python
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Go
Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di Cloud Talent Solution.
Best practice
Società riservate
Se vuoi pubblicare un'offerta di lavoro confidenziale, ti consigliamo di creare un'azienda separata che simuli i campi dell'azienda, ma offuschi displayName
, externalId
e tutti gli altri campi di identificazione.
Nei casi in cui il datore di lavoro finale debba essere anonimo (ad esempio, il caso d'uso dell'agenzia di reclutamento), consigliamo di impostare externalId
e
displayName
su valori casuali, ma univoci.