Stay organized with collections
Save and categorize content based on your preferences.
Resource: monitor
This page documents the parameters that are available for the monitor
resource of the Email Audit API when
monitoring emails.
Fields
Description
destUserName
Required.
The destination user, the username (not the full email address) who
receives copies of the messages. This is the user auditing the messages.
For example, in the example.com domain, to make kai@example.com the
destination user, use name='destUserName' value='kai'.
Only one monitor exists for a unique 'destination user - source user'
pair. If more than one monitor is created for the same
'destination user - source user' pair, the settings of the last monitor
are retained. This is how you update the audited email configuration. For
information about updating, see
Update an email monitor.
beginDate
Optional.
The date when the audit starts. If this element is an empty string, the
email auditing begins with the current date. This date must be the
current date or a future date. The date format is
YYYY-MM-dd HH:mm where the HH is the hour of
the day using 0 - 23, and the mm is the minutes of the hour
using 0 - 59.
The date when the audit stops. This value must be greater than the
beginDate parameter. The date format is
YYYY-MM-dd HH:mm where the HH is the hour of
the day using 0 - 23, and the mm is the minutes of the hour
using 0 - 59.
The amount of audited information captured for incoming emails. If no
value is entered, the default is FULL_MESSAGE. The
following values are accepted:
FULL_MESSAGE: The full incoming email body is sent to
the destination user.
HEADER_ONLY: Only the incoming email's header
information is sent to the destination user.
outgoingEmailMonitorLevel
Optional.
The amount of monitored information captured for outgoing emails. If no
value is entered, the default is FULL_MESSAGE. The
following values are accepted:
FULL_MESSAGE: The full outgoing email body is sent to
the destination user.
HEADER_ONLY: Only the outgoing email's header
information is sent to the destination user.
draftMonitorLevel
Optional.
The amount of audit information captured for draft emails. If no value
or the empty string is provided for this element, no email drafts are
audited.NONE is the default.
FULL_MESSAGE: The full draft email body is sent to the
destination user.
HEADER_ONLY: Only the draft email's headers is sent to
the destination user.
NONE: No email draft is sent to the destination user.
chatMonitorLevel
Optional.
The amount of audit information captured for archived Hangouts chats.
This setting only applies to classic Hangouts Chat, not Google Chat.
Hangouts Chat is deprecated. For information about archiving
Chat messages, see
Archive Chat messages.
If no value or the empty string is provided for this element, no chats
are audited. This is the default.
FULL_MESSAGE: The full chat text is sent to the
destination user.
HEADER_ONLY: Only the chat's header is sent to the
destination user.
[[["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 2025-08-04 UTC."],[],[],null,["Resource: `monitor`\n-------------------\n\nThis page documents the parameters that are available for the `monitor`\nresource of the Email Audit API when\n[monitoring emails](/workspace/admin/email-audit/monitor-email).\n\n| Fields | Description |\n|-----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `destUserName` | Required. The destination user, the username (not the full email address) who receives copies of the messages. This is the user auditing the messages. For example, in the example.com domain, to make kai@example.com the destination user, use `name='destUserName' value='kai'`. Only one monitor exists for a unique 'destination user - source user' pair. If more than one monitor is created for the same 'destination user - source user' pair, the settings of the last monitor are retained. This is how you update the audited email configuration. For information about updating, see [Update an email monitor](/workspace/admin/email-audit/monitor-email#update_an_email_monitor). |\n| `beginDate` | Optional. The date when the audit starts. If this element is an empty string, the email auditing begins with the current date. This date must be the current date or a future date. The date format is `YYYY-MM-dd HH:mm` where the `HH` is the hour of the day using 0 - 23, and the `mm` is the minutes of the hour using 0 - 59. The time zone is in Coordinate Univeral Time (UTC) format. [Convert your time to UTC format](https://www.timeanddate.com/worldclock/converter.html) before creating a new monitor. |\n| `endDate` | Required. The date when the audit stops. This value must be greater than the `beginDate` parameter. The date format is `YYYY-MM-dd HH:mm` where the `HH` is the hour of the day using 0 - 23, and the `mm` is the minutes of the hour using 0 - 59. The time zone is in Coordinate Univeral Time (UTC) format. [Convert your time to UTC format](https://www.timeanddate.com/worldclock/converter.html) before creating a new monitor. |\n| `incomingEmailMonitorLevel` | Optional. The amount of audited information captured for incoming emails. If no value is entered, the default is `FULL_MESSAGE`. The following values are accepted: - `FULL_MESSAGE`: The full incoming email body is sent to the destination user. - `HEADER_ONLY`: Only the incoming email's header information is sent to the destination user. |\n| `outgoingEmailMonitorLevel` | Optional. The amount of monitored information captured for outgoing emails. If no value is entered, the default is `FULL_MESSAGE`. The following values are accepted: - `FULL_MESSAGE`: The full outgoing email body is sent to the destination user. - `HEADER_ONLY`: Only the outgoing email's header information is sent to the destination user. |\n| `draftMonitorLevel` | Optional. The amount of audit information captured for draft emails. If no value or the empty string is provided for this element, no email drafts are audited.`NONE` is the default. - `FULL_MESSAGE`: The full draft email body is sent to the destination user. - `HEADER_ONLY`: Only the draft email's headers is sent to the destination user. - `NONE`: No email draft is sent to the destination user. |\n| `chatMonitorLevel` | Optional. The amount of audit information captured for archived Hangouts chats. This setting only applies to classic Hangouts Chat, not Google Chat. Hangouts Chat is deprecated. For information about archiving Chat messages, see [](/chat/how-tos/chat-archiving)Archive Chat messages. If no value or the empty string is provided for this element, no chats are audited. This is the default. - `FULL_MESSAGE`: The full chat text is sent to the destination user. - `HEADER_ONLY`: Only the chat's header is sent to the destination user. |"]]