Domain Service から Admin SDK Advanced Services に移行する

ドメイン サービス（Google Workspace 管理者がユーザーとグループを管理できるサービス）は、2014 年 5 月 15 日に非推奨となり、2014 年 11 月 20 日に提供を終了しました。このサービスは、Admin SDK Directory と Admin SDK Reports の高度な サービスに置き換えられました。このページでは、ドメイン サービスから 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 パラメータのいずれかを指定する必要があります。アカウント管理者は、アカウントの customerId を表す my_customer エイリアスを使用することもできます。
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)
確認コード（2 要素） AdminDirectory.VerificationCodes