A capacidade de acessar eficazmente às informações dos usuários do Google é fundamental para criar interfaces de utilizador com capacidade de resposta e automatizar tarefas como o envio de e-mails para vários utilizadores de um domínio. Para satisfazer estes requisitos, introduzimos um conjunto de funcionalidades para obter informações específicas do utilizador e para recuperar todos os perfis e contatos do domínio.
Ligação de conta
Antes de obter informações do utilizador, precisamos de criar um objeto de ligação OAuth 2.0:
var $oAuth2:=cs.NetKit.OAuth2Provider.new($credentials)
var $google:=cs.NetKit.Google.new($oAuth2)
Note-se que podem ser necessários vários âmbitos de aplicação para aceder às informações do utilizador:
- 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/diretory.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
Obter detalhes do utilizador atual
Foi adicionada a capacidade de obter informações sobre o utilizador atualmente autenticado: Google.user.getCurrent(). Por predefinição, este método devolve detalhes importantes, como o nome e o endereço de e-mail do utilizador, mas pode ser alargado para incluir outros atributos, como números de telefone, aniversários e muito mais.
var $currentUser :=$google.user.getCurrent()
Recuperar todos os perfis e contatos do domínio
O comando Google.user.list() permite aos programadores acessar a perfis de diretório ou contatos de domínio. Inclui opções de filtragem e paginação de resultados para se adequar às diferentes necessidades das aplicações.
var $userList :=$google.user.list()
Obter informações específicas do utilizador
O comando Google.user.get() fornece informações sobre uma pessoa específica utilizando o seu nome de recurso. Os programadores podem especificar quais os campos de dados a recuperar utilizando uma máscara de campo, permitindo um tratamento de dados eficiente.
var $user :=$google.user.get($userList.users[0].resourceName)
Conclusão
Estas novas funcionalidades dão aos desenvolvedores 4D as ferramentas necessárias para obter informação do utilizador Google. Quer esteja a trabalhar para melhorar a interface do utilizador ou automatizar emails, ter acesso fácil aos dados do utilizador é a chave para construir melhores aplicações.