Von Domain Service zu den Admin SDK Advanced Services migrieren

Der Domain-Dienst, mit dem Google Workspace-Administratoren Nutzer und Gruppen verwalten können, wurde am 15. Mai 2014 eingestellt, und am 20. November 2014 deaktiviert. Er wird durch die erweiterten Dienste Admin SDK Directory und Admin SDK Reports ersetzt. Auf dieser Seite wird der Migrationspfad vom Domain-Dienst zum Admin SDK beschrieben.

Methodenvergleich

In der folgenden Tabelle finden Sie eine Übersicht der Methoden, die im Domain-Dienst verwendet werden, und der entsprechenden Methoden im Admin SDK.

Domain-Dienstmethode 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 mit dem optionalen roles Parameter aufgeführt werden.
DomainGroup.getAllOwners()
DomainGroup.getDescription() AdminDirectory.Groups.get(groupKey)
Attribut: description
Attribut: id
Attribut: 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)
Attribut: description
Attribut: name
DomainGroup.setName(name)
DomainGroup.setPermissionLevel(level) –
DomainNickname.deleteNickname() AdminDirectory.Users.Aliases.remove(userKey, alias)
DomainNickname.getNickname() AdminDirectory.Users.Aliases.list(userKey, optionalArgs)
Attribut: aliases
Attribut: primaryEmail
DomainNickname.getUsername()
DomainUser.deleteUser() AdminDirectory.Users.remove(userKey)
DomainUser.getAgreedToTerms() AdminDirectory.Users.get(userKey)
Attribut: agreedToTerms
Attribut: changePasswordAtNextLogin
Attribut: primaryEmail
Attribut: name.familyName
Attribut: name.givenName
Attribut: isAdmin
Attribut: 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)
Attribut: changePasswordAtNextLogin
Attribut: name.familyName
Attribut: name.givenName
DomainUser.setFamilyName(name)
DomainUser.setGivenName(name)
DomainUser.setIsAdmin(admin) AdminDirectory.Users.makeAdmin(resource, userKey)
Attribut: isAdmin
DomainUser.setIsSuspended(suspended) AdminDirectory.Users.patch(resource, userKey)
Attribut: suspended
Attribut: password
Attribut: 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() 		N/A
Als Problemumgehung können 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 durchlaufen, 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)
Attribut: hashFunction
UserManager.getAllUsers() AdminDirectory.Users.list(optionalArgs)
Es muss entweder der Parameter customer oder der domain 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 im vorherigen Abschnitt beschriebenen unterstützten Methoden bieten die erweiterten Dienste des Admin SDK die folgenden neuen Funktionen:

Funktion Admin SDK-Klasse oder -Methode
Admin-Benachrichtigungen 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
Löschung von Nutzern rückgängig machen AdminDirectory.Users.undelete()
Nutzerdaten AdminDirectory.Users.get(userKey)
Nutzerfoto AdminDirectory.Users.Photos.get(userKey)
Bestätigungscodes (2‑Faktor-Authentifizierung) AdminDirectory.VerificationCodes