# REST Resource: members

## Resource: Member

A Google Groups member can be a user or another group. This member can be inside or outside of your account's domains. For more information about common group member tasks, see the [Developer's Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-group-members).

| JSON representation |
|---|
| ``` { "kind": string, "email": string, "role": string, "etag": string, "type": string, "status": string, "delivery_settings": string, "id": string } ``` |

| Fields ||
|---|---|
| `kind` | `string` The type of the API resource. For Members resources, the value is `admin#directory#member`. |
| `email` | `string` The member's email address. A member can be a user or another group. This property is required when adding a member to a group. The `email` must be unique and cannot be an alias of another group. If the email address is changed, the API automatically reflects the email address changes. |
| `role` | `string` <br /> The member's role in a group. The API returns an error for cycles in group memberships. For example, if `group1` is a member of `group2`, `group2` cannot be a member of `group1`. For more information about a member's role, see [Assign group roles to members](https://support.google.com/a/answer/167094). Acceptable values are: - `MANAGER`: This role is only available if the Google Groups for Business is enabled using the Admin Console. See [Turn Groups for Business ON or OFF](https://support.google.com/a/answer/167096). A `MANAGER` role can do everything done by an `OWNER` role except make a member an `OWNER` or delete the group. A group can have multiple `MANAGER` members. - `MEMBER`: This role can subscribe to a group, view discussion archives, and view the group's membership list. For more information about member roles, see [Assign group roles to members](https://support.google.com/a/answer/167094). - `OWNER`: This role can send messages to the group, add or remove members, change member roles, change group's settings, and delete the group. An `OWNER` must be a member of the group. A group can have more than one `OWNER`. |
| `etag` | `string` ETag of the resource. |
| `type` | `string` <br /> The type of group member. Acceptable values are: - `CUSTOMER`: The member represents all users in a domain. An email address is not returned and the ID returned is the customer ID. - `EXTERNAL`: The member is a user or group from outside the domain. (Not currently used) - `GROUP`: The member is another group. - `USER`: The member is a user. |
| `status` | `string` Status of member (Immutable) |
| `delivery_settings` | `string` <br /> Defines mail delivery preferences of member. This field is only supported by `insert`, `update`, and `get` methods. Acceptable values are: - `ALL_MAIL`: All messages, delivered as soon as they arrive. - `DAILY`: No more than one message a day. - `DIGEST`: Up to 25 messages bundled into a single message. - `DISABLED`: Remove subscription. - `NONE`: No messages. |
| `id` | `string` The unique ID of the group member. A member `id` can be used as a member request URI's `memberKey`. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/members/delete` | Removes a member from a group. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/members/get` | Retrieves a group member's properties. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/members/hasMember` | Checks whether the given user is a member of the group. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/members/insert` | Adds a user to the specified group. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/members/list` | Retrieves a paginated list of all members in a group. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/members/patch` | Updates the membership properties of a user in the specified group. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/members/update` | Updates the membership of a user in the specified group. |