Overview
Add Google Workspace Admin to any ModuleX agent or workflow. Retrieve admin audit activity reports from Google Workspace via the Admin SDK Reports API (admin.googleapis.com).
Categories: Productivity & Collaboration · Admin · Enterprise · Auth: OAuth2 · Actions: 4
Authentication
OAuth2 Authentication
Connect using Google OAuth (recommended)Required Credentials
OAuth Configuration
- Authorization URL:
https://accounts.google.com/o/oauth2/v2/auth - Token URL:
https://oauth2.googleapis.com/token - Scopes:
https://www.googleapis.com/auth/admin.reports.audit.readonly
Available Actions
list_activities_by_admin — Retrieve admin console activities for a specific administrator
list_activities_by_admin — Retrieve admin console activities for a specific administrator
Parameters
string
required
Application name to retrieve events for. Valid values: access_transparency, admin, calendar, chat, drive, gcp, gplus, groups, groups_enterprise, jamboard, login, meet, mobile, rules, saml, token, user_accounts, context_aware_access, chrome, data_studio, keep
string
required
Profile ID or email of the administrator to filter activities for
string
Name of the event to filter by
string
End of the time range in RFC 3339 format (e.g. 2010-10-28T10:26:35.000Z)
string
Beginning of the time range in RFC 3339 format (e.g. 2010-10-28T10:26:35.000Z)
integer
Maximum number of activity records to return per page (default 1000)
string
Comma-separated event parameter filters (e.g. parameter_name relational_operator value)
Response
list_activities_by_event_and_admin — Retrieve activities filtered by both a specific event name and administrator
list_activities_by_event_and_admin — Retrieve activities filtered by both a specific event name and administrator
Parameters
string
required
Application name to retrieve events for. Valid values: access_transparency, admin, calendar, chat, drive, gcp, gplus, groups, groups_enterprise, jamboard, login, meet, mobile, rules, saml, token, user_accounts, context_aware_access, chrome, data_studio, keep
string
required
Name of the event to filter by
string
required
Profile ID or email of the administrator to filter activities for
string
End of the time range in RFC 3339 format (e.g. 2010-10-28T10:26:35.000Z)
string
Beginning of the time range in RFC 3339 format (e.g. 2010-10-28T10:26:35.000Z)
integer
Maximum number of activity records to return per page (default 1000)
string
Comma-separated event parameter filters (e.g. parameter_name relational_operator value)
Response
list_activities_by_event_name — Retrieve activities for all users filtered by a specific event name
list_activities_by_event_name — Retrieve activities for all users filtered by a specific event name
Parameters
string
required
Application name to retrieve events for. Valid values: access_transparency, admin, calendar, chat, drive, gcp, gplus, groups, groups_enterprise, jamboard, login, meet, mobile, rules, saml, token, user_accounts, context_aware_access, chrome, data_studio, keep
string
required
Name of the event to filter by
string
End of the time range in RFC 3339 format (e.g. 2010-10-28T10:26:35.000Z)
string
Beginning of the time range in RFC 3339 format (e.g. 2010-10-28T10:26:35.000Z)
integer
Maximum number of activity records to return per page (default 1000)
string
Comma-separated event parameter filters (e.g. parameter_name relational_operator value)
Response
list_all_activities — Retrieve all administrative activities for the account
list_all_activities — Retrieve all administrative activities for the account
Parameters
string
required
Application name to retrieve events for. Valid values: access_transparency, admin, calendar, chat, drive, gcp, gplus, groups, groups_enterprise, jamboard, login, meet, mobile, rules, saml, token, user_accounts, context_aware_access, chrome, data_studio, keep
string
End of the time range in RFC 3339 format (e.g. 2010-10-28T10:26:35.000Z)
string
Beginning of the time range in RFC 3339 format (e.g. 2010-10-28T10:26:35.000Z)
integer
Maximum number of activity records to return per page (default 1000)
string
Comma-separated event parameter filters (e.g. parameter_name relational_operator value)
Response
Limits & Quotas
- Admin SDK Reports API quota: 2,400 queries per minute per Google Workspace domain (default).
- Per-user limit: 480 queries per minute per user.
- Error model: non-2xx responses and timeouts are caught and returned as
success=False+errorrather than raising. Plan for retries on the agent side based on the error string.