Google Chat developer platform release notes

This page contains release notes for features and updates to the Chat developer platform. We recommend that Chat developers periodically check this list for any new announcements.

To get the latest product updates delivered to you, add the URL of this page to your feed reader, or add the feed URL directly: https://developers.google.com/feeds/chat-release-notes.xml.

December 08, 2023

The Google Chat API spaces.list() method now supports app authentication for query filters.

December 06, 2023

Developer Preview: You can now get and update a user's read state in a space, and get a user's read state in a message thread. User read states are singleton resources that represent details about a specified user's last read message.

The users.spaces resource represents a user's read state in a space. The users.spaces.threads resource represents a user's read state in a message thread.

User read states support the following methods:

November 30, 2023

(Generally available): You can now retrieve Google Groups that are members of a Google Chat space using ListMemberships (with the showGroups option) and GetMembership. If you try to add a member to a Chat space while this member is already part of a Google Group in the same space, it triggers an already exists error (HTTP status code 409).

November 28, 2023

(Developer Preview): Your Chat app can now send an app home card message to a user. This message is a customizable card message that a Chat app sends to a user when they open a direct message with the Chat app.

November 06, 2023

(Generally available): You can now call the Chat API from Apps Script with the Advanced Chat Service. To learn how, see Advanced Chat Service in the Apps Script reference documentation.

We've also updated the Apps Script code samples to use the Advanced Chat Service in the following Chat API developer guides:

November 03, 2023

Users can now install Google Chat apps from app listing pages on the Google Workspace Marketplace. For details, see Publish Google Chat apps.

October 30, 2023

(Developer Preview): Google Chat apps can now subscribe to the following types of events about message reactions:

  • New reactions
  • Removed reactions
  • Multiple reactions have changed.

For details, see Subscribe to Google Chat events.

October 24, 2023

(Developer Preview): You can now migrate historical memberships when you import data into Google Chat.

October 17, 2023

(Generally available): Multiselect menus for cards and dialogs are now generally available. Multiselect menus let users select Google Workspace users and spaces, or select items from external data sources. For details, see Selection input.

October 03, 2023

(Developer Preview): Google Chat apps can now monitor and receive events about Google Chat spaces. The following event types are supported:

  • New messages
  • Updated messages
  • New members
  • Updated members
  • Removed members
  • Updated space
  • Deleted space

To receive events, Chat apps create subscriptions using the Google Workspace Events API. To learn more, see the Google Workspace Events API overview.

September 28, 2023

You can now use the formattedText field to view the text formatting sent in a message.

September 15, 2023

Developer Preview: You can now update a human user's membership in a Chat space. For example, you can use the spaces.members.patch method to update membership roles from member to manager and from manager to member.

August 08, 2023

Google Chat users outside of Google Workspace organizations can now install and use public Google Chat apps. To learn about how users discover and use Chat apps, see Publish Google Chat apps.

July 28, 2023

Google Chat apps that authenticate as a user can now reference users with their email address. The following Chat API methods support using email addresses to reference users:

Chat apps can also use email addresses to @mention users. To learn more, see Mention users in a message.

July 13, 2023

You can now specify no divider between card sections.

July 10, 2023

Multiselect menus are now available in Developer Preview. Multiselect menus help users input static and dynamic data for Google Chat apps. To learn more, see the Selection input widget documentation.

June 07, 2023

Developer Preview: Available as part of the Google Workspace Developer Preview Program, which grants early access to certain features.

Import data from your other messaging platforms into Google Chat. You can import existing messages, attachments, reactions, memberships, and space entities from your other messaging platforms to corresponding Chat API resources. You can import this data by creating Chat spaces in import mode and importing data into those spaces.

May 25, 2023

You can authenticate and authorize users' credentials to access the Chat API by using OAuth 2.0. Authenticating and authorizing with user credentials lets Chat apps access user data and perform operations on the authenticated user's behalf. When an app performs an action with user authentication (such as creating a space), Google Chat might display an attribution message that tells users the name of the app that performed the action for the user who authorized it.

Oauth 2.0 scopes are available for you to request and your users to consent to.

Quotas and limits are applied to the Chat API.

The following methods are available:

March 06, 2023

You can now design your Chat app to include checkboxes, radio buttons, switches, or a dropdown menu in your Chat app. For more information, see SelectionInput widget.

January 18, 2023

Chat apps can now receive and respond to user-submitted information in cards and dialogs. For more information, see Process information inputted by users.

January 17, 2023

Buttons can now include text and an icon. Previously, only an icon or only text was allowed in buttons.

June 28, 2022

Cards v1 is deprecated. Instead, use Cards v2.

June 16, 2022

On the web, Google Chat cards now match Google Material Design. The Material Design cards feature aesthetic enhancements that improve usability and render faster.

May 15, 2022

Developer Preview: Available as part of the Google Workspace Developer Preview Program, which grants early access to certain features.

On mobile devices, Google Chat cards now match Google Material Design. The Material Design cards feature aesthetic enhancements that improve usability and render faster.