Panoramica
Prima di poter iniziare a utilizzare Cloud Talent Solution (CTS), devi attivare l'API nella console della piattaforma Google Cloud (GCP). I passaggi riportati di seguito illustrano le seguenti azioni:
- Abilita CTS in un progetto Google Cloud.
- Assicurati che la fatturazione sia attivata per CTS.
- Accetta i Termini e condizioni per il logging dei dati.
- Crea e/o assegna uno o più account di servizio a Cloud Talent Solution.
- Scarica una chiave delle credenziali dell'account di servizio.
- Imposta la variabile di ambiente di autenticazione.
Configurazione della console Google Cloud
Vai alla console Google Cloud. Vai al menu a discesa nella parte superiore della pagina e scegli il progetto Google Cloud da associare a Cloud Talent Solution. Se hai già creato uno o più progetti, questi verranno visualizzati in un elenco nel menu popup. Puoi scegliere un progetto esistente (viene visualizzato un segno di spunta accanto al progetto selezionato) o crearne uno nuovo facendo clic su NUOVO PROGETTO. Per ulteriori dettagli sulla creazione di un progetto Google Cloud, consulta la documentazione.
Se crei un nuovo progetto, ti verrà chiesto di collegare un account di fatturazione a questo progetto. Se utilizzi un progetto esistente, assicurati di avere attivato la fatturazione. Puoi accedere ai dati di fatturazione del progetto in qualsiasi momento accedendo al menu di navigazione principale (l'icona a forma di menu nell'angolo in alto a sinistra) e facendo clic sull'opzione Fatturazione:
Dopo aver selezionato un progetto Google Cloud e averlo collegato a un account di fatturazione, puoi attivare l'API Cloud Talent Solution. Vai al menu di navigazione principale e scorri verso il basso fino alla sezione Intelligenza artificiale. Fai clic su Talent Solution e scegli Panoramica dal menu popup:
Se vuoi prima provare l'API senza collegarla al tuo progetto, puoi scegliere l'opzione PROVA QUESTA API. Per ulteriori informazioni sull'utilizzo di questa funzionalità, consulta la documentazione di Job Search API Explorer. Per attivare l'API Cloud Talent Solution per l'utilizzo con il tuo progetto Google Cloud, fai clic su ABILITA:
Viene visualizzata la pagina di registrazione dei dati. Devi accettare i Termini e condizioni per avere accesso completo alle funzionalità di CTS. Se scegli di non accettare questi termini, potrai utilizzare solo le richieste API di eliminazione. Fai clic su ABILITA:
A questo punto ti viene chiesto di collegare uno o più account di servizio all'API CTS. Se utilizzi un progetto a cui sono già associati account di servizio, questi verranno visualizzati in un elenco in questa pagina. Fai clic su COLLEGA accanto agli account che vuoi collegare all'API CTS. Al termine, puoi andare al passaggio 8 per assicurarti di aver scaricato una credenziale JSON o P12 per quell'account.
Se il progetto non ha ancora account di servizio, ti viene chiesto di crearne uno. Digita un nome a tua scelta nella casella Nome account di servizio. Il valore inserito viene inserito automaticamente nella casella ID account di servizio. La casella Descrizione account di servizio è facoltativa, ma consigliata se prevedi di associare più account di servizio al tuo progetto. Inserisci una breve descrizione dell'account di servizio in questa casella, quindi fai clic su CREA.
Nella pagina successiva puoi assegnare un ruolo al nuovo account di servizio. Per informazioni dettagliate sui ruoli disponibili e sulle autorizzazioni consentite per ciascuno, consulta la pagina Autorizzazioni IAM di CTS. Fai clic sul menu a discesa Seleziona un ruolo e scorri verso il basso fino a Cloud Talent Solution. Puoi scegliere un ruolo per questo account di servizio tra le opzioni disponibili nella colonna di destra:
Nella pagina successiva puoi scegliere di completare diverse attività. Questi requisiti non sono obbligatori, ma vivamente consigliati. Puoi concedere l'accesso ai singoli utenti all'account di servizio che hai appena creato inserendo i loro indirizzi email. Puoi anche creare una chiave privata per l'account di servizio. Quando utilizzi l'API, devi utilizzare una chiave privata durante la procedura di autenticazione. Se scegli di non eseguire queste azioni ora, puoi generare una chiave e aggiungere/modificare le informazioni dei singoli utenti in qualsiasi momento accedendo all'account di servizio tramite l'opzione IAM nel menu di navigazione principale.
Fai clic su CREA CHIAVE:
Scegli il formato che preferisci dal menu popup e fai clic su CREA:
Verrà scaricato automaticamente un nuovo file delle credenziali JSON o P12. Memorizza questo file in una posizione specifica e prendi nota del percorso del file. Dovrai indirizzare la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS a questo file durante la procedura di autenticazione. Questo è un passaggio essenziale per autenticare le richieste a Cloud Talent Solution.
Una volta scaricato il file delle credenziali, fai clic su FINE:
Il tuo account di servizio viene visualizzato nella pagina Collega account di servizio. Fai clic su COLLEGA per collegarlo all'API CTS:
L'account è ora collegato e puoi iniziare a integrare Cloud Talent Solution nel tuo sistema:
Imposta la variabile di ambiente di autenticazione
Provide authentication credentials to your application code by setting the
environment variable GOOGLE_APPLICATION_CREDENTIALS. This
variable applies only to your current shell session. If you want the variable
to apply to future shell sessions, set the variable in your shell startup file,
for example in the ~/.bashrc or ~/.profile file.
Linux o macOS
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"Replace KEY_PATH with the path of the JSON file that contains your credentials.
For example:
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
Windows
For PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"Replace KEY_PATH with the path of the JSON file that contains your credentials.
For example:
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
For command prompt:
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATHReplace KEY_PATH with the path of the JSON file that contains your credentials.
Per ulteriori informazioni, consulta la documentazione sull'autenticazione di Google Cloud.
Passaggi successivi
Installa una libreria client o consulta la guida rapida per la creazione di attività e aziende per iniziare a effettuare chiamate API.