Panoramica
Prima di poter iniziare a utilizzare Cloud Talent Solution (CTS), devi abilitare l'API nella console di Google Cloud Platform. I passaggi riportati di seguito illustrano le seguenti azioni:
- Abilitare CTS in un progetto Google Cloud.
- Assicurati che la fatturazione sia abilitata 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 console di GCP
Vai alla console di 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 preesistente (accanto al progetto selezionato verrà visualizzato un segno di spunta) 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 preesistente, assicurati di avere abilitato la fatturazione. Per accedere ai dati di fatturazione del progetto in qualsiasi momento, vai al menu di navigazione principale (l'icona a forma di hamburger nell'angolo in alto a sinistra) e fai clic sull'opzione Fatturazione:
Dopo aver selezionato un progetto Google Cloud e averlo collegato a un account di fatturazione, puoi abilitare 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 (Soluzione di talento) e scegli Panoramica dal menu popup:
Se vuoi prima provare l'API senza collegarla al tuo progetto, puoi scegliere l'opzione PROVA QUESTA API. Consulta la documentazione di Explorer API Job Search per ulteriori informazioni sull'utilizzo di questa funzionalità. Per abilitare l'API Cloud Talent Solution da utilizzare con il tuo progetto Google Cloud, fai clic su ABILITA:
Viene visualizzata la pagina del logging dei dati. Devi accettare Termini e condizioni per avere accesso completo alle funzionalità di CTS. Se scegli di non accettare questi termini, potrai utilizzare solo le richieste API Delete. Fai clic su ABILITA:
Viene richiesto 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 su questa pagina. Fai clic su COLLEGA accanto agli account che vuoi collegare all'API CTS. Una volta eseguita questa operazione, puoi andare al passaggio 8 per assicurarti di aver scaricato una credenziale JSON o P12 per quell'account.
Se il progetto non dispone ancora di 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 completato 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.
La pagina successiva ti consente di assegnare un ruolo al nuovo account di servizio. Consulta la pagina delle autorizzazioni IAM del CTS per informazioni dettagliate sui ruoli disponibili e sulle autorizzazioni consentite per ciascuno. 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 nella colonna a destra:
La pagina successiva ti dà la possibilità di completare diverse attività. Non sono obbligatori, ma vivamente consigliati. Puoi concedere ai singoli utenti l'accesso all'account di servizio appena creato inserendo i loro indirizzi email. Puoi anche creare una chiave privata per l'account di servizio. Devi utilizzare una chiave privata durante il processo di autenticazione quando usi l'API. Se scegli di non eseguire subito queste azioni, 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:
Viene scaricato automaticamente un nuovo file delle credenziali JSON o P12. Archivia 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 quando esegui il processo 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 ora visualizzato nella pagina Connetti gli account di servizio. Fai clic su COLLEGA per collegarlo all'API CTS:
L'account è connesso e puoi iniziare a integrare Cloud Talent Solution nel tuo sistema:
Imposta la variabile di ambiente di autenticazione
Fornisci le credenziali di autenticazione al codice dell'applicazione impostando la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS. Questa variabile si applica solo alla sessione di shell attuale. Se vuoi che la variabile venga applicata a future sessioni shell, impostala nel file di avvio della shell, ad esempio nel file ~/.bashrc o ~/.profile.
Linux o macOS
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.
Ad esempio:
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
Windows
Per PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.
Ad esempio:
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
Per il prompt dei comandi:
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.
Per ulteriori informazioni, consulta la documentazione sull'autenticazione GCP.
Passaggi successivi
Installa una libreria client o consulta la guida rapida alla creazione di job e aziende per iniziare a effettuare chiamate API.