연락처 위임 관리

이 가이드에서는 Google Workspace 사용자의 연락처 위임자를 생성, 나열, 삭제하는 방법을 설명합니다.

Google Workspace 사용자는 도메인 내 다른 사용자에게 연락처에 액세스하고 관리할 권한을 부여할 수 있습니다. 이러한 위임자는 이름, 전화번호, 주소 등의 정보를 연락처에 추가하고 업데이트할 수 있습니다.

이 가이드는 연락처에 대한 액세스 권한을 위임하기 위한 것입니다. Gmail에 대한 액세스 권한을 위임하려면 이메일 위임 및 공동작업하기를 참고하세요.

기본 요건

연락처 위임 API를 사용하려면 다음 요구사항을 충족해야 합니다.

연락처 공유 사용 설정: 디렉터리 관리자가 관리 콘솔에서 연락처 공유를 사용 설정해야 합니다. 자세한 내용은 연락처 공유 사용 또는 사용 중지하기를 참고하세요.
관리자 권한: 다른 사용자의 위임자를 관리하려면 '연락처' 관리자 권한이 있어야 합니다.
도메인 제한: 동일한 Google Workspace 조직의 사용자 간에만 연락처를 위임할 수 있습니다.
OAuth 범위: 애플리케이션에서 다음 OAuth 범위를 사용해야 합니다. https://www.googleapis.com/auth/admin.contact.delegation.

사용자의 위임자를 만들려면 위임자의 이메일 주소로 POST 요청을 보냅니다.

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

USER_EMAIL을 위임자의 이메일 주소로 바꿉니다.

요청 본문에서 위임자의 이메일 주소를 제공합니다.

{
  "email": "DELEGATE_EMAIL"
}

DELEGATE_EMAIL을 위임자의 이메일 주소로 바꿉니다.

응답에 성공하면 HTTP 200 상태 코드와 새 위임자의 이메일이 반환됩니다.

{
  "email": "DELEGATE_EMAIL"
}

사용자 연락처의 위임자를 나열하려면 해당 사용자의 이메일 주소로 GET 요청을 보냅니다.

GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

USER_EMAIL을 사용자의 이메일 주소로 바꿉니다.

응답에 성공하면 HTTP 200 상태 코드와 위임자 이메일 목록이 반환됩니다.

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

사용자 연락처의 위임자를 삭제하려면 다음 단계를 완료하세요.

위임자 및 위임자 이메일 주소로 DELETE 요청을 보냅니다.

DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL

USER_EMAIL을 위임자의 이메일 주소로, DELEGATE_EMAIL을 위임자의 이메일 주소로 바꿉니다.

응답에 성공하면 HTTP 200 상태 코드가 반환됩니다.