This document lists the events and parameters for
various types of
Groups Audit activity events. You can retrieve these events by
calling Activities.list()
with applicationName=groups
.
ACL change
Events of this type are returned with type=acl_change
.
Group permission changed
Event details |
Event name |
change_acl_permission |
Parameters |
acl_permission |
string
Group permission setting updated.
Possible values:
can_add_members Who can add members setting.
can_add_references Who can add references setting.
can_approve_members Who can approve members setting.
can_approve_messages Who can approve messages setting.
can_assign_topics Who can assign topics setting.
can_attach_files Who can attach files setting.
can_authoritative_reply Who can create authoritative reply setting.
can_ban_users Who can ban users setting.
can_change_tags_and_categories Who can change tags and categories setting.
can_contact_owner Who can contact the group's owner setting.
can_delete_any_post Who can delete any post setting.
can_delete_topics Who can delete topics setting.
can_edit_forum_alerts Who can edit forum alerts setting.
can_edit_others_post Who can edit other's posts setting.
can_edit_own_post Who can edit own post setting.
can_enter_free_tags Who can enter free tags setting.
can_have_custom_photo Who can have custom photo setting.
can_hide_abuse Who can hide abuse setting.
can_invite_members Who can invite members setting.
can_join Who can join setting.
can_lock_topics Who can lock topics setting.
can_mark_duplicate Who can mark topics as duplicates setting.
can_mark_favorite_reply_on_own_topics Who can mark favourite reply on own topics setting.
can_mark_favorite_reply_others Who can mark other topics as favorite replies setting.
can_mark_no_response_needed Who can mark post not needing response setting.
can_mark_topics_as_sticky Who can mark topics as sticky setting.
can_me_too Who can mark post as me too setting.
can_modify_members Who can modify members setting.
can_modify_roles Who can modify roles setting.
can_move_individual_messages Who can move individual messages setting.
can_move_topics_in Who can move topics in setting.
can_move_topics_out Who can move topics out setting.
can_post Who can post setting.
can_post_announcements Who can post announcements setting.
can_post_as_group Who can post as the group setting.
can_post_moderated Who can post moderated setting.
can_post_rich_text Who can post rich text setting.
can_reply_to_author Who can reply to author setting.
can_reply_to_auto_closed Who can reply to post auto closed setting.
can_send_private_messages Who can send private messages setting.
can_take_topics Who can take topics setting.
can_unassign_topics Who can unassign topics setting.
can_unmark_favorite_reply Who can unmark favorite reply setting.
can_use_canned_responses Who can use canned responses setting.
can_view_member_emails Who can view members' emails setting.
can_view_members Who can view members setting.
can_view_topics Who can view topics setting.
|
group_email |
string
Email address of the target group.
|
new_value_repeated |
string
New values of the group setting (several values).
Possible values:
managers Managers of the group.
members Members of the group.
none
only_invited Only invited.
organization Anyone in the organization.
organization_can_ask Anyone in the organization can ask.
owners Owners of the group.
public Everyone has the permission.
public_can_ask Anyone can ask.
|
old_value_repeated |
string
Old values of the group setting (several values).
Possible values:
managers Managers of the group.
members Members of the group.
none
only_invited Only invited.
organization Anyone in the organization.
organization_can_ask Anyone in the organization can ask.
owners Owners of the group.
public Everyone has the permission.
public_can_ask Anyone can ask.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=change_acl_permission&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} changed {acl_permission} from {old_value_repeated} to {new_value_repeated} in group {group_email}
|
Moderator action
Events of this type are returned with type=moderator_action
.
Actor user accepted invitation to a group
Actor user accepting an invitation to a group.
Event details |
Event name |
accept_invitation |
Parameters |
group_email |
string
Email address of the target group.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=accept_invitation&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} accepted an invitation to group {group_email}
|
Actor user approved request from other user
An user approving a join request from another user.
Event details |
Event name |
approve_join_request |
Parameters |
group_email |
string
Email address of the target group.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=approve_join_request&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} approved join request from {user_email} to group {group_email}
|
Actor user joined a group
Actor user who added himself or herself to the group.
Event details |
Event name |
join |
Parameters |
group_email |
string
Email address of the target group.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=join&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} added himself or herself to group {group_email}
|
Actor user joined a group via mail command
Actor user added himself or herself to a group via mail command.
Event details |
Event name |
join_via_mail |
Parameters |
group_email |
string
Email address of the target group.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=join_via_mail&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} added himself or herself to group {group_email} via mail command
|
Actor user requested to join a group
Actor user requesting to join a group.
Event details |
Event name |
request_to_join |
Parameters |
group_email |
string
Email address of the target group.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=request_to_join&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} requested to join group {group_email}
|
Actor user requested to join a group via mail command
Event details |
Event name |
request_to_join_via_mail |
Parameters |
group_email |
string
Email address of the target group.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=request_to_join_via_mail&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} requested to join group {group_email} via mail command
|
Group basic setting changed
Event details |
Event name |
change_basic_setting |
Parameters |
basic_setting |
string
Group basic setting updated.
Possible values:
allow_external_members Allow external members.
allow_posting_by_email Allow posting by email.
allow_web_posting Allow users to post to the group on the web.
archive_messages Archive messages to the group.
authors_receive_bounce_replies Authors should receive bounced email notifications.
categories_enabled Categories enabled.
every_display_name_must_be_unique Every display name must be unique.
include_custom_footer Include custom footer text setting.
include_group_web_url_in_footer Include group web URL in email footer.
send_reject_notification_to_author Notify authors when moderators reject their messages.
show_in_groups_directory List this group in the directory.
suppress_footer_separator Suppress email footer separator.
tags_enabled Tags enabled.
|
group_email |
string
Email address of the target group.
|
new_value |
string
New value of the group setting.
Possible values:
|
old_value |
string
Old value of the group setting.
Possible values:
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=change_basic_setting&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} changed {basic_setting} from {old_value} to {new_value} in group {group_email}
|
Group created
Event details |
Event name |
create_group |
Parameters |
group_email |
string
Email address of the target group.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=create_group&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} created group {group_email}
|
Group deleted
Event details |
Event name |
delete_group |
Parameters |
group_email |
string
Email address of the target group.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=delete_group&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} deleted group {group_email}
|
Group email subscription type changed
A member's email subscription type setting is changed.
Event details |
Event name |
change_email_subscription_type |
Parameters |
group_email |
string
Email address of the target group.
|
new_value |
string
New value of the group setting.
Possible values:
abridged No more than one email a day.
all_messages All messages, as they come.
digest Up to 25 messages bundled into a single email.
no_messages No email messages.
remove Indicate that the subscription should be removed.
|
old_value |
string
Old value of the group setting.
Possible values:
abridged No more than one email a day.
all_messages All messages, as they come.
digest Up to 25 messages bundled into a single email.
no_messages No email messages.
remove Indicate that the subscription should be removed.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=change_email_subscription_type&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} in group {group_email} changed the email subscription type for user {user_email} from {old_value} to {new_value}
|
Group identity setting changed
An identity setting changed.
Event details |
Event name |
change_identity_setting |
Parameters |
group_email |
string
Email address of the target group.
|
identity_setting |
string
Identity setting.
Possible values:
required_forms_of_identity Setting for choosing required forms of identity.
|
new_value |
string
New value of the group setting.
Possible values:
display_name_only Only display names are a valid form of identity in the group.
display_name_or_google_profile Either display name or Google profile are valid forms of identity in the group.
organization_profile_only Only organization profiles are a valid form of identity in the group.
|
old_value |
string
Old value of the group setting.
Possible values:
display_name_only Only display names are a valid form of identity in the group.
display_name_or_google_profile Either display name or Google profile are valid forms of identity in the group.
organization_profile_only Only organization profiles are a valid form of identity in the group.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=change_identity_setting&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} changed {identity_setting} from {old_value} to {new_value} in group {group_email}
|
Group info setting added
A group info setting has been added.
Event details |
Event name |
add_info_setting |
Parameters |
group_email |
string
Email address of the target group.
|
info_setting |
string
Group info setting updated.
Possible values:
custom_footer Custom footer.
custom_reply_to_address Custom reply-to address.
group_email Group email address.
group_language Group language.
group_name Group name.
max_message_size Maximum message size.
subject_prefix Subject prefix.
|
value |
string
Value of the group setting.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=add_info_setting&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} added {info_setting} with value {value} in group {group_email}
|
Group info setting changed
A group info setting changed.
Event details |
Event name |
change_info_setting |
Parameters |
group_email |
string
Email address of the target group.
|
info_setting |
string
Group info setting updated.
Possible values:
custom_footer Custom footer.
custom_reply_to_address Custom reply-to address.
group_email Group email address.
group_language Group language.
group_name Group name.
max_message_size Maximum message size.
subject_prefix Subject prefix.
|
new_value |
string
New value of the group setting.
|
old_value |
string
Old value of the group setting.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=change_info_setting&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} changed {info_setting} from {old_value} to {new_value} in group {group_email}
|
Group info setting removed
A group info setting has been removed.
Event details |
Event name |
remove_info_setting |
Parameters |
group_email |
string
Email address of the target group.
|
info_setting |
string
Group info setting updated.
Possible values:
custom_footer Custom footer.
custom_reply_to_address Custom reply-to address.
group_email Group email address.
group_language Group language.
group_name Group name.
max_message_size Maximum message size.
subject_prefix Subject prefix.
|
value |
string
Value of the group setting.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=remove_info_setting&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} removed {info_setting} with value {value} in group {group_email}
|
Group new members restrictions setting changed
A new members restrictions setting changed.
Event details |
Event name |
change_new_members_restrictions_setting |
Parameters |
group_email |
string
Email address of the target group.
|
new_members_restrictions_setting |
string
New members restriction setting.
Possible values:
new_members_can_post Setting to control if new members can post.
new_members_can_post_moderated Setting to control if new members can post moderated.
|
new_value |
string
New value of the group setting.
Possible values:
inherit This setting was inherited from other group setting.
overriden_to_false This setting has been overridden to false. This is applied to boolean settings which can have a true/false value by default.
overriden_to_true This setting has been overridden to true. This is applied to boolean settings which can have a true/false value by default.
|
old_value |
string
Old value of the group setting.
Possible values:
inherit This setting was inherited from other group setting.
overriden_to_false This setting has been overridden to false. This is applied to boolean settings which can have a true/false value by default.
overriden_to_true This setting has been overridden to true. This is applied to boolean settings which can have a true/false value by default.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=change_new_members_restrictions_setting&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} changed {new_members_restrictions_setting} from {old_value} to {new_value} in group {group_email}
|
Group post replies setting changed
A post replies setting changed.
Event details |
Event name |
change_post_replies_setting |
Parameters |
group_email |
string
Email address of the target group.
|
new_value |
string
New value of the group setting.
Possible values:
reply_to_author_only Setting used to set replies to the author of the message only.
reply_to_custom_address Setting used to set replies to a custom address.
reply_to_entire_group Setting used to set replies to the entire group.
reply_to_managers Setting used to set replies to the managers of the group only.
reply_to_owners Setting used to set replies to the owners of the group only.
users_decide_where_to_reply Setting used to allow user to specify where to send the reply.
|
old_value |
string
Old value of the group setting.
Possible values:
reply_to_author_only Setting used to set replies to the author of the message only.
reply_to_custom_address Setting used to set replies to a custom address.
reply_to_entire_group Setting used to set replies to the entire group.
reply_to_managers Setting used to set replies to the managers of the group only.
reply_to_owners Setting used to set replies to the owners of the group only.
users_decide_where_to_reply Setting used to allow user to specify where to send the reply.
|
post_replies_setting |
string
Post replies setting.
Possible values:
where_should_replies_be_sent Setting to control to which email address(s) messages should be sent.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=change_post_replies_setting&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} changed {post_replies_setting} from {old_value} to {new_value} in group {group_email}
|
Group spam moderation setting changed
A spam moderation setting changed.
Event details |
Event name |
change_spam_moderation_setting |
Parameters |
group_email |
string
Email address of the target group.
|
new_value |
string
New value of the group setting.
Possible values:
moderate_and_do_not_send_notifications Send spam messages to the moderation queue but do not send a notification to the moderators.
moderate_and_send_notifications Send spam messages to the moderation queue and send a notification to the moderators.
reject_immediately Reject spam messages immediately.
skip_moderation_queue Skip the moderation queue and post to the group.
|
old_value |
string
Old value of the group setting.
Possible values:
moderate_and_do_not_send_notifications Send spam messages to the moderation queue but do not send a notification to the moderators.
moderate_and_send_notifications Send spam messages to the moderation queue and send a notification to the moderators.
reject_immediately Reject spam messages immediately.
skip_moderation_queue Skip the moderation queue and post to the group.
|
spam_moderation_setting |
string
Spam moderation setting.
Possible values:
how_to_handle_suspected_spam_messages Setting to decide how to handle suspected spam messages.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=change_spam_moderation_setting&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} changed {spam_moderation_setting} from {old_value} to {new_value} in group {group_email}
|
Group topic setting changed
A topic setting changed.
Event details |
Event name |
change_topic_setting |
Parameters |
group_email |
string
Email address of the target group.
|
new_value |
string
New value of the group setting.
Possible values:
discussions Discussions.
discussions_questions Discussions and Questions.
questions Questions.
|
old_value |
string
Old value of the group setting.
Possible values:
discussions Discussions.
discussions_questions Discussions and Questions.
questions Questions.
|
topic_setting |
string
Topic setting.
Possible values:
allowed_topic_types Allowed topic types.
default_topic_type Default topic Type.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=change_topic_setting&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} changed {topic_setting} from {old_value} to {new_value} in group {group_email}
|
Message moderated
Description for moderated message.
Event details |
Event name |
moderate_message |
Parameters |
group_email |
string
Email address of the target group.
|
message_id |
string
SMTP message Id of an email message.
|
message_moderation_action |
string
Message moderation action.
Possible values:
approved Message approved by moderator.
rejected Message rejected by moderator.
|
status |
string
A status describing the output of an operation.
Possible values:
failed Failed.
succeeded Succeeded.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=moderate_message&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} moderated message in {group_email} with action: {message_moderation_action} and result: {status}. Message details: Message Id: {message_id}
|
Posts from user will always be posted
Event details |
Event name |
always_post_from_user |
Parameters |
group_email |
string
Email address of the target group.
|
status |
string
A status describing the output of an operation.
Possible values:
failed Failed.
succeeded Succeeded.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=always_post_from_user&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} made posts from {user_email} to always be posted in {group_email} with result: {status}
|
User added to a group
User added to group.
Event details |
Event name |
add_user |
Parameters |
group_email |
string
Email address of the target group.
|
member_role |
string
A group's member role.
Possible values:
manager Manager.
member Member.
owner Owner.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=add_user&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} added {user_email} to group {group_email} with role {member_role}
|
User banned from group during message moderation
User banned from group with a moderation.
Event details |
Event name |
ban_user_with_moderation |
Parameters |
group_email |
string
Email address of the target group.
|
status |
string
A status describing the output of an operation.
Possible values:
failed Failed.
succeeded Succeeded.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=ban_user_with_moderation&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} banned user {user_email} from group {group_email} with result: {status} during message moderation
|
User invitation revoked from a group
User invitation to a group was revoked.
Event details |
Event name |
revoke_invitation |
Parameters |
group_email |
string
Email address of the target group.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=revoke_invitation&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} revoked invitation to {user_email} from group {group_email}
|
User invited to a group
Event details |
Event name |
invite_user |
Parameters |
group_email |
string
Email address of the target group.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=invite_user&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} invited {user_email} to group {group_email}
|
User join request rejected from a group
Event details |
Event name |
reject_join_request |
Parameters |
group_email |
string
Email address of the target group.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=reject_join_request&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} rejected join request from {user_email} to group {group_email}
|
User reinvited to a group
Event details |
Event name |
reinvite_user |
Parameters |
group_email |
string
Email address of the target group.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=reinvite_user&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} reinvited {user_email} to group {group_email}
|
User removed from a group
Event details |
Event name |
remove_user |
Parameters |
group_email |
string
Email address of the target group.
|
user_email |
string
Email address of the user.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=remove_user&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} removed {user_email} from group {group_email}
|
User unsubscribed a group via mail command
Event details |
Event name |
unsubscribe_via_mail |
Parameters |
group_email |
string
Email address of the target group.
|
|
Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/groups?eventName=unsubscribe_via_mail&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
Admin Console message format |
{actor} unsubscribed group {group_email} via mail command
|