Access Transparency Activity Events
This document lists the events and parameters for
various types of
Access Transparency activity events. You can retrieve these events by
calling Activities.list()
with applicationName=access_transparency.
Google Workspace Resource Event
Events of this type are returned with type=GSUITE_RESOURCE.
ACCESS
A Google Workspace resource was accessed by Google.
| Event details |
| Event name |
ACCESS |
| Parameters |
ACCESS_APPROVAL_ALERT_CENTER_IDS |
string
Parameter for the Access Approval Alert Center IDs.
|
ACCESS_APPROVAL_REQUEST_IDS |
string
Parameter for the Access Approval ticket IDs.
|
ACCESS_MANAGEMENT_POLICY |
string
Parameter for the Access Management Policy.
|
ACTOR_HOME_OFFICE |
string
The home office of the actor who performed the data access. Possible values:
- ISO 3166-1 alpha-2 country code in which the actor has a permanent desk.
- "??" if location is not available.
- 3-character continent identifier where actor is in a low-population country
(ASI, EUR, OCE, AFR, NAM, SAM, ANT).
Actor refers to a Google employee.
|
GSUITE_PRODUCT_NAME |
string
Google Workspace product name.
Possible values:
CALENDAR
Google Calendar.DRIVE
Google Drive.GMAIL
Google Gmail.SEARCH_AND_INTELLIGENCE
Search and Intelligence.SHEETS
Google Sheets.SLIDES
Google Slides.
|
JUSTIFICATIONS |
string
Access justifications, such as "Customer Initiated Support - Case Number: 12345678".
|
LOG_ID |
string
Unique log ID.
|
ON_BEHALF_OF |
string
Parameter for the resource sharee email(s).
|
OWNER_EMAIL |
string
The email ID or team identifier of the customer who owns the resource.
|
RESOURCE_NAME |
string
Name of the resource that was accessed.
|
TICKETS |
string
Parameter for tickets.
|
|
| Sample request |
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/access_transparency?eventName=ACCESS&maxResults=10&access_token=YOUR_ACCESS_TOKEN
|
| Admin Console message format |
Access to {RESOURCE_NAME} has been logged. Please have your Google Workspace Super Admin visit the Access Transparency report in the Admin Dashboard to view more details about this log
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-21 UTC.
[null,null,["Last updated 2024-08-21 UTC."],[[["Access Transparency activity events provide insights into Google's access to your Google Workspace data."],["You can retrieve event details, including justifications, resource names, and actor information using the Activities.list() method with applicationName=access_transparency."],["The `ACCESS` event indicates a Google Workspace resource was accessed by Google, and it provides details like product name, resource name, and actor's home office."],["Admins can find further details about these access logs within the Access Transparency report in the Admin Dashboard."]]],[]]
