Google Workspace developer release notes

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

July 25, 2025

Chat API
v1

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

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.

July 22, 2025

Chat API
v1

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.

July 16, 2025

Google Drive API
v3

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:

July 09, 2025

Chat API
v1

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

Google Workspace add-ons

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

July 07, 2025

Google Drive API
v3

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

Google Workspace Events API
v1beta

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

Google Workspace Marketplace API
v1

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.

July 01, 2025

Google Workspace Admin SDK

Reports API: You can now retrieve activity events for Gemini in Workspace Apps. These events provide insights into how users in your organization are using Gemini. To retrieve these events, use the activities.list method with applicationName=gemini_in_workspace_apps. For details, see the reference documentation.

June 17, 2025

Google Sheets API
v4

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.

June 10, 2025

Chat API
v1

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

June 04, 2025

Google Apps Script

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.

Google Workspace add-ons

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.

June 02, 2025

Google Workspace Events API
v1

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.

May 20, 2025

Gmail API
v1

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.

May 12, 2025

Google Workspace add-ons

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.

May 05, 2025

Google Workspace add-ons

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.

April 30, 2025

Chat API
v1

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.

April 29, 2025

Google Meet

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.

Google Sheets API
v4

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

Google Workspace add-ons

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.

April 23, 2025

Google Apps Script

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.

April 08, 2025

Google Apps Script

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.

Google Forms API
v1

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

March 17, 2025

Google Workspace Admin SDK

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.

March 13, 2025

Chat API
v1

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.

Google Meet

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.

Google Workspace Events API
v1beta

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.

March 07, 2025

Chat API
v1

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:

March 05, 2025

Chat API
v1

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 Workspace add-ons

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.

March 03, 2025

Chat API
v1

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.

February 24, 2025

Google Meet

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.

February 20, 2025

Google Apps Script

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.

February 19, 2025

Google Drive API
v3

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.

February 18, 2025

Chat API
v1

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.

February 14, 2025

Google Workspace Admin SDK

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.

February 07, 2025

Google Meet

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.

January 30, 2025

Google Meet

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.

January 08, 2025

Google Apps Script

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:

AuthorizationInfo class:

For more information, refer to Handle granular OAuth permissions.

December 27, 2024

Google Workspace add-ons

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

December 18, 2024

Chat API
v1

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.

Google Workspace add-ons

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.

December 16, 2024

Chat API
v1

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.

December 13, 2024

Google Workspace add-ons

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

December 09, 2024

Google Apps Script

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:

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.

December 05, 2024

Chat API
v1

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

Google Workspace Marketplace API
v1

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

Google Workspace add-ons

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

December 03, 2024

Chat API
v1

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.

November 27, 2024

Google Apps Script

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:

November 19, 2024

Google Calendar API
v3

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.

November 05, 2024

Chat API
v1

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.

November 04, 2024

Chat API
v1

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

October 30, 2024

Chat API
v1

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.

October 24, 2024

Chat API
v1

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

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

October 10, 2024

Chat API
v1

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

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

October 08, 2024

Google Workspace add-ons

Generally Available: Google Sheets now supports smart chips for link previews to third-party resources. To learn more, see Preview links with smart chips.

October 07, 2024

Google Meet

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.

October 02, 2024

Chat API
v1

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:

Google Apps Script

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.

September 30, 2024

Chat API
v1

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

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

September 17, 2024

Google Workspace Events API
v1

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

September 13, 2024

Google Drive API
v3

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.

September 12, 2024

Google Workspace Marketplace API
v1

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.

September 11, 2024

Chat API
v1

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:

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.

September 10, 2024

Chat API
v1

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.

September 09, 2024

Google Meet

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.

September 03, 2024

Google Apps Script

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.

August 16, 2024

Chat API
v1

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.

August 15, 2024

Google Apps Script

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.

August 08, 2024

Google Meet

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.

August 07, 2024

Chat API
v1

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

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

Google Apps Script

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 add-ons

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.

August 05, 2024

Google Calendar API
v3

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.

July 25, 2024

Google Apps Script

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

For more information refer to the following:

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

For more information refer to the following:

Google Workspace add-ons

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

For more information refer to the following:

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

For more information refer to the following:

July 23, 2024

Google Tasks API
v1

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.

July 11, 2024

Google Drive API
v3

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.

July 08, 2024

Chat API
v1

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.

July 03, 2024

Chat API
v1

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.

June 28, 2024

Chat API
v1

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

June 26, 2024

Chat API
v1

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

Google Workspace Marketplace API
v1

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.

June 25, 2024

Chat API
v1

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

June 24, 2024

Chat API
v1

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 Workspace Events API
v1

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.

June 18, 2024

Chat API
v1

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

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

June 13, 2024

Google Meet

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.

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

June 03, 2024

Google Meet

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.

May 29, 2024

Google Meet

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.

May 22, 2024

Chat API
v1

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

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

Google Calendar API
v3

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.

May 21, 2024

Chat API
v1

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

May 17, 2024

Google Calendar API
v3

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.

May 09, 2024

Google Meet

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.

May 02, 2024

Google Apps Script

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.

Google Workspace Events API
v1

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.

April 30, 2024

Google Apps Script

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

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.

April 25, 2024

Chat API
v1

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

April 24, 2024

Chat API
v1

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

April 23, 2024

Chat API
v1

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

April 22, 2024

Chat API
v1

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

Google Apps Script

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

April 18, 2024

Chat API
v1

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

April 08, 2024

Chat API
v1

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

March 28, 2024

Chat API
v1

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

Google Workspace Events API
v1

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

March 20, 2024

Chat API
v1

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

March 15, 2024

Google Apps Script

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.

Google Workspace add-ons

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.

March 13, 2024

Chat API
v1

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

March 07, 2024

Google Apps Script

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

March 05, 2024

Chat API
v1

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

Google Apps Script

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

Google Workspace add-ons

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

March 04, 2024

Chat API
v1

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

February 29, 2024

Google Apps Script

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.

February 21, 2024

Google Apps Script

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

For more information refer to the following:

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

For more information refer to the following:

Google Workspace add-ons

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

For more information refer to the following:

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

For more information refer to the following:

February 20, 2024

Chat API
v1

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

Google Apps Script

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

February 15, 2024

Google Meet

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.

Google Workspace Events API
v1

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

February 12, 2024

Google Meet

Meet Add-ons SDK:

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

February 07, 2024

Google Calendar API
v3

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:

February 06, 2024

Google Calendar API
v3

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.

Google Meet

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.

January 29, 2024

Google Workspace Admin SDK

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.

January 26, 2024

Google Drive API
v3

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.

January 24, 2024

Google Apps Script

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

Google Drive API
v3

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.

Google Workspace add-ons

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

January 22, 2024

Google Workspace Events API
v1beta

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

January 19, 2024

Google Workspace Events API
v1beta

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

January 18, 2024

Google Apps Script

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

Google Workspace add-ons

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

January 17, 2024

Chat API
v1

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

Google Workspace Events API
v1beta

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

January 10, 2024

Chat API
v1

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

January 08, 2024

Chat API
v1

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

January 05, 2024

Chat API
v1

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

January 04, 2024

Google Meet

Meet Add-ons SDK:

December 27, 2023

Google Workspace Admin SDK

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.

December 15, 2023

Google Meet

Meet API:

December 14, 2023

Chat API
v1

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.

December 13, 2023

Chat API
v1

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

Google Apps Script

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

December 11, 2023

Google Apps Script

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

December 08, 2023

Chat API
v1

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

December 07, 2023

Google Apps Script

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.

Google Calendar API
v3

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.

Google Meet

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.

December 06, 2023

Chat API
v1

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:

Google Apps Script

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

November 30, 2023

Chat API
v1

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

November 28, 2023

Chat API
v1

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

November 21, 2023

Google Drive API
v3

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.

November 15, 2023

Chat API
v1

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

Google Apps Script

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

Google Workspace add-ons

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

November 13, 2023

Google Apps Script

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

Google Workspace add-ons

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

November 06, 2023

Chat API
v1

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

Google Apps Script

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

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

November 03, 2023

Chat API
v1

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

Google Workspace Marketplace API
v1

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

November 02, 2023

Google Meet

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.
Google Workspace Events API
v1beta

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

October 30, 2023

Chat API
v1

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

Google Workspace Events API
v1beta

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

October 24, 2023

Chat API
v1

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

October 17, 2023

Chat API
v1

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

October 16, 2023

Google Meet

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.

October 03, 2023

Chat API
v1

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

Google Workspace Events API
v1beta

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

September 28, 2023

Chat API
v1

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

September 26, 2023

Google Apps Script

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.

September 19, 2023

Google Apps Script

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.

September 15, 2023

Chat API
v1

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

August 23, 2023

Google Apps Script

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:

August 17, 2023

Google Calendar API
v3

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.

August 15, 2023

Google Workspace add-ons

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.

August 11, 2023

Google Meet

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:

August 08, 2023

Chat API
v1

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

July 31, 2023

Google Workspace Marketplace API
v1

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.

July 28, 2023

Chat API
v1

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

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

July 24, 2023

Google Drive API
v3

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.

July 13, 2023

Chat API
v1

You can now specify no divider between card sections.

Google Workspace add-ons

You can now specify no divider between card sections.

July 10, 2023

Chat API
v1

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

June 12, 2023

Google Apps Script

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.

Google Workspace add-ons

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.

June 07, 2023

Chat API
v1

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.

Google Meet

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.

May 25, 2023

Chat API
v1

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:

May 23, 2023

Google Meet

Live Sharing SDK: Renamed the following symbols:

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

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

May 15, 2023

Google Workspace Marketplace API
v1

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.

March 23, 2023

Google Meet

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.

March 06, 2023

Chat API
v1

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.

February 22, 2023

Google Meet

Live Sharing SDK: Marked MeetingDisconnectHandler as deprecated; developers should migrate to LiveSharingSessionDelegate instead.

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

January 18, 2023

Chat API
v1

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

January 17, 2023

Chat API
v1

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

January 03, 2023

Google Meet

Live Sharing SDK: Maximum size of co-doing state increased from 1650 bytes to 16 KB.

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.

December 16, 2022

Google Apps Script

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.

December 07, 2022

Google Workspace add-ons

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.

November 03, 2022

Google Apps Script

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.

November 01, 2022

Google Apps Script

Apps Script has sunset the following methods:

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

Learn about the switch from Classic Hangouts to Chat.

October 27, 2022

Google Meet

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

Live Sharing SDK:

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

October 03, 2022

Google Meet

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.

September 28, 2022

Google Meet

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.

September 27, 2022

Google Apps Script

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:

Google Meet

Live Sharing SDK:

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

September 06, 2022

Google Workspace Admin SDK

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

August 29, 2022

Google Meet

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

August 24, 2022

Google Meet

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

August 22, 2022

Google Calendar API
v3

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

August 18, 2022

Google Meet

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

July 26, 2022

Google Meet

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

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:

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

July 19, 2022

Google Apps Script

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

July 08, 2022

Google Apps Script

Apps Script has deprecated the following methods:

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.

June 28, 2022

Chat API
v1

Cards v1 is deprecated. Instead, use Cards v2.

June 16, 2022

Chat API
v1

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

June 06, 2022

Google Apps Script

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.

May 25, 2022

Google Meet

Live Sharing SDK: Addressed some race conditions.

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

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:

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

May 15, 2022

Chat API
v1

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.

May 09, 2022

Google Meet

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

Before After
CoDoing CoDoingSession
CoWatching CoWatchingSession
CoDoingController CoDoingSessionDelegate
CoWatchingController CoWatchingSessionDelegate

Live Sharing SDK: Artifact released com.google.android.livesharing:livesharing:1.0.0-eap04

May 05, 2022

Google Meet

Live Sharing SDK:

  • Fixes ExceptionInInitializerError bug introduced in 1.0.0-eap02.
  • Fixes "playout rate set as zero" known issue.
  • Fixes "wait for connection to resolve" known issue.

Live Sharing SDK: Artifact released com.google.android.livesharing:livesharing:1.0.0-eap03

May 03, 2022

Google Meet

Live Sharing SDK: Addresses issue with io.grpc.util.SecretRoundRobinLoadBalancerProvider instantiation for some apps.

Live Sharing SDK: Enables logging for ERROR-level logs for better debugging with partners. This will be reverted at the end of the EAP program; any details revealed in these logs are covered by NDA.

Live Sharing SDK: Artifacts released com.google.android.livesharing:livesharing:1.0.0-eap02

April 14, 2022

Google Meet

Live Sharing SDK: Initial release. Artifact released: com.google.android.livesharing:livesharing:1.0.0-eap01

April 13, 2022

Google Apps Script

You can now perform the following actions in the new Apps Script integrated development environment (IDE):

March 24, 2022

Google Apps Script

For Google Workspace Add-ons, an Attachment class has been added to the Card Service that lets you add custom attachments to Calendar events. You can also set an event trigger that fires when the user clicks on the add-on attachment provider in the Calendar dropdown menu. For more information, refer to EventAttachmentTrigger.

March 23, 2022

Google Calendar API
v3

The Calendar API now supports custom attachments. See Calendar add-ons for more information.

March 18, 2022

Google Apps Script

The get methods for several color objects in the Spreadsheet Service have been deprecated in favor of a new naming convention. The functionality remains the same. For example, the getFontColor() method from the Range class has been replaced with getFontColorObject().

The following classes have updated get methods for color objects:

  • Banding:
    • getFirstColumnColor() is now getFirstColumnColorObject().
    • getFirstRowColor() is now getFirstRowColorObject().
    • getFooterColumnColor() is now getFooterColumnColor().
    • getFooterRowColor() is now getFooterRowColorObject().
    • getHeaderColumnColor() is now getHeaderColumnColorObject().
    • getHeaderRowColor() is now getHeaderRowColorObject().
    • getSecondColumnColor() is now getSecondColumnColorObject().
    • getSecondRowColor() is now getSecondRowColorObject().
  • BooleanCondition:
    • getBackground() is now getBackgroundObject().
    • getFontColor() is now getFontColorObject().
  • GradientCondition:
    • getMaxColor() is now getMaxColorObject.
    • getMidColor() is now getMidColorObject.
    • getMinColor() is now getMinColorObject.
  • Range:
    • getFontColor() is now getFontColorObject().
    • getFontColors() is now getFontColorObjects().
  • Sheet:
    • getTabColor() is now getTabColorObject.
  • Slicer:
    • getBackgroundColor() is now getBackgroundColorObject().

March 17, 2022

Google Forms API
v1

The Google Forms API is now generally available.

February 14, 2022

Google Apps Script

Owners receive email alerts when someone outside the owner's organization edits a script project in the new integrated development environment (IDE).

  • For container-bound scripts: If someone outside the container owner's organization creates or edits a container-bound script project, the container owner receives an email notification.

  • For standalone scripts: If someone outside the script project owner's organization edits a standalone script project, the script project owner receives an email notification.

January 19, 2022

Google Apps Script

The following classes have been added to the Spreadsheet Service to let you add images to cells:

  • CellImageBuilder: This builder creates the image value needed to add an image to a cell.
  • CellImage: Represents an image to add to a cell.

To add an image to a cell, you must create a new image value for the image using SpreadsheetApp.newCellImage() and CellImageBuilder. Then, use Range.setValue(value) or Range.setValues(values) to add the image value to the cell.

December 15, 2021

Google Apps Script

Versions 1.0 and 1.1 of the TLS security protocol are disabled. To establish JDBC connections, use TLS 1.2 or higher.

October 20, 2021

Google Calendar API
v3

The Calendar API now exposes a new eventType. The new type is called focusTime and allows users of the API to distinguish the special focus time events. For more information, see the API reference.

September 02, 2021

Google Keep API
v1

Announcement The Google Keep API is now available for enterprise administrators.

September 01, 2021

Google Apps Script

In the HTML Service iframe sandbox, allow-top-navigation, which allows the content to navigate its top-level browsing context, is restricted and not set as an attribute in the sandbox. Instead, the allow-top-navigation-by-user-activation attribute has been added to the sandbox.

If you need to redirect your script, add a link or a button for the user to take action on.

Learn more about HMTL Service restrictions.

August 31, 2021

Google Apps Script

The Drive Service has added three new methods to the file and folder classes to manage the use of resource keys when sharing files and folders.

  • getSecurityUpdateEligible(): Gets whether a file for folder is eligible to apply the security update that requires a resource key for access when it's shared using a link.
  • getSecurityUpdateEnabled(): Gets whether a file or folder requires a resource key for access when it's shared using a link.
  • setSecurityUpdateEnabled(enabled): Sets whether the file or folder requires a resource key for access when it's shared using a link.

Learn more about the resource key security update for Drive.

August 23, 2021

Google Apps Script

The Document Service has added support for smart chips by adding three new classes:

  • Date - An element representing a formatted date.
  • Person - An element representing a link to a person.
  • RichLink - An element representing a link to a Google resource, such as a Drive file or a YouTube video.

Learn more about smart chips in Google Docs.

August 09, 2021

Google Apps Script

The Microsoft SQL Server JDBC driver was updated to version 7.2.1. If you encounter issues, report them on the issue tracker. If you're an administrator and need live support, contact Google Workspace support.

August 02, 2021

Google Sheets API
v4

Google Sheets API v3 is turned down. For more information, see Migrate from Sheets API v3.

June 01, 2021

Google Apps Script

A new divider widget has been added for Google Workspace Add-ons. To add a divider to an add-on card, use the newDivider() method within the Card service.

May 27, 2021

Google Apps Script

A new method has been added to the Sheet class of the Spreadsheet service. setRowHeightsForced(startRow, numRows, height) lets you manually set the height for a row or a set of rows.

May 18, 2021

Google Calendar API
v3

Two new quotas now exist for the Calendar API in addition to the general Calendar usage limits:

  • Per minute per project.
  • Per minute per project per user.

See Manage quotas for more information.

March 15, 2021

Google Apps Script

The following updates have been made to deployments in the new editor:

  • You can now have more than one active deployment.
  • You can now change the version associated with an active deployment.

To learn more, see Create and manage deployments.

March 09, 2021

Google Workspace add-ons

The KeyValue class is deprecated. Instead, use the DecoratedText class.

February 08, 2021

Google Calendar API
v3

Starting today, all existing and new out of office events will be updated to set the organizer to unknownorganizer@calendar.google.com instead of the Calendar owner. It may take 2-3 weeks for this change to fully roll out.

You can use the calendarId from the API endpoint https://www.googleapis.com/calendar/v3/calendars/calendarId to identify the owner of the out of office event.

February 01, 2021

Google Calendar API
v3

The Calendar API now exposes a new field for events. The new field is called eventType and allows users of the API to distinguish special event types, such as outOfOffice. For more information, see the API reference.

January 11, 2021

Google Calendar API
v3

From now, we require conferenceData to be consistent with conferenceData.conferenceSolution.key.type; meaning only Google Meet calls can have conferenceData.conferenceSolution.key.type set to hangoutsMeet. All 3P video conference providers are expected to set conferenceData.conferenceSolution.key.type to addOn.

December 07, 2020

Google Apps Script

The Apps Script integrated development environment, or IDE, has been fully redesigned. Along with a completely new interface, the following features have been updated:

  • The editor now has a collapsible left sidebar to navigate to the Apps Script project overview, settings, executions, and triggers.
  • The editor's resources panel now includes files, advanced services, and libraries.
  • Autoformatting has been added to the editor.
  • Autocomplete in the editor has been enhanced to be faster, more consistent, and extends its support to user-defined functions and JavaScript language features. You can add JSDoc to your functions for better autocomplete suggestions.
  • The editor now supports codeblock and function collapsing.
  • Keyboard shortcuts and a Command Palette has been added to the editor. Press F1 to view the Command Palette and available keyboard shortcuts.
  • The editor now includes a contextual right-click menu with options such as Go To Symbol, Rename Symbols, and Command Palette.
  • Enhancements have been made to the debugger's performance and speed.
  • Logs now stream in real-time as you run a script.
  • The deployments dialog auto-detects the deployment types from the script project's manifest. You can change or add more types as needed.
  • Deployments have been merged with versions. Each time you create a new deployment, a new version is automatically created. clasp users are unaffected by this change.
  • A single deployment can be an add-on deployment , web app, library, or API executable. Any deployment can be used as a library.
  • Now only one deployment can be active at a time. This change doesn't affect existing active deployments. clasp users are unaffected by this change.
  • You can no longer explicitly deactivate published web apps. Instead, delete the deployment that has the web app. To reactivate the web app, deploy it again.
  • The debugger is no longer supported in the Rhino runtime. To use the debugger, migrate your script to the V8 runtime.
  • Testing Editor Add-ons is not yet supported in this release and will be added in 2021. To test Editor Add-ons, switch back to the legacy IDE.

To switch back to the legacy IDE from within the editor, at the top, click Use legacy editor.

October 23, 2020

Google Apps Script

An advanced service for Google Tables has been added to Apps Script. The Tables service allows scripts to programmatically read and edit rows within Tables.

September 07, 2020

Google Calendar API
v3

Meet video conferences should be added explicitly using the following existing parameters:

  1. Set conferenceDataVersion query parameter to 1.
  2. Set conferenceData.createRequest event property as follows:
    • conferenceData.createRequest.conferenceSolutionKey.type to hangoutsMeet.
    • conferenceData.createRequest.requestId to unique request id.

We stopped auto-populating Meet for API calls (such as Events.insert) to prevent Meet conferences being added unintentionally via 3rd parties.

September 03, 2020

Google Apps Script

New classes and methods have been added to support Connected Sheets.

The following new classes have been added to the Spreadsheet service:

  • DataSourceChart
  • DataSourceColumn
  • DataSourceFormula
  • DataSourcePivotTable
  • DataSourceRefreshSchedule
  • DataSourceRefreshScheduleFrequency
  • DataSourceSheet
  • DataSourceSheetFilter
  • DataSourceTableColumn
  • DataSourceTableFilter
  • DateTimeGroupingRule
  • PivotGroupLimit
  • SortSpec

New methods to support Connected Sheets have been added to the following classes in the Spreadsheet service:

  • BigQueryDataSourceSpecBuilder
  • BigQueryDataSourceSpec
  • DataExecutionStatus
  • DataSourceTable
  • DataSource
  • EmbeddedChart
  • FilterCriteriaBuilder
  • `PivotFilter
  • PivotGroup
  • PivotTable
  • PivotValue
  • Range
  • Sheet
  • SpreadsheetApp
  • Spreadsheet

August 27, 2020

Google Apps Script

A new class called DecoratedText has been added to the Card Service. DecoratedText adds text with optional decorations and was added to replace the KeyValue class.

July 27, 2020

Google Apps Script

To help simplify Google Drive's folder structure and sharing models, new methods have been added to the Drive service and some existing methods have been deprecated.

The DriveApp now has an enforceSingleParent(value) method that enables or disables enforceSingleParent behavior.

  • The File class now has the following methods:

    • file.getTargetId(): Gets a shortcut's file ID.
    • file.getTargetMimeType(): Returns the mime type of the item a shortcut points to.
    • file.moveTo(destination): Moves a file to a specified destination folder.

The Folder class now has the following methods:

  • folder.createShortcut(targetId): Creates a shortcut to the provided Drive item ID, and returns it.
  • folder.moveTo(destination): Moves an item to the provided destination folder.

The following Folder class methods have been deprecated:

  • addFile(File)
  • addFolder(Folder)
  • removeFile(File)
  • removeFolder(Folder)

June 12, 2020

Google Apps Script

New methods have been added to the Spreadsheet service:

  • The RichTextValue class now has a RichTextValue.getLinkUrl() method that gets the URL of the specified value.
  • The RichTextValueBuilder class now has a RichTextValueBuilder.setLinkUrl() method that sets the link URL for the specified value.
  • The PivotTable class now has a PivotTable.getSourceDataRange() method that returns the source data range on which the pivot table is constructed.
  • The PivotValue class now has a PivotValue.remove() method that removes the value from the pivot table.

June 01, 2020

Google Vault API
v1

All Team Drive-related fields are removed from the Vault API. Although these fields are marked as deprecated and will continue to be available until then, we strongly recommend that you update your apps and your API configuration to reference the new fields as soon as possible. If you do not migrate your apps by June 1, 2020, they might stop functioning.

If you have additional questions or need assistance, please visit our support page.

May 14, 2020

Google Workspace Admin SDK

Reports API: A new parameter member_type has been added to the Enterprise Groups activity report. Valid member types include user, group, service account, and other.

April 22, 2020

Google Apps Script

A new simple trigger, onSelectionChange(e), has been added for Google Sheets. The onSelectionChange(e) trigger runs automatically when a user changes the selection in a spreadsheet.

April 02, 2020

Google Apps Script

The following has been added to the Spreadsheet service:

The following has been added to the Drive service:

  • There's a new FILE_ORGANIZER value in the Permission enum. If you have FILE_ORGANIZER permission on a shared drive, you can edit, trash, and move content within that drive.

March 16, 2020

Google Calendar API
v3

Service accounts created on or after March 2, 2020 are only able to invite guests using domain-wide delegation of authority.

February 28, 2020

Google Apps Script

The following methods have been added to the Spreadsheet service to support the use of theme colors. Many of these methods duplicate the effect of existing color methods, but let you use Color objects instead of strings as parameters and return types:

February 05, 2020

Google Apps Script

Apps Script now supports the V8 runtime. This enables modern JavaScript features and syntax in Apps Script. You can migrate existing scripts to use V8 and its features.

January 21, 2020

Google Apps Script

To support the launch of G Suite Add-ons, the following manifest changes, service, classes, and methods have been added to Add-ons:

The Conference Data service has been added to Apps Script. The service helps G Suite Add-ons that extend Google Calendar to stay in sync with third-party conferencing applications. This service is only useful to developers who manage a conferencing application and want to make it available in Google Calendar.

January 14, 2020

Google Workspace add-ons

Google Workspace Add-ons have been launched. Google Workspace add-ons are the latest generation of add-ons, and build on the original Gmail add-ons infrastructure. Google Workspace add-ons provide a variety of new features, including:

With the launch of Google Workspace add-ons, Gmail add-ons have been deprecated. You can still use existing Gmail add-ons, but they are effectively just Google Workspace add-ons that only extend Gmail. If you have Gmail add-ons you've developed, you can upgrade them into Google Workspace add-ons to take advantage of the new features.

Note: Editor add-ons can't be upgraded into Google Workspace add-ons at this time. All editor add-ons remain functional.

December 18, 2019

Google Apps Script

December 11, 2019

Google Apps Script

November 12, 2019

Gmail API
v1

The messages.import method uses a more performant backend implementation. The new version is API-compatible with the previous implementation and all clients automatically started using the new behavior as of a few weeks ago. The new backend supports parallel message.import calls efficiently and clients can now import messages in parallel for a user to achieve higher migration throughput. The quota cost of the message.import method has been decreased to reflect the new performance.

Google Workspace add-ons

The Gmail add-on https://www.googleapis.com/auth/gmail.addons.execute scope is no longer required for Gmail add-ons. Apps Script and Gmail now ignore this scope if it is present in an add-on's manifest.

November 07, 2019

Google Workspace add-ons

All add-ons are now in the G Suite Marketplace.

To streamline the add-on discovery experience for users in the G Suite Marketplace, publication of both public and private add-ons to the Chrome Web Store is deprecated. Chrome extensions continue to be presented in the Chrome Web Store and aren't affected by this change.

November 06, 2019

Google Apps Script

The Spreadsheet service has been extended with the following class and new methods to support using slicers to filter ranges, charts, and pivot tables:

The Script service has been extended with the ScriptApp.getIdentityToken() method, which returns an identity token for the effective user.

October 28, 2019

Google Apps Script

You can no longer publish web apps to the Chrome Web Store. The Chrome Web Store deprecated Chrome apps in 2016 and they are now only available for ChromeOS devices. This change includes published Apps Script web apps. Previously published web apps are no longer discoverable in the Chrome Web Store. Editor Add-ons aren't affected; you can still publish Editor Add-ons to the Chrome Web Store.

October 23, 2019

Google Apps Script

The Slides service class RgbColor and the enumeration ColorType have been moved from the Slides service to the [Base script service](https://developers.google.com/apps-script/reference/base). The functionality of these classes has not changed. Moving these classes to the Base script service enables other services to make use of them in the future. You can now find the documentation for these classes at [RgbColor](https://developers.google.com/apps-script/reference/base/rgb-color) and [ColorType`](https://developers.google.com/apps-script/reference/base/color-type).

Several classes and methods relating to the now shutdown UiApp service have been removed. Most of these methods involved interactions between the Charts service and UiApp that were very seldom used. The following is a full list of the removed classes and methods:

  • Charts service
    • CategoryFilterBuilder
    • Control
    • DashboardPanel
    • DashboardPanelBuilder
    • Chart.getId()
    • Chart.getType()
    • Charts.newCategoryFilter()
    • Charts.newDashboardPanel()
    • Charts.newNumberRangeFilter()
    • Charts.newStringFilter()
    • NumberRangeFilterBuilder.build()
    • NumberRangeFilterBuilder.setDataTable(tableBuilder)
    • NumberRangeFilterBuilder.setDataTable(table)
    • NumberRangeFilterBuilder.setFilterColumnIndex(columnIndex)
    • NumberRangeFilterBuilder.setFilterColumnLabel(columnLabel)
    • NumberRangeFilterBuilder.setLabel(label)
    • NumberRangeFilterBuilder.setLabelSeparator(labelSeparator)
    • NumberRangeFilterBuilder.setLabelStacking(orientation)
    • StringFilterBuilder.build()
    • StringFilterBuilder.setDataTable(tableBuilder)
    • StringFilterBuilder.setDataTable(table)
    • StringFilterBuilder.setFilterColumnIndex(columnIndex)
    • StringFilterBuilder.setFilterColumnLabel(columnLabel)
    • StringFilterBuilder.setLabel(label)
    • StringFilterBuilder.setLabelSeparator(labelSeparator)
    • StringFilterBuilder.setLabelStacking(orientation)
  • Spreadsheet service
    • EmbeddedChart.getId()
    • EmbeddedChart.getType()
    • EmbeddedChart.setId(id)

September 27, 2019

Google Calendar API
v3

The Calendar API allows attaching a conference data of type addOn to a new or existing event using Events.insert or Events.update methods.

September 09, 2019

Google Apps Script

The Card service methods CardHeader.setUrl(url) and Image.setUrl(url) have been updated to accept an encoded image data string as an input parameter. As before, you can alternatively use a publicly-available image URL as the input parameter.

August 07, 2019

Google Apps Script

Documentation for the UI service has been removed. This service was deprecated in December 2014 and officially shut down on July 15, 2019. To build interfaces for web apps and Editor Add-ons, use the HTML service.

July 30, 2019

Google Workspace Admin SDK

Reports API: The customer usage reports for App Maker and Apps Script are deprecated and will eventually be removed from the API.

July 26, 2019

Google Apps Script

June 10, 2019

Google Vault API
v1

The "Team Drive" feature of Google Drive has been renamed to "shared drive". Consequently, the Vault API is changing as follows:

May 20, 2019

Google Apps Script

May 03, 2019

Google Apps Script

The Document service has been updated to add methods to get and set the language of a document:

April 19, 2019

Google Apps Script

The Data Studio service has been updated to add a few values to FieldType enum:

  • HYPERLINK
  • IMAGE
  • IMAGE_LINK

April 08, 2019

Google Apps Script

The behavior of the Google Cloud (GCP) projects used by scripts has been altered. Now, the default GCP projects that Apps Script creates for new scripts are hidden and script owners can't access them directly. Admins and domain users with the resourcemanager.projects.list permission on the parenting GCP folder can still access default GCP projects.

If you need access to a script's GCP project (because you wish to publish it or take a similar action), it's best to switch your script to use a standard GCP project.

April 05, 2019

Google Apps Script

March 16, 2019

Google Vault API
v1

Hangouts Chat and Google Meet together are the next generation of Hangouts. Later this year they will replace the original version (classic Hangouts) in Google Workspace.

Vault admins must take action to prepare for this migration. Learn More.

February 26, 2019

Google Apps Script

January 22, 2019

Google Apps Script

The deprecated UiApp service will be officially shutdown on July 15th, 2019. After this date, the service will no longer function for any script project.

January 04, 2019

Google Apps Script

December 13, 2018

Google Apps Script

The Fusion Tables advanced service has been deprecated and will shutdown fully on December 3rd, 2019.

November 19, 2018

Google Calendar API
v3

Starting on January 7, 2019, notifications and reminders using the sms method type will be ignored. The API calls setting such notifications and reminders will still succeed and modify all the other fields.

Since Calendar offers in-app notifications, you can still get notified, regardless of your device or connection. For more information see Google Calendar SMS notifications to be removed.

November 14, 2018

Google Apps Script

October 31, 2018

Google Calendar API
v3

The Calendar API now supports four new OAuth scopes. The scopes allow your application to limit access to only the data you really need. See Authorizing Google Calendar API Requests for more details.

October 30, 2018

Google Apps Script

October 22, 2018

Google Workspace Admin SDK

Reports API: The community_name parameter for the Google+ communities report is now available only for communities inside your organization.

October 18, 2018

Google Apps Script

October 05, 2018

Google Workspace Admin SDK

Alert Center API: V1beta1 is now available.

October 02, 2018

Google Calendar API
v3

A more flexible approach to sending event change notifications is now available through the sendUpdates parameter. The new parameter lets you set event change notifications to do one of the following:

  • Notify all the event guests.
  • Notify only the guests who are not using Google Calendar.
  • Completely suppress the notifications, for example, during a migration.

Now it is possible to always keep in sync guests who use other calendaring systems, without sending too many non-mandatory emails to Google Calendar users.

September 27, 2018

Google Apps Script

The Data Studio service is now available. You can use this service when building a Data Studio Community Connector.

August 20, 2018

Google Apps Script

August 01, 2018

Google Workspace Admin SDK

Reports API: The availability of past data for the Entities Usage Report has been changed to 30 days.

June 28, 2018

Google Tasks API
v1

The Google Tasks API is now generally available.

June 19, 2018

Google Apps Script

The quota limits for UrlFetch GET response size and POST size have been increased to 50MB / call.

The quota on total data received by UrlFetch per day per user has been removed.

June 04, 2018

Google Workspace Admin SDK

Reports API: Fixed an issue where some Entities Usage Parameters were under-reported for some Google+ communities. This has been corrected as of May 25, 2018.

April 23, 2018

Google Apps Script

April 11, 2018

Google Apps Script

Macros for Google Sheets are now becoming available for users, and will finish rolling out over then next few weeks. This feature lets you record macros in the Google Sheets UI and use Apps Script to create or edit them.

The Sheets service has been extended with a large number of new classes and methods. The addition of these methods make it possible to reproduce in code nearly any action a Sheets user can take at a keyboard. The new classes and methods include:

  • BandingTheme
  • Banding
  • BooleanCondition
  • BooleanCriteria
  • ConditionalFormatRuleBuilder
  • ConditionalFormatRule
  • Dimension
  • Direction
  • FilterCriteriaBuilder
  • FilterCriteria
  • Filter
  • GradientCondition
  • InterpolationType
  • PivotFilter
  • PivotGroup
  • PivotTableSummarizeFunction
  • PivotTable
  • PivotTableDisplayType
  • PivotValue
  • RangeList
  • RelativeDate
  • Selection
  • TextDirection
  • TextRotation
  • TextToColumnsDelimiter
  • WrapStrategy
  • EmbeddedChartBuilder.setHiddenDimensionStrategy(strategy) (also in each of the type-specific chart builder classes)
  • EmbeddedChartBuilder.setNumHeaders(headers) (also in each of the type-specific chart builder classes)
  • EmbeddedChartBuilder.setMergeStrategy(mergeStrategy) (also in each of the type-specific chart builder classes)
  • EmbeddedChartBuilder.setTransposeRowsAndColumns(transpose) (also in each of the type-specific chart builder classes)
  • Range.activateAsCurrentCell()
  • Range.applyColumnBanding()
  • Range.applyColumnBanding(bandingTheme)
  • Range.applyColumnBanding(bandingTheme, showHeader, showFooter)
  • Range.applyRowBanding()
  • Range.applyRowBanding(bandingTheme)
  • Range.applyRowBanding(bandingTheme, showHeader, showFooter)
  • Range.createFilter()
  • Range.createPivotTable(sourceData)
  • Range.deleteCells(shiftDimension)
  • Range.getBandings()
  • Range.getNextDataCell(direction)
  • Range.getTextDirection()
  • Range.getTextDirections()
  • Range.getTextRotation()
  • Range.getTextRotations()
  • Range.getWrapStrategies()
  • Range.getWrapStrategy()
  • Range.insertCells(shiftDimension)
  • Range.setShowHyperlink(showHyperlink)
  • Range.setTextDirection(direction)
  • Range.setTextDirections(directions)
  • Range.setTextRotation(degrees)
  • Range.setTextRotation(rotation)
  • Range.setTextRotations(rotations)
  • Range.setVerticalText(isVertical)
  • Range.setWrapStrategies(strategies)
  • Range.setWrapStrategy(strategy)
  • Range.setTextToColumns()
  • Range.setTextToColumns(delimiter)
  • Range.setTextToColumns(delimiter)
  • Sheet.autoResizeColumns(startColumns, numColumns)
  • Sheet.autoResizeRows(startRows, numRows)
  • Sheet.clearConditionalFormatRules()
  • Sheet.getActiveRangeList()
  • Sheet.getBandings()
  • Sheet.getConditionalFormatRules()
  • Sheet.getCurrentCell()
  • Sheet.getFilter()
  • Sheet.getPivotTables()
  • Sheet.getRangeList(a1Notations)
  • Sheet.getSelection()
  • Sheet.hasHiddenGridlines()
  • Sheet.isRightToLeft()
  • Sheet.setActiveRangeList(rangeList)
  • Sheet.setColumnWidths(startColumn numColumns, width)
  • Sheet.setConditionalFormatRules(rules)
  • Sheet.setCurrentCell(cell)
  • Sheet.setHiddenGridlines(hideGridlines)
  • Sheet.setRightToLeft(rightToLeft)
  • Sheet.setRowHeights(startRow, numRows, height)
  • Spreadsheet.getActiveRangeList()
  • Spreadsheet.getBandings()
  • Spreadsheet.getCurrentCell()
  • Spreadsheet.getRangeList(a1Notations)
  • Spreadsheet.getSelection()
  • Spreadsheet.setActiveRangeList(rangeList)
  • Spreadsheet.setCurrentCell(cell)

The Charts service has been extended to support EmbeddedCharts in Google Sheets with the enums ChartHiddenDimensionStrategy and ChartMergeStrategy. In addition, the following ChartTypes have been added:

  • TIMELINE
  • BUBBLE
  • CANDLESTICK
  • GAUGE
  • GEO
  • RADAR
  • ORG
  • SPARKLINE
  • STEPPED_AREA
  • TREEMAP
  • WATERFALL

March 26, 2018

Google Apps Script

March 22, 2018

Google Calendar API
v3

Support for the JSON-RPC protocol and Global HTTP batch endpoints has been deprecated, and will be fully discontinued on March 25, 2019. This change is being made to the Google API infrastructure and as such affects multiple Google APIs, including Calendar v3.

For more information and migration instructions, see the Discontinuing support for JSON-RPC and Global HTTP Batch Endpoints blog post.

February 26, 2018

Google Apps Script

Calendar event triggers are now available. You can use these triggers in conjunction with the Calendar advanced service to discover recently changed calendar events via regular sync operations.

February 13, 2018

Google Apps Script
  • The Slides service has been extended with the following new methods:
    • Layout.insertGroup(group)
    • Layout.insertImage(image)
    • Layout.insertLine(line)
    • Layout.insertPageElement(pageElement)
    • Layout.insertShape(shape)
    • Layout.insertSheetsChart(sheetsChart)
    • Layout.insertTable(table)
    • Layout.insertVideo(video)
    • Layout.insertWordArt(wordArt)
    • Master.insertGroup(group)
    • Master.insertImage(image)
    • Master.insertLine(line)
    • Master.insertPageElement(pageElement)
    • Master.insertShape(shape)
    • Master.insertSheetsChart(sheetsChart)
    • Master.insertTable(table)
    • Master.insertVideo(video)
    • Master.insertWordArt(wordArt)
    • Page.insertGroup(group)
    • Page.insertImage(image)
    • Page.insertLine(line)
    • Page.insertPageElement(pageElement)
    • Page.insertShape(shape)
    • Page.insertSheetsChart(sheetsChart)
    • Page.insertTable(table)
    • Page.insertVideo(video)
    • Page.insertWordArt(wordArt)
    • Presentation.appendSlide(slide)
    • Presentation.insertSlide(insertionIndex, slide)
    • Slide.insertGroup(group)
    • Slide.insertImage(image)
    • Slide.insertLine(line)
    • Slide.insertPageElement(pageElement)
    • Slide.insertShape(shape)
    • Slide.insertSheetsChart(sheetsChart)
    • Slide.insertTable(table)
    • Slide.insertVideo(video)
    • Slide.insertWordArt(wordArt)
    • TextRange.appendRange(textRange)
    • TextRange.appendRange(textRange, matchSourceFormatting)
    • TextRange.insertRange(startOffset, textRange)
    • TextRange.insertRange(startOffset, textRange, matchSourceFormatting)
  • The Spreadsheet service has been extended with the following new enum class and method:

January 19, 2018

Google Apps Script

January 11, 2018

Google Apps Script

December 11, 2017

Google Workspace Admin SDK

Reports API: We have created the Entities Usage Report to generate reports on entities used by your account's users. The API currently supports reporting for Google+ communities.

October 24, 2017

Google Apps Script
  • The Gmail add-ons framework is now available to all developers.
  • A new Card service supports Gmail add-ons by defining several UI widget elements that you can use to create a Gmail add-on interface without HTML or CSS. These widgets function on both desktop and mobile. You can only use the Card service in a Gmail add-on project.
  • You can now view and explicitly edit Apps Script project manifests. These files give you more direct control of project properties.
  • You can now directly control the OAuth scopes that your project requests during authorization. Use this control to prevent your script project from asking for more access than it needs.
  • You can now deploy a script project directly from the project manifest.
  • We've updated the Publish script editor menu item to more accurately represent the various kinds of deployments a project can have, such as add-on, web app, or API executable deployments.

October 10, 2017

Google Apps Script

October 06, 2017

Google Apps Script

Add-ons now require OAuth Client Verification prior to beginning the publication process. Verification no longer is conducted during the add-on review.

September 26, 2017

Google Apps Script

Added Apps Script support for the Google Slides service. You can now use Apps Script to create and edit presentations and their contents; you can also build add-ons for Google Slides.

September 15, 2017

Google Apps Script

July 28, 2017

Google Apps Script

July 18, 2017

Google Apps Script

To protect users from abuse, Google OAuth clients that request certain sensitive OAuth scopes are subject to review by Google. Such apps may present users with a warning screen saying the app is unverified by Google. You can remove this screen from your app's authorization flow by submitting a review request.

July 12, 2017

Google Calendar API
v3

Hangouts and Google Meet conferences are now supported in Calendar events via the conferenceData field. You can:

  • Read conference data associated with events.
  • Copy conference data from one event to another.
  • Request new conference generation for an event.
  • Clear conference data associated with events.

To learn more, see Create Events.

July 11, 2017

Google Workspace Admin SDK

Reports API: Nine new parameters have been added to the Google+ customer usage report. The new parameters are:

  • num_communities
  • num_communities_public
  • num_communities_private
  • num_communuties_organization_wide
  • num_communities_organization_private
  • num_collections
  • num_collections_public
  • num_collections_organization_wide
  • num_collections_organization_private

In addition, the Google+ user usage report was created with seven metrics:

  • num_shares
  • num_plusones
  • num_plusones_received
  • num_replies
  • num_replies_received
  • num_reshares
  • num_reshares_received

June 23, 2017

Google Apps Script

Stackdriver Logging has been moved out of Early Access. All scripts now have access to Stackdriver logging.

June 20, 2017

Google Apps Script

Added the method Range.randomize() that randomizes the order of rows in a spreadsheet Range.

May 11, 2017

Google Workspace Admin SDK

Reports API: We have added the App Maker and Apps Script customer usage reports to the customerUsageReports.get method. These new reports allow you to view information about App Maker and Apps Script usage in your domains.

May 05, 2017

Gmail API
v1

Deprecated Review Action, which sunsets on July 15th, 2017.

April 26, 2017

Google Apps Script

April 05, 2017

Google Workspace Admin SDK

Reports API: Google Docs customer and usage reports are being replaced by Google Drive customer and usage metrics. See details in Update your Drive and Docs Metrics.

March 14, 2017

Google Workspace Admin SDK

Reports API: Six new parameters have been added to the Google+ customer usage report. The new parameters are:

  • num_new_users
  • num_shares
  • num_reshares
  • num_plusones
  • num_replies
  • num_stream_items_read

March 09, 2017

Google Apps Script
  • Introduced project collaboration using Shared drives. Files and scripts in a shared drive are owned by the group instead of individuals, allowing collaborators to develop and maintain scripts more readily.
  • Script editors (in addition to script owners) can now publish add-ons and deploy scripts as web apps or executables for the Execution API.
  • For all container-bound scripts, the container owner takes ownership of a new script project regardless of who created it.

March 07, 2017

Google Apps Script

February 07, 2017

Gmail API
v1

The history.list method supports filtering history records by type.

December 01, 2016

Google Apps Script

Introduced the Early Access program for new G Suite Business features. These features include App Maker and Stackdriver Logging.

November 30, 2016

Gmail API
v1

The messages.batchModify method lets you modify labels on multiple messages by message IDs, in a single batch operation.

November 23, 2016

Google Apps Script

Added forms validation classes for check boxes, generic data, grid items, paragraph text items, and text items.

November 01, 2016

Gmail API
v1

The Gmail API supports a gmail.metadata scope. This scope gives developers access to a user's mailbox including history records, labels, and email headers, but not email body's or attachments.

October 19, 2016

Google Apps Script

Added X-Frame-Option header support to HtmlService, allowing iframes to render Apps Script HTML and web apps.

July 28, 2016

Google Apps Script

Added support for Android add-ons. Now you can make Google Docs and Sheets add-ons that work on Android.

July 12, 2016

Google Apps Script

The use of project keys to identify scripts is now deprecated. The preferred unique identifier for a script is the Script ID. There are no plans to turn off or disable the use of project keys; code that uses project keys will continue to work for the foreseeable future.

July 06, 2016

Google Apps Script

NATIVE sandbox mode is now shut down. All scripts default to IFRAME mode, regardless of which mode, if any, is specified. Scripts that relied on NATIVE mode features may need to be migrated.

July 01, 2016

Gmail API
v1

The q request parameter for the drafts.list method restricts results to the messages matching the specified query.

June 15, 2016

Google Sheets API
v4

Google Sheets API v4 is now available. For more information, see Introducing the Google Sheets API v4.

June 13, 2016

Cloud Search
v1

The Google Cloud Search API is now available for enterprise administrators.

May 18, 2016

Google Slides API
v1

The Google Slides API is now generally available.

April 11, 2016

Google Apps Script

Support for PATCH requests has been added to UrlFetchApp.

March 25, 2016

Google Apps Script

Deprecated the add(widget) method in the DashboardPanel class because it takes a UiApp.Widget argument, and UiApp was deprecated in 2014.

February 29, 2016

Google Apps Script
  • The Spreadsheet API adds new methods for getTabColor() and setTabColor(color).

  • The Spreadsheet API adds a new NamedRange type and the following related methods:

    • NamedRange.getName() gets the name of the named range
    • NamedRange.setName(name) sets the name of the named range
    • NamedRange.getRange() gets the underlying range associated with the named range
    • NamedRange.setRange(range) sets the underlying range associated with the named range
    • NamedRange.remove() deletes the named range
    • Spreadsheet.getNamedRanges() gets an array of all the named ranges in the spreadsheet
    • Sheet.getNamedRanges() gets an array of all the named ranges in the sheet
    • Protection.setNamedRange(range) associates an existing protected range with an existing named range
  • The Utilities API includes a new getUuid() method that generates a unique identifier.

February 25, 2016

Gmail API
v1

The messages.batchDelete method lets you delete multiple messages, by message IDs, in a single batch operation.

January 13, 2016

Gmail API
v1

The drafts.list method has an includeSpamTrash option, which determines if the response should include drafts with the SPAM or TRASHlabel applied. The default is currently set to true for this option.

December 10, 2015

Google Apps Script

In the HTML service, EMULATED sandbox mode was sunset. Any scripts that explicitly request EMULATED mode now default to IFRAME mode.

November 12, 2015

Google Apps Script

In the HTML service, all new scripts default to IFRAME sandbox mode unless NATIVE mode is explicitly specified.

August 10, 2015

Google Apps Script

Deprecated the method Service.enable() in the ScriptApp global object. This method is no longer useful because Apps Script's authorization model has changed since the time the method was introduced.

August 04, 2015

Google Apps Script

Added the following methods to the Spreadsheet service to let scripts control "warning-based" protection for spreadsheet ranges (which means that every user can edit data in the area, except editing prompts the user to confirm the edit):

June 30, 2015

Google Apps Script

Added two variations of the method computeRsaSha256Signature to the Utilities global object to let scripts sign a string using the RSA SHA-256 algorithm.

June 22, 2015

Gmail API
v1

To determine the full state of an email before and after a change, the history.list method returns all current Message.labelIds as part of the response in messagesAdded, messagesDeleted, labelsAdded, and labelsRemoved.

June 18, 2015

Gmail API
v1

Added a Message.internalDate field that exposes the message's creation timestamp in the mailbox.

May 29, 2015

Gmail API
v1

You can now send push notifications on mailbox updates, providing real-time server notification without the need for constant polling. With Cloud Pub/Sub, you can now use webhooks—for example, to receive callbacks when updates happen. Additionally, you can filter these notifications to specific Gmail labels.

May 27, 2015

Google Apps Script

Added the method getUserAgent() to the HtmlService global object to let scripts get the user-agent string for the current browser.

May 20, 2015

Google Apps Script

Deprecated the following OAuth class and methods in favor of OAuth libraries: + OAuthConfig + UrlFetchApp.addOAuthService(serviceName) + UrlFetchApp.removeOAuthService(serviceName)

April 23, 2015

Google Apps Script

The DocsList service, which was deprecated in 2014, has been sunset and no longer functions. Users relying on DocsList should switch to DriveApp.

  • Add-ons are now out of developer preview. This means anyone can now publish an add-on. New add-ons will still be reviewed prior to publishing, but the publishing process has been streamlined.
  • Add-ons can now be developed and published from standalone scripts (as opposed to scripts bound to a Sheet, Doc, or Form). The add-on must still operate on a Sheet, Doc, or Form, but the script does not need to be bound to a single master file. Developing from a standalone script is preferred in that it makes collaboration and testing easier.
  • Add-on scripts in development can be tested to ensure they behave as intended.

March 31, 2015

Gmail API
v1

New scopes for labels and inserting messages to better protect users and accommodate apps that don't need full mailbox data access:

March 19, 2015

Google Apps Script
  • Added the ability to publish add-ons for domain-wide installation. This lets an admin of a Google Apps domain install and authorize a Docs, Sheets, or Forms add-on for all users in the domain if the add-on is published to the Google Apps Marketplace. If the developer has already published a Google Apps Marketplace app that is closely related to their add-on, they can also choose to bundle the add-on with the Marketplace app so that admins install both the app and the add-on together.
  • Added the ability to change the Google Developers Console project that a script uses for authorization. This feature is most commonly used to bundle an add-on with a Google Apps Marketplace app, as above.

March 18, 2015

Gmail API
v1

The messages.insert method now supports the deleted request parameter and lets you set SENT and DRAFT labels.

March 04, 2015

Google Apps Script

Deprecated the URL Fetch service's class OAuthConfig, which provided the ability to connect to OAuth 1.0 APIs. This has been replaced by the open source library OAuth1 for Apps Script. See the migration guide for more information.

February 25, 2015

Gmail API
v1

The history.list method now provides details of the change type in each history record. For example, using the messagesAdded, messagesDeleted, labelsAdded, or labelsDeleted enums, it's possible to easily tell how a message was changed and typically avoids the need for additional calls to synchronize your client.

February 11, 2015

Gmail API
v1

The messages.import method now supports the following parameters to better support Email Migration use cases:

  • neverMarkSpam
  • processForCalendar
  • deleted

February 10, 2015

Google Apps Script
  • Deprecated the following class and methods, which have been replaced by the more powerful Protection class above. Although this class and these methods are deprecated, they will remain available for compatibility with the older version of Sheets.

    • PageProtection
    • Spreadsheet.getSheetProtection()
    • Spreadsheet.setSheetProtection(permissions)
    • Sheet.getSheetProtection()
    • Sheet.setSheetProtection(permissions)
  • Replaced the method SpreadsheetApp.open(file), which takes a File object from the deprecated DocsList service as a parameter, with a version that takes a File object from the Drive service instead. The new method has the same name.

  • Changed the Document service methods Text.getFontFamily() and Text.setFontFamily(fontFamilyName) to use string names for font families instead of the FontFamily enum, and consequently deprecated FontFamily.

Changed several Spreadsheet methods that previously returned void so that they now return a Spreadsheet object that can be used to chain method calls.

Issue 4617: HTML service pages that use the new IFRAME sandbox mode now render correctly in Firefox.

February 02, 2015

Google Workspace Admin SDK

Reports API: We have added the Mobile Device customer usage report to the customerUsageReports.get method. This new report allows you to view information about mobile device usage in your domains.

January 23, 2015

Gmail API
v1

You can now specify message.labelIds on messages.import requests to automatically apply the given labels to the message.

The default behavior no longer automatically adds INBOX and UNREAD labels to messages.import emails. When message.labelIds isn't specified, imported mail is only visible in All Mail. If you want INBOX or UNREAD labels applied, specify them in the message.labelIds field.

January 15, 2015

Gmail API
v1

Increased the default per-user quotas from 25 units/user/second to 250 units/user/second and adjusted some method costs slightly.

December 11, 2014

Google Apps Script

Added a new IFRAME sandbox mode for HTML service that imposes many fewer restrictions than the other sandbox modes and runs much faster. However, IFRAME mode does not work at all in certain older browsers, including Internet Explorer 9.

Google Workspace Admin SDK

Reports API: We have added the Google Calendar audit report to the activities.list method. This new report allows you to view information about changes to calendars and calendar events for users in your domain.

December 01, 2014

Google Apps Script

November 20, 2014

Google Workspace Admin SDK

Reports API: We have added the Google Sites customer usage report to the customerUsageReports.get method. This new report allows you to view information about Google Sites usage in your domains.

November 12, 2014

Google Workspace Admin SDK

Reports API: We have added the OAuth Token Audit reporting application to the activities.list method. This new report allows you to view information about third party websites and applications that users in your domains have granted access to.

November 03, 2014

Google Workspace Admin SDK

Reseller API: New billingMethod field.

Reseller API: New transferToDirect deletionType.

October 29, 2014

Google Workspace Admin SDK

Reports API: Added the following parameters to the Gmail customer usage report:

  • num_inbound_delivered_emails
  • num_inbound_rerouted_emails
  • num_inbound_rejected_emails
  • num_inbound_spam_emails
  • num_inbound_non_spam_emails
  • num_inbound_encrypted_emails
  • num_inbound_unencrypted_emails
  • num_outbound_delivered_emails
  • num_outbound_rerouted_emails
  • num_outbound_rejected_emails
  • num_outbound_encrypted_emails
  • num_outbound_unencrypted_emails

October 27, 2014

Google Workspace Admin SDK

Reports API: We have added the ChromeOS Devices customer usage report to the customerUsageReports.get method. This new report allows you to view information about ChromeOS device usage in your domains.

October 23, 2014

Google Apps Script

Add-ons are now available in Google Forms. As with add-ons for Docs and Sheets, Forms add-ons are in developer preview, so you must apply to publish them.

Issue 3928: The Document method setSelection, the Sheet method activate, and the Spreadsheet methods setActiveRange and setActiveSelection now work correctly if they are called from an onOpen or onEdit trigger.

October 22, 2014

Gmail API
v1

You can now specify the return format for the threads.get method. The available formats are full, metadata, and minimal, similar to the messages.get method. The raw format isn't allowed for the threads.get to avoid unexpectedly large amounts of data being returned.

October 16, 2014

Gmail API
v1

The getProfile method provides mailbox-wide information like current history ID and total message and thread counts.

October 14, 2014

Google Apps Script

Add-ons for Google Sheets and Docs can now use time-driven installable triggers.

October 06, 2014

Gmail API
v1

Added a new IMPORTANT label to match functionality with the Gmail UI.

Added new fields to the Labels resource to simplify counting how many messages have a given label applied:

  • messagesTotal
  • messagesUnread
  • threadsTotal
  • threadsUnread

September 30, 2014

Google Apps Script

The UiService widget DocsListDialog now requires that you call DocsListDialog.setOAuthToken(oAuthToken) before calling DocsListDialog.showDocsPicker().

  • Added the LinearOptimizationService, which allows scripts to model and solve linear and mixed-integer linear programs.
  • Add-ons for Google Sheets and Docs can now use most installable triggers, although they still cannot use time-driven triggers (sometimes called clock triggers).
  • Added an installable open trigger for Google Docs. Like the installable open triggers for Sheets and Forms, this trigger is similar to the simple onOpen() trigger, but allows the triggered function to call services that require authorization, if the user has authorized the script ahead of time.
  • Added several new ScriptApp methods, classes, and enums to support installable triggers in add-ons:
    • AuthorizationInfo: An object used to determine whether the user needs to authorize this script to use one or more services, and to provide the URL for an authorization dialog. Returned by ScriptApp.getAuthorizationInfo().
    • AuthorizationStatus: An enumeration denoting the authorization status of a script. Returned by AuthorizationInfo.getAuthorizationStatus().
    • DocumentTriggerBuilder: A builder for document triggers. Returned by TriggerBuilder.forDocument(...).
    • ScriptApp.getUserTriggers(...): Gets all installable triggers owned by this user in the given document, spreadsheet, or form.

September 25, 2014

Gmail API
v1

The messages.insert method defaults to using receivedTime and the messages.import method defaults to using dateHeader.

September 08, 2014

Gmail API
v1

When you use the messages.get method, you can request the metadata return format to return only the email headers and metadata such as identifiers and labels.

September 04, 2014

Google Apps Script
  • Added the UiService method DocsListDialog.setOAuthToken(oAuthToken), which sets an OAuth 2.0 token to use when fetching data for the dialog, on behalf of the user whose content should be shown. This method will become mandatory before calling DocsListDialog.showDocsPicker() on September 30, 2014.
  • Added the CacheService method getDocumentCache() and the LockService method getDocumentLock(), which get a cache and a lock that all users can access within the current document, if the script is published as an add-on. These methods are conceptually similar to the PropertiesService method getDocumentProperties(), which was introduced for use in add-ons earlier this year.

Replaced the CacheService methods getPrivateCache() and getPublicCache() and the LockService methods getPrivateLock() and getPublicLock() with getUserCache(), getScriptCache(), getUserLock(), and getScriptLock(), respectively. The old method names have been deprecated, but will continue to function. The new names follow the same conventions as PropertiesService.

September 02, 2014

Gmail API
v1

You can specify the internalDateSource for both the messages.insert and messages.import methods.

Google Workspace Admin SDK

Reports API: The maximum time limit for usage reports has been increased from 180 days to 450 days. Because this change will take time to populate in our data, the full 450 day history will be available on May 30, 2015 with an earliest available record date of March 6, 2014.

August 15, 2014

Google Workspace Admin SDK

Reports API: A new view event has been added to the Drive activity report.

August 11, 2014

Google Workspace Admin SDK

Directory API: The following fields have been added to the Mobiledevices resource:

  • serialNumber
  • imei
  • meid
  • wifiMacAddress
  • networkOperator
  • defaultLanguage
  • managedAccountIsOnOwnerProfile
  • deviceCompromisedStatus
  • buildNumber
  • kernelVersion
  • basebandVersion

Directory API: The Chromeosdevices resource has the following fields:

  • recentUsers
  • Device's ethernetMacAddress

August 04, 2014

Google Workspace Admin SDK

Reseller API: Deprecated readonly scope.

Reseller API: new licensedNumberOfSeats field in the Subscriptions resource.

July 17, 2014

Google Apps Script

Added the value ON_CHANGE to the ScriptApp.EventType enum so that Google Sheets change events can be detected correctly.

July 11, 2014

Gmail API
v1

Quota costs for all methods in the API have been reduced by a factor of 10. For example, if a method previously cost 150 quota units, it now costs 15. For a complete list of API method costs, see the per-method quota usage chart.

June 25, 2014

Gmail API
v1

The Gmail API is publicly available!

Google Workspace Admin SDK

Reports API: The Drive activity report is now available. This new report provides insight about Drive activity and how your account's users manage, modify, and share their Google Drive documents. This report is available only for G Suite Business customers and replaces the Google Docs activity report. The Google Docs activity report is now deprecated and will cease functioning on January 31, 2015.

June 20, 2014

Google Apps Script

Deprecated the script gallery in the old version of Google Sheets. As explained in the blog post, the add-on store in the new version of Sheets gives developers wider distribution, automatic updates, and several other features not available in the script gallery.

June 05, 2014

Google Workspace Admin SDK

Reports API: Both customer and user Gmail reports now include default values. For example, if a user sends no email, the num_emails_sent parameter is returned as 0. Previously, if there was no data for a field, that field was omitted from the report.

May 29, 2014

Google Apps Script

Added the Document service methods getTextAlignment and setTextAlignment as well as the enum TextAlignment, to support NORMAL, SUPERSCRIPT, and SUBSCRIPT text alignment in Google Docs.

May 27, 2014

Google Workspace Admin SDK

Reports API: Includes usage statistics from suspended users in Customers Usage reports.

May 15, 2014

Google Apps Script

Deprecated both ScriptDB and the Domain service. As announced in the blog post, the services will remain available for the next six months but will be turned off on November 20, 2014. To replace ScriptDB, see the migration guide and the improved guide to connecting to external databases through JDBC. To replace the Domain service, see the Admin SDK Directory and Admin SDK Reports advanced services.

Added a source property to the event parameter for form triggers. This makes it possible to retrieve the form that triggered the event.

  • Issue 3956: In the new version of Google Sheets, it is now possible to call methods that refer to the "active" sheet or spreadsheet even if the sheet or spreadsheet has just been created.
  • Issue 3579: The Blob method getAs can now create PDFs from spreadsheets created with the new version of Sheets.
  • Issue 3378: The documentation page for a library version now uses the same CSS styles as the Apps Script reference documentation.

May 08, 2014

Google Apps Script

The "Report an issue" dialog for add-ons now asks users whether they would like to share their name and email address with the developer.

May 01, 2014

Google Apps Script

April 24, 2014

Google Apps Script
  • Issue 3891: In the new version of Sheets, custom functions now recalculate correctly if more than 100 cells are passed as an argument.
  • Issue 3859: In the new version of Sheets, setting data-validation criteria for a cell that already contains a value no longer corrupts the spreadsheet.
  • Issue 3773: In the new version of Sheets, the Browser methods inputBox and msgBox now treat newline characters (\n) the same way that the older version of Sheets did. Specifically, \n produces a space, but \\n (double-escaped) produces a line break.
  • Issue 2335: The fact that the ID of a GmailThread varies based on the messages it contains is now documented.
  • Issue 2288: The fact that a Google Site or page of a site cannot have more than 500 child pages is now documented.
  • Issue 1427: The fact that the method getAs replaces the part of a filename that follows the last period with the new file type's extension is now documented.

In the new version of Google Sheets, the Undo command can now revert changes made by a script. This was already true in Docs, Forms, and the older version of Sheets.

April 23, 2014

Google Workspace Admin SDK

Reports API: A change has been made to how parameters with no data are returned by the API. Previously, if there was no data for a parameter, it would be absent from the report. For example, the Gmail user usage report would not include the num_emails_sent field in the response if a user didn't send any emails on the report date. The API now returns these parameters with a default of 0 for integers and false for boolean values.

April 17, 2014

Google Apps Script

The Document method setSelection, the Sheet method activate, and the Spreadsheet methods setActiveRange and setActiveSelection no longer have any effect if they are called from an onOpen or onEdit trigger.

  • Issue 3669: In the new version of Sheets, the Range methods getValue() and getValues() no longer throw an exception if a cell uses the built-in Sheets methods =IMAGE(url) or =SPARKLINE(data).
  • Issue 2684: If a script relies on a deleted version of a library, it is now possible to switch to a different version.

April 15, 2014

Google Workspace Admin SDK

Reports API: A new num_users_2sv_not_enrolled_but_enforced parameter has been added to the customer accounts usage report. This new parameter indicates the number of domain users that have 2-step verification enforced but have not enrolled.

April 10, 2014

Google Apps Script

The deprecated SOAP service and old XML service have now been removed from autocomplete and documentation, as announced on July 9, 2013 and documented in the Apps Script sunset schedule. Existing scripts that use these services should still function. The UI service widgets DeckPanel, DecoratedPopupPanel, DockLayoutPanel, DockPanel, StackLayoutPanel, and TabLayoutPanel have been completely disabled, as announced on April 15, 2013.

  • Issue 3788: In the new version of Sheets, custom functions now calculate if they are passed an error value as an argument. This matches the behavior in the older version of Sheets.
  • Issue 3539: In the new version of Sheets, the Range methods setValue and setValues now automatically detect when a value should be set as a formula. This matches the behavior in the older version of Sheets.

April 03, 2014

Google Apps Script

The Range method getDataSourceUrl() is now supported in the new version of Google Sheets. For information on other incomplete Apps Script features in the new version of Sheets, see the list of known issues.

  • Issue 3866: The DocsList methods File.getEditors() and File.getViewers()no longer throw a server error on every call.
  • Issue 3865: The DocsList method File.getOwner() no longer throws a server error on every call.
  • Issue 3845: The advanced Google services for Drive and Calendar are now documented.
  • Issue 3624: In the new version of Sheets, the Sheet method hideSheet() can now hide sheets that have just been inserted.
  • Issue 3554: In the new version of Sheets, the Range method sort() now succeeds for ranges that do not include column A.
  • Issue 3522: In the new version of Sheets, the SpreadsheetApp method getActiveSheet() now returns the correct sheet in a single custom function call. However, getActiveSheet() still returns an incorrect value if the custom function is used in more than one cell with the same function arguments, or if called from an installable edit trigger in the new version of Sheets.
  • Issue 3496: In the new version of Sheets, the SpreadsheetApp method getActiveRange() now returns the correct range in a single custom function call. However, getActiveRange() still returns an incorrect value if the custom function is used in more than one cell with the same function arguments, or if called from an installable edit trigger in the new version of Sheets.

March 27, 2014

Google Apps Script

When an add-on is installed from the store, the onInstall() simple trigger is now passed an event parameter, e, which includes an authMode property. This makes it easier for an add-on to call onOpen(e) from onInstall(e).

  • Issue 3691: In the new version of Google Sheets, scripts can now run for 6 minutes instead of 5 minutes.
  • Issue 3236: Google Picker, a "file-open" dialog for information stored in Google servers, including files in Google Drive, is now supported in HTML service.
Google Workspace Admin SDK

Reports API: Added two new login_failure_type values to the Login Audit events: login_failure_account_disabled and login_failure_unknown.

Reports API: Fixed an issue that caused filters to use case-sensitive comparisons. All filters are now case-insensitive.

March 24, 2014

Google Apps Script

In the new version of Google Sheets, Range.setValues() now automatically extends the spreadsheet if the range is larger than the present size.

  • Issue 3800: In the new version of Sheets, custom functions now accept numbers larger than 10,000,000 or smaller than 0.0001 as arguments.
  • Issue 3770: In the new version of Sheets, Sheet.insertImage() now inserts the image at the correct size.
  • Issue 3724: In the new version of Sheets, Range.setValue() now correctly sets numeric values in non-English spreadsheets.

March 18, 2014

Google Apps Script

Issue 3757: The link to the Google Developers Console in the Advanced Google Services dialog now opens the correct project.

March 11, 2014

Google Apps Script

Announced a developer preview for add-ons in Google Docs and the new version of Google Sheets, with support for Google Forms coming soon. An add-on is an Apps Script project published to a store inside Docs or Sheets, which makes it easy for users to find and install new features. Our guides cover everything you need to know to develop, design, and apply to publish your first add-on.

  • Released a CSS package to apply Google styling to fonts, buttons, and form elements in HTML service dialogs and sidebars, primarily for use in add-ons.
  • Added the UI method createAddonMenu(), which allows scripts to insert a sub-menu into the Add-ons menu in Google Sheets or Docs. For more information, see the guide to menus.
  • Added the ScriptApp enum AuthMode, which identifies categories of authorized services that Apps Script can execute through a triggered function. For more information, see the guide to the add-on authorization lifecycle.
  • Added support for the custom JsDoc annotation @OnlyCurrentDoc, which forces the authorization dialog to ask only for access to files in which an add-on or script is used, rather than all of a user's spreadsheets, documents, or forms. An opposing annotation, @NotOnlyCurrentDoc, is also available.

Changed the quota for Gmail from 10,000 reads and 10,000 writes per day (excluding sent messages) to 20,000 reads and writes combined per day.

March 05, 2014

Google Workspace Admin SDK

Reports API: Fixed an issue that caused filters to be ignored on queries for single users and always return a single record. After the fix, queries for single users that also include filters will return no result if the user does not match the filter criteria.

February 28, 2014

Google Workspace Admin SDK

Reports API: Fixed an issue that caused certain statistics on numbers of active users to include one extra day. Some domains might notice a decrease in the number of reported active users for reports after February 24, 2014. The affected fields are:

  • Accounts
    • num_1day_logins
    • num_7day_logins
    • num_30day_logins
  • Google Calendar
    • num_1day_active_users
    • num_7day_active_users
  • Google Docs
    • num_1day_active_users
    • num_7day_active_users
    • num_30day_active_users
  • Gmail
    • num_1day_active_users
    • num_7day_active_users
    • num_30day_active_users
  • Google+
    • num_1day_active_users
    • num_7day_active_users

Reports API: Added the following fields to the Customer Account Usage and Users Account Usage reports:

  • Customer Accounts
    • num_authorized_apps
    • authorized_apps
    • drive_used_quota_in_mb
    • gmail_used_quota_in_mb
    • gplus_photos_used_quota_in_mb
    • total_quota_in_mb
    • used_quota_in_mb
    • apps_total_licenses
    • apps_used_licenses
    • vault_total_licenses
    • coordinate_total_licenses
  • User Accounts
    • num_authorized_apps
    • drive_used_quota_in_mb
    • gmail_used_quota_in_mb
    • gplus_photos_used_quota_in_mb
    • total_quota_in_mb
    • used_quota_in_mb
    • used_quota_in_percentage

February 25, 2014

Google Apps Script

Deprecated the Finance service. As announced in the blog post, the service will remain available for the next six months but will be turned off on September 26, 2014.

  • Replaced ScriptProperties and UserProperties with a unified PropertiesService. For more information, see the guide to the Properties service.
  • In Google Docs and Forms, sidebars now ignore the setWidth() method; they cannot be changed from the default width of 300px. This change was applied to the new version of Sheets in the previous week's release.
  • In Google Docs and Forms, the Undo command can now revert changes made by a script. This is also true in the older version of Sheets, but not the new version.
  • In the HTML service, the NATIVE sandbox mode is now the default if you have not specified which mode your script should use. In a few edge cases, this may affect how existing web apps operate; if so, append .setSandboxMode(HtmlService.SandboxMode.EMULATED) to your HtmlOutput object to restore the old behavior.
  • Added the following DocumentApp classes and methods, which allow scripts to create bookmarks and named ranges, plus set the user's cursor position or selection.
    • Bookmark
    • `NamedRange
    • `RangeBuilder
    • `Document.addBookmark(position)
    • `Document.addNamedRange(name, range)
    • `Document.getBookmark(id)
    • `Document.getBookmarks()
    • `Document.getNamedRangeById(id)
    • `Document.getNamedRanges()
    • `Document.getNamedRanges(name)
    • `Document.newPosition(element, offset)
    • `Document.newRange()
    • `Document.setCursor(position)
    • `Document.setSelection(range)
    • `Position.insertBookmark()
  • Added the following ScriptApp class and methods, which allow scripts to create state tokens that can be used in callback APIs (like OAuth flows), as well as to retrieve the script's own OAuth 2.0 access token.
    • `StateTokenBuilder
    • `ScriptApp.getOAuthToken()
    • `ScriptApp.newStateToken()
  • Added the method showModalDialog(userInterface, title) to the Ui class, and replaced the method showDialog(userInterface) with showModelessDialog(userInterface, title). This allows scripts to specify whether a dialog in Google Docs, Forms, or the new version of Sheets should prevent the user from interacting with anything other than the dialog.
  • Added the client-side HTML-service method google.script.host.editor.focus(), which allows scripts to switch browser focus from the dialog or sidebar to the Google Docs, Sheets, or Forms editor.

Issue 3622: The title bar of a sidebar shown by a script in Google Docs, Forms, or the new version of Sheets is now the same height as in a sidebar shown by a built-in feature.

February 24, 2014

Google Workspace Admin SDK

Directory API: The users.update method behavior has been slightly changed to accommodate delegated administrator access to the Directory API. Only fields the authenticated user has access to can be specified in the request and only fields that have been updated are included in the response.

February 18, 2014

Google Apps Script

Removed the Session method getActiveUserTimeZone(), which did not return a value for most users.

  • In Google Docs, Forms, and the new version of Sheets, showing a dialog now automatically closes any other dialogs opened by a script. This matches the longstanding behavior in the older version of Sheets.
  • In the new version of Sheets, sidebars now ignore the setWidth() method; they cannot be changed from the default width of 300px. This change will affect Docs and Forms soon.
  • Issue 3522: In the new version of Sheets, the SpreadsheetApp method getActiveSheet() now returns the correct sheet if called from a simple onEdit() trigger. However, getActiveSheet() still returns an incorrect value if used in a custom function or an installable edit trigger in the new version of Sheets.
  • Issue 3496: In the new version of Sheets, the SpreadsheetApp method getActiveRange() now returns the correct sheet if called from a simple onEdit() trigger. However, getActiveRange() still returns an incorrect value if used in a custom function or an installable edit trigger in the new version of Sheets.
  • Issue 3332: The DocumentApp method setHeading() now applies heading styles in the same way that the Google Docs editor does.

February 10, 2014

Google Workspace Admin SDK

Reports API: Suspended users are now included in the statistics for Google Docs reports. Some domains might notice an increase in the number of reported documents. The following parameters have been added to the User's usage report:

  • Accounts: used_quota_in_percentage
  • Docs
    • num_docs_externally_visible
    • num_docs_internally_visible
  • Gmail: num_emails_exchanged

January 27, 2014

Google Apps Script

The quota for the number of email recipients for scripts running from consumer (gmail.com) or free Google Apps accounts has been reduced from 500 to 100 per day. The quota for paid Google Apps accounts has not been changed.

Added the following Session methods, which allow scripts to determine the user's locale and time zone:

  • getActiveUserLocale()
  • getActiveUserTimeZone()

Renamed several classes and methods in DocumentApp. The old names are deprecated but will continue to work. You do not need to update your code.

  • SearchResult and SelectedElement are now RangeElement.
  • Selection is now Range.
  • Selection.getSelectedElements() is now Range.getRangeElements().
Google Workspace Admin SDK

Directory API: Supports push notifications for changes to users and aliases. You no longer need to poll resources to detect changes. You can create a notification channel using the users.watch and users.aliases.watch methods. You can stop receiving notifications with the channels.stop method.

Directory API: Structured search queries for users are available by using the users.list method.

Reports API: Added push notifications for changes to the Activities resource. This is exposed in the API as two new methods, activities.watch and channels.stop, to start and stop receiving notifications.

January 21, 2014

Google Apps Script

The new SpreadsheetApp method Spreadsheet.getUi() allows scripts to access the spreadsheet's user-interface environment in order to add features like menus, dialogs, and sidebars. This method is consistent with the getUi() methods in DocumentApp and FormApp, but only works in the new version of Google Sheets. The older version of Google Sheets continues to use the existing methods documented in the guides to dialogs and sidebars and menus.

January 13, 2014

Google Apps Script

Renamed the Cursor object in DocumentApp to Position. This does not require any changes to existing code.

Deprecated the SpreadsheetApp.Spreadsheet methods isAnonymousView(), isAnonymousWrite(), isReadable(), isWritable(), and setAnonymousAccess(). Various methods of the File class in DriveApp can achieve the same functionality.

Added the SpreadsheetApp method DataValidationBuilder.requireFormulaSatisfied(String), as well as an accompanying CUSTOM_FORMULA value in DataValidationCriteria. This feature can only be used in the new version of Google Sheets.

January 06, 2014

Google Apps Script
  • Custom menus in Google Docs now appear in the Help menu search box.
  • Custom dialogs created with the HTML service can now be resized by calling google.script.host.setWidth(width) and google.script.host.setHeight(height) in client-side code. Sidebars cannot be resized in client side code.

Added the advanced parameter escaping to UrlFetchApp.fetch(). If false, reserved characters in the URL will not be automatically escaped.

The Maps.DirectionFinder.Mode enum now includes the TRANSIT value allowing for the retrieval of public transit routes in the Maps service.

December 16, 2013

Google Apps Script

Added seven new advanced services: + Admin SDK Directory service + Admin SDK Reports service + Fusion Tables service + Google+ Domains service + Mirror service + YouTube service + YouTube Analytics service

  • Changed the default syntax for all existing advanced services to match the underlying APIs' reference documentation. The old Apps Script getter/setter notation for these services will continue to work but will no longer appear in autocomplete.
  • Renamed the menu entry Resources > Manage libraries to Resources > Libraries.
  • Renamed the menu entry Resources > Google APIs Services to Resources > Advanced Google services.

Issue 3461: A yellow warning bar should no longer appear on Apps Script gadgets that are embedded in Google Sites.

December 03, 2013

Google Workspace Admin SDK

Reports API: Added support for resellers to retrieve usage reports and audit information for a specific customer. This is exposed in the API as a new customerId parameter for the activities.list, customerUsageReports.get, and userUsageReport.get methods.

December 02, 2013

Google Apps Script

Added TITLE and SUBTITLE values to the DocumentApp.ParagraphHeading enum.

  • Issue 3101: Removed the SitesApp method Site.deleteSite(), which was never functional.
  • Issue 3046: UrlFetchApp now properly preserves RFC 3986 escaping.
  • Issue 2497: An rare edge case issue when using UiApp server handler callbacks and libraries no longer occurs.
  • Issue 1346: An issue in which a library's UiApp server handlers created new server handlers that were not able to reference non-library functions should no longer occur.

November 18, 2013

Google Apps Script

The Apps Script methods Utilities.jsonParse() and Utilities.jsonStringify() have been deprecated in favor of the now-standard JavaScript methods JSON.parse() and JSON.stringify(), which now appear in autocomplete.

November 11, 2013

Google Apps Script

Issue 3189: A rare issue in which LockService failed to acquire a lock should no longer occur.

November 04, 2013

Google Apps Script

If a version of a library has been deleted by the library owner, scripts can no longer use that version.

Issue 2817: Sporadic errors about missing libraries should now occur less frequently.

October 28, 2013

Gmail API
v1

The Review Action is out of preview, and now available to all users.

October 21, 2013

Google Apps Script

Issue 74: Simple onEdit() triggers now fire correctly when the user is not signed in to a Google account.

October 08, 2013

Google Apps Script

Added the following FormApp methods, which allow scripts to work with progress bars, custom closed-form messages, and YouTube videos. + Form.hasProgressBar() + Form.setProgressBar(enabled) + Form.getCustomClosedFormMessage() + Form.setCustomClosedFormMessage(message) + Form.addVideoItem()

October 03, 2013

Gmail API
v1

The Schema Validator tool in Testing Your Schemas has been replaced with the new Email Markup Tester.

September 23, 2013

Google Apps Script

Added the following DriveApp methods, which allow scripts to get the owner of a File or Folder.

September 16, 2013

Google Apps Script
  • HTML Service now supports most CSS3 features. A notable exception is the :nth-child() pseudo-selector, which remains unsupported, along with a small number of obscure or non-standardized CSS3 features. To check whether the Caja security sandbox in HTML Service supports a specific feature, see the CSS whitelist definitions in Caja's public repository.
  • Added the following DriveApp methods, which allow scripts to save the state of a file or folder iterator and resume at a later time. These method are useful if processing an iterator in one execution would exceed the maximum execution time.
    • FileIterator.getContinuationToken()
    • FolderIterator.getContinuationToken()
    • DriveApp.continueFileIterator(continuationToken)
    • DriveApp.continueFolderIterator(continuationToken)

The UiApp widgets Hyperlink, InlineHyperlink, LayoutPanel, and RichTextArea have now been disabled, as announced on March 13, 2013 and documented in the Apps Script sunset schedule.

September 09, 2013

Google Apps Script

Added the DocumentApp methods InlineImage.getLinkUrl() and InlineImage.setLinkUrl(url).

Deprecated the DocumentApp methods getFootnotes(), getLinkUrl(), setLinkUrl(url), and isAtDocumentEnd() in the classes FooterSection, FootnoteSection, and HeaderSection, as well as the methods getNextSibling() and getPreviousSibling() in the classes FooterSection and HeaderSection. These methods were not useful.

Issue 2621: A situation in which certain scripts did not terminate despite exceeding the execution-time limit no longer occurs.

September 03, 2013

Google Apps Script

Removed the ability to get the user's email address in simple onEdit() triggers. Because simple triggers don't request user authentication, this change was important to protect the identity of collaborators who hadn't explicitly granted permission for the script to collect their email address.

  • Added the DriveApp methods DriveApp.getFoldersByName(name) and DriveApp.searchFolders(params), which return a FolderIterator with the requested results.
  • Added the DriveApp methods File.getViewers(), File.getEditors(), Folder.getViewers(), and Folder.getEditors(), which return an array of Users with view or edit access.

September 02, 2013

Google Workspace Admin SDK

Reseller API: To retrieve all of a customer's subscriptions, use the customer's customerId parameter. For more information, see Retrieve & update a subscription.

Reseller API: To retrieve all transferable subscriptions for a customer, use the customer's customerId and the customerAuthToken. For more information, see Retrieve all transferable subscriptions for a customer.

Reseller API: When retrieving all transferable subscriptions for a customer, the response contains a subscription's transferInfo property with the tranferabilityExpirationTime and minimumTransferSeats attributes.`

Reseller API: The customer resource's resourceUiUrl URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.

Reseller API: The API can retrieve the full account settings of one of your resold customers or the customerId and customerName of a standalone Google customer or a customer managed by another reseller.

August 19, 2013

Google Apps Script

Added the DriveApp methods File.makeCopy(destination) and File.makeCopy(name, destination), which allow scripts to specify a folder to which a file should be copied.

Issue 3097: A performance issue that affected certain scripts no longer occurs.

August 13, 2013

Google Apps Script

Added the method Spreadsheet.deleteSheet(sheet), which allows deletions of sheets that are not the active sheet.

August 05, 2013

Google Apps Script

Deprecated the DocsList methods find(query, start, max), getAllFiles(start, max), getAllFolders(start, max), getFiles(start, max), getFilesByType(fileType, start, max), and getFolders(start, max). Instead of these methods, use DriveApp or one of the DocsList.get*ForPaging() methods.

  • Issue 2916: HTML files inserted into a new Apps Script project using the Google Drive SDK are no longer created with the server_js filetype.
  • Issue 2880: Special characters (such as apostrophes) no longer need to be escaped twice when passed to DriveApp.getFilesByName().
  • Issue 2780: DriveApp now throws a more appropriate error message if Google Drive apps are prohibited within the user's domain.

July 29, 2013

Google Apps Script

All new scripts now use the new authorization flow by default.

On ChromeOS devices, it is now possible to activate autocomplete (sometimes called "content assist") with the keyboard shortcut Ctrl + Space.

Issue 2947: Newlines are now supported in Ui.alert() and Ui.prompt() dialogs.

July 23, 2013

Gmail API
v1

It is now possible to use schemas to define Orders, Parcel Deliveries, and the TrackAction to let users track packages being delivered.

July 22, 2013

Google Apps Script

Added DriveApp and FormApp to the services tracked on the Apps Script Dashboard.

Issue 2801: Fixed an issue in which specific URL parameters did not work with HtmlService.

July 11, 2013

Gmail API
v1

The RSVP Action is now enabled for all emails sent by Google Calendar.

July 09, 2013

Google Apps Script

Added XmlService to replace the old Xml service.

Deprecated the old Xml service, SoapService, and support for the JavaScript feature E4X.

July 01, 2013

Google Workspace Admin SDK

Reseller API: A subscription's optional status property can be ACTIVE, CANCELLED, PENDING, or SUSPENDED. For more information, see the subscriptions resource.

Reseller API: The customerId parameter is either the primary domain name or the unique identifier of a customer. We recommend using the unique identifier or the customer value.

Reseller API: A Vault subscription is no longer limited to accounts created after August 1.

Reseller API: The maximum queries per day (QPD) has been increased to 10,000. For more information, see Usage limits.

June 25, 2013

Google Apps Script
  • Any script that is container-bound to a Google Doc can now access the active user's Cursor and Selection by calling Document.getCursor() and Document.getSelection(), respectively.
  • The Publish > Deploy as web app dialog now includes an option to save a version of the script, if a version has not previously been saved. Subsequent versions of the script must still be saved through the File > Manage versions dialog.
  • Scripts now always require authorization to use the methods Session.getEffectiveUser() or Session.getUser(). Existing scripts that use those methods and were upgraded to the new authorization experience require reauthorization but will not prompt for authorization automatically. To reauthorize the script, follow these instructions.
  • UrlFetch requests made by scripts that run on a time-based trigger now include an If-Modified-Since HTTP header so that Apps Script can use a cached copy of the page if one is available and the page has not changed.
  • Issue 2820: getActiveSheet()now properly returns the active sheet when used with an onChange trigger.
  • Issue 2761: When a Document element that contains an image is copied, the image is now also copied.

June 17, 2013

Google Apps Script
  • Issue 1034: The new Drive Service methods addCommenter() and removeCommenter() allow scripts to add and remove commenters on files.
  • Issue 674: Mail sent with GmailApp now appears in the Sent Mail folder in Gmail.
  • Issue 2626: The execution transcript now correctly reports the execution time for methods that are called repeatedly.
  • Issue 2559: A sporadic issue in which Spreadsheet.getSheetByName() returned null for a valid sheet name no longer occurs.
  • Issue 1965: Emails forwarded using GmailMessage.forward() now preserve inline images.
  • Issue 1414: Range.copyTo() now adds additional rows as necessary, if the destination sheet does not have enough rows to accommodate the range.

June 11, 2013

Google Apps Script
  • Issue 2823: Timestamps for the start and end of script execution, including total runtime, now appear in the execution transcript (View > Execution transcript) instead of the log.
  • Issue 2807: A rare issue where a script could not be upgraded to the new authorization flow no longer occurs.
  • Issue 2791: Calling Trigger.getTriggerSource() for a Form-based trigger no longer throws an exception.
  • Issue 2734: HtmlService scripts that call long-running server-side functions no longer repeat the function call multiple times.

June 03, 2013

Google Apps Script
  • To simplify the end user experience, function names are no longer shown in the notification message for scripts that run successfully from a spreadsheet, document, or form. Function names are still displayed when there is an error (to help with debugging) and when the script is run from the script editor.
  • To simplify the Document service, the following methods were removed from the Body class: getNextSibling(), getPreviousSibling(), isAtDocumentEnd(), getLinkUrl(), setLinkUrl(), and removeFromParent().
  • Issue 2819: Folder.createFile(name, content, mimeType) now creates the file in the folder on which the method was executed.
  • Issue 2776: Existing deployed web apps now properly authenticate after upgrading a script to use the new authorization experience.
  • Issue 2679: The getAs() method of the File class no longer throws an error when converting .docx, .pptx, or .xlsx files to PDF.
  • Issue 2643: The timestamps for a script's log messages are now in the script's timezone.
  • Issue 2597: The script editor's Find functionality no longer skips the first result.

May 13, 2013

Google Apps Script
  • The script editor is now available within Google Docs and the Google Forms editor, and both Docs and Forms can now be containers for scripts.
  • Added Forms Service, which allows scripts to create and modify Google Forms.
  • Added Drive Service, which allows scripts to create and modify files and folders in Google Drive. This is a newer version of the existing DocsList Service.
  • Added a getUi method to DocumentApp and FormApp, which returns a Ui object that allows the script to add features like menus, dialogs, and sidebars to the Docs or Forms editor.
  • Added the FormTriggerBuilder class to allow scripts to respond to Forms events.
  • Added a setSandboxMode method to enable a faster version of the HtmlService sandbox.
  • Added a MimeType enum, which provides access to MIME-type declarations without typing the strings explicitly.
  • Added an option to upgrade to a new authorization flow that requires fewer clicks and automatically creates a Google Developers Console project for every script.

May 09, 2013

Google Apps Script

Issue 2158: The request object passed in to doPost() methods now contains the POST body. It can be accessed using e.postData.getDataAsString().

Issue 2740: UrlFetchApp.fetch() calls no longer fail if the advanced parameters specify a payload without specifying the request method.

May 02, 2013

Google Apps Script

Issue 1363: Added support for spreadsheet change events. The onChange() event now fires when certain modifications, such as row insertions, are done to a spreadsheet.

Issue 2585: Xml.parse() once again correctly parses well-structured XML and HTML documents.

April 29, 2013

Google Apps Script
  • Issue 2695: Form submits in UI Service apps once again work properly.
  • Issue 2625: The withUserObject() method in Html Service apps now works properly with Firefox 20.
  • Issue 1612: Element.copy() can now copy InlineImage elements from one document to another.
  • Issue 170: Spreadsheet.addCollaborators() now sends an email invitation to collaborators when the emailInvitations advanced parameter is set.

April 22, 2013

Google Apps Script

Large scripts in the Script Gallery now install more quickly.

  • Issue 1771: Added a clear() method to the Tree and TreeItem classes. These methods remove all children from the object.
  • Issue 1743: Added an autoResizeColumn() method to the Sheet class. This method resizes a column to fit its contents.
  • Issue 1314: Added support for lazy loading in the Tree class, which reduces wait times in rendering the UI.
  • Issue 2665: UrlFetchApp.fetch() once again allows URLs that contain spaces.
  • Issue 2593: Range.setValue() now behaves correctly in a function called from an onEdit spreadsheet trigger.
  • Issue 941: The event parameter for a ListBox handler function now includes the value of the selected item rather than its name.
  • Issue 307: The event parameter for a Tree handler function now includes the ID of the selected item.

April 15, 2013

Google Apps Script

The following changes were made to simplify the Document service:

  • Renamed the DocumentBodySection class to Body.
  • Renamed Document.getActiveSection() to getBody().
  • Removed methods of the Body class from Document so they only appear in one location.
  • Removed merge() methods for various classes that cannot be merged, such as PageBreak and HorizontalRule.
  • Removed text-related methods such as isBold() and isUnderline() from container elements such as Table while retaining them on the Text class. This functionality can now be achieved by calling editAsText() on the container element, and calling the text-related methods on the returned Text class.
  • Removed methods which allowed appending or inserting HorizonalRule elements with specified attributes.

Deprecated UiApp widgets DeckPanel, DecoratedPopupPanel, DockLayoutPanel, DockPanel, StackLayoutPanel, and TabLayoutPanel, which had limited usability.

Issue 2565: DocsList.createFile() no longer allows the creation of files with invalid MIME types or Google document MIME types.

April 08, 2013

Google Apps Script
  • Simplified the classes in the Document service, removing unnecessary .asSomething() methods.
  • Added timestamps to the log output.
  • Issue 2548: Triggers created in web apps that allow for anonymous access no longer fail to fire.
  • Issue 2488: Charts dashboard components no longer throw serialization errors in certain scenarios.

April 02, 2013

Google Workspace Admin SDK

Directory API: The differences between the Directory API and the deprecated Provisioning API (v2):

  • Account's domain name
    • The Directory API user's primaryEmail property holds the account's primary domain name.
    • The Provisioning API request URL's domain property holds the account's primary domain name.
  • Administrator
    • The Directory API isAdmin property has a boolean true, false value. The isAdmin property can only be edited in the Make a user an administrator operation. If edited in the Create a user account or Update a user account operations, the edit is ignored.
    • The Provisioning API isAdmin property has a boolean true, false value. The property can be edited when the user is created or updated.
  • A customerId unique identifier
    • The Directory API returns a customerId unique identifier property when a user is retrieved for an account with a single or multiple organizational units.
    • The Provisioning API returns a customerId for accounts with an organizational unit hierarchy.
  • Deleted user list
    • The Directory API returns a list of users deleted from the account or a subdomain within the span of the last 20 days.
    • The Provisioning API doesn't support this feature.
  • Disk space
    • Not applicable in this version of the Directory API.
    • The Provisioning API apps:quota that sets the user's disk space quota is no longer available. Setting a customer quota, different than 25600MB, has no effect.
  • Devices
    • The Directory API's Google Chrome devices and mobile devices support the management of retrieving, adding, updating, and deleting your account's various devices.
    • The Provisioning API doesn't support these features.
  • Email aliases outside of an account
    • The Directory API users and groups support listing non-editable alias email addresses that are outside of the account. These are functioning email addresses used by a user or a group on a regular basis.
    • The Provisioning API doesn't support this feature.
  • Group alias
    • The Directory API creates, lists, and deletes a group's aliases.
    • The Provisioning API supports managing groups but doesn't include group aliases.
  • Hash function
    • The Directory API hashFunction property holds the hash format of the password property. The values can be set to either SHA-1, MD5, or CRYPT hash formats.
    • The Provisioning API hashFunctionName attribute is a part of the password tag. The values can be either SHA-1, MD5, or CRYPT hash formats.
  • Organizational units
    • The Directory API uses the orgUnitPath property when setting a new user.
    • The Provisioning API has two steps for creating a user in an organizational unit. First the user account is created and then the user is assigned to an organizational unit.
  • Suspend a user
    • The Directory API suspends a user's account either when creating or updating the user's account using the suspended property. The reason for the suspension is also retained by the API in the suspensionReason property.
    • The Provisioning API uses the operation that suspends a user's account.
  • Undelete a user
    • The Directory API undeletes a previously deleted user account within 20 days of the deletion.
    • The Provisioning API restores a suspended user account to an active state within the suspension period.
  • User aliases
    • The Directory API supports user alias for a single or multiple domain account. A user alias is an alternate email address that uses the same mailbox used by the user's primary email address. A user's alias can be associated with a different account domain than that domain used by the user's primary email address. The account can have single or multiple domains. The Directory API doesn't use the concept of a 'nickname' for a single domain.
    • The Provisioning API manages a single domain account's nicknames, and, in the case of an account with multiple domains, the Provisioning API supports user aliases.
  • User list's search, sorting, and list order
    • The Directory API can search for users by primary email address, given name, or family name. In addition, the Directory API can return lists of a domain's users sorted by the user's primary email address, given name, or family name. And, you have the option to list these results in ascending or descending order.
    • The Provisioning API doesn't support these features.

April 01, 2013

Google Apps Script

Issue 995: The new methods Sheet.hideSheet(), Sheet.isSheetHidden(), and Sheet.showSheet() allow scripts to control the visibility of individual sheets within a spreadsheet.

  • Issue 2524: Scripts that rely on deleted libraries now display a clear error message.
  • Issue 2169: Installing scripts from the Script Gallery no longer results in occasional errors.
  • Issue 459: The event parameter for spreadsheet onEdit() functions now reports the affected range correctly in a variety of situations in which the range property was previously incorrect.

March 25, 2013

Google Apps Script
  • Issue 2534: Debugging into a recursive function using certain GroupsManager methods no longer throws an error.
  • Issue 1106: Restored the correct behavior of Range.mergeAcross(). This function, along with Range.merge() and the newly added Range.mergeVertically(), behave like the items under a spreadsheet's Format > Merge cells menu.

March 18, 2013

Google Apps Script

Renamed the action "Publish to Gallery" to "Submit to Gallery", to avoid confusion with publishing a web app.

Deprecated the GUI Builder and the UIApp widgets Hyperlink, InlineHyperlink, LayoutPanel, RichTextArea, and SuggestBox, which had limited usability.

March 11, 2013

Google Apps Script
  • View > Execution transcript now shows how much time it took to execute each statement.
  • If a script is shared with editors other than its owner and published as a web app, those other editors can now update the app's version and access its development URL (which ends in /dev).

Issue 1917: It is no longer possible to install a script multiple times from the Script Gallery.

March 10, 2013

Google Drive API
v3

The Google Drive API is now generally available.

March 04, 2013

Google Apps Script
  • Issue 1182: Calendar.getEvents(startTime, endTime, statusFilters) now works properly.
  • Issue 459: OnEdit callbacks triggered by pasting to a cell now provide the correct range parameter.

February 25, 2013

Google Apps Script

When setting font colors in a spreadsheet using Range.setFontColor() or Range.setFontColors(), color names will now automatically be converted to their corresponding hexadecimal values. For example, after calling setFontColor('red') the method getFontColor() will return "#ff0000".

  • Issue 2435: Spreadsheet-bound scripts that use Browser.inputBox() no longer fail.
  • Issue 1128: Font colors set using Range.setFontColor() or Range.setFontColors() now appear correctly when printing the spreadsheet or exporting it as a PDF.
  • Issue 529: SpreadsheetApp.getActiveSheet() no longer fails to run in onOpen() triggers for certain spreadsheets.

February 14, 2013

Google Apps Script

Added the method DocumentApp.openByUrl(), which allows documents to be opened by their URL directly.

  • Issue 2382: File.makeCopy() no longer produces an error when copying a new Google Form.
  • Issue 2367: The error message for invalid queries of ScriptDbInstance.between() is now more descriptive.
  • Issue 747: Error messages now specify in which code file the error occurred.

February 11, 2013

Google Apps Script

Added the ability to directly attach StaticMap objects in emails.

  • Issue 2388: The quota dashboard once again displays the correct number of columns.
  • Issue 2344: Scripts that contain onInstall() functions no longer produce an error when installed from the Script Gallery.
  • Issue 2250: Dates are now logged in the script's time zone.
  • Issue 2021: UiInstance.setStyleAttribute() now properly sets the backgroundImage property in all supported browsers.
  • Issue 1811: The debugger can now step into libraries used in development mode.
  • Issue 1300: If a script bound to one spreadsheet uses an installable onEdit() trigger to monitor a separate spreadsheet, the range event parameter passed to the callback function now correctly recognizes the monitored spreadsheet as its parent.
  • Issue 1226: Client handlers for ListBox now fire properly in UiApp.
  • Issue 1030: The setStyleAttribute() method of various UiApp objects now properly sets the 'float' attribute in Firefox.
  • Issue 1014: setFocus() now works correctly.
  • Issue 231: Added show() and hide() methods to PopupPanel.

January 31, 2013

Google Apps Script
  • Changed the behavior of ClockTriggerBuilder so that it now respects the time zone of the script, instead of defaulting to Pacific Time.
  • The editor's Find dialog now supports searching over all files in the project.
  • Improved the error message returned by Range.setValues() when the values fail to pass the validation on those cells.

Added the method SpreadsheetApp.openByUrl(), which allows spreadsheets to be opened by their URL directly.

  • Issue 2317: Email address validation in UiApp now works correctly with uppercase input.
  • Issue 2306: The GUI Builder dialog shown for File > Open no longer has two "Cancel" buttons.
  • Issue 2265: Static maps can now contain many more markers.
  • Issue 2203: CalendarEvent.getGuestList() now returns the event creator in addition to the other guests.
  • Issue 2137: A DateBox containing an empty or invalid date will now have a null value when processed in a server handler or doPost() callback. By default, setting an empty or invalid date will not trigger a value-changed event, but you can call the method setFireEventsForInvalid() to override that behavior.
  • Issue 1795: TextArea widgets created using the GUI Builder now default to displaying scrollbars when the text is too long.
  • Issue 1764: ClockTriggerBuilder.onWeekDay() now works correctly when used in conjunction with everyWeeks().
  • Issue 1695: GmailLabel.getThreads() now works correctly when the label name contains special characters.
  • Issue 1366: The methods getEditors() and getViewers() of the File class now return the full email address for entries that are groups.
  • Issue 918: Subsequent calls to Sheet.hideColumns() on different sheets no longer results in an error.
  • Issue 53: Rows containing only data-validation rules no longer count towards Sheet.getLastRow().

January 24, 2013

Google Apps Script
  • Issue 1642: When connecting to an external database with Jdbc.getConnection, you can now include the advanced argument use JDBCCompliantTimezoneShift.
  • Issue 619: UiInstance's createAnchor method now allows links using the mailto scheme.
  • Issue 286: UrlFetchApp's fetch method now accepts followRedirects as an advanced argument.
  • Issue 1012: New calendar entries that span a time change (for example, the start of daylight saving time in that time zone) are now created with the correct duration.
  • Issue 912: It is now possible to display non-public images in a UiApp or HtmlService user interface, so long as the images are shared with the app's users.
  • Issue 815: UiInstance's createToggleButton(upText, downText) method now functions correctly.
  • Issue 155: Calendar.createAllDayEvent now always sets the event to the correct date.

January 17, 2013

Google Apps Script

Added the method after(durationMilliseconds) to class ClockTriggerBuilder to simplify the creation of one-off triggers.

  • Issue 2155: The Uninstall link emailed to a user after authorizing a script embedded within a Google Site now works correctly.
  • Issue 1882: Icons in the Script Editor now display correctly on Macs with Retina displays.

January 15, 2013

Google Apps Script

Issue 2204: Utilities.formatDate no longer rejects certain time-zone formats, such as EST, CST, etc.

December 17, 2012

Google Apps Script
  • Issue 2131: The timezone offset for "Europe/Moscow" is now correct.
  • Issue 2124: ScriptDb no longer throws an error when storing a float value.
  • Issue 2021: Setting the background image of a UiApp panel now works correctly.
  • Issue 1856: The Jdbc service now resolves host names correctly.
  • Issue 1312: The error message shown when the rate limit for spreadsheet creation is exceeded is now more readable.
  • Issue 949: Typing the character } on a Spanish keyboard now works correctly.

December 11, 2012

Google Apps Script

Added extra validation to the datasource URLs used in charts. Custom datasource URLs that rely on non-Google authentication will no longer work.

  • Issue 2100: ScriptProperties.setProperties() now respects the deleteAllOthers parameter.
  • Issue 2052: UiApp's setStyleAttribute() method no longer rejects certain style attributes.
  • Issue 2041: The native Date methods toLocaleDateString() and toLocaleTimeString() now return the correct values.
  • Issue 1972: Web apps published from a domain, but available to everyone, now use the normal Google login page instead of domain's login page.
  • Issue 1876: The authorize link for scripts embedded in a Google Sites gadget now opens in a new tab/window.
  • Issue 1870: CalendarEvent.getVisibility() now returns the correct value.
  • Issue 1528: Using ContactsApp to modify multiple fields of a contact in quick succession no longer causes an etags mismatch error.
  • Issue 1502: Logs are now saved correctly for scripts that run as a web app, from a spreadsheet menu, or due to a trigger.
  • Issue 1275: Deleting a script now deletes any associated triggers.

November 28, 2012

Google Apps Script
  • Added an enhancement to GmailApp to allow retrieval of bcc addresses via GmailMessage.getBcc().
  • Tree widgets now allow specifying open handlers as well as close handlers.
  • Fixed an issue where onFormSubmit trigger's callback range was incorrect if the submit triggered a formula recalculation.
  • Fixed an issue where XmlDocument properties and functions did not autocomplete when generating an XmlDocument with the Soap service.

November 21, 2012

Google Apps Script
  • Fixed an issue where public locks are not correctly released.
  • Fixed an issue to allow multiple comma-delimited replyTo addresses in MailApp.sendEmail().
  • Fixed an issue with auto-complete for library functions not working when that library contained HTML files.

November 13, 2012

Google Apps Script

Added the ability to disable SSL certificate validation in the SoapService, in response to a feature request.

  • Fixed an issue where MailApp's and GmailApp's sendEmail function ignored the advanced parameter name.
  • Fixed an issue where new library versions took a long time to propagate to other scripts.

November 06, 2012

Google Apps Script
  • Fixed an issue where a script failure notice would refer to the script as "Not Found" in cases where the failure is caused by an auth issue.
  • Fixed an issue where it was not possible to save scripts with more than ~1 million characters.
  • Fixed an issue where LockService did not work correctly when called from a UiApp.

Updated some icons to match icons of other Google Drive applications.

Added options to EmbeddedChartBuilder to make it easier to configure embedded charts. EmbeddedChartBuilder now contains the methods asAreaChart(), asBarChart(), asColumnChart(), asLineChart(), asPieChart(), asScatterChart() and asTableChart() as replacements for calls to setChartType().

October 26, 2012

Google Apps Script
  • Added the ability to list alternate sender addresses using GmailApp.getAliases() and use them in GmailApp.sendEmail() with the advanced option "from".
  • Created the class GmailAttachment, which is the same as a Blob but provides a getSize() method that isn't subject to quota restrictions.
  • Added the ability to set a custom app icon for web apps published to the Chrome Web Store. This is the icon that shows up on Chrome's New Tab Page. More information on the Publishing to the Chrome Web Store page.
  • Added the ability to close containing dialogs from HtmlService pages. More information on the Html Service page.
  • Improved JavaScript execution performance.
  • Removed the "File -> New -> From Script Template" option in the script editor.
  • Limited the ability to programmatically submit a form in JavaScript served by the HtmlService. Calling form.submit() is only allowed when done in the callback for a user-generated click or keypress event.
  • Fixed an issue where the DocsList service was unable to retrieve more than 2000 files. Several new methods were added to the DocsList class (getFilesForPaging, etc.) that use continuation tokens as described in the documentation.
  • Fixed an issue where placing a null value via data table's addRow method produced an error.
  • Fixed an issue where the debugger would throw an exception when using ScriptDb.
  • Fixed an issue where ScriptDb's saveBatch() method was returning the incorrect number of result objects.
  • Fixed an issue where UiApp's setStyleAttribute() method failed when using the attribute backgroundImage.
  • Fixed an issue where the last modified date for standalone wasn't updating.
  • Fixed an issue where GmailThread's moveToArchive() method wasn't working on threads in the trash.
  • Fixed an issue where ampersands in UiApp's Hidden widgets were being escaped incorrectly.
  • Fixed an issue where UiApp's validateOptions() method always threw an error.

September 28, 2012

Google Apps Script

Fixed an issue where certain files could not be copied via DocsList.copy().

September 21, 2012

Google Apps Script

Added a setLabelSeparator() method to CategoryFilterBuilder, to allow for label separator strings to be used.

Enabled SSL certificate validation for UrlFetchApp requests. If you wish to disable this behavior you can set the advanced option validateHttpsCertificates to "false".

Updated DocsList.getFilesByType() to accept values from the DocsList.FileType enumeration. Passing in string values for the document type is deprecated but still functional. (Issue 1755)

  • Fixed an issue where arrays retrieved from ScriptDb didn't behave properly.
  • Fixed an issue where the execution transcript would stop recording after Browser.msgBox() was called.
  • Fixed an issue where scriptlet tags in HtmlTemplates behaved strangely when in attribute values.
  • Fixed a problem that prevented scripts from sending POST requests to other scripts that used the ContentService.

September 07, 2012

Google Apps Script
  • Fixed an issue where selecting a value from a DateBox would cause the value changed handler to fire twice.
  • Fixed an issue where Chart dashboard StringFilters ignored the MatchType that was set.

Added an isDeleted() method to SitesApp's Page class.

August 30, 2012

Google Apps Script
  • Added methods to delete ScriptProperties and UserProperties. Additional methods were also added to set multiple properties, get all properties, etc.
  • Added a setOption method to the various chart builders to make it possible to set advanced options for Charts.

Fixed an issue with scrolling in the script editor so that line numbers will be displayed even when horizontally scrolling on long lines.

August 22, 2012

Google Apps Script
  • Fixed an issue where only one project was copied when making a copy of a Spreadsheet with multiple projects.
  • Fixed an issue where scripts were not installing properly from the Script Gallery.

August 20, 2012

Google Apps Script
  • Increased the allowed file upload size in web apps to 50MB, to match the limit in the DocsList service.
  • Streamlined the process for publishing web apps to the Chrome Web Store so that developers no longer need to manually verify web app URLs via Webmaster Central.
  • UiApp widgets now have a setStyleAttributes method which allow you to set multiple attributes at once.
  • Added a new log method to the Logger service which accepts a format string and a variable number of values to insert.
  • Fixed an issue where the DatePicker widget returned strange values for dates before 1970.
  • Fixed an issue where all day event series weren't scheduled correctly in certain timezones.
  • Fixed an issue that prevented an HTML form element from being set in a google.script.run callback.
  • Fixed an issue where embedded charts were returned with the wrong data type.
  • Fixed an issue where Charts ignored advanced parameters of data source URLs.

August 03, 2012

Google Apps Script

Added a getThumbnail() method to the DocsList service's File class.

  • Fixed an issue where the "parameter" field in the doGet() event argument was missing if no parameters were passed in the URL.
  • Fixed two issues where the DatePicker and DateBox UI components didn't have a setName() method, preventing them from being used as callback elements in UI apps.
  • Fixed an issue where the DatePicker part of a DateBox didn't inherit the z-index style.
  • Fixed an issue where HtmlTemplates could not be loaded within other templates.
  • Fixed an issue where users would receive "Summary of failures for Apps Script" error for a failed trigger, even after the script was deleted.
  • Fixed an issue where incorrect JsDoc comments in a library would prevent auto-complete from working on it.

July 26, 2012

Google Apps Script

Made improvements to the speed of handling large batches of data in ScriptDb.

  • Added support for chatting with script collaborators in the Script Editor. When two or more people are collaborating on a script, a chat panel will be visible on the right-hand side of the Script Editor.
  • Added the ability to support autocomplete for included libraries when they are included in development mode.
  • Added UiInstance.remove methods to remove widgets from UiInstance.
  • Added support for Google Analytics via the Analytics Service.
  • Fixed an error in the Gmail script template from the welcome screen.
  • Fixed an issue where saving an object in ScriptDb with an empty string key causes errors.
  • Fixed an issue where scripts were not being copied when a Site was copied.
  • Fixed an issue with DatePicker.setValue.

July 19, 2012

Google Apps Script

Fixed an issue where setting an empty key in Script Properties or User Properties resulted in a "Data storage error" message.

July 16, 2012

Google Apps Script

Fixed an issue where the script editor could not be accessed for some container-bound scripts.

Updated the link to the support page on the Google Apps Script Dashboard.

June 27, 2012

Google Apps Script

June 19, 2012

Google Apps Script

Added a scrollbar to the file panel in the Script Editor,

June 18, 2012

Google Apps Script
  • The Script Editor's user interface has been updated.
  • Publish > Publish as service is now Publish > Deploy as web app. Additionally, for new scripts, before you can deploy them as a web app, you must first save a version of the script. You can then choose which version should be served when the script is deployed as a web app. For existing scripts that were already published as a service, you will still be able to access the published URL from the Deploy as web app dialog, but to make additional changes, you will need to save a version of the script.

June 14, 2012

Google Apps Script

Fixed an issue where PDF documents uploaded and saved to Google Drive were being saved as blank files.

  • Added the ability to create, modify, and remove Embedded Charts in Google Sheets. Embedded Charts are charts that live solely within Spreadsheets and use multiple ranges of data for their datasource.
  • Added support to the Domain Service for NicknameManager and GroupsManager.

June 08, 2012

Google Apps Script

Simplified sharing settings for scripts. For new script projects, the script will inherit the permissions of its parent. For example, if a script is associated with a Spreadsheet, and user1@example.com has edit access to the Spreadsheet, then user1@example.com will have edit access to the script. The extra blue Share button will no longer be present on these newly created scripts, since the permissions are tied to those of the parent. For scripts created prior to June 8, 2012, the Share button will remain if the checkbox to "Allow document collaborators to edit project" or "Allow site collaborators and owners to edit project" was not selected for that script. For more information see Security. If you would like to have script source that cannot be modified by the editors of your Spreadsheet or Site, then you can use Script Libraries.

May 21, 2012

Google Apps Script

Fixed an issue with ClockTriggerBuilder.nearMinute, where invalid minute values were sometimes created.

  • Updated the Help > Support link in the Script Editor to point to this support page.
  • Set a limit of 20 triggers per script. This limit takes effect as of May 21. For scripts created prior to that date, which already have more than 20 triggers, they will keep the existing triggers, but cannot add new ones without removing existing triggers.

May 11, 2012

Google Apps Script
  • Fixed an issue with the debugger, so that it no longer fails when a breakpoint is set on certain classes from the JDBC service.
  • Fixed an issue with UiApp, so that modifying a spreadsheet cell from a submit handler no longer causes an empty file to be downloaded.

May 04, 2012

Google Apps Script

Launched the Google Apps Script Dashboard so that developers can view service health and quota limits.

Added a DocumentApp.HorizontalAlignment.JUSTIFY value to the DocumentApp.HorizontalAlignment enumeration.

  • Fixed an issue with Site.getOwners(), Site.getReaders(), Site.getEditors(), where the methods were failing in some cases.
  • Fixed an issue with ScriptApp.getService().getUrl() so that the method can be called by users other than just the script owner.
  • Fixed an issue with the Script Editor, where developers were prompted to recover a draft version of another file in the same project, rather than the one being edited.
  • Fixed an issue with resuming continuations (such as in a script that waits for user input via message box), so that the scripts correctly honor the 6 minute script execution limit.
  • Fixed an issue with UiApp.ClientHandler.setValue() so that it doesn't return errors and also works for checkboxes.

April 19, 2012

Google Apps Script
  • Items in the Help menu in the Script Editor now open in a new tab instead of a new window.
  • Made some modifications to the calculation of CPU time for scripts running on triggers, so that time spent waiting on certain processes is not counted toward that limi

April 16, 2012

Google Apps Script
  • Fixed an issue in the Script Editor where the debugger would not terminate after executing the last statement of a script.
  • Fixed an issue where an embedded image would not copy properly in a Google Document.
  • Fixed an issue where a shared folder would not show up in "Collections shared with me".
  • Increased the size of the files that can be created via DocsListApp.createFile() from 2MB to 50MB.
  • Increased the allowed argument value for Utilities.sleep() from 5000 (5 seconds) to 300000 (5 minutes).
  • Updated the script failure notification emails to include the name and a link of the spreadsheet that contains the failed script in response to this issue
  • Increased the allowed attachment size for emails sent via GmailApp and MailApp from 5MB to 25MB.
  • Added method to DocsList service to getRootFolder().
  • Added method to File and Folder classes to check whether the item isTrashed().

April 11, 2012

Google Apps Script

Fixed an issue where files and collections in Google Docs could not be shared with groups.

April 04, 2012

Google Apps Script

Launched the Script service in response to this feature request, which allows developers to programmatically set triggers and manage the publishing of scripts as a service.

Modified document collaboration and sharing rules to make them consistent with what is possible in the user interface.

March 20, 2012

Google Apps Script

Fixed an issue where Spreadsheet.insertSheet() failed to properly copy a sheet when given a {template:sheet_obj} parameter.

March 13, 2012

Google Apps Script
  • Fixed an issue where functions in the Utilities Service were not handling UTF-8 strings correctly.
  • Fixed an issue where text in a ListBox widget was being unnecessarily HTML-encoded.
  • Fixed an issue where Anchor.setWordWrap() was throwing errors.
  • Fixed an issue with UiApp panels that launch from a Google Spreadsheet, where the X to close was not displaying if the title of the application was not set.
  • Fixed an issue in the GUI Builder where setting the visibility for a widget to false was not working.

Added the ability to set the subject line via the subject field in the advanced arguments for GmailMessage.forward().

March 07, 2012

Google Apps Script
  • Added documentation for DocsListDialog. "Unexpected error" is no longer thrown when trying to display it.
  • The Script Editor's menus have been updated:
    • A new Resources menu is added.
    • The Share menu is renamed to Publish.
    • Triggers' management is moved to Resources menu.
    • Google API Services console is moved to Resources menu.
    • Links under the Help menu now open in a new tab rather than a new window in Firefox 9.x and Chrome.
  • Changed the window that appears after Authorization to the script has been granted. It is now displayed in a new tab rather than a pop-up. This tab will no longer close automatically after 5 seconds.
  • Updated the appearance of the warning bar that is displayed when running a script that is published as a service by a user other than the owner, in response to this issue.
  • Added the ability to set the target for an Anchor in UI app, in response to this issue.
  • Added the ability to include a limited set of HTML tags when working with UiApp widgets, in response to this issue. Here is the list of HTML tags that are permitted: B, BLOCKQUOTE, BODY, BR, CENTER, CAPTION, CITE, CODE, DIV, EM, H1, H2, H3, H4, H5, H6, HR, I, LABEL, LEGEND, LI, OL, P, SPAN, STRONG, SUB, SUP, TABLE, TBODY, TD, THEAD, TITLE, TR, TT, UL
  • Added support for sheet protection, in reference to this issue. Introduced two new methods: Sheet.getSheetProtection and Sheet.setSheetProtection, as well as a new PageProtection class.

February 12, 2012

Google Apps Script
  • Fixed an issue with using tab key to format code in the script editor.
  • Fixed an issue where email quotas were too restrictive when executed by an anonymous user from a script running as a service.

February 06, 2012

Google Apps Script

January 31, 2012

Google Apps Script

Fixed an issue where Anchor.setWordWrap() was not working.

January 24, 2012

Google Apps Script
  • Fixed some issues where autocomplete stopped working after certain statements were typed in the script editor.
  • Fixed an issue with the sizing of images when using Document.appendImage().
  • Fixed an issue where an error occurred when opening a document after the Document.saveAndClose() method had previously been called.

January 11, 2012

Google Apps Script

Fixed an issue with Paragraph.setHeading() where text was not formatted as expected.

December 14, 2011

Google Apps Script

Fixed an issue with the debugger, where it would close when stepping into a function that is located in a different file.

November 07, 2011

Google Apps Script
  • Fixed an issue with Session.getTimezone() returning incorrect values.
  • Fixed an issue with the Edit > Find feature in the script editor.

September 26, 2011

Google Apps Script

Fixed an issue where an error occurred if an empty ListBox was used as a callback element.

  • Added support for inlineImages when sending emails with MailApp.sendEmail().
  • Added the Charts Services, which allow users to dynamically create charts and embed them in emails, UiApp, or export them as images.
  • Added the Prediction Services, which allow users to access a cloud hosted machine learning service that makes it easy to build smart apps. Added the Tasks Services, which allow users to manage tasks and task lists. Added the UrlShortener Services, which let you create, inspect, and manage goo.gl short URLs.

August 04, 2011

Google Apps Script

Added support for ScrollPanel to the GUI Builder.

July 25, 2011

Google Apps Script

Added supports for projects in Apps Script.

Fixed an issue where Xml.element failed if the child elements were XmlElements.

July 14, 2011

Google Apps Script

Fixed an issue where GmailApp.getUserLabelByName() failed for label names that contained spaces.

May 04, 2011

Google Apps Script

April 15, 2011

Google Apps Script

Fixed an issue with UiApp.getActiveApplication().setStyleAttribute() for 'cursor.'

Added an appendRow() method to Spreadsheet.

March 21, 2011

Google Apps Script
  • Improved performance of the script editor. The editor can now handle large scripts without any issues in most major browsers.
  • Improved the internal error handling of the Spreadsheet Service, so that fewer errors are received by users.
  • Increased the timeout of UrlFetch to 30 seconds.
  • Fixed a minor bug Script as a Service related to expired tokens.
  • Breakpoint in debugger now clears as expected.
  • SpreadsheetApp.getActiveSheet() when executed in Installable onEdit returns the correct sheet name.
  • Binary files can be uploaded using FileUpload.
  • Enhanced ListBox to function as a multi-select ListBox.

March 08, 2011

Google Apps Script

Added a method in Utilities class that parses CSV text.

  • Fixed an issue which improves performance of various Services.
  • Fixed an issue with Authorization of scripts.

January 21, 2011

Google Apps Script

Introducing the Debugger! The debugger significantly enhances the ability of Apps Script users to debug their scripts. With the debugger, users can set breakpoints, inspect variables, step-in and step-out of functions.

October 21, 2010

Google Apps Script

Added integration with Google Sites, so that Apps Script can now be run from within Google Sites. Read more here.

October 16, 2010

Google Apps Script

September 17, 2010

Google Apps Script
  • Fixed two issues with Calendar.getEvents(). GetEvents previously returned only the first instance of a recurring event in a given time range. Now it returns all instances of the recurring event in the given time range. Additionally, editing the instance of the recurring event previously would edit the entire series. Now, editing an instance of a recurring event edits only the particular instance.
  • Fixed an issue where the unpublished version of onInstall was being run for scripts in the Script Gallery.
  • Fixed an issue where users could not type ( in the script editor when the autocomplete popup was visible.
  • Fixed an issue where getActiveSheet was not working when called from onEdit events. Fixed an issue with UiApp where the UI panels were not displayed properly and an "Error encountered: An unexpected error occurred" error message was displayed.

August 16, 2010

Google Apps Script
  • Added Spreadsheet.show() to the script editor autocomplete and the documentation.
  • Clarified the use of Session.getUser() and added two new methods: Session.getActiveUser() and Session.getEffectiveUser().
  • Added support for persistent storage in scripts via UserProperties and ScriptProperties. Script Properties and User Properties are also available from File > Properties in the script editor.
  • Added several new methods to the Contact class: Contact.getGivenName(), Contact.setGivenName(), Contact.getMiddleName(), Contact.setMiddleName(), Contact.getFamilyName(), Contact.setFamilyName(), Contact.getMaidenName(), Contact.setMaidenName(), Contact.getNickname(), Contact.setNickname().
  • Major improvements to the Sites service, fixing many issues and adding new functionality.
  • Added support for find and replace in the script editor.
  • UiApp is now available to all users. Previously, it was only available to Google Apps Premier domains.
  • The timezone for a script can now be set from File > Properties in the script editor.
  • The user interface for time-based triggers has been updated to make it more clear that the events are triggered between N and N+1 hours.
  • The script timezone is now visible in the script triggers dialog.
  • Revision history for scripts is now available from File > See revision history in the script editor.
  • Added two new methods to the Utilities class provide JSON support: Utilities.jsonParse() and Utilities.jsonStringify().
  • Added support for outbound OAuth requests. See UrlFetchApp.addOAuthService().
  • Added a new method to class Spreadsheet to get the form URL: Spreadsheet.getFormUrl().
  • Added a new Blob class to simplify moving data between different Google Apps Script services.

August 01, 2010

Google Apps Script

Fixed an issue with the Sheet.getFrozenRows, where an error was returned in some cases.

  • Added two new methods to the Sheet class for getting frozen rows and columns: Sheet.getFrozenRows() and Sheet.getFrozenColumns().
  • Added sorting methods: Sheet.sort() and Range.sort().
  • Added methods to get row height and column width in a Sheet: Sheet.getRowHeight() and Sheet.getColumnWidth().

July 12, 2010

Google Apps Script

Line numbers in error messages are now denoted with (line nnn), rather than (# nnn), where nnn is the line number.

  • Fixed an issue with the Contacts service, where a 'Mismatch: etags' error was thrown when a contact was modified more than once.
  • Fixed an issue where a popup dialog with the text "Error encountered: An unexpected error occurred" was displayed when the change handler for a ListBox was called, but no app was returned by the change handler.
  • Fixed an issue where ListBox.addItem wasn't working after calling getElementById.
  • Fixed an issue with Utilities.formatDate, where it was previously always formatting the date into GMT.
  • Added two new methods to the Soap service for setting and getting the SOAP endpoint: WsdlService.getEndpointOverride() and WsdlService.setEndpointOverride().
  • Added a method to check if there is remaining quota for sending emails for the current day: MailApp.getRemainingDailyQuota().