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.

JSON representation
  "kind": string,
  "email": string,
  "role": string,
  "etag": string,
  "type": string,
  "status": string,
  "delivery_settings": string,
  "id": string


The type of the API resource. For Members resources, the value is admin#directory#member.



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.



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.

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. 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.
  • 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 of the resource.



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 of member (Immutable)



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.


The unique ID of the group member. A member id can be used as a member request URI's memberKey.



Removes a member from a group.


Retrieves a group member's properties.


Checks whether the given user is a member of the group.


Adds a user to the specified group.


Retrieves a paginated list of all members in a group.


Updates the membership properties of a user in the specified group.


Updates the membership of a user in the specified group.