從網域服務遷移至 Admin SDK Advanced Services

允許 G Suite 網域管理員管理使用者和群組的網域網域服務已於 2014 年 5 月 15 日淘汰,並於 2014 年 11 月 20 日關閉。這項服務已由近期新增的 Admin SDK DirectoryAdmin SDK 報表進階服務取代。本頁概述從網域服務遷移至新替換 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)
資源: aliases
資源: 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)
Admin 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