Migrar do serviço de domínio para os serviços avançados do SDK Admin

O serviço de domínio, que permite que os administradores do Google Workspace gerenciem usuários e grupos, foi descontinuado em 15 de maio de 2014, e desativado em 20 de novembro de 2014. Ele foi substituído pelos serviços avançados do SDK Admin Directory e do SDK Admin Reports. Esta página descreve o caminho de migração do serviço de domínio para o SDK Admin.

Comparação de métodos

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

Método do serviço de domínio Método do SDK Admin
DomainGroup.addMember(memberId) AdminDirectory.Members.insert(resource, groupKey)
No SDK Admin, o papel de um participante em um grupo pode ser especificado 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)
A definição do nível de permissão não é compatível com o 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, receba 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)
Você precisará 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)
O parâmetro customer ou o domain precisa ser fornecido. Como administrador da conta, você também pode usar o alias my_customer para representar o customerId da sua conta.
UserManager.getUser(user)
UserManager.getUser(username)
AdminDirectory.Users.get(userKey)

Novos recursos do SDK Admin

Além dos métodos compatíveis descritos na seção anterior, 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
Restaurar usuários excluídos 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 (2 fatores) AdminDirectory.VerificationCodes