Google Workspace Updates: API (original) (raw)
Wednesday, February 4, 2026
Google Classroom API: Student groups endpoints are now available
Last year, we announced the launch of the Google Classroom API Student Groups endpoints through the Google Workspace Developer Preview Program (DPP). Now, Student Groups endpoints are generally available, so developers no longer need to be in the Developer Preview Program (DPP) to access them.
Student Groups endpoints enable developers to manage student groups and group members on behalf of administrators and teachers. Specifically, developers can:
- Create, modify, and delete student groups within a course
- Add and remove members within student groups
- Read members of student groups
With this launch, developers can programmatically read and manage student groups in Google Classroom, enabling greater integration between Google Classroom and other tools used by teachers and schools.
Getting started
- Developers: Use the Manage student groups guide to get started.
Rollout pace
- Rapid Release and Scheduled Release domains: Available now
Availability
- API requests are permitted on behalf of teachers and administrators who have Google Workspace for Education Plus licenses
Resources
- Google Workspace Updates Blog: Create and manage student groups using the Google Classroom API
- Google Workspace Updates Blog: Introducing Student Groups in Google Classroom
- Google Classroom API: Create and manage student groups
- Google Classroom Teacher Help Center: Manage student groups
Tuesday, August 19, 2025
Create and manage student groups using the Google Classroom API
What’s changing
- Create, modify, and delete student groups within a course.
- Add and remove members within student groups.
This launch will help Developers to programmatically read and manage student groups in Google Classroom, enabling greater integration between Google Classroom and other tools used by teachers.
Getting Started
- To access Google Classroom API Student Group endpoints, join the Google Workspace Developer Preview Program.
- Begin development following the Manage student groups guide.
- Provide feedback. We would love to hear what you think!
Who’s impacted
- Developers building integrations with the Google Classroom API.
Rollout pace
- Available now through the Google Workspace Developer Preview Program.
Availability
- API requests are permitted on behalf of teachers and administrators with a Google Workspace for Education Plus license.
Resources
Monday, July 7, 2025
Google Drive Events API now available in Developer Public Preview
What’s changing
Google Drive is now integrated with the Workspace Events API, which allows third-party developers to create subscriptions on Drive items and receive notifications via Cloud Pub/Sub when those resources change. This offers developers a more reliable, featureful way of receiving events over the current files.watch and changes.watch methods that exist today. The following events are supported in the Developer Public Preview:
- A file has been:
- Added to a folder or shared drive.
- Moved to a folder or shared drive.
- Edited or a new revision is uploaded.
- Trashed or removed from the trash.
- An access proposal has been created or resolved on a file.
Getting started
- Admins: There is no admin control for this feature.
- Developers: Developers need to be enrolled in the Workspace Developer Public Preview program in order to access the API via this sign up. Once enrolled in the program, developers can reference our getting started guides:
Rollout pace
- Available to all Google Workspace customers and Workspace Individual Subscribers
Resources
- Developer Documentation: Drive API release notes
- Developer Documentation: Workspace Events release notes
Tuesday, July 1, 2025
Access Gemini Audit logs using the Reporting API, the security and audit investigation tools
What’s changing
Gemini Audit logs are now accessible through the Reporting API (Admin SDK). This allows admins to track user activity and interactions with Gemini in the Gemini app and Workspace apps, including:
- The action performed by the user within a Workspace application, initiated or assisted by Gemini. For example: formalizing copy, generating a background, or summarizing a conversation.
- The specific app where Gemini was used, for example Chat, Gmail, or Docs.
- The specific features which were used, for example “help me write”, “remove image background” or “help me organize”.
- And more – see our API documentation for more information on the types of Gemini in Workspace activity you can query.
Who’s impacted
Admins
Why you’d use it
Admins can use the Reports API to analyze how their users are engaging with Gemini at scale. These valuable insights can help organizations get the most out of Gemini. Specifically:
- Monitoring adoption and usage: Admins can track the overall use of Gemini features across the organization and within specific Workspace applications (Gmail, Docs, Slides, Sheets, Gemini app). This includes identifying the number of active Gemini users, their usage patterns per app, and the “Last Used” time stamp for each user.
- Understanding feature utilization: The reports detail how frequently specific Gemini features like content summarization and generation are used within different applications.
- Identifying training needs: By observing feature and app usage, admins can pinpoint areas where users might require additional training or resources to maximize their use of Gemini's capabilities.
- Identifying power users: The reports can help identify individuals who are heavily utilizing Gemini features, potentially recognizing internal champions who can share their expertise and best practices with other users.
Further, surfacing this information in the audit and investigation tool can help admins review user activity related to Gemini, while the security and investigation tool can help admins to identify, triage, and take action on potential security and privacy issues.
Getting started
- Admins: Use our API documentation for more information on auditing Gemini in Workspace Apps events, the security investigation tool, and the audit investigation tool.
- End users: There is no end user impact or action required.
Rollout pace
- Reports API: Available now.
- Security investigation tool and the audit investigation tool: Extended rollout (potentially longer than 15 days for feature visibility) beginning on July 1, 2025
Availability
- Available for all customers with a Google Workspace edition that includes access to Gemini in Workspace apps, as well as customers with a Gemini add-on*.
- The Reports API and audit and investigation tool is available for all Google Workspace customers.
- The security investigation tool is available for Google Workspace
- Frontline Standard and Plus
- Enterprise Standard and Plus
- Education Standard and Plus
- Enterprise Essentials Plus
- Cloud Identity Premium
Resources
- API Documentation: Gemini for Workspace Audit Activity Events
- Google Workspace Admin Help: About the security investigation tool
- Google Workspace Admin Help: About the audit and investigation tool
Friday, June 20, 2025
Google Workspace Updates Weekly Recap - June 20, 2025
4 New updates
Unless otherwise indicated, the features below are available to all Google Workspace customers, and are fully launched or in the process of rolling out. Rollouts should take no more than 15 business days to complete if launching to both Rapid and Scheduled Release at the same time. If not, each stage of rollout should take no more than 15 business days to complete.
Admins can now deploy Context-Aware Access for the NotebookLM mobile app
Earlier this year, we introduced the ability for admins to specify Context-Aware Access (CAA) policies when their users access NotebookLM. This week, we’ve expanded this to the NotebookLM app, which enables admins to set up access levels for the NotebookLM app based on a user’s identity and the context of the request (location, device security status, IP address). | Rolling out now to Rapid Release and Scheduled Release domains. | Context-Aware Access is available for Google Workspace Enterprise Standard and Plus; Education Standard and Plus; Enterprise Essentials Plus; Frontline Standard and Plus, and Cloud Identity Premium customers. | Visit the Help Center to learn more about protecting your business with Context-Aware Access, about qualifying Google Workspace editions and how to turn this service on or off.
Introducing a new video player experience in Google Drive on Android devices
Last year, we announced a smoother, more modern video player on the Google Drive web experience. This updated look and feel is now available when watching Drive videos on your Android device. | Rollout to Rapid Release and Scheduled Release domains is complete. | Available to all Google Workspace customers, Workspace Individual Subscribers, and users with personal Google accounts. | Visit the Help Center to learn more about storing & playing video in Google Drive.
Improving the file upload experience on Android and iOS devices
To improve Google Drive's mobile upload experience, we've launched more fine grained controls and proactive status updates. Starting this week, you’ll notice updates to:
- The initial upload screen where you can adjust the file’s name and location.
- The progress bar that tells you how many items are uploading and how long it will take.
- The Upload Tab where you can see all pending or recently completed uploads.
Rollout to Rapid Release and Scheduled Release domains is complete. | Available to all Google Workspace customers, Workspace Individual Subscribers, and users with personal Google accounts. | Visit the Help Center to learn more about uploading files & folders to Google Drive.
Support for file and people smart chips now available with Google Sheets API
Last month, we introduced the ability to take basic actions to create and modify tables via the Google Sheets API. This week, we’re expanding the API functionality to include the ability to write and read file and people smart chips. | Rollout to Rapid Release and Scheduled Release domains is complete. | Available to Google Workspace customers, Google Workspace Individual subscribers, and users with personal Google accounts. | Visit the Developer Documentation to learn more about the Google Sheets API.
Previous announcements
The announcements below were published on the Workspace Updates blog earlier this week. Please refer to the original blog posts for complete details.
Google Meet now offers customizable caption styling
You can now customize the styling of captions in Google Meet, including the font size, font type, color, and background color. This allows for the captions to be customized in a way that works best for you. | Learn more about caption styles in Meet.
Adding new admin settings to control Google Form responses
Admins can now independently control two distinct settings: whether users in their domain can respond to forms created externally, and whether users in their domain can share forms with external recipients. | Learn more about admin controls for Google Forms.
Create a Google Vid from Google Slides
At Google I/O, we introduced the ability to turn existing Google Slides content into engaging videos using Google Vids. Today, we’re starting to roll out the first iteration of this new experience for Vids customers. | Learn more about creating a Vid using Slides.
Data migration log events are available in the Admin console
Beginning this week, you can now access log events for the new data migration service in the audit and investigation tool and the security investigation tool. You can search across a variety of attributes including: Who started a migration, What data is being migrated and When the migration was set up or executed, and more. | Learn more about Data migration log events.
Generate charts and valuable insights using Gemini in Google Sheets in additional languages
Earlier this year, we introduced the ability for Gemini to provide insights and generate charts based on your data in Google Sheets. Today, we’re excited to expand this feature to the following languages: Spanish, Portuguese, Japanese, Korean, Italian, French and German. | Learn more about language expansion for Gemini in Sheets.
The Gemini app is now available to all education users
We are expanding support for the Gemini app for Google Workspace for Education users of all ages. | Learn more about the Gemini app for education users.
For a recap of announcements in the past six months, check out What’s new in Google Workspace (recent releases).
Wednesday, May 28, 2025
Configure Calendar interoperability with Microsoft Office 365 using the Microsoft Graph API
What’s changing
Beginning today, Admins can use the Microsoft Graph API to enable Calendar interoperability with Microsoft Office 365. The Graph API will replace the existing Exchange Web Services (EWS) API, which will no longer be supported by Microsoft beginning October 1, 2026 – we recommend that admins update their interop configuration to Graph API as soon as possible.
Admins can configure interoperability via the Graph API in the Admin console by going to Apps > Google Workspace > Calendar > Calendar Interop Management > Exchange availability in Calendar > Allow Google Calendar to display Exchange user availability. The user interface has also been streamlined and admins can easily select an endpoint from a drop down list, and enter other details like the specific Microsoft domain that should be connected to Calendar, and specify role accounts for user availability and resource booking.
Quickly select your endpoint type from the new drop down list
Enter additional details, like the Microsoft domain you want to connect to and role accounts.
We’ve also made additional updates to improve the overall admin experience, including additional user interface updates and troubleshooting — keep reading for more information.
Who’s impacted
Admins
Why it’s important
These updates will ensure calendar interoperability continues after support for EWS ends and improve the overall experience for configuring and managing interoperability for admins. Additionally, the Graph API allows admins to grant access to Exchange calendar data only, ensuring access isn’t too broadly scoped.
Additional details
- Also included in this update are the following improvements:
- Admins can use the same role accounts for user availability and resource booking when configuring their Graph API interop setup.
- We’re making it easier for admins to troubleshoot errors encountered while setting up interoperability. Admins can now see detailed information each step of the way which will help them work through potential issues in the setup configuration.
- The overall Admin user interface has been streamlined as well. Admins can define which domains are supported by which endpoint, and this information is neatly listed in a table. This makes it easily scannable and actionable, and helps avoid unnecessary queries trying to get the availability of users who are not part of a domain covered by the interop setup.
Apps > Google Workspace > Settings for Calendar > Calendar Interop management
- If admins select EWS, or have existing endpoints set up using EWS, they will see a reminder banner that EWS will no longer be supported by Microsoft and to use the Graph API instead.
Getting started
- Admins: As the Exchange Web Services endpoint type will no longer be supported beginning October 1, 2026, we recommend updating your interop configuration to Graph API as soon as possible. Visit the Help Center to learn more about Calendar interoperability, and specifically allowing Calendar users to see Exchange availability.
- End users: There is no end user action required.
Rollout pace
- Rapid Release and Scheduled Release domains: Gradual rollout (up to 15 days for feature visibility) starting on May 28, 2025
Availability
Available for Google Workspace:
- Business Starter, Standard, and Plus
- Enterprise Starter, Standard, and Plus
- Education Fundamentals, Standard, and Plus
- Frontline Standard and Plus
- Nonprofits
Resources
- Google Workspace Admin Help: About Calendar interop
- Google Workspace Admin Help: Allow Calendar users to see Exchange availability
Friday, May 16, 2025
Google Workspace Updates Weekly Recap - May 16, 2025
6 New updates
Unless otherwise indicated, the features below are available to all Google Workspace customers, and are fully launched or in the process of rolling out. Rollouts should take no more than 15 business days to complete if launching to both Rapid and Scheduled Release at the same time. If not, each stage of rollout should take no more than 15 business days to complete.
Easily connect to BigQuery data using Saved Queries in Connected Sheets
Scan documents easier using Google Drive on Android devices
To improve upon the scanning experience in the Google Drive app on Android devices, we’re increasing the size and updating the style of the scan buttons. To scan something, open the Drive app on your Android device > scan a document > edit scan (if desired) > upload to Drive. | Rollout to Rapid Release domains is complete; Rolling out now to Scheduled Release domains, with expected completion by June 30, 2025. | Available to Google Workspace customers, Google Workspace Individual subscribers, and users with personal Google accounts. | Visit the Help Center to learn more about scanning documents with Google Drive.
Export Gemini responses to a Google Doc or Sheet from Gemini in the side panel of Google Drive
Users can collaborate with Gemini in Google Drive to perform various tasks, such as extracting data, drafting proposals, creating study guides and more. We’re excited to build upon this by giving users the ability to convert Gemini’s response directly into a Sheet or a Doc. After asking Gemini a question, click the ‘Export to Doc’ or ‘Export to Sheet’ button, and you’ll have an artifact that you can continue working on or share with others. | Rolling out now to Rapid Release and Scheduled Release domains. | Available to Business Standard and Plus; Enterprise Standard and Plus; Google One AI Premium; Customers with the Gemini Education or Gemini Education Premium add-on, and anyone who previously purchased a Gemini Business or Gemini Enterprise add-on. | Visit the Help Center to learn more about collaborating with Gemini in Google Drive.
Create even more interactive YouTube assignments in Google Classroom
In 2024, we added AI-suggested questions that educators can easily attach to the video based on its content to save educators time. Today, we’re excited to announce that we’re expanding the collection of YouTube videos that have AI-suggested questions available. As a result, educators can create even more interactive YouTube assignments in Classroom more quickly and efficiently, with the help of Gemini. Before assigning the interactive video activity, educators will be able to edit the suggested questions ahead of attaching the YouTube video to the assignment. | Rollout to Rapid Release and Scheduled Release domains is complete. | Available for Google Workspace Education Plus and the Teaching and Learning add-on. | Visit the Help Center to learn more about interactive questions for YouTube videos in Google Classroom.
Your users can now express interest in upgrading their Google Workspace subscription
We’re introducing a simple way for Workspace end users to request an upgraded edition of Google Workspace from their admins. To send this request, Workspace end users will see a path to request an upgraded Workspace edition including additional Gemini features when they interact with Gemini, such as with the Gemini icon displayed across Workspace apps. This interaction will provide an end user a path to complete a request form for an upgraded Workspace edition. Super admins will receive this request by email, and from there they can choose to upgrade their Workspace subscription directly in the Admin console. | Admins can disable these requests at any time in the Admin console by going to Account > Account Settings > Gemini for Google Workspace, and deselecting the ‘User-requested upgrades’ setting — use this article in our Help Center for more information. | Please note this is only available for customers in the US and India with fewer than 300 licenses. | Rolling out now to Rapid Release and Scheduled Release domains. | Learn more about Gemini for Workspace, including our recent Gemini for Workspace announcements.
Previous announcements
The announcements below were published on the Workspace Updates blog earlier this week. Please refer to the original blog posts for complete details.
Use Gemini in Drive to interact with folders in 20+ additional languages
Last year, we added folder support to Gemini in the side panel of Google Drive. This week, we’re excited to announce this experience is now available in 20+ languages. | Learn more about language availability for Gemini in Drive.
Use Gemini in Google Sheets to quickly add dropdowns, pivot tables, filters, and more
Analyzing and manipulating data in spreadsheets can be complex and time-consuming, even for experienced users. This week, we're introducing powerful new editing options within Gemini in Sheets that are designed to help everyone accomplish more, faster. | Learn more about Gemini in Sheets.
Google Workspace apps for Gmail, Google Drive, Google Docs, Calendar, Keep, and Tasks are now generally available for the Gemini app
Earlier this year, we launched Google Workspace apps (formerly known as "extensions") in Gemini in open beta. When enabled, Gemini can reference and incorporate data from these apps to generate even more informed and relevant responses, bringing Gemini’s capabilities more seamlessly into your daily workflows, helping enhance productivity. Workspace apps are available for: Calendar, Docs, Drive, Gmail, Keep, Tasks. | Learn more about Workspace apps in the Gemini app.
Extract and categorize data in AppSheet with the power of Gemini
At Google Cloud Next 2025, we introduced Gemini in AppSheet solutions for AppSheet Enterprise Plus users. Now you can automatically extract key information from uploaded photos, parse through complex PDFs, or even categorize, route and prioritize incoming requests based on their content – all seamlessly within your existing AppSheet apps. The new AI Task (Preview) feature, powered by Gemini, makes this a reality. | Learn more about Gemini in AppSheet.
Upcoming Changes to Microsoft Exchange Migrations
Beginning May 31, 2025, the legacy Data Migration Service will no longer support migrating email, calendar, and contact data from Microsoft Exchange on-premises servers (e.g., Exchange 2010, 2013, or 2016). Admins will not be able to start new migrations after May 31, 2025 – migrations that are in progress will continue until completion. | Learn more about changes to Microsoft Exchange Migrations.
Completed rollouts
Rapid Release Domains:
Scheduled Release Domains:
- New sidebar with design elements in Google Slides makes building presentations easier
- Introducing even more high-quality Google Slides templates to elevate your presentations
Rapid and Scheduled Release Domains:
- Educators can now upload content to Read Along in Google Classroom
- Control Workspace Business and Enterprise users’ access to new Google Workspace with Gemini features before general availability
- Updates for configuring your preferred language for “Take notes for me”, recorded captions, and meeting transcripts (Calendar availability)
- Generate and use images with Gemini in the side panel of Gmail on Android and iOS devices (Android only)
- Expanding Google Vids to Business Starter, Enterprise Starter and Nonprofit customers
- Google Voice gets support for three way calling and a refreshed in-call user interface
- Generate custom video clips in Google Vids with Veo 2
- Gemini app reporting now available for all Google Workspace for Education customers
- 2.5 Pro Preview: our latest Pro experimental model is now available in the Gemini app
- Audio Overview in the Gemini app is now available in 45 additional languages
- Use Gemini in Google Sheets to quickly add dropdowns, pivot tables, filters, and more
- Extract and categorize data in AppSheet with the power of Gemini
- Conduct in-depth two-way conversations with Gemini Live
For a recap of announcements in the past six months, check out What’s new in Google Workspace (recent releases).
Friday, May 2, 2025
Google Workspace Updates Weekly Recap - May 2, 2025
4 New updates
Unless otherwise indicated, the features below are available to all Google Workspace customers, and are fully launched or in the process of rolling out. Rollouts should take no more than 15 business days to complete if launching to both Rapid and Scheduled Release at the same time. If not, each stage of rollout should take no more than 15 business days to complete.
Create custom emojis using the Google Chat API
The Google Chat Custom Emoji API is now generally available for Google Workspace developers. You can now call the Chat API to manage custom emoji when custom emoji are enabled for your organization:
Use tables with the Google Sheets API
Following the improvements made to tables in Google Sheets in March and April, we’re excited to introduce API support for tables. Now, users will be able to take basic actions to create and modify tables via the Sheets API. | Rollout to Rapid Release and Scheduled Release domains is complete. | Available to Google Workspace customers, Google Workspace Individual subscribers, and users with personal Google accounts. | Visit the Help Center to learn more about using tables in Google Sheets and developer documentation to learn more about tables.
Deep Research is now available on the Gemini mobile app
File upload to Gems in the Gemini app is now supported in more languages
Previous announcements
The announcements below were published on the Workspace Updates blog earlier this week. Please refer to the original blog posts for complete details.
Enhance Your Organization’s Security with Out-of-Domain File Warnings in Google Workspace
Use NotebookLM to generate Audio Overviews more than 50 languages
Audio Overviews are lively “deep dive” discussions between two AI hosts who summarize key topics in your sources. These turn documents, slides, charts and more into engaging discussions with one click and are especially useful for learning on-the-go. This week, we’re excited to expand Audio Overviews to over 50 languages in Beta. | Learn more about Audio Overviews in new languages.
Expanding Google Vids to Business Starter, Enterprise Starter and Nonprofit customers
We’re excited to expand Google Vids to Business Starter, Enterprise Starter, and Nonprofit customers, giving them full access to Vids, and access to Vids AI features for a limited time. | Learn more about the Vids expansion.
Express yourself and quickly respond to emails with emojis reactions in Gmail
We’re excited to introduce the ability for users to react to emails in Gmail with emojis. This new feature allows users to quickly respond, acknowledge receipt of an email, and express themselves more authentically. | Learn more about emoji reactions in Gmail.
Google Voice gets support for three way calling and a refreshed in-call user interface
We’re pleased to introduce two significant updates for Google Voice: support for three way calling and an overall enhanced, redesigned in-call user interface. | Learn more about three way calling.
Start a conversation with Gemini in the side panel of Google Drive about specific files
We recently added clickable “nudges” at the top of the Drive homepage and folders to help you get started with Gemini in Drive even faster, and this week we’re introducing updates that make starting a conversation with Gemini about a specific set of files easier. | Learn more about Gemini conversations in Drive about specific files.
Completed rollouts
Rapid Release Domains:
Scheduled Release Domains:
- Gemini Shelf on Folder Home: Get started with Gemini in Google Drive quickly with new homepage feature
- Group by view aggregation now available for tables in Google Sheets
Rapid and Scheduled Release Domains:
- Beginning September 30, 2024: third-party apps that use only a password to access Google Accounts and Google Sync will no longer be supported
- Mobile scans are now crisper and clearer with auto enhancements in the Google Drive scanner
- Support for continuous framing on select Logitech Series One room kits
- Help me write in Gmail now available in Japanese and Korean (mobile)
- Save time making changes or updates to AI voiceovers in Google Vids
- Google Classroom is expanding to 7 additional languages
- New features available in NotebookLM and NotebookLM Plus (language selector)
- Updates for configuring your preferred language for “Take notes for me”, recorded captions, and meeting transcripts (Mobile availability only)
- Create custom chart groupings in Connected Sheets
- Data classifications labels for Gmail are now generally available
- Introducing easier editing for objects and audio tracks in Google Vids
- Introducing draggable dividers on large screen Android devices
- Use NotebookLM and NotebookLM Plus to generate Audio Overviews more than 50 language
For a recap of announcements in the past six months, check out What’s new in Google Workspace (recent releases).
Wednesday, April 9, 2025
Create and manage grading periods using the Google Classroom API
What’s changing
- Create, modify, and delete grading periods in courses
- Read grading periods in courses
- Reference and set grading periods on CourseWork resources
- Apply grading period settings to existing CourseWork items
Who’s impacted
Developers
Why you’d use it
The new grading periods endpoints allow developers to create, modify, and read grading periods in Classroom on behalf of administrators and teachers.
Getting started
- Admins: The Classroom API provides a RESTful interface for you to manage courses and rosters in Google Classroom. Learn more about the Classroom API overview.
- Developers:
- Application developers can use the Classroom API to integrate their apps with Classroom. These apps need to use OAuth 2.0 to request permission to view classes and rosters from teachers. Admins can restrict whether teachers and students in their domain can authorize apps to access their Google Classroom data.
- All API and Classroom share button integrations should follow the Classroom brand guidelines.
Rollout pace
- This feature is available now.
Availability
- A Google Workspace for Education Plus license is required to access this feature for both education leaders and educators. Learn more about licensing requirements.
Resources
Friday, February 21, 2025
New Chat Usage Analytics Updates for Admins and Developers
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 sentNumber of attachments uploadedNumber of spaces createdNumber 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.
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, viewing Apps reports for your organization and using the security investigation tool.
- Developers: Check out our developer documentation for more information on Chat Audit Activity Events. and CustomerUsageReports.get and UserUsageReport.get.
Rollout pace
- Rapid Release and Scheduled Release domains: 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
- Enterprise Standard and Plus
- Education Standard and Plus
- Enterprise Essentials Plus
- Frontline Standard
- And Cloud Identity Premium customers
Resources
- Developer documentation: Reports API Overview
- Developer Documentation: Google Chat Parameters: CustomerUsageReports.get
- Developer Documentation: Google Chat PArameters: UserUsageReport.get
- Developer Documentation: Chat Audit Activity Events
- Developer Documentation: Admin SDK API developer platform release notes
- Google Workspace Admin Help: Understand Chat usage with analytics
- Google Workspace Admin Help: View Apps reports for your organization
- Google Workspace Admin Help: About the security investigation tool
- Workspace Updates Blog: New Google Chat usage reports provide deeper insights into user engagement







