This document lists the events and parameters for
various types of
Directory Sync Audit activity events. You can retrieve these events by
calling Activities.list()
with applicationName=directory_sync
.
Sync entity events
The processing of user and group entities.
Events of this type are returned with type=DIRECTORY_SYNC_ENTITY
.
Group Membership Added
This event occurs when an entity is added to a group.
ADDED_GROUP_MEMBERSHIP
DRY_
RUN
boolean
True if this event is for a dry run.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
GROUP_
ID
string
The email id of the group.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
NEW_
MEMBERSHIP_
ROLE
string
The new role for the membership.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ADDED_GROUP_MEMBERSHIP
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Added {TARGET_OBJECT_ID}
in group {GROUP_ID}
as {NEW_MEMBERSHIP_ROLE}
Group Membership Removed
This event occurs when an entity is removed from a group.
REMOVED_GROUP_MEMBERSHIP
DRY_
RUN
boolean
True if this event is for a dry run.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
GROUP_
ID
string
The email id of the group.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
OLD_
MEMBERSHIP_
ROLE
string
The previous role for the membership.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= REMOVED_GROUP_MEMBERSHIP
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Removed {TARGET_OBJECT_ID}
from group {GROUP_ID}
as {OLD_MEMBERSHIP_ROLE}
Group Membership Updated
This event occurs when an entity's membership in a group is updated.
UPDATED_GROUP_MEMBERSHIP
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
GROUP_
ID
string
The email id of the group.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
NEW_
MEMBERSHIP_
ROLE
string
The new role for the membership.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= UPDATED_GROUP_MEMBERSHIP
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Updated {ENTITY_TYPE}
{TARGET_OBJECT_ID}
's role in group {GROUP_ID}
to {NEW_MEMBERSHIP_ROLE}
Object Created
Occurs when a new entity is created.
ENTITY_CREATED
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ENTITY_CREATED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Created {ENTITY_TYPE}
{TARGET_OBJECT_ID}
Object Deprovisioned
Occurs when an object is deprovisioned.
OBJECT_DEPROVISIONED
DEPROVISION_
ACTION
string
The action of deprovisioning an object.
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
MESSAGE
string
The reason for the event.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= OBJECT_DEPROVISIONED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{ENTITY_TYPE}
{TARGET_OBJECT_ID}
{DEPROVISION_ACTION}
because {MESSAGE}
Object Excluded
Occurs when an entity is excluded from a sync.
ENTITY_EXCLUDED
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
EXCLUSION_
RULE
string
The exclusion rule.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ENTITY_EXCLUDED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Excluded {ENTITY_TYPE}
{SOURCE_OBJECT_ID}
due to the exclusion rule {EXCLUSION_RULE}
Object Excluded Summary
Provides a summary of entities excluded from a sync.
ENTITY_EXCLUSIONS_SUMMARY
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
EXCLUDED_
COUNT
integer
The count of items excluded.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ENTITY_EXCLUSIONS_SUMMARY
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Excluded {EXCLUDED_COUNT}
{ENTITY_TYPE}
entities from directory {SOURCE_DIRECTORY_DISPLAY_NAME}
Object Skipped - Source object
Occurs when an entity is skipped during a sync.
ENTITY_SKIPPED
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
MESSAGE
string
The reason for the event.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ENTITY_SKIPPED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Skipped syncing {ENTITY_TYPE}
{SOURCE_OBJECT_ID}
. {MESSAGE}
Object Skipped - Target object
Occurs when a target entity is skipped during a sync.
TARGET_ENTITY_SKIPPED
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
MESSAGE
string
The reason for the event.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= TARGET_ENTITY_SKIPPED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Skipped syncing {ENTITY_TYPE}
{TARGET_OBJECT_ID}
. {MESSAGE}
Object Skipped - Unexpected error
Occurs when an entity could not be processed.
ENTITY_SYNC_FAILED
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
GROUP_
ID
string
The email id of the group.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
MESSAGE
string
The reason for the event.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ENTITY_SYNC_FAILED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Skipped syncing {ENTITY_TYPE}
. {MESSAGE}
Object Updated
Occurs when an entity's attributes are updated.
ENTITY_UPDATED
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
NEW_
ATTRIBUTES
string
The new attributes for the entity.
OLD_
ATTRIBUTES
string
The previous attributes for the entity.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ENTITY_UPDATED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Updated {ENTITY_TYPE}
{TARGET_OBJECT_ID}
. Old attributes {OLD_ATTRIBUTES}
, new attributes {NEW_ATTRIBUTES}
Read Objects
Occurs when an entity is read from the remote directory.
REMOTE_DIRECTORY_ENTITY_READ
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
OLD_
ATTRIBUTES
string
The previous attributes for the entity.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= REMOTE_DIRECTORY_ENTITY_READ
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Read {SOURCE_OBJECT_ID}
with attributes {OLD_ATTRIBUTES}
Read Objects - Initiating read from source directory
Occurs when the sync process starts reading entities from the remote directory.
REMOTE_DIRECTORY_READ
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
FILTER
string
The remote directory filter.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= REMOTE_DIRECTORY_READ
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Reading {ENTITY_TYPE}
s from source directory {SOURCE_DIRECTORY_DISPLAY_NAME}
with filter {FILTER}
Read Objects - Initiating read from target directory
Occurs when the sync process starts reading entities from the Google directory.
CLOUD_DIRECTORY_READ
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= CLOUD_DIRECTORY_READ
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Reading {ENTITY_TYPE}
s from your Google directory
Read Objects - Source directory read summary
Provides a summary of entities read from the remote directory.
REMOTE_DIRECTORY_READ_FINISHED
COUNT
integer
The count of items affected.
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= REMOTE_DIRECTORY_READ_FINISHED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Retrieved {COUNT}
{ENTITY_TYPE}
s from source directory {SOURCE_DIRECTORY_DISPLAY_NAME}
Read Objects - Target directory read summary
Provides a summary of entities read from the Google directory.
CLOUD_DIRECTORY_READ_FINISHED
COUNT
integer
The count of items affected.
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= CLOUD_DIRECTORY_READ_FINISHED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Retrieved {COUNT}
{ENTITY_TYPE}
s from your Google directory
Sync Error
Indicates an error occurred during the sync process.
ERROR
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
MESSAGE
string
The reason for the event.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ERROR
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{MESSAGE}
Sync Error - Individual object
Occurs when an entity could not be created in the target directory.
ENTITY_NOT_CREATED
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
MESSAGE
string
The reason for the event.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SOURCE_
IMMUTABLE_
ID
string
The immutable id of source object.
SOURCE_
OBJECT_
ID
string
The id of the source object.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
TARGET_
OBJECT_
ID
string
The id of the target object.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ENTITY_NOT_CREATED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{ENTITY_TYPE}
{TARGET_OBJECT_ID}
could not be created. Message: {MESSAGE}
Sync Summary
Provides a summary of entity changes.
ENTITY_CHANGES
CREATED_
COUNT
integer
The count of items created.
DELETED_
COUNT
integer
The count of items deleted.
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
FAILED_
COUNT
integer
The count of entities that failed to sync.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SKIPPED_
COUNT
integer
The count of entities that are skipped in sync due to other non error flows.
SKIPPED_
ERROR_
COUNT
integer
The count of entities that are skipped in sync because of errors.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
UPDATED_
COUNT
integer
The count of items updated.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= ENTITY_CHANGES
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{ENTITY_TYPE}
changes: {CREATED_COUNT}
created, {UPDATED_COUNT}
updated, {DELETED_COUNT}
suspended, {FAILED_COUNT}
failed, {SKIPPED_ERROR_COUNT}
skipped (errors), {SKIPPED_COUNT}
skipped (other)
Sync Job execution
A Sync Job executed.
Events of this type are returned with type=DIRECTORY_SYNC_EXECUTION
.
Sync Completed
Indicates that the sync run has completed.
SYNC_RUN_END
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= SYNC_RUN_END
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Completed syncing {ENTITY_TYPE}
s from {SOURCE_DIRECTORY_DISPLAY_NAME}
Sync Failed
Indicates that the sync run has failed.
SYNC_RUN_FAILED
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
MESSAGE
string
The reason for the event.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= SYNC_RUN_FAILED
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{ENTITY_TYPE}
sync from {SOURCE_DIRECTORY_DISPLAY_NAME}
failed. Error: {MESSAGE}
Sync Failed - Retry scheduled
Indicates that a failed sync run is scheduled for retry.
SYNC_RUN_FAILED_RETRY
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
MESSAGE
string
The reason for the event.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= SYNC_RUN_FAILED_RETRY
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
{ENTITY_TYPE}
sync from {SOURCE_DIRECTORY_DISPLAY_NAME}
failed. Sync will be retried soon. Error: {MESSAGE}
Sync Started
Indicates that a sync run has started.
SYNC_RUN_START
DRY_
RUN
boolean
True if this event is for a dry run. Possible values:
-
false
Enum value of dry run disabled. -
true
Enum value of dry run enabled.
ENTITY_
TYPE
string
The type of the entity. Possible values:
-
GROUP
Represents a group entity. -
GROUP_MEMBERSHIP
Represents a group membership entity. -
USER
Represents a user entity.
LOG_
LEVEL
string
The severity level of audit event. Possible values:
-
DEBUG
Debug log. -
ERROR
Error log. -
FATAL
Fatal log. -
INFORMATION
Information log. -
WARNING
Warning log.
REMOTE_
DIRECTORY
string
The name of the Sync remote directory.
SOURCE_
DIRECTORY_
DISPLAY_
NAME
string
The display name of the source directory.
SYNC_
JOB
string
The name of the Sync Job.
SYNC_
JOB_
CONFIG
string
The config of the sync job.
SYNC_
RUN
string
The name of the Sync Run.
VERBOSE
boolean
True if this is a verbose log event. Possible values:
-
false
Enum value for non verbose event. -
true
Enum value for verbose event.
GET https://admin.googleapis.com
/admin
/reports
/v1
/activity
/users
/all
/applications
/ directory_sync
?eventName= SYNC_RUN_START
&maxResults=10
&access_token= YOUR_ACCESS_TOKEN
Started syncing {ENTITY_TYPE}
s from {SOURCE_DIRECTORY_DISPLAY_NAME}
using {SYNC_JOB_CONFIG}

