Google: Gmail users history schemas

← Gmail users history operations · All schemas

Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body

Field	Type	Presence	Description and constraints
$	object	Root
history	array	Optional	List of history records. Any `messages` contained in the response will typically only have `id` and `threadId` fields populated.
history[]	Model	Each item	Expand Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item
historyId	string	Optional	The ID of the mailbox's current history record. Format: uint64
nextPageToken	string	Optional	Page token to retrieve the next page of results in the list.

Referenced models: Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item

Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item

Field	Type	Presence	Description and constraints
$	object	Root	A record of a change to the user's mailbox. Each history change may affect multiple messages in multiple ways.
id	string	Optional	The mailbox sequence ID. Format: uint64
labelsAdded	array	Optional	Labels added to messages in this history record.
labelsAdded[]	Model	Each item	Expand Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item labels Added item
labelsRemoved	array	Optional	Labels removed from messages in this history record.
labelsRemoved[]	Model	Each item	Expand Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item labels Removed item
messages	array	Optional	List of messages changed in this history record. The fields for specific change types, such as `messagesAdded` may duplicate messages in this field. We recommend using the specific change-type fields instead of this.
messages[]	Model	Each item	Expand Gets the specified message — response body
messagesAdded	array	Optional	Messages added to the mailbox in this history record.
messagesAdded[]	Model	Each item	Expand Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item messages Added item
messagesDeleted	array	Optional	Messages deleted (not Trashed) from the mailbox in this history record.
messagesDeleted[]	Model	Each item	Expand Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item messages Added item

Referenced models: Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item labels Added item, Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item labels Removed item, Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item messages Added item, Gets the specified message — response body

Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item labels Added item

Field	Type	Presence	Description and constraints
$	object	Root
labelIds	array	Optional	Label IDs added to the message.
labelIds[]	string	Each item
message	Model	Optional	Expand Gets the specified message — response body

Referenced models: Gets the specified message — response body

Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item labels Removed item

Field	Type	Presence	Description and constraints
$	object	Root
labelIds	array	Optional	Label IDs removed from the message.
labelIds[]	string	Each item
message	Model	Optional	Expand Gets the specified message — response body

Referenced models: Gets the specified message — response body

Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item messages Added item

Field	Type	Presence	Description and constraints
$	object	Root
message	Model	Optional	Expand Gets the specified message — response body

Referenced models: Gets the specified message — response body