Google Workspace developer release notes

Generally Available: Updates to Gmail API usage quotas

A new tiering model with updates to API usage quotas will start to roll out. For more information, see Google Workspace standardized model for agent tools and APIs.

Generally Available: Quota units for drafts.get, messages.attachments.get, messages.get, messages.trash, threads.get, and threads.trash have changed.

Generally Available: Updates to Calendar API usage quotas

A new tiering model with updates to API usage quotas will start to roll out. For more information, see Google Workspace standardized model for agent tools and APIs.

Generally Available: Updates to Drive API usage quotas

A new tiering model with updates to API usage quotas will start to roll out. For more information, see Google Workspace standardized model for agent tools and APIs.

Generally Available: To help align resource usage in the Google Drive API, usage quotas will change to be measured in quota units instead of the number of requests. Additionally, Google Workspace users can now only egress 1 TB per day. For more information, see Google Drive API usage limits.

Developer Preview: The Model Context Protocol (MCP) server for Google Chat is now available in developer preview. MCP is an open protocol that enables seamless integration between AI applications and your Chat conversations. By configuring the Chat MCP server, you enable AI agents to securely list messages and take actions, such as sending messages in your spaces.

For example, you can ask your AI agent: "What's the latest update in the 'Project X' space?"

To get started with the Chat MCP server, see the following documentation:

• Set up the Chat MCP server
• Chat MCP tool reference

To find more available MCP servers, see Model Context Protocol (MCP) servers in Google Workspace.

Developer Preview: The Model Context Protocol (MCP) server for Gmail is now available in developer preview. MCP is an open protocol that enables seamless integration between AI applications and Gmail. By configuring the Gmail MCP server, you enable AI agents to securely read your emails and take actions, such as creating drafts and labeling messages.

For example, you can ask your AI agent: "What did Ariel say in her last email about our marketing plan?"

To get started with the Gmail MCP server, see the following documentation:

• Set up the Gmail MCP server
• Gmail MCP tool reference

To find more available MCP servers, see Model Context Protocol (MCP) servers in Google Workspace.

Developer Preview: The Model Context Protocol (MCP) server for Google Calendar is now available in developer preview. MCP is an open protocol that enables seamless integration between AI applications and your calendars. By configuring the Calendar MCP server, you enable AI agents to securely read your schedule and take actions, such as creating, updating, or deleting events.

For example, you can ask your AI agent: "When is my next meeting with Ariel?"

To get started with the Calendar MCP server, see the following documentation:

• Set up the Calendar MCP server
• Calendar MCP tool reference

To find more available MCP servers, see Model Context Protocol (MCP) servers in Google Workspace.

Developer Preview: The Model Context Protocol (MCP) server for Google Drive is now available in developer preview. MCP is an open protocol that enables seamless integration between AI applications and your Drive files. By configuring the Drive MCP server, you enable AI agents to securely search your files and take actions, such as reading content or creating files.

For example, you can ask your AI agent: "Summarize the file 'Marketing Plan'."

To get started with the Drive MCP server, see the following documentation:

• Set up the Drive MCP server
• Drive MCP tool reference

To find more available MCP servers, see Model Context Protocol (MCP) servers in Google Workspace.

Generally Available: The Google Drive API now lets you start and manage approvals on Drive files through the approvals resource. The following API methods have been added:

• approvals.start
• approvals.approve
• approvals.decline
• approvals.reassign
• approvals.cancel
• approvals.comment

You can still retrieve and list the status of your approvals using either the approvals.get or the approvals.list method.

For details, see Manage approvals.

Meet API

Generally Available: The phoneAccess and gatewaySipAccess fields on the spaces resource can now be used to identify and join a meeting space.

For details, see How Meet identifies a meeting space.

Generally Available: Chat apps can find existing group conversations with specific members using the FindGroupChats method. For more information, see Find a group chat.

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