Contacts Audit Activity Events

This document lists the events and parameters for various types of Contacts Audit activity events. You can retrieve these events by calling Activities.list() with applicationName=contacts.

Mutate Contact Data

A category of audit logging event in which contact data was mutated by the user. Events of this type are returned with type=mutate_contact_data.

Added to contacts

An event that occurs when profiles are added to the user's contact list.

Event details
Event name add_to_contacts
Parameters
CONTACTS_COUNT

integer

Number of contacts involved in the action. For example, if the action is to delete contacts, this parameter would contain the number of contacts that were deleted.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=add_to_contacts&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} added a record to their contact list

Changes accepted

An event that occurs when merge and fix suggestions are accepted by the user.

Event details
Event name accept_merge_and_fix_suggestions
Parameters
CHANGES_COUNT

integer

Number of changes that were saved in the action. For example, if the action is to reformat phone numbers of contacts, this parameter would contain the number of phone numbers that were reformated.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=accept_merge_and_fix_suggestions&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} accepted changes from the Merge and Fix page

Contacts created

An event that occurs when multiple contacts are created at once.

Event details
Event name create_multiple_contacts
Parameters
CONTACTS_COUNT

integer

Number of contacts involved in the action. For example, if the action is to delete contacts, this parameter would contain the number of contacts that were deleted.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=create_multiple_contacts&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} created contacts

Contacts deleted

An event that occurs when contacts are deleted.

Event details
Event name delete_contacts
Parameters
CONTACTS_COUNT

integer

Number of contacts involved in the action. For example, if the action is to delete contacts, this parameter would contain the number of contacts that were deleted.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=delete_contacts&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} deleted contacts

Contacts hidden

An event that occurs when contacts are hidden from the user's contact list.

Event details
Event name hide_contacts
Parameters
CONTACTS_COUNT

integer

Number of contacts involved in the action. For example, if the action is to delete contacts, this parameter would contain the number of contacts that were deleted.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=hide_contacts&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} hid contacts

Contacts imported

An event that occurs when ontacts are imported from an external file.

Event details
Event name import_contacts
Parameters
CONTACTS_COUNT

integer

Number of contacts involved in the action. For example, if the action is to delete contacts, this parameter would contain the number of contacts that were deleted.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=import_contacts&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} imported contacts

Trashed contacts deleted

An event that occurs when contacts from the trash are deleted.

Event details
Event name delete_trashed_contacts
Parameters
CONTACTS_COUNT

integer

Number of contacts involved in the action. For example, if the action is to delete contacts, this parameter would contain the number of contacts that were deleted.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=delete_trashed_contacts&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} deleted contacts from Trash

Trashed contacts recovered

An event that occurs when contacts from the trash are recovered.

Event details
Event name recover_trashed_contacts
Parameters
CONTACTS_COUNT

integer

Number of contacts involved in the action. For example, if the action is to delete contacts, this parameter would contain the number of contacts that were deleted.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=recover_trashed_contacts&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} recovered contacts from Trash

Significant View

A category of audit logging events in which contact data was viewed in a way that was considered significant, such as exporting or printing the contact list. Events of this type are returned with type=significant_view. Events of this type are returned with type=significant_view.

Contacts exported

An event that occurs when contacts are exported to an external file.

Event details
Event name export_contacts
Parameters
CONTACTS_COUNT

integer

Number of contacts involved in the action. For example, if the action is to delete contacts, this parameter would contain the number of contacts that were deleted.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=export_contacts&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} exported contacts

An event that occurs when contacts are printed.

Event details
Event name print_contacts
Parameters
CONTACTS_COUNT

integer

Number of contacts involved in the action. For example, if the action is to delete contacts, this parameter would contain the number of contacts that were deleted.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/contacts?eventName=print_contacts&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} printed contacts