Stay organized with collections
Save and categorize content based on your preferences.
This document lists the events and parameters for
Group Settings
Admin Audit activity events. You can retrieve these events by
calling Activities.list()
with applicationName=admin.
Group Settings
Events of this type are returned with type=GROUP_SETTINGS.
Filtering groups updated
Whitelisted groups updated event.
Event details
Event name
WHITELISTED_GROUPS_UPDATED
Parameters
WHITELISTED_GROUPS
string
A comma-separated list of the names of whitelisted groups.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=WHITELISTED_GROUPS_UPDATED&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
Filtering groups updated to {WHITELISTED_GROUPS}
Group Creation
Event details
Event name
CREATE_GROUP
Parameters
GROUP_EMAIL
string
The group's primary email address.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=CREATE_GROUP&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
Group {GROUP_EMAIL} created
Group Deletion
Event details
Event name
DELETE_GROUP
Parameters
GROUP_EMAIL
string
The group's primary email address.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=DELETE_GROUP&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
Group {GROUP_EMAIL} deleted
Group Description Change
Event details
Event name
CHANGE_GROUP_DESCRIPTION
Parameters
GROUP_EMAIL
string
The group's primary email address.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=CHANGE_GROUP_DESCRIPTION&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
Description for group {GROUP_EMAIL} changed
Group List Download
Event details
Event name
GROUP_LIST_DOWNLOAD
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=GROUP_LIST_DOWNLOAD&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
Group list was downloaded as a CSV file
Group Member Creation
Event details
Event name
ADD_GROUP_MEMBER
Parameters
GROUP_EMAIL
string
The group's primary email address.
USER_EMAIL
string
The user's primary email address.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=ADD_GROUP_MEMBER&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
User {USER_EMAIL} created under group {GROUP_EMAIL}
Group Member Deletion
Event details
Event name
REMOVE_GROUP_MEMBER
Parameters
GROUP_EMAIL
string
The group's primary email address.
USER_EMAIL
string
The user's primary email address.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=REMOVE_GROUP_MEMBER&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
User {USER_EMAIL} deleted from group {GROUP_EMAIL}
Group Member Update
Group Setting Change.
Event details
Event name
UPDATE_GROUP_MEMBER
Parameters
GROUP_EMAIL
string
The group's primary email address.
NEW_VALUE
string
The new SETTING_NAME value that was set during this event.
OLD_VALUE
string
The previous SETTING_NAME value that was replaced during this event.
USER_EMAIL
string
The user's primary email address.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=UPDATE_GROUP_MEMBER&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
Roles of the user {USER_EMAIL} in group {GROUP_EMAIL} updated from {OLD_VALUE} to {NEW_VALUE}
Group Member Update
Group Member Delivery Settings Change.
Event details
Event name
UPDATE_GROUP_MEMBER_DELIVERY_SETTINGS
Parameters
GROUP_EMAIL
string
The group's primary email address.
NEW_VALUE
string
The new SETTING_NAME value that was set during this event.
OLD_VALUE
string
The previous SETTING_NAME value that was replaced during this event.
USER_EMAIL
string
The user's primary email address.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=UPDATE_GROUP_MEMBER_DELIVERY_SETTINGS&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
DeliverySettings of the user {USER_EMAIL} in group {GROUP_EMAIL} updated from {OLD_VALUE} to {NEW_VALUE}
Group Member Update
Group Member Delivery Settings Email Override Change.
The new SETTING_NAME value that was set during this event.
OLD_VALUE
string
The previous SETTING_NAME value that was replaced during this event.
USER_EMAIL
string
The user's primary email address.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=UPDATE_GROUP_MEMBER_DELIVERY_SETTINGS_CAN_EMAIL_OVERRIDE&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
DeliverySettings Email Override of the user {USER_EMAIL} in group {GROUP_EMAIL} updated from {OLD_VALUE} to {NEW_VALUE}
Group Members Bulk Upload
Event details
Event name
GROUP_MEMBER_BULK_UPLOAD
Parameters
GROUP_MEMBER_BULK_UPLOAD_FAILED_NUMBER
string
The number of failures when attemping to bulk upload group members.
GROUP_MEMBER_BULK_UPLOAD_TOTAL_NUMBER
string
The total number of bulk uploaded group members.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=GROUP_MEMBER_BULK_UPLOAD&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
A total of {GROUP_MEMBER_BULK_UPLOAD_TOTAL_NUMBER} members selected for upload. {GROUP_MEMBER_BULK_UPLOAD_FAILED_NUMBER} out of {GROUP_MEMBER_BULK_UPLOAD_TOTAL_NUMBER} members failed to be uploaded
Group Members Download
Event details
Event name
GROUP_MEMBERS_DOWNLOAD
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=GROUP_MEMBERS_DOWNLOAD&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
Group member list was downloaded as a CSV file
Group Name Change
Event details
Event name
CHANGE_GROUP_NAME
Parameters
GROUP_EMAIL
string
The group's primary email address.
NEW_VALUE
string
The new SETTING_NAME value that was set during this event.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=CHANGE_GROUP_NAME&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
Name of group {GROUP_EMAIL} changed to {NEW_VALUE}
Group Setting Change
Event details
Event name
CHANGE_GROUP_SETTING
Parameters
GROUP_EMAIL
string
The group's primary email address.
NEW_VALUE
string
The new SETTING_NAME value that was set during this event.
OLD_VALUE
string
The previous SETTING_NAME value that was replaced during this event.
SETTING_NAME
string
The unique name (ID) of the setting that was changed.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/admin?eventName=CHANGE_GROUP_SETTING&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{SETTING_NAME} for group {GROUP_EMAIL} changed from {OLD_VALUE} to {NEW_VALUE}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-08-21 UTC."],[[["This document outlines Admin Audit activity events related to Group Settings, accessible via the Activities.list() API call."],["Events cover a range of actions, including group creation, deletion, member management, and setting modifications."],["Each event has specific parameters for filtering and retrieving detailed information about the activity."],["Admin Console message formats show how event information is presented within the Google Admin console."],["Sample requests demonstrate how to query the API for specific group setting events."]]],[]]
