La possibilità di accedere in modo efficiente alle informazioni sugli utenti di Google è fondamentale per creare interfacce utente reattive e automatizzare attività come l’invio di e-mail a più utenti all’interno di un dominio. Per soddisfare questi requisiti, abbiamo introdotto una serie di funzioni per ottenere informazioni specifiche sugli utenti e per recuperare tutti i profili e i contatti del dominio.
Connessione all’account
Prima di ottenere le informazioni sull’utente, è necessario creare un oggetto di connessione OAuth 2.0:
var $oAuth2:=cs.NetKit.OAuth2Provider.new($credentials)
var $google:=cs.NetKit.Google.new($oAuth2)
Si noti che per accedere alle informazioni dell’utente possono essere necessari più ambiti:
- https://www.googleapis.com/auth/contacts
- https://www.googleapis.com/auth/contacts.other.readonly
- https://www.googleapis.com/auth/contacts.readonly
- https://www.googleapis.com/auth/directory.readonly
- https://www.googleapis.com/auth/user.addresses.read
- https://www.googleapis.com/auth/user.birthday.read
- https://www.googleapis.com/auth/user.emails.read
- https://www.googleapis.com/auth/user.gender.read
- https://www.googleapis.com/auth/user.organization.read
- https://www.googleapis.com/auth/user.phonenumbers.read
- https://www.googleapis.com/auth/userinfo.email
- https://www.googleapis.com/auth/userinfo.profile
Recupero dei dettagli dell’utente corrente
È stata aggiunta la possibilità di ottenere informazioni sull’utente attualmente autenticato: Google.user.getCurrent(). Per impostazione predefinita, questo metodo restituisce dettagli chiave come il nome e l’indirizzo e-mail dell’utente, ma può essere esteso per includere altri attributi come numeri di telefono, date di nascita e altro ancora.
var $currentUser :=$google.user.getCurrent()
Recuperare tutti i profili e i contatti del dominio
Il comando Google.user.list() consente agli sviluppatori di accedere ai profili della directory o ai contatti del dominio. Include opzioni per filtrare e impaginare i risultati per soddisfare le diverse esigenze delle applicazioni.
var $userList :=$google.user.list()
Ottenere informazioni specifiche sull’utente
Il comando Google.user.get() fornisce informazioni su una persona specifica utilizzando il nome della risorsa. Gli sviluppatori possono specificare quali campi di dati recuperare utilizzando una maschera di campo, consentendo una gestione efficiente dei dati.
var $user :=$google.user.get($userList.users[0].resourceName)
Conclusione
Queste nuove funzioni forniscono agli sviluppatori 4D gli strumenti necessari per recuperare le informazioni sugli utenti di Google. Che si tratti di migliorare l’interfaccia utente o di automatizzare le e-mail, avere un facile accesso ai dati degli utenti è fondamentale per costruire applicazioni migliori.