Como migrar do serviço de domínio para o Advanced Services do SDK Admin

O serviço de domínio, que permite aos administradores de domínio do G Suite gerenciar usuários e grupos, foi descontinuado em 15 de maio de 2014 e será desativado em 20 de novembro de 2014. O serviço foi substituído pelos serviços avançados Diretório do SDK Admin e Relatórios do SDK Admin adicionados recentemente. Nesta página, descrevemos o caminho de migração do serviço de domínio para a nova substituição, o SDK Admin.

Comparação de métodos

A tabela abaixo fornece uma visão geral dos métodos usados no serviço de domínio e dos métodos equivalentes (se houver) no SDK Admin.

Método dos serviços de domínio Método do SDK Admin
DomainGroup.addMember(memberId) AdminDirectory.Members.insert(resource, groupKey)
No SDK Admin, é possível especificar o papel de um membro em um grupo usando role.
DomainGroup.addOwner(ownerId)
DomainGroup.deleteGroup() AdminDirectory.Groups.remove(groupKey)
DomainGroup.getAllMembers() AdminDirectory.Members.list(groupKey, optionalArgs)
No SDK Admin, os proprietários podem ser listados usando o parâmetro opcional roles.
DomainGroup.getAllOwners()
DomainGroup.getDescription() AdminDirectory.Groups.get(groupKey)
Propriedade: description
Propriedade: id
Propriedade: name
DomainGroup.getId()
DomainGroup.getName()
DomainGroup.getPermissionLevel() N/A
DomainGroup.removeMember(memberId) AdminDirectory.Members.remove(groupKey, memberKey)
DomainGroup.removeOwner(ownerId)
DomainGroup.setDescription(description) AdminDirectory.Groups.patch(resource, groupKey)
Propriedade: description
Propriedade: name
DomainGroup.setName(name)
DomainGroup.setPermissionLevel(level) N/A
DomainNickname.deleteNickname() AdminDirectory.Users.Aliases.remove(userKey, alias)
DomainNickname.getNickname() AdminDirectory.Users.Aliases.list(userKey, optionalArgs)
Propriedade: aliases
Propriedade: primaryEmail
DomainNickname.getUsername()
DomainUser.deleteUser() AdminDirectory.Users.remove(userKey)
DomainUser.getAgreedToTerms() AdminDirectory.Users.get(userKey)
Propriedade: agreedToTerms
Propriedade: changePasswordAtNextLogin
Propriedade: primaryEmail
Propriedade: name.familyName
Propriedade: name.givenName
Propriedade: isAdmin
Propriedade: suspended
DomainUser.getChangePasswordAtNextLogin()
DomainUser.getEmail()
DomainUser.getFamilyName()
DomainUser.getGivenName()
DomainUser.getIsAdmin()
DomainUser.getIsSuspended()
DomainUser.getStorageQuota() AdminReports.UserUsageReport.get(userKey, date, optionalArgs)
Conta: total_quota_in_mb
DomainUser.setChangePasswordAtNext Login(changePassword) AdminDirectory.Users.patch(resource, userKey)
Propriedade: changePasswordAtNextLogin
Propriedade: name.familyName
Propriedade: name.givenName
DomainUser.setFamilyName(name)
DomainUser.setGivenName(name)
DomainUser.setIsAdmin(admin) AdminDirectory.Users.makeAdmin(resource, userKey)
Propriedade: isAdmin
DomainUser.setIsSuspended(suspended) AdminDirectory.Users.patch(resource, userKey)
Propriedade: suspended
Propriedade: password
Propriedade: primaryEmail
DomainUser.setPassword(password)
DomainUser.setUsername(username)
GroupsManager.createGroup(groupId, name, description, permissionLevel) GroupsManager.createGroup(groupId, name) AdminDirectory.Groups.insert(resource)
Não é possível definir o nível de permissão no SDK Admin.
GroupsManager.getAllGroups()
GroupsManager.getAllGroups(memberId)
AdminDirectory.Groups.list(optionalArgs)
Parâmetro: userKey
GroupsManager.getDomain()
NicknameManager.getDomain()
UserManager.getDomain()
N/A
Como solução alternativa, extraia o endereço de e-mail de um único usuário e extraia o domínio.
GroupsManager.getGroup(groupId) AdminDirectory.Groups.get(groupKey)
NicknameManager.createNickname(username, nickname) AdminDirectory.Users.Aliases.insert(resource, userKey)
NicknameManager.getAllNicknames() N/A
NicknameManager.getAllNicknames(username) AdminDirectory.Users.Aliases.list(userKey, optionalArgs)
Será necessário percorrer os resultados para encontrar o apelido.
NicknameManager.getNickname(nickname)
UserManager.createUser(username, givenName, familyName, password) UserManager.createUser(username, givenName, familyName, password, passwordHashFunction) AdminDirectory.Users.insert(resource)
Propriedade: hashFunction
UserManager.getAllUsers() AdminDirectory.Users.list(optionalArgs)
É necessário fornecer o parâmetro customer ou domain. Como administrador da conta, também é possível usar o alias my_customer para representar o customerId da sua conta.
UserManager.getUser(user)
UserManager.getUser(username)
AdminDirectory.Users.get(userKey)

Novos recursos no SDK Admin

Além dos métodos compatíveis descritos acima, os serviços avançados do SDK Admin oferecem os seguintes novos recursos:

Recurso Classe ou método do SDK Admin
Notificações do administrador AdminDirectory.Notifications
Senhas específicas do aplicativo AdminDirectory.Asps
Gerenciamento de dispositivos AdminDirectory.Chromeosdevices
AdminDirectory.Mobiledevices
Aliases de grupo AdminDirectory.Groups.Aliases
Tokens OAuth AdminDirectory.Tokens
Unidades organizacionais AdminDirectory.Orgunits
Relatórios AdminReports
Pesquisar usuários AdminDirectory.Users.list(optionalArgs)
Parâmetro: query
Cancelar exclusão de usuários AdminDirectory.Users.undelete()
Dados do usuário AdminDirectory.Users.get(userKey)
Foto do usuário AdminDirectory.Users.Photos.get(userKey)
Códigos de verificação (dois fatores) AdminDirectory.VerificationCodes