Esta página foi traduzida pela API Cloud Translation.

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)`	`AdminDirectory.Members.remove(groupKey, memberKey)`
`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`