Von Domain Service zu Admin SDK Advanced Services migrieren

Der Domaindienst, mit dem G Suite-Domainadministratoren Nutzer und Gruppen verwalten können, wurde am 15. Mai 2014 eingestellt und am 20. November 2014 deaktiviert. Der Dienst wird durch die kürzlich hinzugefügten Dienste Admin SDK Directory und Admin SDK Reports ersetzt. Auf dieser Seite wird der Migrationspfad vom Domaindienst zum neuen Ersatzdienst Admin SDK beschrieben.

Methodenvergleich

Die folgende Tabelle bietet einen Überblick über die im Domain-Dienst verwendeten Methoden und die entsprechenden Methoden (falls vorhanden) im Admin SDK.

Methode für Domaindienste Admin SDK-Methode
DomainGroup.addMember(memberId) AdminDirectory.Members.insert(resource, groupKey)
Im Admin SDK kann die Rolle eines Mitglieds in einer Gruppe über role angegeben werden.
DomainGroup.addOwner(ownerId)
DomainGroup.deleteGroup() AdminDirectory.Groups.remove(groupKey)
DomainGroup.getAllMembers() AdminDirectory.Members.list(groupKey, optionalArgs)
Im Admin SDK können Inhaber mithilfe des optionalen Parameters roles aufgeführt werden.
DomainGroup.getAllOwners()
DomainGroup.getDescription() AdminDirectory.Groups.get(groupKey)
Property: description
Property: id
Property: name
DomainGroup.getId()
DomainGroup.getName()
DomainGroup.getPermissionLevel()
DomainGroup.removeMember(memberId) AdminDirectory.Members.remove(groupKey, memberKey)
DomainGroup.removeOwner(ownerId)
DomainGroup.setDescription(description) AdminDirectory.Groups.patch(resource, groupKey)
Property: description
Property: name
DomainGroup.setName(name)
DomainGroup.setPermissionLevel(level)
DomainNickname.deleteNickname() AdminDirectory.Users.Aliases.remove(userKey, alias)
DomainNickname.getNickname() AdminDirectory.Users.Aliases.list(userKey, optionalArgs)
Property: aliases
Property: primaryEmail
DomainNickname.getUsername()
DomainUser.deleteUser() AdminDirectory.Users.remove(userKey)
DomainUser.getAgreedToTerms() AdminDirectory.Users.get(userKey)
Property: agreedToTerms
Property: changePasswordAtNextLogin
Property: primaryEmail
Property: name.familyName
Property: name.givenName
Property: isAdmin
Property: suspended
DomainUser.getChangePasswordAtNextLogin()
DomainUser.getEmail()
DomainUser.getFamilyName()
DomainUser.getGivenName()
DomainUser.getIsAdmin()
DomainUser.getIsSuspended()
DomainUser.getStorageQuota() AdminReports.UserUsageReport.get(userKey, date, optionalArgs)
Konto: total_quota_in_mb
DomainUser.setChangePasswordAtNext Login(changePassword) AdminDirectory.Users.patch(resource, userKey)
Property: changePasswordAtNextLogin
Property: name.familyName
Property: name.givenName
DomainUser.setFamilyName(name)
DomainUser.setGivenName(name)
DomainUser.setIsAdmin(admin) AdminDirectory.Users.makeAdmin(resource, userKey)
Property: isAdmin
DomainUser.setIsSuspended(suspended) AdminDirectory.Users.patch(resource, userKey)
Property: suspended
Property: password
Property: primaryEmail
DomainUser.setPassword(password)
DomainUser.setUsername(username)
GroupsManager.createGroup(groupId, name, description, permissionLevel) GroupsManager.createGroup(groupId, name) AdminDirectory.Groups.insert(resource)
Das Festlegen der Berechtigungsstufe wird im Admin SDK nicht unterstützt.
GroupsManager.getAllGroups()
GroupsManager.getAllGroups(memberId)
AdminDirectory.Groups.list(optionalArgs)
Parameter: userKey
GroupsManager.getDomain()
NicknameManager.getDomain()
UserManager.getDomain()

Sie können das Problem umgehen, indem Sie die E-Mail-Adresse eines einzelnen Nutzers abrufen und die Domain extrahieren.
GroupsManager.getGroup(groupId) AdminDirectory.Groups.get(groupKey)
NicknameManager.createNickname(username, nickname) AdminDirectory.Users.Aliases.insert(resource, userKey)
NicknameManager.getAllNicknames()
NicknameManager.getAllNicknames(username) AdminDirectory.Users.Aliases.list(userKey, optionalArgs)
Sie müssen die Ergebnisse durchgehen, um den Alias zu finden.
NicknameManager.getNickname(nickname)
UserManager.createUser(username, givenName, familyName, password) UserManager.createUser(username, givenName, familyName, password, passwordHashFunction) AdminDirectory.Users.insert(resource)
Property: hashFunction
UserManager.getAllUsers() AdminDirectory.Users.list(optionalArgs)
Der Parameter customer oder domain muss angegeben werden. Als Kontoadministrator können Sie auch den Alias my_customer verwenden, um die customerId Ihres Kontos darzustellen.
UserManager.getUser(user)
UserManager.getUser(username)
AdminDirectory.Users.get(userKey)

Neue Funktionen im Admin SDK

Zusätzlich zu den oben beschriebenen unterstützten Methoden bieten die erweiterten Admin SDK-Dienste die folgenden neuen Funktionen:

Funktion Admin SDK-Klasse oder -Methode
Administratorbenachrichtigungen AdminDirectory.Notifications
Anwendungsspezifische Passwörter AdminDirectory.Asps
Geräteverwaltung AdminDirectory.Chromeosdevices
AdminDirectory.Mobiledevices
Gruppenaliasse AdminDirectory.Groups.Aliases
OAuth-Tokens AdminDirectory.Tokens
Organisationseinheiten AdminDirectory.Orgunits
Berichte AdminReports
Nach Nutzern suchen AdminDirectory.Users.list(optionalArgs)
Parameter: query
Nutzer wiederherstellen AdminDirectory.Users.undelete()
Nutzerdaten AdminDirectory.Users.get(userKey)
Nutzerfoto AdminDirectory.Users.Photos.get(userKey)
Bestätigungscodes (2-Faktor) AdminDirectory.VerificationCodes