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

允許 G Suite 網域管理員管理使用者和群組的網域網域服務已於 2014 年 5 月 15 日淘汰，並於 2014 年 11 月 20 日關閉。這項服務已由近期新增的 Admin SDK Directory 和 Admin 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