읽기 전용입니다. 그룹의 고유 ID입니다. 그룹 id는 그룹 요청 URI의 groupKey로 사용할 수 있습니다.
email
string
그룹의 이메일 주소입니다. 계정에 여러 도메인이 있는 경우 이메일 주소에 적절한 도메인을 선택합니다. email은 고유해야 합니다. 이 속성은 그룹을 만들 때 필요합니다. 그룹 이메일 주소에는 사용자 이름과 동일한 문자 사용 규칙이 적용됩니다. 자세한 내용은 고객센터를 참고하세요.
name
string
그룹의 표시 이름입니다.
description
string
사용자가 그룹의 목적을 파악하는 데 도움이 되는 확장된 설명입니다. 예를 들어 그룹에 참여해야 하는 사람, 그룹에 보낼 메시지 유형, 그룹 관련 FAQ 링크, 관련 그룹 등에 대한 정보를 포함할 수 있습니다. 최대 길이는 4,096자(영문 기준)입니다.
그룹의 직속 회원 수입니다. 그룹이 이 그룹 (상위)의 회원 (하위)인 경우 하위 그룹의 회원은 상위 그룹의 directMembersCount 속성에 포함되지 않습니다.
kind
string
API 리소스의 유형입니다. 그룹 리소스의 경우 값은 admin#directory#group입니다.
etag
string
리소스의 ETag입니다.
aliases[]
string
읽기 전용입니다. 그룹의 별칭 이메일 주소 목록입니다. 그룹의 별칭을 추가, 업데이트 또는 삭제하려면 groups.aliases 메서드를 사용하세요. 그룹의 POST 또는 PUT 요청에서 수정하면 수정사항이 무시됩니다.
nonEditableAliases[]
string
읽기 전용입니다. 계정의 기본 도메인 또는 하위 도메인 외부에 있는 수정할 수 없는 그룹의 별칭 이메일 주소 목록입니다. 그룹에서 사용하는 이메일 주소입니다. 그룹의 API 응답에서 반환되는 읽기 전용 속성입니다. 그룹의 POST 또는 PUT 요청에서 수정하면 수정사항이 무시됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-24(UTC)"],[],[],null,["# REST Resource: groups\n\nResource: Group\n---------------\n\nGoogle Groups provide your users the ability to send messages to groups of people using the group's email address. For more information about common tasks, see the [Developer's Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-groups).\n\nFor information about other types of groups, see the [Cloud Identity Groups API documentation](https://cloud.google.com/identity/docs/groups).\n\nNote: The user calling the API (or being impersonated by a service account) must have an assigned [role](https://developers.google.com/workspace/admin/directory/v1/guides/manage-roles) that includes Admin API Groups permissions, such as Super Admin or Groups Admin.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"email\": string, \"name\": string, \"description\": string, \"adminCreated\": boolean, \"directMembersCount\": string, \"kind\": string, \"etag\": string, \"aliases\": [ string ], \"nonEditableAliases\": [ string ] } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Read-only. The unique ID of a group. A group `id` can be used as a group request URI's `groupKey`. |\n| `email` | `string` The group's email address. If your account has multiple domains, select the appropriate domain for the email address. The `email` must be unique. This property is required when creating a group. Group email addresses are subject to the same character usage rules as usernames, see the [help center](https://support.google.com/a/answer/9193374) for details. |\n| `name` | `string` The group's display name. |\n| `description` | `string` An extended description to help users determine the purpose of a group. For example, you can include information about who should join the group, the types of messages to send to the group, links to FAQs about the group, or related groups. Maximum length is `4,096` characters. |\n| `adminCreated` | `boolean` Read-only. Value is `true` if this group was created by an administrator rather than a user. |\n| `directMembersCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The number of users that are direct members of the group. If a group is a member (child) of this group (the parent), members of the child group are not counted in the `directMembersCount` property of the parent group. |\n| `kind` | `string` The type of the API resource. For Groups resources, the value is `admin#directory#group`. |\n| `etag` | `string` ETag of the resource. |\n| `aliases[]` | `string` Read-only. The list of a group's alias email addresses. To add, update, or remove a group's aliases, use the `groups.aliases` methods. If edited in a group's POST or PUT request, the edit is ignored. |\n| `nonEditableAliases[]` | `string` Read-only. The list of the group's non-editable alias email addresses that are outside of the account's primary domain or subdomains. These are functioning email addresses used by the group. This is a read-only property returned in the API's response for a group. If edited in a group's POST or PUT request, the edit is ignored. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------|----------------------------------------------------------------------------|\n| ### [delete](/workspace/admin/directory/reference/rest/v1/groups/delete) | Deletes a group. |\n| ### [get](/workspace/admin/directory/reference/rest/v1/groups/get) | Retrieves a group's properties. |\n| ### [insert](/workspace/admin/directory/reference/rest/v1/groups/insert) | Creates a group. |\n| ### [list](/workspace/admin/directory/reference/rest/v1/groups/list) | Retrieves all groups of a domain or of a user given a userKey (paginated). |\n| ### [patch](/workspace/admin/directory/reference/rest/v1/groups/patch) | Updates a group's properties. |\n| ### [update](/workspace/admin/directory/reference/rest/v1/groups/update) | Updates a group's properties. |"]]
