Stay organized with collections
Save and categorize content based on your preferences.
Resource: export
This page documents the parameters that are available for the export
resource of the Email Audit API when
downloading a mailbox.
Fields
Description
beginDate
Optional.
The date for the first email included in the exported mailbox. If you
want all emails starting from when the account was created, don't enter
a value for this field.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
before starting a mailbox export.
endDate
Optional.
The date for the last email included in the exported mailbox. If this
value isn't specified, the exported emails go to the current 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
before starting a mailbox export.
searchQuery
Optional.
The mailbox is filtered by using the searchQuery value
and only the filtered search results are available for download. These
queries follow the same search rules as the
advanced search in Gmail.
The searchQuery and includeDeleted parameters
are mutally exclusive. A search query isn't possible if
includeDeleted = "true".
includeDeleted
Optional.
Determines whether or not deleted messages are include in the mailbox
export file. By default, the value is "false" and deleted
messages aren't included.
The searchQuery and includeDeleted parameters
are mutally exclusive. A search query isn't possible if
includeDeleted = "true".
packageContent
Required.
Determines whether the full email or the email's header are used in the
mailbox export file.
FULL_MESSAGE: The full email text, including
attachments, is copied to the export file. This is the default
setting.
HEADER_ONLY: Only the email's header is copied to the
export file.
[[["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-12-19 UTC."],[[["This page describes the parameters for downloading a mailbox using the `export` resource of the Email Audit API."],["You can specify a date range for the export using `beginDate` and `endDate` parameters in UTC format."],["Filter the export by using the `searchQuery` parameter, following Gmail's advanced search rules, or include deleted messages by setting `includeDeleted` to \"true\", but not both."],["Choose between exporting the full email content (`FULL_MESSAGE`) or only the header (`HEADER_ONLY`) using the `packageContent` parameter."]]],[]]