Migrer du service de domaine vers les services avancés du SDK Admin

Le service de domaine, qui permet aux administrateurs de domaines G Suite de gérer les utilisateurs et les groupes, est obsolète depuis le 15 mai 2014 et sera désactivé le 20 novembre 2014. Il est remplacé par les services avancés Annuaire du SDK Admin et Rapports du SDK Admin récemment ajoutés. Cette page décrit le processus de migration du service de domaine vers son nouveau SDK Admin de remplacement.

Comparaison des méthodes

Le tableau ci-dessous présente les méthodes utilisées dans le service de domaine et leurs méthodes équivalentes (le cas échéant) dans le SDK Admin.

Méthode des services de domaine Méthode SDK Admin
DomainGroup.addMember(memberId) AdminDirectory.Members.insert(resource, groupKey)
Dans le SDK Admin, le rôle d'un membre dans un groupe peut être spécifié via role.
DomainGroup.addOwner(ownerId)
DomainGroup.deleteGroup() AdminDirectory.Groups.remove(groupKey)
DomainGroup.getAllMembers() AdminDirectory.Members.list(groupKey, optionalArgs)
Dans le SDK Admin, vous pouvez lister les propriétaires à l'aide du paramètre facultatif roles.
DomainGroup.getAllOwners()
DomainGroup.getDescription() AdminDirectory.Groups.get(groupKey)
Propriété : description
Propriété : id
Propriété : 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)
Propriété : description
Propriété: 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)
Propriété : aliases
Propriété : primaryEmail
DomainNickname.getUsername()
DomainUser.deleteUser() AdminDirectory.Users.remove(userKey)
DomainUser.getAgreedToTerms() AdminDirectory.Users.get(userKey)
Propriété : agreedToTerms
Propriété : changePasswordAtNextLogin
Propriété : primaryEmail
Propriété : name.familyName
Propriété : name.givenName
Propriété : isAdmin
Propriété : suspended
DomainUser.getChangePasswordAtNextLogin()
DomainUser.getEmail()
DomainUser.getFamilyName()
DomainUser.getGivenName()
DomainUser.getIsAdmin()
DomainUser.getIsSuspended()
DomainUser.getStorageQuota() AdminReports.UserUsageReport.get(userKey, date, optionalArgs)
Compte : total_quota_in_mb
DomainUser.setChangePasswordAtNext Login(changePassword) AdminDirectory.Users.patch(resource, userKey)
Propriété : changePasswordAtNextLogin
Propriété : name.familyName
Propriété : name.givenName
DomainUser.setFamilyName(name)
DomainUser.setGivenName(name)
DomainUser.setIsAdmin(admin) AdminDirectory.Users.makeAdmin(resource, userKey)
Propriété : isAdmin
DomainUser.setIsSuspended(suspended) AdminDirectory.Users.patch(resource, userKey)
Propriété : suspended
Propriété : password
Propriété : primaryEmail
DomainUser.setPassword(password)
DomainUser.setUsername(username)
GroupsManager.createGroup(groupId, name, description, permissionLevel) GroupsManager.createGroup(groupId, name) AdminDirectory.Groups.insert(resource)
Le SDK Admin ne permet pas de définir le niveau d'autorisation.
GroupsManager.getAllGroups()
GroupsManager.getAllGroups(memberId)
AdminDirectory.Groups.list(optionalArgs)
Paramètre : userKey
GroupsManager.getDomain()
NicknameManager.getDomain()
UserManager.getDomain()
N/A
Pour contourner ce problème, récupérez l'adresse e-mail d'un seul utilisateur et extrayez le domaine.
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)
Vous devrez parcourir les résultats en boucle pour trouver le pseudo.
NicknameManager.getNickname(nickname)
UserManager.createUser(username, givenName, familyName, password) UserManager.createUser(username, givenName, familyName, password, passwordHashFunction) AdminDirectory.Users.insert(resource)
Propriété : hashFunction
UserManager.getAllUsers() AdminDirectory.Users.list(optionalArgs)
Vous devez indiquer le paramètre customer ou domain. En tant qu'administrateur de compte, vous pouvez également utiliser l'alias my_customer pour représenter le customerId de votre compte.
UserManager.getUser(user)
UserManager.getUser(username)
AdminDirectory.Users.get(userKey)

Nouvelles fonctionnalités du SDK Admin

En plus des méthodes compatibles décrites ci-dessus, les services avancés du SDK Admin offrent les nouvelles fonctionnalités suivantes:

Caractéristique Classe ou méthode SDK Admin
Notifications pour les administrateurs AdminDirectory.Notifications
Mots de passe spécifiques à des applications AdminDirectory.Asps
Gestion des appareils AdminDirectory.Chromeosdevices
AdminDirectory.Mobiledevices
Alias de groupe AdminDirectory.Groups.Aliases
Jetons OAuth AdminDirectory.Tokens
Unités organisationnelles AdminDirectory.Orgunits
Reporting AdminReports
Rechercher des utilisateurs AdminDirectory.Users.list(optionalArgs)
Paramètre: query
Annuler la suppression de comptes utilisateur AdminDirectory.Users.undelete()
Données utilisateur AdminDirectory.Users.get(userKey)
Photo de l'utilisateur AdminDirectory.Users.Photos.get(userKey)
Codes de validation (deux facteurs) AdminDirectory.VerificationCodes