Groups

A Groups resource is the root data class for the Groups Settings API. Each Groups resource is associated with a collection of settings.

For more information, see a list of methods for this resource.

Resource representations

A Groups resource includes metadata with a summary of a specified group's settings. These settings manage the group's access, notifications, discussion archiving, message moderation, and customize your account's user groups.

By default, the Groups resource data is returned in the atom+XML data format.

Atom

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:apps="http://schemas.google.com/apps/2006" xmlns:gd="http://schemas.google.com/g/2005">
  <id>
    string
  </id>
  <title>
    Groups Resource Entry
  </title>
  <content type="text">
    string
  </content>
  <author>
    <name>
      Google
    </name>
  </author>
  <apps:email>
    string
  </apps:email>
  <apps:name>
    string
  </apps:name>
  <apps:description>
    string
  </apps:description>
  <apps:whoCanJoin>
    string
  </apps:whoCanJoin>
  <apps:whoCanViewMembership>
    string
  </apps:whoCanViewMembership>
  <apps:whoCanViewGroup>
    string
  </apps:whoCanViewGroup>
  <apps:whoCanInvite>
    string
  </apps:whoCanInvite>
  <apps:whoCanAdd>
    string
  </apps:whoCanAdd>
  <apps:allowExternalMembers>
    string
  </apps:allowExternalMembers>
  <apps:whoCanPostMessage>
    string
  </apps:whoCanPostMessage>
  <apps:allowWebPosting>
    string
  </apps:allowWebPosting>
  <apps:primaryLanguage>
    string
  </apps:primaryLanguage>
  <apps:maxMessageBytes>
    integer
  </apps:maxMessageBytes>
  <apps:isArchived>
    string
  </apps:isArchived>
  <apps:archiveOnly>
    string
  </apps:archiveOnly>
  <apps:messageModerationLevel>
    string
  </apps:messageModerationLevel>
  <apps:spamModerationLevel>
    string
  </apps:spamModerationLevel>
  <apps:replyTo>
    string
  </apps:replyTo>
  <apps:customReplyTo>
    string
  </apps:customReplyTo>
  <apps:includeCustomFooter>
    string
  </apps:includeCustomFooter>
  <apps:customFooterText>
    string
  </apps:customFooterText>
  <apps:sendMessageDenyNotification>
    string
  </apps:sendMessageDenyNotification>
  <apps:defaultMessageDenyNotificationText>
    string
  </apps:defaultMessageDenyNotificationText>
  <apps:showInGroupDirectory>
    string
  </apps:showInGroupDirectory>
  <apps:allowGoogleCommunication>
    string
  </apps:allowGoogleCommunication>
  <apps:membersCanPostAsTheGroup>
    string
  </apps:membersCanPostAsTheGroup>
  <apps:messageDisplayFont>
    string
  </apps:messageDisplayFont>
  <apps:includeInGlobalAddressList>
    string
  </apps:includeInGlobalAddressList>
  <apps:whoCanLeaveGroup>
    string
  </apps:whoCanLeaveGroup>
  <apps:whoCanContactOwner>
    string
  </apps:whoCanContactOwner>
  <apps:whoCanAddReferences>
    string
  </apps:whoCanAddReferences>
  <apps:whoCanAssignTopics>
    string
  </apps:whoCanAssignTopics>
  <apps:whoCanUnassignTopic>
    string
  </apps:whoCanUnassignTopic>
  <apps:whoCanTakeTopics>
    string
  </apps:whoCanTakeTopics>
  <apps:whoCanMarkDuplicate>
    string
  </apps:whoCanMarkDuplicate>
  <apps:whoCanMarkNoResponseNeeded>
    string
  </apps:whoCanMarkNoResponseNeeded>
  <apps:whoCanMarkFavoriteReplyOnAnyTopic>
    string
  </apps:whoCanMarkFavoriteReplyOnAnyTopic>
  <apps:whoCanMarkFavoriteReplyOnOwnTopic>
    string
  </apps:whoCanMarkFavoriteReplyOnOwnTopic>
  <apps:whoCanUnmarkFavoriteReplyOnAnyTopic>
    string
  </apps:whoCanUnmarkFavoriteReplyOnAnyTopic>
  <apps:whoCanEnterFreeFormTags>
    string
  </apps:whoCanEnterFreeFormTags>
  <apps:whoCanModifyTagsAndCategories>
    string
  </apps:whoCanModifyTagsAndCategories>
  <apps:favoriteRepliesOnTop>
    string
  </apps:favoriteRepliesOnTop>
  <apps:whoCanApproveMembers>
    string
  </apps:whoCanApproveMembers>
  <apps:whoCanBanUsers>
    string
  </apps:whoCanBanUsers>
  <apps:whoCanModifyMembers>
    string
  </apps:whoCanModifyMembers>
  <apps:whoCanApproveMessages>
    string
  </apps:whoCanApproveMessages>
  <apps:whoCanDeleteAnyPost>
    string
  </apps:whoCanDeleteAnyPost>
  <apps:whoCanDeleteTopics>
    string
  </apps:whoCanDeleteTopics>
  <apps:whoCanLockTopics>
    string
  </apps:whoCanLockTopics>
  <apps:whoCanMoveTopicsIn>
    string
  </apps:whoCanMoveTopicsIn>
  <apps:whoCanMoveTopicsOut>
    string
  </apps:whoCanMoveTopicsOut>
  <apps:whoCanPostAnnouncements>
    string
  </apps:whoCanPostAnnouncements>
  <apps:whoCanHideAbuse>
    string
  </apps:whoCanHideAbuse>
  <apps:whoCanMakeTopicsSticky>
    string
  </apps:whoCanMakeTopicsSticky>
  <apps:whoCanModerateMembers>
    string
  </apps:whoCanModerateMembers>
  <apps:whoCanModerateContent>
    string
  </apps:whoCanModerateContent>
  <apps:whoCanAssistContent>
    string
  </apps:whoCanAssistContent>
  <apps:customRolesEnabledForSettingsToBeMerged>
    string
  </apps:customRolesEnabledForSettingsToBeMerged>
  <apps:enableCollaborativeInbox>
    string
  </apps:enableCollaborativeInbox>
  <apps:whoCanDiscoverGroup>
    string
  </apps:whoCanDiscoverGroup>
  <apps:defaultSender>
    string
  </apps:defaultSender>
</entry>

The following table shows the Groups resources:

Property name Value Description
entry object A Group resource
entry/xmlns string Schema for Atom format
entry/xmlns:apps string Schema for Google Workspace I/O format
entry/xmlns:gd string Schema for Google Data protocol
entry/id object Unique identifier for a Group resource
entry/title object Title of the API's Atom entry, which is Groups Resource Entry
entry/content object Content type of Atom entry
entry/content/type string Content type of the Atom feed, which is text
entry/author object Author tag for Atom entry
entry/author/name object Name of the author, which is Google
entry/apps:email object

The group's email address. This property can be updated using the Directory API.

entry/apps:name object The group name. A group's name has a maximum of 75 characters.
entry/apps:description object The description of the group. This property value can be an empty string if no group description has been entered. If entered, the maximum group description is no more than 300 characters.
entry/apps:whoCanJoin object Permission to join group. Possible values are:
  • ANYONE_CAN_JOIN: Any internet user, both inside and outside your domain, can join the group.
  • ALL_IN_DOMAIN_CAN_JOIN: Anyone in the account domain can join. This includes accounts with multiple domains.
  • INVITED_CAN_JOIN: Candidates for membership can be invited to join.
  • CAN_REQUEST_TO_JOIN: Non members can request an invitation to join.
entry/apps:whoCanViewMembership object Permissions to view membership. Possible values are:
  • ALL_IN_DOMAIN_CAN_VIEW: Anyone in the account can view the group members list.

    If a group already has external members, those members can still send email to this group.

  • ALL_MEMBERS_CAN_VIEW: The group members can view the group members list.
  • ALL_MANAGERS_CAN_VIEW: The group managers can view group members list.
entry/apps:whoCanViewGroup object Permissions to view group messages. Possible values are:
  • ANYONE_CAN_VIEW: Any internet user can view the group's messages.
  • ALL_IN_DOMAIN_CAN_VIEW: Anyone in your account can view this group's messages.
  • ALL_MEMBERS_CAN_VIEW: All group members can view the group's messages.
  • ALL_MANAGERS_CAN_VIEW: Any group manager can view this group's messages.
  • ALL_OWNERS_CAN_VIEW: Any group owner can view this group's messages.
entry/apps:whoCanInvite object Deprecated. This is merged into the whoCanModerateMembers setting. Permissions to invite new members. Possible values are:
  • ALL_MEMBERS_CAN_INVITE: Managers and members can invite a new member candidate.
  • ALL_MANAGERS_CAN_INVITE: Only managers can invite a new member. This includes the group's owner.
  • ALL_OWNERS_CAN_INVITE: Only owners can invite a new member.
  • NONE_CAN_INVITE: No one can invite a new member candidate.
entry/apps:whoCanAdd object Deprecated. This is merged into the whoCanModerateMembers setting. Permissions to directly add new members. Possible values are:
  • ALL_MEMBERS_CAN_ADD: Managers and members can directly add new members.
  • ALL_MANAGERS_CAN_ADD: Only managers can directly add new members. This includes the group's owner.
  • ALL_OWNERS_CAN_ADD: Only owners can directly add new members.
  • NONE_CAN_ADD: No one can directly add new members.
entry/apps:allowExternalMembers object Identifies whether members external to your organization can join the group. Possible values are:
  • true: Google Workspace users external to your organization can become members of this group.
  • false: Users not belonging to the organization are not allowed to become members of this group.
entry/apps:whoCanPostMessage object Permissions to post messages. Possible values are:
  • NONE_CAN_POST: The group is disabled and archived. No one can post a message to this group.
    • When archiveOnly is false, updating whoCanPostMessage to NONE_CAN_POST, results in an error.
    • If archiveOnly is reverted from true to false, whoCanPostMessages is set to ALL_MANAGERS_CAN_POST.
  • ALL_MANAGERS_CAN_POST: Managers, including group owners, can post messages.
  • ALL_MEMBERS_CAN_POST: Any group member can post a message.
  • ALL_OWNERS_CAN_POST: Only group owners can post a message.
  • ALL_IN_DOMAIN_CAN_POST: Anyone in the account can post a message.
  • ANYONE_CAN_POST: Any internet user who outside your account can access your Google Groups service and post a message.
entry/apps:allowWebPosting object Allows posting from web. Possible values are:
  • true: Allows any member to post to the group forum.
  • false: Members only use Gmail to communicate with the group.
entry/apps:primaryLanguage object The primary language for the group. Use the language tags in the Supported languages table.
entry/apps:maxMessageBytes object Deprecated. The maximum size of a message is 25Mb.
entry/apps:isArchived object Allows the Group contents to be archived. Possible values are:
  • true: Archive messages sent to the group.
  • false: Do not keep an archive of messages sent to this group. If false, previously archived messages remain in the archive.
entry/apps:archiveOnly object Allows the group to be archived only. Possible values are:
  • true: Group is archived and the group is inactive. New messages to this group are rejected. The older archived messages are browseable and searchable.
    • If true, the whoCanPostMessage property is set to NONE_CAN_POST.
    • If reverted from true to false, whoCanPostMessages is set to ALL_MANAGERS_CAN_POST.
  • false: The group is active and can receive messages.
    • When false, updating whoCanPostMessage to NONE_CAN_POST, results in an error.
entry/apps:messageModerationLevel object Moderation level of incoming messages. Possible values are:
  • MODERATE_ALL_MESSAGES: All messages are sent to the group owner's email address for approval. If approved, the message is sent to the group.
  • MODERATE_NON_MEMBERS: All messages from non group members are sent to the group owner's email address for approval. If approved, the message is sent to the group.
  • MODERATE_NEW_MEMBERS: All messages from new members are sent to the group owner's email address for approval. If approved, the message is sent to the group.
  • MODERATE_NONE: No moderator approval is required. Messages are delivered directly to the group.
entry/apps:spamModerationLevel object Specifies moderation levels for messages detected as spam. Possible values are:
  • ALLOW: Post the message to the group.
  • MODERATE: Send the message to the moderation queue. This is the default.
  • SILENTLY_MODERATE: Send the message to the moderation queue, but do not send notification to moderators.
  • REJECT: Immediately reject the message.
entry/apps:replyTo object Specifies who the default reply should go to. Possible values are:
  • REPLY_TO_CUSTOM: For replies to messages, use the group's custom email address.

    When the group's ReplyTo property is set to REPLY_TO_CUSTOM, the customReplyTo property holds the custom email address used when replying to a message. If the group's ReplyTo property is set to REPLY_TO_CUSTOM, the customReplyTo property must have a value. Otherwise an error is returned.

  • REPLY_TO_SENDER: The reply sent to author of message.
  • REPLY_TO_LIST: This reply message is sent to the group.
  • REPLY_TO_OWNER: The reply is sent to the owners of the group. This doesn't include the group's managers.
  • REPLY_TO_IGNORE: Group users individually decide where the message reply is sent.
  • REPLY_TO_MANAGERS: This reply message is sent to the group's managers, which includes all managers and the group owner.
entry/apps:customReplyTo object An email address used when replying to a message if the replyTo property is set to REPLY_TO_CUSTOM. This address is defined by an account administrator.
  • When the group's ReplyTo property is set to REPLY_TO_CUSTOM, the customReplyTo property holds a custom email address used when replying to a message.
  • If the group's ReplyTo property is set to REPLY_TO_CUSTOM, the customReplyTo property must have a text value or an error is returned.
entry/apps:includeCustomFooter object Whether to include custom footer. Possible values are:
  • true
  • false
entry/apps:customFooterText object Set the content of custom footer text. The maximum number of characters is 1000.
entry/apps:sendMessageDenyNotification object Allows a member to be notified if the member's message to the group is denied by the group owner. Possible values are:
  • true: When a message is rejected, send the deny message notification to the message author.

    The defaultMessageDenyNotificationText property is dependent on the sendMessageDenyNotification property being true.

  • false: When a message is rejected, no notification is sent.
entry/apps:defaultMessageDenyNotificationText object When a message is rejected, this is text for the rejection notification sent to the message's author. By default, this property is empty and has no value in the API's response body. The maximum notification text size is 10,000 characters.
entry/apps:showInGroupDirectory object Deprecated. This is merged into the whoCanDiscoverGroup setting. Allows the group to be visible in the Groups Directory. Possible values are:
  • true: All groups in the account are listed in the Groups directory.
  • false: All groups in the account are not listed in the directory.
entry/apps:allowGoogleCommunication object Deprecated. Allows Google to contact administrator of the group.
  • true: Allow Google to contact managers of this group. Occasionally Google may send updates on the latest features, ask for input on new features, or ask for permission to highlight your group.
  • false: Google can not contact managers of this group.
entry/apps:membersCanPostAsTheGroup object Enables members to post messages as the group. Possible values are:
  • true: Group member can post messages using the group's email address instead of their own email address. Message appear to originate from the group itself.
  • false: Members can not post in behalf of the group's email address.
entry/apps:messageDisplayFont object Deprecated. The default message display font always has a value of DEFAULT_FONT.
entry/apps:includeInGlobalAddressList object Enables the group to be included in the Global Address List. For more information, see the help center. Possible values are:
  • true: Group is included in the Global Address List.
  • false: Group is not included in the Global Address List.
entry/apps:whoCanLeaveGroup object Specifies who can leave the group. Possible values are:
  • ALL_MANAGERS_CAN_LEAVE
  • ALL_MEMBERS_CAN_LEAVE
  • NONE_CAN_LEAVE
entry/apps:whoCanContactOwner object Specifies who can contact the group owner. Possible values are:
  • ALL_IN_DOMAIN_CAN_CONTACT
  • ALL_MANAGERS_CAN_CONTACT
  • ALL_MEMBERS_CAN_CONTACT
  • ANYONE_CAN_CONTACT
entry/apps:whoCanAddReferences object Deprecated. This functionality is no longer supported in the Google Groups UI. The value is always NONE.
entry/apps:whoCanAssignTopics object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can assign topics in a forum to another user. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanUnassignTopic object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can unassign any topic in a forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanTakeTopics object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can take topics in a forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMarkDuplicate object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can mark a topic as a duplicate of another topic. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMarkNoResponseNeeded object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can mark a topic as not needing a response. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMarkFavoriteReplyOnAnyTopic object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can mark any other user’s post as a favorite reply. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMarkFavoriteReplyOnOwnTopic object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can mark a post for a topic they started as a favorite reply. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanUnmarkFavoriteReplyOnAnyTopic object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can un-mark any post from a favorite reply. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanEnterFreeFormTags object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can enter free form tags for topics in a forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanModifyTagsAndCategories object Deprecated. This is merged into the whoCanAssistContent setting. Specifies who can change tags and categories. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:favoriteRepliesOnTop object Indicates if favorite replies should be displayed above other replies.
  • true: Favorite replies will be displayed above other replies.
  • false: Favorite replies will not be displayed above other replies.
entry/apps:whoCanApproveMembers object Deprecated. This is merged into the whoCanModerateMembers setting. Deprecated. This is merged into the whoCanModerateMembers setting. Specifies who can approve members who ask to join groups. Possible values are:
  • ALL_MEMBERS_CAN_APPROVE
  • ALL_MANAGERS_CAN_APPROVE
  • ALL_OWNERS_CAN_APPROVE
  • NONE_CAN_APPROVE
entry/apps:whoCanBanUsers object Deprecated. This is merged into the whoCanModerateMembers setting. Specifies who can deny membership to users. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanModifyMembers object Deprecated. This is merged into the whoCanModerateMembers setting. Specifies who can change group members' roles. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanApproveMessages object Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can approve pending messages in the moderation queue. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanDeleteAnyPost object Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can delete replies to topics. (Authors can always delete their own posts). Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanDeleteTopics object Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can delete topics. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanLockTopics object Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can prevent users from posting replies to topics. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMoveTopicsIn object Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can move topics into the group or forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMoveTopicsOut object Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can move topics out of the group or forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanPostAnnouncements object Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can post announcements, a special topic type. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanHideAbuse object Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can hide posts by reporting them as abuse. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMakeTopicsSticky object Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can make topics appear at the top of the topic list. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanModerateMembers object Specifies who can manage members. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanModerateContent object Specifies who can moderate content. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanAssistContent object Specifies who can moderate metadata. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:customRolesEnabledForSettingsToBeMerged object Specifies whether the group has a custom role that's included in one of the settings being merged. This field is read-only and UPDATE and PATCH requests to it are ignored. Possible values are:
  • true
  • false
entry/apps:enableCollaborativeInbox object Specifies whether a collaborative inbox will remain turned on for the group. Possible values are:
  • true
  • false
entry/apps:whoCanDiscoverGroup object Specifies the set of users for whom this group is discoverable. Possible values are:
  • ANYONE_CAN_DISCOVER
  • ALL_IN_DOMAIN_CAN_DISCOVER
  • ALL_MEMBERS_CAN_DISCOVER
entry/apps:defaultSender object Default sender for members who can post messages as the group. Possible values are:
  • DEFAULT_SELF
  • GROUP

JSON

{
  "kind": "groupsSettings#groups",
  "email": string,
  "name": string,
  "description": string,
  "whoCanJoin": string,
  "whoCanViewMembership": string,
  "whoCanViewGroup": string,
  "whoCanInvite": string,
  "whoCanAdd": string,
  "allowExternalMembers": string,
  "whoCanPostMessage": string,
  "allowWebPosting": string,
  "primaryLanguage": string,
  "maxMessageBytes": integer,
  "isArchived": string,
  "archiveOnly": string,
  "messageModerationLevel": string,
  "spamModerationLevel": string,
  "replyTo": string,
  "customReplyTo": string,
  "includeCustomFooter": string,
  "customFooterText": string,
  "sendMessageDenyNotification": string,
  "defaultMessageDenyNotificationText": string,
  "showInGroupDirectory": string,
  "allowGoogleCommunication": string,
  "membersCanPostAsTheGroup": string,
  "messageDisplayFont": string,
  "includeInGlobalAddressList": string,
  "whoCanLeaveGroup": string,
  "whoCanContactOwner": string,
  "whoCanAddReferences": string,
  "whoCanAssignTopics": string,
  "whoCanUnassignTopic": string,
  "whoCanTakeTopics": string,
  "whoCanMarkDuplicate": string,
  "whoCanMarkNoResponseNeeded": string,
  "whoCanMarkFavoriteReplyOnAnyTopic": string,
  "whoCanMarkFavoriteReplyOnOwnTopic": string,
  "whoCanUnmarkFavoriteReplyOnAnyTopic": string,
  "whoCanEnterFreeFormTags": string,
  "whoCanModifyTagsAndCategories": string,
  "favoriteRepliesOnTop": string,
  "whoCanApproveMembers": string,
  "whoCanBanUsers": string,
  "whoCanModifyMembers": string,
  "whoCanApproveMessages": string,
  "whoCanDeleteAnyPost": string,
  "whoCanDeleteTopics": string,
  "whoCanLockTopics": string,
  "whoCanMoveTopicsIn": string,
  "whoCanMoveTopicsOut": string,
  "whoCanPostAnnouncements": string,
  "whoCanHideAbuse": string,
  "whoCanMakeTopicsSticky": string,
  "whoCanModerateMembers": string,
  "whoCanModerateContent": string,
  "whoCanAssistContent": string,
  "customRolesEnabledForSettingsToBeMerged": string,
  "enableCollaborativeInbox": string,
  "whoCanDiscoverGroup": string,
  "defaultSender": string
}

The following table shows the Groups resources:

Property name Value Description
kind string The type of the resource. It is always groupsSettings#groups.
email string The group's email address. This property can be updated using the Directory API.
name string Name of the group, which has a maximum size of 75 characters.
description string Description of the group. This property value can be an empty string if no group description has been entered. If entered, the maximum group description is no more than 300 characters.
whoCanJoin string Permission to join group. Possible values are:
  • ANYONE_CAN_JOIN: Any internet user, both inside and outside your domain, can join the group.
  • ALL_IN_DOMAIN_CAN_JOIN: Anyone in the account domain can join. This includes accounts with multiple domains.
  • INVITED_CAN_JOIN: Candidates for membership can be invited to join.
  • CAN_REQUEST_TO_JOIN: Non members can request an invitation to join.
whoCanViewMembership string Permissions to view membership. Possible values are:
  • ALL_IN_DOMAIN_CAN_VIEW: Anyone in the account can view the group members list.

    If a group already has external members, those members can still send email to this group.

  • ALL_MEMBERS_CAN_VIEW: The group members can view the group members list.
  • ALL_MANAGERS_CAN_VIEW: The group managers can view group members list.
whoCanViewGroup string Permissions to view group messages. Possible values are:
  • ANYONE_CAN_VIEW: Any internet user can view the group's messages.
  • ALL_IN_DOMAIN_CAN_VIEW: Anyone in your account can view this group's messages.
  • ALL_MEMBERS_CAN_VIEW: All group members can view the group's messages.
  • ALL_MANAGERS_CAN_VIEW: Any group manager can view this group's messages.
whoCanInvite string Deprecated. This is merged into the whoCanModerateMembers setting. Permissions to invite new members. Possible values are:
  • ALL_MEMBERS_CAN_INVITE: Managers and members can invite a new member candidate.
  • ALL_MANAGERS_CAN_INVITE: Only managers can invite a new member. This includes the group's owner.
  • ALL_OWNERS_CAN_INVITE: Only owners can invite a new member.
  • NONE_CAN_INVITE: No one can invite a new member candidate.
whoCanAdd string Deprecated. This is merged into the whoCanModerateMembers setting. Permissions to add members. Possible values are:
  • ALL_MEMBERS_CAN_ADD: Managers and members can directly add new members.
  • ALL_MANAGERS_CAN_ADD: Only managers can directly add new members. this includes the group's owner.
  • ALL_OWNERS_CAN_ADD: Only owners can directly add new members.
  • NONE_CAN_ADD: No one can directly add new members.
allowExternalMembers string Identifies whether members external to your organization can join the group. Possible values are:
  • true: Google Workspace users external to your organization can become members of this group.
  • false: Users not belonging to the organization are not allowed to become members of this group.
whoCanPostMessage string Permissions to post messages. Possible values are:
  • NONE_CAN_POST: The group is disabled and archived. No one can post a message to this group.
    • When archiveOnly is false, updating whoCanPostMessage to NONE_CAN_POST, results in an error.
    • If archiveOnly is reverted from true to false, whoCanPostMessages is set to ALL_MANAGERS_CAN_POST.
  • ALL_MANAGERS_CAN_POST: Managers, including group owners, can post messages.
  • ALL_MEMBERS_CAN_POST: Any group member can post a message.
  • ALL_OWNERS_CAN_POST: Only group owners can post a message.
  • ALL_IN_DOMAIN_CAN_POST: Anyone in the account can post a message.
  • ANYONE_CAN_POST: Any internet user who outside your account can access your Google Groups service and post a message.
allowWebPosting string Allows posting from web. Possible values are:
  • true: Allows any member to post to the group forum.
  • false: Members only use Gmail to communicate with the group.
primaryLanguage string The primary language for the group. Use the language tags in the Supported languages table.
maxMessageBytes integer Deprecated. The maximum size of a message is 25Mb.
isArchived string Allows the Group contents to be archived. Possible values are:
  • true: Archive messages sent to the group.
  • false: Do not keep an archive of messages sent to this group. If false, previously archived messages remain in the archive.
archiveOnly string Allows the group to be archived only. Possible values are:
  • true: Group is archived and the group is inactive. New messages to this group are rejected. The older archived messages are browseable and searchable.
    • If true, the whoCanPostMessage property is set to NONE_CAN_POST.
    • If reverted from true to false, whoCanPostMessages is set to ALL_MANAGERS_CAN_POST.
  • false: The group is active and can receive messages.
    • When false, updating whoCanPostMessage to NONE_CAN_POST, results in an error.
messageModerationLevel string Moderation level of incoming messages. Possible values are:
  • MODERATE_ALL_MESSAGES: All messages are sent to the group owner's email address for approval. If approved, the message is sent to the group.
  • MODERATE_NON_MEMBERS: All messages from non group members are sent to the group owner's email address for approval. If approved, the message is sent to the group.
  • MODERATE_NEW_MEMBERS: All messages from new members are sent to the group owner's email address for approval. If approved, the message is sent to the group.
  • MODERATE_NONE: No moderator approval is required. Messages are delivered directly to the group.
spamModerationLevel string Specifies moderation levels for messages detected as spam. Possible values are:
  • ALLOW: Post the message to the group.
  • MODERATE: Send the message to the moderation queue. This is the default.
  • SILENTLY_MODERATE: Send the message to the moderation queue, but do not send notification to moderators.
  • REJECT: Immediately reject the message.
replyTo string Specifies who receives the default reply. Possible values are:
  • REPLY_TO_CUSTOM: For replies to messages, use the group's custom email address.

    When the group's ReplyTo property is set to REPLY_TO_CUSTOM, the customReplyTo property holds the custom email address used when replying to a message. If the group's ReplyTo property is set to REPLY_TO_CUSTOM, the customReplyTo property must have a value. Otherwise an error is returned.

  • REPLY_TO_SENDER: The reply sent to author of message.
  • REPLY_TO_LIST: This reply message is sent to the group.
  • REPLY_TO_OWNER: The reply is sent to the owner(s) of the group. This does not include the group's managers.
  • REPLY_TO_IGNORE: Group users individually decide where the message reply is sent.
  • REPLY_TO_MANAGERS: This reply message is sent to the group's managers, which includes all managers and the group owner.
customReplyTo string An email address used when replying to a message if the replyTo property is set to REPLY_TO_CUSTOM. This address is defined by an account administrator.
  • When the group's ReplyTo property is set to REPLY_TO_CUSTOM, the customReplyTo property holds a custom email address used when replying to a message.
  • If the group's ReplyTo property is set to REPLY_TO_CUSTOM, the customReplyTo property must have a text value or an error is returned.
includeCustomFooter string Whether to include custom footer. Possible values are:
  • true
  • false
customFooterText string Set the content of custom footer text. The maximum number of characters is 1,000.
sendMessageDenyNotification string Allows a member to be notified if the member's message to the group is denied by the group owner. Possible values are:
  • true: When a message is rejected, send the deny message notification to the message author.

    The defaultMessageDenyNotificationText property is dependent on the sendMessageDenyNotification property being true.

  • false: When a message is rejected, no notification is sent.
defaultMessageDenyNotificationText string When a message is rejected, this is text for the rejection notification sent to the message's author. By default, this property is empty and has no value in the API's response body. The maximum notification text size is 10,000 characters.
showInGroupDirectory string Deprecated. This is merged into the whoCanDiscoverGroup setting. Allows the group to be visible in the Groups Directory. Possible values are:
  • true: All groups in the account are listed in the Groups directory.
  • false: All groups in the account are not listed in the directory.
allowGoogleCommunication string Deprecated. Allows Google to contact administrator of the group.
  • true: Allow Google to contact managers of this group. Occasionally Google may send updates on the latest features, ask for input on new features, or ask for permission to highlight your group.
  • false: Google can not contact managers of this group.
membersCanPostAsTheGroup string Enables members to post messages as the group. Possible values are:
  • true: Group member can post messages using the group's email address instead of their own email address. Message appear to originate from the group itself.
  • false: Members can not post in behalf of the group's email address.
messageDisplayFont string Deprecated. The default message display font always has a value of DEFAULT_FONT.
includeInGlobalAddressList string Enables the group to be included in the Global Address List. For more information, see the help center. Possible values are:
  • true: Group is included in the Global Address List.
  • false: Group is not included in the Global Address List.
whoCanLeaveGroup string Permission to leave the group. Possible values are:
  • ALL_MANAGERS_CAN_LEAVE
  • ALL_MEMBERS_CAN_LEAVE
  • NONE_CAN_LEAVE
whoCanContactOwner string Permission to contact owner of the group via web UI. Possible values are:
  • ALL_IN_DOMAIN_CAN_CONTACT
  • ALL_MANAGERS_CAN_CONTACT
  • ALL_MEMBERS_CAN_CONTACT
  • ANYONE_CAN_CONTACT
whoCanAddReferences string Deprecated. This functionality is no longer supported in the Google Groups UI. The value is always "NONE".
whoCanAssignTopics string Deprecated. This is merged into the whoCanAssistContent setting. Permission to assign topics in a forum to another user. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanUnassignTopic string Deprecated. This is merged into the whoCanAssistContent setting. Permission to unassign any topic in a forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanTakeTopics string Deprecated. This is merged into the whoCanAssistContent setting. Permission to take topics in a forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkDuplicate string Deprecated. This is merged into the whoCanAssistContent setting. Permission to mark a topic as a duplicate of another topic. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkNoResponseNeeded string Deprecated. This is merged into the whoCanAssistContent setting. Permission to mark a topic as not needing a response. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkFavoriteReplyOnAnyTopic string Deprecated. This is merged into the whoCanAssistContent setting. Permission to mark any other user's post as a favorite reply. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkFavoriteReplyOnOwnTopic string Deprecated. This is merged into the whoCanAssistContent setting. Permission to mark a post for a topic they started as a favorite reply. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanUnmarkFavoriteReplyOnAnyTopic string Deprecated. This is merged into the whoCanAssistContent setting. Permission to unmark any post from a favorite reply. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanEnterFreeFormTags string Deprecated. This is merged into the whoCanAssistContent setting. Permission to enter free form tags for topics in a forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanModifyTagsAndCategories string Deprecated. This is merged into the whoCanAssistContent setting. Permission to change tags and categories. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
favoriteRepliesOnTop string Indicates if favorite replies should be displayed before other replies.
  • true: Favorite replies are displayed before other replies.
  • false: Favorite replies aren't displayed before other replies.
whoCanApproveMembers string Specifies who can approve members who ask to join groups. This permission will be deprecated once it is merged into the whoCanModerateMembers setting. Possible values are:
  • ALL_MEMBERS_CAN_APPROVE
  • ALL_MANAGERS_CAN_APPROVE
  • ALL_OWNERS_CAN_APPROVE
  • NONE_CAN_APPROVE
whoCanBanUsers string Specifies who can deny membership to users. This permission will be deprecated once it is merged into the whoCanModerateMembers setting. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanModifyMembers string Deprecated. This is merged into the whoCanModerateMembers setting. Specifies who can change group members' roles. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanApproveMessages string Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can approve pending messages in the moderation queue. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanDeleteAnyPost string Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can delete replies to topics. (Authors can always delete their own posts). Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanDeleteTopics string Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can delete topics. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanLockTopics string Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can prevent users from posting replies to topics. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanMoveTopicsIn string Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can move topics into the group or forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanMoveTopicsOut string Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can move topics out of the group or forum. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanPostAnnouncements string Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can post announcements, a special topic type. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanHideAbuse string Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can hide posts by reporting them as abuse. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanMakeTopicsSticky string Deprecated. This is merged into the whoCanModerateContent setting. Specifies who can make topics appear at the top of the topic list. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanModerateMembers string Specifies who can manage members. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanModerateContent string Specifies who can moderate content. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanAssistContent string Specifies who can moderate metadata. Possible values are:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
customRolesEnabledForSettingsToBeMerged string Specifies whether the group has a custom role that's included in one of the settings being merged. This field is read-only and UPDATE and PATCH requests to it are ignored. Possible values are:
  • true
  • false
enableCollaborativeInbox string Specifies whether a collaborative inbox will remain turned on for the group. Possible values are:
  • true
  • false
whoCanDiscoverGroup string Specifies the set of users for whom this group is discoverable. Possible values are:
  • ANYONE_CAN_DISCOVER
  • ALL_IN_DOMAIN_CAN_DISCOVER
  • ALL_MEMBERS_CAN_DISCOVER
defaultSender string Default sender for members who can post messages as the group. Possible values are:
  • DEFAULT_SELF
  • GROUP

Methods

The groupsSettings.groups.get and groupsSettings.groups.update methods operate on a specified Groups Resource.

get
Retrieves a group's settings identified by the group email address.
update
Updates an existing group's settings, which is identified by the group email address.
patch
Updates an existing resource. This method supports patch semantics.

Supported languages

The following language codes are supported for a group's primaryLanguage field.

aa
ab
af
am
ar
as
ay
az
ba
be
bg
bh
bi
bn
bo
br
bs
ca
co
cs
cy
da
de
dz
el
en
en-GB
en-US-pseudo
en_US
eo
es
et
eu
fa
fi
fj
fo
fr
fr-CA
fy
ga
gd
gl
gn
gu
ha
hi
hr
hu
hy
ia
id
ie
ik
is
it
iu
iw
ja
jw
ka
kk
kl
km
kn
ko
ks
ku
ky
la
ln
lo
lt
lv
mg
mi
mk
ml
mn
mo
mr
ms
mt
my
na
ne
nl
nn
no
oc
om
or
pa
pl
ps
pt-BR
pt-PT
qu
rm
rn
ro
ru
rw
sa
sd
sg
sh
si
sk
sl
sm
sn
so
sq
sr
ss
st
su
sv
sw
ta
te
tg
th
ti
tk
tl
tn
to
tr
ts
tt
tw
ug
uk
ur
uz
vi
vo
wo
xh
xx-bork
xx-elmer
xx-hacker
xx-klingon
xx-piglatin
yi
yo
za
zh-CN
zh-TW
zu