이 문서에서는 Gmail API를 사용하여 이메일을 위임하고 공동작업하는 방법을 설명합니다.
Gmail 사용자는 동일한 Google Workspace 조직에 속한 하나 이상의 사용자에게 편지함 액세스 권한을 부여할 수 있습니다. 액세스 권한을 부여하는 사용자는 위임자이고 액세스 권한을 받는 사용자는 위임받은 사용자입니다.
대리인은 내 계정에서 이메일 메시지를 읽고, 보내고, 삭제할 수 있습니다. 또한 연락처를 조회하고 추가할 수도 있습니다. 대리인이 내 계정에서 메일을 보내면 대리인의 이메일 주소가 표시됩니다. 자세한 내용은 이메일 위임 및 공동작업하기를 참고하세요.
Google Workspace 조직은 settings.delegates 리소스를 사용하여 조직 내 Gmail 계정의 대리인을 관리할 수 있습니다. 이를 위해서는 도메인 전체 권한이 위임된 서비스 계정이 필요합니다.
위임된 사용자는 이메일 별칭이 아닌 기본 이메일 주소로 참조해야 합니다. Gmail은 Google Workspace 조직의 사용자별 대리인 수를 최대 25명으로 제한합니다.
settings.delegates 리소스에는 위임을 생성하거나 나열하거나 가져오기하거나 삭제하는 방법에 관한 자세한 정보가 포함되어 있습니다.
settings.delegates 리소스에는 이메일 주소의 소유권이 위임을 위해 확인되었는지 여부를 나타내는 VerificationStatus 객체가 포함됩니다.
settings.delegates.create 메서드를 사용하여 위임자를 만들면 확인 이메일을 보내지 않고 verificationStatus 필드가 accepted로 설정됩니다.