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. Der Dienst 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

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

Methode „Domainservices“ 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 Parameter roles aufgelistet 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)
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)
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)
Attribut: 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() 		Nicht zutreffend
Als Workaround 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 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 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
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