從 Domain Service 遷移至 Admin SDK Advanced Services

網域服務可供 Google Workspace 管理員管理使用者和群組，但已於 2014 年 5 月 15 日終止支援，並於 2014 年 11 月 20 日關閉。這項服務已由 Admin SDK Directory 和 Admin SDK Reports 進階服務取代。本頁說明從 Domain 服務遷移至 Admin SDK 的路徑。

方法比較

下表概述網域服務中使用的所有方法，以及 Admin SDK 中對應的方法 (如有)。

網域服務方法 Admin SDK 方法
DomainGroup.addMember(memberId) AdminDirectory.Members.insert(resource, groupKey)
在 Admin SDK 中，可以透過 role 指定成員在群組中的角色。
DomainGroup.addOwner(ownerId)
DomainGroup.deleteGroup() AdminDirectory.Groups.remove(groupKey)
DomainGroup.getAllMembers() AdminDirectory.Members.list(groupKey, optionalArgs)
在 Admin SDK 中，可以使用選用的 roles 參數列出擁有者。
DomainGroup.getAllOwners()
DomainGroup.getDescription() AdminDirectory.Groups.get(groupKey)
屬性： description
屬性： id
屬性： 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)
屬性： description
屬性： 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)
屬性： agreedToTerms
屬性： changePasswordAtNextLogin
屬性： primaryEmail
屬性： name.familyName
屬性： name.givenName
屬性： isAdmin
屬性： suspended
DomainUser.getChangePasswordAtNextLogin()
DomainUser.getEmail()
DomainUser.getFamilyName()
DomainUser.getGivenName()
DomainUser.getIsAdmin()
DomainUser.getIsSuspended()
DomainUser.getStorageQuota() AdminReports.UserUsageReport.get(userKey, date, optionalArgs)
帳戶： total_quota_in_mb
DomainUser.setChangePasswordAtNext Login(changePassword) AdminDirectory.Users.patch(resource, userKey)
屬性： changePasswordAtNextLogin
屬性： name.familyName
屬性： name.givenName
DomainUser.setFamilyName(name)
DomainUser.setGivenName(name)
DomainUser.setIsAdmin(admin) AdminDirectory.Users.makeAdmin(resource, userKey)
屬性： isAdmin
DomainUser.setIsSuspended(suspended) AdminDirectory.Users.patch(resource, userKey)
屬性： suspended
屬性： password
屬性： primaryEmail
DomainUser.setPassword(password)
DomainUser.setUsername(username)
GroupsManager.createGroup(groupId, name, description, permissionLevel) GroupsManager.createGroup(groupId, name) AdminDirectory.Groups.insert(resource)
管理員 SDK 不支援設定權限層級。
GroupsManager.getAllGroups()
GroupsManager.getAllGroups(memberId)		 AdminDirectory.Groups.list(optionalArgs)
參數： userKey
GroupsManager.getDomain()
NicknameManager.getDomain()
UserManager.getDomain() 		不適用
如要解決這個問題，請取得單一使用者的電子郵件地址，並擷取網域。
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)
您需要逐一查看結果，找出暱稱。
NicknameManager.getNickname(nickname)
UserManager.createUser(username, givenName, familyName, password) UserManager.createUser(username, givenName, familyName, password, passwordHashFunction) AdminDirectory.Users.insert(resource)
屬性： hashFunction
UserManager.getAllUsers() AdminDirectory.Users.list(optionalArgs)
必須提供 customer 或 domain 參數。身為帳戶管理員，您也可以使用 my_customer 別名來代表帳戶的 customerId。
UserManager.getUser(user)
UserManager.getUser(username)		 AdminDirectory.Users.get(userKey)

Admin SDK 的新功能

除了前一節所述的支援方法，Admin SDK 進階服務還提供下列新功能：

功能 Admin SDK 類別或方法
管理員通知 AdminDirectory.Notifications
應用程式專用密碼 AdminDirectory.Asps
裝置管理 AdminDirectory.Chromeosdevices
AdminDirectory.Mobiledevices
群組別名 AdminDirectory.Groups.Aliases
OAuth 權杖 AdminDirectory.Tokens
機構單位 AdminDirectory.Orgunits
報表 AdminReports
搜尋使用者 AdminDirectory.Users.list(optionalArgs)
參數： query
取消刪除使用者 AdminDirectory.Users.undelete()
使用者資料 AdminDirectory.Users.get(userKey)
使用者相片 AdminDirectory.Users.Photos.get(userKey)
驗證碼 (雙重驗證) AdminDirectory.VerificationCodes