In an effort to make the reports for Admin log events more understandable, detailed, and precise, there are updates to some event names and types as well as reporting frequency and event conditions. Between now and August 2026, legacy and updated event names and types will be available. After August 2026, only the new event names and types will be available.
Saved investigations will continue to work, but they will be based on legacy events and will stop working after August 2026. After August 2026, custom charts in the security investigation tool will be based on old data.
What you need to do
- Review the changes listed on this page. If you're using or relying on any of the events listed on this page, you might need to make changes to your existing queries, alerts, reports, and rules.
- Between now and August 2026, rules that are affected will be automatically migrated and you might need to make changes to your rules. For details on updating any migrated rules, go to View and edit your activity rules.
Important: If you don't update rules that have changes to more than one event condition, you'll get increased alerts. Rules that have 2 conditions that are true will trigger an alert even if only one condition is true. For example, if a rule triggers an alert for a change to a specific Gmail setting, you will get an alert for all Gmail setting changes.
Changes to Admin log events
Account & security
| Admin console setting | Security & Audit and investigation tool | Reports API & Google SecOps | BigQuery Export |
|---|---|---|---|
| Account settings > Preferences > New features |
Toggle New App Features event name is renamed to Toggle New App Features Preference. Value for New Value changes from True or False to Rapid release or Scheduled release. Description value changes from New app features for your organization changed to value to The account setting of "New Features" was changed from value1 to value2. The Old Value attribute is introduced. Its values are Rapid release and Scheduled release. The New Features value is added to the Setting Category attribute. |
|
|
| Security > Access and data control > Google Cloud session control > Reauthentication policy |
New Value and Old Value attributes for Session Control Settings Change records values for reauthentication frequency, idle session timeout, and reauthentication method in separate log events. Previously, all 3 settings were recorded in one log event. If any of the settings are unchanged, no log event is recorded for that setting. |
If any of the settings are unchanged, no log event is recorded for that setting. |
If any of the settings are unchanged, no log event is recorded for that setting. |
App access control
Reports API & SecOps events[].name& BigQuery Export event_name |
Security & Audit and investigation tool event name |
New events[].name & event_name |
New Security & Audit and investigation tool event name |
|---|---|---|---|
| DISALLOW_ |
API Access Blocked | CHANGE_ |
API Access Changed |
| ALLOW_ |
API Access Allowed | CHANGE_ |
API Access Changed |
| ADD_ |
App Added to Blocked List | CHANGE_ |
App Configuration Changed |
| ADD_ |
App Added to Limited List | CHANGE_ |
App Configuration Changed |
| ADD_ |
App Added to Trusted Allowlist | CHANGE_ |
App Configuration Changed |
| ADD_ |
App added to Trusted by OAuth Scope list | CHANGE_ |
App Configuration Changed |
| ADD_ |
App allowlisted for exemption from API access blocks | CHANGE_ |
App Configuration Changed |
| REMOVE_ |
App Removed from Trusted Allowlist | CHANGE_ |
App Configuration Changed |
| REMOVE_ |
App no longer allowlisted for exemption from API access blocks | CHANGE_ |
App Configuration Changed |
| REMOVE_ |
App Removed from Blocked List | CHANGE_ |
App Configuration Changed |
| REMOVE_ |
App removed from Limited list | CHANGE_ |
App Configuration Changed |
| REMOVE_ |
App removed from Trusted by OAuth Scope list | CHANGE_ |
App Configuration Changed |
| BLOCK_ |
All third party API access blocked | CHANGE_ |
Unconfigured Apps Access Changed |
| UNBLOCK_ |
All third party API access unblocked | CHANGE_ |
Unconfigured Apps Access Changed |
| SIGN_ |
Allow Google Sign-in only third party API access | CHANGE_ |
Unconfigured Apps Access Changed |
| UNDERAGE_ |
All third party API access blocked | CHANGE_ |
Under 18 Unconfigured Apps Access Changed |
| UNDERAGE_ |
Allow Google Sign-in only third party API access | CHANGE_ |
Under 18 Unconfigured Apps Access Changed |
Google Drive settings with inherited values
Previously, Google Drive settings that were overridden from an inherited value or reverted to an inherited value used the same log event identifiers, with INHERIT_FROM_PARENT in the old value and new value attributes:
- Security & Audit and investigation tool: The Change Drive Setting event name showed INHERIT_FROM_PARENT in Old value and New value
- Reports API & SecOps:
events[].type=DOCS_SETTINGS,events[].name=CHANGE_DOCS_SETTINGshowed INHERIT_FROM_PARENT inadmin.old_valueandadmin.new_value - BigQuery Export:
events_type=DOCS_SETTINGS,event_name=CHANGE_DOCS_SETTINGshowed INHERIT_FROM_PARENT inadmin.old_valueandadmin.new_value
| Tool | Override an inherited value | Change an existing value | Revert to an inherited value |
| Security & Audit and investigation tool | Event name: Create Application Setting |
Event name: Change Application Setting |
Event name: Delete Application Setting |
| Reports API & SecOps | Event type: APPLICATION_ Event name: CREATE_ |
Event type: APPLICATION_ Event name: CHANGE_ |
Event type: APPLICATION_ Event name: DELETE_ |
| BigQuery Export | Event type: APPLICATION_ Event name: CREATE_ |
Event type: APPLICATION_ Event name: CHANGE_ |
Event type: APPLICATION_ Event name: DELETE_ |
Drive settings
The following table lists updated log event information for the following Admin log event attributes and values:
- Security & Audit and investigation tool: Setting name, Old value, New value
- BigQuery Export:
admin.setting_name,admin.old_value,admin.new_value - Reports API & SecOps:
events[].parameters[].name=setting_name,events[].parameters[].name=OLD_VALUEorNEW_VALUE
|
Old event |
Updated event |
||
|
Setting name |
Old or new value |
Setting name |
Old or new value |
|
SHARING_ |
SHARING_ |
ExternalSharing external_ |
DISALLOWED |
|
ExternalSharing allow_ |
true |
||
|
SHARING_ |
ExternalSharing external_ |
DISALLOWED |
|
|
ExternalSharing allow_ |
false |
||
|
TRUSTED_ |
ExternalSharing external_ |
ALLOWLISTED_DOMAINS |
|
|
ExternalSharing warn_ |
true |
||
|
ExternalSharing allow_ |
true |
||
|
TRUSTED_ |
ExternalSharing external_ |
ALLOWLISTED_DOMAINS |
|
|
ExternalSharing warn_ |
true |
||
|
ExternalSharing allow_ |
false |
||
|
TRUSTED_ |
ExternalSharing external_ |
ALLOWLISTED_DOMAINS |
|
|
ExternalSharing warn_ |
false |
||
|
ExternalSharing allow_ |
true |
||
|
TRUSTED_ |
ExternalSharing external_ |
ALLOWLISTED_DOMAINS |
|
|
ExternalSharing warn_ |
false |
||
|
ExternalSharing allow_ |
false |
||
|
SHARING_ |
ExternalSharing external_ |
ALLOWED |
|
|
ExternalSharing warn_ |
true |
||
|
SHARING_ |
ExternalSharing external_ |
ALLOWED |
|
|
ExternalSharing warn_ |
false |
||
|
SHARING_ |
NOT_ |
ExternalSharing allow_ |
false |
|
ANONYMOUS_ |
ExternalSharing allow_ |
true |
|
|
PUBLISHING_ |
NOT_ |
ExternalSharing allow_ |
false |
|
ALLOWED |
true |
||
|
SHARING_ |
NAMED_ |
ExternalSharing access_ |
RECIPIENTS_ |
|
DOMAIN_ |
RECIPIENTS_ |
||
|
ALL |
RECIPIENTS_ |
||
|
SHARING_ |
CROSS_ |
ExternalSharing allowed_ |
ALL_ |
|
CROSS_ |
ELIGIBLE_ |
||
|
CROSS_ |
NONE |
||
|
DEFAULT_ |
PRIVATE |
GeneralAccessDefault default_ |
PRIVATE_ |
|
PEOPLE_ |
PRIMARY_ |
||
|
PUBLIC |
PRIMARY_ |
||
|
DOCS_ |
false |
DocsOffline enable_ |
false |
|
true |
true |
||
|
ENABLE_ |
false |
DriveSdk enable_ |
false |
|
true |
true |
||
Gmail settings
For all affected settings in Reports API & SecOps:
events[].typeEMAIL_SETTINGS is renamed to APPLICATION_SETTINGSevents[].parameters[].name=USER_DEFINED_SETTING_NAME is moved toevents[].parameters[].name=SETTING_METADATA.USER_DEFINED_NAME
For all affected settings in BigQuery Export:
event_typeEMAIL_SETTINGS is renamed to APPLICATION_SETTINGS- admin.user_defined_setting_name is moved to admin.setting_metadata.user_defined_name
|
Gmail setting |
Security & Audit and investigation tool |
Reports API & SecOps | BigQuery Export |
|---|---|---|---|
|
Mail delegation |
Change Email Setting is renamed to Change/Create/Delete Application Setting ENABLE_ |
|
|
|
Image URL proxy allowlist |
Change Email Setting is renamed to Change/Create/Delete Application Setting NUMBER_ |
|
|
|
Compliance > Restrict delivery |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting RESTRICT_ |
|
|
|
Compliance > Comprehensive mail storage |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting COMPREHENSIVE_ |
|
|
|
Spam, phishing, and malware > Inbound gateway |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting INBOUND_ |
|
|
|
Routing > Email forwarding using recipient address map |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting ALIAS_ |
|
|
|
Compliance > Content compliance |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting CONTENT_ |
|
|
|
Default Routing > Default Routing |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting DOMAIN_ |
|
|
|
Routing > Routing |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting UNIFIED_ |
|
|
|
Routing > Inbound email journal acceptance in Vault |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting INBOUND_ |
|
|
|
Blocked senders |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting BLOCKED_ |
|
|
|
Routing > Third-party email archiving |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting OUTBOUND_ |
|
|
|
Routing > Non-Gmail mailbox |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting QUARANTINE_ |
|
|
|
Routing > SMTP relay service |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting OUTBOUND_ |
|
|
|
Spam, phishing, and malware > Security sandbox rules |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting SECURITY_ |
|
|
|
Compliance > Secure transport (TLS) compliance |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting TLS_ |
|
|
|
Spam, phishing, and malware > Spam |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting SPAM_ |
|
|
|
Compliance > Objectable content |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting OBJECTIONABLE_ |
|
|
|
Routing > Alternate secure route |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting ALTERNATE_ |
|
|
|
Compliance > Attachment compliance |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting ATTACHMENT_ |
|
|
|
Compliance > Restrict delivery for S/MIME |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting SMIME_ |
|
|
|
Hosts > Hosts |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting EMAIL_ |
|
|
|
Compliance > Append footer |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting COMPLIANCE_ |
|
|
|
Routing > Outbound Gateway |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting EMAIL_ |
|
|
|
User Settings > Email read receipts |
Change Email Setting is renamed to Change/Create/Delete Application Setting EMAIL_ |
|
|
|
User Settings > Name Format |
Change Email Setting is renamed to Change/Create/Delete Application Setting DEFAULT_ |
|
|
|
End User Access > Allow per user outbound gateways |
Change Email Setting is renamed to Change/Create/Delete Application Setting ALLOW_ |
|
|
|
End User Access > Pop and Imap access |
Change Email Setting is renamed to Change/Create/Delete Application Setting IMAP_ ENABLE_POP_ |
|
|
|
End User Access > Automatic Forwarding |
Change Email Setting is renamed to Change/Create/Delete Application Setting ENABLE_ |
|
|
|
End User Access > Google Workspace Sync |
Change Email Setting is renamed to Change/Create/Delete Application Setting ENABLE_ |
|
|
|
Setup > User email uploads |
Change Email Setting is renamed to Change/Create/Delete Application Setting ENABLE_ |
|
|
|
User settings > Themes |
Change Email Setting is renamed to Change/Create/Delete Application Setting ENABLE_ |
|
|
|
Compliance > Optical Character Recognition (OCR) |
Change Email Setting is renamed to Change/Create/Delete Application Setting ENABLE_ |
|
|
|
Manage Quarantines |
Change Email Setting is renamed to Change/Create/Delete Application Setting EMAIL_ |
|
|
|
Manage Google Workspace Marketplace allowlist access |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting ENABLE_ |
|
|
|
Google Workspace Marketplace Apps |
Change/Delete/Create Gmail Setting is renamed to Change/Delete/Create Application Setting The ENABLE_ |
|
|
|
User Settings > S/MIME |
Change Email Setting is renamed to Change/Create/Delete Application Setting EMAIL_ |
|
|
New Gmail parameters
|
Parameter name |
Nested parameter | Reports API & SecOps | BigQuery Export |
|---|---|---|---|
| SETTING_ |
USER_ |
|
admin.setting_ |
|
DESCRIPTION |
|
admin.setting_ |
|
|
rule_ |
|
admin.setting_ |
|
|
rule_ |
|
admin.setting_ |
New Gmail events
Changes to the following Gmail settings (Apps > Google Workspace > Settings for Gmail) in the Admin console will log an event in Admin log events:
- User Settings > S/MIME > Allow SHA-1 globally (not recommended)
- Spam, phishing, and malware > Inbound gateway > Gateway IPs > Add/Delete IP addresses / ranges
- Authenticate email > DKIM authentication > Start/Stop Authentication
- Compliance > Email and chat auto-deletion > Automatically delete email and chat messages older than the specified number of days > Modify the labels to exclude
Changes to the settings will be logged as follows:
- Security & Audit and investigation tool event: Change Application Setting
- Reports API & SecOps:
events[].name=CHANGE_APPLICATION_SETTING,events[].type=APPLICATION_SETTINGS - BigQuery Export:
event_name=CHANGE_APPLICATION_SETTING,event_type=APPLICATION_SETTINGS
Updating automatically migrated rules
Instructions will be added here soon describing how you can find your rules that have been automatically migrated. For details on managing automatically migrated rules, go to Create and manage activity rules.
Changes to event names in the security investigation tool
For the affected event names in the following table:
- Breaking columns are being removed from rule conditions. (A breaking column is a security investigation tool column that has a changed value.)
- Rule creation for these events is being restricted.
- Certain event names will have new conditions, as shown in Updates to event names later on this page.
| Security investigation tool event name | Breaking column name |
|---|---|
| Change email setting | Setting name |
| Resource name | |
| New value | |
| Old value | |
| Change Gmail setting | Setting name |
| Resource name | |
| New value | |
| Old value | |
| Create Gmail setting | Setting name |
| Resource name | |
| New value | |
| Old value | |
| Delete Gmail setting | Setting name |
| Resource name | |
| New value | |
| Old value | |
| Change Drive setting | Setting name |
| New value | |
| Old value | |
| Session control settings change | New value |
| Old value | |
|
No breaking columns |
| Toggle new app features | New value |
Event name change example in the security investigation tool
For all rule conditions joined by AND, we're removing the part of the condition that contains the changing event. The final condition will be a single condition.
If Event name IS Change email setting AND Setting name IS abc, the automatically migrated rule will become Event name IS Change email setting.
Updates to event conditions
We are also updating the following event conditions.
| Event display name | Current condition | New condition |
|---|---|---|
| Change email setting | Event IS Change email setting | (Event IS Change application setting OR Event IS Create application setting OR Event IS Delete application setting) AND Setting Application IS Gmail |
| Change Gmail setting | Event IS Change Gmail setting | (Event IS Change application setting OR Event IS Create application setting OR Event IS Delete application setting) AND Setting Application IS Gmail |
| Create Gmail setting | Event IS Create Gmail setting | Event IS Create application setting AND Setting Application IS Gmail |
| Delete Gmail setting | Event IS Delete Gmail setting | Event IS Delete application setting AND Setting Application IS Gmail |
| Change Drive setting | Event IS Change Drive setting | (Event IS Change application setting OR Event IS Create application setting OR Event IS Delete application setting) AND Setting Application IS Drive and Docs |
| Toggle New App Features | Event IS Toggle New App Features | Event IS Toggle New App Features Preference |
| API Access Blocked | Event IS API Access Blocked | Event IS API Access Changed AND Old Value IS Unrestricted |
| API Access Allowed | Event IS API Access Allowed | Event IS API Access Changed AND New Value IS Unrestricted |
| App Added to Blocked List | Event IS App Added to Blocked List | Event IS App Configuration Changed AND New Value IS Blocked |
| App Added to Limited List | Event IS App Added to Limited List | Event IS App Configuration Changed AND New Value IS Limited |
| App Added to Trusted Allowlist | Event IS App Added to Trusted Allowlist | Event IS App Configuration Changed AND New Value IS Trusted |
| App added to Trusted by OAuth Scope list | Event IS App added to Trusted by OAuth Scope list | Event IS App Configuration Changed AND New Value IS Specific Google data |
| App Removed from Blocked List | Event IS App Removed from Blocked List | Event IS App Configuration Changed AND Old Value IS Blocked AND New Value IS Unconfigured |
| App removed from Limited list | Event IS App removed from Limited list | Event IS App Configuration Changed AND Old Value IS Limited AND New Value IS Unconfigured |
| App Removed from Trusted Allowlist | Event IS App Removed from Trusted Allowlist | Event IS App Configuration Changed AND Old Value IS Trusted AND New Value IS Unconfigured |
| App removed from Trusted by OAuth Scope list | Event IS App removed from Trusted by OAuth Scope list | Event IS App Configuration Changed AND Old Value IS Specific Google data AND New Value IS Unconfigured |
| App allowlisted for exemption from API access blocks | Event IS App allowlisted for exemption from API access blocks | Event IS App Configuration Changed AND New Value IS Trusted and Allowlisted for Context-Aware Access Exemption |
| App no longer allowlisted for exemption from API access blocks | Event IS App no longer allowlisted for exemption from API access blocks | Event IS App Configuration Changed AND Old Value IS Trusted and Allowlisted for Context-Aware Access Exemption AND New Value IS Unconfigured |
| All third party API access blocked | Event IS All third party API access blocked | Event IS Unconfigured Apps Access Changed AND New Value IS Don't Allow |
| All third party API access unblocked | Event IS All third party API access unblocked | Event IS Unconfigured Apps Access Changed AND New Value IS Allow |
| Allow Google Sign-in only third party API access | Event IS Allow Google Sign-in only third party API access | Event IS Unconfigured Apps Access Changed AND New Value IS Allow Google sign-in only |
| All third party API access blocked | Event IS All third party API access blocked | Event IS Under 18 Unconfigured Apps Access Changed AND New Value IS Don't Allow |
| Allow Google Sign-in only third party API access | Event IS Allow Google Sign-in only third party API access | Event IS Under 18 Unconfigured Apps Access Changed AND New Value IS Allow Google sign-in only |