What’s changing 

In December 2024, we introduced new, detailed usage reports for Google Chat. 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 and userUsageReports.get 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



Rollout pace


Availability

  • New Chat usage metrics in Report API  are available for all Google Workspace customers.
  • The security investigation tool is available for Google Workspace
    • Enterprise Standard and Plus
    • Education Standard and Plus
    • Enterprise Essentials Plus
    • Frontline Standard
    • And Cloud Identity Premium customers