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
change_acl_permission
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.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= change_acl_permission
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{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.
accept_invitation
group_
email
string
Email address of the target group.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= accept_invitation
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
accepted an invitation to group {group_email}
Actor user approved request from other user
An user approving a join request from another user.
approve_join_request
group_
|
Email address of the target group. |
user_
|
Email address of the user. |
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= approve_join_request
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{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.
join
group_
email
string
Email address of the target group.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= join
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{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.
join_via_mail
group_
email
string
Email address of the target group.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= join_via_mail
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{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.
request_to_join
group_
email
string
Email address of the target group.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= request_to_join
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
requested to join group {group_email}
Actor user requested to join a group via mail command
request_to_join_via_mail
group_
email
string
Email address of the target group.
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
{actor}
requested to join group {group_email}
via mail command
Group basic setting changed
change_basic_setting
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:
-
false
False. -
true
True.
old_
value
string
Old value of the group setting. Possible values:
-
false
False. -
true
True.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= change_basic_setting
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
changed {basic_setting}
from {old_value}
to {new_value}
in group {group_email}
Group created
create_group
group_
email
string
Email address of the target group.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= create_group
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
created group {group_email}
Group deleted
delete_group
group_
email
string
Email address of the target group.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= delete_group
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
deleted group {group_email}
Group email subscription type changed
A member's email subscription type setting is changed.
change_email_subscription_type
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.
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
{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.
change_identity_setting
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.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= change_identity_setting
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{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.
add_info_setting
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.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= add_info_setting
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
added {info_setting}
with value {value}
in group {group_email}
Group info setting changed
A group info setting changed.
change_info_setting
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.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= change_info_setting
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{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.
remove_info_setting
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.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= remove_info_setting
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
removed {info_setting}
with value {value}
in group {group_email}
Group new members restrictions setting changed
A new members restrictions setting changed.
change_new_members_restrictions_setting
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.
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
{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.
change_post_replies_setting
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.
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
{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.
change_spam_moderation_setting
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.
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
{actor}
changed {spam_moderation_setting}
from {old_value}
to {new_value}
in group {group_email}
Group topic setting changed
A topic setting changed.
change_topic_setting
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.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= change_topic_setting
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
changed {topic_setting}
from {old_value}
to {new_value}
in group {group_email}
Message moderated
Description for moderated message.
moderate_message
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.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= moderate_message
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{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
always_post_from_user
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.
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
{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.
add_user
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.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= add_user
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{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.
ban_user_with_moderation
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.
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
{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.
revoke_invitation
group_
|
Email address of the target group. |
user_
|
Email address of the user. |
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= revoke_invitation
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
revoked invitation to {user_email}
from group {group_email}
User invited to a group
invite_user
group_
|
Email address of the target group. |
user_
|
Email address of the user. |
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= invite_user
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
invited {user_email}
to group {group_email}
User join request rejected from a group
reject_join_request
group_
|
Email address of the target group. |
user_
|
Email address of the user. |
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= reject_join_request
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
rejected join request from {user_email}
to group {group_email}
User reinvited to a group
reinvite_user
group_
|
Email address of the target group. |
user_
|
Email address of the user. |
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= reinvite_user
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
reinvited {user_email}
to group {group_email}
User removed from a group
remove_user
group_
|
Email address of the target group. |
user_
|
Email address of the user. |
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= remove_user
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
removed {user_email}
from group {group_email}
User unsubscribed a group via mail command
unsubscribe_via_mail
group_
email
string
Email address of the target group.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ groups
?eventName= unsubscribe_via_mail
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{actor}
unsubscribed group {group_email}
via mail command