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.
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
[[["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."],[[["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."]]],["Access Transparency events, specifically `GSUITE_RESOURCE` type, log when Google accesses a Workspace resource. Retrieve these events using `Activities.list()` with `applicationName=access_transparency`. The `ACCESS` event indicates resource access and includes parameters like `ACCESS_APPROVAL_ALERT_CENTER_IDS`, `GSUITE_PRODUCT_NAME`, `JUSTIFICATIONS`, `LOG_ID`, and `RESOURCE_NAME`. A sample request demonstrates fetching `ACCESS` events. Admin console messages log access to the `RESOURCE_NAME`.\n"]]