Google 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.

For a list of methods for this resource, see the end of this page.

Resource representations

The following JSON template is used for Groups resources in the Directory API:

  "kind": "admin#directory#group",
  "id": string,
  "etag": etag,
  "email": string,
  "name": string,
  "directMembersCount": long,
  "description": string,
  "adminCreated": boolean,
  "aliases": [
  "nonEditableAliases": [
Property name Value Description Notes
adminCreated boolean Value is true if this group was created by an administrator rather than a user.
aliases[] list List of a group's alias email addresses.
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. writable
directMembersCount long 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.
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 administration help center for the details. writable
etag etag ETag of the resource.
id string The unique ID of a group. A group id can be used as a group request URI's groupKey.
kind string The type of the API resource. For Groups resources, the value is admin#directory#group.
name string The group's display name. writable
nonEditableAliases[] list 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 by the API service.


Deletes a group.
Retrieves a group's properties.
Creates a group.
Retrieve all groups of a domain or of a user given a userKey (paginated)
Updates a group's properties. This method supports patch semantics.
Updates a group's properties.