도메인 서비스에서 Admin SDK 고급 서비스로 이전

Google Workspace 관리자가 사용자 및 그룹을 관리할 수 있는 도메인 서비스는 2014년 5월 15일에 지원 중단되었으며 2014년 11월 20일에 사용 중지되었습니다. 이 서비스는 Admin SDK 디렉터리 및 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)
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)
속성: 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)
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)
계정: 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)
Property: 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)
관리 SDK에서는 권한 수준 설정이 지원되지 않습니다.
GroupsManager.getAllGroups()
GroupsManager.getAllGroups(memberId)		 AdminDirectory.Groups.list(optionalArgs)
Parameter: 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)
Property: 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)
인증 코드 (2단계) AdminDirectory.VerificationCodes