Google Chat developer platform release notes

Generally Available: If you're migrating to Google Chat from other messaging platforms, you can now create a group chat in import mode using the spaces.create method.

Developer Preview: You can now use a read-only scope (https://www.googleapis.com/auth/chat.customemojis.readonly) to get or list custom emoji.

Developer Preview: You can now call the Chat API to get or update a user's space notification settings. To learn more, see the spaceNotificationSetting reference documentation.

Generally Available: The following widgets are now available for building card-based user interfaces:

• Chip
• Overflow Menu
• Material Buttons
• Collapsible Text paragraph
• Customizable control button of collapsible Section

Chat apps can use these widgets in card messages, homepages, and dialogs. For examples, see Design an interactive card or dialog.

Developer Preview: When creating custom emoji is turned on for a Workspace organization, you can now call Chat API to manage custom emoji:

• Create custom emoji (RPC, REST)
• Delete custom emoji (RPC, REST)
• Get custom emoji (RPC, REST)
• List custom emoji (RPC, REST)

To learn more, see CustomEmoji (RPC, REST) in the Chat API documentation.

Generally available: You can now call the Chat API to create announcement spaces, and read and update the permission settings of a space. For more information, see the following reference documentation:

• PredefinedPermmissionSettings field for the Spaces resource
• PermissionSettings field for the Spaces resource

Developer Preview: The following Chat API methods support app authentication using a new type of authentication scope, https://www.googleapis.com/auth/chat.app.*:

• Create a named space as a Chat app with https://www.googleapis.com/auth/chat.app.spaces or https://www.googleapis.com/auth/chat.app.spaces.create.
• Update a space as a Chat app with https://www.googleapis.com/auth/chat.app.spaces
• Delete a named space as a Chat app with https://www.googleapis.com/auth/chat.app.delete
• Get details about a space as a Chat app with https://www.googleapis.com/auth/chat.app.spaces.
• Invite or add a user to a space as a Chat app with https://www.googleapis.com/auth/chat.app.memberships.
• Update a membership as a Chat app with https://www.googleapis.com/auth/chat.app.memberships.
• Remove a member from a space with https://www.googleapis.com/auth/chat.app.memberships.

To learn more, see Types of required authentication and Authenticate as a Chat app.

Generally Available: The chatSpaceLinkData object has been added to the RichLinkMetaData field of the spaces.messages resource. This lets you add a smart chip to your message that points to a Chat space in any field that supports formatted text.

Generally Available: Google Workspace administrators can now call the Google Chat API to manage and search Google Chat spaces across their organization. This functionality lets them manage spaces at scale and automate common or repeatable tasks, such as the following:

• Search spaces based on specified criteria
• List members of a space
• Add members to and remove members from a space
• Get details about a member and a space
• Update or delete a space
• Update a user's membership

For more information about managing spaces, read the documentation at Manage Google Chat spaces as a Google Workspace administrator.

For more information about searching spaces, read the documentation at Search for and manage Google Chat spaces for your Google Workspace organization.

Developer Preview: If you're migrating to Google Chat from other messaging platforms, you can now create a group chat in import mode using the spaces.create method.

Developer Preview: The following widgets are now available for building card-based user interfaces:

• Chip
• Overflow Menu
• Material Buttons
• Collapsible Text paragraph
• Customizable control button of collapsible Section

Chat apps can use these widgets in card messages, homepages, and dialogs. For examples, see Design an interactive card or dialog.

Generally Available: You can now import a space from other messaging platforms, and allow external users to join that Chat space. For more information, see the externalUserAllowed option.

Generally Available: When building Chat apps using Google Cloud Functions, Cloud Run, or any system that supports authentication via ID tokens, you can now Authenticate requests using Cloud Functions or Cloud Run or Authenticate requests with an App URL ID Token to verify that the requests to your app came from Google Chat.

Generally Available: You can now call the Chat API to Make a Google Chat space discoverable to specific users in a Google Workspace organization using the accessSettings field on the Space resource. You can read the URI of the space using the spaceUri field.

(Generally Available): Dialogflow CX Chat apps can open dialogs and receive data inputted by users in card messages and dialogs.

(Developer Preview): You can now use the Chat API to create announcement spaces, plus read and update the permission settings of a space. For more information, see the PredefinedPermissionSettings and PermissionSettings fields.

(Generally Available): You can now add a Google Group to a Chat space using the spaces.members.create method or the spaces.setup method. You can remove a Google Group from a space using the spaces.members.delete method.

Google Chat apps can now create a subscription to receive events for all Chat spaces where the user is a member. To target all spaces for a user, set the subscription's targetResource field to //chat.googleapis.com/spaces/-. To learn more, see Subscribe to Google Chat events.

(Developer Preview): If you're a domain administrator or a delegated administrator, you can now include the useAdminAccess parameter when you call the Chat API with your administrator privileges with the following methods to manage Chat spaces and memberships in your Workspace organization:

• Get a space
• Update a space
• Get a member
• Update a member

To learn more, see Authenticate and authorize using administrator privileges.

(Developer Preview): If you're a domain administrator or a delegated administrator, you can now include the useAdminAccess parameter when you call the Chat API with your administrator privileges to manage Chat spaces and memberships in your organization. The following API methods are supported:

• Search spaces
• Delete spaces
• List memberships
• Create memberships
• Delete memberships

To learn more, see Authenticate and authorize using administrator privileges.

(Generally available): 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:

• Get space read state to return details about a user's read state within a space.

• Update space read state to update a user's read state within a space.

• Get thread read state to return details about a user's read state within a thread.

(Generally Available): Build a Chat app that understands and responds with natural language using a direct integration between Dialogflow CX and Google Chat API. To learn how, see Build a Dialogflow CX Google Chat app.

(Generally available): 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.

For details, see Send an app home card message for a Google Chat app.

(Generally Available): Google Chat apps now support Google Apps Script's Card Service. If you've built your Chat app using Apps Script, you can use Card Service to build user interfaces such as card messages and dialogs. For more information, see the Card Service reference documentation.

(Generally available): You can now update a human user's membership in a Chat space to change their role between regular member and space manager using the spaces.members.patch method. To learn more, see Update a user's membership in a Google Chat space.

(Developer Preview): You can now import a space from other messaging platforms, and allow external users to join that space. For more information, see the externalUserAllowed option.

(Generally available): Google Chat apps can now use accessory widgets, which are interactive widgets that appear at the bottom of a message. For details, see Send a message.

(Developer Preview): You can now get or list events about a Google Chat space. For example, you can track periodic resource changes, such as monthly reports of new or changed members in a space, or fetch events that are missing from subscriptions using the Google Workspace Events API.

The following types of space events are supported:

• A message is created or updated.
• A member is added, updated, or removed.
• The space is updated.

For more information, see the following:

• Work with events from Google Chat.
• Get details about an event in a space.
• List events from a space.

(Developer Preview): Build a Chat app that understands and responds with natural language using a direct integration between Dialogflow CX and Google Chat API. To learn how, see Build a Dialogflow CX Google Chat app.

(Generally available): The formattedText field on the Message resource includes the markup syntax for bulleted list text formatting. For more information, see Format a text message.

(Developer Preview): Google Chat apps now support Google Apps Script's Card Service. If you've built your Chat app using Apps Script, you can use Card Service to build user interfaces such as card messages and dialogs. For more information, see the Card Service reference documentation.

(Developer Preview): Chat apps can now subscribe to events about users. The following event types are supported:

• New memberships
• Updated memberships
• Deleted memberships
• Multiple memberships have changed

For details, see Subscribe to Google Chat events in the Google Workspace Events API documentation.

(Developer Preview): You can make a Chat space discoverable to a target audience instead of inviting users individually.

(Generally available): 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.

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

(Developer Preview): Chat apps can now add interactive buttons to the bottom of messages. For details, see the reference documentation.

Chat apps can now send messages privately in spaces with multiple people. For details, see Send private messages to Google Chat users.

(Generally available): The Card Builder Tool is now available to help you design and preview card messages in Google Chat apps.

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:

• Get space read state to return details about a user's read state within a space.

• Update space read state to update a user's read state within a space.

• Get thread read state to return details about a user's read state within a thread.

(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).

(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.

(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:

• Authenticate as an app
• Authenticate as a user
• Try it - Respond to Incidents

(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.

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

(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.

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

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.

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:

• Set up a space
• Find a direct message
• Create a membership
• Get a membership
• Delete a membership

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

You can now specify no divider between card sections.

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.

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.

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.

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

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

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.