Mail Admin Quarantine API를 호출하기 전에 이 페이지의 단계를 완료하여 API를 사용 설정하고, 모든 요청에 필요한 식별자를 찾고, Google Workspace 계정에 필요한 관리자 권한을 부여하세요.
기본 요건
- 관리자 스팸 격리 저장소 기능이 있는 Google Workspace 계정 자세한 내용은 이메일 스팸 격리 저장소 설정 및 관리하기를 참고하세요.
- Google Cloud 프로젝트 프로젝트를 만들려면 프로젝트 만들기를 참조하세요.
- Google Workspace 개발자 프리뷰 프로그램 멤버십 관리 격리 API를 호출하려면 먼저 Cloud 프로젝트가 프로그램에 등록되어 있어야 합니다.
- 관리자 권한을 부여하고 도메인 전체 위임을 승인하기 위해 최고 관리자로 Google 관리 콘솔에 액세스합니다.
API 사용 설정
통합을 호스팅하는 Cloud 프로젝트에서 mailadminquarantine.googleapis.com를 사용 설정합니다.
콘솔
Google Cloud 콘솔에서 Mail Admin Quarantine API를 사용 설정합니다.
gcloud
다음 명령어를 실행하여 PROJECT_ID를 Cloud 프로젝트 ID로 바꿉니다.
gcloud services enable mailadminquarantine.googleapis.com \
--project=PROJECT_ID
고객 ID 찾아보기
Admin Quarantine API에 대한 모든 요청은 customers/CUSTOMER_ID 리소스 이름으로 Google Workspace 계정을 식별합니다.
고객 ID를 찾는 방법은 다음과 같습니다.
- 관리자로 관리 콘솔에 로그인합니다.
- 계정 > 계정 설정 > 프로필로 이동합니다.
- 고객 ID를 복사합니다.
고객 ID가 C로 시작하는 경우 C를 삭제하고 리소스 이름에 나머지 영숫자 값을 사용합니다(예: customers/01abc23de).
도메인 이름을 고객 ID로 사용하지 마세요.
자세한 내용은 고객 ID 찾기를 참조하세요.
필수 관리자 권한 부여
Admin Quarantine API는 관리 콘솔의 관리자 스팸 격리와 동일한 관리자 권한 검사를 시행합니다. 모든 요청은 Google Workspace 관리자를 대신하여 실행되며 해당 관리자는 다음 Gmail 권한 중 하나를 보유해야 합니다.
| 프리빌리지 | 허용되는 작업 |
|---|---|
| 관리 스팸 격리 저장소 액세스 | 기본 스팸 격리 저장소를 포함한 모든 스팸 격리 저장소의 메일에 액세스하고 관리합니다. |
| 제한된 스팸 격리 저장소에 액세스 | 관리자가 속한 그룹과 관련된 스팸 격리 저장소의 메일만 액세스하고 관리합니다. |
최고 관리자에게는 이러한 권한이 자동으로 부여됩니다. 다른 관리자의 경우 해당 권한이 포함된 역할을 할당합니다.
- 최고 관리자로 관리 콘솔에 로그인합니다.
- 계정 > 관리자 역할로 이동합니다.
- 기존 역할을 선택하거나 새 역할 만들기를 클릭합니다.
- 권한 탭에서 서비스 > Gmail로 이동하여 관리 스팸 격리 저장소 액세스 또는 제한된 스팸 격리 저장소에 액세스를 선택합니다.
- API를 호출할 때 통합이 가장하는 관리자 계정에 역할을 할당합니다.
위임된 관리자 역할에 대한 자세한 내용은 Gmail에서 관리자 권한 위임하기 및 관리자 권한 정의를 참고하세요.
명의 도용된 관리자에게 필요한 권한이 없으면 API가 403 PERMISSION_DENIED 오류를 반환합니다.