---
title: New Chat Usage Analytics Updates for Admins and Developers
description: New Chat Usage Analytics Updates for Admins and Developers
---

[Suitebriar Blog ](https://blog.suitebriar.com)

# [New Chat Usage Analytics Updates for Admins and Developers](https://blog.suitebriar.com/http/workspaceupdates.googleblog.com/feeds/1684423840945685627/comments/default)

 Written by [Alfonso Martinez](https://blog.suitebriar.com/author/alfonso-martinez) | Feb 21, 2025 6:34:00 PM

### What’s changing 

In December 2024, we introduced [new, detailed usage reports for Google Chat](https://workspaceupdates.googleblog.com/2024/12/google-chat-usage-reports.html). These reports help admins better understand how their teams are using Chat, allowing them to analyze engagement, drive adoption, configure safety features, and more. These reports aggregate data at the group and organization level, to provide relevant insights for Workspace admins while protecting individual privacy. 

Starting today, [customerUsageReports.get](https://developers.google.com/admin-sdk/reports/v1/appendix/usage/customer/chat) and [userUsageReports.get](https://developers.google.com/admin-sdk/reports/v1/appendix/usage/user/chat) for Google Chat are available via the Admin SDK Reports API for customers to use in their own customized dashboards and reporting tools. This gives admins more ways to analyze Chat usage data.

Please refer to the table below to learn about the metrics available to you:

| Category | Variations |
| --- | --- |
| # of messages sent by users of the organization | Total number of messages |
| Messages sent by conversation type (direct message, group chat, space) |  |
| Messages sent by type (regular, voice, video, huddle) |  |
| Messages sent with or without attachment |  |
| Messages sent to conversations that contain or do not contain external users. |  |
| # of spaces owned by organization | Number of active spaces |
| Number of spaces created |  |
| # of active users in your organization by level of activity | Number of engaged users (read at least one conversation or sent messages or reactions) |
| Number of communicator users (sent at least one message or reaction) |  |
| # of actions by specific users* | Number of messages and reactions sent Number of attachments uploaded Number of spaces created Number of conversations read |

*Most metrics are available for periods of 1, 7, and 28 days.*

**Available for 28 days only*

### Additional details

We’ve also added four new fields and one additional event available in Chat Audit Logs and surfaced in the Security Investigation Tool. In addition to providing even more context on Chat usage, admins can leverage these additional data points in their own custom reporting.

The fields are:

**Conversation ownership indicates whether the conversation, where a specific Chat event occurs, is owned by the organization or by an external entity. These possible values include:**

- Internally owned: conversation is owned by the admin’s organization
- Externally owned: conversation is owned by an external entity

**Conversation type indicates the type of conversation where the event occurs:**

- User-to-user direct message
- User-to-app direct message
- Group chat
- Space

**Message type indicates type of the message in Message sent and Message edited events:**

- Regular message
- Voice message
- Video message
- Huddle

**Attachment status indicates whether the message was sent with an attachment (image or file):**

- Has attachment
- No attachment

Additionally, we’ve added a new event, “Conversation Read”. Every time a user opens a conversation and reads one or more unread messages, an event will be logged.

### Getting started

- **Admins: **Visit the Help Center to learn more about [understanding Chat usage with analytics](https://support.google.com/a/answer/15560233), [viewing Apps reports for your organization](https://support.google.com/a/answer/6072773) and [using the security investigation tool](https://support.google.com/a/answer/7575955).
- **Developers:** Check out our developer documentation for more information on [Chat Audit Activity Events](https://developers.google.com/admin-sdk/reports/v1/appendix/activity/chat). and [CustomerUsageReports.get](https://developers.google.com/admin-sdk/reports/v1/appendix/usage/customer/chat) and [UserUsageReport.get](https://developers.google.com/admin-sdk/reports/v1/appendix/usage/user/chat).

### Rollout pace

- Available now.

### Availability

- **New Chat usage metrics in Report API**  are available for all Google Workspace customers.
- **The security investigation tool** is available for Google Workspace

### Resources

- [Developer documentation: Reports API Overview](https://developers.google.com/admin-sdk/reports/v1/get-start/overview)
- [Developer Documentation: Google Chat Parameters: CustomerUsageReports.get](https://developers.google.com/admin-sdk/reports/v1/appendix/usage/customer/chat)
- [Developer Documentation: Google Chat PArameters:  UserUsageReport.get](https://developers.google.com/admin-sdk/reports/v1/appendix/usage/user/chat)
- [Developer Documentation: Chat Audit Activity Events](https://developers.google.com/admin-sdk/reports/v1/appendix/activity/chat)
- [Developer Documentation: Admin SDK API developer platform release notes](https://developers.devsite.corp.google.com/admin-sdk/docs/release-notes)
- [Google Workspace Admin Help: Understand Chat usage with analytics](https://support.google.com/a/answer/15560233)
- [Google Workspace Admin Help: View Apps reports for your organization](https://support.google.com/a/answer/6072773)
- [Google Workspace Admin Help: About the security investigation tool](https://support.google.com/a/answer/7575955)
- [Workspace Updates Blog: New Google Chat usage reports provide deeper insights into user engagement](https://workspaceupdates.googleblog.com/2024/12/google-chat-usage-reports.html)

[View full post](https://blog.suitebriar.com/http/workspaceupdates.googleblog.com/feeds/1684423840945685627/comments/default)

```json
{
  "@context" : "http://schema.org",
  "@type" : "BlogPosting",
  "author" : {
    "@type" : "Person",
    "name" : "Alfonso Martinez"
  },
  "dateModified" : "2025-02-21T18:34:00.318Z",
  "datePublished" : "2025-02-21T18:34:00Z",
  "headline" : "New Chat Usage Analytics Updates for Admins and Developers",
  "image" : {
    "@type" : "ImageObject",
    "height" : 470,
    "url" : "https://storage.googleapis.com/suitebriar-resources/workspaceupdates.png",
    "width" : 815
  },
  "mainEntityOfPage" : "https://blog.suitebriar.com/http/workspaceupdates.googleblog.com/feeds/1684423840945685627/comments/default",
  "publisher" : {
    "@type" : "Organization",
    "logo" : {
      "@type" : "ImageObject",
      "height" : 60,
      "url" : "/hs/hsstatic/content_shared_assets/static-1.4092/img/default-amp-logo.png",
      "width" : 60
    },
    "name" : "Suitebriar Blog"
  }
}
```