사용자 별칭 만들기
사용자의 별칭은 사용자의 기본 이메일 주소여야 합니다. 사용자 별칭은 해당 도메인이 아닌 다른 계정 도메인과 연결될 수 있습니다. 사용자의 기본 이메일 주소에서 사용하는 도메인입니다. 24시간 이내 (일반적으로 더 빨리) 사용자가 시작 이 주소로 전송된 이메일을 수신합니다. API를 사용하려면 도메인 소유권 확인 해야 사용자 별칭을 만들 수 있습니다.
사용자 별칭을 만들려면 다음 POST
요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. userKey
은 사용자의 기본 이메일 주소, 사용자 id
또는 사용자 별칭일 수 있습니다. 이메일 요청 및 응답 속성은 API 참조를 확인하세요.
POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
JSON 요청
다음 JSON 요청은 사용자 별칭을 만들기 위한 샘플 요청을 보여줍니다. 사용자는 liz@example.com이고 별칭은 Chica@example.com입니다.
POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
{ "alias": "chica@example.com" }
성공 응답은 HTTP 201 상태 코드를 반환합니다. 응답은 상태 코드와 함께 새 사용자 별칭의 속성을 반환합니다.
사용자의 모든 별칭 검색
모든 도메인에서 사용자 별칭을 모두 검색하려면 다음 GET
요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. userKey
은 사용자의 기본 이메일 주소, 사용자 id
또는 사용자 별칭일 수 있습니다. 이메일 요청 및 응답 속성은 API 참조를 확인하세요.
GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
모든 사용자 별칭은 알파벳순으로 반환됩니다. '모든 별칭 검색'에는 maxResults
쿼리 문자열이나 페이지로 나누기와 같은 페이지 크기가 없습니다. 있습니다.
JSON 응답
성공 응답은 HTTP 200 상태 코드를 반환합니다. 응답은 상태 코드와 함께 사용자의 별칭을 알파벳순으로 반환합니다. 이러한 별칭 도메인은 기본 도메인 및 계정의 기타 여러 도메인입니다.
{ "kind": "directory#user#aliases", "aliases": [ { "kind": "directory#user#alias", "id": "the unique user id", "primary_email": "liz@example.com", "alias": "chica@example.com" }, { "kind": "directory#user#alias", "id": "the unique user id", "primary_email": "liz@example.com", "alias": "support@example.com" }, { "kind": "directory#user#alias", "id": "the unique user id", "primary_email": "liz@example.com", "alias": "help@hr.example.com" }, { "kind": "directory#user#alias", "id": "the unique user id", "primary_email": "liz@example.com", "alias": "tickets@jumboinc.com" } ] }
사용자 별칭 삭제하기
사용자 별칭을 삭제하려면 다음 DELETE
요청을 사용하고
승인에 설명되어 있습니다.
요청을 승인합니다. 최대
24시간 내에 별칭이 삭제됩니다. 이
userKey
는 사용자의 기본 이메일 주소, 사용자 id
또는 다음 중 하나일 수 있습니다.
사용자 별칭의 이메일 aliasId
는 별칭임 사용 중인 이메일 주소와
이(가) 삭제되었습니다. 요청 및 응답 속성은
API 참조
DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
DELETE
요청은 userKey의 liz@example.com에 대한 Chica@example.com 별칭을 삭제합니다.
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com
성공 응답은 HTTP 200 상태 코드를 반환합니다.