Migrazione da Domain Service ai servizi avanzati di SDK Admin

Il servizio Dominio, che consente agli amministratori di dominio di G Suite di gestire utenti e gruppi, è ritirato a partire dal 15 maggio 2014 e verrà disattivato il 20 novembre 2014. Il servizio viene sostituito dai servizi avanzati Admin SDK Directory e Admin SDK Reports aggiunti di recente. Questa pagina descrive il percorso di migrazione dal servizio Domain al nuovo SDK Admin sostitutivo.

Confronto del metodo

La tabella seguente fornisce una panoramica dei metodi utilizzati nel servizio Domain e dei relativi metodi equivalenti (se presenti) in SDK Admin.

Metodo dei servizi del dominio Metodo SDK Admin
DomainGroup.addMember(memberId) AdminDirectory.Members.insert(resource, groupKey)
In SDK Admin, il ruolo di un membro in un gruppo può essere specificato tramite role.
DomainGroup.addOwner(ownerId)
DomainGroup.deleteGroup() AdminDirectory.Groups.remove(groupKey)
DomainGroup.getAllMembers() AdminDirectory.Members.list(groupKey, optionalArgs)
Nell'SDK Admin, è possibile elencare i proprietari utilizzando il parametro facoltativo roles.
DomainGroup.getAllOwners()
DomainGroup.getDescription() AdminDirectory.Groups.get(groupKey)
Proprietà: description
Proprietà: id
Proprietà: 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)
Proprietà: description
Proprietà: 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)
Proprietà: aliases
Proprietà: primaryEmail
DomainNickname.getUsername()
DomainUser.deleteUser() AdminDirectory.Users.remove(userKey)
DomainUser.getAgreedToTerms() AdminDirectory.Users.get(userKey)
Proprietà: agreedToTerms
Proprietà: changePasswordAtNextLogin
Proprietà: primaryEmail
Proprietà: name.familyName
Proprietà: name.givenName
Proprietà: isAdmin
Proprietà: suspended
DomainUser.getChangePasswordAtNextLogin()
DomainUser.getEmail()
DomainUser.getFamilyName()
DomainUser.getGivenName()
DomainUser.getIsAdmin()
DomainUser.getIsSuspended()
DomainUser.getStorageQuota() AdminReports.UserUsageReport.get(userKey, date, optionalArgs)
Account: total_quota_in_mb
DomainUser.setChangePasswordAtNext Login(changePassword) AdminDirectory.Users.patch(resource, userKey)
Proprietà: changePasswordAtNextLogin
Proprietà: name.familyName
Proprietà: name.givenName
DomainUser.setFamilyName(name)
DomainUser.setGivenName(name)
DomainUser.setIsAdmin(admin) AdminDirectory.Users.makeAdmin(resource, userKey)
Proprietà: isAdmin
DomainUser.setIsSuspended(suspended) AdminDirectory.Users.patch(resource, userKey)
Proprietà: suspended
Proprietà: password
Proprietà: primaryEmail
DomainUser.setPassword(password)
DomainUser.setUsername(username)
GroupsManager.createGroup(groupId, name, description, permissionLevel) GroupsManager.createGroup(groupId, name) AdminDirectory.Groups.insert(resource)
L'impostazione del livello di autorizzazione non è supportata in SDK Admin.
GroupsManager.getAllGroups()
GroupsManager.getAllGroups(memberId)		 AdminDirectory.Groups.list(optionalArgs)
Parametro: userKey
GroupsManager.getDomain()
NicknameManager.getDomain()
UserManager.getDomain() 		N/D
Come soluzione alternativa, ottieni l'indirizzo email di un singolo utente ed estrai il dominio.
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)
Per trovare il nickname, devi scorrere i risultati.
NicknameManager.getNickname(nickname)
UserManager.createUser(username, givenName, familyName, password) UserManager.createUser(username, givenName, familyName, password, passwordHashFunction) AdminDirectory.Users.insert(resource)
Proprietà: hashFunction
UserManager.getAllUsers() AdminDirectory.Users.list(optionalArgs)
È necessario specificare il parametro customer o domain. In qualità di amministratore dell'account, puoi anche utilizzare l'alias my_customer per rappresentare le customerId del tuo account.
UserManager.getUser(user)
UserManager.getUser(username)		 AdminDirectory.Users.get(userKey)

Nuove funzionalità in SDK Admin

Oltre ai metodi supportati descritti sopra, i servizi avanzati di SDK Admin forniscono le seguenti nuove funzionalità:

Funzionalità Classe o metodo SDK Admin
Notifiche per gli amministratori AdminDirectory.Notifications
Password specifiche per le applicazioni AdminDirectory.Asps
Gestione dispositivi AdminDirectory.Chromeosdevices
AdminDirectory.Mobiledevices
Alias di gruppo AdminDirectory.Groups.Aliases
Token OAuth AdminDirectory.Tokens
Unità organizzative AdminDirectory.Orgunits
Report AdminReports
Cerca utenti AdminDirectory.Users.list(optionalArgs)
Parametro: query
Annullare l'eliminazione di utenti AdminDirectory.Users.undelete()
Dati utente AdminDirectory.Users.get(userKey)
Foto dell'utente AdminDirectory.Users.Photos.get(userKey)
Codici di verifica (a 2 fattori) AdminDirectory.VerificationCodes