Google Workspace administrators can set up a third-party archiving service to archive Google Chat messages and other content. Chat archiving works by logging messages to an email address specified in the Admin console. This guide describes the format of these email messages.
The following content types are archived in Chat messages:
- Message header metadata
- Membership state changed
- Message was created
- Message was edited
- Message was deleted
- User reacted or removed a reaction
- Google Meet link was added
- File attachment was added
- Link to Google Drive file was added
- Any other activity that writes to the Chat stream, such as a bot message
The following content is not archived:
- Interactions that don't write to the chat stream, such as bots that display a card to users to select an action
- Interactions outside of Chat that are displayed in rooms but don't write to the chat stream, such as viewing a Task in the Tasks tab
This section describes the format of archived Chat information and gives examples of each type.
Message header metadata and email format
Following is the header format of archive messages. In these examples, the
archive address is set to
- Subject: Google Chat activity from DM or Room
- DM: if the message is a direct message or group direct message
- Room: if the message is in a room
- ID: Google Chat space ID (used by the Chat REST API)
- with: email addresses associated with message; if <=5, usernames; if >5, count
- To: email addresses of all users, plus the archive address
From: <firstname.lastname@example.org> Date: Tue, Jan 28, 2020 at 10:13 AM Subject: Google Chat activity from DM 8at_0gAAAAE with rose, mike To: <email@example.com>, <firstname.lastname@example.org> From: <email@example.com> Date: Tue, Jan 28, 2020 at 10:15 AM Subject: Google Chat activity from Room g2-uKgAAAAE with 6 members To: <firstname.lastname@example.org>, <email@example.com>, <firstname.lastname@example.org>, <email@example.com>, <firstname.lastname@example.org>, <email@example.com>
In addition, Google Workspace Admins can add custom headers by enabling the optional header metadata in the Admin console. An example of optional custom headers:
X-ArchivalProvider-MsgType: Google_Chat Message-ID: <firstname.lastname@example.org> Date: Wed, 27 Nov 2019 17:27:15 +0000 Subject: Chat activity from DM 8at_0gAAAAE From: email@example.com To: firstname.lastname@example.org, email@example.com
The rest of this section gives examples of each type of archived data.
Membership state changed
When a user joins a room:
[2019-09-23T16:47:17.773827Z] mike marsden (firstname.lastname@example.org) MEMBERSHIP STATE BECAME JOINED
When a user leaves a room:
[2019-11-27T16:39:05.750194Z] Brian Zhao (email@example.com) MEMBERSHIP STATE BECAME NOT A MEMBER
Message was created
[2019-09-23T17:36:57.710319Z] Edward Deng (firstname.lastname@example.org) POSTED VEiF-WPTkJU:PezyhNYvFzk Good morning!
Message was edited
[2019-09-23T17:37:08.137734Z] Edward Deng (email@example.com) EDITED VEiF-WPTkJU:PezyhNYvFzk Very good morning!
Message was deleted
[2019-09-23T17:37:14.212127Z] DELETED VEiF-WPTkJU:mn4aIBqVYzs MESSAGE DELETED
User reacted or removed a reaction
[2019-11-27T18:17:58.479409Z] Donna Lee (firstname.lastname@example.org) REACTED TO fTi4iKLrveQ:fTi4iKLrveQ =F0=9F=99=82 [2019-11-27T18:18:08.730463Z] Donna Lee (email@example.com) REMOVED REACTION TO fTi4iKLrveQ:fTi4iKLrveQ =F0=9F=99=82
Google Meet link was added
[2019-12-13T19:45:54.168271Z] Natraj Verma (firstname.lastname@example.org) UPLOADED Google Meet: https://meet.google.com/vzf-pjqg-czj POSTED 7-NYOcR7gqQ:7-NYOcR7gqQ let's talk over video
File attachment was added
[2019-12-13T19:50:29.899503Z] Edward Deng (email@example.com) UPLOADED application/pdf: "kitchen.pdf" POSTED n8dcClo_dWw:gq-ItEhSZvQ wdyt?
The file attachment is added to the email archive if the file is smaller than the maximum file size.
Link to Google Drive file was added
[2020-01-28T17:13:38.332367Z] Edward Deng (firstname.lastname@example.org) ADDED Google Drive File https://drive.google.com/open?id=11r0l3zuwjgY8k9kw-MWwYq6srSKZTuuLhkr1md2Sl-Y application/vnd.google-apps.presentation: "Test Slides" POSTED _YdFA9wEVVo:_YdFA9wEVVo