Google Workspace developer release notes

Developer Preview: You can now configure and respond to message actions in Google Chat. Message actions let users invoke your Chat app from the message context menu. This feature is available for both Google Chat apps and Google Workspace Add-ons that extend Google Chat through the Developer Preview Program.

Developer Preview: You can now configure and respond to message actions in Google Chat. Message actions let users invoke your Chat app from the message context menu. This feature is available for both Google Chat apps and Google Workspace Add-ons that extend Google Chat through the Developer Preview Program.

Meet API

Generally Available: The get and list methods on the smartNotes resource can now retrieve smart notes files in a conference record. For details, see Work with artifacts.

Additionally, subscriptions are now generally available for the following smartNotes events:

• google.workspace.meet.smartNote.v2.started
• google.workspace.meet.smartNote.v2.ended
• google.workspace.meet.smartNote.v2.fileGenerated

For details, see Subscribe to Google Meet events and Respond to events from Google Meet.

Generally Available: Generally available - You can now call the Chat API to create and manage custom sections and organize conversations into a personalized view.

For more information, see the following guides:

• Create a custom section
• Delete a custom section
• List custom sections
• Update a custom section
• Position a custom section
• List custom section items
• Move a custom section item

Generally available: The following Chat API methods support app authentication with administrator approval:

• Get a message
• List messages
• Get a space event
• List space events

Additionally, Chat apps can now call the following methods in the Google Workspace Events API using app authentication with administrator approval:

• Subscribe to Chat space events
• Update or renew a subscription
• Reactivate a subscription

Generally available: Chat apps can now format text with block quotes. For details, see Format your messages.

Generally Available: The AddOnsResponseService and its associated classes in Apps Script are now generally available. This service allows developers to create and manage interactive responses for Google Workspace Add-ons that extend Google Chat.

Generally Available: The Dialogflow integrations for Google Workspace Add-ons that extend Google Chat is now generally available. These integrations let add-ons use Dialogflow CX or Dialogflow ES to understand and respond to user queries in natural language. For more information, see Build a Dialogflow CX Chat app or Build a Dialogflow ES Chat app.

Generally Available: The Google Cloud Pub/Sub integration for Google Workspace Add-ons that extend Google Chat is now generally available. This integration allows add-ons to receive and respond to events from Google Chat using Pub/Sub. For more information, see Build a Chat app that uses Pub/Sub.

Developer Preview: Chat apps can now create messages containing cards on behalf of users with user authentication. Additionally, apps can asynchronously update the cards in these messages without requiring user interaction. For more information, see Create and update interactive cards.

Deprecated: The method setAuthentication(clientId, signingKey) has been deprecated and is scheduled for sunset in June 2026. This change is because Maps platform client IDs were deprecated on May 26, 2025, and can't be used after May 31, 2026. Instead, use setAuthenticationByKey(apiKey) or setAuthenticationByKey(apiKey, signingKey). To get an API key, refer to the Client ID Migration Guide.

Generally Available: To authenticate to the Maps service, you can now use an API key with the new methods setAuthenticationByKey(apiKey) and setAuthenticationByKey(apiKey, signingKey). To reset authentication to the default mode, use resetAuthenticationApiKey().

Generally Available: The enforceExpansiveAccess query parameter is now deprecated for all methods in the permissions resource (v2 and v3). To restrict item access, use the folders with limited access setting instead.

We have updated the guidance for using Google Meet conferences on Google Calendar events.

Reusing Google Meet codes across different events can cause access issues, and can expose meeting details to unintended users. We recommend that you generate a new conference using the createRequest field for every new event.

For more information about using events with the Calendar API, see the documentation for the events resource.

Generally Available: When sending a message with app authentication, Google Chat API now supports mentioning users who haven't joined a Chat space or are members of a space that is in import mode. Previously, only sending a message with user authentication was supported. To learn how, see Mention users in a text message.

Developer Preview: You can now build Google Chat apps as Google Workspace add-ons that use Cloud Pub/Sub to receive messages. This architecture is useful if your Chat app is behind a firewall. For details, see Build a Chat app that uses Pub/Sub.

Generally Available: The Gmail Postmaster Tools API v2 is now generally available. The API provides access to the full Postmaster Tools dataset—including compliance status data—and includes enhancements like flexible querying with queryDomainStats and support for batch operations. For details on how to use the v2 API, see the updated Postmaster Tools API documentation.

Generally Available: You can now convert your interactive event-driven Chat apps to Google Workspace Add-ons that extends Chat.

By converting, your Google Chat app can use the Google Workspace Add-ons framework, opening up new possibilities for integration and features within Google Chat and across Google Workspace. For example, instead of two distributions — one Google Chat app and one Google Workspace add-on — you can distribute a single Google Workspace add-on through Google Workspace Marketplace that extends Chat apps alongside other Google Workspace host applications, like Gmail, Calendar, and Docs.

To learn more, see Convert an interactive Google Chat app to a Google Workspace add-on.

Generally Available: Use Apps Script's Vertex AI advanced service to call the Vertex AI API and prompt AI models to generate text, images, and more.

For details, see the Vertex AI advanced service reference documentation.

The licenseNotification resource and the licenseNotification.list method are now deprecated. The licenseNotification.list method previously retrieved a list of licensing notifications for a given app.

There is no alternative resource or method within the Google Workspace Marketplace API. However, user-initiated install events can be tracked through Google Analytics.

The Google Chat platform samples gallery now lets you find samples by products, language, and sample type. The gallery also features the following new samples for building Chat apps:

• Agent2Agent agents
• ADK AI agents
• Dialogflow ES
• Dialogflow CX

The Apps Script samples gallery now lets you find samples by use case, products, and sample type. The gallery also features the following new samples:

• Build a Google Chat app with an ADK AI agent
• Build a Chat app with an Agent2Agent agent
• Analyze and label Gmail messages with Gemini and Vertex AI

Developer Preview: You can now build Chat apps that extend Google Workspace add-ons using Apps Script's AddOnsResponseService. For details, see AddOns Response Service.

The Add-ons samples gallery now lets you find samples by products, languages, sample type, and add-on type. The gallery also features the following new samples:

• Build Chat apps using Agent2Agent agents, ADK AI agents, Dialogflow ES, and Dialogflow CX
• Plan travels with an AI agent accessible across Google Workspace
• Analyze and label Gmail messages with Gemini and Vertex AI

License Manager API: The SKU name "Gemini Education" has been renamed to "Google AI Pro for Education." For details, see the Google Product and SKU IDs documentation and announcement.

Generally Available: The Google Drive API now supports the reading of content approvals on Drive files through the approvals resource. To retrieve approvals on a file, you can use either the get or list method.

For details, see Manage approvals.

(Developer Preview): You can now get approval events in Google Drive. The following event types are supported:

• An approval is created, cancelled, reset, or completed on a file.
• An approval reviewer is changed on a file.
• An approval reviewer responded to an approval on a file.

For details, see Subscribe to Google Drive events in the Google Workspace Events API documentation. For information on how to receive Google Drive events from Google Cloud Pub/Sub, see Work with events from Google Drive.

Meet API

Developer Preview: Subscriptions are now available for the following smartNotes events:

• google.workspace.meet.smartNote.v2.started
• google.workspace.meet.smartNote.v2.ended
• google.workspace.meet.smartNote.v2.fileGenerated

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

For information on how to receive Google Meet events from Google Cloud Pub/Sub, see Respond to events from Google Meet.

Meet API

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

You can now retrieve smart notes files in a conference record using the get and list methods on the smartNotes resource.

For details, see Work with artifacts.

Developer Preview: You can now dynamically populate drop-down menus in Google Chat apps with data from Google Workspace or external data sources, with an autocomplete functionality. To learn more, see Add interactive UI elements to cards.

Developer Preview: You can now call the Chat API to create and manage custom sections and organize conversations in a personalized view:

• Create section (RPC, REST)
• Delete section (RPC, REST)
• List sections (RPC, REST)
• Update section (RPC, REST)
• Position section (RPC, REST)
• List section items (RPC, REST)
• Move section items (RPC, REST)

To learn more, see Section (RPC, REST) and SectionItem (RPC, REST) in the Chat API documentation.

Limited Preview: Extending Google Workspace Studio with add-ons is in limited preview.

Generally available: The Chat API now supports reading rich links to Gmail threads in Chat messages that appear as chips. To learn more, see RichLinkType in the Chat API reference documentation.

Developer Preview: You can now build Dialogflow CX and Dialogflow ES Chat apps as Google Workspace add-ons.

Generally Available: You can now build add-ons that extend Google Workspace Studio (previously known as Google Workspace Flows). For details, see Extend Google Workspace Studio.

For ideas about what you can build, see Introducing Google Workspace Studio: Automate everyday work with AI agents in the Google Workspace blog.

Developer Preview: You can now access data in Gmail Postmaster Tools v2 using the v2beta API. The new API provides access to the full Postmaster Tools dataset, including compliance status data.

The v2beta API also includes enhancements such as the queryDomainStats method for flexible querying, and adds support for batch operations.

To learn how to use the API, see the Postmaster Tools API documentation.

Meet API

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

You can now identify and join a meeting space using the phoneAccess and gatewaySipAccess fields on the spaces resource.

For details, see How Meet identifies a meeting space.

Meet API

Generally Available: Calendar invitees can now receive google.workspace.meet.conference.v2.started and google.workspace.meet.transcript.v2.fileGenerated events.

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

For information on how to receive Google Meet events from Google Cloud Pub/Sub, see Respond to events from Google Meet.

(Developer Preview): You can now get comment and reply events in Google Drive. The following event types are supported:

• A user posts a comment in a Google Docs, Sheets, or Slides file.
• A user replies to a comment.

For details, see Subscribe to Google Drive events in the Google Workspace Events API documentation. For information on how to receive Google Drive events from Google Cloud Pub/Sub, see Work with events from Google Drive.

Developer Preview: Chat apps can find existing group conversations with specific members using FindGroupChats.

Generally available starting November 10, 2025:

Secondary calendars will now have a single data owner. This applies to both existing and newly created calendars. In the Calendar API, the data owner's email address will be in the read-only dataOwner field in the Calendars and CalendarList resources.

To prevent unintended actions and undesired states, the following new restrictions apply:

• Only the data owner can delete secondary calendars.
• The data owner's access level cannot be changed from the default owner access.
• The data owner cannot remove an owned calendar from their calendar list. They can hide it from their UI.

When a new secondary calendar is created, the authenticated user that makes the request is the data owner. We recommend that you use user authentication to create secondary calendars. Data ownership can be transferred in the Google Calendar UI.

For more details, see the documentation for Calendars and CalendarList closer to November 10.

Gemini Alpha: As part of the Gemini Alpha program, you can now build add-ons that extend Google Workspace Flows. For details, see Extend Google Workspace Flows.

Generally available: When sending private messages, Chat apps can now include interactive accessory widgets.

Generally available: We're enhancing membership roles in Chat spaces by introducing a new membership role type. In the Chat UI, existing space managers are now owners and a new manager role is added.

Previously, there were three membership role types in Chat API. MEMBERSHIP_ROLE_UNSPECIFIED, which meant a user wasn't a member but could be invited. ROLE_MEMBER, which meant a user was a member of the space. And ROLE_MANAGER, which meant a user was a space manager.

Now, in the Chat UI, ROLE_MANAGER users are called owners; this is a cosmetic change so permissions and the API enum remain the same. To help space owners administer spaces, we're introducing ROLE_ASSISTANT_MANAGER which is called manager in the UI. Possible membership roles include:

• MEMBERSHIP_ROLE_UNSPECIFIED: Default value. For users: they aren't a member of the space, but can be invited. For Google Groups: they're always assigned this role.
• ROLE_MEMBER: A member of the space. In the Chat UI, this role is called Member. Members have basic permissions, like reading messages in a space. Managers and Owners can grant them additional permissions, like adding or removing members, editing space details, and turning history on and off.
• ROLE_ASSISTANT_MANAGER: A space manager. In the Chat UI, this role is called Manager. By default, managers have permission to make other members managers, delete messages, and change space permissions.
• ROLE_MANAGER: A space owner. In the Chat UI, this role is called Owner. Owners have the broadest set of permissions, including permission to make other members owners or delete the space.

To learn more, see Update a user's membership in a Google Chat space and MembershipRole in the Chat API reference documentation.

Generally available: You can now format text with Markdown, including lists and code blocks, in your Chat apps.

Developer Preview: The following Chat API methods support app authentication with administrator approval when called with chat.app.* authorization scopes:

• Get a Chat space event.
• List Chat space events.

Additionally, Chat apps can now call the following methods in the Google Workspace Events API using app authentication with administrator approval with chat.app.* authorization scopes:

• Subscribe to Chat space events
• Update or renew a subscription
• Reactivate a subscription

Generally available: Increased per-space quota limits for writing messages and reactions with the Chat API:

• When importing data to Google Chat, the per-space quota limit for writing messages with spaces.messages.create increases from 60 to 600 per minute.
• When writing reactions with spaces.messages.reactions.create, the per-space quota limit increases from 60 to 300 per minute.

To learn more, see the Chat API's per-space quotas.

Generally available: You can now design your Chat app to include a carousel, which is a layout that rotates and displays a list of cards in a slideshow format, with buttons navigating to the previous or next carousel card. For details, see Carousel.

You can now use annotations to create Deal Cards in the Promotions tab. To get started, see the overview of Deal Cards.

Developer Preview: The following Chat API methods support app authentication with administrator approval:

• Get a message as a Chat app with administrator approval using chat.app.messages.readonly scope.
• List messages with a Chat app with administrator approval using chat.app.messages.readonly scope.

Generally available: You can now call the Chat API to create messages that quote other messages, or to update messages to remove quotes. To learn more, see Quote a message.

Generally Available: 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: Chat apps can now create (RPC, REST), update (RPC, REST), and get details about (RPC, REST) Chat space permission settings by calling the corresponding method in Chat API using app authentication with the https://www.googleapis.com/auth/chat.app.spaces or https://www.googleapis.com/auth/chat.app.spaces.create authentication scope, including creating announcement spaces.

You can now read the metadata for Meet, Huddle, and Calendar chips using message annotations. Use the RichLinkMetadata object to read information about the chip.

The Drive API has changed how download, print, and copy restrictions are applied.

Users with the role of owner or organizer can apply restrictions to other users with writer roles, in addition to reader roles. Users can directly apply restrictions on files using the itemDownloadRestriction field within the DownloadRestrictionsMetadata object. Determination of whether file restrictions can be changed is controlled by the new capabilities.canChangeItemDownloadRestriction field.

Similarly, users with the role of shared drive organizer can directly apply restrictions on shared drives using the downloadRestriction field within the Restrictions object. Determination of whether shared drive restrictions can be changed is also controlled by the capabilities.canChangeDownloadRestriction field.

While the previous field (copyRequiresWriterPermission) that controlled download, print, and copy restrictions is still available, the functionality is different for both reading from and writing to the field. We recommend that you use the new DownloadRestriction object to enforce how users can download, print, and copy files.

For more information about how download, print, and copy restrictions are now applied for My Drive and shared drive files, see:

• Protect file content
• Manage shared drives

Generally available: You can now build Google Chat apps as Google Workspace add-ons. For details, see Extend Google Chat.

Generally available: You can now build Google Chat apps as Google Workspace add-ons. For details, see Extend Google Chat.

(Developer Preview): You can now subscribe to events in Google Drive. The following event types are supported:

• A file is added to a folder or shared drive.
• A file is moved to a folder or shared drive.
• A file is edited or a new revision is uploaded.
• A file is trashed or removed from the trash.
• An access proposal is created or resolved on a file.

For details, see Subscribe to Google Drive events in the Google Workspace Events API documentation. For information on how to receive Google Drive events from Google Cloud Pub/Sub, see Work with events from Google Drive.

(Developer Preview): The Google Workspace Events API now supports subscriptions to Google Drive. The API supports the following types of events:

• A file is added to a folder or shared drive.
• A file is moved to a folder or shared drive.
• A file is edited or a new revision is uploaded.
• A file is trashed or removed from the trash.
• An access proposal is created or resolved on a file.

For details, see Subscribe to Google Drive events.

Generally Available: Google Workspace Marketplace has updated the app publishing process. For published apps, certain changes to your draft—such as adding new app integrations or modifying the app name or description—will now trigger a manual review before being published. You can now also cancel an app listing that has been submitted for review, which reverts the app to its draft state. To learn more, see Update your app listing with drafts.

Generally available: Create, update, and read Google Drive and People chips in Google Sheets API. To learn more, see Smart chips in the Sheets API documentation.

Developer Preview: Chat apps can now format text with markdown, including lists and code blocks.

Google Analytics 4 has replaced Universal Analytics, which means the Apps Script Advanced Service for Google Analytics Management API and Reporting API is deprecated. Use the Google Analytics Data API Advanced Service instead.

Developer Preview: Starting on June 16, 2025, the following default Apps Script function names for Google Chat app triggers will change:

• For Added to space triggers, the default function name will change from onAddToSpace to onAddedToSpace.
• For Removed from space triggers, the default function name will change from onRemoveFromSpace to onRemovedFromSpace.

If your Chat app responds to being added or removed from Chat spaces, you can address this breaking change and avoid any potential errors by doing one of the following:

• In your Apps Script project, update the name of your functions to onAddedToSpace and onRemovedFromSpace. If required, create another versioned deployment of your Apps Script project and save the new deployment ID in the Chat API Configuration page in the Google Cloud console.
• In the Google Cloud console, open the Chat API Configuration page and in the Triggers section, update the function name for the Added to space and Removed from space triggers so that they use the function name that you're currently using in your Apps Script project.

To learn how to update your Chat app configuration in the Google Cloud console, see Configure a Google Chat app.

The following app-specific fields on the space.message resource are now populated when the created and updated Google Chat events are sent:

• threadKey
• clientAssignedMessageId
• slashCommand
• MatchedUrl

See the space.message resource.

See the list of Google Chat event types.

For Google Workspace organizations that use hardware key encryption, the Gmail API supports using smart cards for client-side encryption (CSE). For details, see the reference documentation for CseIdentity and CseKeyPair resources.

For Google Workspace add-ons that extend Google Chat, the invoked_function field is no longer part of the Common event object. Use the parameters field to determine and handle user interactions.

If your application doesn't depend on the invoked_function field, no action is needed.

If your application used the invoked_function field, see to the documentation for an example that uses the parameters field to create interactive widgets.

Generally Available: Granular OAuth permissions are now supported for HTTP Google Workspace add-ons. The granular OAuth consent screen lets users specify which individual OAuth scopes they want to authorize.

Keep the following dates in mind when you're building or modifying add-ons:

• HTTP Google Workspace add-ons built after May 27, 2025 must support granular consent.
• Existing add-ons have until December 1, 2025 to add support for granular consent.
• After December 1, 2025, all HTTP Google Workspace add-ons must support granular consent.

For more information about how to add support for granular consent, refer to Build a Google Workspace add-on using HTTP endpoints.

Generally available: You can now call the Chat API to create, delete, and view custom emoji in organizations where creating custom emoji is enabled. You can now include or react with custom emoji in messages.

• Learn about including custom emoji in Chat messages
• Learn more about enabling custom emoji

Meet API

Generally Available: You can now programmatically configure the moderation settings and the permissions users receive when they join a meeting space. Additionally, you can also pre-configure auto-recording, auto-transcripts, and "take notes for me" in meeting spaces.

For more information, see Configure meeting spaces and members.

You can now create and modify tables, and take basic actions on tables using the Sheets API.

• Learn more about creating tables using the Sheets API
• Learn about the Table object in the Sheets API

For Google Workspace add-ons that extend Google Chat, event_time timestamps are serialized and match the serialization of legacy Google Chat apps. You can now use the same timestamp-handling logic in both legacy Chat apps, and in your Workspace add-ons that extend Google Chat.

Previously, timestamps were serialized in the following format:

"eventTime": {
 "seconds": 1.742601948E9
 "nanos": 7.01868E8
}

After this fix, timestamps are serialized in the following format that shows the date and time:

"eventTime": "2025-03-24T16:31:21.165203Z"

See the Event object in the Google Chat API.

Between approximately September 2024 and March 2025, for Google Sheets modifications made by time-based Apps Script triggers, a bug caused incorrect OAuth App IDs and App Names to be logged in the Google Admin console.

This logging issue did not impact the functionality of Apps Script or Google Sheets. A fix was deployed on March 27, 2025, preventing future incorrect logging. Historical logs will not be corrected.

To learn more about Apps Script and audit logs, see Monitor and control Apps Script use in your Google Workspace organization.

You can now use the Forms Service to publish forms, and to have granular control over who can respond to forms.

Learn about the setPublished method to publish forms.

Reports API: User Logs Events now have logs for additional challenge types, such as Passkey, Device Prompt, SAML and more.

Learn more about Login Audit Activity Events. You can get these events using the activities.list method.

The Google Workspace Events API v1beta endpoint will be decommissioned for Google Chat and Google Meet events on April 30, 2025. To subscribe to Chat or Meet events, use the generally available v1 endpoint.

The Google Workspace Events API v1beta endpoint will be decommissioned for Google Chat and Google Meet events on April 30, 2025. To subscribe to Chat or Meet events, use the generally available v1 endpoint.

The Google Workspace Events API v1beta endpoint will be decommissioned for Google Chat and Google Meet events on April 30, 2025. To subscribe to Chat or Meet events, use the generally available v1 endpoint.

Generally Available: You can now call the Chat API to get or update a user's notification settings for a Chat space. For details, see the following guides:

• Get a user's space notification settings
• Update a user's space notification settings

Generally available: Chat apps can respond to quick commands. To use quick commands, users select the command from the message reply area in a Chat space. To learn more, see Respond to Google Chat app commands.

Generally available: Chat apps can respond to quick commands. To use quick commands, users select the command from the message reply area in a Chat space. To learn more, see Respond to Google Chat app commands.

Google Chat API now supports mentioning users who haven't joined a Chat space or are members of a space that is in import mode when sending a message with user authentication. To learn how, see Mention users in a text message.

Meet Media API

Developer Preview: The Google Meet Media API is now available as part of the Developer Preview Program. The Meet Media API lets you access real-time media from Google Meet conferences.

As of February 20, 2025, the Rhino runtime is deprecated. Scripts running on Rhino will continue to function until January 31, 2026, after which they will no longer execute. Please migrate your scripts to the V8 runtime before this date. Refer to Migrate scripts to the V8 runtime.

Generally Available: The Google Drive API now supports folders with limited access which allow you to restrict folders to specific users. Folders with limited access broadens the expansive access model from shared drives to My Drive.

To limit access to a folder, developers can set the boolean inheritedPermissionsDisabled field on the files resource to true. Developers can also opt in to expansive access API behavior in My Drive ahead of any future mandatory enforcement by setting the enforceExpansiveAccess request parameter to true on the permissions.delete() and permissions.update() methods.

To learn more, see Manage folders with limited and expansive access.

Generally available: When a user deletes a message sent by a Chat app, the DeletionType of the Chat API Message resource is set to SPACE_MEMBER. Previously, the DeletionType was set to CREATOR.

Reports API: Google Chat now supports the customerUsageReports.get() and userUsageReports.get() methods. Forty eight new metrics have been added to customerUsageReports and four new metrics have been added to userUsageReports.

Reports API: A new event type conversation_read has been added to Google Chat along with four new event parameters to activities.list, and activities.watch:

• conversation_ownership
• conversation_type
• message_type
• attachment_status

The full list of events and parameters supported in Chat audit activities can be found on the Chat Audit Activity Events page.

Meet API

Developer Preview: You can now pre-configure auto-recording, auto-transcripts, and "take notes for me" within a meeting space. For details, see Manage auto artifacts.

Generally Available: You can now use a new non-sensitive scope (https://www.googleapis.com/auth/meetings.space.settings) to set up auto-artifacts for meetings created by other apps including Google Calendar. For details, see OAuth scopes for settings.

Meet API

Generally Available: All meeting participants can now query for certain conference data including the conference records, the conference artifacts, and the participant records.

Meet Add-ons SDK

Early Access Preview: Meet add-ons on Android now contains a new meeting status, MEETING_WITH_START_COACTIVITY_PERMISSION_DISABLED, which lets you set a status when the user doesn't have permission to start a co-activity session during a meeting.

Generally Available: Granular OAuth permissions are now supported for users executing scripts in the Apps Script IDE. The granular OAuth consent screen lets users specify which individual OAuth scopes they would like to authorize. The granular consent screen will gradually launch to the remaining Apps Script surfaces, such as add-ons and trigger executions, in the future.

For more information, refer to the Workspace Updates blog post: Granular OAuth consent in Google Apps Script IDE executions.

Generally Available: To complement the release of the granular consent flow in Apps Script IDE executions, the following methods have been added to the ScriptApp and AuthorizationInfo classes to let Apps Script developers programmatically interact with the scopes granted for a script.

ScriptApp class:

• requireScopes(authMode, oAuthScopes)
• requireAllScopes(authMode)
• getAuthorizationInfo(authMode, oAuthScopes)

AuthorizationInfo class:

• getAuthorizedScopes()

For more information, refer to Handle granular OAuth permissions.

When building Google Workspace Add-on user interfaces, the following functionality is now available:

• TextInput Format Validation.
• Required inputs submission validation for TextInput, DateTimePicker, dropdown selector, and multiselect widgets. To learn more, see addRequiredWifget and setAllWidgetsAreRequired.

Developer Preview: Quick commands are a new way for users to invoke and interact with a Chat app directly without typing a slash command. For details, see Respond to quick commands as a Google Chat app.

Developer Preview: To respond to slash commands, Chat apps must now use the AppCommandPayload instead of a MessagePayload. To learn more, see Respond to slash commands.

Developer Preview: Quick commands are a new way for users to invoke and interact with a Chat app directly without typing a slash command. For details, see Respond to quick commands in Google Chat.

Developer Preview: You can now design your Chat app to include a carousel, which is a layout that rotates and displays a list of cards in a slideshow format, with buttons navigating to the previous or next carousel card. For details, see Carousel.

Developer Preview: Chat apps can now create (RPC, REST), update (RPC, REST), and get details about (RPC, REST) Chat space permission settings by calling the corresponding method in Chat API using app authentication with the https://www.googleapis.com/auth/chat.app.spaces or https://www.googleapis.com/auth/chat.app.spaces.create authentication scope, including creating announcement spaces.

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

Developer Preview: You can now use the following widgets when building user interfaces for Add-ons:

• Chip
• Overflow menu
• Material buttons
• Collapsible text paragraph
• Customizable control button of a collapsible section

The getUrl() method for the CellImage, CellImageBuilder, and OverGridImage classes of the Spreadsheet service has been deprecated. An image's source URL isn't available regardless of how the image is inserted into a spreadsheet.

Generally available: The getSheetById() method has been added to the Spreadsheet class of the Spreadsheet service. This lets you get a sheet in a spreadsheet using its unique ID.

Generally available: You can now get and set the transparency of a calendar event, meaning whether the event shows as "Busy" or "Available" in Google Calendar. For more information, refer to the following documentation:

• Enum EventTransparency
• Class CalendarEvent
• Class CalendarEventSeries

Developer Preview: You can now build Google Chat apps as Google Workspace Add-ons. For details, see Extend Google Chat.

Developer Preview: You can now build Google Chat apps as Google Workspace Add-ons. For details, see Extend Google Chat.

Developer Preview: You can now build Google Chat apps as Google Workspace Add-ons. For details, see Extend Google Chat.

Chat apps now have 90 days to complete the import of data. Previously, Chat apps had 30 days. To learn more, see Import data to Google Chat.

The Calendar service now has a getEventType() method that lets developers differentiate regular events from other types of events like out-of-office and working location events. For more information, see the following documentation:

• getEventType() for events
• getEventType() for event series
• EventType enum

You can now access birthday and other special events that are automatically created from Google Contacts using the Calendar API.

Birthday events now have birthdayProperties that show birthday-specific event data, such as the type of the special event, whether it's a birthday, an anniversary, or another significant date, and the contact that the event is linked to. You can use the contact as a resource name in the People API to fetch contact details.

To learn more, see the developer guide for the birthday event type.

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: Google Sheets now supports smart chips for link previews to third-party resources. To learn more, see Preview links with smart chips.

Meet Add-ons SDK

Generally Available: You can now retrieve the meetingCode property of an ongoing meeting. This is applicable in version 1.1.0.

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

Apps Script has rescheduled the shutdown date of the Contacts service to January 31, 2025. Refer to the Apps Script sunset schedule.

The Apps Script Contacts service was deprecated in December 2022. Instead, use the People API advanced service. Refer to Migrate from Contacts service to People API advanced service.

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) - For event subscriptions, you can now use the eventTypes field in the updateMask parameter of the subscriptions.patch method to change the event types to receive for the target resource.

The Google Drive API returns a long-running operation (LRO) every time you call the files.download method to download blob file content or export Google Workspace document content either through the Drive API or its client libraries.

The files.download method returns an Operation resource to the client. You can use the Operation interface to asynchronously retrieve the status of the API method by polling the operation through the GetOperationRequest method.

The files.download method is the only way to download Google Vids files in MP4 format and is typically best suited to downloading most video files.

To learn more, see Manage long-running operations.

Generally Available: Google Workspace Marketplace supports draft app listings. With a draft listing, you can make changes to your app listing and then preview and test the changes before publishing them. While your draft changes are in testing, the original app listing remains available on the Google Workspace Marketplace. To learn more, see Update your app listing with drafts.

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.

Meet Add-ons SDK

Generally Available: The Google Meet Add-ons SDK is now generally available.

The Meet Add-ons SDK lets you embed your app into Google Meet as a Google Workspace Add-on where users can discover, share, and collaborate, plus sync content state across devices, without leaving Meet.

For more information, see the guides and reference documentation.

Generally available: You can now use Looker in Connected Sheets from Apps Script. This update lets you create a new or access existing Looker data source connections, connect a sheet to them, create pivot tables, and more.

The following updates have been made to the Spreadsheet service to support Looker in Connected Sheets from Apps Script.

• The following new data source type has been added:
  • LOOKER
• The following new classes have been added:
  • LookerDataSourceSpec
  • LookerDataSourceSpecBuilder
• The following new methods have been added to existing classes:
  • DataSourceSpec.asLooker()
  • DataSourceSpecBuilder.asLooker()

Generally Available: You can now call Chat API using Cloud Client Libraries in addition to the already available Google API Client Libraries.

Benefits of Cloud Client Libraries include:

• Idiomatic code that follows your preferred language's natural conventions and styles.
• Consistent style across client libraries.
• Handling the low-level details of server communication, including authentication, pagination, long-running operations, streams, and retries.
• Installable using package management tools like npm and pip.
• Improved performance in some cases, thanks to gRPC.

Additionally, our Chat API reference documentation now features a RPC reference arranged by services and their methods in addition to our existing REST reference arranged by resource hierarchies and their methods.

To learn more, see Install client libraries.

Generally Available: You can now create and organize tabs in Google Docs documents using Apps Script's Document service. For more information, refer to Work with tabs.

Meet Add-ons SDK

Developer Preview: Add-ons can now programmatically end a collaboration by calling the endCollaboration method for the MeetMainStageClient or the MeetSidePanelClient. This is applicable in version 0.9.0 or later.

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.

Google Workspace administrators can now turn on an allowlist in the admin console to control which external domains users can access through Apps Script's URL Fetch service.

• If you're using a script or add-on that accesses external domains, work with your administrator to add those URLs to the admin allowlist.
• If you've published an add-on on the Google Workspace Marketplace, it might be helpful to list the URLs that admins should add to their allowlist on your Marketplace listing.

For more information, refer to the Google Workspace Admin Help article: Allow only certain external connections for Apps Script and Sheets.

Google Workspace administrators can now turn on an allowlist in the admin console to control which external domains users can access through Apps Script's URL Fetch service.

• If you're using a script or add-on that accesses external domains, work with your administrator to add those URLs to the admin allowlist.
• If you've published an add-on on the Google Workspace Marketplace, it might be helpful to list the URLs that admins should add to their allowlist on your Marketplace listing.

For more information, refer to the Google Workspace Admin Help article: Allow only certain external connections for Apps Script and Sheets.

Generally available starting September 17, 2024: Create and manage birthdays directly within Google Calendar. Birthdays are exposed in the Calendar API as a new eventType called "birthday" which distinguishes special all-day events with an annual recurrence. Birthday events support a limited set of event properties.

You can filter by the birthday event type using the events.list() and events.watch() methods. If no type filters are specified, all event types including birthdays are returned.

To learn more, see our developer guide about working with the birthday event type.

(Generally Available): Multiselect menus are now generally available for Add-ons.

For more information refer to the following:

• SelectionInput for Apps Script
• SelectionInput for HTTP runtimes

(Generally Available): Columns are now generally available for Add-ons.

For more information refer to the following:

• Columns for Apps Script
• Columns for HTTP runtimes

(Generally Available): Multiselect menus are now generally available for Add-ons.

For more information refer to the following:

• SelectionInput for Apps Script
• SelectionInput for HTTP runtimes

(Generally Available): Columns are now generally available for Add-ons.

For more information refer to the following:

• Columns for Apps Script
• Columns for HTTP runtimes

Generally Available: You can now get, edit, and delete tasks assigned from Google Docs documents or Chat spaces using the Tasks API. For more information, refer to the tasks reference documentation.

The Google Drive API now supports the drive.meet.readonly scope. This restricted scope lets you view Drive files created or edited by Google Meet.

For details, see Choose Google Drive API scopes.

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.

Developer Preview: Google Workspace Marketplace now supports draft app listings. With a draft listing, you can make changes to your app listing and then preview and test the changes before publishing them. While your draft changes are in testing, the original app listing remains available on the Google Workspace Marketplace. To learn more, see Update your app listing with drafts.

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

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.

Meet API

Developer Preview: The Meet API now lets you pre-configure a meeting space and manage the members who join a meeting.

For more information, see Configure meeting spaces and members.

Meet Add-ons SDK

Early Access Preview: For Meet add-ons on Android, you can now view and reference specific error codes from add-on exception errors.

Meet Add-ons SDK

Developer Preview: Google Meet Add-ons SDK supports two usability improvements that aren't backwards compatible and require developer action.

1. The introduction of an add-on loading screen. Make sure to call createAddonSession on both the main stage and side panel once your add-on has finished loading. This signals Meet to dismiss the loading screen.

2. The removal of the startActivity button in the Meet side panel. Instead, the add-on now starts the activity through a call to startCollaboration. Make sure to call startCollaboration in your add-on once the user has completed content selection and is ready to start the collaboration.

Meet Add-ons SDK

• Added the connection exception addonexception.ADDON_NOT_INSTALLED. To fix this error, display a message to the user that they must install the add-on and provide a link to the Google Workspace Marketplace page containing the add-on.

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

The following changes to events from Gmail take effect on May 30, 2024:

• Events from Gmail use fromGmail instead default as the value for the eventType field. You can filter by this new event type using the events.list() and events.watch() methods.
• Events from Gmail use the email address of the email recipient as the event organizer instead of unknownorganizer@calendar.google.com.
• You can only update the event properties, such as reminders, color ID, visibility, status, and extended properties of Event resources with the event type fromGmail.

For details, see the Calendar API Events reference documentation.

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

The following change takes effect on June 3, 2024:

For batch operations on Event resources, a batched item returns an HTTP 409 Conflict status code if the batch operation can't successfully execute this item due to conflicts with other requested batched items.

Suggested action: Exclude all successfully finished and failed batched items and retry remaining items in a different batch operation or by using single event operations.

For more information, see Handle API errors.

Live Sharing SDK

• Added the withCoWatching and withCoDoing methods to allow both first party and third party apps to include the initial state of the add-on session.

• Added a new AddonException of OPERATION_UNSUPPORTED. The exception occurs when requesting an unsupported operation on Meet.

To subscribe to events using Apps Script, you can now use the Advanced Google Workspace Events service. For details, see the Apps Script reference documentation.

To subscribe to events using Apps Script, you can now use the Advanced Google Workspace Events service. For details, see the Apps Script reference documentation.

The cancelDataRefresh() method has been added to the following classes of the Spreadsheet service:

• DataSourceChart
• DataSourceFormula
• DataSourcePivotTable
• DataSourceSheet
• DataSourceTable

The cancelDataRefresh() method cancels the data refresh associated with the object it's called on if the refresh is currently running.

The cancelAllLinkedDataSourceObjectRefreshes() method has been added to the DataSource class. This method cancels all currently running refreshes of data source objects linked to the data source this method is called on.

(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): 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 get, list, and subscribe to events. To receive events, you can do the following:

• Use the get() and list() methods on the spaces.spaceEvents resource of the Google Chat API.
• Create subscriptions to events about users and spaces using Google Workspace Events API.

To learn more, see Work with events from Google Chat.

Events about deleted messages are now supported (Event type: google.workspace.chat.message.v1.deleted).

(Generally available): Subscriptions to Google Chat spaces and users are now generally available. To learn more, see Subscribe to Google Chat events.

Events about deleted messages are now supported (Event type: google.workspace.chat.message.v1.deleted).

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

The default property for the TextButtonStyle enum in the Apps Script Card Service has been renamed from TEXT to OUTLINED to align with the Google Material 3 design system. Existing scripts that use the original default, TEXT, render the same as the new default, OUTLINED.

The default property for the TextButtonStyle enum in the Apps Script Card Service has been renamed from TEXT to OUTLINED to align with the Google Material 3 design system. Existing scripts that use the original default, TEXT, render the same as the new default, OUTLINED.

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

(Generally Available): You can now delete multiple unused versions at the same time from the Project History page. Refer to Delete multiple versions.

(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 LinkPreview class has been added to the Apps Script Card service. This class lets you control various aspects of link previews, including the smart chip title, the link preview title, and the link preview card.

(Generally Available): The LinkPreview class has been added to the Apps Script Card service. This class lets you control various aspects of link previews, including the smart chip title, the link preview title, and the link preview card.

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

The 200 version limit, first announced for new scripts on December 6, 2023, has been extended to all script projects. If your existing script project already has more than 200 versions, after June 1, 2024 you won't be able to add a new version. To delete unused versions, refer to Delete a version.

(Developer Preview): Multiselect menus are now in Developer Preview for Add-ons.

For more information refer to the following:

• SelectionInput for Apps Script
• SelectionInput for other runtimes

(Developer Preview): Columns are now in Developer Preview for Add-ons.

For more information refer to the following:

• Columns for Apps Script
• Columns for other runtimes

(Developer Preview): Multiselect menus are now in Developer Preview for Add-ons.

For more information refer to the following:

• SelectionInput for Apps Script
• SelectionInput for other runtimes

(Developer Preview): Columns are now in Developer Preview for Add-ons.

For more information refer to the following:

• Columns for Apps Script
• Columns for other runtimes

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

Meet API

Generally available: v2 of the Google Meet API is now generally available. For more information, see the v2 reference documentation.

Generally available: Google Meet events are now generally available using the Google Workspace Events API. To learn more, see Subscribe to Google Meet events.

(Generally available): The Google Workspace Events API is now generally available and supports subscriptions to Google Meet events. To learn more, see Subscribe to Google Meet events and the v1 reference documentation.

Meet Add-ons SDK

Developer Preview: The getCurrentMeetingRecordingStatus() method has been deprecated. There isn't a replacement method to get this data.

The following changes will take effect on March 11, 2024:

• The use of event type filters will be considered when reviewing quota increase requests. Before you request a quota increase, make sure you specify the event types you need as a parameter for your application.
• Both events.list and events.watch will use the same default event type filter.
• To help with error handling, improved error messages will be returned when unsupported operations are attempted on special event types, such as working location, out-of-office, and focus time events.

For more information, refer to the following:

• Manage focus time, out of office, and working location events
• Manage quotas

Generally available: The events.watch() method now supports the eventTypes field as a query parameter so that you can subscribe to changes about specific Calendar events, such as working location, out-of-office, or focus time events. For details, see the reference documentation.

Meet API

• Developer Preview: A change announced by email on December 21, 2023 to members of the developer preview program, specifying spaces/{spaceId} changed from the previous version, has now gone into effect. Requests using meeting space resource names with the old meeting space IDs are now rejected. Note that a meeting code can also be used as an alias when calling spaces.get, such as spaces/abc-mnop-xyz. When provided with a meeting code, spaces.get returns the canonical resource identifier for the meeting space.

Reports API: The event returned in the activities.watch method payload is now filtered to the event name set in the filter. Before this change, multiple events were returned in the payload even if the customer filtered to a specific event.

You can now get a list of the user's installed apps in v3, with information about each app's supported MIME types, file extensions, and other details.

The apps resource represents a user's list of installed apps and it supports the following methods:

• Get a specific installed app.

• List all the installed apps.

(Generally Available): Google Workspace Add-ons now support third-party resource creation from the @ menu in Google Docs. This feature is gradually rolling out over the next few weeks. To use this feature, see Create third-party resources from the @ menu.

Each user can have up to 500 million items that were created by that account, no matter where those items reside. Previously, users could create an unlimited number of items in Drive.

(Generally Available): Google Workspace Add-ons now support third-party resource creation from the @ menu in Google Docs. This feature is gradually rolling out over the next few weeks. To use this feature, see Create third-party resources from the @ menu.

(Developer Preview): The Google Workspace Events API supports the get() method on the Operations resource.

(Developer Preview): The Google Workspace Events API now sends lifecycle events when subscriptions expire. For details, see Subscription expired events.

(Generally available): Google Workspace Add-ons now support link previews in Google Sheets and Slides. To learn more, see Preview links with smart chips.

(Generally available): Google Workspace Add-ons now support link previews in Google Sheets and Slides. To learn more, see Preview links with smart chips.

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

(Developer Preview): The Google Workspace Events API now supports subscriptions to Google Chat users. Subscriptions to Chat users support the following event types:

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

For details, see Subscribe to Google Chat events.

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

Meet Add-ons SDK

• Google Chrome and other browsers have begun phasing out third-party cookies to better protect user privacy. Chrome has restricted third-party cookies for 1% of users from January 4th, 2024. For more details on how to prepare, provide feedback, and report potential site issues, refer to the following:
  • Prepare for third-party cookie restrictions
  • The next step toward phasing out third-party cookies in Chrome

Directory API

(Generally available): You can now change the device status of ChromeOS devices in batch. For more information, refer to Deprovisioning or disabling Chrome devices.

Directory API: The action method of the chromeosdevices resource is deprecated. Instead, use the batchChangeStatus method in the customer.devices.chromeos resource.

Meet API

• Developer Preview: Added the startTime and endTime fields to the conferenceRecords.recordings resource and conferenceRecords.transcripts resource.

We've published a comprehensive tutorial and code sample showing how to build a Chat app using generative AI and a database, Manage projects with Google Chat, Vertex AI, and Firestore.

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

(Generally available): The setPersistValues(persistValues) method has been added to the Action class of the Card service. This means that you can now indicate whether form values are determined by the client's values or the server's values after an action response updates a form's card.

(Generally Available): You can now call version 3 of the Google Drive API from Apps Script with the advanced Drive service. To learn more, see Advanced Drive service.

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

To fix a bug that prevented events of eventType != 'default' from importing, we updated the code sample in Populate a team vacation calendar, the popular Apps Script + Calendar API solution. Review the code change in GitHub.

To fix a bug that prevented events of eventType != 'default' from importing, we updated the code sample in Populate a team vacation calendar, the popular Apps Script + Calendar API solution. Review the code change in GitHub.

Meet Add-ons SDK

• Developer Preview: The Google Meet Add-ons SDK is now available as part of the Developer Preview Program. The Meet Add-ons SDK lets you embed your app into Google Meet as an add-on where users can discover, share, and collaborate in the app without leaving Meet.

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 delete versions in your Apps Script project from the project history page in the Apps Script IDE.

Script projects created after December 10, 2023 can have up to 200 versions. If your script reaches the versions limit, or you want to clean up your script project, delete undeployed versions that you no longer need.

To learn more, see Delete a version.

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

A user's My Drive can't contain more than 100 levels of nested folders. Previously, folders in My Drive could be at an unlimited depth.

(Generally available): Google Material Design 3 styles, including icons, are available for cards in Chat apps.

(Developer Preview): Google Workspace Add-ons now support third-party resource creation from the @ menu in Google Docs. To use this feature, see Create third-party resources from the @ menu.

(Developer Preview): Google Workspace Add-ons now support third-party resource creation from the @ menu in Google Docs. To use this feature, see Create third-party resources from the @ menu.

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

Google Workspace Add-ons now support link previews in Google Sheets and Slides. To learn more, see Preview links with smart chips.

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

Google Workspace Add-ons now support link previews in Google Sheets and Slides. To learn more, see Preview links with smart chips.

(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

(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

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

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

Meet API

• Developer Preview: Google Meet API is now available as part of the Developer Preview Program. Meet API lets you create and manage meetings for Google Meet and offers entry points to your users directly from your app.

(Developer Preview): The Google Workspace Events API now supports subscriptions to Google Meet meeting spaces and users. The API supports the following types of events:

• A conference starts or ends.
• A participant joins or leaves a conference.
• A recording is generated.
• A transcript is generated.

To learn more, see Subscribe to Google Meet events.

(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): Subscriptions to Google Chat spaces now support the following event types:

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

Live Sharing SDK

• Added a RecordingInfo field to the AddonMeetingInfo resource that indicates if the current Google Meet call is being recorded.

• Added the verifyRecordingInfo method to the AddonSession.Builder resource to specify if the Meet Add-ons SDK should make sure that the add-on application has the correct recording status. If this method is called and there's a discrepancy between the add-on and Meet in regards to the recording status, then Meet severs the add-on connection and the session is terminated.

   addonClient.newSessionBuilder(appContext, new MyAddonSessionDelegate())
         .withParticipantMetadata(new MyMetadataDelegate(), initialMetadata)
         .withCoWatching(new MyCoWatchingHandler())
         .withCoDoing(new MyCoDoingHandler())
         .verifyRecordingInfo() // Newly added method
         .begin();
  

• Artifact released: com.google.android.meet:meet-addons:2.0.0-alpha04.

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

(Developer Preview): The Google Workspace Events API is now available to members of the Developer Preview Program. The API supports subscribing to Google Chat spaces for the following types of events:

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

To learn more, see the Google Workspace Events API overview.

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

The email address that sends notifications about errors in triggers has been updated from apps-scripts-notifications@google.com to noreply-apps-scripts-notifications@google.com.

The classic Google Sites service has been deprecated due to the transition from classic Sites to new Sites. There isn't a way to connect to new Sites with Apps Script.

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.

You can now view previously deployed script versions and compare them to the current script version in the Apps Script IDE. Anyone who has edit permission on an Apps Script project can access the project history page. To learn more, refer to the following:

• Google Workspace Updates blog: View & compare script versions with Apps Script project history

• Developer documentation: Versions

Generally available: Reading and updating working locations using the Google Calendar API is now generally available. For details, see Manage working locations for Google Calendar users.

The user interface (UI) of Google Workspace Add-ons has been upgraded to better reflect Material 3 guidelines (GM3). The updated interface is generally available on web for Gmail, Calendar, Drive, Docs, Sheets, and Slides. New and existing Google Workspace Add-ons automatically reflect the new interface.

Embed SDK Web

• You no longer have to add a domain to an allowlist. Any domain can embed Meet.
• You no longer have to provide an accessToken when building the MeetApp. Previously, the accessToken indicated user consent of having Google Meet in an embedded website. Meet now shows its own consent dialog to the user before they can join a meeting. Consent is cached for 24 hours.
• Anonymous users can now join a meeting and are only required to enter a name to represent them during the meeting. Previously, users had to be signed in to a Google Account.
• Documentation changes:
  • The "Configure OAuth consent" and "Set up authentication & authorization" pages were removed.
  • The Set up your Google Cloud project section was added.

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.

The Google Workspace Marketplace now offers independent security verification badges that appear in search results and on app listing pages. To receive the badge, your app must undergo an independent security assessment. To learn about the requirements for the badge, see the documentation.

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.

A new content restriction parameter that only the file owner can modify (ownerRestricted) was added.

In addition, three capabilities were added:

• capabilities.canModifyEditorContentRestriction
• capabilities.canModifyOwnerContentRestriction
• capabilities.canRemoveContentRestriction

For details, see Protect file content.

The capabilities.canModifyContentRestriction parameter was deprecated.

You can now specify no divider between card sections.

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.

Third-party smart chips and link previews are now generally available. To build a Google Workspace Add-on that uses this feature, see Preview links with smart chips.

Third-party smart chips and link previews are now generally available. To build a Google Workspace Add-on that uses this feature, see Preview links with smart chips.

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.

Live Sharing SDK

• Renamed SDK artifact and namespace:
  • Maven artifact changed to com.google.android.meet:meet-addons.
  • Java namespace changed to com.google.android.meet.addons.
• Removed deprecated queryMeeting() method. Use registerMeetingStatusListener() instead.
• Removed liveSharingApplicationName parameter from the session builder.
• The cloudProjectNumber parameter on AddonClientFactory#getClient is now required. This value is acquired by registering a Meet add-on.
• Artifact released: com.google.android.meet:meet-addons:2.0.0-alpha03.

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:

• Create a message
• Delete a message
• Get a message
• Update a message
• List messages
• Create a reaction
• Delete a reaction
• List reactions
• Create a membership
• Delete a membership
• Get a membership
• List memberships
• Create a space
• Delete a space
• Get a space
• Find a direct message
• List spaces
• Update a space
• Set up a space (create and populate)
• Download media
• Upload media

Live Sharing SDK

Added onParticipantPrivilegeChanged callback to AddonSessionHandler. Artifact released: com.google.android.livesharing:livesharing:2.0.0-alpha02.

Live Sharing SDK

Renamed the following symbols:

+   `LiveSharing*` → `Addon*`
+   `*Delegate` → `*Handler`
+   `CoWatchingSession` → `CoWatchingClient`
+   `CoDoingSession` → `CoDoingClient`

The Google Workspace Marketplace launches a new category called Intelligent Apps, where users can discover AI-powered productivity apps that let organizations work faster by automating their Google Workspace workflows. To learn more about Marketplace categories, see the documentation.

Live Sharing SDK

Alpha version of a new SDK major release. While the internals of this SDK are production-ready, the API surface of this alpha is subject to additional breaking changes—such as new features—before a final 2.0.0 release is published. The following changes are part of this release:

• Co-Doing:
  • CoDoingSession: Renamed broadcastStateUpdate() to setGlobalState().
  • CoDoingSessionDelegate:
    • Eliminated onCoDoingStateQuery(). If initial state must be set upon connecting to live sharing, call CoDoingSession#setGlobalState() explicitly instead.
    • Renamed onCoDoingStateChanged() to onGlobalStateChanged().
• Co-Watching:
  • CoWatchingSession: Removed previously-deprecated notifyPlayoutRate() overload.
  • CoWatchingSessionDelegate:
    • Renamed onCoWatchingStateQuery() to onStateQuery().
    • onStateQuery() now returns a QueriedCoWatchingState, which is a subset of CoWatchingState. Update the return type and either:
      • Continue building and returning a CoWatchingState...
      • Or, simplify the implementation by constructing a simpler QueriedCoWatchingState instance.
• LiveSharingClient:
  • Replaced the following methods with a builder pattern:
    • connectMeeting() / disconnectMeeting()
    • beginCoDoing() / endCoDoing()
    • beginCoWatching() / endCoWatching()
• Instead of calling connectMeeting() followed by beginCoDoing()(or co-watching), call newSessionBuilder().withCoDoing().begin().
• begin() returns a new LiveSharingSession instance:
  • To end the session, call endSession().
  • To set participant metadata after the session has started, call setParticipantMetadata().
  • To access the co-doing/co-watching session, call getCoDoing()/getCoWatching().
  • To access information about the current meeting, call getMeetingInfo().
• To set up participant metadata and register a delegate, call withParticipantMetadata() as part of the session builder chain.
• Added registerMeetingStatusListener()/unregisterMeetingStatusListener()and deprecated `queryMeeting().
• Artifacts released: com.google.android.livesharing:livesharing:2.0.0-alpha01.

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.

Live Sharing SDK

Added LiveSharingSessionDelegate to the API. Artifact released: com.google.android.livesharing:livesharing:1.2.0.

Live Sharing SDK

Marked MeetingDisconnectHandler as deprecated; developers should migrate to LiveSharingSessionDelegate instead.

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

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

Live Sharing SDK

• Added notifyLiveSharingFailureEvent method to API for failure reporting.
• Artifact released: com.google.android.livesharing:livesharing:1.1.0.

Live Sharing SDK

Fixed some issues.

Live Sharing SDK

Maximum size of co-doing state increased from 1650 bytes to 16 KB.

Apps Script has deprecated the Contacts service. Instead, use the People API advanced service. Refer to Migrate from Contacts service to People API advanced service.

The Contacts service shutdown has been rescheduled from April 2023 to January 2025. Refer to the Apps Script sunset schedule.

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

You can now build third-party smart chips for Google Workspace Add-ons. To use this feature, see Preview links with smart chips.

Apps Script added a new method to the Utilities class. parseDate(date, timeZone, format) parses a provided string date according to the specification described in the Java Standard Edition SimpleDateFormat class.

Apps Script has sunset the following methods:

• getChatThreads()
• getChatThreads(start, max)

There isn't a replacement method to get this data with Apps Script.

Learn about the switch from Classic Hangouts to Chat.

Live Sharing SDK:

• Updated external dependencies.
• Artifact released com.google.android.livesharing:livesharing:1.0.5.

Live Sharing SDK: Fixed potential issues in bundled Proguard configuration in previous release.

Live Sharing SDK:

• Improved bundled Proguard configuration.
• Updated MAX_CODOING_BLOB_BYTES to correctly represent the current maximum.
• Artifact released: com.google.android.livesharing:livesharing:1.0.4.

Live Sharing SDK:

• The SDK size was significantly reduced.
• Artifact released: com.google.android.livesharing:livesharing:1.0.3

Live Sharing SDK: Fixed some issues.

Apps Script has turned down the legacy integrated development environment (IDE) in favor of the redesigned IDE that launched in December 2020.

Learn more about the IDE updates from the following blog posts:

• Updated Apps Script integrated development environment will replace the legacy experience by Q4 2022.
• Additional functionality for the Apps Script Integrated Development Environment (IDE) Script Editor.
• Use the new Apps Script Integrated Development Environment (IDE) Script Editor.

Live Sharing SDK:

• Fixed some issues.
• Javadoc improvements.
• Artifact released: com.google.android.livesharing:livesharing:1.0.2.

Reseller API: The maximum queries per day (QPD) of 10,000 no longer applies.

Live Sharing SDK: Fixed some issues. Artifact released: com.google.android.livesharing:livesharing:1.0.1.

Live Sharing SDK: Fixed some issues. Artifact released: com.google.android.livesharing:livesharing:1.0.0.

Developer Preview: The Google Calendar API now supports reading and updating working locations. For details, see Manage working locations for Google Calendar users.

Live Sharing SDK: Fixed some issues. Artifact released com.google.android.livesharing:livesharing:1.0.0-eap08.

Live Sharing SDK:

• Executors passed to LiveSharingClientFactory#getClient are now respected by the SDK.
• Updated LiveSharingException:
  • MEET_VERSION_UNSUPPORTED: Consumers can now query LiveSharingExceptionMetadata#packageName()to redirect the user to install an appropriate app.
  • SDK_VERSION_UNSUPPORTED: New error code for phasing out old SDK versions if necessary in the future.
  • PARTICIPANT_INELIGIBLE: New error code indicating that the current user is not eligible to participate.
• The SDK no longer requires the full com.google.guava:guava target as a dependency; only com.google.guava:listenablefuture.

Live Sharing SDK:

• Added API for setting participant metadata. Note: This functionality is not yet present. This will occur in a future release.
• Artifact released: com.google.android.livesharing:livesharing:1.0.0-eap07

Live Sharing SDK: The com.google.android.apps.meetings.permission.MEET_LIVE_SHARING permission is obsolete and removed from the manifest.

Apps Script now automatically deletes default Google Cloud projects (Google Cloud projects that Apps Script creates in the background) when their associated scripts haven't run in 180 days or more. If the script runs after Apps Script deletes the default Google Cloud project, Apps Script creates one for the script.

This update doesn't affect standard Google Cloud projects (Google Cloud projects created by people).

Apps Script has deprecated the following methods:

• getChatThreads()
• getChatThreads(start, max)

These methods will become unavailable later this year once Google switches all users from Classic Hangouts to Google Chat. There isn't a replacement method to get this data with Apps Script.

Learn about the switch from Classic Hangouts to Chat.

Cards v1 is deprecated. Instead, use Cards v2.

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

You can now call functions in separate files before they're parsed. Previously, the V8 runtime required a script file to be parsed before any other file could call the functions it defines.

Now, the order of files in the Apps Script editor doesn't matter. This means that you can call a function in a different file to assign a value to a global variable—the function is always defined before it's called. This behavior reflects that of the legacy Rhino runtime.

Live Sharing SDK: Addressed some race conditions.

Live Sharing SDK:

• Surfaced LiveSharingMeetingInfo.Builder to API consumers for ease-of-testing.
• Added new overload of LiveSharingClientFactory#getClient, permitting API consumers to provide their own executor services. Consumers can begin using this API, but the SDK does not yet respect the provided executors. This will occur in a future release.
• Added error code mechanism to LiveSharingException, allowing common errors to be tagged with a canonical code. Currently supports one error code: MEET_VERSION_UNSUPPORTED.
• Enabled #queryMeeting() feature.
• Artifact released com.google.android.livesharing:livesharing:1.0.0-eap05.

Live Sharing SDK: Removed internal handler creation for ongoing call detector. If LSA does not provide a handler, the registered receiver will run on the UI thread.

Live Sharing SDK: In-call banner does not have the correct string.

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.

Live Sharing SDK: Renames the following symbols on the API surface: