Skip to main content
Google Super logo
  • Category: file management & storage
  • Auth: OAUTH2, API_KEY
  • Composio-managed OAuth available? Yes
  • Tools: 559
  • Triggers: 48
  • Slug: GOOGLESUPER
  • Version: 20261103_00

Frequently Asked Questions

For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see How to create OAuth2 credentials for Google Apps.
Google Super requires broad Google Workspace scopes for some cross-product workflows, and some of those scopes are not available on Composio-managed Google Super auth today. If users see Google’s “App is blocked” or unverified-app screen with managed Google Super auth, use your own verified Google OAuth app and reconnect through a custom auth config.Composio is working on getting the managed Google Super app approved for the needed scopes, but until that is complete, custom Google OAuth is the workaround for production usage. See How to create OAuth2 credentials for Google Apps.
When using custom OAuth credentials, the required Google API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.
The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the Google OAuth scopes docs. If you’re creating auth configs programmatically, see the programmatic auth config guide.

Tools

Slug: GOOGLESUPER_ACL_DELETEDeletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain.

Input Parameters

string
required
ACL rule identifier.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ACL_GETRetrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain.

Input Parameters

string
required
ACL rule identifier. Format: ‘scope_type:scope_value’ or ‘default’. Valid scope types: ‘user’ (email), ‘group’ (group email), ‘domain’ (domain name), ‘default’ (public access). Examples: ‘user:john@example.com’, ‘group:team@example.com’, ‘domain:example.com’, ‘default’. Note: ‘me’ is NOT valid; use actual email/domain. The rule must exist - use GOOGLECALENDAR_LIST_ACL_RULES to find valid IDs.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ACL_INSERTCreates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain.

Input Parameters

string ("none" | "freeBusyReader" | "reader" | "writer" | "owner")
required
The role assigned to the scope. Possible values: “none” - Provides no access; “freeBusyReader” - Provides read access to free/busy information; “reader” - Provides read access to the calendar; “writer” - Provides read and write access to the calendar; “owner” - Provides ownership of the calendar.
object
required
The extent to which calendar access is granted by this ACL rule. Specifies who gets the access (user, group, domain, or default).
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
boolean
Whether to send notifications about the calendar sharing change. Optional. The default is true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ACL_LISTRetrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary ‘rule_id’ values required for updating specific ACL rules.

Input Parameters

string
Token specifying which result page to return. Optional.
string
Token obtained from the nextSyncToken field returned on the last page of a previous list operation. It makes the result of this list operation contain only entries that have changed since then. Optional. The default is to retrieve all entries.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
integer
Maximum number of entries returned on one result page. Optional. The default is 100.
boolean
Whether to include deleted ACLs in the result. Optional. The default is False.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ACL_PATCHPartially updates the role or scope of an existing Google Calendar access control rule. Provide at least one of role or scope; you can also choose whether to send sharing notifications. This operation modifies an existing rule rather than creating one.

Input Parameters

string
The role assigned to the scope. Possible values are: “none” - Provides no access; “freeBusyReader” - Provides read access to free/busy information; “reader” - Provides read access to the calendar (private events appear but details are hidden); “writer” - Provides read and write access to the calendar (private events and details are visible); “owner” - Provides ownership of the calendar (all permissions of writer plus ability to see and manipulate ACLs).
object
The extent to which calendar access is granted by this ACL rule. Optional for patch operations. Must include type (one of: ‘user’, ‘group’, ‘domain’, ‘default’) and value (email address or domain name) for all types except ‘default’.
string
required
ACL rule identifier of an existing rule. IMPORTANT: The rule must already exist on the calendar - this action cannot create new rules, only modify existing ones. Use the ACL list action to find existing rule IDs, or use the ACL insert action to create a new rule first. Format: ‘type:value’, such as ‘user:email@example.com’ or ‘group:group@example.com’.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
boolean
Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ACL_UPDATEUpdates an access control rule for the specified calendar.

Input Parameters

string
required
The role assigned to the scope. Possible values are: - “none” - Provides no access. - “freeBusyReader” - Provides read access to free/busy information. - “reader” - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - “writer” - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. - “owner” - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to see and manipulate ACLs.
string
required
ACL rule identifier.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
boolean
Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ACL_WATCHTool to watch for changes to ACL resources. Use when you need to set up real-time notifications for access control list modifications on a calendar.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel.
string
The type of delivery mechanism used for this channel. Valid values are “web_hook” or “webhook”.
string
An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
object
Additional parameters controlling delivery channel behavior. Optional.
string
required
The address where notifications are delivered for this channel.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ADD_ENRICHMENTAdds a text, location, or map enrichment at a specified position in a Google Photos album created by this app.

Input Parameters

string
required
Identifier of the album where the enrichment is to be added
object
required
Position in the album where the enrichment is to be inserted. Required field with valid position types: FIRST_IN_ALBUM, LAST_IN_ALBUM, AFTER_MEDIA_ITEM (requires relativeMediaItemId), AFTER_ENRICHMENT_ITEM (requires relativeEnrichmentItemId)
object
required
The enrichment to be added, can be a text, location, or map enrichment

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ADD_FILE_SHARING_PREFERENCEDEPRECATED: Use GOOGLEDRIVE_CREATE_PERMISSION instead; use GOOGLEDRIVE_UPDATE_PERMISSION to modify existing permissions (avoids duplicate entries). Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or ‘anyone’. Bulk calls may trigger 403 rateLimitExceeded (~100 req/100s/user); use jittered exponential backoff.

Input Parameters

string ("owner" | "organizer" | "fileOrganizer" | "writer" | "commenter" | "reader")
required
Permission role to grant. Accepted values: ‘reader’, ‘commenter’, ‘writer’, ‘fileOrganizer’, ‘organizer’, ‘owner’. Invalid strings cause validation failures.
string ("user" | "group" | "domain" | "anyone")
required
Type of grantee for the permission. Using ‘anyone’ with ‘writer’ or ‘owner’ broadly exposes the document — confirm before applying. Admin policies may block ‘anyone’ or domain-wide sharing. For type=‘anyone’ with role=‘reader’, the link must be explicitly shared; files are not publicly searchable.
string
Domain to grant permission to (e.g., ‘example.com’). Required if ‘type’ is ‘domain’.
string
required
Unique identifier of the file to update sharing settings for. Must be an alphanumeric string containing only letters, numbers, hyphens, and underscores (no slashes, spaces, or other special characters). Use GOOGLEDRIVE_FIND_FILE or GOOGLEDRIVE_LIST_FILES to get valid file IDs from your Google Drive. For shared drive membership, supply the shared drive ID, not an individual document ID.
string
Email address of the user or group. Required if ‘type’ is ‘user’ or ‘group’.
boolean
Whether to transfer ownership to the specified user. Required when role is ‘owner’. Only a single user can be specified in the request when transferring ownership. Ownership transfer is difficult to reverse — obtain explicit confirmation before setting true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ADD_LABEL_TO_EMAILAdds and/or removes specified Gmail labels for a message; ensure message_id and all label_ids are valid (use ‘listLabels’ for custom label IDs).

Input Parameters

string
User’s email address or ‘me’ for the authenticated user.
string
required
Immutable ID of the message to modify. Gmail message IDs are hexadecimal strings (e.g., ‘1a2b3c4d5e6f7890’). IMPORTANT: Do NOT use UUIDs (32-character strings like ‘093ca4662b214d5eba8f4ceeaad63433’), thread IDs, or internal system IDs - these will cause ‘Invalid id value’ errors. Obtain valid message IDs from: (1) ‘GMAIL_FETCH_EMAILS’ response ‘messageId’ field, (2) ‘GMAIL_FETCH_MESSAGE_BY_THREAD_ID’ response, or (3) ‘GMAIL_LIST_THREADS’ and then fetching thread messages.
array
Label IDs to add (IDs, not display names). System labels: INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, CATEGORY_PERSONAL, CATEGORY_SOCIAL, CATEGORY_PROMOTIONS, CATEGORY_UPDATES, CATEGORY_FORUMS. Use full CATEGORY_ prefix (e.g., ‘CATEGORY_UPDATES’ not ‘UPDATES’). Custom labels: call ‘listLabels’ first to get the ID (format: ‘Label_<number>’). Do NOT use the label display name; the API requires the ID. SENT, DRAFT, CHAT are immutable and cannot be added or removed. A label cannot appear in both add_label_ids and remove_label_ids.
array
Label IDs to remove (IDs, not display names). System labels: INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, CATEGORY_PERSONAL, CATEGORY_SOCIAL, CATEGORY_PROMOTIONS, CATEGORY_UPDATES, CATEGORY_FORUMS. Use full CATEGORY_ prefix (e.g., ‘CATEGORY_UPDATES’ not ‘UPDATES’). Custom labels: call ‘listLabels’ first to get the ID (format: ‘Label_<number>’). SENT, DRAFT, CHAT are immutable and cannot be removed. Common operations: to mark as read, remove ‘UNREAD’; to archive, remove ‘INBOX’. A label cannot appear in both add_label_ids and remove_label_ids.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ADD_OR_REMOVE_TO_CUSTOMER_LISTSubmit email contacts for addition to or removal from a Google Ads Customer Match list through an asynchronous offline user data job, marking ad user data and personalization consent as granted. The returned status does not confirm processing completion.

Input Parameters

array
required
Array of emails of contacts to add to or remove from the customer list. Emails must be valid, normalized strings (lowercase, trimmed); malformed addresses reduce match rates.
string ("create" | "remove")
Operation to perform on the customer list (UserList/audience list). Either create or remove.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
string
required
Resource name of the customer list (UserList/audience list), not an account. For example: customers/1234567890/userLists/1234567890. For account-owned resources, use the same customer ID as the tool call’s customer_id; in MCC workflows, this is the child/sub-account ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ADD_PARENTTool to add a parent folder for a file using Google Drive API v2. Use when you need to add a file to an additional folder.

Input Parameters

string
required
The ID of the parent folder to add. This is the folder that will become a parent of the file.
string
required
The ID of the file to add a parent folder to.
boolean
Whether the requesting application supports both My Drives and shared drives. Default is false.
boolean
Deprecated: Use supportsAllDrives instead.
boolean
Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ADD_PROPERTYTool to add a property to a file, or update it if it already exists (v2 API). Use when you need to attach custom key-value metadata to a Google Drive file.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format values.
string
Selector specifying which fields to include in a partial response.
string
required
The ID of the file.
string
JSONP callback function name.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string ("PRIVATE" | "PUBLIC")
Property visibility values.
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
required
The key of this property.
string
required
The value of this property.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ADD_SHEETAdd a GRID sheet with rows and columns to an existing spreadsheet. This action does not create chart-only or DATA_SOURCE sheets. Use properties to configure the GRID sheet’s dimensions, tab color, position, visibility, and text direction. Notes: - Sheet names must be unique; use forceUnique=true to auto-append suffix (_2, _3) if name exists - For tab colors, use EITHER rgbColor OR themeColor, not both - Avoid ‘index’ when creating sheets in parallel (causes errors)

Input Parameters

string
The name for the new sheet tab. Must be unique within the spreadsheet. Example: “Q3 Report”, “Sales Data 2025”. This is a convenience parameter - alternatively, you can set this via properties.title. Note: sheet_name is also accepted as an alias for title.
object
Advanced GRID sheet properties such as dimensions, tab color, position, visibility, and text direction. For simple cases, use the title parameter directly.
boolean
When True (default), automatically ensures the sheet name is unique by appending a numeric suffix (e.g., ‘_2’, ‘_3’) if the requested name already exists. This makes the action resilient to retries and parallel workflows. When False, the action fails with an error if a sheet with the same name already exists.
string
required
REQUIRED. Cannot be empty. The ID of the target spreadsheet where the new sheet will be added. This is the long alphanumeric string in the Google Sheet URL (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’). Use ‘Search Spreadsheets’ action to find the spreadsheet ID by name if you don’t have it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_AGGREGATE_COLUMN_DATAAggregates data from a column in a Google Sheet, either across all rows or rows matching column-value filters. Supports sum, average, count, minimum, maximum, and percentage.

Input Parameters

string ("sum" | "average" | "count" | "min" | "max" | "percentage")
required
The mathematical operation to perform on the target column values.
string
required
The name of the specific sheet within the spreadsheet. Matching is case-insensitive. If no exact match is found, partial matches will be attempted (e.g., ‘overview’ will match ‘Overview 2025’).
string
The exact value to search for in the search column. Case-sensitive by default. If not provided (or if search_column is not provided), all rows in the target column will be aggregated without filtering.
string
The column to search in for filtering rows. Can be a letter (e.g., ‘A’, ‘B’) or column name from header row (e.g., ‘Region’, ‘Department’). If not provided, all rows in the target column will be aggregated without filtering.
string
required
The column to aggregate data from. Can be a letter (e.g., ‘C’, ‘D’) or column name from header row (e.g., ‘Sales’, ‘Revenue’).
boolean
Whether the search should be case-sensitive.
boolean
Whether the first row contains column headers. If True, column names can be used for search_column and target_column.
string
required
The unique identifier of the Google Sheets spreadsheet.
number
For percentage operation, the total value to calculate percentage against. If not provided, uses sum of all values in target column.
array
Extra column=value conditions applied with AND logic on top of search_column/search_value. Use this to filter on multiple columns simultaneously. Example: [{“column”: “Region”, “value”: “APAC”}] combined with search_column=Product/search_value=Beacon returns only rows where Product=Beacon AND Region=APAC.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_APPEND_DIMENSIONTool to append new rows or columns to a sheet, increasing its size. Use when you need to add empty rows or columns to an existing sheet.

Input Parameters

integer
required
The number of rows or columns to append.
integer
required
The numeric ID of the sheet (not the sheet name). This is a non-negative integer found in the sheet’s URL as the ‘gid’ parameter (e.g., gid=0) or in the sheet properties. The first sheet in a spreadsheet typically has sheet_id=0.
string ("ROWS" | "COLUMNS")
required
Specifies whether to append rows or columns.
string
required
The ID of the spreadsheet.
array
Limits the ranges of the spreadsheet to include in the response.
boolean
True if grid data should be included in the response (if includeSpreadsheetInResponse is true).
boolean
True if the updated spreadsheet should be included in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_ARCHIVE_CUSTOM_DIMENSIONTool to archive a CustomDimension on a property. Use when you need to remove a custom dimension from active use without permanently deleting it. Archived dimensions cannot be used in new reports.

Input Parameters

string
required
Required. The resource name of the CustomDimension to archive. Must be in the exact format: properties/{property_id}/customDimensions/{dimension_id} where property_id and dimension_id are numeric identifiers. IMPORTANT: Must start with ‘properties/’ prefix, contain ‘/customDimensions/’ in the middle, have no trailing slashes, and no additional path segments. Valid example: ‘properties/489591273/customDimensions/13661259421’. Invalid examples: ‘489591273/13661259421’ (missing prefix), ‘properties/489591273/customDimensions/13661259421/’ (trailing slash), ‘properties/489591273/customDimensions/13661259421/extra’ (extra segments)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_AUTOCOMPLETEReturns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches. Returns up to five predictions ordered by relevance.

Input Parameters

string
required
Text string to search for place predictions. Can be full words, substrings, place names, addresses, or plus codes. Must be non-empty.
object
Latitude/longitude point for distance calculations.
string
Region code in ccTLD format for formatting responses (e.g., ‘us’, ‘br’).
integer
Zero-based Unicode character offset of cursor position in the input string.
string
Preferred language for results using IETF BCP-47 language codes (e.g., ‘en-US’, ‘es-ES’).
object
Area to bias search results toward.
string
User-generated string grouping calls into sessions for billing purposes.
array
Up to 15 two-character country codes (ISO 3166-1 Alpha-2) to restrict results. Query predictions unavailable when this is set.
object
Area to restrict search results within.
array
Restricts results to up to five specified primary types (e.g., ‘restaurant’, ‘cafe’).
boolean
Includes query predictions in response for text searches (default: false).
boolean
Includes businesses without physical locations (default: false).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_AUTO_RESIZE_DIMENSIONSAuto-fit column widths or row heights for a dimension range using batchUpdate.autoResizeDimensions. Use when you need to automatically adjust row heights or column widths to fit content after writing data.

Input Parameters

integer
The numeric ID of the sheet to resize. Either sheet_id or sheet_name must be provided. If both are provided, sheet_name takes precedence and will be resolved to sheet_id.
string ("ROWS" | "COLUMNS")
required
The dimension to auto-resize. Use ‘ROWS’ to auto-fit row heights or ‘COLUMNS’ to auto-fit column widths.
integer
required
The zero-based end index of the dimension range to resize (exclusive). Must be greater than start_index. For example, to resize columns A-C, use start_index=0 and end_index=3.
string
The name of the sheet to resize. Either sheet_id or sheet_name must be provided. Using sheet_name is recommended as it’s more intuitive. If both sheet_id and sheet_name are provided, sheet_name takes precedence.
integer
required
The zero-based start index of the dimension range to resize (inclusive). For columns, 0 = column A. For rows, 0 = row 1.
string
required
The ID of the spreadsheet containing the sheet to resize.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_ADD_MEDIA_ITEMSAdds one or more app-created media items to an app-created Google Photos album.

Input Parameters

string
required
Identifier of the Album that the media items are added to. Must be an album created by this application.
array
required
Identifiers of the MediaItems to be added. Maximum 50 items. Media items must be created by this application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_CLEAR_VALUES_BY_DATA_FILTERClears one or more ranges of values from a spreadsheet using data filters. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared — all other properties of the cell (such as formatting, data validation, etc..) are kept.

Input Parameters

array
required
The DataFilters used to determine which ranges to clear.
string
required
The ID of the spreadsheet to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_CREATE_MEDIA_ITEMSUploads and creates up to 50 Google Photos media items from public URLs or uploaded files, optionally placing them at a specific position in an app-created album. Creating media requires the photoslibrary.appendonly authorization scope, which is not included in the toolkit’s default scopes.

Input Parameters

array
Simplified input: List of public URLs of media files to upload. File names will be extracted from URLs automatically. Use ‘media_files’ for more control over file names and descriptions.
array
List of files to upload to Google Photos.
string
Optional identifier of the album where the media items are to be added. If not specified, media items are added to the user’s library only.
array
List of media files to upload. Each item can specify either a ‘url’ (public URL) or a ‘file’ (FileUploadable object). Maximum 50 items per request.
object
Position in the album to add the media items.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_DELETE_MESSAGESPermanently deletes multiple Gmail messages by ID, bypassing Trash. A successful request does not confirm individual messages existed or were deleted.

Input Parameters

string
User’s email address or ‘me’ for the authenticated user.
array
required
List of Gmail message IDs to delete. Each ID must be a hexadecimal string (e.g., ‘18c5f5d1a2b3c4d5’). Obtain IDs from actions like GMAIL_FETCH_EMAILS or GMAIL_LIST_THREADS - do not use human-readable descriptions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_EVENTSExecute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results. Use this to materially reduce round-trips for bulk operations like migrations, cleanup, or large-scale updates.

Input Parameters

boolean
If true, stop processing after the first batch containing any 4xx error (except 404 on DELETE). Default is false.
array
required
List of batch operations to execute. Maximum 1000 operations per request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_EXECUTEExecutes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results. Use this to reduce LLM tool invocations when performing bulk operations like updating many tasks, moving tasks, or deleting multiple items. Note: Each sub-request still counts toward API quota; batching primarily reduces HTTP overhead and tool call count.

Input Parameters

array
required
Array of sub-requests to execute in this batch. Each sub-request is independent and will return its own result.
integer
Maximum number of sub-requests allowed in a single batch. Google’s typical cap is 1000. Lower values can control response size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_GETRetrieves values from specified cell ranges in a Google Spreadsheet. If ranges are omitted or empty after filtering blank entries, it retrieves data from the first sheet.

Input Parameters

array
A list of cell ranges in A1 notation from which to retrieve data. If this list is omitted, empty, or contains only empty strings, all data from the first sheet of the spreadsheet will be fetched. Empty strings in the list are automatically filtered out. Supported formats: (1) Bare sheet name like ‘Sheet1’ to get all data from that sheet, (2) Sheet with range like ‘Sheet1!A1:B2’, (3) Just cell reference like ‘A1:B2’ (uses first sheet). For sheet names with spaces or special characters, enclose in single quotes (e.g., “‘My Sheet’” or “‘My Sheet’!A1:B2”). IMPORTANT: For large sheets, always use bounded ranges with explicit row limits (e.g., ‘Sheet1!A1:Z10000’ instead of ‘Sheet1!A:Z’). Unbounded column ranges like ‘A:Z’ on sheets with >10,000 rows may cause timeouts or errors. If you need all data from a large sheet, fetch in chunks of 10,000 rows at a time.
string ("DIMENSION_UNSPECIFIED" | "ROWS" | "COLUMNS")
The major dimension for organizing data in results.
string
required
The unique identifier of the Google Spreadsheet from which data will be retrieved. This is the ID found in the spreadsheet URL after /d/. You can provide either the spreadsheet ID directly or a full Google Sheets URL (the ID will be extracted automatically).
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How values should be rendered in the output. FORMATTED_VALUE: Values are calculated and formatted (default). UNFORMATTED_VALUE: Values are calculated but not formatted. FORMULA: Values are not calculated; the formula is returned instead.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How dates and times should be rendered in the output. SERIAL_NUMBER: Dates are returned as serial numbers (default). FORMATTED_STRING: Dates returned as formatted strings.
boolean
Indicates whether empty strings were filtered from the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_GET_MEDIA_ITEMSReturns app-created Google Photos media items for the specified media item identifiers.

Input Parameters

array
required
Identifiers of the media items to be requested. Must not contain duplicates.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_GET_SPREADSHEET_VALUESRead multiple explicit ranges from one Google Spreadsheet in one request.

Input Parameters

array
required
One or more explicit A1 or R1C1 ranges to read, in request order. Every range must be nonblank. Use bounded ranges such as ‘Sheet1!A1:D1000’ for predictable response sizes.
string
required
The Google Spreadsheet ID from its URL.
string ("ROWS" | "COLUMNS")
Whether returned values are organized by rows or columns.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How cell values are rendered in the response.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How dates, times, and durations are rendered when values are not formatted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_MODIFY_MESSAGESAdds or removes labels on up to 1,000 Gmail messages in one request, supporting operations such as archiving and marking messages read or unread. A successful response confirms request acceptance, not individual message status.

Input Parameters

string
User’s email address or ‘me’ for the authenticated user.
array
required
List of message IDs to modify. Maximum 1,000 message IDs per request. Get message IDs from GMAIL_FETCH_EMAILS or GMAIL_LIST_THREADS actions. Accepts ‘messageIds’, ‘ids’, or ‘message_ids’ as the parameter name.
array
List of label IDs to add to the messages. IMPORTANT: Use label IDs, NOT label display names. System labels use their name as ID: INBOX, STARRED, IMPORTANT, SENT, DRAFT, SPAM, TRASH, UNREAD, CATEGORY_PERSONAL, CATEGORY_SOCIAL, CATEGORY_PROMOTIONS, CATEGORY_UPDATES, CATEGORY_FORUMS. Custom labels MUST use their ID (format: ‘Label_XXX’, e.g., ‘Label_1’, ‘Label_25’), NOT the display name (e.g., do NOT use ‘Work’ or ‘Projects’). Call GMAIL_LIST_LABELS first to get the ‘id’ field for custom labels. At least one of add_label_ids or remove_label_ids must be provided. CONSTRAINT: Label IDs must NOT overlap with remove_label_ids - cannot add and remove the same label.
array
List of label IDs to remove from the messages. IMPORTANT: Use label IDs, NOT label display names. System labels use their name as ID: INBOX, STARRED, IMPORTANT, SENT, SPAM, TRASH, UNREAD. Custom labels MUST use their ID (format: ‘Label_XXX’, e.g., ‘Label_1’, ‘Label_25’), NOT the display name (e.g., do NOT use ‘Work’ or ‘Projects’). Call GMAIL_LIST_LABELS first to get the ‘id’ field for custom labels. Common use cases: Remove ‘UNREAD’ to mark as read, remove ‘INBOX’ to archive. Note: ‘DRAFT’ cannot be removed - use GMAIL_DELETE_DRAFT instead. At least one of add_label_ids or remove_label_ids must be provided. CONSTRAINT: Label IDs must NOT overlap with add_label_ids - cannot add and remove the same label.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_MUTATECreate, update, remove, or act on supported Google Ads resource types in one request. With partial_failure=false (the default), all operations are atomic and execute only if every operation is valid. With partial_failure=true, valid operations execute independently while invalid operations return errors. Use negative temporary resource IDs to connect resources created in the same request. Remove operations are destructive.

Input Parameters

string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If false (the default), all operations are atomic: they are carried out in one transaction only when every operation is valid. If true, valid operations are carried out independently while invalid operations return errors in partial_failure_error.
array
required
Cross-resource operations. Each item must contain exactly one official operation family, such as campaign_operation or campaign_budget_operation, whose value is the provider operation body.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls response content for a cross-resource mutate request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_RUN_PIVOT_REPORTSTool to return multiple pivot reports in a batch for a GA4 property. Use when you need to fetch multiple pivot table reports with multi-dimensional analysis in a single request.

Input Parameters

string
required
Required. The GA4 property resource name. Format: properties/{property_id}
array
required
Required. Up to 5 individual RunPivotReportRequest objects. Each request can have dimensions, metrics, dateRanges, pivots, dimensionFilter, metricFilter, currencyCode, cohortSpec, keepEmptyRows, returnPropertyQuota, and comparisons fields. CRITICAL CONSTRAINT: Every dimension defined in ‘dimensions’ MUST be used in at least one of: pivots (fieldNames), dimensionFilter, or orderBys. Dimensions not used anywhere will cause a 400 error. The only exception is ‘dateRange’ dimensions. Additionally, all fieldNames in pivots must reference dimensions defined in the request’s ‘dimensions’ array, and no two pivots can share the same dimension.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_RUN_REPORTSRuns multiple analytics data reports for one GA4 property in a single request. Report metadata returned by this tool does not include data truncation reasons.

Input Parameters

string
required
Required. The property resource name. Format: properties/{property_id}
array
required
Required. Up to 5 individual RunReportRequest objects (minimum 1, maximum 5). CRITICAL: Non-cohort requests MUST contain ‘dateRanges’ (list of {startDate, endDate}); cohort requests (containing ‘cohortSpec’) must NOT include ‘dateRanges’. Key fields per request: dateRanges, dimensions (list of {name}), metrics (list of {name}), dimensionFilter/metricFilter (FilterExpression: use andGroup/orGroup/notExpression/filter at top level), cohortSpec, offset, limit, orderBys, keepEmptyRows. NOTE: Do NOT include ‘pivots’ field - use batchRunPivotReports action for pivot reports.
array
Internal field to track which filters were unwrapped during validation

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_UPDATEDeprecated: Writes values to one range in a Google Sheet, or appends rows when no start cell is given. It may expand the sheet grid; if a recognized default sheet name is not found, it uses the first sheet instead.

Input Parameters

array
required
A 2D array of cell values where each inner array represents a row. Values can be strings, numbers, booleans, or None/null for empty cells. Ensure columns are properly aligned across rows.
string
required
The name of the specific sheet (tab) within the spreadsheet to update (required, separate from cell reference). Case-insensitive matching is supported (e.g., ‘sheet1’ will match ‘Sheet1’). Note: Default sheet names are locale-dependent (e.g., ‘Sheet1’ in English, ‘Foglio1’ in Italian, ‘Hoja 1’ in Spanish, ‘시트1’ in Korean, ‘Feuille 1’ in French). If you specify a common default name like ‘Sheet1’ and it doesn’t exist, the action will automatically use the first sheet in the spreadsheet.
string
required
The unique identifier of the Google Sheets spreadsheet to be updated. Must be an alphanumeric string (with hyphens and underscores allowed) typically 44 characters long. Can be found in the spreadsheet URL between ‘/d/’ and ‘/edit’. Example: ‘https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit’ has ID ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’.
string ("RAW" | "USER_ENTERED")
How input data should be interpreted. ‘USER_ENTERED’: Values are parsed as if typed by a user (e.g., strings may become numbers/dates, formulas are calculated). ‘RAW’: Values are stored exactly as provided without parsing (e.g., ‘123’ stays as string, ‘=SUM(A1:B1)’ is not calculated).
string
The starting cell for the update range, specified as a single cell in A1 notation WITHOUT sheet prefix (e.g., ‘A1’, ‘B2’, ‘AA931’). The update will extend from this cell to the right and down based on the provided values. Sheet name must be provided separately in the ‘sheet_name’ field. If omitted or set to null, values are appended as new rows to the sheet. Note: Use only a single cell reference (e.g., ‘AA931’), NOT a range (e.g., ‘AA931:AF931’) or sheet-prefixed notation (e.g., ‘Sheet1!A1’).
boolean
If set to True, the response will include the updated values in the ‘spreadsheet.responses[].updatedData’ field. The updatedData object contains ‘range’ (A1 notation), ‘majorDimension’ (ROWS), and ‘values’ (2D array of the actual cell values after the update).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_UPDATE_MEMBERSUpdate 1 to 500 Google Meet members in one space in a single batch. Requires meetings.space.created. Supply nested member names and optional email or role values. A child updateMask requires an identical top-level updateMask. With neither mask, all fields are updated, including clearing unset fields.

Input Parameters

string
required
Required. Shared parent of all members: spaces/{space}.
array
required
Required. Between 1 and 500 member updates in the same space.
string
Optional. Member fields to update for every child request, such as ‘role’ or ‘email,role’. With no top-level or child mask, all fields are updated, including deleting fields not set. Empty selects provided values; ’*’ updates all fields, including deleting unset fields. Any child mask must equal this mask.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_UPDATE_SPREADSHEET_VALUESWrite values to multiple Google Sheets ranges in one batch request.

Input Parameters

array
required
The native Google Sheets value ranges to update in request order.
string
required
The spreadsheet ID from its Google Sheets URL, not its title.
string ("RAW" | "USER_ENTERED")
required
How Google Sheets interprets input values: RAW stores them unchanged; USER_ENTERED parses them as if entered in the Sheets UI.
boolean
Whether each update result should include the values written by Google Sheets.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How returned values are rendered when include_values_in_response is true.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How returned dates and times are rendered when values are unformatted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BATCH_UPDATE_VALUES_BY_DATA_FILTERTool to update values in ranges matching data filters. Use when you need to update specific data in a Google Sheet based on criteria rather than fixed cell ranges.

Input Parameters

array
required
The new values to apply to the spreadsheet. If more than one range is matched by the specified DataFilter the specified values are applied to all of those ranges. Can be provided as a JSON string or as a list of DataFilterValueRange objects.
string
required
The ID of the spreadsheet to update.
string ("INPUT_VALUE_OPTION_UNSPECIFIED" | "RAW" | "USER_ENTERED")
required
How the input data should be interpreted. RAW: Values are stored exactly as entered, without parsing. USER_ENTERED: Values are parsed as if typed by a user (numbers stay numbers, strings prefixed with ’=’ become formulas, etc.). INPUT_VALUE_OPTION_UNSPECIFIED: Default input value option is not specified.
boolean
Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
Determines how dates, times, and durations in the response should be rendered. This is ignored if responseValueRenderOption is FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_BULK_INSERT_TASKSDEPRECATED: Use BatchExecute instead. Creates multiple tasks in a Google Tasks list in a single operation using HTTP batching. Use when you need to create many tasks efficiently (reducing round-trips compared to individual insert calls).

Input Parameters

array
required
Array of tasks to create. Each task requires at least a title.
integer
Maximum number of tasks per batch request. Default: 50. Tasks exceeding this will be split into multiple batch calls.
string
required
Identifier for the Google Task list where tasks will be created. Use actual task list IDs, not ‘@default’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CALENDAR_LIST_DELETERemoves a calendar from the user’s calendar list, unsubscribing from it without deleting the calendar itself.

Input Parameters

string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the ‘primary’ keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CALENDAR_LIST_GETRetrieves metadata for a SINGLE specific calendar from the user’s calendar list by its calendar ID. This action requires a calendarId parameter and returns details about that one calendar only. NOTE: This does NOT list all calendars. To list all calendars in the user’s calendar list, use GOOGLECALENDAR_CALENDAR_LIST_LIST instead.

Input Parameters

string
required
Required. The calendar identifier for the single calendar to retrieve. Use ‘primary’ for the primary calendar of the authenticated user, or provide a specific calendar ID (e.g., an email address or group calendar ID). To find calendar IDs, first use GOOGLECALENDAR_CALENDAR_LIST_LIST to list all calendars.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CALENDAR_LIST_INSERTInserts an existing calendar into the user’s calendar list, with optional display settings. The primary keyword is not accepted; provide the actual calendar ID.

Input Parameters

string
required
The identifier of the calendar to insert. Must be a valid calendar ID in email format (e.g., ‘user@example.com’ for a user’s calendar or ‘calendarid@group.calendar.google.com’ for a shared calendar). Note: The ‘primary’ keyword is not supported for this operation - use the actual email address of the primary calendar instead. The calendar must exist and you must have appropriate access permissions.
boolean
Whether the calendar has been hidden from the list. Accepts only boolean values: true or false. If not specified, the API defaults to false.
string
The color of the calendar. This is an ID referring to an entry in the calendarCore color palette.
boolean
Whether the calendar is selected and visible in the calendar list. Accepts only boolean values: true or false. If not specified, the API defaults to false.
string
The background color of the calendar in the Web UI. (Hexadecimal color code)
string
The foreground color of the calendar in the Web UI. (Hexadecimal color code)
string
The summary that the authenticated user has set for this calendar.
boolean
Whether to use the foregroundColor and backgroundColor fields to write the calendar colors (RGB). If this feature is used, the index-based colorId field will be set to the best matching option automatically. Optional. The default is False.
array
The default reminders that the authenticated user has for this calendar.
object
The notifications that the authenticated user is receiving for this calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CALENDAR_LIST_PATCHUpdates an existing calendar on the user’s calendar list using patch semantics. This method allows partial updates, modifying only the specified fields.

Input Parameters

boolean
Whether calendar is hidden.
string
ID for calendar color from colors endpoint.
boolean
Whether calendar content shows in UI.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. Use “primary” keyword for the currently logged in user’s primary calendar.
boolean
Whether to use RGB for foreground/background colors.
string
Hex color for calendar background.
string
Hex color for calendar foreground.
string
User-set summary for the calendar.
array
List of default reminders.
object
Notification settings for the calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CALENDAR_LIST_UPDATEUpdates a calendar list entry’s display/subscription settings (color, visibility, reminders, selection) for the authenticated user — does not modify the underlying calendar resource (title, timezone, etc.). To modify the calendar itself, use GOOGLECALENDAR_CALENDARS_UPDATE.

Input Parameters

boolean
Whether calendar is hidden.
string
ID for calendar color from colors endpoint.
boolean
Whether calendar content shows in UI.
string
required
Calendar identifier. Must be an actual calendar ID (e.g., “examplecalendar@group.calendar.google.com” or “c_abc123…@group.calendar.google.com”). To retrieve valid calendar IDs, use the GOOGLECALENDAR_LIST_CALENDARS action first. The “primary” alias is not valid for calendarList.update.
boolean
Whether to use RGB for foreground/background colors.
string
Hex color for calendar background.
string
Hex color for calendar foreground.
string
User-set summary for the calendar.
array
List of default reminders.
object
Notification settings for the calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CALENDAR_LIST_WATCHCreates a push-notification channel for changes to the user’s calendar list. Notifications signal changes rather than providing full change details, and delivery is not completely reliable.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel. Maximum 64 characters.
string
required
The type of delivery mechanism used for this channel. Must be “web_hook” or “webhook”.
string
An arbitrary string delivered to the target address with each notification. Maximum 256 characters. Used for channel verification and message routing.
object
Additional parameters controlling delivery channel behavior.
string
required
The HTTPS URL where notifications are delivered for this channel. Must have a valid SSL certificate.
integer
Unix timestamp in milliseconds indicating when the API should stop sending notifications.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CALENDARS_DELETEDeletes a secondary calendar that you own or have delete permissions on. Deletion is permanent and irreversible — verify the correct calendar_id before calling. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead. Parallel calls may trigger userRateLimitExceeded; sequence bulk deletions.

Input Parameters

string
required
Calendar identifier for a secondary calendar you own or have delete permissions on. Use calendarList.list to find deletable calendar IDs (look for accessRole “owner”). Primary calendars cannot be deleted; use the Clear Calendar action instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CALENDARS_UPDATEFull PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. Use GOOGLECALENDAR_PATCH_CALENDAR to update only a subset of fields. Mutates the underlying calendar resource (title, description, timeZone, etc.); use GOOGLECALENDAR_CALENDAR_LIST_UPDATE to change per-user display properties like color.

Input Parameters

string
required
Title of the calendar. Must be a non-empty string; passing an empty string clears the calendar title.
string
Geographic location of the calendar as free-form text. Optional.
string
The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. “Europe/Zurich”.) Optional.
string
required
Calendar identifier. Use ‘primary’ to update the primary calendar of the currently logged in user, or provide a specific calendar ID (typically in email format like ‘abc123@group.calendar.google.com’). To retrieve calendar IDs call the calendarList.list method. IMPORTANT: This is NOT the calendar’s display name/title. NOTE: For better performance, prefer providing the actual calendar ID instead of ‘primary’, as the ‘primary’ alias requires an additional API call to resolve.
string
Description of the calendar. Optional.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CHANNELS_STOPTool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel.
string
An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
string
required
An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CHECK_COMPATIBILITYTool to list dimensions and metrics compatible with a GA4 report request. Use when you need to validate compatibility of chosen dimensions or metrics before running a report.

Input Parameters

array
Optional. List of metrics to check compatibility for. Maximum of 10 metrics allowed per request.
string
required
Required. GA4 property resource name. Format: properties/{property_id}.
array
Optional. List of dimensions to check compatibility for.
object
Optional. A FilterExpression for metrics; must follow GA4 FilterExpression JSON schema.
object
Optional. A FilterExpression for dimensions; must follow GA4 FilterExpression JSON schema.
string ("COMPATIBILITY_UNSPECIFIED" | "COMPATIBLE" | "INCOMPATIBLE")
Compatibility status for dimensions or metrics per Google Analytics Data API v1beta. Valid values: COMPATIBILITY_UNSPECIFIED, COMPATIBLE, INCOMPATIBLE. Note: Values like ‘REPORT_COMPATIBLE’ are NOT valid - use ‘COMPATIBLE’ instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CLEAR_BASIC_FILTERTool to clear the basic filter from a sheet. Use when you need to remove an existing basic filter from a specific sheet within a Google Spreadsheet.

Input Parameters

integer
required
The ID of the sheet on which the basic filter should be cleared.
string
required
The ID of the spreadsheet.
array
Limits the ranges included in the response spreadsheet. Only applicable when include_spreadsheet_in_response is true.
boolean
True if grid data should be returned in the response. Only applicable when include_spreadsheet_in_response is true.
boolean
Determines if the update response should include the spreadsheet resource.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CLEAR_CALENDARClears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. Primary calendars cannot be deleted entirely.

Input Parameters

string
required
Primary calendar to clear: “primary” or the account’s own email address. Google only clears primary calendars; secondary calendar IDs return 400 Invalid Value. To remove a secondary calendar’s events, delete them individually or delete the calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CLEAR_SPREADSHEET_VALUESPermanently clear values from one range while preserving formatting, notes, and validation.

Input Parameters

string
required
The A1 or R1C1 notation of the single range whose values should be permanently cleared, such as ‘Sheet1!A1:B10’.
string
required
The ID of the Google Sheets spreadsheet containing the values to clear.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CLEAR_TASKSPermanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone. Always require explicit user confirmation before invoking.

Input Parameters

string
required
The identifier of the task list from which to clear completed tasks. Use ‘@default’ (with the @ symbol) for the user’s primary task list, or provide the task list ID obtained from GOOGLETASKS_LIST_TASK_LISTS. Note: ‘default’ without the @ prefix is not valid.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CLEAR_VALUESClears cell content (preserving formatting and notes) from a specified A1 notation range in a Google Spreadsheet; the range must correspond to an existing sheet and cells.

Input Parameters

string
required
The A1 notation of the range to clear values from (e.g., ‘Sheet1!A1:B2’, ‘MySheet!C:C’, or ‘A1:D5’). If the sheet name is omitted (e.g., ‘A1:B2’), the operation applies to the first visible sheet.
string
required
The unique identifier of the Google Spreadsheet from which to clear values. This ID can be found in the URL of the spreadsheet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_COLORS_GETReturns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_COMPUTE_ROUTE_MATRIXCalculates travel distance and duration matrices between multiple origins and destinations using the Routes API, with various travel modes and OAuth2 support; some connections limit requests to 100 origin-destination pairs. Map results using originIndex and destinationIndex, and check condition for route availability.

Input Parameters

string ("METRIC" | "IMPERIAL")
Unit system (e.g., ‘METRIC’ for kilometers, ‘IMPERIAL’ for miles) for displaying distances. Note: distanceMeters in responses is always in meters regardless of this setting; units affects only human-readable text output.
array
required
List of origin locations. Each can be specified as an address or latitude/longitude coordinates.
string
Comma-separated list of response fields to include (e.g., ‘originIndex,destinationIndex,duration,distanceMeters,status’). Keep originIndex, destinationIndex and status in the mask; some connections reject requests without them. Use ’*’ for all fields.
string ("DRIVE" | "BICYCLE" | "WALK" | "TWO_WHEELER" | "TRANSIT")
Mode of transportation for the route matrix calculation.
array
required
List of destination locations. Each can be specified as an address or latitude/longitude coordinates.
string
BCP-47 language code (e.g., ‘en-US’, ‘es’) for textual information.
string ("ROUTING_PREFERENCE_UNSPECIFIED" | "TRAFFIC_UNAWARE" | "TRAFFIC_AWARE" | "TRAFFIC_AWARE_OPTIMAL")
Specifies factors to consider when calculating the route.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_COPY_DOCUMENTTool to create a copy of an existing Google Document. Use this to duplicate a document, for example, when using an existing document as a template. The copied document will have a default title (e.g., ‘Copy of [original title]’) if no new title is provided, and will be placed in the user’s root Google Drive folder.

Input Parameters

string
The title for the new copied document. If not provided, the title will be ‘Copy of [original document’s title]’.
string
required
The ID of the Google Document to be copied.
boolean
Whether to support copying documents from shared drives. Defaults to True.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_COPY_FILEDEPRECATED: Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead. Duplicates an existing file (not folders) in Google Drive by file_id; copy lands in same folder as original — use GOOGLEDRIVE_MOVE_FILE afterward for precise placement. Copy receives a new file_id; update stored references accordingly. For shared drives, requires organizer/manager rights.

Input Parameters

string
required
The unique identifier for the file on Google Drive that you want to copy. This ID can be retrieved from the file’s shareable link or via other Google Drive API calls. Pass only the raw ID, not a full URL. Name-based searches may return multiple files — confirm the correct file_id before calling.
string
The title to assign to the new copy of the file. If not provided, the copied file will have the same title as the original, prefixed with ‘Copy of ’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_COPY_FILE_ADVANCEDCreates a copy of a file and applies any requested updates with patch semantics. Use when you need to duplicate a file with advanced options like label inclusion, visibility settings, or custom metadata.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string
The name of the copied file. If not provided, the copied file will have the same name as the original, prefixed with ‘Copy of ’.
string ("1" | "2")
V1 error format options.
string
Selector specifying which fields to include in a partial response. Use comma-separated field paths.
string
required
The ID of the file to copy. This is the unique identifier for the file on Google Drive.
array
The IDs of the parent folders which contain the file. If not specified as part of a copy request, the file inherits any discoverable parents of the source file.
boolean
Whether the user has starred the file.
boolean
Whether the file has been trashed.
string
JSONP callback parameter.
string
The MIME type of the file. Google Drive attempts to automatically detect an appropriate value from uploaded content, if no value is provided.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
object
A collection of arbitrary key-value pairs which are visible to all apps. Entries with null values are cleared in update and copy requests.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
The time at which the file was created (RFC 3339 date-time).
string
A short description of the copied file.
string
OAuth 2.0 token for the current user.
string
A language hint for OCR processing during image import (ISO 639-1 code).
boolean
Returns response with indentations and line breaks for improved readability.
string
OAuth access token.
string
The last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime will also update modifiedByMeTime for the user.
object
A collection of arbitrary key-value pairs which are private to the requesting app. Entries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request with an OAuth 2 client ID.
string
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
string
The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the folderColorPalette field of the About resource.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).
boolean
Whether users with only writer permission can modify the file’s permissions. Not populated for items in shared drives.
boolean
Whether the requesting application supports both My Drives and shared drives.
boolean
Deprecated: Use supportsAllDrives instead.
boolean
Deprecated. Copying files into multiple folders is no longer supported. Use shortcuts instead.
boolean
Whether to set the ‘keepForever’ field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
boolean
Whether to ignore the domain’s default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.
string
Specifies which additional view’s permissions to include in the response. Only ‘published’ is supported.
boolean
Whether the options to copy, print, or download this file should be disabled for readers and commenters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_ALBUMCreates a new album in Google Photos. This requires the photoslibrary.appendonly scope, which is not included in the default authorization scopes.

Input Parameters

string
required
Name of the album to be created in Google Photos. Maximum 500 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_AND_POPULATE_TABLECreates a table in a Google Document and attempts to populate its cells with the provided text. Table creation and cell population are separate steps, so a failure after creation can leave the table in the document.

Input Parameters

integer
required
The number of rows in the table. Must be between 1 and 20.
integer
The zero-based index where the table will be inserted, in UTF-16 code units. The index must be strictly less than the segment’s end index. To insert at the end of a segment, omit this parameter and set ‘insertAtEndOfSegment’ to true instead.
string
The tab that the location is in. When omitted, the request is applied to the first tab.
integer
required
The number of columns in the table. Must be between 1 and 20.
array
required
A 2D array (list of lists) containing the text content for each cell. The outer list represents rows, and each inner list represents columns. Must match the dimensions specified by ‘rows’ and ‘columns’. Empty strings are allowed for empty cells.
string
The ID of the header, footer or footnote the location is in. An empty segment ID signifies the document’s body.
string
required
The ID of the document to update.
boolean
If true, inserts the table at the end of the segment (document body, header, or footer specified by segment_id). If false or omitted, and ‘index’ is not provided, it defaults to inserting at the end of the document body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_AUDIENCE_EXPORTTool to create an audience export for Google Analytics. Use when you need to export a snapshot of users in an audience at a specific point in time. This initiates a long-running asynchronous request that returns an operation resource name immediately. The export begins in CREATING state with rowCount=0; the operation must complete before export data is accessible for querying.

Input Parameters

string
required
Parent property resource name where the audience export will be created. Format: properties/{property_id}.
string
required
Audience resource name identifying the audience to export. Format: properties/{property_id}/audiences/{audience_id}.
array
Optional list of dimensions requested and displayed in the export. Each dimension is specified by dimensionName.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_AUDIENCE_LISTTool to create an audience list for later retrieval by initiating a long-running asynchronous request. Use when you need to create a snapshot of users currently in an audience. The method returns quickly with an Operation resource while processing occurs in the background.

Input Parameters

string
required
Required. The parent property resource name. Format: ‘properties/{property_id}’. Example: ‘properties/489591273’
string
required
Required. The audience resource name identifying the audience being listed. Format: ‘properties/{property_id}/audiences/{audience_id}’. Example: ‘properties/489591273/audiences/11228260226’
array
required
Required. The dimensions requested and displayed in the query response. At least one dimension is required. Each entry must be an object with a dimensionName key (e.g., [{'dimensionName': 'deviceId'}]). Only dimensions supported for audience lists on that property are valid; unsupported values return a 400 INVALID_ARGUMENT error. Use GOOGLE_ANALYTICS_GET_METADATA to retrieve valid dimension names.
object
Webhook notification configuration for audience list operation updates.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_CALENDARCreates a new secondary Google Calendar with the specified title and optional settings. Use this action when you need to create a new calendar for organizing events separately from the primary calendar. The authenticated user becomes the owner of the newly created calendar. Optional parameters include description, location, and timezone.

Input Parameters

string
required
Title of the calendar. This is the name that will be displayed in Google Calendar.
string
Geographic location of the calendar as free-form text.
string
The time zone of the calendar, specified as an IANA Time Zone Database name (e.g., ‘America/New_York’, ‘Europe/London’, ‘Asia/Tokyo’). If not specified, defaults to UTC.
string
Description of the calendar. Provides additional context about the calendar’s purpose.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_CALLOUT_ASSETCreate an immutable account asset containing a validated callout. Associate the returned resource using Mutate Customer Assets with field_type CALLOUT. Cleanup removes that association; Google does not allow deleting the asset.

Input Parameters

string
Optional internal name for the immutable callout asset.
object
required
Validated callout content and optional schedule.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_CHARTCreate a chart in a Google Sheets spreadsheet using a specified data range and chart type, or an optional full chart specification. The chart type and data range are required even when supplying a chart specification.

Input Parameters

string
Optional title for the chart.
integer
required
The numeric sheetId (not the sheet name/title) of the worksheet where the chart will be created. This is a unique integer identifier for the sheet within the spreadsheet. The first/default sheet typically has sheetId=0. IMPORTANT: Use ‘Get Spreadsheet Info’ action to retrieve valid sheetIds - look for sheets[].properties.sheetId in the response. The sheetId must exist in the target spreadsheet; using an ID from a different spreadsheet will fail.
string
Optional subtitle for the chart.
object
Optional full ChartSpec object to send to the Google Sheets API. Use this to support ALL chart types and advanced options. Must set exactly one of: basicChart, pieChart, bubbleChart, candlestickChart, histogramChart, treemapChart, waterfallChart, orgChart, scorecardChart. See https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/charts#ChartSpec.
string
required
Type of chart to create. Supported types: BAR, LINE, AREA, COLUMN, SCATTER, COMBO, STEPPED_AREA, PIE, HISTOGRAM, BUBBLE, CANDLESTICK, TREEMAP, WATERFALL, ORG, SCORECARD. Case-insensitive and whitespace-tolerant.
string
required
A single contiguous range of data for the chart in A1 notation (e.g., ‘A1:C10’ or ‘Sheet1!B2:D20’). Must be a single continuous range - comma-separated multi-ranges (e.g., ‘A1:A10,C1:C10’) are not supported. When chart_spec is not provided, the first column is used as the domain/labels and the remaining columns as series. IMPORTANT: PIE charts require at least 2 columns - the first column for category labels (domain) and the second column for numeric values (series). Single-column ranges are not supported for PIE charts.
string
Optional title for the X-axis.
string
Optional title for the Y-axis.
number
Red component of chart background color (0.0-1.0). If not specified, uses default.
string
required
The unique identifier of the Google Sheets spreadsheet where the chart will be created. Must be the actual spreadsheet ID from the URL (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’), NOT the spreadsheet name or title. Find it in the URL: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit
number
Blue component of chart background color (0.0-1.0). If not specified, uses default.
string
Position of the chart legend. Options: BOTTOM_LEGEND, TOP_LEGEND, LEFT_LEGEND, RIGHT_LEGEND, NO_LEGEND.
number
Green component of chart background color (0.0-1.0). If not specified, uses default.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_COMMENTTool to create a comment on a file in Google Drive. Returns a nested data object; extract data.id for the resulting comment identifier. Omit anchor and quoted_file_content_* for general file-level comments.

Input Parameters

string
A JSON string defining the region of the document to which the comment is anchored. Format: {“region”: {“kind”: “drive#commentRegion”, “<classifier>”: <value>, “rev”: “head”}}. Supported classifiers: (1) “line” for text lines (e.g., “line”: 12), (2) “page” for page numbers (e.g., “page”: {“p”: 0}), (3) “txt” for text ranges (e.g., “txt”: {“o”: 100, “l”: 50}), (4) “rect” for rectangles in images (e.g., “rect”: {“x”: 10, “y”: 20, “w”: 100, “h”: 50}), (5) “time” for video timestamps (e.g., “time”: {“t”: “00:01:30”}), (6) “matrix” for spreadsheet cells (e.g., “matrix”: {“c”: 2, “r”: 5}). Note: On blob files, only unanchored comments are supported. Google Workspace editors may treat API-set anchors as unanchored.
string
required
The plain text content of the comment.
string
required
The ID of the file. The id field from GOOGLEDOCS_SEARCH_DOCUMENTS results can be used directly without conversion.
string
The quoted content itself.
string
The MIME type of the quoted content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_CUSTOM_DIMENSIONTool to create a CustomDimension for a Google Analytics property. Use when you need to add a new custom dimension to track specific user properties, event parameters, or eCommerce item parameters.

Input Parameters

string ("DIMENSION_SCOPE_UNSPECIFIED" | "EVENT" | "USER" | "ITEM")
required
Required. Immutable. The scope of this dimension. Must be one of: EVENT, USER, or ITEM
string
required
Required. The property in which to create the CustomDimension. Format: properties/{property_id}
string
Optional. Description for this custom dimension. Max length of 150 characters
string
required
Required. Display name for this custom dimension as shown in the Analytics UI. Max length of 82 characters, alphanumeric plus space and underscore starting with a letter
string
required
Required. Immutable. Tagging parameter name for this custom dimension. For user-scoped dimensions, this is the user property name. For event-scoped dimensions, this is the event parameter name. For item-scoped dimensions, this is the parameter name in the eCommerce items array. May only contain alphanumeric and underscore characters, starting with a letter. Max length of 24 characters for user-scoped dimensions, 40 characters for event-scoped dimensions
boolean
Optional. If set to true, sets this dimension as NPA and excludes it from ads personalization. This is currently only supported by user-scoped custom dimensions

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_CUSTOMER_CLIENTCreate a new Google Ads client under an eligible direct parent manager. Requires a manager account, not an advertiser client account. Currency and time zone cannot be changed after creation. Set validate_only=true to check eligibility and parameters without account creation. Invitation fields require Google allowlisting.

Input Parameters

string ("UNSPECIFIED" | "UNKNOWN" | "ADMIN" | "STANDARD" | "READ_ONLY" | "EMAIL_ONLY")
Proposed invited user’s role, available only to allowlisted managers. Use ADMIN, STANDARD, READ_ONLY, or EMAIL_ONLY; UNKNOWN is return-only.
string
Direct parent manager account ID, not a child account ID. Defaults to the connection customer_id; spaces and hyphens are stripped. An ancestor login-customer-id may be required.
string
User to invite to the new account. Available only to allowlisted managers; omit for ordinary account creation.
boolean
If true, validate parameters and manager eligibility without creating an account or inviting a user. Only errors, not results, are returned.
object
required
New client account’s essential settings and optional URL options.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_CUSTOMER_LISTCreates a Google Ads Customer Match user list for contact information, not a customer account. Membership updates can take many hours to propagate; targeting eligibility is not immediate after creation.

Input Parameters

string
required
Name of the Google Ads customer list (UserList/audience list), not an account.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
string
Description of the Google Ads customer list (UserList/audience list), not an account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_CUSTOM_METRICTool to create a custom metric in Google Analytics. Use when you need to define a new custom metric for tracking specific event parameters.

Input Parameters

string ("METRIC_SCOPE_UNSPECIFIED" | "EVENT")
required
Required. Immutable. The scope of this custom metric.
string
required
Required. The property where the custom metric will be created. Format: properties/{property_id}
string
Optional. Description for this custom metric. Max length of 150 characters.
string
required
Required. Display name for this custom metric as shown in the Analytics UI. Max length of 82 characters, alphanumeric plus space and underscore starting with a letter.
string
required
Required. Immutable. Tagging name for this custom metric. If this is an event-scoped metric, then this is the event parameter name. May only contain alphanumeric and underscore characters, starting with a letter. Max length of 40 characters for event-scoped metrics.
string ("MEASUREMENT_UNIT_UNSPECIFIED" | "STANDARD" | "CURRENCY" | "FEET" | "METERS" | "KILOMETERS" | "MILES" | "MILLISECONDS" | "SECONDS" | "MINUTES" | "HOURS")
required
Required. The type for the custom metric’s value.
array
Optional. Types of restricted data that this metric may contain. Required for metrics with CURRENCY measurement unit. Must be empty for metrics with a non-CURRENCY measurement unit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_DATA_MANAGER_USER_LISTCreate a Data Manager user list, or validate without creating one.

Input Parameters

string
Resource identifier: accountTypes/{accountType}/accounts/{account}/userLists/{userList}.
string
required
Parent account ID, without hyphens for Google Ads.
string
Description of the user list.
string
required
Required display name of the user list.
string
Optional authorizing account resource: accountTypes/{type}/accounts/{id}.
boolean
If true, validate the request without creating a user list.
string
Optional account resource with a product link to login_account.
string
required
Parent account type, for example GOOGLE_ADS.
string
External system ID used by user list sellers.
string ("MEMBERSHIP_STATUS_UNSPECIFIED" | "OPEN" | "CLOSED")
Membership status: OPEN accrues members; CLOSED stops new members.
string
Google duration in seconds ending in s; must be an exact multiple of 86400 seconds (24 hours).
object
Eligibility information for target networks.
string ("ACCESS_STATUS_UNSPECIFIED" | "ENABLED" | "DISABLED")
Whether this account’s shared access remains enabled.
object
Information for a list populated by ingested user data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_DOCUMENTCreates a new Google Docs document using the provided title as filename and inserts the initial text at the beginning if non-empty, returning the document’s ID and metadata (excluding body content).

Input Parameters

string
Optional initial text content to insert at the beginning of the new document. If not provided, an empty document will be created. For very large text (over 50,000 characters), the text will be inserted in chunks to avoid API limits.
string
required
Title for the new document, used as its filename in Google Drive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_DOCUMENT2DEPRECATED: Use GOOGLEDOCS_CREATE_DOCUMENT instead. Tool to create a blank Google Docs document with a specified title. Use when you need to create a new, empty document.

Input Parameters

string
required
The title of the document to create. This will be used as the document name in Google Drive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_DOCUMENT_MARKDOWNCreates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text.

Input Parameters

string
required
The title for the new Google Docs document.
array
Optional uploaded images that Markdown can reference by name. Use Markdown image syntax like Alt. Public HTTPS image URLs in markdown do not need image_assets.
string
The initial content for the document, formatted as Markdown. Also accepts ‘content’ as an alias. Supports headings, real Google Docs lists including nested lists, multiple Markdown tables, task-list markers, images via publicly accessible URLs or matching image_assets uploads (max 2KB URL length after resolution; formats: JPEG, PNG, GIF; SVG not supported), blockquotes, code blocks, hyperlinks (e.g., text), and text formatting (bold, italic, etc.). If empty or omitted, creates document with title only.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_DRIVECreates a Google shared drive for collaboration or storage. When reusing a request ID, an existing drive returned is not guaranteed to be the drive originally created with that ID.

Input Parameters

string
required
The name of this shared drive.
boolean
Whether the shared drive is hidden from default view.
string
The ID of the theme from which the background image and color will be set. The set of possible driveThemes can be retrieved from a drive.about.get response. When not specified on a drive.drives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don’t set colorRgb or backgroundImageFile.
string
The color of this shared drive as an RGB hex string. It can only be set on a drive.drives.update request that does not set themeId.
string
Optional. An ID for idempotent creation of a shared drive. If not provided, a UUID will be auto-generated. Each requestId can only be used ONCE to successfully create a drive. If retrying a request that succeeded previously with the same requestId, the existing drive will be returned.
object
An image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on drive.drives.update requests that don’t set themeId. When specified, all fields of the backgroundImageFile must be set.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_DRIVE_FILECreate a metadata-only Google Drive file, folder, or shortcut.

Input Parameters

string
Name of the Drive item. Google Drive supplies a default when omitted.
string
Drive partial-response field selector.
boolean
Whether the item is starred.
string
Drive MIME type, such as application/vnd.google-apps.folder.
object
Public custom properties.
string
File description.
object
Private app custom properties.
string
Parent Drive folder ID.
string
Target ID when creating a Drive shortcut.
boolean
Support My Drive and shared drives.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_EMAIL_DRAFTCreates a Gmail draft with optional recipients, subject, plain or HTML body, attachments, and threading. When a requested thread cannot be fetched, the draft is created without threading; a provided subject is used instead of the thread subject.

Input Parameters

array
Carbon Copy (CC) recipients’ email addresses. Each must be a valid email address (e.g., ‘user@example.com’) or display name format (e.g., ‘John Doe <user@example.com>’). Plain names without email addresses are NOT valid. Optional for drafts (recipients can be added later before sending).
array
Blind Carbon Copy (BCC) recipients’ email addresses. Each must be a valid email address (e.g., ‘user@example.com’) or display name format (e.g., ‘Bob Jones <user@example.com>’). Plain names without email addresses are NOT valid. Optional for drafts (recipients can be added later before sending).
string
Email body content (plain text or HTML); is_html must be True if HTML. Optional - drafts can be created without a body and edited later before sending. Can also be provided as ‘message_body’.
boolean
Set to True if body is already formatted HTML. When False, plain text newlines are auto-converted to
tags. Both modes result in HTML email; this flag controls whether the body content is treated as raw HTML or plain text that gets HTML formatting applied.
string
Email subject line. Optional - drafts can be created without a subject and edited later before sending. When creating a draft reply to an existing thread (thread_id provided), leave this empty to stay in the same thread. Setting a subject will create a NEW thread instead.
string
User’s email address or ‘me’ for the authenticated user.
string
ID of an existing Gmail thread to reply to; omit for new thread. If the thread ID is invalid or inaccessible, the draft will be created as a new thread instead of failing.
string
File(s) to attach to the email. Accepts a single file or a list of files. Total message size including base64-encoded attachments must be under 25 MB; use shareable links (e.g., Google Drive) for larger files.
string
Primary recipient’s email address. Must be a valid email address (e.g., ‘user@example.com’) or display name format (e.g., ‘John Doe <user@example.com>’). A plain name without an email address (e.g., ‘John Doe’) is NOT valid - the ’@’ symbol and domain are required. Optional for drafts (recipients can be added later before sending). Use extra_recipients if you want to send to multiple recipients.
array
Additional ‘To’ recipients’ email addresses (not Cc or Bcc). Each must be a valid email address (e.g., ‘user@example.com’), display name format (e.g., ‘Jane Doe <user@example.com>’), or ‘me’ for the authenticated user. Plain names without email addresses are NOT valid. Should only be used if recipient_email is also provided.
boolean
Append the sender’s Gmail signature (the ‘Send mail as’ signature configured in Gmail settings) to the message body, ahead of any quoted or forwarded content. Skipped when the body already ends with that signature, when no signature is configured, or when the connection lacks permission to read Gmail settings. Set to false to send the body exactly as provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_EVENTCreates a timed or all-day Google Calendar event and returns it under response_data, without conflict checking. send_updates defaults to “all”, which emails all attendees; for eligible event types, the organizer is added unless excluded and a Google Meet link is requested by default.

Input Parameters

string
Summary (title) of the event.
string
Exclusive end date for an all-day event in YYYY-MM-DD format. Must be provided together with start_date and be later than start_date.
string
Geographic location of the event as free-form text.
string
IANA timezone name from the timezone database (e.g., ‘America/New_York’, ‘Europe/London’, ‘Asia/Jerusalem’, ‘UTC’). Required if datetime is naive. For recurring events, start and end must include a timeZone. If not provided, UTC is used. If datetime includes timezone info (Z or offset), this field is optional and defaults to UTC. IMPORTANT: Must be a valid IANA timezone identifier. Values like ‘EST’, ‘PST’, ‘ISRAEL TIME’, or other abbreviations are NOT valid IANA timezone names.
array
List of attendees. Each attendee can be either: (1) A string email address (e.g., ‘user@example.com’), or (2) An object with ‘email’ (required), ‘optional’ (boolean, default false), ‘displayName’ (string), ‘comment’ (string), ‘additionalGuests’ (integer), and ‘resource’ (boolean). To mark an attendee as optional (not required), use object format: {‘email’: ‘user@example.com’, ‘optional’: true}. IMPORTANT: Only valid email addresses are accepted. Plain names cannot be used.
string ("birthday" | "default" | "focusTime" | "outOfOffice" | "workingLocation")
Type of the event, immutable post-creation. ‘workingLocation’ (REQUIRES Google Workspace Enterprise). Note: ‘fromGmail’ events cannot be created via API.
array
List of RRULE, EXRULE, RDATE, EXDATE lines for recurring events. Supported frequencies: DAILY, WEEKLY, MONTHLY, YEARLY. For recurring events, start.timeZone and end.timeZone must be present. UNTIL values follow RFC 5545: date-only (YYYYMMDD) for all-day events, or UTC datetime with Z suffix (YYYYMMDDTHHMMSSZ) for timed events. UNTIL values with time but missing Z suffix are auto-corrected. Provide an empty list to remove recurrence so the event becomes non-recurring.
string
Inclusive start date for an all-day event in YYYY-MM-DD format. Must be provided together with end_date and without start_datetime or end_datetime.
string ("default" | "public" | "private" | "confidential")
Event visibility: ‘default’, ‘public’, ‘private’, or ‘confidential’.
string
Calendar identifier. Use ‘primary’ (recommended) for the user’s main calendar. Alternatively, use a calendar ID from the user’s accessible calendar list. Calendar IDs look like email addresses (e.g., ‘xyz@group.calendar.google.com’ for shared calendars). Important: Arbitrary email addresses will NOT work - the calendar must exist in the user’s calendar list with appropriate access permissions. Use GOOGLECALENDAR_LIST_CALENDARS to retrieve valid calendar IDs.
string
Description of the event. Can contain HTML. Optional. Must be omitted for ‘birthday’ event type.
string
Event end time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. When provided, this parameter takes precedence over event_duration_hour and event_duration_minutes. If not provided, the end time is calculated using start_datetime + duration. Must be after start_datetime. Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted.
string ("all" | "externalOnly" | "none")
Options for who should receive notifications about event changes.
string ("opaque" | "transparent")
‘opaque’ (busy) or ‘transparent’ (available).
string
Event start time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. Required for timed events; omit it when using start_date and end_date for an all-day event.
boolean
If True, guests can modify the event.
boolean
If True, the organizer will NOT be added as an attendee. Default is False (organizer is included).
object
Properties for birthday events.
boolean
Defaults to True. When True, for CREATE operations creates a Google Meet link; for UPDATE operations preserves existing conference data if present, or adds a new Meet link if none exists. Google Workspace accounts will successfully receive a Meet link. Personal Gmail accounts and other unsupported accounts will gracefully fallback to creating an event without a Meet link when conference creation fails. Set to False to skip Meet link operations (won’t create new or modify existing conference data). The fallback ensures event creation succeeds even when conference features are unavailable due to account limitations.
integer
Number of hours for the event duration. Supports multi-day events (e.g., 240 hours = 10 days). For durations under 1 hour, use event_duration_minutes instead. Ignored if end_datetime is provided.
object
Extended properties of the event for storing custom metadata. Contains ‘private’ (visible only on this calendar) and/or ‘shared’ (visible to all attendees) dictionaries mapping string keys to string values. Example: {‘private’: {‘key1’: ‘value1’}, ‘shared’: {‘key2’: ‘value2’}}
object
Properties for focusTime events. REQUIRES Google Workspace Enterprise account with Focus Time feature enabled.
boolean
Whether attendees other than the organizer can invite others to the event.
object
Properties for outOfOffice events.
integer
Duration in minutes (0-59 ONLY). NEVER use 60+ minutes - use event_duration_hour=1 instead. Maximum value is 59. Combined duration (hours + minutes) must be greater than 0. Ignored if end_datetime is provided.
boolean
Whether attendees other than the organizer can see who the event’s attendees are.
object
Properties for workingLocation events. REQUIRES Google Workspace Enterprise. Constraints discovered from testing: - Must set transparency=‘transparent’ and visibility=‘public’ - Description must be omitted - Depending on ‘type’, include one of ‘homeOffice’, ‘officeLocation’, or ‘customLocation’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_EXPANDED_DATA_SETCreate an expanded data set for a Google Analytics 360 property using specified dimensions and metrics.

Input Parameters

string
required
Parent property resource name. Format: properties/{propertyId}
object
required
Definition of the ExpandedDataSet to create.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_EXPERIMENTCreate the experiment definition that begins an experiment setup workflow. Create its control and treatment arms before scheduling it.

Input Parameters

object
required
Writable fields for the new experiment.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
Validate the request without creating the experiment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_EXPERIMENT_ARMSCreate two Google Ads experiment arms in one atomic batch: one control and one treatment arm belonging to the same experiment. The control arm must contain one campaign, and their traffic splits must total 100%.

Input Parameters

string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
Validate the complete arm set without creating it.
array
required
The control and treatment arms, created atomically in one request.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Return resource names only or mutable experiment-arm fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_FILECreates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. When file_to_upload is provided, uploads the actual file bytes; otherwise creates an empty file. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells when no content is provided; content must be added manually afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in parents rather than GOOGLEDRIVE_CREATE_FOLDER.

Input Parameters

string
The name of the file. While optional, providing a meaningful name is strongly recommended. If not specified, Google Drive will create the file with name ‘Untitled’.
string
A comma-separated list of fields to include in the response.
array
Google Drive folder ID (not folder name) where the file will be created. Must be a list with exactly one folder ID (e.g., [‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs07X8ygaR’]). Folder IDs are long alphanumeric strings, not human-readable names. Use GOOGLEDRIVE_FIND_FOLDER or GOOGLEDRIVE_LIST_FILES to look up folder IDs by name. If omitted, the file is created in My Drive root.
boolean
Whether the user has starred the file.
string ("application/vnd.google-apps.folder" | "application/vnd.google-apps.document" | "application/vnd.google-apps.spreadsheet" | "application/vnd.google-apps.presentation" | "application/vnd.google-apps.drawing" | "application/vnd.google-apps.form" | "application/vnd.google-apps.script" | "application/vnd.google-apps.shortcut" | "application/vnd.google-apps.site" | "application/vnd.google-apps.map" | "application/vnd.google-apps.jam" | "application/pdf" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.oasis.opendocument.text" | "application/rtf" | "text/plain" | "text/html" | "text/markdown" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.oasis.opendocument.spreadsheet" | "text/csv" | "text/tab-separated-values" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.oasis.opendocument.presentation" | "image/jpeg" | "image/png" | "image/gif" | "image/bmp" | "image/webp" | "image/svg+xml" | "image/tiff" | "video/mp4" | "video/x-msvideo" | "video/quicktime" | "video/x-ms-wmv" | "video/webm" | "audio/mpeg" | "audio/wav" | "audio/ogg" | "application/zip" | "application/vnd.rar" | "application/x-tar" | "application/gzip" | "application/x-7z-compressed" | "application/json" | "application/xml" | "application/x-yaml" | "application/epub+zip" | "application/octet-stream")
Common MIME types for Google Drive file creation.
string
A short description of the file.
object
Optional file content to upload. If provided, the file will be created with the actual content from this upload. If omitted, creates an empty file (for folders) or empty Google Workspace document. Use this when you need to upload actual file bytes (images, PDFs, documents, etc.).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_FILE_FROM_TEXTCreates a Google Drive file from text, with support for Google Workspace formats and an optional parent folder. Returns file metadata at the top level; files can inherit parent permissions, and shared-drive targets are not supported in all cases.

Input Parameters

string
required
Required. Desired name for the new file on Google Drive. Also accepts ‘title’ or ‘name’ as aliases.
string
MIME type for the new file, determining how Google Drive interprets its content. Must exactly match the content type — a mismatched value (e.g., text/plain for HTML) breaks Drive previews and downstream conversion.
string
IMPORTANT: Must be a valid Google Drive folder ID that exists and you have access to. Do NOT pass folder names - only folder IDs work. If omitted, the file is created in the root of ‘My Drive’. To get a folder ID from a folder name, use GOOGLEDRIVE_FIND_FOLDER first. Also accepts ‘folder_id’ or ‘parent_folder_id’ as aliases.
string
required
Required. Plain text content to be written into the new file. Also accepts ‘content’, ‘body’, or ‘text’ as aliases. Only the documented aliases (content, body, text) are accepted; undocumented keys like file_content cause an ‘Invalid request data’ error. Must be UTF-8 encoded.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_FILTERTool to create a new Gmail filter with specified criteria and actions. Use when the user wants to automatically organize incoming messages based on sender, subject, size, or other criteria. Note: you can only create a maximum of 1,000 filters per account.

Input Parameters

object
required
REQUIRED. Action that the filter will perform on messages matching the criteria. At least one action field must be specified.
string
The user’s email address or the special value ‘me’ to indicate the authenticated user for whom the filter will be created.
object
required
REQUIRED. Message matching criteria that determines which messages the filter will apply to. At least one criteria field must be specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_FOLDERCreates a Google Drive folder, optionally inside an existing parent specified by ID or exact name. If multiple folders match a parent name, it uses the first match; use a parent ID to avoid ambiguity.

Input Parameters

string
required
Name for the new folder. This is a required field.
string
ID or exact name of an EXISTING parent folder. IMPORTANT: The parent folder MUST already exist - this action will NOT create parent folders automatically. If you need to create nested folders, first use GOOGLEDRIVE_FIND_FOLDER to verify the parent exists, or create it with a separate call. If a name is provided, the action searches for a folder with that exact name. If omitted, the folder is created in the Drive root. Must be non-trashed, accessible, and an actual folder (not a file) — shared drive root IDs are not valid. Use GOOGLEDRIVE_FIND_FOLDER to verify before calling.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_FOOTNOTETool to create a new footnote in a Google Document. Use this when you need to add a footnote at a specific location or at the end of the document body.

Input Parameters

object
Inserts the footnote reference at a specific index in the document. The segmentId within this Location object must be empty as footnotes can only be inserted in the document body.
string
required
The ID of the document to create the footnote in.
object
Inserts the footnote reference at the end of the document body. The segmentId within this EndOfSegmentLocation object must be empty.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_GOOGLE_SHEET1Creates a new Google Spreadsheet in Drive with an optional title and folder ID or exact folder name. Multiple matching folders return choices before creation; if moving a created spreadsheet to the requested folder fails, the response reports partial success.

Input Parameters

string
The title for the new Google Sheet. If omitted, Google will create a spreadsheet with a default name like ‘Untitled spreadsheet’.
string
Google Drive folder ID where the spreadsheet should be created. If provided, the spreadsheet will be moved to this folder after creation. Takes precedence over folder_name.
string
Google Drive folder name where the spreadsheet should be created. If provided and folder_id is not provided, the action will search for a folder with this exact name. If multiple folders match, you’ll receive a list to choose from. If no folder matches, an error is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_HEADERCreates a header in a Google Document, optionally for a specified section, and can add text. For a document-level default header, it may reuse an existing header; text insertion is attempted separately and its success is reported.

Input Parameters

string
Optional text content to add to the header after creation. If provided, the text will be inserted into the header at index 0.
string ("HEADER_FOOTER_TYPE_UNSPECIFIED" | "DEFAULT")
The type of header to create. Use ‘DEFAULT’ for the standard document header. Only one DEFAULT header can exist per document; if one already exists, the existing header ID will be returned.
string
required
The ID of the document to create the header in.
object
The location of the SectionBreak which begins the section this header should belong to. Only needed for section-specific headers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_LABELCreates a Gmail label and returns its label ID. For nested labels, it may create missing parent labels; on a name conflict it attempts to return the existing matching label.

Input Parameters

string
The email address of the user in whose account the label will be created.
string
required
REQUIRED. The name for the new label. Must be unique within the account, non-blank, maximum length 225 characters, cannot contain commas (’,’), not only whitespace, and must not be a reserved system label. Reserved English system labels include: Inbox, Starred, Important, Sent, Draft, Drafts, Spam, Trash, etc. Forward slashes (’/’) are allowed and used to create hierarchical nested labels (e.g., ‘Work/Projects’, ‘Personal/Finance’). When creating nested labels, any missing parent labels will be automatically created (similar to ‘mkdir -p’). Periods (’.’) are allowed and commonly used for numbering schemes (e.g., ‘1. Action Items’, ‘2. Projects’). Note: ‘name’ is also accepted as an alias for this field. If a label with this name already exists, returns a 409 conflict; use GMAIL_LIST_LABELS to check existing labels and reuse the existing labelId, or use GMAIL_PATCH_LABEL to update it.
string ("#000000" | "#434343" | "#666666" | "#999999" | "#cccccc" | "#efefef" | "#f3f3f3" | "#ffffff" | "#fb4c2f" | "#ffad47" | "#fad165" | "#16a766" | "#43d692" | "#4a86e8" | "#a479e2" | "#f691b3" | "#f6c5be" | "#ffe6c7" | "#fef1d1" | "#b9e4d0" | "#c6f3de" | "#c9daf8" | "#e4d7f5" | "#fcdee8" | "#efa093" | "#ffd6a2" | "#fce8b3" | "#89d3b2" | "#a0eac9" | "#a4c2f4" | "#d0bcf1" | "#fbc8d9" | "#e66550" | "#ffbc6b" | "#fcda83" | "#44b984" | "#68dfa9" | "#6d9eeb" | "#b694e8" | "#f7a7c0" | "#cc3a21" | "#eaa041" | "#f2c960" | "#149e60" | "#3dc789" | "#3c78d8" | "#8e63ce" | "#e07798" | "#ac2b16" | "#cf8933" | "#d5ae49" | "#0b804b" | "#2a9c68" | "#285bac" | "#653e9b" | "#b65775" | "#464646" | "#e7e7e7" | "#0d3472" | "#b6cff5" | "#0d3b44" | "#98d7e4" | "#3d188e" | "#e3d7ff" | "#711a36" | "#fbd3e0" | "#8a1c0a" | "#f2b2a8" | "#7a2e0b" | "#ffc8af" | "#7a4706" | "#ffdeb5" | "#594c05" | "#fbe983" | "#684e07" | "#fdedc1" | "#0b4f30" | "#b3efd3" | "#04502e" | "#a2dcc1" | "#c2c2c2" | "#4986e7" | "#2da2bb" | "#b99aff" | "#994a64" | "#f691b2" | "#ff7537" | "#ffad46" | "#662e37" | "#cca6ac" | "#094228" | "#42d692" | "#076239" | "#16a765" | "#1a764d" | "#1c4587" | "#41236d" | "#822111" | "#83334c" | "#a46a21" | "#aa8831" | "#ebdbde")
Text color for the label. Gmail only accepts colors from a predefined palette of 102 specific hex values. Common color names like ‘YELLOW’, ‘RED’, ‘BLUE’, ‘GREEN’, ‘ORANGE’, ‘PURPLE’, ‘PINK’ are automatically mapped to the closest Gmail palette color. Provide either a common color name, a Gmail palette color name (e.g., ‘BLACK’, ‘ROYAL_BLUE’), or exact hex value (e.g., ‘#000000’, ‘#4a86e8’). If only text_color is provided without background_color, a complementary background color (white or black) will be auto-selected for optimal contrast. Full palette: https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels#Color Must be supplied together with background_color — providing only one will cause a 400 error. The auto-selected complementary color behavior does not apply; both colors are required.
string ("#000000" | "#434343" | "#666666" | "#999999" | "#cccccc" | "#efefef" | "#f3f3f3" | "#ffffff" | "#fb4c2f" | "#ffad47" | "#fad165" | "#16a766" | "#43d692" | "#4a86e8" | "#a479e2" | "#f691b3" | "#f6c5be" | "#ffe6c7" | "#fef1d1" | "#b9e4d0" | "#c6f3de" | "#c9daf8" | "#e4d7f5" | "#fcdee8" | "#efa093" | "#ffd6a2" | "#fce8b3" | "#89d3b2" | "#a0eac9" | "#a4c2f4" | "#d0bcf1" | "#fbc8d9" | "#e66550" | "#ffbc6b" | "#fcda83" | "#44b984" | "#68dfa9" | "#6d9eeb" | "#b694e8" | "#f7a7c0" | "#cc3a21" | "#eaa041" | "#f2c960" | "#149e60" | "#3dc789" | "#3c78d8" | "#8e63ce" | "#e07798" | "#ac2b16" | "#cf8933" | "#d5ae49" | "#0b804b" | "#2a9c68" | "#285bac" | "#653e9b" | "#b65775" | "#464646" | "#e7e7e7" | "#0d3472" | "#b6cff5" | "#0d3b44" | "#98d7e4" | "#3d188e" | "#e3d7ff" | "#711a36" | "#fbd3e0" | "#8a1c0a" | "#f2b2a8" | "#7a2e0b" | "#ffc8af" | "#7a4706" | "#ffdeb5" | "#594c05" | "#fbe983" | "#684e07" | "#fdedc1" | "#0b4f30" | "#b3efd3" | "#04502e" | "#a2dcc1" | "#c2c2c2" | "#4986e7" | "#2da2bb" | "#b99aff" | "#994a64" | "#f691b2" | "#ff7537" | "#ffad46" | "#662e37" | "#cca6ac" | "#094228" | "#42d692" | "#076239" | "#16a765" | "#1a764d" | "#1c4587" | "#41236d" | "#822111" | "#83334c" | "#a46a21" | "#aa8831" | "#ebdbde")
Background color for the label. Gmail only accepts colors from a predefined palette of 102 specific hex values. Common color names like ‘YELLOW’, ‘RED’, ‘BLUE’, ‘GREEN’, ‘ORANGE’, ‘PURPLE’, ‘PINK’ are automatically mapped to the closest Gmail palette color. Provide either a common color name, a Gmail palette color name (e.g., ‘ROYAL_BLUE’, ‘CARIBBEAN_GREEN’), or exact hex value (e.g., ‘#4a86e8’, ‘#43d692’). If only background_color is provided without text_color, a complementary text color (white or black) will be auto-selected for optimal contrast. Full palette: https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels#Color Must be supplied together with text_color — providing only one will cause a 400 error. The auto-selected complementary color behavior does not apply; both colors are required.
string ("labelShow" | "labelShowIfUnread" | "labelHide")
Controls how the label is displayed in the label list in the Gmail sidebar. Valid values: ‘labelShow’ (always show), ‘labelShowIfUnread’ (show only if unread messages), ‘labelHide’ (hide from list).
string ("show" | "hide")
Controls how messages with this label are displayed in the message list. Valid values: ‘show’ or ‘hide’. Note: These values are different from label_list_visibility - do NOT use ‘labelShow’ or ‘labelHide’ here.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_MEETCreates a new Google Meet space with optional access controls, moderation, recording, or transcription settings, without attaching it to a calendar event. Returns the space name, meeting URI and meeting code when available, and requires the meetings.space.created OAuth scope.

Input Parameters

object
Optional configuration for the meeting space. If not provided, default settings will be used. Key sub-fields: accessType and entryPointAccess default to permissive values — set explicitly when audience or access level is known, as permissive defaults may conflict with organizational policies. Invalid combinations of these fields or moderation settings may be rejected based on domain/account policies. Recording and transcription features require a Workspace edition that supports cloud recording; personal accounts may not support these options.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_MEMBERCreate a member in a Google Meet space, optionally assigning a co-host role. Members configured with a role can join the space without knocking. Supply the space resource name and the member’s email address.

Input Parameters

string
Optional. Identifier of the member. Format: spaces/{space}/members/{member}.
string ("ROLE_UNSPECIFIED" | "COHOST")
Optional. Meeting role assigned to the member. COHOST assigns the co-host role. ROLE_UNSPECIFIED leaves the contributor or viewer role to be determined on joining, based on meeting configuration.
string
required
Required for creation. Email address of the member.
string
Optional partial-response field selector. Defaults to name,email,role,user at the provider.
string
required
Required. Resource name of the meeting space. Format: spaces/{space}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_NAMED_RANGETool to create a new named range in a Google Document. Use this to assign a name to a specific part of the document for easier reference or programmatic manipulation.

Input Parameters

string
required
The name for the new named range. Must be 1-256 characters.
string
Optional. The ID of the document tab containing this range. When omitted, Google Docs applies the request to the first tab.
string
required
The ID of the document where the named range will be created.
integer
required
The zero-based end index of the range.
string
Optional. The ID of the header, footer, or footnote. Empty for document body.
integer
required
The zero-based start index of the range.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_PARAGRAPH_BULLETSTool to add bullets to paragraphs within a specified range in a Google Document. Use when you need to format a list or a set of paragraphs as bullet points.

Input Parameters

string
Optional tab ID to apply to createParagraphBullets.range.tabId. When omitted, Google Docs applies the request to the first tab.
string
required
The ID of the document to update.
object
required
The request body for creating paragraph bullets in the document.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_PERMISSIONTool to create a permission for a file or shared drive. Use when you need to share a file or folder with users, groups, domains, or make it publicly accessible. Warning: Concurrent permissions operations on the same file are not supported; only the last update is applied.

Input Parameters

string ("owner" | "organizer" | "fileOrganizer" | "writer" | "commenter" | "reader")
required
The role granted by this permission. Valid values are: owner, organizer, fileOrganizer, writer, commenter, reader.
string ("user" | "group" | "domain" | "anyone")
required
The type of the grantee. When creating a permission, if type is ‘user’ or ‘group’, you must provide an emailAddress. When type is ‘domain’, you must provide a domain. There isn’t extra information required for ‘anyone’ type.
string
The domain to which this permission refers. Required when type is ‘domain’.
string
required
The ID of the file or shared drive.
string
The email address of the user or group to which this permission refers. Required when type is ‘user’ or ‘group’.
string
A plain text custom message to include in the notification email.
string
The time at which this permission will expire (RFC 3339 date-time). Expiration times can only be set on user and group permissions, must be in the future, and cannot be more than a year in the future.
boolean
Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect.
boolean
Whether the requesting application supports both My Drives and shared drives.
boolean
Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type ‘domain’ or ‘anyone’.
boolean
This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to true, the item will be moved to the new owner’s My Drive root folder and all prior parents removed. If set to false, parents are not changed.
boolean
Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers.
boolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_PERMISSIONS_BATCHCreates multiple permissions for files or shared drives in a single batch request. Use this action when you need to share multiple files with users, or share a single file with multiple users or groups simultaneously. Each permission in the batch can target a different file and specify different access levels. Batch operations are more efficient than creating permissions individually, with a maximum of 100 permissions per batch.

Input Parameters

array
required
A list of permissions to create. Each permission specifies the file_id, type, role, and other details. Maximum 100 permissions per batch request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_PRESENTATIONCreate a blank Google Slides presentation with an optional title and presentation ID.

Input Parameters

string
The title of the presentation. If omitted, the API uses a default title.
string
The locale of the presentation, as an IETF BCP 47 language tag (e.g., ‘en-US’, ‘fr-FR’, ‘ja-JP’). If omitted, the API uses a default locale.
object
The size of a page in the presentation.
string
The ID to use for the new presentation. If provided, it is used as the ID of the new presentation. Otherwise, a new ID is automatically generated. Must be a valid Google Drive/Slides ID format (long alphanumeric string). Note: Human-readable IDs (e.g., ‘my-presentation’) are not valid and will cause API errors. Only provide this if you have a valid Google Drive/Slides ID format; otherwise omit to let the API generate one.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_RECURRING_AUDIENCE_LISTTool to create a recurring audience list that automatically generates new audience lists daily based on the latest data. Use when you need to automate audience list creation and reduce quota token consumption.

Input Parameters

string
required
Parent property resource name where the recurring audience list will be created. Format: properties/{property_id}.
string
required
Audience resource name identifying the audience being listed. Format: properties/{property_id}/audiences/{audience_id}.
array
required
List of dimensions requested and displayed in the audience list response.
integer
Counter decreasing daily. Defaults to 180 days for Analytics 360 properties (max 365) and 14 days for standard properties (max 30).
object
Configuration for receiving webhook notifications about recurring audience list status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_REPLYCreate a plain-text reply to a comment on a Google Drive file, optionally resolving or reopening the parent comment.

Input Parameters

string ("resolve" | "reopen")
The action the reply performed to the parent comment.
string
Selector specifying which fields to include in a partial response.
string
required
The plain text content of the reply. HTML content is not supported.
string
required
The ID of the file.
string
required
The ID of the comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_REPORT_TASKTool to create a report task as a long-running asynchronous request for customized Google Analytics event data reports. Use when you need to generate large or complex reports that process asynchronously.

Input Parameters

string
required
Required. Property identifier in format ‘properties/{propertyId}’. The Google Analytics property for which to create the report task.
object
Defines how the report executes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_ROLLUP_PROPERTYTool to create a roll-up property. Use when consolidating multiple GA4 properties into one aggregated view.

Input Parameters

string
required
Required. Parent account resource. Format: accounts/{account_id}
string
required
Required. IANA time zone for the roll-up property.
string
required
Required. Display name for the roll-up property.
array
Optional. List of source property resource names to link. Format: properties/{property_id}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_SHORTCUT_TO_FILETool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it. The shortcut receives its own distinct file ID (capture from response). No parent folder parameter exists; use GOOGLEDRIVE_MOVE_FILE after creation to place the shortcut in the desired location.

Input Parameters

string
required
The name of the shortcut.
string
required
The ID of the file or folder that this shortcut points to.
string
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
boolean
Whether the requesting application supports both My Drives and shared drives. Recommended to set to true if interacting with shared drives.
boolean
Whether to set the ‘keepForever’ field in the new head revision.
boolean
Whether to ignore the domain’s default visibility settings for the created file.
string ("published")
Enum for includePermissionsForView parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_SLIDES_MARKDOWNCreates a new Google Slides presentation from Markdown, splitting content into slides at ’---’ separators and selecting layouts based on content structure. Images that fail validation or cannot be fetched may be skipped; skipped URLs are reported in the execution message.

Input Parameters

string
required
The title for the new Google Slides presentation.
string
required
The content for the slides, formatted as Markdown. THEME SELECTION: Add Theme: <name> at the start of your markdown. Available themes: default, corporate_blue, modern_dark, professional_gray, creative_purple, warm_orange, forest_green, minimal_beige. SLIDE SEPARATION: Use ’ --- ’ (on its own line) to separate slides. Each slide auto-detects its type. SLIDE TYPES: 1. Title Slide (first slide): # Title Subtitle text 2. Bullet Slides: Use -, *, or bullet characters for bullets 3. Table Slides: Standard markdown tables 4. Quote Slides: > Quote text 5. Text Slides: Regular paragraphs 6. Image Slides: 7. Two-Column Slides: Use &#124;&#124;&#124; on its own line to split left/right IMAGE REQUIREMENTS: Images must be publicly accessible PNG/JPEG/GIF under 50MB. No auth-requiring URLs. FORMATTING: Use **text** for bold. Emojis supported. Line breaks preserved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_SPREADSHEET_COLUMNInserts a new column in a Google Spreadsheet at a specified index. Select the target sheet by numeric ID or name; if neither is provided, sheet ID 0 is used.

Input Parameters

integer
The numeric identifier of the specific sheet (tab) within the spreadsheet. Defaults to 0 (the first sheet) if neither sheet_id nor sheet_name is provided. Use GOOGLESHEETS_GET_SHEET_NAMES or GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE to obtain the sheet_id from a sheet name.
string
The name (title) of the sheet/tab where the column will be added. If provided, the action will look up the sheet_id automatically. If both sheet_id and sheet_name are provided, sheet_id takes precedence.
integer
The 0-based index at which the new column will be inserted. For example, an index of 0 inserts the column before the current first column (A), and an index of 1 inserts it between the current columns A and B.
string
required
The unique identifier of the Google Spreadsheet where the column will be created.
array
Limits the ranges of the spreadsheet to include in the response. Only used if includeSpreadsheetInResponse is true.
boolean
If true, the new column inherits properties (e.g., formatting, width) from the column immediately to its left (the preceding column). If false (default), it inherits from the column immediately to its right (the succeeding column). This is ignored if there is no respective preceding or succeeding column.
boolean
If true, grid data will be included in the response (only used if includeSpreadsheetInResponse is true).
boolean
If true, the updated spreadsheet will be included in the response. Defaults to true if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_SPREADSHEET_ROWInserts a new, empty row into a specified sheet of a Google Spreadsheet at a given index, optionally inheriting formatting from the row above.

Input Parameters

integer
The numeric identifier of the sheet (tab) within the spreadsheet where the row will be inserted. This ID (gid) is found in the URL of the spreadsheet (e.g., ‘0’ for the first sheet). Either sheet_id or sheet_name must be provided.
string
The human-readable name of the sheet (tab) within the spreadsheet where the row will be inserted (e.g., ‘Sheet1’). Either sheet_id or sheet_name must be provided. If both are provided, sheet_id takes precedence.
integer
The 0-based index at which the new row should be inserted. For example, an index of 0 inserts the row at the beginning of the sheet. If the index is greater than the current number of rows, the row is appended.
string
required
The unique identifier of the Google Spreadsheet. Can be provided as the ID (e.g., ‘1qpyC0XzHc_-_d824s2VfopkHh7D0jW4aXCS1D_AlGA’) or as a full URL (the ID will be extracted automatically).
array
Limits the ranges included in the response spreadsheet. Only meaningful when include_spreadsheet_in_response is True. Use A1 notation (e.g., [‘Sheet1!A1:D10’]).
boolean
If True, the newly inserted row will inherit formatting and properties from the row immediately preceding its insertion point. If False, it will have default formatting.
boolean
If True, grid data will be included in the response spreadsheet. Only meaningful when include_spreadsheet_in_response is True. Default is False.
boolean
If True, the response will include the full updated Spreadsheet resource. Default behavior includes the spreadsheet when this parameter is not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_TABCreates a new tab in a Google Docs document. Tabs allow you to organize document content into separate sections within a single document. Use this action when you need to add a new organizational tab to a document. When a tab is added at a specified index, all subsequent tabs’ indexes are automatically incremented.

Input Parameters

string
required
The unique identifier of the Google Docs document where the tab will be created. This ID can be found in the document’s URL.
object
Properties of a tab to be created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_TASK_LISTCreates a new task list with the specified title and returns its details, including its ID for use in task operations. Duplicate titles are permitted, so check existing lists before creating one to avoid unintended duplicates.

Input Parameters

string
required
Title for the new task list. The maximum allowed length is 1024 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_CREATE_TEAM_DRIVETool to create a Team Drive. Deprecated: Use drives.create instead. Use when you need to create a Team Drive for collaboration.

Input Parameters

string
required
The name of this Team Drive. This is a required field.
string
The ID of the theme from which the background image and color will be set. The set of possible teamDriveThemes can be retrieved from a drive.about.get response. When not specified on a drive.teamdrives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don’t set colorRgb or backgroundImageFile.
string
The color of this Team Drive as an RGB hex string. It can only be set on a drive.teamdrives.update request that does not set themeId.
string
Optional. An ID for idempotent creation of a Team Drive. If not provided, a UUID will be auto-generated. Each requestId can only be used ONCE to successfully create a Team Drive. If retrying a request that succeeded previously with the same requestId, the existing Team Drive will be returned or a 409 error will occur.
object
An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field; it can only be set on drive.teamdrives.update requests that don’t set themeId. When specified, all fields of the backgroundImageFile must be set.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_CHARTDelete an existing chart from a Google Sheets spreadsheet. Use this action when you need to remove a chart that is no longer needed or needs to be replaced. This action is irreversible — once a chart is deleted, it cannot be recovered. The chart data source (the cells containing the data) remains unchanged; only the chart visualization is removed.

Input Parameters

integer
required
The unique numeric identifier of the chart to delete (also known as objectId or chartId). This is the chart’s ID within the spreadsheet, not the sheet ID. You can retrieve chart IDs using the ‘Get Spreadsheet Info’ action - look for sheets[].charts[].chartId in the response. Each chart has a unique ID that persists until the chart is deleted.
string
required
The unique identifier of the Google Sheets spreadsheet containing the chart to delete. Must be the actual spreadsheet ID from the URL (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’), NOT the spreadsheet name or title. Find it in the URL: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_CHILDTool to remove a child from a folder using Google Drive API v2. Use when you need to remove a file from a specific folder.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format enum.
string
Selector specifying which fields to include in a partial response.
string
required
The ID of the child.
string
JSONP
string
required
The ID of the folder.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. “media”, “multipart”).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
Upload protocol for media (e.g. “raw”, “multipart”).
boolean
Deprecated: If an item is not in a shared drive and its last parent is removed, the item is placed under its owner’s root.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_COMMENTPermanently deletes a comment thread (and all its replies) from a Google Drive file — this action is irreversible. To remove only a single reply within a thread, use GOOGLEDRIVE_DELETE_REPLY instead. Verify the exact comment content and comment_id before calling.

Input Parameters

string
required
The ID of the file.
string
required
The ID of the comment. Comment IDs are different from file IDs and have a distinct format (e.g., ‘AAAByC37kko’). You must obtain the comment ID from the LIST_COMMENTS or CREATE_COMMENT actions. Do NOT use the file ID here.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_CONTENT_RANGETool to delete a range of content from a Google Document. Use when you need to remove a specific portion of text or other structural elements within a document. Note: Every segment (body, header, footer, footnote) in Google Docs ends with a final newline character that cannot be deleted. Ensure the endIndex does not include this trailing newline.

Input Parameters

object
required
The range of content to delete. Deleting text across paragraph boundaries may merge paragraphs and affect styles. Certain deletions can invalidate document structure (e.g., part of a surrogate pair, last newline of critical elements, incomplete deletion of tables/equations). IMPORTANT: The endIndex must not include the final newline character at the end of a segment (body, header, footer, footnote), as this newline cannot be deleted.
string
required
The ID of the document from which to delete content. This ID can be found in the URL of the Google Doc.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_DATA_MANAGER_USER_LISTDelete a Data Manager user list, optionally validating only.

Input Parameters

string
required
Required user list resource name: accountTypes/{accountType}/accounts/{account}/userLists/{userList}.
string
Optional login account resource name; defaults to the account in name.
boolean
If true, validate the request without deleting the user list.
string
Optional account resource name with an established product link to the login account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_DIMENSIONTool to delete specified rows or columns from a sheet in a Google Spreadsheet. Use when you need to remove a range of rows or columns.

Input Parameters

integer
The unique numeric ID of the sheet (not the index/position). This ID is assigned by Google Sheets and does not change when sheets are reordered. Use GOOGLESHEETS_GET_SPREADSHEET_INFO to find the sheet ID, or use sheet_name instead. Either sheet_id or sheet_name must be provided.
string ("ROWS" | "COLUMNS")
The dimension to delete (ROWS or COLUMNS).
integer
The zero-based end index of the range to delete, exclusive. Must be greater than start_index and at most equal to the sheet’s current row/column count. Note: Cannot delete all rows or columns from a sheet - at least one row and one column must remain.
string
The name/title of the sheet from which to delete the dimension. Using sheet_name is recommended as it’s more intuitive than sheet_id. Either sheet_id or sheet_name must be provided.
integer
The zero-based start index of the range to delete, inclusive. Must be less than end_index and within the sheet’s current row/column count. Note: Cannot delete all rows or columns from a sheet - at least one row and one column must remain.
string
required
The ID of the spreadsheet.
array
Limits the ranges of cells included in the response spreadsheet.
object
The details for the delete dimension request object.
boolean
True if grid data should be returned. This parameter is ignored if a field mask was set in the request.
boolean
Determines if the update response should include the spreadsheet resource.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_DRAFTPermanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct draft_id and obtain explicit user confirmation before calling. Ensure the draft exists and the user has necessary permissions for the given user_id.

Input Parameters

string
User’s email address or ‘me’ for the authenticated user; ‘me’ is recommended.
string
required
Immutable ID of the draft to delete. Must be obtained from GMAIL_LIST_DRAFTS or GMAIL_CREATE_EMAIL_DRAFT actions. Draft IDs typically have an ‘r’ prefix (e.g., ‘r-1234567890’ or ‘r1234567890’). Draft IDs differ from message IDs used in GMAIL_BATCH_DELETE_MESSAGES — do not interchange. When multiple similar drafts exist, confirm the exact ID via GMAIL_LIST_DRAFTS before deleting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_DRIVETool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified).

Input Parameters

string
required
The ID of the shared drive.
boolean
Whether any items inside the shared drive should also be deleted. This option is only supported when useDomainAdminAccess is also set to true.
boolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_EVENTDeletes an event from the specified calendar. Only Google’s HTTP 204 confirms deletion; 404 or 410 can also mean the event belongs to a different calendar. Bulk deletions may trigger rateLimitExceeded or userRateLimitExceeded; cap concurrency to 5–10 requests and apply exponential backoff.

Input Parameters

string
required
Unique identifier of the event to delete. For standalone events, use the base event ID (e.g., ‘abc123def456’). For recurring event instances, use the instance ID format ‘baseEventId_YYYYMMDDTHHMMSSZ’ (e.g., ‘abc123def456_20260522T093000Z’) where the timestamp suffix represents the instance’s original start time in UTC. Instance IDs can be obtained from the EVENTS_INSTANCES action. To delete ALL occurrences of a recurring event, use the base event ID without the timestamp suffix. Must be the internal API identifier from a prior API response — UI-visible identifiers, URL-encoded variants, or shortened IDs are invalid and cause 404/validation errors.
string
Identifier of the Google Calendar (e.g., email address, specific ID, or ‘primary’ for the authenticated user’s main calendar) from which the event will be deleted. Calendars without event-deletion permission, including subscribed calendars not owned by the authenticated user, return 403 on deletion attempts.
string ("all" | "externalOnly" | "none")
Options for who should receive notifications about event changes.
boolean
Deprecated. Whether to send notifications about the deletion of the event. Note that some emails might still be sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_FILEDEPRECATED: Use GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION instead. Tool to permanently delete a file owned by the user without moving it to trash. Use when permanent deletion is required. If the file belongs to a shared drive, the user must be an organizer on the parent folder.

Input Parameters

string
required
The ID of the file to delete. This permanently removes the file without moving it to trash.
boolean
Whether the requesting application supports both My Drives and shared drives. Set to true if the file might be in a shared drive.
boolean
Deprecated parameter. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item is placed under its owner’s root.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_FILTERTool to permanently delete a Gmail filter by its ID. Use when you need to remove an existing email filtering rule.

Input Parameters

string
User’s email address or ‘me’ for the authenticated user.
string
required
The ID of the filter to be deleted. Filter IDs can be obtained from GMAIL_LIST_FILTERS action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_HEADERDeletes a specified header by ID from a Google Document, optionally targeting a document tab.

Input Parameters

string
The tab containing the header to delete. When omitted, the request is applied to the first tab.
string
required
The ID of the header to delete. If this header is defined on DocumentStyle, the reference to this header is removed, resulting in no header of that type for the first section of the document. If this header is defined on a SectionStyle, the reference to this header is removed and the header of that type is now continued from the previous section.
string
required
The ID of the document from which to delete the header.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_LABELPermanently DELETES a user-created Gmail label from the account (not from a message). WARNING: This action DELETES the label definition itself, removing it from all messages. System labels (INBOX, SENT, UNREAD, etc.) cannot be deleted. To add/remove labels from specific messages, use GMAIL_ADD_LABEL_TO_EMAIL action instead.

Input Parameters

string
User’s email address or ‘me’ for the authenticated user.
string
required
ID of the user-created label to be permanently DELETED from the account. Must be a custom label ID (format: ‘Label_<id>’ e.g., ‘Label_1’, ‘Label_42’). System labels (INBOX, SENT, DRAFT, UNREAD, STARRED, IMPORTANT, SPAM, TRASH, CATEGORY_*, etc.) cannot be deleted. WARNING: This action permanently DELETES the label definition from your account - it does NOT remove a label from a message. To add/remove labels from messages, use GMAIL_ADD_LABEL_TO_EMAIL instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_MEMBERDeletes a member who was previously assigned roles in a Google Meet space. Requires the full spaces/{space}/members/{member} resource name. This removes the member’s space role assignment, not a participant from an active conference. Returns an empty object on success.

Input Parameters

string
required
Required. Full resource name of the member whose previously assigned space roles should be deleted. Format: spaces/{space}/members/{member}. This is a space member, not a conference participant.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_MESSAGEPermanently deletes a specific email message by its ID from a Gmail mailbox; for user_id, use ‘me’ for the authenticated user or an email address to which the authenticated user has delegated access.

Input Parameters

string
User’s email address. The special value ‘me’ refers to the authenticated user.
string
required
Identifier of the email message to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_NAMED_RANGETool to delete a named range from a Google Document. Use when you need to remove a previously defined named range by its ID or name.

Input Parameters

string
required
The ID of the document.
object
required
Specifies the named range to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_PARAGRAPH_BULLETSTool to remove bullets from paragraphs within a specified range in a Google Document. Use when you need to clear bullet formatting from a section of a document.

Input Parameters

object
required
The range of the document from which to delete paragraph bullets. The range is applied to the document body by default. To specify a different segment (e.g. header, footer), include segment_id in the range object.
string
The ID of the tab the range is in. If omitted, it applies to the first tab or the singular tab in a single-tab document.
string
required
The ID of the document to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_PARENTTool to remove a parent from a file using Google Drive API v2. Use when you need to remove a file from a specific folder.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format enum.
string
Selector specifying which fields to include in a partial response.
string
required
The ID of the file.
string
JSONP
string
required
The ID of the parent.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. “media”, “multipart”).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
Upload protocol for media (e.g. “raw”, “multipart”).
boolean
Deprecated: If an item is not in a shared drive and its last parent is removed, the item is placed under its owner’s root.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_PERMISSIONDeletes a specified permission from a file or shared drive by permission ID; deleting other permissions does not remove an existing public-access permission. Check the returned success flag: an owner permission that cannot be removed returns success=false.

Input Parameters

string
required
The ID of the file or shared drive.
string
required
The unique ID of the permission to delete. IMPORTANT: You MUST first call GOOGLEDRIVE_LIST_PERMISSIONS with the file_id to retrieve valid permission IDs. Permission IDs are opaque identifiers assigned by Google (e.g., ‘18394857362947583’, ‘anyoneWithLink’) and cannot be guessed. Do NOT use placeholder values like ‘any’ or ‘1234’.
boolean
Whether the requesting application supports both My Drives and shared drives.
boolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_PROPERTYDelete a custom property from a Google Drive file using API v2. The property is selected by key and visibility; visibility defaults to private when omitted.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format values.
string
Selector specifying which fields to include in a partial response.
string
required
The ID of the file.
string
JSONP callback function name.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
The visibility of the property. If specified, only deletes the property if it has this visibility level.
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
required
The key of the property to delete.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_REPLYTool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. Removes only the targeted reply, not the full comment thread — use GOOGLEDRIVE_DELETE_COMMENT to remove the entire thread.

Input Parameters

string
required
The ID of the file.
string
required
The ID of the reply. Confirm correct target using createdTime and author alongside reply_id, as multiple similar replies may exist on the same comment.
string
required
The ID of the comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_REVISIONTool to permanently delete a file revision. Use when you need to remove a specific version of a binary file (images, videos, etc.). Cannot delete revisions for Google Docs/Sheets or the last remaining revision.

Input Parameters

string
required
The ID of the file.
string
required
The ID of the revision to delete. You can obtain revision IDs by calling GOOGLEDRIVE_LIST_REVISIONS. Important: You can only delete revisions for files with binary content (images, videos, etc.), not Google Docs or Sheets. You cannot delete the last remaining revision of a file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_SHEETTool to delete a sheet (worksheet) from a spreadsheet. Use when you need to remove a specific sheet from a Google Sheet document.

Input Parameters

integer
required
The ID of the sheet to delete. Note: A spreadsheet must contain at least one sheet, so you cannot delete the last remaining sheet. If the sheet is of DATA_SOURCE type, the associated DataSource is also deleted.
string
required
The ID of the spreadsheet from which to delete the sheet.
array
Limits which ranges are returned when includeSpreadsheetInResponse is true. Only meaningful if includeSpreadsheetInResponse is set to true. Ranges should be in A1 notation (e.g., ‘Sheet1!A1:B10’).
boolean
True if grid data should be returned in the response spreadsheet. Only meaningful when includeSpreadsheetInResponse is true and no field mask is set on the request.
boolean
Determines if the spreadsheet resource should be returned in the response. If true, the response includes the updated spreadsheet resource with all its sheets, properties, and metadata.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_TABDeletes a tab from a Google Document. This action is irreversible — the tab cannot be recovered once removed. Use when you need to remove a tab and all its child tabs from a document’s tab structure.

Input Parameters

string
required
The ID of the tab to delete. If the tab has child tabs, they will also be deleted.
string
required
The ID of the document containing the tab to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_TABLE_COLUMNTool to delete a column from a table in a Google Document. Use this tool when you need to remove a specific column from an existing table within a document.

Input Parameters

array
required
A list of requests to be applied to the document.
string
required
The ID of the document to delete the table column from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_TABLE_ROWTool to delete a row from a table in a Google Document. Use when you need to remove a specific row from an existing table.

Input Parameters

string
required
The ID of the document.
object
required
The reference table cell location from which the row will be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_TASKDeletes a specified task from a Google Tasks list. Deletion is permanent and irreversible — confirm with the user before executing, and consider GOOGLETASKS_UPDATE_TASK or GOOGLETASKS_MOVE_TASK as non-destructive alternatives. Both tasklist_id and task_id are required parameters. The Google Tasks API does not support deleting tasks by task_id alone — you must specify which task list contains the task. Use ‘List Task Lists’ to get available list IDs, then ‘List Tasks’ to find the task_id within that list.

Input Parameters

string
required
The unique identifier of the Google Task to delete. Required - must be a task that exists within the specified tasklist_id. Obtain this ID by using the ‘List Tasks’ action with the corresponding tasklist_id. Multiple tasks may share the same title — verify against additional fields (e.g., due date, notes) before selecting the task_id to avoid deleting the wrong task.
string
required
The unique identifier of the Google Task list containing the task to delete. Required - tasks cannot be deleted by task_id alone; the API requires specifying which list contains the task. Obtain this ID by using the ‘List Task Lists’ action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_TASK_LISTPermanently deletes an existing Google Task list, identified by tasklist_id, along with all its tasks; this operation is irreversible. Require explicit user confirmation before calling; do not invoke in read-only or exploratory flows.

Input Parameters

string
required
Unique identifier of the Google Task list to be deleted. This field is required and cannot be empty.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_TEAM_DRIVETool to permanently delete a Team Drive. Deprecated: Use drives.delete instead. Use when you need to remove a Team Drive using the legacy endpoint.

Input Parameters

string
required
The ID of the Team Drive to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DELETE_THREADTool to immediately and permanently delete a specified thread and all its messages. This operation cannot be undone. Use threads.trash instead for reversible deletion.

Input Parameters

string
required
ID of the Thread to delete.
string
User’s email address. The special value ‘me’ refers to the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DISTANCE_MATRIX_APIDEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern ‘Compute Route Matrix’ action instead, which supports OAuth2 authentication. Supports different modes of transportation and options like departure/arrival times. Capped at 100 elements per request (elements = origins × destinations count); split large sets into batches.

Input Parameters

string
Your application’s API key. This key identifies your application for purposes of quota management.
string ("driving" | "walking" | "bicycling" | "transit")
Specifies the mode of transport to use.
string ("tolls" | "highways" | "ferries" | "indoor")
Indicates that the calculated route should avoid the specified features. Multiple values can be pipe-separated e.g. ‘tolls|highways’.
string ("metric" | "imperial")
Specifies the unit system to use when displaying results. The default is metric.
string
The region code, specified as a ccTLD (‘top-level domain’) two-character value. This helps influence results based on the region.
string
required
The starting point for calculating travel distance and time. You can supply one or more locations separated by the pipe character (|), in the form of a place ID (prefixed with place_id:), an address, latitude/longitude coordinates (e.g., ‘40.7128,-74.0060’), a plus code, or an encoded polyline (prefixed with enc: and a colon).
string
The language in which to return results. See the list of supported languages: https://developers.google.com/maps/faq#languagesupport
integer
Specifies the desired time of arrival for transit directions, in seconds since midnight, January 1, 1970 UTC. You can specify either departure_time or arrival_time, but not both.
string
required
One or more locations to use as the finishing point for calculating travel distance and time. Accepts the same formats as origins.
string ("bus" | "subway" | "train" | "tram" | "rail")
Specifies one or more preferred modes of transit. This parameter may only be specified for transit directions. Multiple values can be pipe-separated e.g. ‘bus|train’.
string ("best_guess" | "pessimistic" | "optimistic")
Specifies the assumptions to use when calculating time in traffic. This parameter is only used if the request includes a departure_time and mode is ‘driving’.
string
Specifies the desired time of departure. You can specify the time as an integer in seconds since midnight, January 1, 1970 UTC, or as the string ‘now’. Required for duration_in_traffic.
string ("less_walking" | "fewer_transfers")
Specifies preferences for transit routes. This parameter may only be specified for transit directions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DOWNLOAD_FILEDownloads a Drive file’s content and returns it in downloaded_file_content. For native blob files such as PDFs, images, videos, and Office files, it returns the original bytes without conversion; leave mime_type unset. For Google Workspace documents, it exports the content and mime_type optionally selects the export format.

Input Parameters

string
required
The unique identifier of the file to be downloaded from Google Drive. Must be a valid Google Drive file ID containing only alphanumeric characters, hyphens, and underscores. File paths with slashes (/) are not valid. This ID can typically be found in the file’s URL in Google Drive or obtained from API calls that list files.
string ("application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.oasis.opendocument.text" | "application/rtf" | "application/pdf" | "text/plain" | "application/zip" | "application/epub+zip" | "text/html" | "text/markdown" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.oasis.opendocument.spreadsheet" | "text/csv" | "text/tab-separated-values" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.oasis.opendocument.presentation" | "image/jpeg" | "image/png" | "image/svg+xml" | "application/vnd.google-apps.script+json" | "application/vnd.google-apps.vid")
ONLY for Google Workspace documents (Docs, Sheets, Slides, Drawings). Specifies the export format. Has NO effect on regular files (PDFs, images, videos, Office documents, etc.) - they are always downloaded in their native format. Google Forms and Maps cannot be downloaded as they do not support exports through the Drive API. If omitted for Google Workspace files, defaults to PDF. Different Workspace types support different formats. Use application/pdf for universal compatibility.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DOWNLOAD_FILE2DEPRECATED: Use GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION instead. Tool to download file content as a long-running operation. Use when you need to download files from Google Drive. Operations are valid for 24 hours from the time of creation.

Input Parameters

string
required
The ID of the file to download

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DOWNLOAD_FILE_OPERATIONStarts a long-running operation to download a Drive file, including Google Vids files, or export supported Google Workspace documents. Returns operation status and metadata; operations are valid for 24 hours from creation.

Input Parameters

string
required
The ID of the file to download. This is a required parameter. The file_id can be found in the file’s Google Drive URL or obtained from API calls that list files.
string
The MIME type for exporting Google Workspace documents (Google Docs, Sheets, Slides, etc.) to different formats. Only applicable to Google Workspace documents (not blob files like PDFs, images, videos). If provided for a non-Google Workspace file, this parameter will be ignored to prevent API errors. Common export formats: ‘application/pdf’, ‘application/vnd.openxmlformats-officedocument.wordprocessingml.document’ (Word), ‘application/vnd.openxmlformats-officedocument.spreadsheetml.sheet’ (Excel).
string
The ID of the revision to download. If not specified, the current head revision will be downloaded. This field can only be set when downloading blob files, Google Docs, and Google Sheets.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DOWNLOAD_FILE_REVISIONDownload the stored bytes of one blob-file revision. This action does not export Google Docs, Sheets, Slides, or other Workspace revisions. Use GOOGLEDRIVE_GET_REVISION to retrieve a Workspace revision’s exportLinks, then download the selected export URL separately.

Input Parameters

string
required
The ID of the blob file whose revision will be downloaded.
string
Optional name for the downloaded file. Unsafe path and filesystem characters are replaced. Defaults to a name derived from the file and revision IDs.
string
required
The ID of the blob-file revision to download, obtained from a revisions list or metadata response.
boolean
Set explicitly to true only when the file owner or shared-drive organizer accepts the risk of downloading a file Google has flagged as abusive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_DUPLICATE_CALENDARCreates a new, empty Google Calendar with the specified title (summary). Newly created calendars default to UTC timezone; use GOOGLECALENDAR_PATCH_CALENDAR afterward to set the desired timeZone if needed.

Input Parameters

string
required
Title for the new Google Calendar to be created. Required and must be a non-empty string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EDIT_FILEReplaces the entire content of an existing Google Drive binary file with UTF-8 text while retaining its file ID. Google Docs, Sheets, Slides, and other checked Workspace file types are not supported.

Input Parameters

string
required
New textual content to overwrite the existing file; will be UTF-8 encoded for upload. Overwrites the entire file body — partial edits are not possible, so reconstruct the full desired content before calling. Back up with GOOGLEDRIVE_COPY_FILE before irreversible edits.
string
required
ID of the Google Drive file to update. Only works with files that have binary content (e.g., .txt, .json, .pdf, .jpg files uploaded to Drive). Does NOT support Google Workspace native files (Docs, Sheets, Slides) even if they appear as spreadsheets or documents - those must be edited via Google Docs/Sheets/Slides APIs. Use GOOGLEDRIVE_FIND_FILE to retrieve an existing file’s ID; using an upload action instead would create a duplicate with a different ID.
string
MIME type of the content being uploaded. Must match the actual format of the content being uploaded (not the existing file type). Cannot be a Google Workspace MIME type (application/vnd.google-apps.*). Valid examples: text/plain, text/html, application/json, application/pdf, image/jpeg.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EMPTY_TRASHTool to permanently and irreversibly delete ALL trashed files in the user’s Google Drive or a specified shared drive. Recovery is impossible after execution — no Drive tool can restore items once trash is emptied. Affects every item in trash across the entire account or shared drive, not just files from the current workflow. Always obtain explicit user confirmation and clarify that recovery is impossible before executing. Provide driveId to target a specific shared drive’s trash; omit to empty the user’s root trash.

Input Parameters

string
If set, empties the trash of the provided shared drive. This parameter is ignored if the item is not in a shared drive.
boolean
Deprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner’s root. This parameter is ignored if the item is not in a shared drive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_END_ACTIVE_CONFERENCEEnds an active conference in a specified Google Meet space, immediately dropping active participants. A response indicating there is no active conference is also treated as success; obtain explicit user confirmation before calling.

Input Parameters

string
required
REQUIRED. Resource name of the space in the format ‘spaces/{space}’ where {space} is a unique, case-sensitive server-generated ID. Example: ‘spaces/jQCFfuBOdN5z’. This can be the full resource name including the ‘spaces/’ prefix or just the space ID. You must always provide this parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_END_EXPERIMENTImmediately stop a running experiment without deleting its campaigns, or validate that operation. Google changes the experiment’s end date to now.

Input Parameters

string
required
Experiment resource name: customers/{customer_id}/experiments/{experiment_id}.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
Validate ending without stopping the experiment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EVENTS_GETRetrieves a SINGLE event by its unique event_id (REQUIRED). This action does NOT list or search events - it fetches ONE specific event when you already know its ID. If you want to list events within a time range, search for events, or filter by criteria like time_min/time_max, use GOOGLECALENDAR_EVENTS_LIST instead.

Input Parameters

string
required
REQUIRED. The unique identifier of the specific event to retrieve. You must already know this ID (e.g., from a previous EVENTS_LIST call or event creation response). This action fetches ONE event by ID - it cannot list or search events. To find events by time range or search criteria, use GOOGLECALENDAR_EVENTS_LIST instead.
string
Time zone used in the response. If not specified, the calendar’s time zone is used.
string
Identifier of the Google Calendar (e.g., email address, specific ID, or ‘primary’ for the authenticated user’s main calendar) from which to retrieve the event.
integer
Maximum number of attendees to include in the response. If there are more than the specified number, only the participant is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EVENTS_IMPORTTool to import an event as a private copy to a calendar. Use when you need to add an existing event to a calendar using its iCalUID. Only events with eventType=‘default’ can be imported.

Input Parameters

object
required
The (exclusive) end time of the event. For all-day events, use ‘date’ field; for timed events, use ‘dateTime’ and ‘timeZone’ fields.
object
required
The (inclusive) start time of the event. For all-day events, use ‘date’ field; for timed events, use ‘dateTime’ and ‘timeZone’ fields. dateTime must be ISO 8601 format (e.g., '2024-01-15T10:00:00'); timeZone should match the calendar’s timezone to avoid shifted times.
object
Source from which the event was created.
string
Status of the event. Possible values: ‘confirmed’, ‘tentative’, ‘cancelled’.
string
The color of the event. This is an ID referring to an entry in the event colors definition.
string
required
Event unique identifier as defined in RFC5545. This is required to identify the event being imported.
string
Title of the event.
string
Geographic location of the event as free-form text.
integer
Sequence number as per iCalendar.
array
The attendees of the event.
object
Information about the event’s reminders for the authenticated user.
array
List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545. Each string must include the full prefix (e.g., 'RRULE:FREQ=WEEKLY;BYDAY=MO'); omitting the prefix causes a 400 error.
string
Visibility of the event. Possible values: ‘default’, ‘public’, ‘private’, ‘confidential’. Default: ‘default’.
array
File attachments for the event.
string
Calendar identifier. Use ‘primary’ for the logged-in user’s primary calendar or the calendar’s email address.
string
Description of the event. Can contain HTML.
string
Whether the event blocks time on the calendar. Possible values: ‘opaque’ (blocks time), ‘transparent’ (does not block time). Default: ‘opaque’.
boolean
Whether attendees other than the organizer can modify the event. Default: False.
object
Extended properties of the event.
boolean
Whether API client performing operation supports event attachments. Default: False.
integer
Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in the event’s body. Version 1 enables copying of ConferenceData as well as for creating new conferences using the createRequest field of conferenceData. Default: 0.
boolean
Whether attendees other than the organizer can invite others to the event. Default: True.
boolean
Whether attendees other than the organizer can see who the event’s attendees are. Default: True.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EVENTS_INSTANCESReturns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. On high-volume calls, 403 rateLimitExceeded or 429 too_many_requests may occur; apply exponential backoff (1s, 2s, 4s) before retrying.

Input Parameters

string
required
REQUIRED. The ID of the recurring event whose instances you want to retrieve. You must first use GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to find recurring events and get their IDs. This action only works with recurring events that have a recurrence rule.
string
Upper bound (exclusive) for an event’s start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339 timestamp with mandatory time zone offset.
string
Lower bound (inclusive) for an event’s end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339 timestamp with mandatory time zone offset.
string
Time zone used in the response. Optional. The default is the time zone of the calendar.
string
Token specifying which result page to return. Optional.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
integer
Maximum number of events returned on one result page. By default the value is 250 events. The page size can never be larger than 2500 events. Optional.
boolean
Whether to include deleted events (with status equals “cancelled”) in the result. Cancelled instances of recurring events will still be included if singleEvents is False. Optional. The default is False.
integer
The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.
string
The original start time of the instance in the result. Optional.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EVENTS_LISTLists or incrementally synchronizes events from one calendar, defaulting to the connected user’s primary calendar. Use timeMin/timeMax for a time window, singleEvents to expand recurring series, showDeleted to include cancelled events, query for text search, orderBy to sort, pageToken to continue a page sequence, and syncToken to retrieve changes after a completed full sync. A sync token cannot be combined with event, text, property, time, update-time, or ordering filters; keep other parameters unchanged across sync pages. The final page returns nextSyncToken, and an expired token requires a new full sync after Google returns HTTP 410. Use fields to request a smaller partial response, including continuation tokens needed by the workflow.

Input Parameters

string
Free text search terms to find events that match these terms in various fields. Optional.
string
Google partial-response selector that limits which fields are returned. Use comma-separated fields and nested selectors, for example ‘items(id,status,summary,start,end,updated),nextPageToken,nextSyncToken’. Include nextPageToken when paginating and nextSyncToken when synchronizing, and keep the same selector on every page and incremental-sync request.
string
Specifies an event ID in the iCalendar format to be provided in the response. Optional. Use this if you want to search for an event by its iCalendar ID.
string ("startTime" | "updated")
The order of the events returned in the result. Optional. The default is an unspecified, stable order. Acceptable values are: “startTime”, “updated”. When set to “startTime”, singleEvents must be true. The action automatically sets singleEvents=true when orderBy=‘startTime’.
string
Upper bound (exclusive) for an event’s start time to filter by. Optional. If unset, no start-time upper bound is applied. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). Milliseconds may be provided but are ignored. If timeMin is set, timeMax must be greater than timeMin. TIMEZONE WARNING: If using UTC times (ending in ‘Z’) but the calendar is in a different timezone, the time window may not align with local calendar dates. For example, ‘2026-01-19T00:00:00Z’ to ‘2026-01-20T00:00:00Z’ covers 2026-01-18 4pm to 2026-01-19 4pm in America/Los_Angeles (UTC-8). To query a specific local date, use timestamps with the appropriate local timezone offset (e.g., ‘2026-01-19T00:00:00-08:00’ for PST). NOTE: Natural language expressions like ‘today’, ‘tomorrow’, ‘next week’ are NOT supported.
string
Lower bound (exclusive) for an event’s end time to filter by. Optional. If unset, no end-time lower bound is applied. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). Milliseconds may be provided but are ignored. If timeMax is set, timeMin must be smaller than timeMax. TIMEZONE WARNING: If using UTC times (ending in ‘Z’) but the calendar is in a different timezone, the time window may not align with local calendar dates. For example, ‘2026-01-19T00:00:00Z’ to ‘2026-01-20T00:00:00Z’ covers 2026-01-18 4pm to 2026-01-19 4pm in America/Los_Angeles (UTC-8). To query a specific local date, use timestamps with the appropriate local timezone offset (e.g., ‘2026-01-19T00:00:00-08:00’ for PST). NOTE: Natural language expressions like ‘today’, ‘tomorrow’, ‘next week’ are NOT supported.
string
Time zone used in the response for formatting event times. Optional. Use an IANA time zone identifier (e.g., America/Los_Angeles). Defaults to the user’s primary time zone. Offsets (e.g., ‘-03:00’, ‘UTC+0’) and abbreviations (e.g., ‘IST’, ‘PST’) are invalid. NOTE: This parameter only affects how event times are displayed in the response. It does NOT change how timeMin/timeMax filtering is interpreted. To query a specific local date, use timestamps with the appropriate timezone offset directly in timeMin/timeMax (e.g., ‘2026-01-19T00:00:00-08:00’).
string
Opaque pagination token from a previous response’s nextPageToken field. Must be the exact string returned by the API - do not use placeholder values like ‘NEXT’, ‘next’, ‘1’, ‘2’, etc. Omit this parameter for the first page. Keep the calendar, filters, fields selector, and syncToken unchanged while paging. Continue until nextPageToken is absent; nextSyncToken is returned only on the final page.
string
Token from nextSyncToken to return only entries changed since the last list. Cannot be combined with iCalUID, orderBy, privateExtendedProperty, q, sharedExtendedProperty, timeMin, timeMax, or updatedMin. Deletions since the previous list are always included; showDeleted cannot be false in this mode. Keep all other parameters identical to the initial full sync and retain this token while following pageToken values. The action automatically removes conflicting parameters when syncToken is provided. If Google returns HTTP 410, discard the token and perform a new full sync without syncToken.
string
Calendar identifier. Use “primary” for the user’s main calendar, or a calendar ID from the user’s accessible calendar list. Arbitrary email addresses will NOT work - the calendar must exist in the user’s calendar list. Use GOOGLECALENDAR_LIST_CALENDARS to retrieve valid calendar IDs. Defaults to “primary”. Empty strings will be treated as “primary”. Do NOT use Composio internal IDs like connectedAccountId (which start with “ca_”) - these will be automatically replaced with “primary”.
array
Event types to return. Google accepts this query parameter more than once, so provide a list to include multiple types. A single string is also accepted for compatibility. If unset, returns all event types. Values: “birthday”, “default”, “focusTime”, “fromGmail”, “outOfOffice”, “workingLocation”.
integer
Maximum number of events returned on one result page. The number of events in the resulting page may be less than this value, or none at all, even if there are more events matching the query. Incomplete pages can be detected by a non-empty nextPageToken field in the response. By default the value is 250 events. The page size can never be larger than 2500 events. Optional. Must be >= 1 if provided.
string
Lower bound for an event’s last modification time (RFC3339). When specified, entries deleted since this time are always included regardless of showDeleted. Optional.
boolean
Include cancelled events (status=“cancelled”). Optional; default is false. This surfaces cancelled (soft-deleted) events, not items in the Trash. When syncToken or updatedMin is used, deletions since those markers are included regardless of showDeleted. Recurring interaction: if singleEvents=false and showDeleted=false, cancelled instances of a recurring series may still be included; if showDeleted=true and singleEvents=true, only single deleted instances (not parent series) are returned.
integer
The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional. Must be >= 1 if provided.
boolean
Whether to expand recurring events into instances and only return single one-off events and instances of recurring events. Optional. The default is False.
boolean
Deprecated and ignored.
boolean
Whether to include hidden invitations in the result. Optional. The default is False. Hidden invitations are events where your attendee entry has responseStatus=‘needsAction’ and attendees[].self==true. When true, such invitations are included.
string
Extended properties constraint specified as propertyName=value. Matches only shared properties. This parameter might be repeated multiple times to return events that match all given constraints.
string
Extended properties constraint specified as propertyName=value. Matches only private properties. This parameter might be repeated multiple times to return events that match all given constraints.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EVENTS_LIST_ALL_CALENDARSLists and deduplicates events across selected calendars or the user’s calendar list for a time range. Returns a compact summary by default, with full event details available on request; per-calendar errors can make results incomplete.

Input Parameters

string
Free text search terms to find events that match these terms in any field, except for extended properties. Optional.
string
required
Upper bound (exclusive) for an event’s start time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). If timezone offset is missing, UTC (Z) will be automatically appended. Required.
string
required
Lower bound (inclusive) for an event’s end time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). If timezone offset is missing, UTC (Z) will be automatically appended. Required.
array
Event types to return. Optional.
array
Optional list of specific calendar IDs to query. If not provided, all calendars from the user’s calendar list will be queried.
boolean
Whether to include deleted events (with status equals ‘cancelled’) in the result. Optional. The default is False.
boolean
Whether to expand recurring events into instances and only return single one-off events and instances of recurring events. Optional. The default is True.
string ("minimal" | "full")
Level of detail in the response. ‘minimal’ (default) returns only the compact summary_view, omitting the large events array to reduce token usage. ‘full’ returns both summary_view and the full detailed events array.
integer
Maximum number of events returned per calendar. Optional. If not provided, defaults to the API’s default (250). Results may be paginated; follow nextPageToken in the response until absent to retrieve the complete event list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EVENTS_MOVEMoves a default event to another calendar, changing its organizer. Other event types cannot be moved.

Input Parameters

string
required
Event identifier. To retrieve event identifiers call the events.list method.
string
required
Calendar identifier of the source calendar. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
string
required
Calendar identifier of the destination calendar. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
string ("all" | "externalOnly" | "none")
Options for who should receive notifications about event changes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EVENTS_WATCHWatch for changes to Events resources. Watch channels expire; persist the channel id per calendarId to re-establish watches after expiration or restarts.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel.
string
The type of delivery mechanism used for this channel.
string
An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
object
Additional parameters controlling delivery channel behavior. Optional.
string
required
The address where notifications are delivered for this channel. Must be a publicly accessible HTTPS URL; http:// or localhost URLs will not receive notifications.
boolean
A Boolean value to indicate whether payload is wanted. Optional.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EXECUTE_SQLDeprecated SQL facade for selecting, inserting, updating, and deleting data in automatically detected spreadsheet tables, including limited WITH queries; discovery reads at most 10,000 rows per sheet. For detected header-based tables, the first data row is skipped and update/delete row targeting can be offset.

Input Parameters

string
required
Complete SQL query to execute. Must begin with SELECT, INSERT, UPDATE, DELETE, or WITH. Supports Common Table Expressions (CTEs) using WITH clause for complex queries. Note: WITH clauses require the sqlglot library for full support; simple SELECT/INSERT/UPDATE/DELETE operations work without it. Use table names (sheet names) in FROM/INTO clauses, not A1 range notation. The query must include proper SQL clauses (e.g., SELECT columns FROM table, not just a column name or condition). Example: SELECT * FROM “Sheet1” WHERE A = ‘value’ (correct) instead of just A = ‘value’ (incorrect).
boolean
Preview changes without applying them (for write operations)
string ("clear" | "remove_rows")
For DELETE operations: ‘clear’ preserves row structure, ‘remove_rows’ shifts data up
string
required
The unique alphanumeric ID of the Google Spreadsheet extracted from the URL. Format: A long string of letters, numbers, hyphens, and underscores (typically 44 characters). Find it in the URL: https://docs.google.com/spreadsheets/d/&#123;SPREADSHEET_ID&#125;/edit. Must be a valid ID - values like ‘auto’ are NOT valid and will fail.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EXPORT_DOCUMENT_AS_PDFTool to export a Google Docs file as PDF using the Google Drive API. Use when you need to generate a PDF version of a Google Docs document for download or distribution. Note: Google Drive enforces a 10MB limit on export content.

Input Parameters

string
required
The ID of the Google Docs file to export as PDF. This is the same as the document ID for Google Docs files - typically a 44-character alphanumeric string. Extract it from a Google Docs URL: https://docs.google.com/document/d/&#123;FILE_ID&#125;/edit
string
Optional suggested filename for the exported PDF (e.g., ‘report.pdf’). If not provided, a default filename will be generated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EXPORT_DRIVE_FILEExport an entire native spreadsheet as XLSX, ODS, PDF, ZIP, CSV, or TSV; use Export Sheet as PDF for print layout and range controls.

Input Parameters

string
required
Opaque Drive file ID of a native Google Sheets spreadsheet, not its title or URL.
string ("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.oasis.opendocument.spreadsheet" | "application/pdf" | "application/zip" | "text/csv" | "text/tab-separated-values")
required
Official Drive export MIME type for spreadsheets: XLSX, ODS, PDF, zipped HTML, CSV, or TSV. CSV and TSV export only the first sheet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EXPORT_GOOGLE_WORKSPACE_FILEExports a Google Workspace document to the requested MIME type and returns exported file content. Use when you need to export Google Docs, Sheets, Slides, Drawings, or Apps Script files to a specific format. Note: The exported content is limited to 10MB by Google Drive API.

Input Parameters

string
required
The ID of the Google Workspace file to export. Must be a valid file ID for a Google Docs, Sheets, Slides, Drawings, or Apps Script file.
string ("application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.oasis.opendocument.text" | "application/rtf" | "application/pdf" | "text/plain" | "application/zip" | "application/epub+zip" | "text/markdown" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.oasis.opendocument.spreadsheet" | "text/csv" | "text/tab-separated-values" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.oasis.opendocument.presentation" | "image/jpeg" | "image/png" | "image/svg+xml" | "application/vnd.google-apps.script+json")
required
The MIME type of the format requested for this export. Supported formats depend on the source file type: Google Docs -> DOCX, ODT, RTF, PDF, TXT, HTML (ZIP), EPUB, Markdown; Google Sheets -> XLSX, ODS, PDF, CSV, TSV, HTML (ZIP); Google Slides -> PPTX, ODP, PDF, TXT, JPG, PNG, SVG; Google Drawings -> PDF, JPG, PNG, SVG; Apps Script -> JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_EXPORT_SHEET_AS_PDFRender one sheet tab or rectangular range as PDF with orientation, gridline, margin, and fit-to-width controls.

Input Parameters

boolean
Whether to use portrait orientation, mapped to portrait.
integer
required
Numeric ID of the sheet tab to export (the gid in a Sheets URL), not the tab title or spreadsheet ID.
number
Top margin passed to the sample-backed top_margin control. Google does not formally document its unit or accepted range.
number
Left margin passed to the sample-backed left_margin control. Google does not formally document its unit or accepted range.
boolean
Value for the sample-backed fitw PDF print control.
boolean
Value for the sample-backed printtitle PDF print control.
number
Right margin passed to the sample-backed right_margin control. Google does not formally document its unit or accepted range.
number
Bottom margin passed to the sample-backed bottom_margin control. Google does not formally document its unit or accepted range.
integer
Sample-backed r2 range control. It must exceed start_row_index; Google does not formally document this browser-route key.
boolean
Whether to show sheet gridlines in the PDF.
string
required
Google Sheets spreadsheet ID or original docs.google.com Sheets URL, not the spreadsheet title. Published /d/e/ URLs are not supported.
boolean
Whether to print the sheet name, mapped to sheetnames.
integer
Sample-backed r1 range control. Supply it with all other range indices; Google does not formally document this browser-route key.
integer
Sample-backed c2 range control. It must exceed start_column_index; Google does not formally document this browser-route key.
boolean
Value for the sample-backed fzr PDF print control.
integer
Sample-backed c1 range control. Supply it with all other range indices; Google does not formally document this browser-route key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FETCH_EMAILSLists Gmail messages with query and label filtering, pagination, and optional message details. Individual detail fetches returning 404, 429, or 503 are skipped, so a page can contain fewer messages than the list result.

Input Parameters

string
Gmail advanced search query (e.g., ‘from:user subject:meeting’). Supported operators: ‘from:’, ‘to:’, ‘subject:’, ‘label:’, ‘has:’, ‘is:’, ‘in:’, ‘category:’, ‘after:YYYY/MM/DD’, ‘before:YYYY/MM/DD’, AND/OR/NOT. IMPORTANT - ‘is:’ vs ‘label:’ usage: Use ‘is:’ for special mail states: is:snoozed, is:unread, is:read, is:starred, is:important. Use ‘label:’ ONLY for user-created labels (e.g., ‘label:work’, ‘label:projects’). Note: ‘muted’ may work with both ‘is:muted’ and ‘label:muted’ based on community reports. Common mistake: ‘label:snoozed’ is WRONG - use ‘is:snoozed’ instead. Use quotes for exact phrases. Omit for no query filter. after:/before: evaluate whole calendar days in UTC; before: is exclusive — adjust for local timezone to avoid off-by-one-day gaps.
string
User’s email address or ‘me’ for the authenticated user. Non-‘me’ addresses require domain-level delegation; without it, authentication or not-found errors result.
boolean
If false, uses optimized concurrent metadata fetching for faster performance (~75% improvement). If true, uses standard detailed message fetching. When false, only essential fields (subject, sender, recipient, time, labels) are guaranteed. Body content and attachment details require verbose=true even when include_payload=true.
boolean
If true, only returns message IDs from the list API without fetching individual message details. Fastest option for getting just message IDs and thread IDs.
array
Filter by label IDs; only messages with all specified labels are returned (AND logic). Optional - omit or use empty list to fetch all messages without label filtering. System label IDs: ‘INBOX’, ‘SPAM’, ‘TRASH’, ‘UNREAD’, ‘STARRED’, ‘IMPORTANT’, ‘CATEGORY_PRIMARY’ (alias ‘CATEGORY_PERSONAL’), ‘CATEGORY_SOCIAL’, ‘CATEGORY_PROMOTIONS’, ‘CATEGORY_UPDATES’, ‘CATEGORY_FORUMS’. For custom/user-created labels, you MUST use the label ID (e.g., ‘Label_123456’), NOT the display name. Use the ‘listLabels’ action to find label IDs for custom labels. Combining label_ids with label: in query applies AND logic across both, which can silently over-restrict results; use one strategy consistently.
string
Token for retrieving a specific page, obtained from a previous response’s nextPageToken. Must be a valid opaque token string from a previous API response. Do not pass arbitrary values. Omit for the first page. Loop calls using nextPageToken until it is absent to avoid silently missing messages. resultSizeEstimate is approximate — do not use as a stopping condition.
integer
Maximum number of messages to retrieve per page. Default of 1 retrieves only a single message; set higher for practical use. Hard cap is 500 per page.
boolean
Set to true to include full message payload (headers, body, attachments); false for metadata only. payload may still be null even when true; use GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID for guaranteed complete content. When payload is present, bodies are base64url-encoded in payload.parts; replace ’-’→’+’ and ’_’→’/’ and fix padding before decoding, and check both text/plain and text/html parts.
boolean
Set to true to include messages from ‘SPAM’ and ‘TRASH’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FETCH_MESSAGE_BY_MESSAGE_IDFetches a Gmail message by its message ID in the requested format and returns formatted message details. Available fields depend on the format.

Input Parameters

string
Format for message content. ‘minimal’: lightest (ID, thread ID, labels only). ‘metadata’: headers and message metadata without body content - ideal for summarization, analysis, or when you only need subject/sender/timestamp (recommended for most use cases). ‘full’: complete MIME structure with 50+ headers, nested parts, and base64url-encoded body data - heavy payload, only use when you need the complete raw MIME structure for parsing attachments or body content. ‘raw’: entire RFC 2822 formatted message as base64url string.
string
User’s email address or ‘me’ for the authenticated user.
string
required
The Gmail API message ID (hexadecimal string, typically 15-16 characters like ‘19b11732c1b578fd’). Must be obtained from Gmail API responses (e.g., List Messages, Search Messages). Do NOT use email subjects, dates, sender names, or custom identifiers. Do NOT use threadId (use GMAIL_FETCH_MESSAGE_BY_THREAD_ID for threads), the Message-ID email header, or any fabricated value — only IDs from Gmail API list/search responses.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FETCH_MESSAGE_BY_THREAD_IDRetrieves messages from an accessible Gmail thread by thread ID, returning thread details and a messages array. Message order is not guaranteed; use messageTimestamp to identify oldest or newest messages and labelIds to filter drafts.

Input Parameters

string
The email address of the user.
string
required
Hexadecimal thread ID from Gmail API (e.g., ‘19bf77729bcb3a44’). Obtain from GMAIL_LIST_THREADS or GMAIL_FETCH_EMAILS. Prefixes like ‘msg-f:’ or ‘thread-f:’ are auto-stripped. Legacy Gmail web UI IDs (e.g., ‘FMfcgzQfBZdVqKZcSVBhqwWLKWCtDdWQ’) are NOT supported - use the API thread ID instead. Deduplicate thread_ids before calling when multiple listed messages share the same threadId to avoid redundant calls.
string
Opaque page token for fetching a specific page of messages if results are paginated. Iterate calls by passing the returned nextPageToken until it is absent; stopping early will miss messages in long threads.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FIND_EVENTFinds events in a specified Google Calendar using text, time ranges, and event types. Results are returned in event_data.event_data and may span multiple pages; follow nextPageToken even when a page is empty.

Input Parameters

string
Free-text search terms to find events. This query is matched against various event fields including summary, description, location, attendees’ details (displayName, email), and organizer’s details. Cannot search by event_id. Performs full-text match (not exact); broad terms may return unrelated events. For person-based matching, prefer attendees[].email over display names. If results appear incomplete, use GOOGLECALENDAR_EVENTS_LIST with client-side filtering.
string
Order of events: ‘startTime’ (ascending by start time) or ‘updated’ (ascending by last modification time). Note: ‘startTime’ requires single_events=true. Use ‘updated’ if you need to include recurring masters (e.g., cancelled series).
string
Upper bound (exclusive) for an event’s start time to filter by. Only events starting before this time are included. Accepts multiple formats: 1. RFC3339 timestamp (e.g., ‘2024-12-06T13:00:00Z’) 2. Comma-separated date/time parts (e.g., ‘2024,12,06,13,00,00’) 3. Simple datetime string (e.g., ‘2024-12-06 13:00:00’) Set to the first instant after the desired period to avoid missing boundary events, especially all-day events (date-only fields). Overly wide ranges expand many recurring instances, causing large payloads and high latency — constrain to the minimum required window.
string
Lower bound (exclusive) for an event’s end time to filter by. Only events ending after this time are included. Accepts multiple formats: 1. RFC3339 timestamp (e.g., ‘2024-12-06T13:00:00Z’) 2. Comma-separated date/time parts (e.g., ‘2024,12,06,13,00,00’) 3. Simple datetime string (e.g., ‘2024-12-06 13:00:00’) RFC3339 timestamps must include explicit timezone offsets; missing or mismatched offsets can silently exclude matching events. To align with the calendar’s timezone, retrieve it via GOOGLECALENDAR_GET_CALENDAR.
string
Token from a previous response’s nextPageToken to fetch the subsequent page of results. Always follow every nextPageToken until absent; skipping pagination silently omits events on busy calendars.
string
Identifier of the Google Calendar to query. IMPORTANT: This must be a valid calendar identifier, NOT a calendar name/title. Valid formats are: ‘primary’ (the authenticated user’s primary calendar), an email address (e.g., ‘user@example.com’), or a calendar ID (e.g., ‘abc123xyz@group.calendar.google.com’). To find the calendar ID for a named calendar, first use the List Calendars action (GOOGLECALENDAR_LIST_CALENDARS) to retrieve all available calendars with their IDs. ‘primary’ searches only the authenticated user’s primary calendar; to search all calendars, retrieve each ID via GOOGLECALENDAR_LIST_CALENDARS and query separately.
array
Event types to include. Supported values: ‘birthday’, ‘default’, ‘focusTime’, ‘outOfOffice’, ‘workingLocation’.
integer
Maximum number of events per page (1-2500).
string
Lower bound (exclusive) for an event’s last modification time to filter by. Only events updated after this time are included. When specified, events deleted since this time are also included, regardless of the show_deleted parameter. Accepts multiple formats: 1. RFC3339 timestamp (e.g., ‘2024-12-06T13:00:00Z’) 2. Comma-separated date/time parts (e.g., ‘2024,12,06,13,00,00’) 3. Simple datetime string (e.g., ‘2024-12-06 13:00:00’)
boolean
Include events whose status is ‘cancelled’. This surfaces cancelled/deleted events, not a separate ‘trash’ view. Behavior with recurring events: when single_events=true, only individual cancelled instances are returned (the recurring master is omitted); to include cancelled recurring masters, set single_events=false. If updated_min is provided, events deleted since that time are included regardless of this flag.
boolean
When true, recurring event series are expanded into their individual instances. When false, only the recurring master events are returned. Note: Ordering by ‘startTime’ requires singleEvents=true. For large calendars, it is strongly recommended to specify both timeMin and timeMax to limit the expansion window and improve performance.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FIND_FILEThe comprehensive Google Drive search tool that handles all file and folder discovery needs. Use this for any file finding task - from simple name searches to complex queries with date filters, MIME types, permissions, custom properties, folder scoping, and more. Searches across My Drive and shared drives with full metadata support. Examples: - Find PDFs: q=“mimeType = ‘application/pdf’” - Find recent files: q=“modifiedTime > ‘2024-01-01T00:00:00’” - Search by name: q=“name contains ‘report’” - Files in folder: folderId=“abc123” or q=“‘FOLDER_ID’ in parents”

Input Parameters

string
Query string to filter file results. Accepts both simple text searches and full Google Drive query syntax. Simple Text Search: Bare text (e.g., “SAM RFP”) is auto-converted to fullText search. Bare email addresses are auto-converted to owner search. Full Query Syntax: ‘field operator value’ combined with ‘and’, ‘or’, ‘not’ Operators: =, !=, <, >, <=, >=, contains, in Common Fields: - name - File name (exact match with = or partial match with contains) - fullText - File content search - mimeType - File type (e.g., ‘application/pdf’, ‘application/vnd.google-apps.folder’) - modifiedTime, createdTime - Dates (RFC 3339: ‘2024-01-01T00:00:00’) - parents - Folder IDs containing the file - owners, writers - User email addresses (MUST use ‘in’ operator, NOT colon syntax) - properties, appProperties - Custom metadata Boolean Filter Fields (sharedWithMe, trashed, starred): These fields require explicit = true or = false syntax: - sharedWithMe = true - Find files shared with you by others - sharedWithMe = false - Find files NOT shared with you (your own files) - trashed = true - Find files in trash - trashed = false - Exclude trashed files from results - starred = true - Find starred/favorited files - starred = false - Find non-starred files Combine with other conditions using ‘and’: - “sharedWithMe = true and name contains ‘report’” - Find shared files with ‘report’ in name - “sharedWithMe = true and mimeType = ‘application/pdf’” - Find shared PDF files - “starred = true and modifiedTime > ‘2024-01-01T00:00:00’” - Find recently modified starred files Query Complexity Limits: Queries with many OR clauses (typically >5-10) may fail with ‘The query is too complex’ error. Name Field Usage: Wildcards (*) are NOT supported. Use ‘contains’ operator for partial matching. User Email Searches: - CORRECT: “‘user@example.com’ in owners” or “‘user@example.com’ in writers” or “‘user@example.com’ in readers” - INCORRECT: “owner:user@example.com” (colon syntax is NOT supported and will cause errors) - Always use the ‘in’ operator with quoted email addresses for user-based searches Special Syntax: - Dates: RFC 3339 format (time zone defaults to UTC) - Apostrophes/quotes in values: Automatically escaped. You can write “name = ‘Jan’26’” or “name = ‘Valentine’s Day’” without manual escaping. - Grouping: Use parentheses for OR: “(mimeType contains ‘image/’ or mimeType contains ‘video/’)” - Custom properties: “properties has { key=‘department’ and value=‘sales’ }” IMPORTANT - Root Folder (‘My Drive’): ‘My Drive’ is NOT a searchable folder name. To work with the root folder, use the ‘root’ alias: folder_id=‘root’ or “‘root’ in parents” in your query.
string
Selector specifying which fields to include in a partial response. Use ’*’ for all fields. Default Behavior (Recommended for Discovery): When omitted, returns essential file discovery fields: id, name, mimeType, size, modifiedTime, createdTime, parents, webViewLink, trashed, starred. This lightweight default is optimized for file search/discovery use cases without verbose permission or capability metadata. Format: For file fields, use ‘files(field1,field2,…)’ format. For example: ‘files(id,name,mimeType)’. Top-level response fields (kind, nextPageToken, incompleteSearch) can be used directly. Note: Bare field names like ‘id,name,mimeType’ will be automatically wrapped in ‘files()’ for convenience. The ‘editors’ field is not valid in Drive API v3; use ‘permissions’ instead for access control information.
string
A comma-separated list of spaces to query. Supported values are ‘drive’, ‘appDataFolder’ and ‘photos’.
string ("user" | "drive" | "domain" | "allDrives")
Specifies which collections of files to search. Defaults to ‘allDrives’ (searches My Drive + all accessible shared drives). Values: - user - Search only user’s personal My Drive - domain - Search all files shared within Google Workspace domain - drive - Search specific shared drive (requires ‘driveId’ parameter and ‘includeItemsFromAllDrives’ must be true) - allDrives - Search My Drive + all accessible shared drives (DEFAULT, requires ‘includeItemsFromAllDrives’ to be true) When to Use: - Personal files only: Use ‘user’ - Organization-wide: Use ‘domain’ - Specific shared drive: Use ‘drive’ with ‘driveId’ - Maximum coverage: Use ‘allDrives’ (auto-enables supportsAllDrives and includeItemsFromAllDrives)
string
ID of the shared drive to search. When provided, ‘corpora’ will automatically be set to ‘drive’ (mutually exclusive with corpora=‘allDrives’). Required if ‘corpora’ is ‘drive’.
string
Comma-separated sort keys. Ascending by default; add ‘desc’ for descending. Cannot be used when query (q) contains fullText search terms. Valid Keys: - createdTime, modifiedTime, modifiedByMeTime - Dates - viewedByMeTime, sharedWithMeTime - Activity dates - name, name_natural - File name (natural: file1, file2, file10) - folder - Folder hierarchy - quotaBytesUsed - Storage size (NOTE: ‘size’ is NOT valid, use ‘quotaBytesUsed’) - starred - Starred status - recency - Recent activity (combines view time and modification time for relevance-based sorting) Important: ‘size’ is NOT a valid sort key. Use ‘quotaBytesUsed’ to sort by file size. Restriction: Sorting is not supported when the query contains fullText searches (e.g., “fullText contains ‘keyword’”). Omit orderBy when using fullText queries.
integer
The maximum number of files to return per page.
string
ID of a specific folder to search within. This automatically adds “‘folder_id’ in parents” to the query. Can be combined with the ‘q’ parameter to further filter results within the folder. Use ‘root’ to search within the user’s root folder (My Drive). Note: ‘My Drive’ is not a searchable folder name - use ‘root’ alias instead.
string
The token for continuing a previous list request on the next page. IMPORTANT: This must be the exact opaque string from a previous response’s ‘nextPageToken’ field - do not modify, truncate, URL-encode, or construct tokens manually. Invalid or corrupted tokens will result in API errors.
string
A comma-separated list of label IDs to include in the labelInfo part of the response for each file. Empty strings are automatically treated as omitted.
boolean
Indicates whether the page token was dropped from the request.
boolean
Whether the requesting application supports both My Drives and shared drives. If ‘includeItemsFromAllDrives’ is true, this must also be true.
string
The original email query before transformation.
boolean
Indicates whether the editors field was removed from the request.
boolean
Indicates whether an email query was transformed into a search filter.
boolean
Indicates whether the orderBy size value was transformed.
string
The original bare text query before transformation.
boolean
Whether both My Drive and shared drive items should be included in results. Must be true when corpora is ‘drive’ or ‘allDrives’. If true, ‘supportsAllDrives’ should also be true.
boolean
Indicates whether the email address field was removed from the request.
string
The original invalid page token that was dropped.
boolean
Indicates whether a bare text query was transformed into a search filter.
string
Specifies which additional view’s permissions to include in the response. Must be either omitted entirely or set to ‘published’. Empty strings are automatically treated as omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FIND_FOLDERFinds one page of Google Drive folders by name and optional parent. Use nextPageToken with page_token to retrieve additional pages.

Input Parameters

boolean
Set to true to search for folders that are starred, or false for those that are not.
integer
The maximum number of folders to return in this call (1-1000). This action returns one page per call; use the response’s nextPageToken to retrieve additional pages.
string
The exact name of the folder to search for as a string. This search is case-sensitive. Do not pass numbers - convert to string if needed.
string
Opaque token for the next page. Omit for the first page, then pass the previous response’s nextPageToken unchanged to continue the same search.
string
A substring to search for within folder names as a string. This search is case-insensitive.
string
Search for folders modified after a specific date and time. The timestamp must be in RFC 3339 format (e.g., ‘2023-01-15T10:00:00Z’ or ‘2023-01-15T10:00:00.000Z’).
string
The ID of the parent folder to search within. Only folders directly inside this parent folder will be returned. You can find parent folder IDs by first searching for the parent folder by name. Supports folders in both My Drive and Shared Drives.
string
A substring to exclude from folder names as a string. Folders with names containing this substring will not be returned. This search is case-insensitive.
string
A string to search for within the folder’s name or description (NOT the content of files inside the folder). This search is case-insensitive. Note: Google Drive’s fullText search on folders only matches the folder’s own metadata, not files contained within.
string
A string to exclude from the folder’s name or description (NOT the content of files inside the folder). This search is case-insensitive. Note: Google Drive’s fullText search on folders only matches the folder’s own metadata, not files contained within.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FIND_FREE_SLOTSQueries busy intervals and calculates free gaps for specified calendars, without filtering by meeting duration; the range is limited to 89 days, and calendar errors produce empty free slots marked unreliable. Omitted start defaults to now, and omitted end to 23:59:59 on the applicable day in the specified timezone.

Input Parameters

array
List of calendar identifiers to query for free/busy information. Pass as a simple list of strings, e.g., [‘primary’] or [‘primary’, ‘user@example.com’]. Valid values include: ‘primary’ (authenticated user’s main calendar), calendar IDs from the user’s calendar list (typically ending in @group.calendar.google.com), or email addresses of users whose free/busy information you want to query. The FreeBusy API will return error information for any calendars that are not accessible or invalid in the response under the ‘errors’ key for each calendar. Calendars omitted from items or inaccessible are treated as free (not unknown), which can silently produce incorrect availability results.
string
End datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats. If provided without an explicit timezone, it is interpreted in the specified timezone. If not provided, defaults to 23:59:59 of the day specified in time_min (if provided), otherwise defaults to 23:59:59 of the current day in the specified timezone. Maximum span between time_min and time_max is approximately 90 days per Google Calendar freeBusy API limit. time_max is exclusive; to cover a full day, set time_max to 00:00:00 of the following day in the target timezone rather than 23:59:59.
string
Start datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats. If provided without an explicit timezone, it is interpreted in the specified timezone. If not provided, defaults to the current timestamp in the specified timezone to ensure only future/bookable slots are returned. Maximum span between time_min and time_max is approximately 90 days per Google Calendar freeBusy API limit.
string
IANA timezone identifier (e.g., ‘America/New_York’, ‘Europe/London’, ‘Asia/Tokyo’). Determines how naive time_min/time_max are interpreted and the timezone used in the response for timeMin, timeMax, busy periods, and calculated free slots. Note: ‘local’ is not supported; use a specific IANA timezone name.
integer
Maximum calendar identifiers to return for a single group. Must be between 1 and 100 (inclusive). Values exceeding 100 will be rejected.
integer
Maximum calendars for which FreeBusy information is provided. Must be between 1 and 50 (inclusive). Values exceeding 50 will be rejected.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FIND_REPLACEFinds and replaces text across cells in a Google Spreadsheet, scoped to a sheet, range, or all sheets; if no scope is specified, it searches all sheets. Formula cells can be included explicitly when fixing formula references or patterns.

Input Parameters

string
required
The text to find. Can be a literal string or a regular expression pattern.
string
A1 notation range string to search within (e.g., ‘A1:B10’, ‘Sheet1!A1:B10’). When using A1 notation with a sheet name, you must also provide range_sheet_id to specify the numeric sheet ID (the API requires numeric IDs). Alternatively, use the GridRange parameters (range_sheet_id with optional row/column indices) for explicit numeric control. Mutually exclusive with sheet_id and all_sheets.
string
required
The text to replace the found instances with.
integer
The numeric ID of the sheet to search the entire sheet (e.g., 0 for the first sheet). Mutually exclusive with sheet_name, range/range_sheet_id parameters, and all_sheets. You must specify exactly one scope: either sheet_id (entire sheet), sheet_name, range/range_sheet_id (specific range), or all_sheets.
boolean
Whether to search across all sheets in the spreadsheet. Mutually exclusive with sheet_id and range parameters.
boolean
Whether the search should be case-sensitive.
string
The name/title of the sheet (tab) to search within (e.g., ‘Sheet1’, ‘Sales Data’). The sheet name will be resolved to its numeric sheet ID. Mutually exclusive with sheet_id, range/range_sheet_id parameters, and all_sheets.
integer
The end row (0-indexed, exclusive) of the range. Only used when range_sheet_id is provided without a ‘range’ parameter.
integer
The numeric sheet ID for a GridRange-based search. Required when using the ‘range’ parameter with A1 notation. Can also be used alone or with row/column index parameters to define a specific range. Mutually exclusive with sheet_id and all_sheets.
boolean
Whether to treat the find text as a regular expression.
string
required
The ID of the spreadsheet to update.
integer
The start row (0-indexed, inclusive) of the range. Only used when range_sheet_id is provided without a ‘range’ parameter.
integer
The end column (0-indexed, exclusive) of the range. Column A = 0, B = 1, etc. Only used when range_sheet_id is provided without a ‘range’ parameter.
boolean
Whether to include cells with formulas in the search. If true, formulas are searched and can be replaced. If false, only cell values (not formulas) are searched. If not specified, the default API behavior applies (both formulas and values are searched).
boolean
Whether to match only cells that contain the entire search term.
integer
The start column (0-indexed, inclusive) of the range. Column A = 0, B = 1, etc. Only used when range_sheet_id is provided without a ‘range’ parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FIND_WORKSHEET_BY_TITLEDEPRECATED: Finds a worksheet by its case-sensitive title within a Google Spreadsheet, after trimming input whitespace and decoding Unicode escapes. Returns a found boolean and matched worksheet metadata, or indicates no match.

Input Parameters

string
required
The unique identifier of the Google Spreadsheet from the URL (e.g., https://docs.google.com/spreadsheets/d/&#123;spreadsheet_id&#125;/edit). Important: This is NOT the spreadsheet’s display name/title. It is the long alphanumeric string (typically 40-45 characters) from the URL containing only letters, numbers, hyphens, and underscores.
string
required
The exact, case-sensitive title of the worksheet (tab name) to find.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FORMAT_CELLFormats a specified cell range in a Google Sheets worksheet. It always applies text style, font size and background color defaults unless supplied; a sheet prefix in an A1 range is ignored, so select the worksheet separately.

Input Parameters

number
Red component of the background color (0.0-1.0).
number
Blue component of the background color (0.0-1.0).
boolean
Apply bold formatting.
number
Green component of the background color (0.0-1.0).
string
OPTION 1: Cell range in A1 notation (RECOMMENDED). Supports: single cells (‘A1’, ‘F9’), cell ranges (‘A1:B5’), entire columns (‘A’, ‘I:J’), entire rows (‘1’, ‘1:5’). Also accepts sheet-prefixed ranges (‘Sheet1!A1’, ‘Instagram Calendar!A1:E1’) for convenience - if provided, the sheet prefix is stripped and ignored. The actual sheet used is determined by the sheet_name or worksheet_id parameter. Provide EITHER this field OR all four index fields below, not both.
boolean
Apply italic formatting.
integer
Font size in points.
Cell-level text link URI. Must include a URI scheme, such as ‘https://’ or ‘mailto:’.
boolean
Apply underline formatting.
string
The worksheet name/title (e.g., ‘Sheet1’, ‘Q3 Report’). Provide either this field OR worksheet_id, not both. If both are provided, sheet_name takes precedence and will be resolved to worksheet_id.
string
Text color as 6-digit hex.
string
Font family.
integer
Top padding in pixels.
string
Border color as 6-digit hex.
string ("DOTTED" | "DASHED" | "SOLID" | "SOLID_MEDIUM" | "SOLID_THICK" | "NONE" | "DOUBLE")
Border styles supported by Google Sheets.
integer
Left padding in pixels.
integer
The worksheet identifier. Accepts EITHER: (1) The sheetId from the Google Sheets API (a large number like 1534097477, obtainable via GOOGLESHEETS_GET_SPREADSHEET_INFO), OR (2) The 0-based positional index of the worksheet (0 for first sheet, 1 for second, etc.). The action will first try to match by sheetId, then fall back to matching by index. Defaults to 0 (first sheet). Provide either this field OR sheet_name, not both.
integer
OPTION 2: 0-based index of the row AFTER the last row (exclusive). Required if ‘range’ is not provided. Must provide ALL four index fields together.
integer
Right padding in pixels.
boolean
Apply strikethrough formatting.
string ("OVERFLOW_CELL" | "LEGACY_WRAP" | "CLIP" | "WRAP")
How text wraps within cells.
integer
Bottom padding in pixels.
string
required
Identifier of the Google Sheets spreadsheet.
string ("LEFT_TO_RIGHT" | "RIGHT_TO_LEFT")
Text direction in a cell.
integer
OPTION 2: 0-based row index (row 1 = index 0, row 9 = index 8). Required if ‘range’ is not provided. Must provide ALL four index fields together.
number
Background alpha from 0.0 to 1.0.
string
Background color as 6-digit hex.
integer
OPTION 2: 0-based index of the column AFTER the last column (exclusive). Required if ‘range’ is not provided. Must provide ALL four index fields together.
string ("TEXT" | "NUMBER" | "PERCENT" | "CURRENCY" | "DATE" | "TIME" | "DATE_TIME" | "SCIENTIFIC")
How number values should be represented to the user.
integer
OPTION 2: 0-based column index (A = 0, B = 1, F = 5). Required if ‘range’ is not provided. Must provide ALL four index fields together.
string ("TOP" | "MIDDLE" | "BOTTOM")
Vertical alignment of text in a cell.
integer
Text rotation angle from -90 to 90.
string ("LEFT" | "CENTER" | "RIGHT")
Horizontal alignment of text in a cell.
string
Optional number/date pattern.
How a hyperlink should be displayed in a cell.
boolean
Make text read top to bottom.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FORWARD_MESSAGEForwards an existing Gmail message to specified recipients, with optional additional text. The tool copies original message parts into a new message, but may alter MIME structure and attachment metadata.

Input Parameters

array
List of email addresses to CC.
array
List of email addresses to BCC.
string
User’s email address or ‘me’ for the authenticated user.
string
required
Gmail message ID (hexadecimal string, e.g., ‘17f45ec49a9c3f1b’). Must contain only hex characters [0-9a-fA-F]. Obtain this from actions like ‘List Messages’ or ‘Fetch Emails’.
array
required
List of email addresses to forward the message to.
string
Optional additional text to include before the forwarded content.
boolean
Append the sender’s Gmail signature (the ‘Send mail as’ signature configured in Gmail settings) to the message body, ahead of any quoted or forwarded content. Skipped when the body already ends with that signature, when no signature is configured, or when the connection lacks permission to read Gmail settings. Set to false to send the body exactly as provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_FREE_BUSY_QUERYQueries raw busy intervals for one or more calendars or groups over an exact time range. Returns per-calendar and per-group availability and errors, without event titles or details. Use GOOGLECALENDAR_FIND_FREE_SLOTS when you want default time bounds and computed free intervals; use GOOGLECALENDAR_EVENTS_LIST when you need event records.

Input Parameters

array
required
List of calendars and/or groups to query. Accepts either strings (e.g., [‘primary’, ‘user@example.com’]) or objects with an ‘id’ field (e.g., [{‘id’: ‘primary’}]). String values are automatically converted to the proper format. Only calendars with at least freeBusyReader-level access are queried; omitting shared/secondary calendars can hide real conflicts. Batch all attendees into one call to avoid 403 rateLimitExceeded or 429 tooManyRequests errors.
string
required
The end of the interval for the query formatted as per RFC3339. Exclusive bound; must be greater than timeMin. Keep the timeMin–timeMax window within ~90 days; larger spans may return empty or degraded results.
string
required
The start of the interval for the query formatted as per RFC3339. Must be strictly less than timeMax. For full-day windows, use local 00:00 in the target timezone to avoid DST/off-by-one errors.
string
Time zone used in the response. Optional. The default is UTC. Defaults to UTC, which skews working-hours analysis for users in other timezones; always supply a valid IANA timezone (e.g., ‘America/New_York’).
integer
Maximal number of calendar identifiers to be provided for a single group. Optional. An error is returned for a group with more members than this value. Maximum value is 100.
integer
Maximal number of calendars for which FreeBusy information is to be provided. Optional. Maximum value is 50.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GENERATE_IDSGenerates a set of file IDs which can be provided in create or copy requests. Use when you need to pre-allocate IDs for new files or copies.

Input Parameters

string
The type of items for which the IDs can be used. For example, ‘files’ or ‘shortcuts’.
integer
The number of IDs to return. Value must be between 1 and 1000, inclusive.
string
The space in which the IDs can be used. Supported values are ‘drive’ and ‘appDataFolder’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GENERATE_KEYWORD_FORECAST_METRICSForecast clicks, conversions and costs for a hypothetical keyword campaign without creating resources.

Input Parameters

object
required
Hypothetical campaign to forecast; does not create a campaign.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
string
Currency for exchange-rate conversion; defaults to the account currency.
object
Forecast dates in the customer’s timezone; defaults to next Sunday through Saturday.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GENERATE_KEYWORD_HISTORICAL_METRICSRetrieve historical search volumes, competition, and bid metrics for supplied keywords without creating or changing advertising resources.

Input Parameters

array
required
Keywords whose historical metrics to retrieve (up to 10,000). Close variants are deduplicated by Google.
string
Language resource name, such as languageConstants/1000; omitted means all languages.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
object
Aggregate metrics to include, such as the DEVICE breakdown.
array
Up to 10 location resource names, such as geoTargetConstants/2840. An empty list targets all geos.
string ("UNSPECIFIED" | "UNKNOWN" | "GOOGLE_SEARCH" | "GOOGLE_SEARCH_AND_PARTNERS")
Target network; defaults to Google Search and partners.
boolean
Include adult keywords in the response; defaults to false.
object
Average CPC and date-range options. Defaults to the past 12 months; up to four years of history is available.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GENERATE_KEYWORD_IDEASGenerate keyword ideas and planning metrics from exactly one seed form.

Input Parameters

string
Language constant resource name to target, for example languageConstants/1000.
object
A URL used as the sole idea seed.
integer
Number of ideas requested for this page; Google returns at most 10,000.
object
A site domain used as the sole idea seed.
string
Token returned as next_page_token by the previous page.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
object
Keywords or phrases used as the sole idea seed.
object
Aggregate metric breakdowns to include in the response.
array
Keyword annotation types to include in the response.
array
Up to 10 geo target constant resource names; an empty list targets all geos.
object
Keywords and a URL used together as the sole idea seed.
string ("UNSPECIFIED" | "UNKNOWN" | "GOOGLE_SEARCH" | "GOOGLE_SEARCH_AND_PARTNERS")
Google Ads network on which to generate keyword ideas.
boolean
Whether the response may include adult keywords.
object
Options controlling the returned historical metrics.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GEOCODE_ADDRESSGeocode a street address or address components to latitude and longitude, which may be approximate. API key authentication supports component-only queries; OAuth without an API key requires an address. DEPRECATED: Consider the newer Text Search action instead.

Input Parameters

string
Your application’s API key. This parameter is required when using API key authentication. If not provided, will attempt to use OAuth authentication (requires X-Goog-User-Project header with project ID).
string
Bounding box of the viewport within which to bias geocode results more prominently. Format: southwest_lat,southwest_lng|northeast_lat,northeast_lng. This parameter will only influence, not fully restrict, results from the geocoder.
string
Region code specified as a ccTLD (country code top-level domain) two-character value. This parameter will only influence, not fully restrict, results from the geocoder.
string
The street address that you want to geocode, in the format used by the national postal service of the country concerned. Additional address elements such as business names and unit, suite or floor numbers should be avoided. Street address elements should be delimited by spaces (shown here as url-escaped to %20). If both address and components are provided, address takes precedence.
string
Language in which to return results. If not supplied, the geocoder attempts to use the preferred language as specified in the Accept-Language header, or the native language of the domain from which the request is sent.
string
Component filters separated by a pipe (|). Each component filter consists of component:value pair and fully restricts results from the geocoder. Examples: components=country:US or components=postal_code:94043|country:US. If both address and components are provided, address takes precedence.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GEOCODE_ADDRESS_WITH_QUERYTool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API. Results may match multiple places — always verify formattedAddress, region, and addressComponents in the response before using returned coordinates.

Input Parameters

string
Region code, specified as a ccTLD two-character value (e.g., ‘US’, ‘FR’). This parameter affects results based on applicable law.
string
required
The unstructured address to geocode. This should be a single string containing the full address (e.g., ‘1600 Amphitheatre Parkway Mountain View CA’). Include city, state/region, and country where possible — incomplete or ambiguous strings may return zero results or incorrect matches.
string
Language in which the results should be returned (e.g., ‘en’, ‘es’, ‘fr’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GEOCODE_DESTINATIONSTool to perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations, landmarks, entrances, and navigation points. Use when you need comprehensive destination data for an address, place ID, or geographic coordinates.

Input Parameters

string
Resource name in format ‘places/{placeId}’ to retrieve destination by Place ID
string
Two-character ccTLD region code for formatting/filtering (e.g., ‘US’, ‘UK’)
array
Filter navigation points by travel mode. Supported values: DRIVE, WALK
object
Address query in unstructured or structured format
string
Preferred language code for results (e.g., ‘en’, ‘es’, ‘fr’)
object
Location query using geographic coordinates

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GEOCODE_LOCATIONTool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates. A single coordinate pair may return multiple results; verify formattedAddress, region, and addressComponents before committing to a result.

Input Parameters

array
Set of type tags to restrict results; results without specified types are removed
number
required
Latitude coordinate in degrees, range [-90.0, +90.0]
number
required
Longitude coordinate in degrees, range [-180.0, +180.0]
string
Region code specified as a ccTLD two-character value, affecting results based on applicable law
string
Language code in which the results should be returned (BCP-47 format)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GEOCODE_PLACETool to perform geocode lookup using a place identifier to retrieve address and coordinates. Use when you need to get detailed geographic information for a specific Google Place ID.

Input Parameters

string
required
Place identifier to geocode. Must be in the format ‘places/{placeId}’ or just the place ID (e.g., ‘ChIJj61dQgK6j4AR4GeTYWZsKWw’). The unique identifier for a place in the Google Places database.
string
Region code specified as a ccTLD two-character value, affecting results based on applicable law and address formatting.
string
Language code in which the results should be returned (BCP-47 format). Defaults to ‘en’ if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GEOCODING_APIGeocode an address into geographic coordinates, reverse geocode coordinates to find an address, or look up a place by its Place ID using Google’s Geocoding API v4beta. Choose one lookup mode per request; language and region options can guide results.

Input Parameters

string
Your application’s API key. If not provided, will be extracted from connection metadata.
string
The bounding box of the viewport within which to bias geocode results more prominently (e.g., ‘34.172684,-118.604794|34.236144,-118.500938’). This parameter will only influence, not fully restrict, results.
string
The latitude and longitude coordinates specifying the location for which you want the closest, human-readable address (e.g., ‘40.714224,-73.961452’). Provide for reverse geocoding.
string
The region code, specified as a ccTLD (‘top-level domain’) two-character value. This parameter will only influence, not fully restrict, results from the geocoder.
string
The street address or plus code that you want to geocode. Provide for geocoding (address to coordinates).
string
The language in which to return results. If language is not supplied, the geocoder attempts to use the preferred language as specified in the Accept-Language header, or the native language of the domain from which the request is sent.
string
The place ID of the place for which you wish to obtain the human-readable address. Provide for place ID geocoding.
string
A components filter with elements separated by a pipe (|). E.g., ‘postal_code:94043|country:US’. Used for geocoding, can be restrictive or biasing. Supplying only components without address may return ZERO_RESULTS for some queries.
string
A filter of one or more address types, separated by a pipe (|) (e.g., ‘street_address|locality’). Used for reverse geocoding and place ID geocoding.
string
A filter of one or more location types, separated by a pipe (|) (e.g., ‘ROOFTOP|RANGE_INTERPOLATED’). Used for reverse geocoding and place ID geocoding.
array
Use this parameter to specify additional features in the response. Can select multiple values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GEOLOCATEEstimate a device’s geographic location from cell tower and WiFi observations. With a connected Google Maps account, IP fallback can be used; managed requests require device observations and disable IP fallback.

Input Parameters

string
Carrier name.
string ("gsm" | "cdma" | "wcdma" | "lte" | "nr")
Radio type. Defaults to ‘gsm’.
array
Array of cell tower objects.
boolean
Whether to fall back to IP geolocation if WiFi and cell tower signals are missing. Defaults to true when your own Google Maps account is connected; otherwise IP fallback is always disabled and device observations are required.
array
Array of WiFi access point objects (minimum 2 required for success).
integer
Mobile country code for device’s home network. Range: 0-999.
integer
MNC for GSM/WCDMA/LTE/NR (0-999); SID for CDMA (0-32767).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET2D_TILETool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations. Use when you need to download individual map tile images for roadmap, satellite, or terrain views. Requires a valid session token from the createSession endpoint.

Input Parameters

integer
required
Tile column coordinate. Valid range: [0, (2^zoom)-1].
integer
required
Tile row coordinate. Valid range: [0, (2^(zoom-1))-1]. Valid range: [0, (2^zoom)-1], same as x.
integer
required
Zoom level ranging from 0 (entire world) to 22 (highly detailed).
string
Google API key for authentication. If not provided, will be extracted from connection metadata. Required if not using Bearer token authentication.
string
required
Session token UUID obtained from /v1/createSession endpoint. Valid for approximately two weeks. Required for all 2D tile requests. Reuse across multiple tile requests; each createSession call consumes quota.
integer
Rotation parameter in degrees counter-clockwise. Valid values: 0, 90, 180, or 270.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET3D_TILES_ROOTTool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google’s photorealistic tiles following the OGC 3D Tiles specification. The Map Tiles API is billable per request; cache the root response client-side and avoid repeated calls.

Input Parameters

string
Your Google Maps API key with Map Tiles API enabled. If not provided, will be extracted from connection metadata.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_ABOUTTool to retrieve information about the user, the user’s Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats. Note: storageQuota reflects My Drive (personal) storage only — it does not cover shared drives; use GOOGLEDRIVE_LIST_SHARED_DRIVES and GOOGLEDRIVE_GET_DRIVE for shared drive quotas. A successful response confirms base Drive read access only; write access and shared drive access must be verified separately.

Input Parameters

string
A comma-separated list of fields to include in the response. Use * to include all fields. Supported fields in Drive API v3: kind, user, storageQuota, importFormats, exportFormats, maxImportSizes, maxUploadSize, appInstalled, canCreateDrives, canCreateTeamDrives (deprecated), driveThemes, teamDriveThemes (deprecated), folderColorPalette. Note: rootFolderId was removed in v3 and is not supported. Note: storageQuota sub-fields (limit, usage, usageInDrive, usageInDriveTrash) are returned as strings representing bytes — convert to numeric types before arithmetic.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_ACCOUNTTool to retrieve a single Account by its resource name. Use when you need detailed account info after confirming the account resource name (e.g., accounts/100).

Input Parameters

string
required
Required. The resource name of the Account to retrieve. Must be in the exact format: accounts/{account_id} where account_id is a numeric identifier. IMPORTANT: Must start with ‘accounts/’ prefix, contain no forward slashes in the account_id, have no trailing slashes, and no additional path segments. Valid example: ‘accounts/100’. Invalid examples: ‘100’ (missing prefix), ‘accounts/100/’ (trailing slash), ‘accounts/100/extra’ (extra segments)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_ALBUMRetrieves a Google Photos album created by this app by its ID.

Input Parameters

string
required
Identifier of the album to be requested.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_APPTool to get information about a specific Drive app by ID. Use ‘self’ as the app ID to get information about the calling app.

Input Parameters

string
required
The ID of the app. Use ‘self’ to refer to the calling app.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_ATTACHMENTRetrieves a Gmail message attachment by message and attachment IDs and returns a downloadable file using the supplied filename.

Input Parameters

string
User’s email address (‘me’ for authenticated user).
string
required
Desired filename for the downloaded attachment. This is a required string field - do not pass null.
string
required
Immutable ID of the message containing the attachment. This is a required string field - do not pass null. Obtain the message_id from Gmail API responses (e.g., fetchEmails, listThreads).
string
required
The internal Gmail attachment ID (NOT the filename). This is a system-generated token string like ‘ANGjdJ8s…’. Obtain this ID from the ‘attachmentId’ field in the ‘attachmentList’ array returned by fetchEmails or fetchMessageByMessageId actions. Do NOT pass the filename (e.g., ‘report.pdf’). Requires a fully hydrated message payload: call GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID with format=‘full’ to obtain valid attachment IDs — lightweight fetch modes may omit attachmentList entirely.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_ATTRIBUTION_SETTINGSTool to retrieve attribution configuration for a Google Analytics property. Use when you need to check attribution models, lookback windows, and conversion export settings.

Input Parameters

string
required
Required. The resource name of the attribution settings to retrieve. Must be in the exact format: properties/{property_id}/attributionSettings where property_id is a numeric identifier. IMPORTANT: Must start with ‘properties/’ prefix, contain no forward slashes in the property_id, have no trailing slashes, and must end with ‘/attributionSettings’. Valid example: ‘properties/489591273/attributionSettings’. Invalid examples: ‘489591273’ (missing prefix), ‘properties/489591273’ (missing suffix), ‘properties/489591273/attributionSettings/’ (trailing slash)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_AUDIENCETool to retrieve a single Audience configuration from a Google Analytics property. Use when you need detailed audience information including membership criteria and filter clauses.

Input Parameters

string
required
Required. The audience identifier to retrieve. Provide the numeric audience ID (e.g., ‘11228260226’).
string
required
Required. The Google Analytics property identifier. Can be provided as just the numeric ID (e.g., ‘123456789’) or as full resource name (e.g., ‘properties/123456789’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_AUDIENCE_EXPORTTool to get configuration metadata about a specific audience export. Use when you need to understand an audience export after it has been created or check its status.

Input Parameters

string
required
Required. The audience export resource name. Format: properties/{property}/audienceExports/{audience_export}. Example: properties/489591273/audienceExports/19298228

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_AUDIENCE_LISTTool to get configuration metadata about a specific audience list. Use after confirming the audience list resource name.

Input Parameters

string
required
Required. The resource name of the Audience List to retrieve. Format: properties/{property}/audienceLists/{audienceList}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_AUTO_FORWARDINGTool to get the auto-forwarding setting for the specified account. Use when you need to retrieve the current auto-forwarding configuration including enabled status, forwarding email address, and message disposition.

Input Parameters

string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_BATCH_VALUESDEPRECATED: Use GOOGLESHEETS_BATCH_GET instead. Tool to return one or more ranges of values from a spreadsheet. Use when you need to retrieve data from multiple ranges in a single request.

Input Parameters

array
required
The A1 notation or R1C1 notation of the ranges to retrieve values from. Specify one or more ranges (e.g., [‘Sheet1!A1:B10’, ‘Sheet2!C1:D5’]). For sheet names with spaces or special characters, wrap in single quotes (e.g., “‘My Sheet’!A1:B10”).
string
required
The ID of the spreadsheet to retrieve data from. This is the unique identifier found in the spreadsheet URL between ‘/d/’ and ‘/edit’ (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’).
string ("DIMENSION_UNSPECIFIED" | "ROWS" | "COLUMNS")
The major dimension for results.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How values should be rendered in the output.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How dates, times, and durations should be represented in the output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CALENDARGets canonical metadata for one Google Calendar, defaulting to the authenticated user’s primary calendar. Returns its identifier, title, description, location, time zone, and conference properties. Use GOOGLECALENDAR_CALENDAR_LIST_GET for one calendar’s user-specific list settings such as access role, color, visibility, selection, and default reminders; use GOOGLECALENDAR_LIST_CALENDARS to enumerate accessible calendars.

Input Parameters

string
Identifier of the Google Calendar to retrieve. Must be ‘primary’ (the default) for the user’s main calendar, or an email-like identifier (e.g., ‘user@example.com’ or ‘en.usa#holiday@group.v.calendar.google.com’). IMPORTANT: Calendar display names/titles (e.g., ‘Work’, ‘Vacation’) are NOT valid identifiers and will result in errors. To find a calendar’s ID, use the LIST_CALENDARS action which returns the ‘id’ field for each calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CALENDAR_PROFILEDEPRECATED: Use CalendarListGet instead. Tool to retrieve the authenticated user’s primary calendar profile. Use when you need to get information about the user’s main calendar, including timezone, settings, and preferences.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CAMPAIGN_BY_IDRetrieve a Google Ads campaign’s name and status by numeric campaign ID for the specified or connected customer account.

Input Parameters

string
required
id of the campaign to search on GoogleAds.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CAMPAIGN_BY_NAMERetrieve the first Google Ads campaign matching an exact name for the specified or connected customer account. Names containing quotes, backslashes, NUL or line breaks are not supported.

Input Parameters

string
required
Name of the campaign to search on Google Ads. Matched using exact GAQL equality. Unicode and punctuation are supported except quotes, backslashes, NUL, and line breaks, which cannot be safely embedded in the query literal.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CHANGETool to get a specific change by ID from Google Drive v2 API. Deprecated: Use changes.getStartPageToken and changes.list to retrieve recent changes instead.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format.
string
Selector specifying which fields to include in a partial response.
string
The shared drive from which the change will be returned.
string
JSONP
string
required
The ID of the change.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
Deprecated: Use driveId instead.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).
boolean
Whether the requesting application supports both My Drives and shared drives.
boolean
Deprecated: Use supportsAllDrives instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CHANGES_START_PAGE_TOKENTool to get the starting pageToken for listing future changes in Google Drive. Returns only a token — pass it to GOOGLEDRIVE_LIST_CHANGES to retrieve actual changes. Persist this token; losing it requires a full rescan. The token is forward-looking: GOOGLEDRIVE_LIST_CHANGES may return no results if no changes have occurred since issuance. For simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE; use this tool only for incremental change-feed workflows.

Input Parameters

string
The ID of the shared drive for which the starting pageToken for listing future changes from that shared drive will be returned.
string
Deprecated: Use driveId instead.
boolean
Whether the requesting application supports both My Drives and shared drives. Defaults to false.
boolean
Deprecated: Use supportsAllDrives instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CHILDTool to get a specific child reference for a folder using Drive API v2. Use when you need to verify a specific file exists as a child of a folder.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format options.
string
Selector specifying which fields to include in a partial response.
string
required
The ID of the child.
string
JSONP callback parameter.
string
required
The ID of the folder.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_COMMENTTool to get a comment by ID. Use when you need to retrieve a specific comment from a Google Drive file and have both the file ID and comment ID.

Input Parameters

string
required
The ID of the file.
string
required
The ID of the comment.
boolean
Whether to return deleted comments. Deleted comments will not include their original content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CONDITIONAL_FORMAT_RULESList conditional formatting rules for each sheet (or a selected sheet) in a normalized, easy-to-edit form. Use when you need to view, audit, or prepare to modify conditional format rules.

Input Parameters

integer
Optional filter: return rules only for the sheet with this exact numeric sheetId. If not provided, returns rules for all sheets. If both sheet_title and sheet_id are provided, sheet_id takes precedence.
string
Optional filter: return rules only for the sheet with this exact title. If not provided, returns rules for all sheets.
string
required
Unique identifier of the Google Spreadsheet, typically found in its URL.
boolean
True if tables should be excluded in the banded ranges. False if not set.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CONFERENCE_RECORD_BY_NAMETool to get a specific conference record by its resource name. Use when you have the conference record ID and need to retrieve detailed information about a single meeting instance.

Input Parameters

string
required
Required. Resource name of the conference record. Format: ‘conferenceRecords/{conference_record}’ where {conference_record} is a unique ID for each instance of a call within a space. Example: ‘conferenceRecords/GLkPdCDLsjSXet2-QH9dDxIPOAIIigIgABgECA’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CONTACTSLists saved Google contacts with selectable fields and pagination, optionally including Other Contacts. Other Contacts are fetched on the first page; endpoint failures can result in partial results, and contact records may be sparse.

Input Parameters

string
Token to retrieve a specific page of results, obtained from ‘nextPageToken’ in a previous response. Repeat calls with each successive nextPageToken until it is absent — stopping early silently omits contacts.
string
Comma-separated person fields to retrieve for each contact (e.g., ‘names,emailAddresses’).
string
Identifier for the person resource whose connections are listed; use ‘people/me’ for the authenticated user.
boolean
Include ‘Other Contacts’ (interacted with but not explicitly saved) in addition to regular contacts. WARNING: ‘Other Contacts’ often have incomplete data - they may lack names, phone numbers, and other fields even when requested. These auto-generated contacts are created from email interactions and typically only have email addresses. Set to False if you need contacts with complete name information. When True, each contact will have a ‘contactSource’ field indicating its origin. When True, person_fields is restricted to emailAddresses, names, phoneNumbers, and metadata only — requesting other fields (e.g., organizations, birthdays) causes validation errors or silent omissions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CONVERSION_ACTION_TAG_SNIPPETSRetrieve provider-generated website or call conversion tag snippets after creating a conversion action. Markup is returned exactly as Google provides it.

Input Parameters

string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
string
required
Numeric Google Ads conversion action ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CONVERSION_INGESTION_STATUSRetrieve one Data Manager ingestion status snapshot. SUCCESS, FAILED, and PARTIAL_SUCCESS are terminal. PROCESSING and REQUEST_STATUS_UNKNOWN are not. The caller owns the documented backoff loop.

Input Parameters

string
required
Top-level request_id returned by an accepted INGEST_CONVERSION_EVENTS call. Do not use a Google Ads request-id header or an ID from an error detail; those transport diagnostics cannot be polled here.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CURRENT_DATE_TIMEGets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., ‘tomorrow’, ‘next Monday’) to avoid off-by-one-day errors across timezones.

Input Parameters

string
Timezone specification. Accepts: (1) IANA timezone identifier (e.g., ‘America/New_York’, ‘Asia/Kolkata’, ‘Europe/London’) - RECOMMENDED, (2) Common timezone abbreviations (e.g., ‘PST’, ‘EST’, ‘CST’, ‘GMT’, ‘UTC’) - will be auto-converted to IANA, or (3) Numeric UTC offset in hours (e.g., -5, 5.5). Use positive values for east of UTC, negative for west. Default 0 is UTC.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CURRENT_USERIdentifies the Google user connected to Calendar from the primary calendar resource. Returns the account identifier, email when available, display name, timezone, and primary calendar ID. This is Calendar identity metadata, not a full Google Account or People profile.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CUSTOM_DIMENSIONTool to retrieve a single CustomDimension by its resource name. Use when you need detailed information about a specific custom dimension including its display name, scope, and parameter name.

Input Parameters

string
required
Required. The resource name of the CustomDimension to retrieve. Must be in the exact format: properties/{property_id}/customDimensions/{customDimension_id} where both property_id and customDimension_id are numeric identifiers. IMPORTANT: Must start with ‘properties/’ prefix, contain exactly one ‘/customDimensions/’ segment, have no trailing slashes, and no additional path segments. Valid example: ‘properties/489591273/customDimensions/13661238280’. Invalid examples: ‘489591273/13661238280’ (missing prefix), ‘properties/489591273/customDimensions/13661238280/’ (trailing slash), ‘properties/489591273/customDimensions/13661238280/extra’ (extra segments)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_CUSTOMER_LISTSList a page of Google Ads customer lists (audience and remarketing user segments), not Google Ads accounts. Use the returned next-page token to retrieve further lists, and review similarly named results before selecting one.

Input Parameters

string
Pagination token from a previous response’s next_page_token.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DATA_MANAGER_USER_LISTGet one Data Manager user list without modifying it.

Input Parameters

string
required
Resource name: accountTypes/{accountType}/accounts/{account}/userLists/{userList}.
string
Optional login account resource name; defaults to the account in name.
string
Optional account resource name with an established product link to the login account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DATA_RETENTION_SETTINGSTool to retrieve data retention configuration for a Google Analytics property. Use when you need to check event-level and user-level data retention durations and reset settings.

Input Parameters

string
required
Required. The resource name of the data retention settings to retrieve. Must be in the exact format: properties/{property_id}/dataRetentionSettings where property_id is a numeric identifier. IMPORTANT: Must start with ‘properties/’ prefix, contain no forward slashes in the property_id, have no trailing slashes, and must end with ‘/dataRetentionSettings’. Valid example: ‘properties/489591273/dataRetentionSettings’. Invalid examples: ‘489591273’ (missing prefix), ‘properties/489591273’ (missing suffix), ‘properties/489591273/dataRetentionSettings/’ (trailing slash)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DATA_SHARING_SETTINGSTool to retrieve data sharing configuration for a Google Analytics account. Use when you need to check which data sharing settings are enabled for an account, including sharing with Google support, sales teams, products, and benchmarking.

Input Parameters

string
required
Required. The resource name of the data sharing settings to retrieve. Must be in the exact format: accounts/{account_id}/dataSharingSettings where account_id is a numeric identifier. IMPORTANT: Must start with ‘accounts/’ prefix, contain no forward slashes in the account_id, have no trailing slashes, and must end with ‘/dataSharingSettings’. Valid example: ‘accounts/1000/dataSharingSettings’. Invalid examples: ‘1000’ (missing prefix), ‘accounts/1000’ (missing suffix), ‘accounts/1000/dataSharingSettings/’ (trailing slash)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DATA_VALIDATION_RULESTool to extract data validation rules from a Google Sheets spreadsheet. Use when you need to understand dropdown lists, allowed values, custom formulas, or other validation constraints for cells.

Input Parameters

array
Optional list of A1 ranges to scan. If omitted, the entire sheet(s) will be scanned. WARNING: Scanning entire large sheets may be slow.
integer
Optional sheet ID to filter by. If omitted, all sheets will be scanned.
string
Optional sheet title to filter by. If omitted, all sheets will be scanned.
boolean
If true, include cells without validation rules in the output. Default is false.
string
required
The ID of the spreadsheet to request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DIRECTIONFetches directions between an origin and destination, with optional intermediate waypoints, travel modes, and preferences for avoiding tolls, highways, or ferries. DEPRECATED: Use the Google Maps Routes API instead. The legacy Directions API is not available to new Cloud projects; existing projects can continue to use it.

Input Parameters

string ("driving" | "walking" | "bicycling" | "transit")
The mode of transportation for which to calculate directions.
string
Specifies features to avoid in the generated route. Multiple values can be combined using a pipe delimiter (e.g., ‘tolls|highways’). Valid options include ‘tolls’, ‘highways’, and ‘ferries’.
string ("metric" | "imperial")
The unit system for displaying distances. Defaults to ‘imperial’.
string
required
The starting point for the directions. This can be a textual address (e.g., ‘123 Main St, Los Angeles, CA’), a place name (e.g., ‘Disneyland’), or latitude/longitude coordinates (e.g., ‘34.0522,-118.2437’).
string
The language code for returning results, e.g., ‘en’ for English, ‘es’ for Spanish. Defaults to ‘en’.
string
A pipe-separated (|) string of intermediate locations (addresses, place names, or coordinates) to visit between the origin and destination. For example: ‘Anaheim, CA|Long Beach, CA’ or ‘Hollywood Bowl|Getty Center’.
string
required
The ending point for the directions. This can be a textual address (e.g., ‘456 Park Ave, New York, NY’), a place name (e.g., ‘Universal Studios Hollywood’), or latitude/longitude coordinates (e.g., ‘40.7128,-74.0060’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DOCS_DRIVE_FILE_METADATAGet selected metadata fields for one Google Drive file by ID.

Input Parameters

string
Drive partial-response field selector.
string
required
Opaque Google Drive file ID.
string
Comma-separated label IDs to include in labelInfo.
boolean
Whether the request supports files in My Drive and shared drives.
string
Include permissions for the published view.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DOCS_SPREADSHEET_VALUESRead cell values from one range in a Google Sheets spreadsheet.

Input Parameters

string
required
An A1 or R1C1 notation range to read, including a sheet name when needed, such as ‘Sheet1!A1:D100’.
string
required
The Google Sheets spreadsheet ID from the spreadsheet URL.
string ("ROWS" | "COLUMNS")
Whether the outer values array represents rows or columns.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How cell values are represented in the response.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How dates, times, and durations are represented when value_render_option is UNFORMATTED_VALUE.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DOCUMENTRetrieve a native Google Docs document’s structured content and metadata by ID.

Input Parameters

string
required
The unique ID of a native Google Docs document. Provide the ID itself, not a document title or URL.
boolean
When true, return content for every tab under tabs. When false, return the first tab through legacy top-level fields such as body, headers, and footers.
string ("DEFAULT_FOR_CURRENT_ACCESS" | "SUGGESTIONS_INLINE" | "PREVIEW_SUGGESTIONS_ACCEPTED" | "PREVIEW_WITHOUT_SUGGESTIONS")
How suggested changes are represented in the returned document.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DOCUMENT_BY_IDRetrieves an existing Google Document by its ID; will error if the document is not found.

Input Parameters

string
required
The unique identifier for a native Google Docs document (typically a 44-character alphanumeric string). Accepts either a document ID or a full Google Docs URL (e.g., https://docs.google.com/document/d/&#123;DOCUMENT_ID&#125;/edit). When a URL is provided, the document ID will be automatically extracted. IMPORTANT: This tool only works with native Google Docs documents (mimeType application/vnd.google-apps.document), not uploaded Office files (DOCX, XLSX, etc.) stored in Google Drive. Use GOOGLEDOCS_SEARCH_DOCUMENTS to find available documents.
boolean
When true, request includeTabsContent=true so the response includes document.tabs with content for all tabs. When false, Google Docs returns the legacy first-tab content fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DOCUMENT_END_INDEXRetrieves the end index and paragraph structure of a Google Document or specific segment. Use this action when you need to determine valid insertion points for text operations, especially before using insertText requests. The end index represents the maximum boundary of the document body or specified segment (header, footer, footnote, or tab).

Input Parameters

string
The ID of the document tab to get the end index from. When omitted, the request is applied to the first tab.
string
The ID of the header, footer, or footnote segment to get the end index for. Leave empty or omit to get the end index of the document body.
string
required
The ID of the document to retrieve the end index from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DOCUMENT_PLAINTEXTRetrieve a Google Doc by ID and return a best-effort plain-text rendering. Converts document structure into plain text including paragraphs, lists, and tables without requiring clients to traverse complex Docs API JSON.

Input Parameters

array
Optional tab IDs to include when include_tabs_content=true. Nested child tabs are searched recursively.
string
required
The unique identifier for the Google Document. Accepts either a document ID (typically a 44-character alphanumeric string) or a full Google Docs URL. When a URL is provided, the document ID will be automatically extracted. Note: This parameter also accepts ‘id’ as an alias for consistency with other GOOGLEDOCS tools.
boolean
Whether to include table content in the plain text output. Tables are rendered with configurable cell and row delimiters.
boolean
Whether to include footer text in the plain text output. Footers are appended with a clear section separator.
boolean
Whether to include header text in the plain text output. Headers are appended with a clear section separator.
boolean
Whether to include footnote text in the plain text output. Footnotes are appended with a clear section separator.
string
The delimiter to use between table rows (default: newline character).
boolean
When true, fetch the document using includeTabsContent=true query parameter to render all tabs. When false, only the main body content is rendered.
string
The delimiter to use between table cells (default: tab character).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DRAFTRetrieves a single Gmail draft by its ID. Use this to fetch and inspect draft content before sending via GMAIL_SEND_DRAFT. The format parameter controls the level of detail returned.

Input Parameters

string
Format for the draft message: ‘minimal’ (ID/labels only), ‘full’ (complete data with parsed payload), ‘raw’ (base64url-encoded RFC 2822 format), ‘metadata’ (ID/labels/headers only).
string
The user’s email address. The special value me can be used to indicate the authenticated user.
string
required
The ID of the draft to retrieve. Draft IDs are typically alphanumeric strings (e.g., ‘r99885592323229922’). Use GMAIL_LIST_DRAFTS to retrieve valid draft IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DRIVETool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive. To discover drive_ids, use GOOGLEDRIVE_LIST_SHARED_DRIVES first; GOOGLEDRIVE_GET_ABOUT reflects overall user storage, not individual shared drive details. Permission changes may have a brief propagation delay before appearing in results.

Input Parameters

string
required
The ID of the shared drive.
boolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_DRIVE_FILE_METADATAGet JSON metadata for one Drive file without downloading its content.

Input Parameters

string
Google partial-response field mask for any valid Drive File fields, for example id,name,mimeType,modifiedTime or permissions(id,emailAddress,role). Omit for Drive’s default metadata projection; use * only when the larger response is needed.
string
required
Opaque Drive file ID to inspect, not a file name. A Google Sheets spreadsheet ID is also its Drive file ID.
string
Comma-separated Drive label IDs to include in labelInfo. Include labelInfo in fields when using a custom projection.
boolean
Whether the caller supports both My Drive and shared-drive files. Defaults to true so a valid shared-drive file ID works.
string
Set to published to include permissions for the published view. Include permissions in fields when using a custom projection.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_EXPERIMENTGet one Google Ads experiment by resource name or numeric ID.

Input Parameters

string
required
Numeric experiment ID or full experiment resource name.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_EXPERIMENT_ARMGet one Google Ads experiment arm, including draft campaigns.

Input Parameters

string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
string
required
Full experiment arm resource name in the form customers/{customer_id}/experimentArms/{experiment_id}~{arm_id}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_FILE_METADATAGets a Drive file’s metadata by ID, optionally returning only the metadata selected by fields. Use fields such as id,name,mimeType,parents,modifiedTime when a compact partial response is needed; omit it for Google’s default metadata. This does not download file content: use GOOGLEDRIVE_DOWNLOAD_FILE for native bytes or exported Workspace content.

Input Parameters

string
Comma-separated list of fields to include in the response. Use this for partial responses to request only specific metadata fields. Common fields: id, name, mimeType, webViewLink, webContentLink, createdTime, modifiedTime, size, quotaBytesUsed, parents, owners, permissions. Use '' to return all available fields. Note: The deprecated v2 field ‘alternateLink’ is automatically migrated to ‘webViewLink’. Example: ‘id,name,mimeType,webViewLink,createdTime,modifiedTime’. Most fields (webViewLink, parents, owners, size, modifiedTime, etc.) are omitted by default — explicitly list required fields or use '' (increases latency). md5Checksum is null for native Google Workspace files (Docs/Sheets/Slides); use mimeType to classify items — folders use mimeType='application/vnd.google-apps.folder' and Workspace files return size=null. modifiedTime is RFC 3339 UTC format.
string
required
The Google Drive file ID (an opaque alphanumeric string like ‘1a2b3c4d5e6f7g8h9i0j’), NOT a file name. If you only have a file name, use GOOGLEDRIVE_FIND_FILE or GOOGLEDRIVE_LIST_FILES to get the file ID first.
string
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
boolean
Whether the requesting application supports both My Drives and shared drives. Defaults to true to ensure files in shared drives are accessible.
string
Specifies which additional view’s permissions to include in the response. Only ‘published’ is supported.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_FILE_PROPERTYTool to get a property by its key using Google Drive API v2. Use when you need to retrieve a specific custom property attached to a file.

Input Parameters

string
required
The ID of the file.
string
The visibility of the property. Allowed values are PRIVATE (default) and PUBLIC. Private properties can only be retrieved using an authenticated request.
string
required
The key of the property.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_FILE_V2Retrieves metadata for a Google Drive file by ID using the v2 API, optionally selecting fields for a partial response. DEPRECATED: Use GetFileMetadata instead. This action does not support returning file content as a media download.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format values.
string
Selector specifying which fields to include in a partial response.
string
required
The ID for the file in question. This is a required parameter and cannot be empty.
string
JSONP callback function name.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string ("BASIC" | "FULL")
Projection parameter values (deprecated).
string
Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).
boolean
Whether the user is acknowledging the risk of downloading known malware or other abusive files.
boolean
Deprecated: Use files.update with modifiedDateBehavior=noChange, updateViewedDate=true and an empty request body.
boolean
Whether the requesting application supports both My Drives and shared drives.
boolean
Deprecated: Use supportsAllDrives instead.
string
Specifies which additional view’s permissions to include in the response. Only ‘published’ is supported.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_FILTERTool to retrieve a specific Gmail filter by its ID. Use when you need to inspect the criteria and actions of an existing filter.

Input Parameters

string
required
The ID of the filter to be fetched.
string
The user’s email address or the special value ‘me’ to indicate the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_FORMRetrieve a Google Form’s definition, questions, settings, and publishing state by ID.

Input Parameters

string
required
The unique Google Form ID. In a Forms editor URL, this is the value after ‘/forms/d/’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_GOOGLE_SIGNALS_SETTINGSTool to retrieve Google Signals configuration settings for a GA4 property. Use when you need to check whether Google Signals is enabled and the consent status for a property.

Input Parameters

string
required
Required. The resource name of the Google Signals settings to retrieve. Must be in the exact format: properties/{property_id}/googleSignalsSettings where property_id is a numeric identifier. IMPORTANT: Must start with ‘properties/’ prefix, contain no forward slashes in the property_id, have no trailing slashes, and must end with ‘/googleSignalsSettings’. Valid example: ‘properties/1000/googleSignalsSettings’. Invalid examples: ‘1000’ (missing prefix), ‘properties/1000’ (missing suffix), ‘properties/1000/googleSignalsSettings/’ (trailing slash)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_KEY_EVENTRetrieve a Key Event by its resource name. This operation is read-only.

Input Parameters

string
required
Required. Resource name of the Key Event to retrieve. Format: properties/{property}/keyEvents/{keyEvent}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_LABELGets details for a specified Gmail label. Use this to retrieve label information including name, type, visibility settings, message/thread counts, and color.

Input Parameters

string
required
The ID of the label to retrieve. Can be a system label (e.g., INBOX, SENT, DRAFT, UNREAD, STARRED, SPAM, TRASH) or a user-created label ID (e.g., Label_1, Label_42).
string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_LANGUAGE_SETTINGSTool to retrieve the language settings for a Gmail user. Use when you need to determine the display language preference for the authenticated user or a specific Gmail account.

Input Parameters

string
The email address of the Gmail user whose language settings are to be retrieved, or the special value ‘me’ to indicate the currently authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_MEDIA_ITEM_DOWNLOADDownloads an app-created Google Photos media item and returns it as a file.

Input Parameters

string
required
ID of the media item to download

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_MEETRetrieve details of a Google Meet space using its unique identifier. Newly created spaces may return incomplete data; retry after 1–3 seconds if needed.

Input Parameters

string
required
The unique identifier (space ID) for the Google Meet space. Provide only the raw space ID without the ‘spaces/’ prefix. Example: ‘mV63iV9-KxoB’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_MEMBERGet a configured Google Meet space member by resource name, including their email and meeting role. Use when the space and member identifiers are already known.

Input Parameters

string
required
Required. Resource name of the member: spaces/{space}/members/{member}.
string
Optional partial-response field selector. If omitted, the API defaults to name,email,role,user. Can request other supported system fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_METADATATool to get metadata for dimensions, metrics, and comparisons for a GA4 property. Use to discover available fields before building a report — always derive dimension/metric apiNames from this output rather than hardcoding from GA4 UI labels, which differ. Available fields vary per property; skip validation and downstream report tools like GOOGLE_ANALYTICS_RUN_REPORT return 400 INVALID_ARGUMENT on incompatible or invalid field combinations. Response can contain hundreds of fields; filter to relevant subset before passing to downstream logic.

Input Parameters

string
required
Resource name of the metadata to retrieve. Format: properties/{property_id}/metadata. Use property_id=0 to return only universal (non-custom) metadata.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PAGE_THUMBNAIL2Tool to generate a thumbnail of the latest version of a specified page. Use when you need a preview image URL for a slide page. This request counts as an expensive read request for quota purposes.

Input Parameters

string
required
The object ID of the page whose thumbnail to retrieve.
string
required
The ID of the presentation to retrieve.
string
The optional mime type of the thumbnail image. Defaults to PNG if not specified.
string ("THUMBNAIL_SIZE_UNSPECIFIED" | "LARGE" | "MEDIUM" | "SMALL")
The optional thumbnail image size. LARGE = 1600px, MEDIUM = 800px, SMALL = 200px. Defaults to LARGE if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PARENTTool to get a specific parent reference for a file using Drive API v2. Use when you need to retrieve information about a specific parent folder of a file.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format options.
string
Selector specifying which fields to include in a partial response.
string
required
The ID of the file.
string
JSONP callback parameter.
string
required
The ID of the parent.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PARTICIPANTGet a Google Meet conference participant by resource name, including their identity and first-join/last-leave times. Use when the conference record and participant IDs are known.

Input Parameters

string
required
Required. Participant resource name: conferenceRecords/{record}/participants/{id}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PARTICIPANT_SESSIONRetrieves detailed information about a specific participant session from a Google Meet conference record. Returns session details including start time and end time for a single join/leave session. A participant session represents each unique join or leave session when a user joins a conference from a device. If a user joins multiple times from the same device, each join creates a new session. PREREQUISITE: You must first obtain the participant session resource name. Use LIST_PARTICIPANT_SESSIONS with a conference record ID and participant ID to get available sessions and their resource names. The ‘name’ parameter is REQUIRED and must be in the format: ‘conferenceRecords/{conference_record}/participants/{participant}/participantSessions/{participant_session}‘

Input Parameters

string
required
Required. Full resource name of the participant session to retrieve. Format: ‘conferenceRecords/{conference_record}/participants/{participant}/participantSessions/{participant_session}’. You can obtain this value from the ‘name’ field returned by the LIST_PARTICIPANT_SESSIONS action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PEOPLERetrieves a person’s details by resource name or lists the authenticated user’s Other Contacts, using a field mask to select the information returned. Other Contacts can be paginated and queried using a sync token for changes since a previous sync.

Input Parameters

array
Source types to include when retrieving other contacts. READ_SOURCE_TYPE_CONTACT supports basic fields (emailAddresses, metadata, names, phoneNumbers, photos). READ_SOURCE_TYPE_PROFILE supports extended fields (birthdays, genders, organizations, etc.) but requires READ_SOURCE_TYPE_CONTACT to also be included. Applicable only when other_contacts is true.
integer
The number of ‘Other Contacts’ to return per page. Applicable only when other_contacts is true.
string
An opaque token from a previous response to retrieve the next page of ‘Other Contacts’ results. Applicable only when other_contacts is true and paginating.
string
A token from a previous ‘Other Contacts’ list call to retrieve only changes since the last sync; leave empty for an initial full sync. Applicable only when other_contacts is true.
string
A comma-separated field mask to restrict which fields on the person (or persons) are returned. Consult the Google People API documentation for a comprehensive list of valid fields. Omitted fields are silently absent from the response — no error is raised. When other_contacts is true, only a restricted subset is valid (emailAddresses, names, phoneNumbers, metadata); extended fields like organizations or birthdays may cause validation errors or silent omissions in that mode.
string
Resource name identifying the person for whom to retrieve information (like the authenticated user or a specific contact). Used only when other_contacts is false. Deleted or stale resource_names may return partial records with missing emailAddresses, names, or other fields.
boolean
If true, retrieves ‘Other Contacts’ (people interacted with but not explicitly saved), ignoring resource_name and enabling pagination/sync. If false, retrieves information for the single person specified by resource_name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PERMISSIONGets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive. Newly created or updated permissions on shared drives may have a brief propagation delay before appearing.

Input Parameters

string
Selector specifying which fields to include in a partial response. Use ‘fields=*’ to return all available fields for the permission resource.
string
required
The ID of the file.
string
required
The numeric ID of the permission. Note: The ‘me’ alias is NOT supported by the Google Drive permissions API. You must provide an actual numeric permission ID (e.g., ‘12345678901234567890’). Use the LIST_PERMISSIONS action to get permission IDs for a file.
boolean
Whether the requesting application supports both My Drives and shared drives.
boolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PERMISSION_ID_FOR_EMAILTool to get the permission ID for an email address using the Drive API v2. Use when you need to convert an email address to its corresponding permission ID.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string
required
The email address for which to return a permission ID
string ("1" | "2")
V1 error format options.
string
Selector specifying which fields to include in a partial response.
string
JSONP callback parameter.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PLACE_DETAILSRetrieves details for a specific place by place ID or resource name. The returned details depend on the requested field mask; by default, it requests the ID, display name, and formatted address.

Input Parameters

string
required
Google Place ID ONLY - an alphanumeric code (NOT a business name, address, or search query). Accepts ‘places/{place_id}’ or just the place_id. Place IDs typically start with ‘ChIJ’ followed by alphanumeric characters. To find a place ID from a business name, first use TEXT_SEARCH or NEARBY_SEARCH.
string
Comma-separated list of place fields to return (no spaces allowed). Use ’*’ for all fields (not recommended for performance/cost). Common fields: id, displayName, formattedAddress, location, types, rating, photos, reviews, regularOpeningHours, nationalPhoneNumber, internationalPhoneNumber, websiteUri, googleMapsUri. Note: ‘emailAddress’ and ‘phoneNumber’ are NOT valid fields - use ‘nationalPhoneNumber’ or ‘internationalPhoneNumber’ instead.
string
Unicode country/region code (CLDR format) for region-specific display names. Examples: ‘US’, ‘GB’, ‘FR’, ‘JP’. This affects how place names and addresses are formatted.
string
Preferred language code for place details (BCP-47 format). Examples: ‘en’ (English), ‘es’ (Spanish), ‘fr’ (French), ‘ja’ (Japanese). If not specified, defaults to the language of the request location.
string
URL-safe base64 string (max 36 characters) for Autocomplete session billing. Used to group this request with previous Autocomplete requests for billing purposes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PRESENTATIONRetrieves a Google Slides presentation by ID, including its page structures. An optional field selector can limit the returned data.

Input Parameters

string
A Google API partial-response selector. Use comma-separated field names and parentheses for nested fields, such as ‘presentationId,title’ or ‘slides(objectId,pageElements(objectId,shape))’. If omitted, Google returns the full presentation resource.
string
required
The Google Slides presentation ID from its URL, not its title.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PRESENTATION_PAGE_THUMBNAILGenerate one short-lived page thumbnail URL using an expensive Slides quota read.

Input Parameters

string
Thumbnail image format. Google currently supports only PNG.
string
required
The object ID of the slide, master, layout, notes page, or notes master to render. Obtain slide IDs from GOOGLEDRIVE_GET_PRESENTATION slides[].objectId.
string ("LARGE" | "MEDIUM" | "SMALL")
Maximum thumbnail width while preserving aspect ratio: LARGE is 1600 px, MEDIUM is 800 px, and SMALL is 200 px.
string
required
The Google Slides presentation ID from its URL, not its title.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PROFILERetrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user. messagesTotal counts individual emails; threadsTotal counts conversations; neither is per-label — use GMAIL_FETCH_EMAILS with label filters for label-specific counts. The returned historyId seeds incremental sync via GMAIL_LIST_HISTORY; if historyIdTooOld is returned, rescan with GMAIL_FETCH_EMAILS before resuming. Response may be wrapped under a top-level data field; unwrap before reading fields. A successful call confirms mailbox connectivity but not full mailbox access if granted scopes are narrow. Use the returned email address to dynamically identify the authenticated account rather than hard-coding it.

Input Parameters

string
The email address of the Gmail user whose profile is to be retrieved, or the special value ‘me’ to indicate the currently authenticated user. Prefer ‘me’ unless explicitly targeting another account; passing a raw email address that does not match the connected account may fail or access the wrong mailbox.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PROPERTYTool to retrieve a single GA4 Property by its resource name. Use when you need detailed property configuration including display name, time zone, currency, and other settings.

Input Parameters

string
required
Required. The resource name of the Property to retrieve. Must be in the exact format: properties/{property_id} where property_id is a numeric identifier. IMPORTANT: Must start with ‘properties/’ prefix, contain no forward slashes in the property_id, have no trailing slashes, and no additional path segments. Valid example: ‘properties/489591273’. Invalid examples: ‘489591273’ (missing prefix), ‘properties/489591273/’ (trailing slash), ‘properties/489591273/extra’ (extra segments)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_PROPERTY_QUOTAS_SNAPSHOTTool to retrieve all property quotas organized by category (corePropertyQuota, funnelPropertyQuota, realtimePropertyQuota) for a given GA4 property. Use when you need to check current quota usage. Snapshot data can lag real consumption by several minutes; treat reported values as approximate and avoid scheduling high-volume jobs at full apparent capacity.

Input Parameters

string
required
Required. The property resource. Format: properties/{property_id}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_RECORDINGGet a Google Meet recording’s metadata by resource name, including its state, timestamps, and Google Drive destination when available. Use when the conference record and recording identifiers are known; this does not download the recording file.

Input Parameters

string
required
Required. Resource name of the recording: conferenceRecords/{record}/recordings/{id}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_RECORDINGS_BY_CONFERENCE_RECORD_IDRetrieves recordings from Google Meet for a given conference record ID. Only returns recordings if recording was enabled and permitted by the organizer’s domain policies; a valid conference_record_id does not guarantee recordings exist. After a meeting ends, recordings may take several minutes to process — an empty result may be temporary, not permanent.

Input Parameters

string
required
Unique identifier for the conference record.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_RECURRING_AUDIENCE_LISTTool to get configuration metadata about a specific recurring audience list. Use when you need to understand a recurring audience list’s state after it has been created or to get the resource name of the most recent audience list instance.

Input Parameters

string
required
Required. The recurring audience list resource name. Format: properties/{property}/recurringAudienceLists/{recurring_audience_list}

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_REPLYTool to get a specific reply to a comment on a file. Use when you need to retrieve the details of a particular reply.

Input Parameters

string
required
The ID of the file.
string
required
The ID of the reply.
string
required
The ID of the comment.
boolean
Whether to return deleted replies. Deleted replies will not include their original content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_REPORT_TASKTool to get report metadata about a specific report task. Use after creating a report task to check its processing state or inspect its report definition.

Input Parameters

string
required
Required. The report task resource name. Format: properties/{property}/reportTasks/{reportTask}

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_REVISIONTool to get a specific revision’s metadata (name, modifiedTime, keepForever, etc.) by revision ID. Returns metadata only — not file content. Use a separate download tool to retrieve file content or restore a revision.

Input Parameters

string
required
The ID of the file.
string
required
The ID of the revision.
boolean
Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the alt parameter is set to media and the user is the owner of the file or an organizer of the shared drive in which the file resides.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_RMF_REPORTRun a prominent, bounded Google Ads report template for Customer, Campaign, Ad, Keyword, Search Term, Dynamic Search Ads Search Term, or Bidding Strategy. Official required columns are always selected; dates default to LAST_30_DAYS.

Input Parameters

string ("CUSTOMER" | "CAMPAIGN" | "AD_GROUP_AD" | "KEYWORD" | "SEARCH_TERM" | "DYNAMIC_SEARCH_AD_SEARCH_TERM" | "BIDDING_STRATEGY")
required
Required Google Ads report template. Each template always includes its official RMF columns plus useful identity columns.
string
Optional inclusive report end date in YYYY-MM-DD format.
integer
Maximum rows returned. The action queries one extra row and reports truncated=true instead of silently dropping results.
string
Optional inclusive report start date in YYYY-MM-DD format.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
array
Additional v26 metrics compatible with the selected report, such as metrics.ctr. Required columns cannot be removed. Google validates resource compatibility.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_ROUTECalculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps. Response duration is a string with ‘s’ suffix (e.g., "4557s"); parse before displaying.

Input Parameters

string ("METRIC" | "IMPERIAL")
Unit system (e.g., ‘METRIC’ for kilometers, ‘IMPERIAL’ for miles) for displaying distances. Note: routes.distanceMeters in the response is always in meters regardless of this setting; units only affects human-readable distance formatting in other fields.
string
Comma-separated list of Route object fields to include in the response (e.g., ‘routes.distanceMeters,routes.duration’). If not specified, a default fieldMask is used based on travelMode: for TRANSIT mode, transit-specific fields (transitDetails, steps, etc.) are included; for other modes, basic route fields (distanceMeters, duration, polyline) are included. Fields not listed are absent from the response; explicitly include all needed fields such as routes.legs.steps and routes.polyline.encodedPolyline.
boolean
Attempts to avoid toll roads if true.
string ("DRIVE" | "BICYCLE" | "WALK" | "TWO_WHEELER" | "TRANSIT")
Mode of transportation for the route.
boolean
Attempts to avoid ferries if true.
string
BCP-47 language code (e.g., ‘en-US’, ‘es’) for textual information like navigation instructions.
boolean
Attempts to avoid highways if true.
string
required
Starting point for the route calculation. Can be an address (e.g., ‘1600 Amphitheatre Parkway, Mountain View, CA’) or coordinates as ‘latitude,longitude’ (e.g., ‘48.8566,2.3522’).
string ("ROUTING_PREFERENCE_UNSPECIFIED" | "TRAFFIC_UNAWARE" | "TRAFFIC_AWARE" | "TRAFFIC_AWARE_OPTIMAL")
Specifies factors to consider when calculating the route.
string
required
Destination point for the route calculation. Can be an address (e.g., ‘85 10th Ave, New York, NY’) or coordinates as ‘latitude,longitude’ (e.g., ‘40.7484,-73.9967’).
boolean
Computes and returns alternative routes if true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_SHEET_NAMESLists all worksheet names from a specified Google Spreadsheet (which must exist), useful for discovering sheets before further operations.

Input Parameters

boolean
When True, hidden sheets will be excluded from the results. When False (default), all sheets including hidden ones are returned. Hidden sheets are sheets that have been hidden via the ‘Hide sheet’ option in Google Sheets UI.
string
required
The unique identifier of the Google Spreadsheet (alphanumeric string, typically 44 characters). Extract only the ID portion from URLs - do not include leading/trailing slashes, ‘/edit’ suffixes, query parameters, or URL fragments. From ‘https://docs.google.com/spreadsheets/d/1qpyC0XzvTcKT6EISywY/edit#gid=0’, use only ‘1qpyC0XzvTcKT6EISywY’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_SMART_NOTEGet metadata for a Google Meet smart note generated by Take Notes with Gemini. Use when the conference record and smart note identifiers are known. Returns state, timestamps, and the Google Docs destination when available, not the full note content. Fetch document content separately with the Google Docs API.

Input Parameters

string
required
Required. Resource name of the smart note: conferenceRecords/{record}/smartNotes/{note}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_SPREADSHEETRetrieve a Google Spreadsheet’s structure, metadata, and selected grid data.

Input Parameters

string
Google partial-response selector, for example ‘spreadsheetId,properties(title),sheets(properties(sheetId,title))’. Omit for Google’s full normal response. When present it overrides include_grid_data behavior; explicitly select sheets.data or descendants to receive grid data.
array
Up to 10 A1 ranges whose sheet data should be returned. Use bounded ranges such as ‘Sheet1!A1:D100’; omit to address the whole spreadsheet resource.
string
required
The spreadsheet ID from its Google Sheets URL, not its title or full URL.
boolean
Include cell grid data for the requested ranges. This can produce a large response. When fields is supplied, Google ignores includeGridData, so this query parameter is omitted and the fields mask must select sheets.data descendants.
boolean
Exclude table data embedded in banded ranges from the response. Leave false to include it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_SPREADSHEET_BY_DATA_FILTERReturns the spreadsheet at the given ID, filtered by the specified data filters. Use this tool when you need to retrieve specific subsets of data from a Google Sheet based on criteria like A1 notation, developer metadata, or grid ranges. Important: This action is designed for filtered data retrieval. While it accepts empty filters and returns full metadata in that case, GOOGLESHEETS_GET_SPREADSHEET_INFO is the recommended action for unfiltered spreadsheet retrieval.

Input Parameters

array
The DataFilters used to select which ranges to retrieve. Supports A1 notation (e.g., ‘Sheet1!A1:B2’), developer metadata lookup, or grid range filters. If empty or omitted, returns full spreadsheet metadata. Recommended: Use GOOGLESHEETS_GET_SPREADSHEET_INFO for unfiltered retrieval as it is the dedicated action for that purpose.
string
required
The ID of the spreadsheet to request.
boolean
True if grid data should be returned. Ignored if a field mask is set.
boolean
True if tables should be excluded in the banded ranges. False if not set.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_SPREADSHEET_INFORetrieves metadata for a Google Spreadsheet using its ID. By default, returns essential information (ID, title, sheet properties) to avoid payload size issues. Use the fields parameter for comprehensive metadata or specific fields.

Input Parameters

string
Optional. Field mask specifying which fields to return. Uses Google’s field mask syntax (comma-separated, dot-notation for nested fields). If not specified, a default mask returning common fields (spreadsheet ID, title, sheet properties) is applied to avoid payload size issues. For full metadata, use ’*’ (not recommended for large spreadsheets). When set, includeGridData is ignored. Examples: ‘sheets.properties(sheetId,title)’, ‘properties.title,sheets.properties.sheetId’.
array
Optional. The ranges to retrieve from the spreadsheet, specified using A1 notation (e.g., ‘Sheet1!A1:D5’, ‘Sheet2!A1:C4’). Multiple ranges can be requested simultaneously. If not specified, metadata for the entire spreadsheet is returned without grid data.
string
Required. The Google Sheets spreadsheet ID or full URL. Accepts either the ID alone (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’) or a full Google Sheets URL (e.g., ‘https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit’). The ID will be automatically extracted from URLs. Note: Published/embedded URLs (containing ‘/d/e/2PACX-…’) are not supported.
boolean
Optional. If true, grid data will be returned. This parameter is ignored if a field mask was set in the request. When false or not specified, only metadata is returned without cell values.
boolean
Optional. If true, tables within banded ranges will be omitted from the response. Default is false when not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_SPREADSHEET_VALUESRead values from one range in a Google Spreadsheet.

Input Parameters

string
required
An A1 or R1C1 range to read, such as ‘Sheet1!A1:D100’. Prefer a bounded range; whole-sheet or whole-column ranges can return very large responses.
string
required
The spreadsheet ID from its Google Sheets URL, not its title.
string ("ROWS" | "COLUMNS")
Whether the outer values array represents rows or columns. If omitted, Google defaults to ROWS.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How cell values are rendered: formatted display values, unformatted calculated values, or formulas.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How dates, times, and durations are rendered when value_render_option is UNFORMATTED_VALUE.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_TABLE_SCHEMADeprecated: Retrieves an inferred schema for a detected table in a Google Spreadsheet, including column names and types estimated from sampled data.

Input Parameters

string
Sheet/tab name if table_name is ambiguous across multiple sheets
string
required
Table name from LIST_TABLES response OR the visible Google Sheets tab name (e.g., ‘Sales Data’, ‘Projections’). Use ‘auto’ to analyze the largest/most prominent table.
integer
Number of rows to sample for type inference
string
required
The unique identifier of the Google Spreadsheet. Must be a valid Google Sheets ID (typically a 44-character alphanumeric string). Do NOT use ‘auto’ - only ‘table_name’ supports auto-detection. You can get this ID from the spreadsheet URL or from SEARCH_SPREADSHEETS action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_TASKRetrieve a specific Google Task. REQUIRES both tasklist_id and task_id. Tasks cannot be retrieved by ID alone - you must always specify which task list contains the task. Use this to refresh task details before display or edits rather than relying on potentially stale results from GOOGLETASKS_LIST_TASKS.

Input Parameters

string
required
REQUIRED. Unique identifier of the Google Task to retrieve. Must be used together with tasklist_id.
string
required
REQUIRED. Unique identifier of the Google Tasks list containing the task. You must always provide this parameter - tasks cannot be retrieved by task_id alone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_TASK_LISTRetrieves a specific task list from the user’s Google Tasks if the tasklist_id exists for the authenticated user.

Input Parameters

string
required
The unique identifier of the task list to retrieve, assigned by Google Tasks when the list is created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_TEAM_DRIVETool to get metadata about a Team Drive by ID. Deprecated: Use the drives.get endpoint instead.

Input Parameters

string
required
The ID of the Team Drive
boolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_TIME_ZONERetrieves time zone information for a specific geographic location and timestamp. Use this action when you need to determine the time zone ID, UTC offset, daylight savings offset, or localized time zone name for any point on Earth. The API considers the provided timestamp to accurately determine whether daylight savings is in effect at that moment.

Input Parameters

string ("ar" | "bg" | "bn" | "ca" | "cs" | "da" | "de" | "el" | "en" | "en-AU" | "en-GB" | "es" | "eu" | "fa" | "fi" | "fil" | "fr" | "gl" | "gu" | "hi" | "hr" | "hu" | "id" | "it" | "iw" | "ja" | "kn" | "ko" | "lt" | "lv" | "ml" | "mr" | "nl" | "no" | "pl" | "pt" | "pt-BR" | "pt-PT" | "ro" | "ru" | "sk" | "sl" | "sr" | "sv" | "ta" | "te" | "th" | "tl" | "tr" | "uk" | "vi" | "zh-CN" | "zh-TW")
Supported language codes for Google Maps API.
string
required
A comma-separated latitude,longitude tuple representing the location to look up. For example: ‘39.6034810,-119.6822510’.
integer
required
The desired time as seconds since midnight, January 1, 1970 UTC (Unix epoch time). The API uses this timestamp to determine whether Daylight Savings should be applied for the location’s time zone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_TRANSCRIPTRetrieves a specific transcript by its resource name. Returns transcript details including state (STARTED, ENDED, FILE_GENERATED), start/end times, and Google Docs destination. PREREQUISITE: Obtain the transcript resource name first by using GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID or construct it from known IDs.

Input Parameters

string
required
Required. Resource name of the transcript. Format: ‘conferenceRecords/{conferenceRecord}/transcripts/{transcript}’. You can obtain this from the ‘Get Transcripts by Conference Record ID’ action or construct it using known conference record and transcript IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_TRANSCRIPT_ENTRYFetches a single transcript entry by resource name for targeted inspection or incremental processing. Use when you have a specific transcript entry resource name and need to retrieve its details (text, speaker, timestamps, language). PREREQUISITE: Obtain the transcript entry resource name first by using LIST_TRANSCRIPT_ENTRIES or construct it from known IDs. The ‘name’ parameter is REQUIRED and must follow the format: ‘conferenceRecords/{conferenceRecordId}/transcripts/{transcriptId}/entries/{entryId}‘

Input Parameters

string
required
Required. Full resource name of the transcript entry. Format: ‘conferenceRecords/{conferenceRecordId}/transcripts/{transcriptId}/entries/{entryId}’. You can obtain this from the LIST_TRANSCRIPT_ENTRIES action or construct it using known conference record, transcript, and entry IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_IDLists a page of transcripts for a Google Meet conference record, with a continuation token when more results are available. Transcripts may require processing time after a meeting ends; an empty result may be transient or indicate that no transcript was generated.

Input Parameters

integer
Maximum number of transcripts to return. The service might return fewer than this value. If unspecified, at most 10 transcripts are returned. The maximum value is 100; values above 100 are coerced to 100.
string
Page token returned from a previous list call, used to retrieve the next page of results.
string
required
Unique identifier of the conference record. This is the ID portion from the conference record resource name (format: ‘conferenceRecords/{id}’). You can obtain valid conference record IDs by using the ‘List Conference Records’ action or from the ‘name’ field in conference record responses. Example ID: ‘kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ’. Do NOT pass the full resource name - only the ID portion after ‘conferenceRecords/’. A single meeting code can map to multiple conference_record_id values across rejoin sessions; verify the correct record using UTC time or metadata from ‘List Conference Records’ before calling.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GET_VACATION_SETTINGSTool to retrieve vacation responder settings for a Gmail user. Use when you need to check if out-of-office auto-replies are configured and view their content.

Input Parameters

string
The email address of the Gmail user whose vacation settings are to be retrieved, or the special value ‘me’ to indicate the currently authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTIONTool to delete a file or folder in Google Drive. Use when you need to permanently remove a specific file or folder using its ID. Note: This action is irreversible. Deleting a folder permanently removes all nested files and subfolders.

Input Parameters

string
required
The ID of the file or folder to delete. This is a required field.
boolean
Whether the application supports both My Drives and shared drives. If false or unspecified, the file is attempted to be deleted from the user’s My Drive. If true, the item will be deleted from shared drives as well if necessary.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_HIDE_DRIVETool to hide a shared drive from the default view. Use when you want to remove a shared drive from the user’s main Google Drive interface without deleting it.

Input Parameters

string
required
The ID of the shared drive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_IMPORT_MESSAGETool to import a message into the user’s mailbox with standard email delivery scanning and classification. Use when you need to add an existing email to a Gmail account without sending it through SMTP. This method doesn’t perform SPF checks, so it might not work for some spam messages.

Input Parameters

string
required
The entire email message in RFC 2822 format, base64url-encoded. This is the raw email message to import into the mailbox.
boolean
Mark the email as permanently deleted (not TRASH) and only visible in Google Vault to a Vault administrator. Only used for Google Workspace accounts.
string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.
boolean
Ignore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox.
string ("receivedTime" | "dateHeader")
Source for Gmail’s internal date of the message.
boolean
Process calendar invites in the email and add any extracted meetings to the Google Calendar for this user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INGEST_AD_EVENTSUpload ad events for an allowlisted Data Partner to Google Analytics, not Ads. Requires an eligible Data Partner account linked to the target advertiser. Use validate_only=true for the provider’s deprecated no-execution check. The response is empty; this operation does not return a request ID.

Input Parameters

array
required
At least one ad event to upload to Google Analytics; no Google Ads destinations are supported by this endpoint.
string
required
Required Data Partner resource name where the credential’s Google Account is a user: accountTypes/DATA_PARTNER/accounts/{loginAccountId}. Not an Ads customer ID.
boolean
Deprecated by Google but documented: true validates without executing; false ingests advertising events irreversibly.
object
Encryption key information; required whenever an ad event contains user_data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INGEST_AUDIENCE_MEMBERSValidate or asynchronously ingest Data Manager audience members. Use validate_only=true for a no-upload check. Customer Match terms must already be accepted for contact/mobile data; do not assert acceptance without authority. Consent may be supplied per request or member. A request ID confirms acceptance, not completion; poll request status for processing errors and partial failures.

Input Parameters

Request-level consent; individual member consent overrides it.
string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")
Required for UserData uploads: encoding of the hashed string, or outer encrypted string if encrypted. Ignored for other uploads.
array
required
Destinations receiving the audience members.
boolean
True validates without executing; only errors, not results, are returned. False starts asynchronous ingestion.
object
Optional encryption for UserData. Omit for hashed, unencrypted identifiers; ignored for other uploads.
array
required
One to 10,000 audience members to ingest.
object
Explicit caller decision on applicable terms; does not automatically accept terms.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INGEST_CONVERSION_EVENTSValidate or submit a bounded Google Ads conversion-event batch. Set validate_only=true for a no-ingestion check. False starts irreversible asynchronous processing and returns a request ID for later status checks.

Input Parameters

array
required
One to 2,000 conversion events to validate or ingest.
Request-level consent applied unless an event supplies its own consent.
string ("HEX" | "BASE64")
Encoding of normalized SHA-256 user identifiers; required with user data.
array
required
One to ten Google Ads destinations for this batch.
boolean
Validate without ingesting when true. False starts irreversible asynchronous processing for an accepted batch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INGEST_USERSIngest account-level identity linkage, not audience-list membership. Requires provider allowlisting. Each user links hashed first-party identifiers with mobile device IDs. Set validate_only=true for no ingestion. A request ID confirms asynchronous acceptance, not completion; poll request status for errors.

Input Parameters

array
required
Users to ingest; each must include both user_data and mobile_data.
string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")
required
Required user-identifier encoding; for encrypted identifiers, the outer encoding.
array
required
Accounts receiving the identity linkage data. Requires provider allowlisting.
boolean
True validates without execution. False starts asynchronous ingestion.
object
Optional encryption key information; omit for hashed, unencrypted identifiers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_CHILDTool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder.

Input Parameters

string
required
The ID of the child file to insert into the folder.
string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format options.
string
Selector specifying which fields to include in a partial response.
string
JSONP callback parameter.
string
required
The ID of the folder.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).
boolean
Whether the requesting application supports both My Drives and shared drives.
boolean
Deprecated: Use supportsAllDrives instead.
boolean
Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_DIMENSIONTool to insert new rows or columns into a sheet at a specified location. Use when you need to add empty rows or columns within an existing Google Sheet.

Input Parameters

string
required
The ID of the spreadsheet to update.
array
Limits the ranges of the spreadsheet to include in the response.
object
required
The details for the insert dimension request.
boolean
True if grid data should be included in the response (if includeSpreadsheetInResponse is true).
boolean
True if the updated spreadsheet should be included in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_IMAGE_IN_TABLE_CELLInserts an image from a URI at a position in a Google Document table cell identified by table start index, row and column. The table lookup searches top-level body content, including the specified top-level tab when provided.

Input Parameters

string
required
The URI of the image to insert. Must be a publicly accessible direct image URL (no redirects or viewer links). Images must be less than 50MB, not exceed 25 megapixels, and be in PNG, JPEG, or GIF format (SVG not supported). The URI can be at most 2 kB in length.
string
required
The ID of the document containing the table.
object
The size of the image. If not specified, the image is rendered at its intrinsic size.
integer
The zero-based offset within the table cell’s content where the image should be inserted. Each table cell contains a paragraph, and this index specifies the position within that paragraph. Use 0 to insert at the beginning of the cell, or a higher value to insert after existing content. If omitted, the image is inserted at the beginning of the cell (index 0).
object
required
The location of the table cell where the image should be inserted. Specify the table’s start index, row index, and column index to identify the target cell.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_INLINE_IMAGETool to insert an image from a given URI at a specified location in a Google Document as an inline image. Use when you need to add an image to a document programmatically.

Input Parameters

string
required
The URI of the image. Must be a publicly accessible direct image URL (no redirects or viewer links like Google Drive preview pages). Images must be less than 50MB, not exceed 25 megapixels, and be in PNG, JPEG, or GIF format (SVG not supported). The URI can be at most 2 kB in length.
object
required
The location in the document to insert the image. The index field is required to specify the insertion point.
string
required
The ID of the document to update.
object
The size of the image. If not specified, the image is rendered at its intrinsic size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_MESSAGETool to insert a message into the user’s mailbox similar to IMAP APPEND. Use when you need to add an email directly to a mailbox bypassing most scanning and classification. This does not send a message.

Input Parameters

string
required
The entire email message in RFC 2822 formatted and base64url encoded string. This is the raw message content that will be inserted into the mailbox.
boolean
Mark the email as permanently deleted (not TRASH) and only visible in Google Vault to a Vault administrator. Only used for Google Workspace accounts.
string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.
string ("receivedTime" | "dateHeader")
Source for Gmail’s internal date of the message.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_PAGE_BREAKTool to insert a page break into a Google Document. Use when you need to start new content on a fresh page, such as at the end of a chapter or section.

Input Parameters

string
required
The ID of the document to update.
string
required
The details for the insertPageBreak request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_TABLE_ACTIONTool to insert a table into a Google Document. Use when you need to add a new table at a specific location or at the end of a segment (like document body, header, or footer) in a document.

Input Parameters

integer
required
The number of rows in the table.
integer
The zero-based index where the table will be inserted, in UTF-16 code units. IMPORTANT: The index must be strictly less than the segment’s end index (you cannot insert at the exact end position using an index). To insert at the end of a segment, omit this parameter and set ‘insertAtEndOfSegment’ to true instead. If provided, ‘location’ will be used. If omitted and ‘insertAtEndOfSegment’ is false or omitted, ‘endOfSegmentLocation’ will be used for the document body.
string
The tab that the location is in. When omitted, the request is applied to the first tab.
integer
required
The number of columns in the table.
string
The ID of the header, footer or footnote the location is in. An empty segment ID signifies the document’s body.
string
required
The ID of the document to update.
boolean
If true, inserts the table at the end of the segment (document body, header, or footer specified by segment_id). This is the recommended way to append content to the end of a segment, as using an index equal to the segment’s end position will fail. If false or omitted, and ‘index’ is not provided, it defaults to inserting at the end of the document body. If ‘index’ is provided, this field is ignored.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_TABLE_COLUMNTool to insert a new column into a table in a Google Document. Use this tool when you need to add a column to an existing table at a specific location.

Input Parameters

array
required
A list of insert table column requests. Multiple requests can be sent in a single call to insert columns at different locations in the document.
string
required
The ID of the document to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_TABLE_ROWInserts a new row into a table in a Google Document at a specified location. Use this action when you need to add a row to an existing table, either above or below a reference cell location.

Input Parameters

array
required
A list of insert table row requests. Multiple requests can be sent in a single call to insert rows at different locations in the document.
string
required
The ID of the document to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_TASKCreates a task in a specified list, optionally under a parent or after a sibling in that list. Date inputs accept various formats; due dates are normalized to midnight UTC, discarding the time, and repeated calls can create duplicate tasks.

Input Parameters

string
Unique identifier for the task. Generated by Google Tasks API when creating a task. Used for updating or deleting existing tasks.
string
Due date for the task (optional). NOTE: Google Tasks only stores the date portion (YYYY-MM-DD) - any time component provided will be automatically stripped before sending to the API. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task. Auto-generated by the API.
string
Additional details or description for the task. Supports plain text only (no HTML/markdown). Maximum 8192 characters. Example: ‘Include Q3 sales data and projections’
string
required
Title/name of the task (REQUIRED). This is the main text displayed for the task. Maximum 1024 characters. Example: ‘Complete quarterly report’
boolean
Whether the task is hidden from the default view. Hidden tasks can still be accessed via API but won’t show in UI. Default: false
string ("needsAction" | "completed")
Status of the task. Must be either ‘needsAction’ (task is pending) or ‘completed’ (task is done). Defaults to ‘needsAction’ if not provided.
boolean
Whether the task has been deleted. Deleted tasks are marked but not immediately removed, allowing for recovery. Default: false
string
Date/time when the task was marked as completed. Only applicable when status=‘completed’. Unlike ‘due’, this field preserves the time component. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Identifier of an existing task to serve as parent; if provided, creates a subtask, otherwise a top-level task in the specified list.
string
required
Task list identifier where the new task will be created. Valid values: (1) ‘@default’ - special identifier that references the user’s default/primary task list, or (2) an actual task list ID obtained from the ‘List Task Lists’ action (GOOGLETASKS_LIST_TASK_LISTS). Task list IDs are opaque strings generated by Google (typically base64-encoded, e.g., ‘MDQ1NTEzMjc4OTM5MzM0NTY4NzE6MDow’).
string
Identifier of an existing task after which the new task will be placed, at the same hierarchical level (as a sibling).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_TEXT_ACTIONTool to insert a string of text at a specified location within a Google Document. Use when you need to add new text content to an existing document. IMPORTANT: Two ways to specify insertion location: 1. Use ‘insertion_index’ to insert at a specific position (index 1 is safe for document start) 2. Use ‘append_to_end=true’ to append text to the end of the document (recommended for appending) CRITICAL CONSTRAINT: When using insertion_index, the index MUST fall within the bounds of an EXISTING paragraph. You cannot insert text at arbitrary indices or at structural boundaries (e.g., table starts). The index must also be strictly less than the document’s end index. To safely append text without index concerns, use append_to_end=true.

Input Parameters

string
The ID of the document tab to insert text into. When omitted, Google Docs applies the request to the first tab.
string
The ID of the header, footer or footnote to insert text into. Leave empty or omit to insert into the document body. Works with both append_to_end and insertion_index modes.
string
required
The ID of the document to insert text into.
boolean
Set to true to append text to the end of the document body. When true, the ‘insertion_index’ parameter is ignored. This is the recommended way to add text at the end of a document as it avoids index boundary issues.
string
required
The string of text to insert. Alternatively, you can provide this as ‘text’.
integer
The zero-based UTF-16 code unit index where text will be inserted. Alternatively, you can provide this as ‘index’. CRITICAL CONSTRAINTS: (1) The index MUST fall within the bounds of an EXISTING paragraph - you cannot insert at arbitrary indices or at structural boundaries like table starts. (2) The index MUST be strictly less than the document’s end index. Index 1 is the minimum valid index and is safe for inserting at the document start. To determine valid indices, first retrieve the document structure using GOOGLEDOCS_GET_DOCUMENT_BY_ID to identify paragraph boundaries. For safely adding text without index concerns, set ‘append_to_end’ to true instead. Either ‘insertion_index’ or ‘append_to_end’ must be provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_INSERT_TEXT_IN_TABLE_CELLInsert text into a Google Docs table using the table’s start index and zero-based row and column positions. Existing table content can cause the text to be inserted outside the requested cell.

Input Parameters

string
required
The text to insert into the table cell.
string
The ID of the document tab containing the table. When omitted, the request is applied to the first tab.
integer
required
The zero-based row index of the target cell (0 for first row, 1 for second row, etc.).
string
required
The ID of the document containing the table.
integer
required
The zero-based column index of the target cell (0 for first column, 1 for second column, etc.).
integer
required
The zero-based index where the target table starts in the document, in UTF-16 code units. To find this index, use GOOGLEDOCS_GET_DOCUMENT_BY_ID to retrieve the document structure and locate the table’s startIndex.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_ACCESSIBLE_CUSTOMERSList Google Ads customer resource names directly accessible to the authenticated OAuth user. Google determines the complete result from the OAuth credentials and ignores customer_id and login-customer-id; this action does not filter the response. For MCC child account names, status, and direct hierarchy, use List Sub Accounts.

Input Parameters

string
Deprecated compatibility parameter. Google ignores this value and returns customer resource names directly accessible with the current OAuth credentials; it does not filter by this customer ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_ACCESS_PROPOSALSTool to list pending access proposals on a file. Use when you need to retrieve access proposals for a specific file. Note: Only approvers can list access proposals; non-approvers will receive a 403 error.

Input Parameters

string
required
The ID of the file to list access proposals for
integer
The number of results per page
string
The continuation token on the list of access requests

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_ACCOUNTSDEPRECATED: Use ListAccountsV1Beta instead. Tool to list all Accounts accessible by the caller. Use when you need to enumerate all Google Analytics accounts your credentials can access. Empty or partial results may indicate a permissions issue rather than no resources existing. Returned resource names follow the format accounts/{account_id}; use these in subsequent calls.

Input Parameters

integer
Optional. Maximum number of accounts to return. Must be ≥1.
string
Optional. Token for retrieving the next page of results.
boolean
Optional. Whether to include soft-deleted (trashed) Accounts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_ACCOUNT_SUMMARIESTool to retrieve summaries of all Google Analytics accounts accessible by the caller. Use when you need a high-level overview of accounts and their properties without fetching full account details.

Input Parameters

integer
Maximum number of account summaries to return. The service may return fewer than this value. If unspecified, at most 50 resources will be returned. Maximum value is 200; higher values will be coerced to the maximum.
string
Page token received from a previous ListAccountSummaries call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAccountSummaries must match the call that provided the page token.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_ACCOUNTS_V1_BETAList Google Analytics accounts accessible to the caller using the v1beta API. Results are paginated and may include accounts without GA properties; soft-deleted accounts are excluded by default.

Input Parameters

integer
The maximum number of resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; higher values will be coerced to the maximum.
string
A page token, received from a previous ListAccounts call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAccounts must match the call that provided the page token.
boolean
Whether to include soft-deleted (ie: ‘trashed’) Accounts in the results. Accounts can be inspected to determine whether they are deleted or not. Defaults to false (soft-deleted accounts are excluded).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_ALBUMSLists Google Photos albums created by this app, with pagination support.

Input Parameters

integer
Maximum number of albums to return. Default 20, maximum 50.
string
Continuation token for getting the next page of results
boolean
If true, excludes media items not created by this app

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_ALL_TASKSList tasks across the user’s task lists with optional filters, annotating each returned task with its list ID and title. Results are limited to 1,000 tasks by default, with a configurable limit and a truncation indicator.

Input Parameters

string
Only include tasks due on or before this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Only include tasks due on or after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include hidden tasks in results. Defaults to false.
string
Only include tasks updated on or after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include deleted tasks in results. Defaults to false.
string
Only include tasks completed on or before this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Only include tasks completed on or after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include tasks assigned to the current user in results. Defaults to false.
boolean
Include completed tasks in results. Defaults to true.
integer
Hard limit on total number of tasks returned across all lists to prevent large payloads. Defaults to 1000.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_APPROVALSLists a page of approvals associated with a Google Drive file, with pagination for browsing subsequent pages. Approval details are unavailable through this action.

Input Parameters

string
required
The ID of the file to list approvals for
integer
The maximum number of approvals to return per page
string
A pagination token returned as ‘nextPageToken’ from a previous list approvals response. Must be an exact, unmodified token from a prior API call - do not construct, encode, or guess token values. Only provide this parameter when paginating through results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_AUDIENCE_EXPORTSTool to list all audience exports for a property. Use when you need to find and reuse existing audience exports rather than creating new ones.

Input Parameters

string
required
Required. Property identifier in format ‘properties/{propertyId}’. Example: ‘properties/489591273’
integer
Optional. Maximum number of audience exports to return. Default: 200, Maximum: 1000
string
Optional. Token from a previous response for pagination to retrieve the next page of results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_AUDIENCE_LISTSTool to list all audience lists for a specified property to help find and reuse existing lists. Use when you need to retrieve a property’s configured audience lists after confirming the property ID.

Input Parameters

string
required
Required. Resource name of the parent property. Format: properties/{property_id}
integer
Optional. Maximum number of audience lists to return. Defaults to 200; maximum is 1000.
string
Optional. Token for retrieving the next page of results. All other parameters must match original request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_AUDIENCESList audience configurations for a Google Analytics property; audiences created before 2020 may not be supported. Returned filter clauses include their types but not the full membership criteria.

Input Parameters

string
required
Required. The property for which to list Audiences. Format: properties/{propertyId} Scoped to a single property per call; invoke separately for each property to list audiences across multiple GA4 properties.
integer
Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200
string
Optional. A page token received from a previous ListAudiences call. Provide this to retrieve the subsequent page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_BUILDINGSLists a page of buildings for a Google Workspace customer, including available addresses, coordinates, and floor names. Use the continuation token for further pages; Directory API access and appropriate administrator privileges are required.

Input Parameters

string
The unique ID for the customer’s Google Workspace account. Use ‘my_customer’ alias to represent your account’s customer ID. As an account administrator, this alias represents your account’s customer ID.
string
Token to specify the next page in the list. Obtained from nextPageToken in a previous response. Omit for the first page.
integer
Maximum number of buildings to return per page. Defaults to 25 for optimal performance.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CALCULATED_METRICSList Calculated Metrics

Input Parameters

string
required
Required. Property identifier in format ‘properties/{propertyId}’. Example: ‘properties/1234’
integer
Optional. Maximum number of results to return per request. Default: 50, Maximum: 200
string
Optional. Token from a previous response for pagination to retrieve the next page of results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CALENDAR_RESOURCESRetrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. Use this action when you need to list available meeting rooms, conference spaces, or other bookable calendar resources in an organization. The action supports filtering by resource category, capacity, building location, and other criteria. IMPORTANT: This requires Admin SDK Directory API access and appropriate admin permissions - it is NOT available for personal Gmail accounts, only Google Workspace domains.

Input Parameters

string
Search query to filter calendar resources. Each clause is ‘field operator value’. Supported operators: ’=’ (exact match), ’!=’ (mismatch), ’:’ (prefix/HAS match — for prefix match, follow the value with ’*’). Supported logical operators: AND, NOT (in that order of precedence). IMPORTANT: Numeric comparison operators (>, <, >=, <=) are NOT supported by the Google Admin Directory API for this endpoint and will cause a 400 Bad Request — ‘capacity’ can only be filtered by exact equality (e.g., ‘capacity=10’). Supported fields: generatedResourceName, name, buildingId, floor_name, capacity, featureInstances.feature.name, resourceEmail, resourceCategory.
string
Specifies sorting order for results. Use field names like ‘resourceId’, ‘resourceName’, ‘capacity’, ‘buildingId’, ‘floorName’ optionally followed by ’ desc’ for descending order. Multiple fields can be separated by commas (e.g., ‘buildingId, capacity desc’).
string
The unique ID for the customer’s Google Workspace account. Use ‘my_customer’ as an alias for the account’s customer ID.
string
Token for retrieving subsequent pages in paginated results. Use the nextPageToken from a previous response.
integer
Maximum number of results to return per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CALENDARSLists calendars accessible through the connected user’s CalendarList, returning IDs and user-specific metadata such as access role, color, visibility, selection, and reminders. Hidden calendars are omitted unless show_hidden is true; min_access_role and show_deleted provide additional filtering. Continue with page_token until next_page_token is absent; for incremental synchronization, pass next_sync_token back as sync_token. Use returned IDs, not display names, with event actions, and use GOOGLECALENDAR_GET_CALENDAR for canonical metadata about one known calendar.

Input Parameters

string
Token for the page of results to return, from a previous response.
string
Sync token from a previous list request to get only changed entries; showDeleted, showHidden, and pageToken are ignored if provided. Also ignores minAccessRole. An HTTP 410 Gone response means the token has expired; perform a full resync by omitting sync_token.
integer
Maximum calendars to return on one page. Google defaults to 100 and allows at most 250. Follow next_page_token until absent to enumerate every accessible calendar.
boolean
Include calendars not typically shown in the UI.
boolean
Include deleted calendars in the result.
string ("freeBusyReader" | "reader" | "writerWithoutPrivateAccess" | "writer" | "owner")
Minimum access role for returned calendars: ‘freeBusyReader’, ‘reader’, ‘writerWithoutPrivateAccess’, ‘writer’, or ‘owner’. freeBusyReader calendars expose only free/busy slots. Omit this filter to include every accessible role.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CHANGESLists a page of changes for a user or shared drive; without a page token, it obtains a current start token and lists subsequent changes rather than earlier activity. Follow nextPageToken to continue and save newStartPageToken for future monitoring.

Input Parameters

string
FieldMask selecting the change-list fields to return. Include pagination tokens when paging and use parentheses for nested change or file fields, for example ‘nextPageToken,newStartPageToken,changes(fileId,removed,file(id,name,mimeType))’. Leave blank for Google’s default fields; use ’*’ only when every field is necessary because it increases response size.
string
A comma-separated list of spaces to query within the corpora. Supported values are ‘drive’ and ‘appDataFolder’.
string
The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier. When driveId is provided, supportsAllDrives is automatically set to true.
integer
The maximum number of changes to return per page.
string
The token for continuing a previous list request on the next page. Must be a valid token from a previous LIST_CHANGES response’s ‘nextPageToken’ field or from the get_changes_start_page_token action. If not provided, the current start page token will be automatically fetched and used. Tokens can become stale — always use a fresh token from GOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKEN or the most recent prior response to avoid missed or duplicate changes. Paginate until nextPageToken is absent; stopping early silently omits changes.
string
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
boolean
Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.
boolean
Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.
boolean
Whether the requesting application supports both My Drives and shared drives. Must be true when driveId is specified (will be automatically set to true when driveId is provided).
boolean
Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file. Note: When set to true, includeRemoved must also be true (will be automatically set).
boolean
Whether both My Drive and shared drive items should be included in results. Must be true when driveId is specified (will be automatically set to true when driveId is provided).
string
Specifies which additional view’s permissions to include in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CHANNEL_GROUPSTool to list ChannelGroups on a property. Use when you need to retrieve channel groups that categorize traffic sources in Analytics reports.

Input Parameters

string
required
Required. The property for which to list ChannelGroups. Format: properties/{property_id}
integer
Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200
string
Optional. A page token received from a previous ListChannelGroups call. Provide this to retrieve the subsequent page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CHARTSLists all charts in a Google Sheets spreadsheet across all sheets, returning chart_id, sheet metadata, chart type, title, and position. Use this action when you need to discover what charts exist in a spreadsheet, retrieve chart IDs for update or delete operations, or inspect chart configurations. The default field mask in GOOGLESHEETS_GET_SPREADSHEET_INFO omits chart data, making this dedicated action necessary for chart discovery.

Input Parameters

integer
Optional. Filter to a specific chart by its numeric chart ID. When provided, returns only the matching chart if it exists in the spreadsheet.
integer
Optional. Filter results to a single sheet’s charts by providing the numeric sheet ID (not the sheet name). When omitted, returns charts from all sheets in the spreadsheet.
boolean
When true, include the full ChartSpec dictionary for each chart (contains all chart configuration details including series, axes, colors, etc.). When false (default), return only a compact summary with chart_id, type, title, and position. Set to false to keep responses small.
string
required
Required. The Google Sheets spreadsheet ID or full URL. Accepts either the ID alone (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’) or a full Google Sheets URL (e.g., ‘https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit’). The ID will be automatically extracted from URLs. Note: Published/embedded URLs (containing ‘/d/e/2PACX-…’) are not supported.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CHILDREN_V2Lists a page of child references for a folder using Google Drive API v2. Follow the returned nextPageToken to retrieve additional pages.

Input Parameters

string
Query string for searching children.
string ("json" | "media" | "proto")
Data format for response enum.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format enum.
string
Selector specifying which fields to include in a partial response. This endpoint returns ChildReference objects, NOT full File objects. Valid ChildReference fields are: ‘id’ (child ID), ‘selfLink’ (link to this reference), ‘kind’ (resource type), ‘childLink’ (link to the child). File-level fields like ‘title’, ‘modifiedDate’, ‘fileSize’, ‘alternateLink’, ‘mimeType’ are NOT valid. Example: ‘items(id,childLink),nextPageToken’
string
A comma-separated list of sort keys. Valid keys are ‘createdDate’, ‘folder’, ‘lastViewedByMeDate’, ‘modifiedByMeDate’, ‘modifiedDate’, ‘quotaBytesUsed’, ‘recency’, ‘sharedWithMeDate’, ‘starred’, and ‘title’. Each key sorts ascending by default, but may be reversed with the ‘desc’ modifier. Example usage: ?orderBy=folder,modifiedDate desc,title.
string
JSONP callback parameter.
string
required
The ID of the folder.
string
Page token for children.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
integer
Maximum number of children to return.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_COMMENTSLists comments on a Google Drive file, with pagination, an option to include deleted comments, and a minimum modification-time filter. Filter by author or content client-side.

Input Parameters

string
A comma-separated list of fields to include in the response. Use * to include all fields. Prefer selective field masks (e.g., ‘comments(id,content,author)’) over ’*’ to reduce payload size and latency.
string
required
The ID of the file. Equivalent to the Google Docs document_id; pass it here under the fileId parameter name.
integer
The maximum number of comments to return per page.
string
The token for continuing a previous list request on the next page. This should be set to the value of ‘nextPageToken’ from the previous response. Comments may be added or modified during pagination on active files; use startModifiedTime to bound the window if consistency is required.
boolean
Whether to include deleted comments. Deleted comments will not include their original content.
string
The minimum value of ‘modifiedTime’ for the result comments (RFC 3339 date-time).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CONFERENCE_RECORDSTool to list conference records. Use when you need to retrieve a list of past conferences, optionally filtering them by criteria like meeting code, space name, or time range.

Input Parameters

string
Optional. User specified filtering condition in EBNF format. Filterable fields: space.meeting_code, space.name, start_time, end_time. Examples: space.name = "spaces/NAME", space.meeting_code = "abc-mnop-xyz", start_time>="2024-01-01T00:00:00.000Z" AND start_time<="2024-01-02T00:00:00.000Z", end_time IS NULL Time values must be RFC3339 UTC (e.g., 2024-01-01T00:00:00.000Z); non-UTC timezones or reversed bounds silently omit records. Unsupported fields or malformed expressions silently return empty or over-narrowed results. A single space.meeting_code may match multiple records if the code was reused; combine with time filters to isolate the target record.
integer
Maximum number of conference records to return. The service might return fewer than this value. If unspecified, at most 25 conference records are returned. The maximum value is 100; values above 100 are coerced to 100.
string
Page token returned from previous List Call. Loop using the returned page_token until no token is returned to retrieve the complete result set.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CONVERSION_EVENTSLists deprecated conversion event resources configured for a Google Analytics property. Google recommends using key events instead.

Input Parameters

string
required
Required. The resource name of the parent property. Format: ‘properties/{propertyId}’
integer
Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200
string
Optional. A page token received from a previous ListConversionEvents call. Provide this to retrieve the subsequent page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CSE_IDENTITIESLists a page of client-side encrypted identities and their key-pair associations. A response indicating that CSE is not enabled is returned as an empty list.

Input Parameters

string
The requester’s primary email address. Use ‘me’ to indicate the authenticated user.
integer
The number of identities to return. If not provided, the page size will default to 20 entries.
string
Pagination token indicating which page of identities to return.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CSE_KEYPAIRSLists a page of client-side encryption key pairs, including public keys and enablement states. A response indicating that CSE is not enabled is returned as an empty list.

Input Parameters

string
The requester’s primary email address. Use ‘me’ to indicate the authenticated user.
integer
The number of key pairs to return per page. If not provided, the page size will default to 20 entries.
string
Pagination token indicating which page of key pairs to return. Omit to return the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CUSTOM_DIMENSIONSList Custom Dimensions

Input Parameters

string
required
Required. The property for which to list CustomDimensions. Format: properties/{property_id}
integer
Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200
string
Optional. A page token received from a previous ListCustomDimensions call. Provide this to retrieve the subsequent page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_CUSTOM_METRICSTool to list CustomMetrics on a property. Use when you need to retrieve all custom metrics configured for a given property.

Input Parameters

string
required
Required. Property identifier in format ‘properties/{propertyId}’. Example: ‘properties/1234’
integer
Optional. Maximum number of resources to return. If unspecified, at most 50 resources will be returned. Maximum value is 200
string
Optional. Token from a previous ListCustomMetrics call for pagination to retrieve the next page of results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_DATA_MANAGER_CONVERSION_ACTIONSList conversion actions usable as Google Ads Data Manager destinations. Returns numeric destination IDs, true owning accounts, action types, and availability; defaults to enabled offline and enhanced-lead actions.

Input Parameters

array
Statuses to include. Keep ENABLED for an ingestible destination; HIDDEN and REMOVED are primarily useful for diagnosis.
string
Select enabled UPLOAD_CLICKS actions for offline conversion ingestion.
string
Google Ads customer to query; hyphens and spaces are accepted and removed. Query the conversion account that owns the actions, not merely a child account that uses cross-account conversion tracking. Defaults to the connection customer_id.
string
Optional case-insensitive literal substring of the conversion action name.
boolean
Require primary_for_goal to be true or false; omit to return both.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_DATA_MANAGER_USER_LISTSList one page of Data Manager user lists and their lifecycle configuration.

Input Parameters

string
Filter using AND, =, !=, >, >=, <, <=, : (has), or IN(field, values…). Supported fields: id, display_name, description, membership_status, integration_code, access_reason, ingested_user_list_info.upload_key_types. Use either all snake_case or all camelCase field names, with fields on the left.
string
required
Account owning the collection, in accountTypes/{accountType}/accounts/{account} form.
integer
Maximum lists to return. Defaults to at most 50; Google coerces values above 1000 to 1000.
string
Token from next_page_token; keep all other parameters unchanged when continuing.
string
Optional accountTypes/{type}/accounts/{id} where the credential user has access; defaults to parent.
string
Optional accountTypes/{type}/accounts/{id} with an established product link to login-account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_DATA_STREAMSTool to list DataStreams on a property. Use when you need to retrieve data stream configurations for a Google Analytics property.

Input Parameters

string
required
Required. The Google Analytics property identifier. Must be in format ‘properties/NUMERIC_ID’ where NUMERIC_ID is your actual property ID (e.g., ‘properties/489591273’). Do NOT use placeholder syntax like ‘properties/{propertyId}’ - replace the placeholder with a real numeric property ID.
integer
Optional. Maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200
string
Optional. A page token received from a previous ListDataStreams call. Provide this to retrieve the subsequent page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_DRAFTSRetrieves a paginated list of email drafts from a user’s Gmail account. Use verbose=true to get full draft details including subject, body, sender, and timestamp. Draft ordering is non-guaranteed; iterate using page_token until it is absent to retrieve all drafts. Newly created drafts may not appear immediately. Rapid calls may trigger 403 userRateLimitExceeded or 429 errors; apply exponential backoff (1s, 2s, 4s) before retrying.

Input Parameters

string
User’s mailbox ID; use ‘me’ for the authenticated user.
boolean
If true, fetches full draft details including subject, sender, recipient, body, and timestamp. If false, returns only draft IDs (faster). Increases response payload size; tune max_results accordingly. Use verbose=true before destructive operations to confirm draft identity by subject, recipient, and timestamp.
string
Token from a previous response to retrieve a specific page of drafts. Ordering is non-guaranteed; continue paginating until page_token is absent in the response to retrieve all drafts.
integer
Maximum number of drafts to return per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_DRIVE_CHANGESStart a Drive change monitor or list one page after an existing token.

Input Parameters

string
Comma-separated Drive spaces to query. Each value must be drive or appDataFolder.
string
Shared-drive ID whose change feed to read. When supplied, supports_all_drives and include_items_from_all_drives are forced true.
integer
Maximum changes to return in this page (1-1000). Drive can return fewer changes than requested.
string
Opaque token from Drive changes.getStartPageToken or the previous response’s next_page_token. Omit it to start monitoring now; the action returns a fresh checkpoint without listing historical changes.
string
Comma-separated Drive label IDs whose data should be included in each changed file’s labelInfo.
boolean
Include changes representing deletion or loss of access. Keep true for a complete incremental sync.
boolean
Declare support for My Drive and shared drives. Automatically true when drive_id is supplied.
boolean
Restrict results to the My Drive hierarchy, excluding app data and shared files not added to My Drive.
boolean
Include the current file resource when it remains accessible even though it was removed from this change corpus. When true, include_removed is forced true.
string
Set to published to include permissions for the published view; no other value is supported.
boolean
Include items from My Drive and shared drives. Automatically true when drive_id is supplied.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_DRIVE_ITEM_PERMISSIONSList permissions for a Google Drive file, folder, or shared drive.

Input Parameters

string
Drive partial-response selector for the permission page.
string
required
Opaque Drive file or shared drive ID.
integer
Maximum number of permissions to return on this page (1-100).
string
Token from a prior next_page_token for the next page.
boolean
Whether the request supports My Drive and shared drives.
boolean
Use eligible Workspace administrator access for a shared drive.
string
Include permissions for the published view.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_EVENT_CREATE_RULESTool to list EventCreateRules configured on a web data stream. Use when you need to retrieve event create rules for a specific GA4 property data stream.

Input Parameters

string
required
Required. Resource name of the parent data stream. Format: properties/{propertyId}/dataStreams/{dataStreamId}.
integer
Optional. Maximum number of event create rules to return. Default is 50, maximum allowed is 200.
string
Optional. A page token received from a previous list call. Provide this to retrieve the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_EXPANDED_DATA_SETSTool to list ExpandedDataSets on a property. Use when you need to retrieve expanded data set configurations for a Google Analytics 360 property.

Input Parameters

string
required
Required. The name of the property to list ExpandedDataSets for. Format: properties/{property_id}
integer
Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200
string
Optional. A page token received from a previous ListExpandedDataSets call. Provide this to retrieve the subsequent page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_EXPERIMENT_ARMSList Google Ads experiment arms, including draft campaigns.

Input Parameters

boolean
Filter control/test arms.
string
Optional experiment resource name to filter by.
string
Token returned as next_page_token by the previous page.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_EXPERIMENTSList Google Ads experiments, optionally filtered by status and type.

Input Parameters

string ("ENABLED" | "REMOVED" | "HALTED" | "PROMOTED" | "SETUP" | "INITIATED" | "GRADUATED")
Filter by status.
string
Token returned as next_page_token by the previous page.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
string ("DISPLAY_AND_VIDEO_360" | "AD_VARIATION" | "YOUTUBE_CUSTOM" | "DISPLAY_CUSTOM" | "SEARCH_CUSTOM" | "DISPLAY_AUTOMATED_BIDDING_STRATEGY" | "SEARCH_AUTOMATED_BIDDING_STRATEGY" | "SHOPPING_AUTOMATED_BIDDING_STRATEGY" | "SMART_MATCHING" | "HOTEL_CUSTOM")
Filter by experiment type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_FILE_LABELSLists labels applied to a Google Drive file, including label IDs and applied field IDs. An empty labels array is a valid response; additional pages may be available.

Input Parameters

string
required
The ID of the file.
string
Token to retrieve a specific page of results.
integer
The maximum number of labels to return per page. Default is 100.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_FILE_PROPERTIESTool to list a file’s properties in Google Drive API v2. Use when you need to retrieve custom properties (key-value pairs) attached to a file.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format values.
string
Selector specifying which fields to include in a partial response.
string
required
The ID of the file. This is a required parameter and cannot be empty.
string
JSONP callback function name.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_FILESLists and searches Google Drive files and folders using filters such as a folder, search query, or drive selection. Results are paginated; a 404 response is returned as an empty list and does not establish that no files match. DEPRECATED: Use GOOGLEDRIVE_FIND_FILE instead.

Input Parameters

string
A query string for filtering the file results. Supports operators ‘and’, ‘or’, ‘not’. VALID query terms: ‘name’ (contains, =, !=), ‘fullText’ (contains), ‘mimeType’ (contains, =, !=), ‘modifiedTime’ (<=, <, =, !=, >, >=), ‘viewedByMeTime’ (<=, <, =, !=, >, >=), ‘trashed’ (=, !=), ‘starred’ (=, !=), ‘parents’ (in), ‘owners’ (in), ‘writers’ (in), ‘readers’ (in), ‘sharedWithMe’ (=, !=), ‘createdTime’ (<=, <, =, !=, >, >=), ‘properties’ (has), ‘appProperties’ (has), ‘visibility’ (=, !=), ‘shortcutDetails.targetId’ (=, !=). IMPORTANT: ‘id’ is NOT a valid query term - you cannot search by file ID using this parameter. To get a specific file by ID, use the ‘Get File Metadata’ action instead. Example: “name contains ‘important’ and mimeType = ‘application/vnd.google-apps.folder’”.
string
Selector specifying which file fields to include in the response. Provide a comma-separated list of file field names (e.g., ‘id,name,mimeType,webViewLink’). The action will automatically format this into the proper API format ‘files(field1,field2,…)’. Common file fields include: id, name, description, mimeType, webViewLink, webContentLink, size, createdTime, modifiedTime, parents, owners, permissions. To also include the pagination token, add ‘nextPageToken’ to the list. NOTE: Google Drive API v2 field names are automatically converted to v3 equivalents (e.g., alternateLink→webViewLink, downloadUrl→webContentLink, title→name, createdDate→createdTime, modifiedDate→modifiedTime).
string
A comma-separated list of spaces to query within the corpora. Supported values are ‘drive’ and ‘appDataFolder’. ‘drive’ represents files in My Drive and shared drives, while ‘appDataFolder’ represents the application’s private data folder.
string
Specifies the bodies of items (files/documents) to which the query applies. Supported values are ‘user’, ‘domain’, ‘drive’, and ‘allDrives’. It’s generally more efficient to use ‘user’ or ‘drive’ instead of ‘allDrives’. Defaults to ‘user’.
string
The ID of the shared drive to search. This is used when corpora is set to ‘drive’.
string
A comma-separated list of sort keys. Valid keys are: ‘createdTime’, ‘folder’, ‘modifiedByMeTime’, ‘modifiedTime’, ‘name’, ‘name_natural’, ‘quotaBytesUsed’, ‘recency’, ‘sharedWithMeTime’, ‘starred’, ‘viewedByMeTime’. IMPORTANT: Use ‘quotaBytesUsed’ to sort by file size (do NOT use ‘size’ - it is not a valid key). Each key sorts in ascending order by default, but can be reversed with the ‘desc’ modifier (e.g., ‘modifiedTime desc’).
string
ID of a specific folder to list files from. This is a convenience parameter that automatically adds “‘folder_id’ in parents” to the query. Cannot be used together with a custom ‘q’ parameter.
integer
The maximum number of files to return per page. The value must be between 1 and 1000, inclusive. Defaults to 100.
string
The token for continuing a previous list request on the next page. This MUST be set to the value of ‘nextPageToken’ from the previous response. Do not manually construct or modify pageToken values as they are opaque tokens generated by the API. If the token is rejected, pagination should be restarted from the first page.
string
A comma-separated list of label IDs to include in the labelInfo part of the response for each file.
boolean
Whether the requesting application supports both My Drives and shared drives. Defaults to false. If true, then includeItemsFromAllDrives can be used to extend the search to all drives.
boolean
Whether to include items from both My Drive and shared drives. This is relevant when corpora is ‘user’ or ‘domain’. Defaults to false.
string
Include additional permissions for a specific view. The only valid value is ‘published’, which includes permissions for files with published content. Omit this parameter if you don’t need published view permissions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_FILTERSTool to list all Gmail filters (rules) in the mailbox. Use for security audits to detect malicious filter rules or before creating new filters to avoid duplicates.

Input Parameters

string
The user’s email address or the special value ‘me’ to indicate the authenticated user whose filters will be retrieved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_FORM_RESPONSESReturn one page of submissions for a Google Form.

Input Parameters

string
Filter responses by submission time. Supported forms are ‘timestamp > RFC3339_Z’ and ‘timestamp >= RFC3339_Z’, for example ‘timestamp >= 2026-01-01T00:00:00Z’.
string
required
The ID of the Google Form whose responses to list.
integer
The maximum number of responses to return on this page, from 1 to 5000.
string
The exact next_page_token returned by a previous call. Keep the same form_id and filter when requesting the next page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_FORWARDING_ADDRESSESTool to list all forwarding addresses for the specified Gmail account. Use when you need to retrieve the email addresses that are allowed to be used for forwarding messages.

Input Parameters

string
The user’s email address or the special value ‘me’ to indicate the authenticated user whose forwarding addresses will be retrieved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_HISTORYLists Gmail mailbox change history since a known history ID for incremental sync, with optional label and history-type filters and pagination. An empty history list means no records matched the request, not necessarily that no mailbox changes occurred.

Input Parameters

string
The user’s email address. Use ‘me’ to specify the authenticated user.
string
Only return history records involving messages with this label ID.
string
Token to retrieve a specific page of results. If the response includes nextPageToken, loop requests using this parameter until no nextPageToken is returned; failing to paginate will silently miss changes.
integer
Maximum number of history records to return. Default is 100; max is 500.
array
Filter by specific history types. Allowed values: messageAdded, messageDeleted, labelAdded, labelRemoved.
string
required
Required. Returns history records after this ID. If the ID is invalid or too old, the API returns 404. Perform a full sync in that case. Should be a numeric string. On 404 (historyIdTooOld) or 400 (invalidArgument), recover by fetching a fresh historyId via GMAIL_GET_PROFILE, then perform a one-time full sync via GMAIL_FETCH_EMAILS before resuming incremental calls.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_KEY_EVENTSList key event definitions for a Google Analytics property. Results are paginated, with a next-page token when more results are available.

Input Parameters

string
required
Required. Resource name of the parent property. Format: properties/{property_id}.
integer
Optional. Maximum number of results to return. Must be between 1 and 200. If not specified or 0, the API uses its default page size.
string
Optional. Token for retrieving the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_LABEL_DEFINITIONSLists available Google Drive labels, returning each label’s ID and display name without requiring a file ID.

Input Parameters

string
Customer resource name to scope the request to, such as customers/123abc789. Defaults to the current customer.
integer
Maximum number of labels to return. Defaults to 10; the provider allows at most 200.
string
Exact next-page token returned by an earlier call.
string ("LABEL_ROLE_UNSPECIFIED" | "READER" | "APPLIER" | "ORGANIZER" | "EDITOR")
Minimum role the current user must have on returned labels. Defaults to READER.
string
BCP-47 language code used to evaluate localized field labels. The provider uses its configured default language when omitted.
boolean
Whether to return only current published label revisions. Disabled labels are included when true; when false, current revisions may be unpublished.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_LABELSRetrieves all system and user-created labels for a Gmail account in a single unpaginated response. Primary use: obtain internal label IDs (e.g., ‘Label_123’) required by other Gmail tools — display names cannot be used as label identifiers and cause silent failures or errors. System labels (INBOX, UNREAD, SPAM, TRASH, etc.) are case-sensitive and must be used exactly as returned; INBOX, SPAM, and TRASH are read-only and cannot be added/removed via label modification tools. The Gmail search ‘label:’ operator accepts display names, but label_ids parameters in tools like GMAIL_FETCH_EMAILS require internal IDs from this tool — mixing conventions yields zero results silently. Do not hardcode label IDs across sessions; refresh via this tool on conflict errors.

Input Parameters

string
Identifies the Gmail account (owner’s email or ‘me’ for authenticated user) for which labels will be listed.
boolean
If true, fetches detailed info for each label including message/thread counts (messagesTotal, messagesUnread, threadsTotal, threadsUnread). This requires additional API calls and may be slower for accounts with many labels. If false (default), returns basic label info (id, name, type) which is faster. Counts are eventually consistent and may lag real-time mailbox state by a few seconds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_MEASUREMENT_PROTOCOL_SECRETSTool to list MeasurementProtocolSecrets under a data stream. Use when you need to retrieve measurement protocol secrets for server-side event tracking.

Input Parameters

string
required
Required. The resource name of the parent data stream. Format: properties/{property}/dataStreams/{dataStream}
integer
Optional. Maximum number of resources to return. If unspecified, at most 10 resources will be returned. The maximum value is 10
string
Optional. A page token received from a previous ListMeasurementProtocolSecrets call. Provide this to retrieve the subsequent page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_MEDIA_ITEMSLists photos and videos created by this application in the user’s Google Photos library, with pagination. It cannot list the user’s entire library.

Input Parameters

integer
Maximum number of items to return. Default 25, maximum 100.
string
Token for getting the next page of results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_MEMBERSList configured members of a Google Meet space, including their email and meeting role. Use to discover space member resource names, not participants attending a conference. Follow nextPageToken to retrieve subsequent pages.

Input Parameters

string
Optional system partial-response field selector. If omitted, the API defaults to name,email,role,user. Can request other supported system fields.
string
required
Required. Space to list configured members for. Format: spaces/{space}.
integer
Maximum number of members to return. If omitted or 0, at most 250 members are returned. The service may return fewer. Values above the maximum of 500 are coerced to 500 by the service; this maximum may change.
string
Page token returned from a previous list call. Provide it to retrieve the next page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_MESSAGESDEPRECATED: Use GMAIL_FETCH_EMAILS instead. Lists the messages in the user’s mailbox. Use when you need to retrieve a list of email messages with optional filtering by labels or search query.

Input Parameters

string
Only return messages matching the specified query. Supports the same query format as the Gmail search box. For example, ‘from:someuser@example.com is:unread’. Cannot be used when accessing the API using the gmail.metadata scope.
string
The user’s email address or ‘me’ to specify the authenticated user.
array
Only return messages with labels that match all of the specified label IDs. Messages in a thread might have labels that other messages in the same thread don’t have.
string
Page token to retrieve a specific page of results in the list.
integer
Maximum number of messages to return. Defaults to 100. The maximum allowed value is 500.
boolean
Include messages from SPAM and TRASH in the results. Default is false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_PARTICIPANTSLists the participants in a conference record. By default, ordered by join time descending. Use to retrieve all participants who joined a specific Google Meet conference, with support for filtering active participants (where latest_end_time IS NULL).

Input Parameters

string
Optional. User-specified filtering condition in EBNF format. Filterable fields: earliest_start_time, latest_end_time. Example: latest_end_time IS NULL returns active participants in the conference.
string
required
Required. Format: conferenceRecords/{conference_record}. The conference record ID can be obtained from the LIST_CONFERENCE_RECORDS action.
integer
Optional. Maximum number of participants to return. The service might return fewer than this value. If unspecified, at most 100 participants are returned. The maximum value is 250; values above 250 are coerced to 250.
string
Optional. Page token returned from a previous list call, used to retrieve the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_PARTICIPANT_SESSIONSLists a page of participant sessions for a specific participant in a Google Meet conference, including session start and end times. Sessions represent joins from devices, with repeated joins creating separate sessions; use the returned page token to retrieve further sessions.

Input Parameters

string
Optional. User-specified filtering condition in EBNF format. Filterable fields include start_time and end_time. Time values must use RFC3339 UTC format (e.g., start_time >= '2024-01-01T00:00:00Z'). Unsupported field names or malformed expressions may silently narrow or drop results rather than raising errors. Reversed bounds or incorrect timezone conversion will produce empty results.
integer
Optional. Maximum number of participant sessions to return. The service might return fewer than this value. If unspecified, at most 100 participant sessions are returned. The maximum value is 250; values above 250 are coerced to 250.
string
Optional. Page token returned from a previous list call, used to retrieve the next page of results. Iterate using successive page_token values until the response omits page_token to avoid silently missing sessions.
string
required
Required. The unique identifier of the participant within the conference. Example: ‘xyz-456’.
string
required
Required. The unique identifier of the conference record. Example: ‘abc-123-def’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_PERMISSIONSLists a page of permissions for a file or shared drive. Use the returned next page token to retrieve further pages when present.

Input Parameters

string
FieldMask selecting the permission-list fields to return. Use comma-separated fields and parentheses for nested permission fields, for example ‘nextPageToken,permissions(id,type,role,emailAddress)’. Leave blank for Google’s default fields; use ’*’ only when every field is necessary because it increases response size.
string
required
The ID of the file or shared drive. Must be a non-empty string.
integer
The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned.
string
The token for continuing a previous list request on the next page. This should be set to the value of ‘nextPageToken’ from the previous response.
boolean
Whether the requesting application supports both My Drives and shared drives. Default: false
boolean
Issue the request as a domain administrator; if set to true, then theRequester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
string
Specifies which additional view’s permissions to include in the response. Only ‘published’ is supported.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_PROPERTIESDEPRECATED: Use ListPropertiesV1Beta instead. Tool to list GA4 properties under a specific account. Use after obtaining an account ID; supports pagination and including soft-deleted properties. Results may include legacy Universal Analytics properties; verify property type before use.

Input Parameters

string
required
Required. Google Analytics account resource name in format accounts/{account_id} where account_id is a Google Analytics account ID (typically 6-10 digits). Use GOOGLE_ANALYTICS_LIST_ACCOUNTS to get valid account IDs. Note: Do not use Google Account IDs (long numeric IDs from OAuth user info) - only Google Analytics account IDs are valid.
integer
Optional. Maximum number of properties to return; must be between 1 and 200.
string
Optional. Token returned from a previous call to retrieve the next page of results.
boolean
Optional. Whether to include soft-deleted (trashed) properties.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_PROPERTIES_FILTEREDTool to list GA4 properties based on filter criteria. Use when you need to find properties under a specific parent account or with specific firebase projects. Supports pagination and including soft-deleted properties.

Input Parameters

string
required
Required. Expression for filtering the results. Fields eligible for filtering: parent: (resource name of parent account/property), ancestor: (resource name of parent account), or firebase_project: (id or number of linked firebase project). Examples: ‘parent:accounts/123’ (account with id 123), ‘parent:properties/123’ (property with id 123), ‘ancestor:accounts/123’ (account with id 123), ‘firebase_project:project-id’ (firebase project with id project-id), ‘firebase_project:123’ (firebase project with number 123).
integer
Optional. Maximum number of properties to return (1-200). Default is 50.
string
Optional. Token from previous ListProperties call to retrieve the next page.
boolean
Optional. Whether to include soft-deleted (trashed) properties. Default is false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_RECORDINGSTool to list recording resources from a conference record. Use when you need to retrieve recordings from a specific Google Meet conference. Recordings are created when meeting recording is enabled and saved to Google Drive as MP4 files.

Input Parameters

string
required
Required. The conference record to list recordings for. Format: conferenceRecords/{conference_record}
integer
Maximum number of recordings to return. The service may return fewer than this value. If unspecified, at most 10 recordings are returned. The maximum value is 100; values above 100 are coerced to 100.
string
Page token returned from a previous list call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to the list call must match the call that provided the page token.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_RECURRING_AUDIENCE_LISTSList a page of recurring audience lists for a GA4 property, with a continuation token when more results are available. Use it to find existing recurring audience lists.

Input Parameters

string
required
Required. Resource name of the parent property. Format: properties/{property_id}
integer
Optional. Maximum number of recurring audience lists to return. Defaults to 200; maximum is 1000.
string
Optional. Token for retrieving the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_REPLIESList a page of replies to a specific comment on a Google Drive file. Supports pagination and optionally including deleted replies.

Input Parameters

string
Selector specifying which fields to include in a partial response. Use ’*’ for all fields or e.g. ‘replies(id,content),nextPageToken’
string
required
The ID of the file.
integer
The maximum number of replies to return per page.
string
required
The ID of the comment.
string
The token for continuing a previous list request on the next page. This should be set to the value of ‘nextPageToken’ from the previous response.
boolean
Whether to include deleted replies. Deleted replies will not include their original content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_REPORTING_DATA_ANNOTATIONSList a page of Reporting Data Annotations for a specific GA4 property, optionally filtering the results. Annotations document important events or periods in reporting data.

Input Parameters

string
Optional. Expression to refine results. Supported fields: name, title, description, annotationDate, annotationDateRange, color. Helper functions: annotation_duration(), is_annotation_in_range(). Operators: =, !=, <, >, <=, >=, :, =, !, NOT, AND, OR.
string
required
Required. Resource name of the property. Format: properties/{property_id}. Example: properties/123456789
integer
Optional. Maximum number of resources per response. Default: 50, Max: 200.
string
Optional. Pagination token from previous response to retrieve next page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_REPORT_TASKSList a page of report tasks for a Google Analytics property, including task definitions and execution status. A continuation token can be used to retrieve subsequent pages.

Input Parameters

string
required
Required. Property identifier in format ‘properties/{propertyId}’. The Google Analytics property whose report tasks should be listed.
integer
Optional. Maximum number of report tasks to return per page. If unspecified, server determines page size.
string
Optional. Pagination token from previous list response for retrieving next page of results. Omit for first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_REVISIONSTool to list a file’s revision metadata (not content) in Google Drive. Drive may prune old revisions, so history may be incomplete for frequently edited files. Filter client-side for specific revisionIds; do not assume the last entry is the active version.

Input Parameters

string
required
The ID of the file.
integer
The maximum number of revisions to return per page.
string
The token for continuing a previous list request on the next page. This should be set to the value of ‘nextPageToken’ from the previous response. Continue paginating until nextPageToken is absent; stopping early silently omits revisions.
boolean
Whether the requesting application supports both My Drives and shared drives. Defaults to false. Must be set to true for shared drive files; omitting it causes fileId resolution failures on shared drives.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SEND_ASLists the send-as aliases for a Gmail account, including the primary address and custom ‘from’ aliases. Use when you need to retrieve available sending addresses for composing emails.

Input Parameters

string
The user’s email address or the special value ‘me’ to indicate the authenticated user whose send-as aliases will be retrieved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SETTINGSDEPRECATED: Use GOOGLECALENDAR_SETTINGS_LIST instead. Tool to return all user settings for the authenticated user. Use when you need to retrieve calendar settings.

Input Parameters

string
Token for pagination to retrieve subsequent result pages
integer
Maximum number of settings to return

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SHARED_ALBUMSLists shared albums visible in the user’s Google Photos Sharing tab, with pagination. DEPRECATED: Google removed shared-album listing after March 31, 2025; use the Google Photos app to manage sharing instead.

Input Parameters

integer
Maximum number of albums to return. Default 20, maximum 50.
string
Continuation token for getting the next page of results. Use the value returned in nextPageToken from the previous response.
boolean
If true, excludes media items not created by this app. Defaults to false (all albums are returned). This field is ignored if the photoslibrary.readonly.appcreateddata scope is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SHARED_DRIVESTool to list the user’s shared drives. Use when you need to get a list of all shared drives accessible to the authenticated user. Results may differ from the web UI due to admin policies; listing a drive does not guarantee access to its contents. Paginated calls may trigger 403 rateLimitExceeded or 429 tooManyRequests; apply exponential backoff when iterating many pages.

Input Parameters

string
Query string for searching shared drives using Google Drive query syntax (e.g., “name contains ‘ProjectX’” or “createdTime > ‘2023-01-01T00:00:00’”). Query format: query_term operator values. Common query terms: name, createdTime, memberCount, organizerCount, hidden. Common operators: contains, =, >, <, >=, !=. String values must be enclosed in single quotes. Special characters (apostrophes, backslashes) must be escaped. Multiple terms can be combined with ‘and’/‘or’ operators and parentheses for grouping.
string
FieldMask selecting the shared-drive list fields to return. Use comma-separated fields and parentheses for nested drive fields, for example ‘nextPageToken,drives(id,name,hidden,createdTime)’. Leave blank for Google’s default fields; use ’*’ only when every field is necessary because it increases response size.
integer
Maximum number of shared drives to return per page. Maximum allowed value is 1000. Paginate by passing the returned nextPageToken back as pageToken until no nextPageToken is returned to avoid silently missing drives.
string
Page token for shared drives.
boolean
Issue the request as a domain administrator. If set to true, then all shared drives of the domain in which the requester is an administrator are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SK_AD_NETWORK_CONVERSION_VALUE_SCHEMASTool to list SKAdNetworkConversionValueSchema configurations for an iOS data stream. Use when you need to retrieve conversion value schemas for iOS app tracking. Maximum one schema per property is supported.

Input Parameters

string
required
Required. The DataStream resource to list schemas for. Format: properties/{property_id}/dataStreams/{dataStream}. Example: ‘properties/123456789/dataStreams/1234567890’
integer
Optional. Maximum number of resources per response. Default: 50, Maximum: 200.
string
Optional. Token from previous call for pagination to retrieve next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SMART_NOTESList metadata for smart notes generated by Take Notes with Gemini in a Google Meet conference. Returns resource names, generation states, timestamps, and Google Docs destinations, not note text. Follow nextPageToken to retrieve subsequent pages.

Input Parameters

string
required
Required. Conference record to list smart notes for. Format: conferenceRecords/{conference_record}.
integer
Maximum number of smart notes to return. If unspecified, at most 10 are returned. The service may return fewer. Values above 100 are coerced to 100 by the service; this maximum may change.
string
Page token returned from a previous list call. Provide it to retrieve the next page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SMIME_INFOLists S/MIME certificate configurations for a specified Gmail send-as alias. If Gmail reports that the feature is not enabled, returns an empty list with S/MIME marked disabled.

Input Parameters

string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.
string
required
The email address that appears in the ‘From:’ header for mail sent using this alias.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SPREADSHEET_CHARTSTool to retrieve a list of all charts from a specified Google Sheets spreadsheet. Use when you need to get chart IDs and their specifications for embedding or referencing elsewhere, such as in Google Docs.

Input Parameters

string
required
The ID of the Google Sheets spreadsheet from which to retrieve charts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SUB_ACCOUNTSList direct child/sub-accounts under a Google Ads manager (MCC) account. Use this before account-scoped read or mutate calls when a user needs to choose which child account to target. The returned customer_id values can be passed to other Google Ads tools as their customer_id.

Input Parameters

string
Pagination token from a previous response’s next_page_token.
string
Manager/MCC Google Ads customer ID whose direct sub-accounts should be listed; hyphens and spaces are stripped. Defaults to the connection customer_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SUBPROPERTY_EVENT_FILTERSList a page of subproperty event filters on a property, including filters that route events to subproperties. Use the returned page token to retrieve subsequent pages.

Input Parameters

string
required
Required. Resource name of the ordinary property. Format: properties/{property_id}
integer
Optional. Maximum number of resources to return; at most 50 by default, maximum 200.
string
Optional. Page token received from a previous call to retrieve the next page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_SUBPROPERTY_SYNC_CONFIGSTool to list SubpropertySyncConfig resources for managing subproperty synchronization configurations. Use when you need to fetch subproperty sync configs for a GA4 property.

Input Parameters

string
required
Required. Resource name of the property. Format: properties/{property_id}. Example: properties/123
integer
Optional. The maximum number of resources to return. May return fewer. If unspecified, at most 50 resources will be returned. Maximum value is 200.
string
Optional. A page token received from a previous ListSubpropertySyncConfig call. Provide this to retrieve the subsequent page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_TABLESDeprecated: Lists heuristically detected tables in a Google Spreadsheet. It scans up to the first 1,000 rows and skips sheets with more than 2,000 rows or 100 columns.

Input Parameters

integer
Minimum number of data rows to consider a valid table
integer
Minimum number of columns to consider a valid table
number
Minimum confidence score (0.0-1.0) to consider a valid table
string
required
The actual Google Spreadsheet ID (not a placeholder or spreadsheet name). Find it in the spreadsheet URL: https://docs.google.com/spreadsheets/d/&#123;SPREADSHEET_ID&#125;/edit. It is the alphanumeric string between ‘/d/’ and ‘/edit’ (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’). IMPORTANT: Do NOT pass the spreadsheet name - only pass the alphanumeric ID from the URL. Do NOT pass template placeholders like ‘{{spreadsheet_id}}’, ‘<spreadsheet_id>’, or ‘your-spreadsheet-id-here’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_TASK_LISTSFetches the authenticated user’s task lists from Google Tasks; results may be paginated. Response contains task lists under the items key. Multiple lists may share similar names — confirm the correct list by ID before passing to other tools.

Input Parameters

string
Token for the page of results to return; omit for the first page, use nextPageToken from a previous response for subsequent pages.
integer
Maximum number of task lists to return per page. Capped at 100; values above 100 are silently truncated to 100.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_TASKSRetrieves tasks from a Google Tasks list with optional date, status, and pagination filters; date inputs can use human-readable formats, and a completion range forces an explicit false showCompleted value to true. Tasks are returned under tasks, ordered by position; filter titles or notes client-side for text search.

Input Parameters

string
Exclude tasks due after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Exclude tasks due before this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Token from a previous list operation for fetching a specific page; if omitted, retrieves the first page.
integer
Maximum number of tasks to return. API default: 20, maximum: 100. Use nextPageToken from the response in successive calls until absent to avoid missing tasks beyond the first page.
boolean
Include hidden tasks. Defaults to false.
string
Lower bound for task’s last modification time (for syncing). Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include deleted tasks. Defaults to false.
string
required
Identifier of the task list. Use ‘@default’ for the user’s primary list, or provide a task list ID from GOOGLETASKS_LIST_TASK_LISTS. The common aliases ‘primary’, ‘default’, and ‘@primary’ are normalized to ‘@default’.
string
Exclude tasks completed after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Exclude tasks completed before this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include completed tasks. Defaults to true. (See action docstring for interaction with completedMin/Max).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_TEAM_DRIVESTool to list Team Drives (deprecated, use List Shared Drives instead). Use when you need to retrieve Team Drives using the legacy endpoint.

Input Parameters

string
Query string for searching Team Drives.
string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports.
string ("1" | "2")
V1 error format values.
string
Selector specifying which fields to include in a partial response.
string
JSONP callback.
integer
Maximum number of Team Drives to return per page.
string
Page token for Team Drives.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).
boolean
Issue the request as a domain administrator; if set to true, then all Team Drives of the domain in which the requester is an administrator are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_THREADSRetrieves a list of email threads from a Gmail account, identified by user_id (email address or ‘me’), supporting filtering and pagination. Spam and trash are excluded by default unless explicitly targeted via label:spam or label:trash in the query.

Input Parameters

string
Filter for threads, using Gmail search query syntax (e.g., ‘from:user@example.com is:unread’). Supported operators include from:, to:, subject:, label:, is:unread, has:attachment, after:, before:. Dates must use YYYY/MM/DD format; date operators are UTC-based. Exact subject phrases require quotes (e.g., subject:'meeting notes').
string
The user’s email address or ‘me’ to specify the authenticated Gmail account.
boolean
If false, returns threads with basic fields (id, snippet, historyId). If true, returns threads with complete message details including headers, body, attachments, and metadata for each message in the thread. Combining verbose=true with large max_results produces very large responses; keep max_results modest when verbose is enabled.
string
Token from a previous response to retrieve a specific page of results; omit for the first page.
integer
Maximum number of threads to return. Hard cap is ~500 per call. For full mailbox coverage, loop using nextPageToken via page_token until absent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LIST_TRANSCRIPT_ENTRIESTool to list structured transcript entries (speaker/time/text segments) for a specific Google Meet transcript. Use when you need to access the detailed content of a transcript, including individual spoken segments with timestamps and speaker information. Note: The transcript entries returned by the API might not match the transcription in Google Docs due to interleaved speakers or post-generation modifications.

Input Parameters

integer
Maximum number of transcript entries to return. The service might return fewer than this value. If unspecified, at most 10 entries are returned. The maximum value is 100; values above 100 are coerced to 100.
string
Page token returned from a previous list call, used to retrieve the next page of results.
string
required
The unique identifier of the transcript within the conference record.
string
required
The unique identifier of the conference record.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LOOKUP_AERIAL_VIDEOTool to look up an aerial view video by address or video ID. Returns video metadata including state and URIs for playback. Use when you need to retrieve a previously rendered aerial video or check the status of a video render request. A PROCESSING response includes metadata.videoId for a later lookup and no playback URIs. Only a lookup returning a ready video is billable.

Input Parameters

string
A US postal address. Either videoId or address must be provided, but not both.
string
An ID returned from videos.renderVideo. Either videoId or address must be provided, but not both.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_LOOKUP_SPREADSHEET_ROWFinds the first row in a specified A1 range or the first sheet where a cell matches the query after Unicode and invisible-character normalization. Matching is case-insensitive and trims surrounding whitespace by default; both behaviors are configurable.

Input Parameters

string
required
Exact text value to find; matches the entire content of a cell in a row.
string
A1 notation range to search within. Supports cell ranges (e.g., ‘Sheet1!A1:D5’), column-only ranges (e.g., ‘Sheet1!A:Z’), and row-only ranges (e.g., ‘Sheet1!1:1’). Defaults to the first sheet if omitted. IMPORTANT: Sheet names with spaces must be single-quoted (e.g., “‘My Sheet’!A1:Z”). Bare sheet names without ranges (e.g., ‘Sheet1’) are not supported - always specify a range.
boolean
If True, the query string search is case-sensitive.
string
required
Identifier of the Google Spreadsheet to search.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How cell values are rendered in the returned row data. unformatted: raw values without display formatting — dates appear as serial numbers, e.g. 46009.47 (default, keeps consistency with UPSERT). formatted: display-formatted values — dates appear as strings, e.g. ‘2025-12-18’. formula: raw formulas instead of computed values.
boolean
If True, strips leading and trailing whitespace from cell values before matching. This helps match cells like ’ TOTAL ’ or ‘TOTAL ’ when searching for ‘TOTAL’.
string
How dates and times are represented. FORMATTED_STRING: human-readable strings (e.g. ‘2025-12-18 11:17’). SERIAL_NUMBER: Excel-style serial numbers. Works with all value_render_option settings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MAPS_EMBED_APIGenerates a Google Maps Embed URL and HTML iframe code for place, view, directions, street view, or search mode using an API key, without making an API call. Supply URL-escaped parameter values; generated URLs contain the key and location query.

Input Parameters

string ("place" | "view" | "directions" | "streetview" | "search")
required
The mode of the embedded map.
string
Google Maps API key. Required if not provided via connection metadata. The Maps Embed API only supports API key authentication, not OAuth.
object
Parameters for ‘view’ mode.
object
Parameters for ‘place’ mode.
object
Parameters for ‘search’ mode.
object
Parameters for ‘directions’ mode.
object
Parameters for ‘streetview’ mode.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MODIFY_FILE_LABELSModifies the set of labels applied to a file. Returns a list of the labels that were added or modified. Use when you need to programmatically change labels on a Google Drive file, such as adding, updating, or removing them.

Input Parameters

string
This is always drive#modifyLabelsRequest.
string
required
The ID of the file.
array
required
The list of modifications to apply to the labels on the file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MODIFY_THREAD_LABELSAdds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid. To modify a single message only, use a message-level tool instead.

Input Parameters

string
User’s email address or ‘me’ for the authenticated user.
string
required
Immutable ID of the thread to modify.
array
List of label IDs to add to the thread. Must be valid label IDs that exist in the user’s account. System labels use uppercase names (e.g., ‘INBOX’, ‘STARRED’, ‘IMPORTANT’, ‘UNREAD’, ‘SPAM’, ‘TRASH’, ‘SENT’, ‘DRAFT’, ‘CATEGORY_PERSONAL’, ‘CATEGORY_SOCIAL’, ‘CATEGORY_PROMOTIONS’, ‘CATEGORY_UPDATES’, ‘CATEGORY_FORUMS’). Custom labels use the format ‘Label_N’ (e.g., ‘Label_1’, ‘Label_42’). Use GMAIL_LIST_LABELS to discover available label IDs. Accepts either a list or a JSON-encoded string. Note: If a label appears in both add_label_ids and remove_label_ids, the add operation takes priority. Use GMAIL_CREATE_LABEL first if the label does not yet exist, then supply its returned ID here.
array
List of label IDs to remove from the thread. Must be valid label IDs that exist in the user’s account. System labels use uppercase names (e.g., ‘INBOX’, ‘STARRED’, ‘IMPORTANT’, ‘UNREAD’, ‘SPAM’, ‘TRASH’, ‘SENT’, ‘DRAFT’, ‘CATEGORY_PERSONAL’, ‘CATEGORY_SOCIAL’, ‘CATEGORY_PROMOTIONS’, ‘CATEGORY_UPDATES’, ‘CATEGORY_FORUMS’). Custom labels use the format ‘Label_N’ (e.g., ‘Label_1’, ‘Label_42’). Use GMAIL_LIST_LABELS to discover available label IDs. Accepts either a list or a JSON-encoded string. Note: Labels that appear in both add_label_ids and remove_label_ids will be automatically removed from this list (add takes priority).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MOVE_CHARTMove or resize an existing chart on a Google Sheets spreadsheet. Use this action when you need to reposition a chart to a different location on the same or different sheet, move it to a brand-new sheet, or change its size. This action wraps the updateEmbeddedObjectPosition batchUpdate request type and supports three positioning modes: moving to a new sheet, moving to an existing sheet, or repositioning via pixel-perfect overlay coordinates.

Input Parameters

integer
required
The unique numeric identifier of the chart to move within the spreadsheet. This is the chartId value (also known as objectId) returned when the chart was created or can be retrieved using GOOGLESHEETS_LIST_CHARTS or ‘Get Spreadsheet Info’ action (look for sheets[].charts[].chartId in the response). The chart must already exist in the specified spreadsheet.
boolean
Set to true to move the chart to a brand-new sheet. Google Sheets will automatically create and name the new sheet. This is mutually exclusive with target_sheet_id and anchor_sheet_id.
integer
Width of the chart in pixels. Only valid when anchor_sheet_id is provided. If omitted, Google Sheets preserves the existing width.
integer
Height of the chart in pixels. Only valid when anchor_sheet_id is provided. If omitted, Google Sheets preserves the existing height.
string
required
The unique identifier of the Google Sheets spreadsheet containing the chart to move. Must be the actual spreadsheet ID from the URL (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’), NOT the spreadsheet name or title. Find it in the URL: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit
integer
The numeric sheetId of the sheet to anchor the chart onto when repositioning via overlay coordinates. Required if any of anchor_row_index, anchor_column_index, offset_x_pixels, offset_y_pixels, width_pixels, or height_pixels is provided. This is mutually exclusive with new_sheet and target_sheet_id.
integer
Horizontal pixel offset from the anchor cell. Only valid when anchor_sheet_id is provided. If omitted, Google Sheets preserves the existing horizontal offset.
integer
Vertical pixel offset from the anchor cell. Only valid when anchor_sheet_id is provided. If omitted, Google Sheets preserves the existing vertical offset.
integer
The numeric sheetId of an existing sheet to move the chart to. The chart’s anchor position on that sheet will remain unchanged. This is mutually exclusive with new_sheet and anchor_sheet_id. Use ‘Get Spreadsheet Info’ to retrieve valid sheetIds.
integer
The 0-based row index of the anchor cell for overlay positioning. Required if anchor_sheet_id is set. Must be used together with anchor_column_index.
integer
The 0-based column index of the anchor cell for overlay positioning. Required if anchor_sheet_id is set. Must be used together with anchor_row_index.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MOVE_FILEMoves a file to another Google Drive folder. At least one of add_parents or remove_parents is required; calls with neither are rejected. Supply add_parents with the destination folder ID; if remove_parents is omitted, the action checks and removes the current parent automatically before adding the destination. For My Drive files only, remove_parents without add_parents moves the file to My Drive root. For shared-drive items, set supports_all_drives=true and provide add_parents because the item must retain exactly one parent; membership, role, and domain policies can restrict moves, and the Drive API cannot move a folder from My Drive into a shared drive. Google Drive files have one parent, so use a shortcut for additional placements.

Input Parameters

string
required
The ID of the file to move. Must be a non-empty string.
string
The ID of the single destination folder (e.g., ‘1FmTIJYwTENUDXOKyNJp7OmcRBvP_6DmT’). Folder names are not accepted. When remove_parents is omitted, the action checks the file’s current parent and removes it automatically before adding this destination. Omit this only when using remove_parents to move a My Drive file to My Drive root. For a shared-drive item, set supports_all_drives=true and provide this destination because the item must retain exactly one parent. At least one of add_parents or remove_parents is required.
string
A language hint for OCR processing during image import (ISO 639-1 code).
string
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
string
A comma-separated list of current parent folder IDs to remove. This is optional when add_parents is supplied because the action checks and removes the current parent automatically. For My Drive files only, supplying this without add_parents moves the file to My Drive root. Do not use remove_parents alone for a shared-drive item; shared-drive items must retain exactly one parent. At least one of add_parents or remove_parents is required.
boolean
Whether the request supports both My Drive and shared drives. Set this to true when the source file or destination folder is in a shared drive; otherwise Google can return not-found or unsupported-drive errors.
boolean
Whether to set the ‘keepForever’ field in the new head revision. This is only applicable to files with binary content in Google Drive.
string
Specifies which additional view’s permissions to include in the response. Only ‘published’ is supported.
boolean
Whether to use the uploaded content as indexable text.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MOVE_SPREADSHEET_TO_FOLDERMove an existing Google Spreadsheet to a different Google Drive folder.

Input Parameters

string
required
ID of the existing Google Spreadsheet to move.
string
required
ID of the Google Drive folder that should become the spreadsheet’s parent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MOVE_TASKMoves the specified task to another position in the task list or to a different task list. Use cases: - Reorder tasks within a list (use ‘previous’ parameter) - Create subtasks by moving a task under a parent (use ‘parent’ parameter) - Move tasks between different task lists (use ‘destinationTasklist’ parameter) - Move a subtask back to top-level (omit ‘parent’ parameter)

Input Parameters

string
required
Task identifier of the task to move. Must be a valid task ID from the source tasklist. Obtain this from ‘List Tasks’ or ‘Insert Task’ actions.
string
New parent task identifier. If provided, the task becomes a subtask of this parent. The parent must exist in the destination list (or source list if no destinationTasklist is specified). Omit to move task to top level.
string
New previous sibling task identifier. The task will be positioned immediately after this sibling. Omit to position the task first among its siblings. Must exist in the same list as the task’s destination (destinationTasklist if specified, otherwise source tasklist). Cross-list sibling references are unsupported.
string
required
Source task list identifier where the task currently exists. Use ‘@default’ for the user’s primary task list, or provide a specific task list ID obtained from ‘List Task Lists’. The task must exist in this list.
string
Destination task list identifier. If set, the task is moved from the source tasklist to this list. Omit to reorder within the same list. Note: Recurrent tasks cannot be moved between lists.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MOVE_THREAD_TO_TRASHMoves the specified thread to the trash. Any messages that belong to the thread are also moved to the trash.

Input Parameters

string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.
string
required
Required. The ID of the thread to trash. This moves all messages in the thread to trash.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MOVE_TO_TRASHMoves an existing, non-deleted email message to the trash for the specified user. Trashed messages are recoverable and still count toward storage quota until purged. Prefer this over GMAIL_BATCH_DELETE_MESSAGES when recovery may be needed. For bulk operations, use GMAIL_BATCH_MODIFY_MESSAGES or GMAIL_BATCH_DELETE_MESSAGES instead of repeated calls to this tool.

Input Parameters

string
User’s email address or ‘me’ for the authenticated user.
string
required
Required. The unique identifier of the email message to move to trash. This is a hexadecimal string that can be obtained from listing or fetching emails. Verify the correct message via subject/snippet before trashing to avoid affecting unrelated conversations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_AD_GROUP_ADSCreate, update, or remove ads in Google Ads ad groups, including responsive search ads. Use this after creating campaigns, budgets, ad groups, and keywords so the ad group has creative that can serve.

Input Parameters

array
required
AdGroupAd operations. For responsive search ads, create payloads usually include ad_group, status, and ad.responsive_search_ad with headlines/descriptions, plus ad.final_urls.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_AD_GROUP_ASSETSCreate, update, or remove links between assets and ad groups. Use this after creating assets to attach sitelinks, callouts, snippets, images, and other asset types at ad group level.

Input Parameters

array
required
AdGroupAsset operations for linking assets to ad groups. Create payloads commonly include ad_group, asset, field_type, and status.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_AD_GROUP_BID_MODIFIERSCreate, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria.

Input Parameters

array
required
AdGroupBidModifier operations. Common create fields include ad_group, bid_modifier, and exactly one criterion such as device or hotel-specific bid modifier criteria.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_AD_GROUP_CRITERIACreate, update, or remove Google Ads ad group criteria in a batch, including keywords, audiences, demographics, mobile apps, YouTube placements, topics, webpages, and Shopping listing groups. Manage bids or remove criteria; removal is irreversible, and validate-only requests test changes without committing them.

Input Parameters

array
required
List of ad group criterion operations to apply atomically (unless partial_failure=true). Each operation MUST contain exactly one of: create, update, or remove.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, the request is validated but no changes are applied. Useful for dry runs. Mutually exclusive with partial_failure (cannot both be true).
boolean
If true, valid operations succeed even when others in the batch fail. Errors are returned in partial_failure_error. If false, the entire batch is atomic — any failure rolls back all changes.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of the mutated resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_AD_GROUPSCreate, update, or remove ad groups within Google Ads campaigns. Supports batch operations with multiple ad group changes in a single request. Use when you need to manage ad groups programmatically, such as creating new ad groups for campaigns, updating ad group settings or status, or removing ad groups that are no longer needed. This action is irreversible for remove operations — deleted ad groups cannot be recovered once removed.

Input Parameters

array
required
List of ad group operations (create, update, or remove). At least one operation is required.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without executing. Useful for testing before making actual changes.
boolean
If true, valid operations succeed even if other operations fail. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_ADSUpdate existing Google Ads ad creative fields. Does not create or remove ads or modify ad-group association/status. Updating TextAd, ExpandedDynamicSearchAd, GmailAd, and ImageAd is not supported. Use validate_only for a dry run and inspect partial_failure_error when partial_failure is enabled.

Input Parameters

array
required
Update operations on individual ads.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
Validate without applying changes; only errors, not results, are returned.
boolean
If true, valid operations succeed and failed operations are reported in partial_failure_error, even with HTTP 200. Otherwise atomic.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
RESOURCE_NAME_ONLY or UNSPECIFIED returns resource names; MUTABLE_RESOURCE also returns mutable ad fields when possible.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_ASSET_GROUP_ASSETSCreate, update, or remove links between assets and Performance Max asset groups. Use this after creating compatible assets and an asset group.

Input Parameters

array
required
AssetGroupAsset operations. Create payloads include asset_group, asset, field_type, and status. Updates require resource_name and mutable fields such as status; update_mask is generated when omitted. Remove uses customers/{customer_id}/assetGroupAssets/{asset_group_id}{asset_id}{field_type}.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_ASSET_GROUPSCreate, update, or remove Google Ads asset groups for Performance Max campaigns. Use validate_only to check operations without making changes. Link assets separately with Mutate Asset Group Assets. Creating Performance Max asset groups may require a GoogleAdsService mutate with asset links in the same request to satisfy minimum asset requirements.

Input Parameters

array
required
AssetGroup create, update, or remove operations. Create payloads use campaign (customers/{customer_id}/campaigns/{campaign_id}), name (1-128 characters, unique within the campaign), and fields such as status, final_urls, final_mobile_urls, path1, path2, tracking_url_template, final_url_suffix, or url_custom_parameters (key/value mappings). Updates require resource_name and mutable fields; update_mask is generated when omitted. Remove uses customers/{customer_id}/assetGroups/{asset_group_id}. Snake_case and lowerCamelCase resource fields are accepted. Set exactly one of create, update, or remove per operation.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes. Only errors are returned, not mutation results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_ASSETSCreate or update supported Google Ads assets such as sitelinks, structured snippets, text assets, lead forms, promotions, calls, price assets, and media assets. Use Create Callout Asset for validated immutable callouts. Google Ads does not allow removing assets; cleanup removes their resource associations.

Input Parameters

array
required
Asset operations. Supported asset payloads include text_asset, callout_asset, structured_snippet_asset, sitelink_asset, lead_form_asset, promotion_asset, call_asset, price_asset, youtube_video_asset, media_bundle_asset, and other Google Ads Asset fields.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_ASSET_SETSCreate, update, or remove Google Ads asset sets, which group assets for feeds, locations, and other campaign uses. Link assets to a set separately with an AssetSetAsset mutation, and attach sets to campaigns with Mutate Campaign Asset Sets.

Input Parameters

array
required
AssetSet operations. Create payloads require name and type. Updates require resource_name and mutable fields such as name; update_mask is generated when omitted. Remove uses customers/{customer_id}/assetSets/{asset_set_id}.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
UNSPECIFIED uses the API default. RESOURCE_NAME_ONLY returns only resource names. MUTABLE_RESOURCE returns mutable resource fields after mutation when supported.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_AUDIENCESCreate or update Google Ads audiences combining segment attributes. Does not support removal. Use validate_only to check operations without changing audiences. Inspect partial_failure_error when partial_failure is true.

Input Parameters

array
required
Audience create or update operations; remove is not supported. Create accepts name, description, dimensions, exclusion_dimension, scope, and asset_group. CUSTOMER scope requires a unique name (1-255 characters); ASSET_GROUP scope requires asset_group and forbids name. Updates need resource_name (customers/{customer_id}/audiences/{audience_id}) and mutable fields. update_mask is generated if omitted. Nested payload keys accept snake_case or lowerCamelCase.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
UNSPECIFIED or RESOURCE_NAME_ONLY returns resource names; MUTABLE_RESOURCE also returns mutable audience fields when available.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_BIDDING_STRATEGIESCreate, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion Value, and Target Impression Share.

Input Parameters

array
required
BiddingStrategy operations. Create payloads include name and one bidding scheme such as target_cpa, target_roas, target_spend, maximize_conversions, maximize_conversion_value, or target_impression_share.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CAMPAIGN_ASSETSCreate, update, or remove links between assets and campaigns. Use this after creating assets to attach sitelinks, callouts, snippets, and other asset types at campaign level.

Input Parameters

array
required
CampaignAsset operations for linking assets to campaigns. Create payloads commonly include campaign, asset, field_type, and status.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CAMPAIGN_BUDGETSCreate, update, or remove Google Ads campaign budgets. Use this before creating campaigns because campaign creation requires an existing campaign_budget resource name.

Input Parameters

array
required
CampaignBudget operations. Common create/update fields include name, amount_micros, total_amount_micros, delivery_method, explicitly_shared, period, type, and resource_name for updates.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CAMPAIGN_CRITERIACreate, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules, audiences, and IP exclusions.

Input Parameters

array
required
CampaignCriterion operations for campaign-level targeting or exclusions. Common create fields include campaign, negative, status, bid_modifier, and exactly one criterion field such as location, language, keyword, device, ad_schedule, or ip_block.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CAMPAIGN_LABELSCreate or remove relationships between campaigns and labels. Use this after creating labels to organize campaigns for filtering and reporting.

Input Parameters

array
required
CampaignLabel operations. Create payloads include campaign and label resource names. Remove uses customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CAMPAIGNSCreate, update, or remove Google Ads campaigns in a batch; removal is irreversible and validate-only can check changes before applying them. Creates default to a declaration that the campaign does not contain EU political advertising and to Manual CPC when no bidding strategy is supplied.

Input Parameters

array
required
List of campaign operations to perform. Each operation can be create, update, or remove. At least one operation is required.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without executing. Useful for testing before making actual changes.
boolean
If true, valid operations succeed even if others fail. Partial failures will be reported in the response.
string
Whether to return full resource or just resource name. Options: ‘RESOURCE_NAME_ONLY’ or ‘MUTABLE_RESOURCE’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CAMPAIGNS_V2Create, update, or remove Search and Display Google Ads campaigns in a batch; new campaigns default to paused when status is omitted. Removal is irreversible, and validate-only can check changes before applying them.

Input Parameters

array
required
List of campaign operations to perform. Each operation can be create, update, or remove. At least one operation is required.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without executing. Useful for testing before making actual changes.
boolean
If true, valid operations succeed even if others fail. Partial failures will be reported in the response.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CONDITIONAL_FORMAT_RULESAdd, update, delete, or reorder conditional format rules on a Google Sheet. Use when you need to create, modify, or remove conditional formatting without manually building batchUpdate requests. Supports four operations: ADD (create new rule), UPDATE (replace existing rule), DELETE (remove rule), MOVE (reorder rules by changing index).

Input Parameters

object
Conditional format rule specification.
integer
Zero-based index for the operation. Required for UPDATE, DELETE, MOVE. Optional for ADD (defaults to end of list).
integer
required
The unique numeric identifier of the sheet/tab to modify (NOT a zero-based index). This is a specific ID assigned by Google Sheets when the sheet is created, not the position of the sheet. You MUST first call GOOGLESHEETS_GET_SPREADSHEET_INFO to retrieve the actual sheetId values from the ‘sheets’ array in the response. Common mistake: Do not assume sheet_id=0 exists - while some spreadsheets may have a sheet with ID 0, many do not.
integer
Destination index for MOVE operation. Required when operation is MOVE.
string ("ADD" | "UPDATE" | "DELETE" | "MOVE")
required
Operation type: ADD (add new rule), UPDATE (replace rule), DELETE (remove rule), MOVE (change rule order/index).
string
required
The ID of the spreadsheet containing the sheet to modify. Found in the Google Sheets URL between ‘/d/’ and ‘/edit’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CONVERSION_ACTIONSCreate, update, or remove Google Ads conversion actions for conversion tracking configuration. This manages Google Ads conversion action resources; installing website/app tags remains outside this action.

Input Parameters

array
required
ConversionAction operations. Common fields include name, status, type, category, primary_for_goal, lookback windows, value_settings, counting_type, and attribution_model_settings.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CUSTOM_AUDIENCESCreate, update, or remove Google Ads custom audiences used to reach users by interests, searches, visited URLs, place categories, or installed apps.

Input Parameters

array
required
CustomAudience operations. Create payloads require name and type. Updates require resource_name and mutable fields; update_mask is generated when omitted. Remove uses customers/{customer_id}/customAudiences/{custom_audience_id}.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CUSTOMERUpdate one Google Ads customer’s mutable account settings using CustomerService. This is not the GoogleAdsService batch mutate endpoint. Use validate_only=true to check an update without changing account settings.

Input Parameters

object
required
The single customer update operation to perform.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates without applying changes; no result is returned.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
RESOURCE_NAME_ONLY or UNSPECIFIED returns the resource name; MUTABLE_RESOURCE also returns mutable customer fields when possible.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_CUSTOMER_ASSETSCreate or remove customer-level asset associations. Removal irreversibly removes the current association; recreate it to restore the link. Use this after creating assets to attach callouts, sitelinks, snippets, and other asset types across a Google Ads customer account.

Input Parameters

array
required
CustomerAsset operations for associating assets with a customer or removing existing customer-level associations.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_KEYWORD_PLAN_AD_GROUP_KEYWORDSCreate, update, or remove Google Ads Keyword Planner ad group keywords. These are planning resources, not serving keywords. Creates need an existing Keyword Plan ad group. Use validate_only to validate without applying changes; validation returns no results. Inspect partial_failure_error when partial_failure is enabled, even on HTTP 200.

Input Parameters

array
required
KeywordPlanAdGroupKeyword operations, each with exactly one of create, update, or remove. Create accepts keyword_plan_ad_group (the parent resource name), text, match_type (EXACT, PHRASE, BROAD), negative, and optional cpc_bid_micros (an int64 decimal string overriding the ad group bid; not applicable to negative keywords). Do not supply the output-only id. Update includes resource_name and changed fields, with update_mask or a mask generated from non-null fields. negative is immutable. Remove uses customers/{customer_id}/keywordPlanAdGroupKeywords/{kp_ad_group_keyword_id}. Resource dictionaries accept snake_case or lowerCamelCase keys.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_KEYWORD_PLAN_AD_GROUPSCreate, update, or remove Google Ads Keyword Planner ad groups. These are planning resources, not serving ad groups. A create needs an existing keyword plan campaign. Use validate_only to check operations without applying changes; validation returns no results. Inspect partial_failure_error when partial_failure is enabled, even on HTTP 200.

Input Parameters

array
required
KeywordPlanAdGroup operations, each with exactly one of create, update, or remove. Create requires a non-empty name and the parent keyword_plan_campaign resource name. Optional cpc_bid_micros is an int64 decimal string; when omitted the campaign bid is inherited. Updates include resource_name and changed fields, with an optional update_mask (otherwise generated). Remove uses customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}. Resource dictionaries accept snake_case or lowerCamelCase keys.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_KEYWORD_PLAN_CAMPAIGN_KEYWORDSCreate, update, or remove negative keywords in Keyword Plan campaigns. These planning resources do not change serving campaign keywords. Set validate_only to validate without changes. With partial_failure, inspect partial_failure_error even on HTTP success; valid operations may be applied.

Input Parameters

array
required
KeywordPlanCampaignKeyword create, update, or remove operations. For create, provide keyword_plan_campaign (customers/{customer_id}/keywordPlanCampaigns/{campaign_id}), text, match_type (EXACT, PHRASE, or BROAD), and negative=true. Only negative campaign keywords are supported. Updates require resource_name and fields to change, with optional update_mask; negative is immutable. Remove takes customers/{customer_id}/keywordPlanCampaignKeywords/{keyword_id}. Use snake_case or lowerCamelCase resource keys. Do not supply the output-only id. Resource names must belong to the target customer.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_KEYWORD_PLAN_CAMPAIGNSCreate, update, or remove campaigns in an existing Keyword Plan. These planning resources do not create serving ad campaigns. Set validate_only to validate without changes. With partial_failure, inspect partial_failure_error even on HTTP success; successful operations may still have been applied.

Input Parameters

array
required
KeywordPlanCampaign create, update, or remove operations. For create, provide keyword_plan (customers/{customer_id}/keywordPlans/{plan_id}), name, cpc_bid_micros (int64 string in account currency), and keyword_plan_network (GOOGLE_SEARCH or GOOGLE_SEARCH_AND_PARTNERS). Optional language_constants accepts at most one language resource name; geo_targets accepts up to 20 objects with geo_target_constant. A plan allows at most one campaign. Updates require resource_name; remove is customers/{customer_id}/keywordPlanCampaigns/{campaign_id}. Use snake_case or lowerCamelCase resource keys.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_KEYWORD_PLANSCreate, update, or remove saved Google Ads Keyword Planner plans. These plans are planning resources, not live advertising campaigns. Use validate_only to validate without saving changes. With partial_failure, inspect partial_failure_error even when the HTTP request succeeds.

Input Parameters

array
required
KeywordPlan operations. Create requires a non-empty name and no resource_name. Optional forecast_period accepts either date_interval (NEXT_WEEK, NEXT_MONTH, NEXT_QUARTER) or date_range with start_date and end_date (YYYY-MM-DD, future dates, at most one year). Update requires resource_name customers/{customer_id}/keywordPlans/{plan_id} and the fields to change; update_mask is generated if omitted. Remove takes that resource name. The id field is output-only. Resource keys accept snake_case or lowerCamelCase.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_LABELSCreate, update, or remove Google Ads labels. Pair this with campaign label mutations to organize campaigns and support filtering.

Input Parameters

array
required
Label operations. Common fields include name and text_label with background_color and description.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_PORTFOLIO_BIDDING_STRATEGIESCreate, edit, or remove typed Target CPA and Target ROAS portfolio strategies. Attach with Mutate Campaigns, read with Get Required Google Ads Report, and transition all campaigns before removal. Budget alignment is not exposed because Google requires the bidding strategy and campaign budget to be changed atomically with GoogleAdsService.Mutate, while this action uses the resource-specific mutate endpoint. currency_code can be set on create only for manager-account strategies.

Input Parameters

array
required
Typed Target CPA or Target ROAS portfolio strategy operations.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_SHARED_CRITERIACreate or remove criteria in a Google Ads shared set, such as negative keywords or excluded placements shared across campaigns.

Input Parameters

array
required
SharedCriterion operations. Create payloads require shared_set and one criterion field, such as keyword or placement. Remove uses customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id}.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
UNSPECIFIED uses the API default. RESOURCE_NAME_ONLY returns only resource names. MUTABLE_RESOURCE also returns mutable shared criterion fields when possible.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_SHARED_SETSCreate, update, or remove Google Ads shared sets used to group shared criteria, such as negative keyword lists, for reuse across campaigns.

Input Parameters

array
required
SharedSet operations. Create payloads require name and type. Updates require resource_name and mutable fields such as name; update_mask is generated when omitted. Remove uses customers/{customer_id}/sharedSets/{shared_set_id}.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
UNSPECIFIED uses the API default. RESOURCE_NAME_ONLY returns only resource names. MUTABLE_RESOURCE returns mutable resource fields after mutation when supported.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_MUTATE_USER_LISTSCreate, update, or remove general Google Ads user-list resources used for audience targeting and remarketing.

Input Parameters

array
required
UserList operations. Create and update accept Google Ads UserList fields; updates include resource_name, and remove uses a user-list resource name.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_NEARBY_SEARCHSearches for places (e.g., restaurants, parks) within a specified circular area, with options to filter by place types and customize the returned fields and number of results.

Input Parameters

number
required
Radius of the circular search area in meters.
number
required
Latitude coordinate of the search center in decimal degrees.
string
Comma-separated list of place fields for the response. Fields are automatically prefixed with ‘places.’ if missing. Common fields: displayName, formattedAddress, id, types, rating, userRatingCount, location, businessStatus, regularOpeningHours, photos, reviews. Use ’*’ for all fields (not recommended for production). Valid field names include: displayName, formattedAddress, shortFormattedAddress, id, types, primaryType, primaryTypeDisplayName, location, viewport, plusCode, rating, userRatingCount, reviews, regularOpeningHours, currentOpeningHours, photos, websiteUri, googleMapsUri, businessStatus, priceLevel, priceRange, addressComponents, utcOffsetMinutes, internationalPhoneNumber, nationalPhoneNumber, editorialSummary, accessibilityOptions, parkingOptions, paymentOptions, delivery, dineIn, takeout, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, allowsDogs, outdoorSeating, liveMusic, goodForChildren, goodForGroups.
number
required
Longitude coordinate of the search center in decimal degrees.
array
List of place types to exclude from Table A. Results matching any of these types are omitted. Up to 50 types allowed. Must be provided as a list, e.g., [‘cafe’] for a single type or [‘cafe’, ‘store’] for multiple types. Must use valid Table A types only.
array
List of place types to include from Table A. Results will match at least one of these types. Up to 50 types allowed. Must be provided as a list, e.g., [‘restaurant’] for a single type or [‘atm’, ‘bank’] for multiple types. Common types: restaurant, cafe, bank, atm, hospital, pharmacy, school, park, gym, hotel, airport, gas_station. IMPORTANT: ‘food’ is NOT a valid type (it’s in Table B); use specific types like restaurant, cafe, bakery, fast_food_restaurant instead. Note: ‘locality’ is valid, but ‘city’, ‘town’, ‘sublocality’, ‘landmark’, and ‘point_of_interest’ are NOT valid for filtering.
integer
Maximum number of search results to return. Valid range: 1-20. The actual count may be lower based on available places.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PARSE_FILEDEPRECATED: Exports Google Workspace files (max 10MB) to a specified format using mime_type, or downloads other file types; use GOOGLEDRIVE_DOWNLOAD_FILE instead.

Input Parameters

string
required
The unique ID of the file stored in Google Drive that you want to export or download.
string ("application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.oasis.opendocument.text" | "application/rtf" | "application/pdf" | "text/plain" | "application/zip" | "application/epub+zip" | "text/markdown" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.oasis.opendocument.spreadsheet" | "text/csv" | "text/tab-separated-values" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.oasis.opendocument.presentation" | "image/jpeg" | "image/png" | "image/svg+xml" | "application/vnd.google-apps.script+json" | "video/mp4")
Target MIME type for exporting Google Workspace files only. Supported exports by source type: Google Docs -> DOCX, ODT, RTF, PDF, TXT, ZIP (HTML), EPUB, MD; Google Sheets -> XLSX, ODS, PDF, ZIP (HTML), CSV, TSV; Google Slides -> PPTX, ODP, PDF, TXT, JPG, PNG, SVG; Google Drawings -> PDF, JPG, PNG, SVG; Apps Script -> JSON. If omitted, a default format is used: Docs->PDF, Sheets->XLSX, Slides->PDF, Drawings->PDF. For non-Workspace files (PDFs, images, text files, etc.), this parameter is ignored and the file is downloaded in its native format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PATCH_CALENDARPartially updates (PATCHes) an existing Google Calendar, modifying only the fields provided. At least one of summary, description, location, or timezone must be provided. Empty strings for description or location clear them.

Input Parameters

string
New title for the calendar; cannot be an empty string when provided. At least one of summary, description, location, or timezone must be provided.
string
New geographic location of the calendar (e.g., ‘Paris, France’).
string
New IANA Time Zone Database name for the calendar (e.g., ‘Europe/Zurich’, ‘America/New_York’). Calendars duplicated via GOOGLECALENDAR_DUPLICATE_CALENDAR may default to UTC; set the correct timezone explicitly after duplication.
string
required
The unique identifier of the Google Calendar to update. Use ‘primary’ for the main calendar, or a calendar’s unique ID (typically in email format like ‘abc123@group.calendar.google.com’). IMPORTANT: This is NOT the calendar’s display name/title - use GOOGLECALENDAR_LIST_CALENDARS to find the ‘id’ field for a calendar.
string
New description for the calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PATCH_EVENTUpdate specified fields of an existing event in a Google Calendar using patch semantics (array fields like attendees are fully replaced if provided); ensure the calendar_id and event_id are valid and the user has write access to the calendar.

Input Parameters

object
Input model for event source.
string ("confirmed" | "tentative" | "cancelled")
Status of the event.
string
New title for the event.
string
Color ID for the event (1-11). Use GOOGLECALENDAR_COLORS_GET to retrieve available colors.
string
New end time (RFC3339 timestamp, e.g., ‘2024-07-01T11:00:00-07:00’). Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted. For all-day events, use YYYY-MM-DD format (exclusive end date). Optional when updating start_time - the original event duration will be preserved if end_time is not specified. Must be strictly after start_time; mismatched or mixed formats cause HTTP 400 timeRangeEmpty.
string
required
The unique technical identifier of the event to update. IMPORTANT: This is NOT the event title/name. Event IDs are opaque strings typically base32hex encoded (5-1024 characters using lowercase a-v and digits 0-9). For recurring event instances, the ID format is ‘baseEventId_YYYYMMDDTHHMMSSZ’ with an underscore separator (e.g., ‘abc123def456_20260115T100000Z’). To get an event ID, first use GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to search for events and retrieve their IDs. Use master event ID to update the entire recurring series; use instance ID to update only that occurrence — confirm scope before patching.
string
New geographic location (physical address or virtual meeting link).
integer
Sequence number as per iCalendar specification. Incremented on each event update.
string
IANA Time Zone Database name for start/end times (e.g., ‘America/Los_Angeles’). Interprets offset-less values and sets the display/recurrence zone; Z or numeric offsets still identify the instant. When provided without start_time or end_time, updates the display zone of an existing timed event while preserving its instants. All-day events do not have a time zone.
array
List of valid email addresses for attendees (e.g., ‘user@example.com’). Replaces existing attendees. Provide an empty list to remove all.
object
Input model for reminders.
array
RRULE, EXRULE, RDATE and EXDATE lines per RFC5545 for recurring events. Replaces existing recurrence rules if provided.
string
New start time (RFC3339 timestamp, e.g., ‘2024-07-01T10:00:00-07:00’). Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted. For all-day events, use YYYY-MM-DD format. When only start_time is provided without end_time, the event’s original duration is preserved automatically.
string ("default" | "public" | "private" | "confidential")
Visibility of the event.
array
File attachments (max 25). Each with ‘fileUrl’ (required) and optional ‘title’, ‘mimeType’. Requires supportsAttachments=true.
string
required
Identifier of the calendar. Use ‘primary’ for the primary calendar of the logged-in user. To find other calendar IDs, use the calendarList.list method. Must be provided in snake_case format.
string
New description for the event; can include HTML.
string ("all" | "externalOnly" | "none")
Whether to send update notifications to attendees. Uses default user behavior if unspecified. Set explicitly to avoid unintended notifications when removing attendees or making bulk updates.
string ("opaque" | "transparent")
Whether the event blocks time on the calendar. ‘opaque’ (default) blocks time, ‘transparent’ does not.
integer
Maximum attendees in response; does not affect invited count. If more, response includes organizer only. Must be positive.
string ("needsAction" | "declined" | "tentative" | "accepted")
RSVP response status for the authenticated user. Updates only the current user’s response status without affecting other attendees. Note: RSVP is only supported for regular calendar events (eventType=‘default’); attempting to RSVP to focusTime, outOfOffice, birthday, or workingLocation events will result in an error.
object
Input model for conference data.
boolean
Whether attendees may have been omitted from the event’s representation.
boolean
Whether attendees other than the organizer can modify the event (default: false).
boolean
Whether anyone can invite themselves to the event (default: false).
object
Input model for extended properties.
boolean
Client application supports event attachments. Set to True if so.
object
Input model for focus time properties.
integer
API client’s conference data support version. Set to 1 to manage conference details (e.g., Google Meet links); 0 (default) ignores conference data. Setting to 1 enables reading/preserving conference data but does not generate a new Meet link — use GOOGLECALENDAR_UPDATE_EVENT with create_meeting_room=true to create one.
boolean
Whether attendees other than the organizer can invite others (default: true).
object
Input model for out-of-office properties.
boolean
Whether attendees can see who the event’s attendees are (default: true).
object
Input model for working location properties.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PATCH_LABELPatches the specified user-created label. System labels (e.g., INBOX, SENT, SPAM) cannot be modified and will be rejected.

Input Parameters

string
required
The ID of the label to update.
string
The display name of the label. At least one of ‘name’, ‘messageListVisibility’, ‘labelListVisibility’, or ‘color’ must be provided. Must be non-empty, unique among user labels, and must not contain ,, /, or ..
object
The color to assign to the label. Color is only available for labels that have their type set to user. At least one of ‘name’, ‘messageListVisibility’, ‘labelListVisibility’, or ‘color’ must be provided. Must include both backgroundColor and textColor subfields; both values must come from Gmail’s predefined color palette — arbitrary hex values or omitting either field causes a 400 error.
string
required
The user’s email address. The special value me can be used to indicate the authenticated user.
string ("labelShow" | "labelShowIfUnread" | "labelHide")
The visibility of the label in the label list in the Gmail web interface. At least one of ‘name’, ‘messageListVisibility’, ‘labelListVisibility’, or ‘color’ must be provided.
string ("show" | "hide")
The visibility of messages with this label in the message list in the Gmail web interface. At least one of ‘name’, ‘messageListVisibility’, ‘labelListVisibility’, or ‘color’ must be provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PATCH_PERMISSIONTool to update a permission using patch semantics. Use when you need to modify specific fields of an existing permission without affecting other fields. Warning: Concurrent permissions operations on the same file are not supported; only the last update is applied.

Input Parameters

string ("owner" | "organizer" | "fileOrganizer" | "writer" | "reader")
Permission roles that can be granted in Google Drive.
string
required
The ID for the file or shared drive.
Whether the link is required for this permission. Set to true for ‘anyone with the link’ access (not publicly discoverable), or false for publicly discoverable access.
string
required
The ID for the permission. Use ‘anyone’ for public link permissions, or specific permission IDs for user/group/domain permissions. You can get permission IDs by calling GOOGLEDRIVE_LIST_PERMISSIONS.
string
The time at which this permission will expire (RFC 3339 date-time). Can only be set on user and group permissions. The date must be in the future and cannot be more than a year in the future.
array
Additional roles for this user. Only ‘commenter’ is currently allowed.
boolean
Whether to remove the expiration date. Set to true to make the permission permanent.
boolean
Whether changing a role to ‘owner’ downgrades the current owners to writers. Does nothing if the specified role is not ‘owner’. Required as an acknowledgement when transferring ownership.
boolean
Whether the requesting application supports both My Drives and shared drives.
boolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PATCH_PROPERTYTool to update a property on a file using PATCH semantics (v2 API). Use when you need to partially update custom key-value metadata attached to a Google Drive file.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string
The value of this property.
string ("1" | "2")
V1 error format values.
string
Selector specifying which fields to include in a partial response.
string
required
The ID of the file.
string
JSONP callback function name.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string ("PRIVATE" | "PUBLIC")
Property visibility values.
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
required
The key of the property to update.
string
OAuth access token.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PATCH_SEND_ASPatches a Gmail send-as alias, including its display name, reply-to address, signature, default status, or SMTP configuration. This tool declares support for service-account OAuth, not standard OAuth.

Input Parameters

string
The user’s email address or the special value ‘me’ to indicate the authenticated user.
object
Configuration for SMTP relay service.
string
An optional HTML signature that is included in messages composed with this alias in the Gmail web UI. This signature is added to new emails only.
boolean
Whether this address is selected as the default ‘From:’ address in situations such as composing a new message or sending a vacation auto-reply. Setting this to true will make other send-as addresses non-default. Only true can be written to this field.
string
A name that appears in the ‘From:’ header for mail sent using this alias. For custom ‘from’ addresses, when empty, Gmail will populate the ‘From:’ header with the name used for the primary address. If the admin has disabled name updates, requests to update this field for the primary login will silently fail.
string
required
The send-as alias email address to update. This is the email address that appears in the ‘From:’ header.
boolean
Whether Gmail should treat this address as an alias for the user’s primary email address. This setting only applies to custom ‘from’ aliases.
string
An optional email address that is included in a ‘Reply-To:’ header for mail sent using this alias. If empty, Gmail will not generate a ‘Reply-To:’ header.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PATCH_TASKPartially updates an existing task (identified by task_id) within a specific Google Task list (identified by tasklist_id), modifying only the provided attributes from TaskInput (e.g., title, notes, due date, status) and requiring both the task and list to exist.

Input Parameters

string
Unique identifier for the task. Generated by Google Tasks API when creating a task. Used for updating or deleting existing tasks.
string
Due date for the task (optional). NOTE: Google Tasks only stores the date portion (YYYY-MM-DD) - any time component provided will be automatically stripped before sending to the API. Accepts RFC3339 format (e.g., ‘2025-09-28T23:59:00Z’) or various human-readable formats like ‘28 Sep 2025’, ‘11:59 PM, 22 Sep 2025’. Normalized to midnight UTC — naive local dates without timezone offset may shift ±1 day. Time-based reminders are not supported via this field.
string
ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task. Auto-generated by the API.
string
Additional details or description for the task. Supports plain text only (no HTML/markdown). Maximum 8192 characters. Example: ‘Include Q3 sales data and projections’
string
Title/name of the task. This is the main text displayed for the task. Maximum 1024 characters. Example: ‘Complete quarterly report’
boolean
Whether the task is hidden from the default view. Hidden tasks can still be accessed via API but won’t show in UI. Default: false
string ("needsAction" | "completed")
Current status of the task. Must be either ‘needsAction’ (task is pending) or ‘completed’ (task is done).
boolean
Whether the task has been deleted. Deleted tasks are marked but not immediately removed, allowing for recovery. Default: false
string
required
Identifier of the Google Task to be updated within the specified task list.
string
Date/time when the task was marked as completed. Only applicable when status=‘completed’. Unlike ‘due’, this field preserves the time component. Accepts RFC3339 format or human-readable date formats. Malformed or non-RFC3339 values will be rejected.
string
required
Identifier of the Google Task list that contains the task to be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PATCH_TASK_LISTUpdates the title of an existing Google Tasks task list.

Input Parameters

string
required
The unique identifier of the task list to be updated.
string
The new title for the task list. Optional for PATCH semantics - only include if you want to update the title. Maximum length: 1024 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PLACE_PHOTORetrieves high quality photographic content from the Google Maps Places database. Use when you need to download a place photo using a photo_reference obtained from Place Details, Nearby Search, or Text Search requests. Images are scaled proportionally to fit within specified dimensions.

Input Parameters

integer
Maximum desired width of the image in pixels (1-1600). Image will be scaled proportionally. You must specify either maxwidth, maxheight, or both.
integer
Maximum desired height of the image in pixels (1-1600). Image will be scaled proportionally. You must specify either maxwidth, maxheight, or both.
string
required
A string identifier that uniquely identifies a photo. Can be either: (1) A full photo resource name in format ‘places/{place_id}/photos/{photo}’ from the new Places API, or (2) Just the photo reference string from legacy API. Obtained from Place Details, Nearby Search, or Text Search requests. Note: Photo references cannot be cached and may expire over time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PRESENTATIONS_BATCH_UPDATEUpdate a Google Slides presentation using markdown or raw API requests. Markdown supports themes and multiple slide types; images may be skipped when their URLs fail validation or Google cannot retrieve them.

Input Parameters

array
List of update requests, each a dict with one of these valid Slides API request types: Common requests: createSlide, createShape, createTable, createImage, insertText, updateTextStyle, updateShapeProperties, updatePageProperties, updateParagraphStyle, deleteObject, updateTableCellProperties, updateTableColumnProperties, replaceAllText IMPORTANT: To update slide backgrounds, use updatePageProperties (NOT updateSlideProperties). The field pageBackgroundFill exists in PageProperties, not SlideProperties. Required if markdown_text is not provided.
object
Options that control how write requests are executed.
string
Markdown content to add as new slides to an existing presentation. Separate slides with ‘\n---\n’. Each slide auto-detects its type from content. Slide types: title (’# Title\nSubtitle’), bullets (’-’/’+’/’*’), tables (markdown tables), quotes (’> text’), images (''), two-column (’|||’ separator), plain text. Add ‘Theme: <name>’ as the first line to apply a theme. Available themes: default, corporate_blue, modern_dark, professional_gray, creative_purple, warm_orange, forest_green, minimal_beige. Font sizes auto-scale based on content length (28pt down to 8pt). Supports bold, emoji, and auto-centering of tables. Images must be publicly accessible URLs (PNG/JPEG/GIF, <50MB).
string
required
The ID of the presentation to apply the updates to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PRESENTATIONS_COPY_FROM_TEMPLATETool to create a new Google Slides presentation by duplicating an existing template deck via Drive file copy. Use when you need to preserve themes, masters, and layouts exactly as they appear in the template. After copying, use GOOGLESLIDES_PRESENTATIONS_BATCH_UPDATE to replace placeholder text or images.

Input Parameters

string
The name/title for the copied presentation. If omitted, a default name like ‘Copy of [original]’ is used.
string
The ID of the destination folder in Google Drive. If provided, the copied presentation will be placed in this folder. If omitted, the copy is placed in the user’s root folder.
string
required
The Drive file ID of the Slides template to copy. This is the presentationId of the existing deck you want to duplicate.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PRESENTATIONS_GETRetrieve the latest version of a presentation by ID or exact name, selecting the first matching non-trashed presentation for a name. Returned slide and page-element information is limited to IDs and page types rather than full slide content.

Input Parameters

string
Comma-separated selector specifying which fields to include in a partial response. Nested fields use parentheses that must be properly balanced. Top-level fields: presentationId, title, locale, revisionId, pageSize, slides, masters, layouts, notesMaster. For slides/masters/layouts, valid Page fields: objectId, pageType, pageElements, pageProperties, revisionId. For pageElements, valid fields: objectId, size, transform, title, description, shape, image, video, line, table, wordArt, elementGroup, sheetsChart, speakerSpotlight. For shape, valid fields: shapeType, text, shapeProperties, placeholder. Note: ‘autofit’ is under shapeProperties, not directly under shape. Use shape(shapeProperties(autofit)), not shape(autofit). Examples: ‘presentationId,title’, ‘slides(objectId,pageElements(objectId,size))’, ‘slides(objectId,pageElements(objectId,shape(shapeType,text,shapeProperties(autofit))))’
string
The ID of the presentation to retrieve. Either presentation_id or presentation_name must be provided.
string
The name of the presentation to search for and retrieve. If provided, the action will search Google Drive for a presentation with this name. Either presentation_id or presentation_name must be provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PRESENTATIONS_PAGES_GETTool to get the latest version of a specific page in a presentation. Use when you need to inspect slide, layout, master, or notes page details.

Input Parameters

string
required
The object ID of the page to retrieve.
string
required
The ID of the presentation from which to fetch the page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PRESENTATIONS_PAGES_GET_THUMBNAILDEPRECATED: Use GOOGLESLIDES_GET_PAGE_THUMBNAIL2 instead. Tool to generate and return a thumbnail image URL for a specific page. Use when you need a quick preview of a slide page after loading it.

Input Parameters

string
required
The object ID of the page whose thumbnail to retrieve.
string
required
The ID of the presentation containing the page.
string
Optional thumbnail image MIME type. Currently only ‘PNG’ is supported by the API. Defaults to ‘PNG’ if omitted.
string ("THUMBNAIL_SIZE_UNSPECIFIED" | "LARGE" | "MEDIUM" | "SMALL")
Optional thumbnail size. One of ‘LARGE’, ‘MEDIUM’, ‘SMALL’, or ‘THUMBNAIL_SIZE_UNSPECIFIED’. Defaults to ‘LARGE’ if omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_PROVISION_ACCOUNT_TICKETTool to request a ticket for creating a Google Analytics account. Use when you need to initiate the account creation flow that requires user acceptance of Terms of Service.

Input Parameters

object
required
Required. Account details including display name and region code.
string
required
Required. Redirect URI where the user will be sent after accepting Terms of Service. Must be configured in Cloud Console as a Redirect URI.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_QUERY_AUDIENCE_EXPORTTool to query a completed audience export. Use when you need to fetch user rows with pagination.

Input Parameters

string
required
Required. Resource name of the audience export. Format: properties/{property}/audienceExports/{audienceExport}, where {property} and {audienceExport} must be integers.
integer
Optional. Number of rows to return. Must be between 1 and 250000. Defaults to 10000.
integer
Optional. Zero-based start row index for pagination. Defaults to 0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_QUERY_AUDIENCE_LISTTool to query an audience list. Use when you need to retrieve user rows from a GA4 audience list with pagination.

Input Parameters

string
required
Required. Audience list resource to query. Format: properties/{property}/audienceLists/{audienceList}.
integer
Optional. Number of rows to return; default 10,000; maximum 250,000.
integer
Optional. Zero-based row offset for pagination.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_QUERY_REPORT_TASKTool to retrieve a report task’s content. Use this after creating a report task with CreateReportTask and confirming it is in ACTIVE state. This method returns an error if the report task’s state is not ACTIVE.

Input Parameters

string
required
Required. Report task name in format ‘properties/{propertyId}/reportTasks/{reportTaskId}’. The report task must be in ACTIVE state.
integer
Optional. Number of rows to return (max 250,000). If unspecified, 10,000 rows are returned. Must be positive. Limited by the ReportTask’s own limit.
integer
Optional. Row offset for pagination (0-indexed). First request omits offset or sets to 0. For subsequent pages, set to the previous limit value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_QUERY_TABLEExecutes SQL-like SELECT queries against detected tables in a native Google spreadsheet, with filtering, sorting, and limits. Sheet names can refer to the first detected table; detection and query processing are heuristic, and results may omit rows. DEPRECATED: Use GOOGLESHEETS_VALUES_GET or GOOGLESHEETS_BATCH_GET for table reads, and GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW for row lookup or filtering.

Input Parameters

string
required
SQL SELECT query. The table name is the Google Sheets tab/sheet name (visible at the bottom of the spreadsheet). Use GOOGLESHEETS_LIST_TABLES to discover available table names if unknown. Supported: SELECT cols FROM table WHERE conditions ORDER BY col LIMIT n. Table names must be quoted with double quotes if they contain spaces or are numeric-only (e.g., SELECT * FROM “My Sheet” or SELECT * FROM “415”).
string
required
The unique identifier of a native Google Sheets file. Found in the spreadsheet URL after /d/ (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’). Only native Google Sheets files (MIME type: application/vnd.google-apps.spreadsheet) are supported. Files uploaded to Google Drive that are not native Google Sheets (such as Excel .xlsx files, PDFs, or Google Docs) will not work even if they can be viewed in Google Sheets.
boolean
Whether to return formula text instead of calculated values for formula columns

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_QUICK_ADDParses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring events, and calendar_id must be valid if not ‘primary’.

Input Parameters

string
required
Required natural language input describing the event. It must contain at least one non-whitespace character. Google Calendar parses it for event details like title, date, and time.
string
Identifier of the calendar for the event. Use ‘primary’ for the main calendar, or provide a specific calendar ID (e.g., email address).
string ("all" | "externalOnly" | "none")
Controls whether email notifications about the event creation are sent to attendees.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_READ_SPREADSHEET_VALUESRead values from one or more ranges in a Google spreadsheet.

Input Parameters

array
required
One or more A1 or R1C1 ranges to read. Results are returned in the same order.
string
required
The ID of the Google spreadsheet, found in its URL between ‘/d/’ and ‘/edit’.
string ("ROWS" | "COLUMNS")
Whether each inner values array represents a row or a column. Google defaults to ROWS.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How values are represented. Google defaults to FORMATTED_VALUE.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How dates, times, and durations are represented when values are not formatted. Google defaults to SERIAL_NUMBER.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_REMOVE_ALL_AUDIENCE_MEMBERSValidate or asynchronously remove all members of Data Manager audiences.

Input Parameters

array
required
Destinations from which to remove all audience members.
boolean
When true, validate without removing members; only errors are returned.
string
RFC 3339 timestamp, not in the future. Only members last added before this time are removed. Omit to use the current time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_REMOVE_ATTENDEERemoves an attendee from a specified event in a Google Calendar; the calendar and event must exist. Concurrent calls on the same event can overwrite attendee lists — apply changes sequentially per event.

Input Parameters

string
required
Unique identifier of the event. For recurring events, target the master series ID or a specific instance ID; removing an attendee from one instance does not affect other instances in the series.
string
Identifier of the Google Calendar to which the event belongs; ‘primary’ signifies the user’s main calendar.
string
required
Email address of the attendee to remove. Must match an attendee email present on the event. If no match is found, the attendee was already removed or was never on the event.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_REMOVE_AUDIENCE_MEMBERSRemove specific users from Data Manager audience destinations. Set validate_only=true to validate without removing users. Execution is asynchronous: a request ID indicates acceptance, not completion. Query its status for errors and partial failures.

Input Parameters

string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")
Required for user data; outer encoding if encrypted. Ignored for other data types.
array
required
Destinations from which to remove users.
boolean
True validates without removal; only errors, not results, are returned. Omitted/false executes removal.
object
User-data encryption details; omit for hashed but unencrypted identifiers.
array
required
Audience members to remove; does not remove the list itself.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_REMOVE_LABELPermanently deletes an existing user-created Gmail label by ID and removes it from messages and threads where it is applied. This action is deprecated.

Input Parameters

string
User’s email address or ‘me’ for the authenticated user.
string
required
ID of the user-created label to be permanently deleted; must exist and not be a system label.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_REMOVE_USERSRemove users identified by hashed user data from Data Manager destinations. Available only to allowlisted accounts; takes user_data, not audience_members or mobile IDs. Set validate_only=true to validate without removal. A request ID indicates asynchronous acceptance, not completion; query request status for processing errors and partial failures.

Input Parameters

string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")
required
Required encoding of user identifiers; for encrypted identifiers, the outer encoding.
array
required
UserData keys identifying users to remove; not AudienceMember objects or mobile IDs.
array
required
Destinations from which the identified users are removed.
boolean
True validates without execution; omitted or false submits asynchronous removal.
object
Encryption key information; omit for unencrypted hashed identifiers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_RENDER_AERIAL_VIDEOStarts rendering an aerial view video for a US postal address. Returns a video ID that can be used with lookupVideo to retrieve the video once rendering completes. Rendering typically takes up to a few hours.

Input Parameters

string
required
US postal address for which to render aerial video. Must be a valid US address with street, city, state, and postal code.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_REPLACE_ALL_TEXTReplaces occurrences of text in a Google Document, either across the document or in selected tabs. Supports case-sensitive matching and regular expressions.

Input Parameters

array
Optional. A list of specific tab IDs to perform the replacement on. If not provided, replacement occurs on all tabs.
string
required
The text to search for in the document. Cannot be empty.
boolean
Indicates whether the search should be case sensitive. Defaults to False (case insensitive).
string
required
The ID of the document to update.
string
required
The text that will replace the matched text.
boolean
Optional. If True, the find_text is treated as a regular expression. Defaults to False.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_REPLACE_IMAGETool to replace a specific image in a document with a new image from a URI. Use when you need to update an existing image within a Google Doc.

Input Parameters

string
required
The ID of the document containing the image to replace.
object
required
The details of the image replacement request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_REPLY_TO_THREADSends a reply to a Gmail thread using its original subject and quoting the last returned message. Requires a thread ID and at least one recipient, and supports optional file attachments.

Input Parameters

array
Carbon Copy (CC) recipients’ email addresses in format ‘user@domain.com’. Each address must include both username and domain separated by ’@’. At least one of cc, bcc, or recipient_email must be provided.
array
Blind Carbon Copy (BCC) recipients’ email addresses in format ‘user@domain.com’. Each address must include both username and domain separated by ’@’. At least one of cc, bcc, or recipient_email must be provided.
boolean
Indicates if message_body is HTML; if True, body must be valid HTML, if False, body should not contain HTML tags. Mismatch causes recipients to see raw HTML tags as plain text.
string
Identifier for the user sending the reply; ‘me’ refers to the authenticated user.
string
required
Identifier of the Gmail thread for the reply. Must be a valid hexadecimal string, typically 15-16 characters long (e.g., ‘169eefc8138e68ca’). Prefixes like ‘msg-f:’ or ‘thread-f:’ are automatically stripped. Note: Format validation only checks the ID structure; the thread must also exist and be accessible in your Gmail account. Use GMAIL_LIST_THREADS or GMAIL_FETCH_EMAILS to retrieve valid thread IDs. Must be a threadId, not a messageId; passing a messageId can cause the reply to fail or start an unintended new thread.
string
File(s) to attach to the reply. Accepts a single file or a list of files. Total message size including attachments must stay under 25 MB (400 badRequest if exceeded); use Drive links for large files.
string
Content of the reply message, either plain text or HTML.
string
Primary recipient’s email address in format ‘user@domain.com’. Must include both username and domain separated by ’@’. Required if cc and bcc is not provided, else can be optional. Use extra_recipients if you want to send to multiple recipients.
array
Additional ‘To’ recipients’ email addresses in format ‘user@domain.com’ (not Cc or Bcc). Each address must include both username and domain separated by ’@’. Should only be used if recipient_email is also provided.
boolean
Append the sender’s Gmail signature (the ‘Send mail as’ signature configured in Gmail settings) to the message body, ahead of any quoted or forwarded content. Skipped when the body already ends with that signature, when no signature is configured, or when the connection lacks permission to read Gmail settings. Set to false to send the body exactly as provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_RESUMABLE_UPLOADUpload a file to Google Drive using a resumable session, creating a new file or updating an existing file by ID. The upload is sent in chunks.

Input Parameters

string
Optional file ID if updating an existing file instead of creating a new one.
object
JSON metadata for the Drive File resource (e.g., {‘name’: ‘photo.jpg’, ‘parents’: [‘folderId’]}). To convert to a Google Docs MIME type, set metadata.mimeType to the target Docs type but send the real file MIME type as the upload content type — using the Docs MIME type as upload content type causes invalidContentType errors.
integer
Chunk size in bytes; must be a multiple of 256 KB.
object
Optional Drive query parameters.
object
required
File to upload to Google Drive via resumable upload.
string
Optional folder ID where NEW files should be uploaded. Only used during file creation, not updates. Will be added to metadata.parents. Must reference a valid, non-trashed folder ID; invalid or trashed IDs silently place files at root.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_RUN_FUNNEL_REPORTTool to run a GA4 funnel report. Use when you need a customized funnel analysis report for a given property. Funnel step sequence is determined by step attributes in the response, not row order.

Input Parameters

integer
Number of rows to return. Default 10000; max 250000.
object
required
Funnel configuration object. Must include a ‘steps’ key with at least one step. Each step requires a ‘name’ and optionally a ‘filterExpression’. Use ‘funnelEventFilter’ for event filters and ‘funnelFieldFilter’ for field filters. Filter expressions with ‘fieldName’ + ‘stringFilter’ are auto-wrapped in ‘funnelFieldFilter’. Example: {“steps”: [{“name”: “First visit”, “filterExpression”: {“funnelEventFilter”: {“eventName”: “first_visit”}}}]}
string
required
GA4 property resource name, format: properties/{property_id}.
array
Up to 4 segments; each yields its own row in the report.
array
List of date ranges to read; overlapping ranges duplicate days across ranges.
object
Dimension-only filter expression.
object
Breakdown dimension configuration for the funnel table sub-report. The ‘breakdownDimension’ is a GA4 Dimension object whose field is ‘name’ (NOT ‘dimensionName’). Example: {“breakdownDimension”: {“name”: “deviceCategory”}, “limit”: “5”}.
object
Next-action dimension configuration for the funnel visualization sub-report. The ‘nextActionDimension’ is a GA4 Dimension object whose field is ‘name’ (NOT ‘dimensionName’). Example: {“nextActionDimension”: {“name”: “eventName”}, “limit”: “5”}.
boolean
If true, includes the property’s current quota state.
string ("STANDARD_FUNNEL" | "TRENDED_FUNNEL")
Visualization type: STANDARD_FUNNEL (default) or TRENDED_FUNNEL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_RUN_PIVOT_REPORTTool to run a customized pivot report of Google Analytics event data. Use when you need a pivot table view with advanced segmentation and multi-dimensional analysis of GA4 data.

Input Parameters

array
Optional. Visual format configuration for dimensions. Each pivot has ‘fieldNames’ (required string array), ‘limit’ (required), optional ‘orderBys’, ‘offset’, and ‘metricAggregations’.
array
required
Required. At least one metric is required. Each metric has a ‘name’ field, optional ‘expression’, and optional ‘invisible’ boolean.
string
required
Required. The GA4 property resource name. Format: properties/{property_id}
object
Optional. Cohort configuration with ‘cohorts’ (required), optional ‘cohortsRange’ and ‘cohortReportSettings’.
array
Optional. Date ranges for event data retrieval. Each range has ‘startDate’ and ‘endDate’ (YYYY-MM-DD format or relative like ‘NdaysAgo’, ‘yesterday’, ‘today’), and optional ‘name’.
array
Optional. Dimensions to request. Each dimension has a ‘name’ field and optional ‘dimensionExpression’. Dimensions must be used in pivots, filters, or orderBys.
array
Optional. Comparison configurations. Each comparison has optional ‘name’ and required ‘dimensionFilter’ or ‘comparison’.
string
Optional. ISO4217 currency code (e.g., ‘USD’, ‘EUR’).
object
Optional. Post-aggregation filter (SQL HAVING clause equivalent).
boolean
Optional. If true, includes rows where all metrics equal 0.
object
Optional. Filter clause for dimensions only. Can use andGroup, orGroup, notExpression, or filter.
boolean
Optional. If true, returns current quota state in PropertyQuota.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_RUN_REALTIME_REPORTTool to run a customized realtime report of Google Analytics event data. Use when you need realtime data (last 30-60 minutes) with dimensions and metrics for a GA4 property.

Input Parameters

integer
Max rows to return (default 10000, max 250000).
array
Metrics to measure (max 10). At least one dimension or metric is required. Valid names: activeUsers, eventCount, keyEvents, screenPageViews.
array
Sorting specification. Example: [{‘metric’: {‘metricName’: ‘activeUsers’}, ‘desc’: true}] or [{‘dimension’: {‘dimensionName’: ‘country’}}].
string
required
Required. The GA4 property resource name. Format: properties/{property_id}. Get property IDs from GOOGLE_ANALYTICS_LIST_PROPERTIES.
array
Dimensions to group by (max 9). At least one dimension or metric is required. Valid names: appVersion, audienceId, audienceName, city, cityId, country, countryId, deviceCategory, eventName, minutesAgo, platform, streamId, streamName, unifiedScreenName. Custom: ‘customUser:param_name’.
object
Post-aggregation filter on metric values. Applied after row aggregation.
array
Time ranges to report on. Default is last 30 minutes. Each range has startMinutesAgo (default 29) and endMinutesAgo (default 0).
object
Filter to restrict data by dimension values. Structure: {‘filter’: {‘fieldName’: ‘country’, ‘stringFilter’: {‘value’: ‘United States’}}} or use andGroup/orGroup/notExpression for complex filters.
array
Request aggregated metric values. Values: ‘TOTAL’, ‘MINIMUM’, ‘MAXIMUM’, ‘COUNT’.
boolean
If true, includes API quota usage info in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_RUN_REPORTRun a customized GA4 event-data report for a property using dimensions, metrics, filters and date ranges or a cohort specification. Requests can include up to 9 dimensions and 10 metrics, with offset and limit for pagination. Dimensions, metrics and filters must be compatible; use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY to check combinations. The invalid dateRange dimension is removed from requests; use a date dimension for date-based grouping.

Input Parameters

integer
Optional. Number of rows to return. Must be between 1 and 250000.
integer
Optional. 0-based start row for pagination. Must be >= 0.
array
Optional. The metrics to request and display. Maximum 10 metrics per request. Each metric MUST be an object with a required non-empty ‘name’ field. Common valid metric names: activeUsers, totalUsers, newUsers, sessions, engagedSessions, screenPageViews, eventCount, conversions, userEngagementDuration, engagementRate, bounceRate, averageSessionDuration, sessionsPerUser, screenPageViewsPerSession, purchaseRevenue, totalRevenue, transactions, ecommercePurchases, publisherAdClicks, publisherAdImpressions, totalAdRevenue. Custom metrics use format ‘customEvent:parameter_name’. CRITICAL: ‘averageEngagementTime’ is NOT a valid metric - use ‘userEngagementDuration’ or ‘averageSessionDuration’ instead. ‘exits’ is NOT a valid metric in GA4.
array
Optional. Specify how rows are ordered. Each OrderBy object must have ‘desc’ (boolean) at the top level and exactly one of: ‘metric’ (with ‘metricName’ string), ‘dimension’ (with ‘dimensionName’ or ‘name’ string and optional ‘orderType’: ‘ALPHANUMERIC’, ‘CASE_INSENSITIVE_ALPHANUMERIC’, or ‘NUMERIC’), or ‘pivot’. Note: For dimension ordering, you can use either ‘dimensionName’ or ‘name’ field - both are accepted and normalized. Example for metric ordering: {‘desc’: true, ‘metric’: {‘metricName’: ‘activeUsers’}}. Example for dimension ordering: {‘desc’: false, ‘dimension’: {‘dimensionName’: ‘country’, ‘orderType’: ‘ALPHANUMERIC’}}.
string
required
Required. The property resource on which to run the report. Format: properties/{property_id} where property_id must be a numeric ID (e.g., ‘properties/123456789’).
object
Optional. Cohort specification. Requires requesting the cohort dimension.
array
The date ranges to read. Required for standard reports. Each range MUST be an object with required ‘startDate’ and ‘endDate’ fields (both must be non-empty). Dates can be in YYYY-MM-DD format or special values like ‘today’, ‘yesterday’, ‘7daysAgo’, ‘30daysAgo’. IMPORTANT: For cohort requests (when cohortSpec is provided), dateRanges must be omitted.
array
Optional. The dimensions to request and display. Maximum 9 dimensions per request. Each dimension MUST be an object with a required non-empty ‘name’ field. Common valid dimension names: date, dateHour, dateHourMinute, year, month, week, day, dayOfWeek, hour, city, cityId, country, countryId, continent, continentId, region, subContinent, deviceCategory, browser, operatingSystem, platform, platformDeviceCategory, screenResolution, sessionSource, sessionMedium, sessionSourceMedium, sessionCampaignName, sessionDefaultChannelGroup, firstUserSource, firstUserMedium, firstUserCampaignName, firstUserDefaultChannelGroup, pagePath, pagePathPlusQueryString, pageTitle, landingPage, hostname, eventName, streamName, userAgeBracket, userGender, language, newVsReturning. Custom dimensions: ‘customEvent:parameter_name’ or ‘customUser:parameter_name’. ‘dateRange’ is NOT a valid dimension — use date dimensions (date, dateHour, year, month, etc.) instead. ‘exits’ is NOT a valid dimension in GA4. COMPATIBILITY: Not all dimensions can be combined with each other or with certain metrics/filters. If you receive a compatibility error, use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY to validate combinations, or see https://developers.google.com/analytics/devguides/reporting/data/v1/compatibility
array
Optional. The comparison configuration. Adds a comparison column to the response.
string
Optional. The currency code to apply, in ISO 4217 format. Defaults to property currency.
object
Optional. Filter expression to restrict rows by metric values. Applied after aggregation. IMPORTANT: Only use metric field names here (e.g., ‘activeUsers’, ‘sessions’, ‘ecommercePurchases’, ‘purchaseRevenue’). Do NOT use dimension names in metricFilter - if you need to filter by a dimension (e.g., ‘country’, ‘city’, ‘pagePath’), use dimensionFilter instead. The action validates that only metric names are used in metricFilter and will reject dimension names with a clear error. Structure: {‘filter’: {‘fieldName’: ‘<metric_name>’, ‘numericFilter’: {‘operation’: ‘GREATER_THAN’, ‘value’: {‘int64Value’: ‘0’}}}} or use ‘andGroup’/‘orGroup’ for multiple conditions.
boolean
Optional. If true, rows with all zero metrics will be returned; otherwise omitted.
object
Optional. Filter expression to restrict rows by dimension values. IMPORTANT: Only use dimension field names here (e.g., ‘country’, ‘city’, ‘date’, ‘deviceCategory’, ‘pagePath’). Do NOT use metric names in dimensionFilter - if you need to filter by a metric (e.g., ‘activeUsers’, ‘sessions’, ‘ecommercePurchases’), use metricFilter instead. Structure: {‘filter’: {‘fieldName’: ‘<dimension_name>’, ‘stringFilter’: {…}}} or use ‘andGroup’/‘orGroup’ for multiple conditions. COMPATIBILITY WARNING: Dimension filters must be compatible with the dimensions in your request. For example, filtering on ‘sessionCampaignName’ while using demographic dimensions (userAgeBracket, userGender) will fail. The filter field creates an implicit dimension that must be compatible with all other dimensions and metrics. Use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY to verify your filter dimensions work with your requested dimensions/metrics.
array
Optional. Aggregation types to include over metrics, e.g., ‘TOTAL’, ‘MINIMUM’, ‘MAXIMUM’.
boolean
Optional. If true, include the property’s current quota state in the response.
array
Internal field to store filtered dimension names for execution message. Not sent to API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SCHEDULE_EXPERIMENTSchedule a Google Ads experiment and return its long-running operation. This materializes the treatment campaign and can begin serving and spending on its start date; the experiment cannot return to SETUP after scheduling. When validate_only is true, Google validates the request and returns no operation.

Input Parameters

string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
string
required
Experiment resource name: customers/{customer_id}/experiments/{experiment_id}.
boolean
Validate scheduling without materializing the experiment campaign.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEARCH_DEVELOPER_METADATATool to search for developer metadata in a spreadsheet. Use when you need to find specific metadata entries based on filters.

Input Parameters

array
required
The data filters describing the criteria used to determine which DeveloperMetadata entries to return.
string
required
The ID of the spreadsheet to retrieve metadata from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEARCH_DOCUMENTSSearch for Google Documents using various filters including name, content, date ranges, and more.

Input Parameters

string
Search query to filter documents. Provide either: (1) Plain text to search in document content (e.g., ‘quarterly report’), which will search fullText, or (2) Drive API query syntax with operators like ‘name contains’, ‘fullText contains’, combined with ‘and’, ‘or’, ‘not’. Leave empty to get all documents.
string
Order results by field. Common options: ‘modifiedTime desc’, ‘modifiedTime asc’, ‘name’, ‘createdTime desc’
string
Token for continuing a previous search request on the next page. Use the next_page_token from the previous response to retrieve additional results.
integer
Maximum number of documents to return per page (1-100). Defaults to 10. Use page_token for pagination when more results are available.
boolean
Whether to return only starred documents. Defaults to False.
string
Return documents created after this date. Use RFC 3339 format like ‘2024-01-01T00:00:00Z’.
string
Return documents modified after this date. Use RFC 3339 format like ‘2024-01-01T00:00:00Z’.
boolean
Whether to return only documents shared with the current user. Defaults to False.
boolean
Whether to include documents in trash. Defaults to False.
string ("minimal" | "full")
Level of detail in the response. ‘minimal’ returns only essential fields (id, name, modifiedTime, webViewLink) for efficient token usage. ‘full’ returns comprehensive metadata including permissions, owners, timestamps, and other detailed information.
boolean
Whether to include documents from shared drives you have access to. Defaults to True.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEARCH_GAQLRun one page of a GAQL search and return its continuation token.

Input Parameters

string
required
The Google Ads Query Language (GAQL) query to run.
string
Token from next_page_token in the preceding search response.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validate the query without executing it.
object
Optional controls for result counts, summary rows, and rows.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEARCH_GOOGLE_ADS_FIELDSSearch the Google Ads v26 field metadata catalog with GAQL.

Input Parameters

string
required
GAQL metadata query selecting Google Ads field attributes. For example, SELECT name, category, data_type, selectable WHERE name LIKE ‘campaign.%’.
integer
Maximum field definitions to request in this page. Google may return fewer results than requested.
string
Token returned as next_page_token by the previous page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEARCH_MEDIA_ITEMSSearches for app-created media items in a user’s Google Photos library.

Input Parameters

string
Album to search within
object
Search filters
string
Sort order for results, e.g. ‘MediaMetadata.creation_time desc’
integer
Maximum number of items to return. Default 25, maximum 100.
string
Token for getting the next page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEARCH_PEOPLESearches saved contacts and optionally Other Contacts by query, returning matching person records. When both sources are requested, results may be partial if one search fails.

Input Parameters

string
required
Matches contact names, nicknames, email addresses, phone numbers, and organization fields.
integer
Maximum results to return; values >30 are capped to 30 by the API.
string
Comma-separated fields to return (e.g., ‘names,emailAddresses’). When ‘other_contacts’ is true, only ‘emailAddresses’, ‘metadata’, ‘names’, ‘phoneNumbers’ are allowed. For full field access including ‘organizations’, set ‘other_contacts’ to false.
boolean
When True, searches both saved contacts and ‘Other Contacts’ (people you’ve interacted with but not explicitly saved). Note: This restricts person_fields to only ‘emailAddresses’, ‘metadata’, ‘names’, ‘phoneNumbers’. When False, searches only saved contacts but allows all person_fields including ‘organizations’, ‘addresses’, etc.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEARCH_SPREADSHEETSSearch for Google spreadsheets accessible in Drive by name, content, dates, and other filters, including starred and shared-with-me status. Results are paginated, with up to 1,000 items per page; shared drives are included by default and searches across them may be incomplete.

Input Parameters

string
Search query to filter spreadsheets. Behavior depends on the ‘search_type’ parameter. For advanced searches, use Google Drive query syntax with fields like ‘name contains’, ‘fullText contains’, or boolean filters like ‘sharedWithMe = true’. DO NOT use spreadsheet IDs as search terms. Leave empty to get all spreadsheets.
string
Sort order (comma-separated list for multi-field sorting). Valid fields: createdTime, folder, modifiedByMeTime, modifiedTime, name, name_natural, quotaBytesUsed, recency, sharedWithMeTime, starred, viewedByMeTime. Append ’ desc’ for descending order (default is ascending). Examples: ‘modifiedTime desc’, ‘folder,name’, ‘starred,modifiedTime desc’.
string
Token for retrieving the next page of results. Use the ‘next_page_token’ value from a previous response to get subsequent pages. Leave empty to get the first page.
integer
Maximum number of spreadsheets to return (1-1000). Defaults to 10.
string ("name" | "content" | "both")
How to search: ‘name’ searches filenames only (prefix matching from the START of filenames), ‘content’ uses fullText search which searches file content, name, description, and metadata (Google Drive API limitation: cannot search content exclusively without also matching filenames), ‘both’ explicitly searches both name OR content with an OR condition. Note: ‘name’ search only matches from the START of filenames (e.g., ‘Budget’ finds ‘Budget 2024’ but NOT ‘Q1 Budget’).
boolean
Whether to return only starred spreadsheets. Defaults to False.
string
Return spreadsheets created after this date. Use RFC 3339 format like ‘2024-01-01T00:00:00Z’.
string
Return spreadsheets modified after this date. Use RFC 3339 format like ‘2024-01-01T00:00:00Z’.
boolean
Whether to return only spreadsheets shared with the current user. Defaults to False.
boolean
Whether to include spreadsheets in trash. Defaults to False.
boolean
Whether to include spreadsheets from shared drives you have access to. Defaults to True.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEARCH_STREAM_GAQLExecute a Google Ads Query Language (GAQL) query and aggregate every streamed response batch in order. For very large reports, select only needed fields and use WHERE and LIMIT because action responses are returned inline and are not automatically offloaded.

Input Parameters

string
required
The Google Ads Query Language (GAQL) query string. Must follow SELECT … FROM … WHERE … format. Example: SELECT campaign.name, campaign.id, metrics.impressions FROM campaign WHERE campaign.status = ‘ENABLED’
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
string ("UNSPECIFIED" | "NO_SUMMARY_ROW" | "SUMMARY_ROW_ONLY" | "SUMMARY_ROW_WITH_RESULTS")
Whether to include a summary row with aggregated metrics. Valid values are ‘UNSPECIFIED’, ‘NO_SUMMARY_ROW’, ‘SUMMARY_ROW_ONLY’, and ‘SUMMARY_ROW_WITH_RESULTS’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEND_DRAFTSends an existing Gmail draft immediately to the recipients already in its To, Cc, and Bcc headers. The draft’s recipients and content cannot be changed by this action; confirm them before sending.

Input Parameters

string
The user’s email address. The special value me can be used to indicate the authenticated user.
string
required
The ID of the draft to send. Draft IDs are typically alphanumeric strings (e.g., ‘r99885592323229922’). Important: Do not confuse draft_id with message_id - they are different identifiers. Use GMAIL_LIST_DRAFTS to retrieve valid draft IDs, or GMAIL_CREATE_EMAIL_DRAFT to create a new draft and get its ID. IMPORTANT: The draft MUST already have recipients (To, Cc, or Bcc) set - this action cannot add or override recipients. If the draft has no recipients, first create a new draft with recipients using GMAIL_CREATE_EMAIL_DRAFT, or use GMAIL_SEND_EMAIL to send a new email directly.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEND_EMAILSends an email immediately through Gmail to specified To, Cc, or Bcc recipients, with a subject or body and optional attachments. Supports plain text or HTML and may append the configured Gmail signature; attachments are limited to 20 MiB in total before encoding.

Input Parameters

array
Carbon Copy (CC) recipients’ email addresses. At least one of ‘to’/‘recipient_email’, ‘cc’, or ‘bcc’ must be provided.
array
Blind Carbon Copy (BCC) recipients’ email addresses. At least one of ‘to’/‘recipient_email’, ‘cc’, or ‘bcc’ must be provided.
string
Email content (plain text or HTML). Either subject or body must be provided for the email to be sent. If HTML, is_html must be True.
boolean
Set to True if the email body contains HTML tags.
string
Subject line of the email. Either subject or body must be provided for the email to be sent.
string
User’s email address; the literal ‘me’ refers to the authenticated user.
string
File(s) to attach. Accepts a single file or a list of files. IMPORTANT: mimetype MUST contain a ’/’ separator - single words like ‘pdf’ or ‘new’ are invalid. Gmail API limits: total message size must not exceed ~25 MB after base64 encoding. Omit or set to null for no attachment. Empty attachment objects (with all fields empty/whitespace) are treated as no attachment.
string
Sender email address for the ‘From’ header. Provide the connected account’s primary email address or a verified alias configured in Gmail’s ‘Send mail as’ settings. When omitted, the action attempts to resolve the primary email address from the authenticated Gmail profile.
string
Primary recipient’s email address. You can also use ‘to’ as an alias for this parameter. At least one of ‘to’/‘recipient_email’, ‘cc’, or ‘bcc’ must be provided. Use extra_recipients if you want to send to multiple recipients. Use the special value ‘me’ to send to your own authenticated email address. Must be a full user@domain address; ‘me’ is not valid here and will fail.
array
Additional ‘To’ recipients’ email addresses (not Cc or Bcc). Should only be used if recipient_email is also provided.
boolean
Append the sender’s Gmail signature (the ‘Send mail as’ signature configured in Gmail settings) to the message body, ahead of any quoted or forwarded content. Skipped when the body already ends with that signature, when no signature is configured, or when the connection lacks permission to read Gmail settings. Set to false to send the body exactly as provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SEND_EVENTSSend GA4 web-stream events using the Measurement Protocol and an API secret. A successful response indicates HTTP receipt, not that Google Analytics processed the events.

Input Parameters

array
required
Required. Array of event objects to send. Maximum 25 events per request. Each event must have a ‘name’ and can optionally include ‘params’.
Consent settings for Google Analytics 4.
string
Optional. A unique identifier for a logged-in user. This should be a non-PII identifier that you use internally to identify a user. Maximum 256 characters.
string
required
Required. A unique identifier for a user/client. This should be a UUID or similar unique string that identifies a specific user across sessions. Maximum 256 characters.
string
required
Required. The API secret generated in the Google Analytics UI under Admin > Data Streams > Measurement Protocol API secrets. Used to authenticate requests.
string
required
Required. The measurement ID for the web stream in the format G-XXXXXXX. This is found in the Google Analytics UI under Admin > Data Streams > Web Stream Details.
object
Optional. User properties to set for this measurement. Each property must have a ‘value’ field. User properties persist across events.
integer
Optional. Unix timestamp in microseconds for when the event occurred. If not provided, the current time is used. Can be up to 72 hours in the past.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SET_BASIC_FILTERTool to set a basic filter on a sheet in a Google Spreadsheet. Use when you need to filter or sort data within a specific range on a sheet.

Input Parameters

object
required
The filter to set.
string
required
The ID of the spreadsheet.
array
Limits the ranges included in the response spreadsheet. Meaningful only if includeSpreadsheetInResponse is true.
boolean
True if grid data should be returned. Meaningful only if includeSpreadsheetInResponse is true. Ignored if a field mask was set in the request.
boolean
Determines if the updated spreadsheet resource appears in the response. Default is false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SET_DATA_VALIDATION_RULETool to set or clear data validation rules (including dropdowns) on a range in Google Sheets. Use when you need to apply dropdown lists, range-based dropdowns, or custom formula validation to cells.

Input Parameters

string ("SET" | "CLEAR")
required
Operation mode: ‘SET’ applies a validation rule to the range, ‘CLEAR’ removes any existing validation from the range.
boolean
Whether to reject invalid data (true) or show a warning (false). Default is true.
array
List of allowed values for dropdown. Required when validation_type=‘ONE_OF_LIST’. Each item becomes a dropdown option.
string
Custom formula for validation. Required when validation_type=‘CUSTOM_FORMULA’. Formula should evaluate to TRUE/FALSE. Example: ‘=A1>10’.
integer
required
The unique sheet ID (numeric identifier) where the validation rule will be applied. The first sheet created in a spreadsheet typically has ID 0, while additional sheets get unique IDs (e.g., 1534097477). If a sheet is deleted, its ID is never reused - so if the original first sheet (ID 0) was deleted, attempting to use 0 will fail. Always verify the actual sheet ID exists using GOOGLESHEETS_GET_SPREADSHEET_INFO action (check ‘sheets[].properties.sheetId’ field).
integer
required
Ending row index (0-based, exclusive) for the validation range. To apply to row 1 only, use start_row_index=0 and end_row_index=1.
string
Optional message shown to the user when they select the cell. Helpful hint about what values are expected.
boolean
Whether to show a dropdown UI for list-based validation. Default is true. Set to true for dropdown lists.
string
required
The unique identifier of the Google Sheets spreadsheet. Can be found in the spreadsheet URL between ‘/d/’ and ‘/edit’.
string
Source range in A1 notation for dropdown values. Required when validation_type=‘ONE_OF_RANGE’. Example: ‘Sheet1!A1:A10’ or ‘A1:A10’.
integer
required
Starting row index (0-based, inclusive) for the validation range. Row 1 is index 0.
string ("ONE_OF_LIST" | "ONE_OF_RANGE" | "CUSTOM_FORMULA" | "NUMBER_GREATER" | "NUMBER_GREATER_THAN_EQ" | "NUMBER_LESS" | "NUMBER_LESS_THAN_EQ" | "NUMBER_EQ" | "NUMBER_NOT_EQ" | "NUMBER_BETWEEN" | "NUMBER_NOT_BETWEEN" | "TEXT_CONTAINS" | "TEXT_NOT_CONTAINS" | "TEXT_EQ" | "TEXT_NOT_EQ" | "TEXT_IS_EMAIL" | "TEXT_IS_URL" | "DATE_EQ" | "DATE_BEFORE" | "DATE_AFTER" | "DATE_ON_OR_BEFORE" | "DATE_ON_OR_AFTER" | "DATE_BETWEEN" | "DATE_NOT_BETWEEN" | "DATE_NOT_EQ" | "DATE_IS_VALID" | "BLANK" | "NOT_BLANK" | "BOOLEAN")
Type of validation rule to apply. Required when mode=‘SET’. Dropdown types: ‘ONE_OF_LIST’ (dropdown from list), ‘ONE_OF_RANGE’ (dropdown from range). Number validations: ‘NUMBER_GREATER’, ‘NUMBER_GREATER_THAN_EQ’, ‘NUMBER_LESS’, ‘NUMBER_LESS_THAN_EQ’, ‘NUMBER_EQ’, ‘NUMBER_NOT_EQ’, ‘NUMBER_BETWEEN’, ‘NUMBER_NOT_BETWEEN’. Text validations: ‘TEXT_CONTAINS’, ‘TEXT_NOT_CONTAINS’, ‘TEXT_EQ’, ‘TEXT_NOT_EQ’, ‘TEXT_IS_EMAIL’, ‘TEXT_IS_URL’ (Note: TEXT_STARTS_WITH and TEXT_ENDS_WITH are only for conditional formatting, not data validation). Date validations: ‘DATE_EQ’, ‘DATE_BEFORE’, ‘DATE_AFTER’, ‘DATE_ON_OR_BEFORE’, ‘DATE_ON_OR_AFTER’, ‘DATE_BETWEEN’, ‘DATE_NOT_BETWEEN’, ‘DATE_NOT_EQ’, ‘DATE_IS_VALID’. Other: ‘BLANK’, ‘NOT_BLANK’, ‘BOOLEAN’, ‘CUSTOM_FORMULA’.
array
Generic list of condition values for validation types that require specific values (e.g., NUMBER_GREATER requires one value, NUMBER_BETWEEN requires two values, TEXT_CONTAINS requires one value). For simple validations like TEXT_IS_EMAIL, BLANK, NOT_BLANK, BOOLEAN, DATE_IS_VALID, this can be omitted. Each value should be a string that will be parsed by Google Sheets.
integer
required
Ending column index (0-based, exclusive) for the validation range. To apply to column A only, use start_column_index=0 and end_column_index=1.
integer
required
Starting column index (0-based, inclusive) for the validation range. Column A is index 0.
boolean
Whether to apply validation to rows hidden by filters. Default is false. Set to true to ensure validation applies to both visible and filtered rows.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SETTINGS_GETTool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value.

Input Parameters

string
required
The identifier of the user setting to retrieve. Valid values include: autoAddHangouts, dateFieldOrder, defaultEventLength, format24HourTime, hideInvitations, hideWeekends, locale, remindOnRespondedEventsOnly, showDeclinedEvents, timezone, useKeyboardShortcuts, weekStart

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SETTINGS_GET_IMAPRetrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size.

Input Parameters

string
The user’s email address or the special value ‘me’ to indicate the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SETTINGS_GET_POPTool to retrieve POP settings for a Gmail account. Use when you need to check the current POP configuration including access window and message disposition.

Input Parameters

string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SETTINGS_LISTLists the authenticated user’s calendar settings, returning a page of settings identified by their id fields. Supports pagination and incremental synchronization using a sync token.

Input Parameters

string
Token specifying which result page to return.
string
Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.
integer
Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250 entries.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SETTINGS_SEND_AS_GETTool to retrieve a specific send-as alias configuration for a Gmail user. Use when you need to get details about a send-as email address including display name, signature, SMTP settings, and verification status. Fails with HTTP 404 if the specified address is not a member of the send-as collection.

Input Parameters

string
The email address of the Gmail user whose send-as alias to retrieve, or the special value ‘me’ to indicate the authenticated user.
string
required
The send-as alias email address to retrieve. This is the email address that appears in the ‘From:’ header.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SETTINGS_WATCHWatch for changes to Settings resources.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel.
string
required
The type of delivery mechanism used for this channel. Must be “web_hook”.
string
An arbitrary string delivered to the target address with each notification delivered over this channel.
object
Additional parameters controlling delivery channel behavior.
string
required
The address where notifications are delivered for this channel.
integer
Unix timestamp in milliseconds specifying when the API should stop sending notifications for this channel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SHEET_FROM_JSONDEPRECATED: Creates a new Google Spreadsheet and populates its first worksheet from JSON rows; an empty list creates an empty worksheet. Headers use keys from the first row followed by additional keys found in later rows.

Input Parameters

string
required
The desired title for the new Google Spreadsheet.
array
required
A list of dictionaries representing the rows of the sheet. Each dictionary must have the same set of keys, which will form the header row. Values can be strings, numbers, booleans, or null (represented as empty cells). An empty list [] is allowed and will create a spreadsheet with an empty worksheet.
string
required
The name for the first worksheet within the newly created spreadsheet. This name will appear as a tab at the bottom of the sheet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SORT_RANGESorts data within a specified range in a Google Sheet based on one or more sort criteria. Use this action when you need to reorder rows in a range by column values, with support for multi-level (cascading) sorts.

Input Parameters

object
required
The range to sort. All cells in this range will be reordered based on the sort specifications.
array
required
The sort order per column. Later specifications are used when values are equal in the earlier specifications (cascading sort). At least one sort specification is required.
array
Limits the ranges included in the response spreadsheet. Meaningful only if includeSpreadsheetInResponse is true.
string
required
The ID of the spreadsheet.
boolean
True if grid data should be returned. Meaningful only if includeSpreadsheetInResponse is true.
boolean
Determines if the updated spreadsheet resource appears in the response. Default is false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SPREADSHEETS_SHEETS_COPY_TOTool to copy a single sheet from a spreadsheet to another spreadsheet. Use when you need to duplicate a sheet into a different spreadsheet.

Input Parameters

integer
required
The ID of the sheet to copy.
string
required
The ID of the spreadsheet containing the sheet to copy.
string
required
The ID of the spreadsheet to copy the sheet to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SPREADSHEETS_VALUES_APPENDTool to append values to a spreadsheet. Use when you need to add new data to the end of an existing table in a Google Sheet.

Input Parameters

string
required
A1 notation range used to locate a logical table. New rows are appended after the last row of that table within this range. First call GOOGLESHEETS_GET_SHEET_NAMES with this exact spreadsheet_id and use one of the returned sheet names; sheet names are case-sensitive and default names like ‘Sheet1’ are unsafe guesses. Valid formats: exact sheet name only (e.g., ‘Sales Data’), sheet-qualified column range (e.g., ‘Sales Data!A:D’), or sheet-qualified cell range (e.g., ‘Sales Data!A1:D100’). Do not pass bare ranges like ‘A:F’ or ‘A1:D100’ because they omit the sheet name. If the needed sheet is not returned, create it or ask the user instead of inventing a name. Sheet names with spaces need single quotes (auto-added). IMPORTANT: The append may land in different columns than specified due to API table detection. For strict column placement, use GOOGLESHEETS_SPREADSHEETS_VALUES_UPDATE instead. Always check updates.updatedRange in the response to verify where data was actually written.
array
required
2D array of values to append. Typically, each inner list is a ROW (majorDimension=ROWS). Use null/None for empty cells.
string
required
The spreadsheet ID (typically 44 characters containing letters, numbers, hyphens, and underscores). Found in the URL between /d/ and /edit. NOT the sheet name (tab name) - that belongs in the ‘range’ parameter.
string ("ROWS" | "COLUMNS")
How to interpret the 2D values array. Use ROWS for row-wise data (most common for appends). Use COLUMNS for column-wise data. Example: if A1=1,B1=2,A2=3,B2=4 then majorDimension=ROWS yields [[1,2],[3,4]] and majorDimension=COLUMNS yields [[1,3],[2,4]].
string ("OVERWRITE" | "INSERT_ROWS")
How the input data should be inserted.
string ("RAW" | "USER_ENTERED")
required
How the input data should be interpreted.
boolean
Determines if the update response should include the values of the cells that were appended. By default, responses do not include the updated values.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
Determines how dates, times, and durations in the response should be rendered. This is ignored if responseValueRenderOption is FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SPREADSHEETS_VALUES_BATCH_CLEARTool to clear one or more ranges of values from a spreadsheet. Use when you need to remove data from specific cells or ranges while keeping formatting and other properties intact.

Input Parameters

array
required
The ranges to clear, in A1 notation (e.g., ‘Sheet1!A1:B2’) or R1C1 notation. Each range should be a clean string without surrounding brackets or extra quotes. Valid examples: ‘Sheet1!A1:B2’, ‘A1:Z100’, ‘Sheet1’. Invalid examples: ”[‘Sheet1!A1:B2’]”, ‘[Sheet1!A1]’.
string
required
The ID of the spreadsheet to update. Can be either a spreadsheet ID or a full Google Sheets URL (the ID will be extracted automatically).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SPREADSHEETS_VALUES_BATCH_GET_BY_DATA_FILTERRetrieves one or more ranges of values from a Google Spreadsheet using data filters. Each filter specifies an A1 range or a grid range.

Input Parameters

array
required
Required. An array of data filter objects used to match ranges of values to retrieve. Each filter can specify either ‘a1Range’ (e.g., ‘Sheet1!A1:B5’) or ‘gridRange’. Must be provided as a list, e.g., [{‘a1Range’: ‘Sheet1!A1:B5’}]. A single filter object will be automatically wrapped in a list.
string
required
The ID of the spreadsheet to retrieve data from. This is the unique identifier found in the spreadsheet URL (e.g., in ‘https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit’, the ID is the SPREADSHEET_ID part). Typical Google Sheets IDs are approximately 44 characters long and contain alphanumeric characters, hyphens, and underscores.
string ("ROWS" | "COLUMNS")
The major dimension that results should use. For example, if the spreadsheet data is: A1=1,B1=2,A2=3,B2=4, then a request that selects that range and sets majorDimension=ROWS returns [[1,2],[3,4]], whereas a request that sets majorDimension=COLUMNS returns [[1,3],[2,4]].
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How values should be represented in the output. The default render option is FORMATTED_VALUE.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How dates, times, and durations should be represented in the output. This is ignored if valueRenderOption is FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_STOP_WATCHTool to stop receiving push notifications for a Gmail mailbox. Use when you need to disable watch notifications previously set up via the watch endpoint.

Input Parameters

string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_STOP_WATCH_CHANNELTool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch. Both id and resourceId must be saved from the original watch response — they cannot be retrieved after the fact.

Input Parameters

string
required
The ID of the channel to stop.
string
Identifies this as a notification channel used to watch for changes to a resource.
string
An arbitrary string delivered to the target address with each notification delivered over this channel.
object
Additional parameters controlling delivery channel behavior.
string
The address where notifications are delivered for this channel.
boolean
A Boolean value to indicate whether payload is wanted.
string
Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds.
string
required
The ID of the resource being watched.
string ("web_hook" | "webhook")
The type of delivery mechanism used for this channel.
string
A version-specific identifier for the watched resource.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_SYNC_EVENTSDeprecated: Retrieves a page of Google Calendar events for full or incremental synchronization, using a sync token for changes. Returns pagination and sync tokens; an expired token requires a new full synchronization.

Input Parameters

string
Token for paginating results, from a previous response’s nextPageToken. Repeat with each returned nextPageToken until no nextPageToken is returned; stopping early silently omits remaining events.
string
Token for incremental sync, retrieving only changes since issued. A 410 GONE response indicates an expired token, requiring a full sync. Cannot be combined with timeMin, timeMax, orderBy, query, or updatedMin; mixing these causes the request to fail.
string
Google Calendar identifier; ‘primary’ refers to the authenticated user’s main calendar.
array
Filters events by specified types (e.g., ‘default’, ‘focusTime’, ‘outOfOffice’, ‘workingLocation’). All types returned if omitted.
integer
Max events per page (max 2500); Google Calendar’s default is used if unspecified.
boolean
If True, expands recurring events into individual instances (excluding master event); otherwise, Google’s default handling applies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_TEXT_SEARCHSearches for places on Google Maps using a textual query (e.g., “restaurants in London”, “Eiffel Tower”). Results may include CLOSED_PERMANENTLY or TEMPORARILY_CLOSED places — filter by businessStatus=OPERATIONAL. Include city/region and business type in textQuery to avoid empty or irrelevant results. Deduplicate using id or formattedAddress, not name alone. Throttle to ~1 req/s; OVER_QUERY_LIMIT (HTTP 429) requires exponential backoff.

Input Parameters

string
Comma-separated list of place fields to return. When omitted, defaults to displayName and formattedAddress (requests through your own connected Google Maps account also include priceLevel). Requesting priceLevel increases the price. Common fields include: displayName, formattedAddress, types, rating, userRatingCount, priceLevel, websiteUri, nationalPhoneNumber, internationalPhoneNumber, regularOpeningHours, location, photos, googleMapsUri, businessStatus, id. The ‘places.’ prefix is optional and will be added automatically. Use ’*’ for all fields (not recommended for performance/cost). Common aliases are supported: ‘name’->displayName, ‘address’->formattedAddress, ‘url’/‘website’->websiteUri, ‘type’->types, ‘phone’->nationalPhoneNumber. Invalid field names (e.g., places.phoneNumber instead of places.nationalPhoneNumber) cause errors. Many fields (rating, websiteUri, regularOpeningHours, nationalPhoneNumber) may be absent even when requested — handle nulls.
string
required
Text query for searching places. Matched against place name, address, and category. Underspecified queries (missing city, region, or business type) yield empty or irrelevant results. Brand-name-only queries return multiple franchise branches — validate formattedAddress against the intended location.
integer
Maximum number of place results to return (must be 1-20). Note: Google prefers pageSize, but this action uses maxResultCount.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_TILES_CREATE_SESSIONCreates a session token for 2D map tiles or Street View imagery, reusable for subsequent tile requests within its validity window. Managed requests support standard-resolution 2D map sessions only.

Input Parameters

string ("scaleFactor1x" | "scaleFactor2x" | "scaleFactor4x")
Label scaling factor for high-resolution displays. Valid values: ‘scaleFactor1x’ (standard), ‘scaleFactor2x’ (2x resolution), or ‘scaleFactor4x’ (4x resolution).
string
required
Two-letter CLDR region code representing the user’s location (e.g., ‘US’, ‘GB’, ‘FR’). This helps Google Maps provide region-specific content.
array
JSON style objects for customizing map appearance (roadmap only). Allows custom styling of map features like roads, buildings, and landmarks.
boolean
Enable high-resolution tiles for high DPI displays. Works only with 2x or 4x scale factors. Set to true for sharper images on high-resolution screens.
string ("roadmap" | "satellite" | "terrain" | "streetview")
required
Base map type. Valid values: ‘roadmap’ for standard road map, ‘satellite’ for satellite imagery, ‘terrain’ for terrain maps, or ‘streetview’ for street view imagery.
boolean
Render map layers separately (true) or combined into a single image (false). Set to true if you want individual overlay layers.
string
required
IETF language tag specifying the display language for map labels and information (e.g., ‘en-US’, ‘es-ES’, ‘fr-FR’).
array
Overlay options for the map. Valid values: ‘layerRoadmap’ (road overlay), ‘layerStreetview’ (street view overlay), ‘layerTraffic’ (traffic layer). Note: terrain mapType requires layerRoadmap.
string ("jpeg" | "png")
Output format for tile images. Valid values: ‘jpeg’ or ‘png’. If omitted, the format will be auto-selected by the API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_TRASH_FILETool to move a file or folder to trash (soft delete). Use when you need to delete a file but want to allow recovery via UNTRASH_FILE. This action is distinct from permanent deletion and provides a safer cleanup workflow.

Input Parameters

string
Comma-separated list of fields to include in the response. Use to limit the amount of data returned. If omitted, returns basic file metadata.
string
required
The ID of the file to trash.
boolean
Whether the requesting application supports both My Drives and shared drives. Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UNHIDE_DRIVETool to unhide a shared drive. Use when you need to restore a shared drive to the default view.

Input Parameters

string
required
The ID of the shared drive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UNMERGE_TABLE_CELLSTool to unmerge previously merged cells in a table. Use this when you need to revert merged cells in a Google Document table back to their individual cell states.

Input Parameters

string
required
The ID of the document to unmerge table cells in.
object
required
The table range specifying which cells of the table to unmerge.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UNTRASH_FILERestore a file from Google Drive trash. The file must still be in the trash; this does not recover permanently deleted files.

Input Parameters

string
required
The ID of the file to untrash.
boolean
Whether the requesting application supports both My Drives and shared drives.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UNTRASH_MESSAGETool to remove a message from trash in Gmail. Use when you need to restore a previously trashed email message.

Input Parameters

string
User’s email address or ‘me’ for the authenticated user.
string
required
Required. The unique identifier of the email message to remove from trash. This is a hexadecimal string that can be obtained from listing or fetching emails.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UNTRASH_THREADTool to remove a thread from trash in Gmail. Use when you need to restore a deleted thread and its messages.

Input Parameters

string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.
string
required
The ID of the thread to remove from trash.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_ALBUMUpdates the title or cover photo of a Google Photos album created by this app.

Input Parameters

string
New title for the album. Maximum 500 characters.
string
required
Identifier of the album to update
string
ID of the media item to use as album cover photo

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_CHARTUpdates an existing chart in a Google Sheets spreadsheet by replacing its chart specification. The specification can change its title, chart type, data ranges, colors, axes, and other visual settings without moving or resizing the chart.

Input Parameters

integer
required
The unique numeric identifier of the chart to update within the spreadsheet. This is the chartId value returned when the chart was created or can be retrieved using the ‘Get Spreadsheet Info’ action (look for sheets[].charts[].chartId in the response). The chart must already exist in the specified spreadsheet.
object
required
The complete ChartSpec object defining the updated chart specification. This replaces the chart’s existing specification but does not move or resize the chart. Must set exactly one chart type field: basicChart, pieChart, bubbleChart, candlestickChart, histogramChart, treemapChart, waterfallChart, orgChart, or scorecardChart. To change chart position or size, use a separate UpdateEmbeddedObjectPosition request. See https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/charts#ChartSpec
string
required
The unique identifier of the Google Sheets spreadsheet containing the chart to update. Must be the actual spreadsheet ID from the URL (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’), NOT the spreadsheet name or title. Find it in the URL: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_COMMENTTool to update an existing comment on a Google Drive file. Use when you need to change the content of a comment. NOTE: The ‘resolved’ field is read-only in the Google Drive API. To resolve or reopen a comment, use CREATE_REPLY with action=‘resolve’ or action=‘reopen’.

Input Parameters

string
Selector specifying which fields to include in a partial response. The API documentation states this is required. If not specified by the user, this action defaults to ’*’ to retrieve all fields, ensuring the API requirement is met. Example: ‘id,content,resolved’.
string
The plain text content of the comment. This field is used to update the comment’s text. If not provided, the existing content will be retained unless ‘resolved’ is being updated.
string
required
The ID of the file.
boolean
NOTE: The ‘resolved’ field is READ-ONLY in the Google Drive API. To resolve or reopen a comment, use the CREATE_REPLY action with action=‘resolve’ or action=‘reopen’. This parameter is kept for backwards compatibility but will be silently ignored by the API.
string
required
The ID of the comment to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_CONTACTReplace selected fields on an existing saved Google contact.

Input Parameters

object
required
Google Person resource containing metadata.sources and replacement values. metadata.sources must include a CONTACT source; include that source’s etag for concurrency protection.
array
Source types to include in the returned Person resource.
string
Comma-separated field mask of Person fields to return after the update. Valid values: addresses, ageRanges, biographies, birthdays, calendarUrls, clientData, coverPhotos, emailAddresses, events, externalIds, genders, imClients, interests, locales, locations, memberships, metadata, miscKeywords, names, nicknames, occupations, organizations, phoneNumbers, photos, relations, sipAddresses, skills, urls, userDefined.
string
required
Saved contact resource name in people/{person_id} form.
string
required
Comma-separated field mask of Person fields to replace. Valid values: addresses, biographies, birthdays, calendarUrls, clientData, emailAddresses, events, externalIds, genders, imClients, interests, locales, locations, memberships, miscKeywords, names, nicknames, occupations, organizations, phoneNumbers, relations, sipAddresses, urls, userDefined.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_DATA_MANAGER_USER_LISTUpdate mutable Data Manager user-list metadata, optionally validating only.

Input Parameters

string
required
Account ID owning the user list.
string
Description; an empty string clears the description.
string
Optional comma-separated FieldMask using provider lowerCamelCase paths, for example displayName,description or targetNetworkInfo.eligibleForSearch. Passed unchanged; omit to use provider defaults. Fields in the mask but absent from the body are reset to their default values.
string
required
Account type, for example GOOGLE_ADS.
string
New display name. Omit when updating other fields.
string
required
ID of the user list to update.
string
Optional authorizing account resource: accountTypes/{type}/accounts/{id}.
boolean
If true, validate the request without updating the list.
string
Optional linked account resource: accountTypes/{type}/accounts/{id}.
string
External-system identifier used by user-list sellers.
string ("MEMBERSHIP_STATUS_UNSPECIFIED" | "OPEN" | "CLOSED")
Whether this list accepts new members.
string
Protobuf duration in seconds, ending in s; exact multiples of 86400 seconds.
object
Mutable target-network eligibility information.
string ("ACCESS_STATUS_UNSPECIFIED" | "ENABLED" | "DISABLED")
Whether the account’s access to a shared list is enabled.
object
Mutable metadata for a list populated with ingested data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_DIMENSION_PROPERTIESTool to hide/unhide rows or columns and set row heights or column widths. Use when you need to change visibility or pixel sizing of dimensions in a Google Sheet.

Input Parameters

integer
The numeric ID of the sheet (tab). Either sheet_id or sheet_name must be provided. If both are provided, sheet_name will be resolved to sheet_id and override this value.
string ("ROWS" | "COLUMNS")
required
Whether to update rows or columns.
integer
required
The zero-based end index (exclusive) of the dimension range to update. For example, to update rows 5-9, use start_index=5 and end_index=10.
integer
The height (for rows) or width (for columns) in pixels. Must be a positive integer. At least one of hidden_by_user or pixel_size must be provided.
string
The name of the sheet (tab). If provided, this will be resolved to the numeric sheet_id using GOOGLESHEETS_GET_SPREADSHEET_INFO. Either sheet_id or sheet_name must be provided.
integer
required
The zero-based start index (inclusive) of the dimension range to update. For rows, 0 is the first row; for columns, 0 is column A.
boolean
Whether to hide (true) or unhide (false) the specified rows/columns. At least one of hidden_by_user or pixel_size must be provided.
string
required
The ID of the spreadsheet to update.
array
Limits the ranges included in the response spreadsheet (only if includeSpreadsheetInResponse is true).
boolean
Whether to include grid data in the response (only if includeSpreadsheetInResponse is true).
boolean
Whether to include the updated spreadsheet in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_DOCUMENT_BATCHApplies a batch of updates to a Google Document, such as inserting text, updating styles, and modifying tables or document structure. Text-style requests with empty ranges are filtered out before the remaining requests are submitted; optional write control helps manage concurrent edits. DEPRECATED: Use UpdateExistingDocument instead.

Input Parameters

array
required
A list of updates to apply to the document. Each request dict must contain exactly one request type key (e.g., insertText, replaceAllText, updateTextStyle, createParagraphBullets). For updateTextStyle, range must be non-empty (startIndex < endIndex). See https://developers.google.com/docs/api/reference/rest/v1/documents/request for all types.
string
required
The ID of the document to update.
object
Provides control over how write requests are executed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_DOCUMENT_MARKDOWNReplaces the body content of a Google Docs tab with rendered Markdown; requires edit permissions. If no tab is specified, the first tab is updated.

Input Parameters

string
required
The unique identifier for the Google Docs document to update. Accepts either a document ID (alphanumeric string, length varies by document age - newer documents typically have 44-character IDs) or a full Google Docs URL (e.g., https://docs.google.com/document/d/&#123;DOCUMENT_ID&#125;/edit). When a URL is provided, the document ID will be automatically extracted.
string
Optional tab ID to replace with the rendered Markdown. When omitted, the first tab is updated.
string
required
Markdown content that will replace the document’s entire existing content. Supports standard Markdown features.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_DOCUMENT_SECTION_MARKDOWNInsert or replace a section of a Google Docs document with rendered Markdown, using start and optional end indices, or append when no start index is provided. A replacement may leave the original content in place while inserting the new content.

Input Parameters

string
Optional tab ID to update with the rendered Markdown. When omitted, the first tab is updated.
integer
Optional one-based end index of the content to replace (exclusive); must be greater than or equal to start_index. If end_index is not provided, the content is inserted at the start_index without replacing existing content. Requires start_index to be provided - if start_index is omitted (append mode), end_index is ignored. Important: Use the exact indices from GOOGLEDOCS_GET_DOCUMENT_BY_ID without modification. The Google Docs API does not allow deleting the last newline character of a document segment (body, header, footer, etc.), so ensure end_index does not include the final segment newline.
string
required
The unique ID of the Google Docs document to update. This is the alphanumeric string found in the document URL: https://docs.google.com/document/d/&#123;DOCUMENT_ID&#125;/edit. Valid IDs are typically 44 characters long and contain only letters, numbers, hyphens, and underscores (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’). To get a document ID: create a new document using GOOGLEDOCS_CREATE_DOCUMENT, or extract it from an existing document’s URL. Also accepts parameter aliases: ‘id’, ‘doc_id’, ‘documentId’, or ‘docId’.
integer
One-based UTF-16 code unit index where to insert or start replacement. If not provided, content will be appended to the end of the document. Use 1 to insert at the very beginning of the document. To insert at a specific position, first use GOOGLEDOCS_GET_DOCUMENT_BY_ID to retrieve the document structure and find the desired index from the body.content elements’ start_index/end_index values. If the provided index equals or exceeds the document segment’s end index, it will be automatically adjusted to the last valid position (end_index - 1) and a message will be included in the response.
string
required
Markdown content to insert or replace in the document section. Large content is automatically split into smaller batches to avoid API limits. Also accepts ‘markdown’, ‘content’, ‘text’, ‘body’, ‘markdownText’, or ‘markdown_content’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_DOCUMENT_STYLETool to update the overall document style, such as page size, margins, and default text direction. Use when you need to modify the global style settings of a Google Document.

Input Parameters

string
A comma-separated list of fields to update (using camelCase API names like ‘marginTop’, ‘pageSize’). Use '' to automatically update only fields that have values set in document_style. For example: “pageSize,marginTop,marginBottom”. When '' is specified, the action automatically computes the field mask from the provided document_style fields.
string
The ID of the tab to update the style for. If not provided, the first tab is used.
string
required
The ID of the document to update.
object
required
The DocumentStyle object with the new style settings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_DRAFTUpdates a Gmail draft by ID by replacing its message. The tool reads the existing draft to preserve omitted recipients, subject and body where applicable, but existing attachments are not preserved unless supplied again.

Input Parameters

array
Carbon Copy (CC) recipients’ email addresses. Each must be a valid email address or display name format.
array
Blind Carbon Copy (BCC) recipients’ email addresses. Each must be a valid email address or display name format.
string
Email body content (plain text or HTML); is_html must be True if HTML. If not provided, previous body is preserved. Can also be provided as ‘message_body’.
boolean
Set to True if body is already formatted HTML. When False, plain text newlines are auto-converted to
tags.
string
Email subject line. If not provided, previous subject is preserved.
string
User’s email address or ‘me’ for the authenticated user.
string
required
The ID of the draft to update. Must be a valid draft ID from GMAIL_LIST_DRAFTS or GMAIL_CREATE_EMAIL_DRAFT.
string
ID of an existing Gmail thread. If provided, the draft will be part of this thread.
string
File(s) to attach to the draft. Accepts a single file or a list of files. Replaces any existing attachments.
string
Primary recipient’s email address. Must be a valid email address (e.g., ‘user@example.com’) or display name format (e.g., ‘John Doe <user@example.com>’). Optional - if not provided, previous recipients are preserved.
array
Additional ‘To’ recipients’ email addresses. Each must be a valid email address or display name format. Should only be used if recipient_email is also provided.
boolean
Append the sender’s Gmail signature (the ‘Send mail as’ signature configured in Gmail settings) to the message body, ahead of any quoted or forwarded content. Skipped when the body already ends with that signature, when no signature is configured, or when the connection lacks permission to read Gmail settings. Set to false to send the body exactly as provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_DRIVETool to update the metadata for a shared drive. Use when you need to modify properties like the name, theme, background image, or restrictions of a shared drive.

Input Parameters

string
The new name for the shared drive.
boolean
Whether the shared drive is hidden from the default view.
string
required
The ID of the shared drive to update.
string
The ID of a theme to apply to the shared drive. Cannot be set if colorRgb or backgroundImageFile are set.
string
The color of this shared drive as an RGB hex string (e.g., “#FF0000”). Cannot be set if themeId is set.
object
A set of restrictions to apply to the shared drive.
object
An image file and cropping parameters for the shared drive’s background. Cannot be set if themeId is set.
boolean
If set to true, the request is issued as a domain administrator.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_EVENTReplaces an existing Google Calendar event using its event ID and required start time. Omitted fields can be cleared, but existing conference data is preserved by default when available; supply the desired event details for the replacement.

Input Parameters

string
Summary (title) of the event.
string
required
REQUIRED. The unique identifier of the event to update. This parameter is MANDATORY - events cannot be updated by title, date, or other criteria. You MUST first retrieve the event_id by using GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to search for the event, then use the returned ‘id’ field here.
string
Geographic location of the event as free-form text.
string
IANA timezone name from the timezone database (e.g., ‘America/New_York’, ‘Europe/London’, ‘Asia/Jerusalem’, ‘UTC’). Required if datetime is naive. For recurring events, start and end must include a timeZone. If not provided, UTC is used. If datetime includes timezone info (Z or offset), this field is optional and defaults to UTC. IMPORTANT: Must be a valid IANA timezone identifier. Values like ‘EST’, ‘PST’, ‘ISRAEL TIME’, or other abbreviations are NOT valid IANA timezone names.
array
List of attendees. Each attendee can be either: (1) A string email address (e.g., ‘user@example.com’), or (2) An object with ‘email’ (required), ‘optional’ (boolean, default false), ‘displayName’ (string), ‘comment’ (string), ‘additionalGuests’ (integer), and ‘resource’ (boolean). To mark an attendee as optional (not required), use object format: {‘email’: ‘user@example.com’, ‘optional’: true}. IMPORTANT: Only valid email addresses are accepted. Plain names cannot be used.
string ("birthday" | "default" | "focusTime" | "outOfOffice" | "workingLocation")
Type of the event, immutable post-creation. ‘workingLocation’ (REQUIRES Google Workspace Enterprise). Note: ‘fromGmail’ events cannot be created via API.
array
List of RRULE, EXRULE, RDATE, EXDATE lines for recurring events. Supported frequencies: DAILY, WEEKLY, MONTHLY, YEARLY. For recurring events, start.timeZone and end.timeZone must be present. UNTIL values follow RFC 5545: date-only (YYYYMMDD) for all-day events, or UTC datetime with Z suffix (YYYYMMDDTHHMMSSZ) for timed events. UNTIL values with time but missing Z suffix are auto-corrected. Provide an empty list to remove recurrence so the event becomes non-recurring.
string ("default" | "public" | "private" | "confidential")
Event visibility: ‘default’, ‘public’, ‘private’, or ‘confidential’.
string
Identifier of the Google Calendar where the event resides. The value ‘primary’ targets the user’s primary calendar.
string
Description of the event. Can contain HTML. Optional. Must be omitted for ‘birthday’ event type.
string
Event end time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. When provided, this parameter takes precedence over event_duration_hour and event_duration_minutes. If not provided, the end time is calculated using start_datetime + duration. Must be after start_datetime. Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted.
string ("all" | "externalOnly" | "none")
Options for who should receive notifications about event changes.
string ("opaque" | "transparent")
‘opaque’ (busy) or ‘transparent’ (available).
string
required
REQUIRED. Event start time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. IMPORTANT: Natural language expressions like ‘tomorrow’, ‘next Monday’, ‘2pm tomorrow’ are NOT supported and will be rejected. You must provide the exact date and time in ISO format. Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted. Examples: ‘2025-01-16T13:00:00’, ‘2025-01-16T13:00:00Z’, ‘2025-01-16T13:00:00-05:00’.
boolean
If True, guests can modify the event.
object
Properties for birthday events.
boolean
Defaults to True. When True, for CREATE operations creates a Google Meet link; for UPDATE operations preserves existing conference data if present, or adds a new Meet link if none exists. Google Workspace accounts will successfully receive a Meet link. Personal Gmail accounts and other unsupported accounts will gracefully fallback to creating an event without a Meet link when conference creation fails. Set to False to skip Meet link operations (won’t create new or modify existing conference data). The fallback ensures event creation succeeds even when conference features are unavailable due to account limitations.
integer
Number of hours for the event duration. Supports multi-day events (e.g., 240 hours = 10 days). For durations under 1 hour, use event_duration_minutes instead. Ignored if end_datetime is provided.
object
Extended properties of the event for storing custom metadata. Contains ‘private’ (visible only on this calendar) and/or ‘shared’ (visible to all attendees) dictionaries mapping string keys to string values. Example: {‘private’: {‘key1’: ‘value1’}, ‘shared’: {‘key2’: ‘value2’}}
object
Properties for focusTime events. REQUIRES Google Workspace Enterprise account with Focus Time feature enabled.
boolean
Whether attendees other than the organizer can invite others to the event.
object
Properties for outOfOffice events.
integer
Duration in minutes (0-59 ONLY). NEVER use 60+ minutes - use event_duration_hour=1 instead. Maximum value is 59. Combined duration (hours + minutes) must be greater than 0. Ignored if end_datetime is provided.
boolean
Whether attendees other than the organizer can see who the event’s attendees are.
object
Properties for workingLocation events. REQUIRES Google Workspace Enterprise. Constraints discovered from testing: - Must set transparency=‘transparent’ and visibility=‘public’ - Description must be omitted - Depending on ‘type’, include one of ‘homeOffice’, ‘officeLocation’, or ‘customLocation’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_EXISTING_DOCUMENTApplies a batch of edits to a specified Google Doc, such as inserting, deleting, or formatting text.

Input Parameters

array
required
(Required) A list of requests to execute on the document. Each request must be a dict containing exactly ONE of the valid request types listed below. Common request types: replaceAllText, insertText, updateTextStyle, createParagraphBullets, deleteParagraphBullets, createNamedRange, deleteNamedRange, updateParagraphStyle, deleteContentRange, insertInlineImage, insertTable, insertTableRow, insertTableColumn, deleteTableRow, deleteTableColumn, insertPageBreak, deletePositionedObject, updateTableColumnProperties, updateTableCellStyle, updateTableRowStyle, replaceImage, updateDocumentStyle, mergeTableCells, unmergeTableCells, createHeader, createFooter, createFootnote, replaceNamedRangeContent, updateSectionStyle, insertSectionBreak, deleteHeader, deleteFooter, pinTableHeaderRows, addDocumentTab, deleteTab, updateDocumentTabProperties, insertPerson. Do NOT use request types from other Google APIs (Slides, Sheets, etc.). For full request schemas, see https://developers.google.com/docs/api/reference/rest/v1/documents/batchUpdate. SEGMENT IDs: Use empty string "" for document body, or a header/footer/footnote ID from the document. Internal ‘kix.’ IDs are NOT valid segment IDs and will cause “Segment with ID … was not found” errors. Call GOOGLEDOCS_GET_DOCUMENT_BY_ID to get valid IDs. TAB IDs: When omitted, operations target the first tab. Invalid tab IDs cause errors. Get valid tab IDs from GOOGLEDOCS_GET_DOCUMENT_BY_ID at tabs[].tabProperties.tabId. BATCH INSERT OPERATIONS: Operations execute sequentially. Each insertText shifts subsequent indices. For multiple inserts at specific positions, process in REVERSE index order (highest first). For appending, use endOfSegmentLocation for each insert. Auto-correction: insertText without location/endOfSegmentLocation automatically appends to document body. INDEX BOUNDARIES: location.index must be LESS than the segment end index (valid: 1 to N-1). To insert at the end, use endOfSegmentLocation instead. PARAGRAPH BOUNDARIES: Text can only be inserted inside existing paragraphs, not at structural boundaries (e.g., a table’s start index). For table cells, add +1 or +2 to the cell’s startIndex. deleteContentRange: The range CANNOT include the trailing newline at segment end. If segment ends at N, use endIndex: N-1. deleteTableRow: Requires tableCellLocation object (NOT top-level rowIndex/tableStartLocation). Structure: { tableCellLocation: { tableStartLocation: { index: N }, rowIndex: R, columnIndex: C } }. updateTableCellStyle: Use EITHER tableStartLocation (all cells) OR tableRange (specific cells), not both. Style updates (updateParagraphStyle, updateTextStyle, updateTableCellStyle, updateDocumentStyle): The ‘fields’ parameter is auto-populated from style keys if omitted. Document title CANNOT be updated via batchUpdate - use Google Drive API instead. updateDocumentStyle valid fields: background, marginTop, marginBottom, marginLeft, marginRight, marginHeader, marginFooter, pageSize, pageNumberStart, useEvenPageHeaderFooter, useFirstPageHeaderFooter, flipPageOrientation (NOT “title”).
string
required
(Required) The unique identifier of the Google Docs document to be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_EXPERIMENTUpdate mutable fields on one Google Ads experiment.

Input Parameters

object
required
Experiment resource name and fields to update.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
string
Comma-separated fields to update; generated from supplied fields when omitted.
boolean
Validate the request without changing the experiment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_EXPERIMENT_ARMSUpdate one or more Google Ads experiment arms.

Input Parameters

array
required
Experiment arm updates to execute in one request.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
Validate the updates without changing experiment arms.
boolean
Apply valid updates and report invalid operations separately.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Return resource names only or mutable experiment-arm fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_FILE_METADATA_PATCHTool to update file metadata using the Drive API v2 PATCH method. Use when you need to modify file properties like title, description, or labels using patch semantics.

Input Parameters

boolean
Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
string
The title of the file. Used to change the name of the file.
string
required
The ID of the file to update.
object
A group of labels for the file. For example: {‘starred’: true, ‘trashed’: false, ‘restricted’: false, ‘viewed’: true}.
boolean
Whether to pin the new revision. A file can have a maximum of 200 pinned revisions.
string
The MIME type of the file.
string
Comma-separated list of parent IDs to add.
array
The list of properties.
string
A short description of the file.
boolean
Whether a blob upload should create a new revision. If not set, a new revision is created.
string
If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
string
Last time this file was modified by anyone (RFC 3339 date-time). Requires setModifiedDate=true.
string
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
object
Indexable text attributes for the file (can be used to improve fulltext queries).
string
Comma-separated list of parent IDs to remove.
boolean
Whether to set the modified date using the value supplied in the request body.
boolean
Whether writers can share the document with other users.
boolean
Whether to update the view date after successfully updating the file.
boolean
Whether the requesting application supports both My Drives and shared drives. Defaults to true.
string
The language of the timed text.
string
The timed text track name.
string
Specifies which additional view’s permissions to include in the response. Only ‘published’ is supported.
boolean
Whether to use the content as indexable text.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_FILE_PROPERTYTool to update a property on a file using Google Drive API v2. Use when you need to modify an existing custom property attached to a file.

Input Parameters

string ("json" | "media" | "proto")
Data format for response.
string
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
string ("1" | "2")
V1 error format values.
string
Selector specifying which fields to include in a partial response.
string
required
The ID of the file.
string
JSONP callback function name.
string
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
string
Legacy upload protocol for media (e.g. ‘media’, ‘multipart’).
string ("PRIVATE" | "PUBLIC")
Visibility options for the property.
string
OAuth 2.0 token for the current user.
boolean
Returns response with indentations and line breaks.
string
required
The key of the property.
string
OAuth access token.
string
The value of this property.
string
Upload protocol for media (e.g. ‘raw’, ‘multipart’).
string ("PRIVATE" | "PUBLIC")
Visibility options for the property.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_FILE_PUTUpdates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3 — only explicitly provided fields are updated, so omit fields you do not intend to overwrite. Use this tool to modify attributes of an existing file like its name, description, or parent folders. To move a file, supply add_parents and remove_parents together; omitting remove_parents creates multiple parents, omitting add_parents can orphan the file. Bulk updates may trigger 429 Too Many Requests; apply exponential backoff. Note: supports metadata updates only; file content updates are not yet implemented.

Input Parameters

string
The name of the file. Google Drive does not enforce name uniqueness within a folder; duplicate names are allowed and can cause ambiguous results when searching by name.
string
required
The ID of the file to update.
boolean
Whether the user has starred the file.
string
The MIME type of the file. Google Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
string
Comma-separated list of folder IDs (not folder names) to add as parents. Folder IDs are alphanumeric strings typically 20+ characters long (e.g., ‘1A2B3C4D5E6F7G8H9I0J’). Folder names will not work and will cause a ‘Parent folder not found’ error. Moving a file requires pairing with remove_parents (source folder ID); omitting remove_parents results in multiple parents. Reparenting to a shared folder changes collaborator access to that folder’s permissions.
string
A short description of the file.
string
A language hint for OCR processing during image import (ISO 639-1 code).
string
Comma-separated list of folder IDs (not folder names) to remove as parents. Folder IDs are alphanumeric strings typically 20+ characters long (e.g., ‘1A2B3C4D5E6F7G8H9I0J’). Folder names will not work and will cause a ‘Parent folder not found’ error.
boolean
Whether writers can share the document with other users.
boolean
Whether the requesting application supports both My Drives and shared drives. Defaults to true to ensure compatibility with shared drive files.
boolean
Whether to set this revision of the file to be kept forever. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
boolean
Whether the requesting application is using domain-wide delegation to access content belonging to a user in a different domain. This is only applicable to files with binary content in Google Drive.
boolean
Whether viewers are prevented from copying content of the file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_FILE_REVISION_METADATAUpdates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). IMPORTANT: This action does NOT update file content. To update file content, use EDIT_FILE or UPDATE_FILE_PUT instead. This action requires BOTH file_id AND revision_id parameters. Use LIST_REVISIONS to get available revision IDs for a file. Valid parameters: file_id (required), revision_id (required), keep_forever, published, publish_auto, published_outside_domain. Invalid parameters (use other actions): file_contents, mime_type, content, name - these are NOT supported by this action.

Input Parameters

string
required
Required. The ID of the file whose revision metadata you want to update. Use LIST_FILES or FIND_FILE to get the file ID.
boolean
Whether this revision is published. This is only applicable to Docs Editors files.
boolean
Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive.
boolean
Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files.
string
required
Required. The ID of the revision to update. Use LIST_REVISIONS to get available revision IDs for a file.
boolean
Whether this revision is published outside the domain. This is only applicable to Docs Editors files.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_IMAP_SETTINGSTool to update IMAP settings for a Gmail account. Use when you need to modify IMAP configuration such as enabling/disabling IMAP, setting auto-expunge behavior, or configuring folder size limits.

Input Parameters

boolean
Whether IMAP is enabled for the account.
string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.
boolean
If this value is true, Gmail will immediately expunge a message when it is marked as deleted in IMAP. Otherwise, Gmail will wait for an update from the client before expunging messages marked as deleted.
integer
An optional limit on the number of messages that an IMAP folder may contain. Legal values are 0, 1000, 2000, 5000 or 10000. A value of zero is interpreted to mean that there is no limit.
string ("expungeBehaviorUnspecified" | "archive" | "trash" | "deleteForever")
The action that will be executed on a message when it is marked as deleted and expunged from the last visible IMAP folder. Possible values: ‘expungeBehaviorUnspecified’ (Unspecified behavior), ‘archive’ (Archive messages marked as deleted), ‘trash’ (Move messages marked as deleted to the trash), ‘deleteForever’ (Immediately and permanently delete messages marked as deleted).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_LABELUpdates an existing Gmail label’s name, visibility settings, or color to help organize the mailbox. Color is available for user labels and requires both a background and text color from Gmail’s supported palette.

Input Parameters

string
required
The ID of the label to update.
string
The display name of the label.
object
Color settings for the label. Both backgroundColor and textColor must be provided together.
string
The user’s email address. The special value me can be used to indicate the authenticated user.
string ("labelShow" | "labelShowIfUnread" | "labelHide")
Visibility of the label in the label list (Gmail sidebar).
string ("show" | "hide")
Visibility of messages with this label in the message list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_LANGUAGE_SETTINGSTool to update the language settings for a Gmail user. Use when you need to change the display language preference for the authenticated user or a specific Gmail account. The returned displayLanguage may differ from the requested value if Gmail selects a close variant.

Input Parameters

string
The email address of the Gmail user whose language settings are to be updated, or the special value ‘me’ to indicate the currently authenticated user.
string
required
The language to display Gmail in, formatted as an RFC 3066 Language Tag (e.g., ‘en-GB’ for British English, ‘fr’ for French, ‘ja’ for Japanese, ‘es’ for Spanish, ‘de’ for German, ‘en’ for English). The set of languages supported by Gmail evolves over time. Note: Gmail may save a close variant if the requested language is not directly supported. For example, if you request a regional variant that’s not available, Gmail may save the base language instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_MEDIA_ITEMUpdates the description of an app-created media item in Google Photos.

Input Parameters

string
required
New description for the media item. Must be shorter than 1000 characters.
string
required
Identifier of the media item to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_MEMBERUpdate an existing Google Meet space member’s email or meeting role. Requires meetings.space.created. Use update_mask to select fields; omitted or empty updates provided values, while ’*’ also clears fields not provided.

Input Parameters

string
required
Required. Member resource name: spaces/{space}/members/{member}. Used as both the path and the Member body identifier.
string ("ROLE_UNSPECIFIED" | "COHOST")
Meeting role: COHOST assigns co-host privileges; ROLE_UNSPECIFIED leaves the contributor/viewer role to the meeting configuration.
string
Email for the member. Optional when updating an existing member.
string
Comma-separated Member fields to update, for example ‘role’ or ‘email,role’. Omitted or empty means update all fields provided with values. ’*’ updates all fields, including deleting fields not set in the request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_PERMISSIONTool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive. Inherited or domain-managed permissions may not be editable; verify editability with GOOGLEDRIVE_LIST_PERMISSIONS before updating.

Input Parameters

string
required
The ID of the file or shared drive.
object
required
The permission resource to update. Only ‘role’ and ‘expirationTime’ can be updated. Role changes take effect immediately and can be difficult to reverse; confirm intent before applying.
string
required
The ID of the permission. For anyone-type permissions, use ‘anyone’ as the permission ID.
boolean
Whether to remove the expiration date.
boolean
Whether the requesting application supports both My Drives and shared drives. Must be set to true when operating on shared drives; omitting this causes the request to fail.
boolean
Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect when set to true.
boolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
boolean
Whether the request should enforce expansive access rules. This field is deprecated, it is recommended to use permissionDetails instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_POP_SETTINGSTool to update POP settings for a Gmail account. Use when you need to configure POP access window or message disposition behavior.

Input Parameters

string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.
string ("dispositionUnspecified" | "leaveInInbox" | "archive" | "trash" | "markRead")
The action that will be executed on a message after it has been fetched via POP.
string ("accessWindowUnspecified" | "disabled" | "fromNowOn" | "allMail")
The range of messages which are accessible via POP.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_PROPERTYTool to update an existing GA4 Property. Use when you need to modify property settings such as display name, time zone, currency code, or industry category.

Input Parameters

string
required
Required. The resource name of the Property to update. Must be in the exact format: properties/{property_id} where property_id is a numeric identifier. IMPORTANT: Must start with ‘properties/’ prefix, contain no forward slashes in the property_id, have no trailing slashes, and no additional path segments. Valid example: ‘properties/489591273’. Invalid examples: ‘489591273’ (missing prefix), ‘properties/489591273/’ (trailing slash), ‘properties/489591273/extra’ (extra segments)
string
Immutable. Resource name of this property’s logical parent. Format: accounts/{account}, properties/{property}. Example: ‘accounts/100’, ‘properties/101’
string
Required. Reporting Time Zone, used as the day boundary for reports. Format: IANA time zone. Example: ‘America/Los_Angeles’
string
required
Required. The list of fields to be updated. Field names must be in snake case (e.g., ‘display_name’, ‘time_zone’, ‘currency_code’). Omitted fields will not be updated. To replace the entire entity, use one path with the string ’*’ to match all fields. Common fields: ‘display_name’, ‘time_zone’, ‘currency_code’, ‘industry_category’
string
Human-readable display name for this property. The max allowed display name length is 100 UTF-16 code units.
string
The currency type used in reports involving monetary values. Format: ISO 4217. Examples: ‘USD’, ‘EUR’, ‘JPY’
string ("PROPERTY_TYPE_UNSPECIFIED" | "PROPERTY_TYPE_ORDINARY" | "PROPERTY_TYPE_SUBPROPERTY" | "PROPERTY_TYPE_ROLLUP")
Property type for a property.
string ("INDUSTRY_CATEGORY_UNSPECIFIED" | "AUTOMOTIVE" | "BUSINESS_AND_INDUSTRIAL_MARKETS" | "FINANCE" | "HEALTHCARE" | "TECHNOLOGY" | "TRAVEL" | "OTHER" | "ARTS_AND_ENTERTAINMENT" | "BEAUTY_AND_FITNESS" | "BOOKS_AND_LITERATURE" | "FOOD_AND_DRINK" | "GAMES" | "HOBBIES_AND_LEISURE" | "HOME_AND_GARDEN" | "INTERNET_AND_TELECOM" | "LAW_AND_GOVERNMENT" | "NEWS" | "ONLINE_COMMUNITIES" | "PEOPLE_AND_SOCIETY" | "PETS_AND_ANIMALS" | "REAL_ESTATE" | "REFERENCE" | "SCIENCE" | "SPORTS" | "JOBS_AND_EDUCATION" | "SHOPPING")
Industry category for a property.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_REPLYTool to update a reply to a comment on a Google Drive file. Use when you need to modify the content of an existing reply.

Input Parameters

string
Selector specifying which fields to include in a partial response. If not provided, defaults to ’*’ to return all fields.
string
required
The new plain text content of the reply.
string
required
The ID of the file.
string
required
The ID of the reply.
string
required
The ID of the comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_SEND_ASUpdates a Gmail send-as alias, including its display name, signature, reply-to address, or SMTP settings; Gmail sanitizes HTML signatures before saving. The tool declares support for service-account OAuth, not standard OAuth; non-primary addresses require domain-wide delegation.

Input Parameters

string
The email address of the Gmail user whose send-as alias to update, or the special value ‘me’ to indicate the authenticated user.
object
SMTP relay configuration for the send-as alias.
string
Optional HTML signature for messages composed with this alias in Gmail web UI. Gmail sanitizes HTML before saving. Only added to new emails.
boolean
Set to true to make this the default ‘From:’ address for composing messages and vacation auto-replies. Setting true makes the previous default false. Only legal writable value is true.
string
Name to appear in ‘From:’ header. For custom from addresses, Gmail populates with primary account name if empty. Admin restrictions may silently fail updates to primary login name.
string
required
The send-as alias email address to update. This is the email address that appears in the ‘From:’ header.
boolean
Whether Gmail treats this address as an alias for the user’s primary email. Only applies to custom from aliases.
string
Optional email address for ‘Reply-To:’ header. Gmail omits header if empty.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_SHEET_PROPERTIESTool to update properties of a sheet (worksheet) within a Google Spreadsheet, such as its title, index, visibility, tab color, or grid properties. Use this when you need to modify the metadata or appearance of a specific sheet.

Input Parameters

string
required
The ID of the spreadsheet containing the sheet to update.
array
Limits the ranges included in the response spreadsheet. Meaningful only if includeSpreadsheetInResponse is true. Ranges should be in A1 notation (e.g., ‘Sheet1!A1:B2’).
object
required
The details of the sheet properties to update.
boolean
True if grid data should be returned. Meaningful only if includeSpreadsheetInResponse is true. When true, the response will include cell data for the specified ranges.
boolean
Determines if the update response should include the spreadsheet resource. When true, the response will include the full updated spreadsheet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_SPACEUpdates the configuration of an existing Google Meet space, including access, moderation and artifact settings, using a supplied or automatically derived update mask. Requires an applicable meetings.space.created or meetings.space.settings OAuth scope.

Input Parameters

string
required
REQUIRED. The unique identifier of the Google Meet space to update. Format: ‘spaces/{space}’ where {space} is the space ID.
object
Configuration settings to update for the meeting space. Provide the fields you want to modify (e.g., accessType, entryPointAccess, moderation settings). Some settings (moderation modes, attendanceReportGenerationType, artifact generation) require specific Google Workspace editions and admin policies; unsupported settings may apply silently with no effect. Certain combinations of accessType, entryPointAccess, or moderation values may be rejected based on domain or account policies.
string
Field mask specifying which fields to update. Comma-separated list of fully qualified field names (e.g., “config.accessType,config.entryPointAccess”). If not provided, only the fields you explicitly set in config will be updated. WARNING: Using ”*” will attempt to update ALL config fields, which may cause errors if required fields like attendanceReportGenerationType are not provided. Recommend specifying only the fields being updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_SPREADSHEET_PROPERTIESTool to update SPREADSHEET-LEVEL properties such as the spreadsheet’s title, locale, time zone, or auto-recalculation settings. Use when you need to modify the overall configuration of a Google Spreadsheet. NOTE: To update individual SHEET properties (like renaming a specific sheet/tab), use GOOGLESHEETS_UPDATE_SHEET_PROPERTIES instead.

Input Parameters

string
required
Field mask specifying which properties to update (comma-separated for multiple fields). Supports nested paths using dot notation (e.g., ‘iterativeCalculationSettings.maxIterations’) per Protocol Buffers FieldMask specification. The root ‘properties’ is implied and must not be included. Special case: When updating ‘spreadsheetTheme’, use the field mask ‘spreadsheetTheme’ (not nested paths like ‘spreadsheetTheme.primaryFontFamily’) and provide the complete theme object with all required fields. Wildcard ’*’ updates all properties.
object
required
The spreadsheet-level properties to update (e.g., title, locale, timeZone, autoRecalc). At least one field within properties must be set. NOTE: To update individual sheet/tab properties (like renaming a specific sheet), use GOOGLESHEETS_UPDATE_SHEET_PROPERTIES instead.
string
required
The ID of the spreadsheet to update.
array
Limits the ranges included in the response spreadsheet. Only meaningful if includeSpreadsheetInResponse is true. Ranges should be in A1 notation (e.g., ‘Sheet1!A1:B2’).
boolean
Determines if grid data (cell values) should be included in the response. Only meaningful if includeSpreadsheetInResponse is true. When true, the response will include cell data for the specified ranges or entire spreadsheet.
boolean
Determines if the update response should include the full spreadsheet resource. When true, the response will include the entire updated spreadsheet with all sheets, properties, and metadata.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_SPREADSHEET_VALUESWrite values to one exact Google Sheets range.

Input Parameters

string
required
The exact A1 notation of the range to update, such as ‘Sheet1!A1:C2’.
array
required
Values to write. The outer list follows major_dimension. A null skips the corresponding cell; an empty string writes an empty value.
string
required
The Google Spreadsheet ID from its URL.
string ("ROWS" | "COLUMNS")
Whether each inner values list represents a row or a column.
string ("RAW" | "USER_ENTERED")
required
How Google Sheets interprets input: RAW stores values as supplied; USER_ENTERED parses them as if entered in the Sheets UI.
boolean
Whether the response should include the resulting cell values in updated_data.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How returned values are rendered when include_values_in_response is true.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How returned dates, times, and durations are rendered when values are unformatted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_TABLE_ROW_STYLEUpdates the style of selected rows in a Google Document table, including minimum row height and overflow prevention.

Input Parameters

string
required
The ID of the document to update.
object
required
The request body for updating the table row style.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_TAB_PROPERTIESUpdates properties of a document tab such as title, parent tab, index, and icon emoji. Use this action when you need to rename a tab, change its emoji icon, move it within the tab hierarchy, or reorganize tab structure.

Input Parameters

string
A comma-separated list of fields to update (using camelCase API names like ‘title’, ‘parentTabId’, ‘index’, ‘iconEmoji’). Use '' to automatically update only fields that have values set in tab_properties. For example: ‘title,iconEmoji’. When '' is specified, the action automatically computes the field mask from the provided tab_properties fields.
string
required
The ID of the tab to update. Get valid tab IDs from GOOGLEDOCS_GET_DOCUMENT_BY_ID at tabs[].tabProperties.tabId.
string
required
The ID of the document containing the tab to update.
object
required
The tab properties to update. Only the fields specified in the ‘fields’ parameter will be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_TASKDeprecated: Updates a Google task with the supplied fields. When marked completed without an explicit completion timestamp, it sets the timestamp to the current time.

Input Parameters

string
Due date of the task (RFC 3339 timestamp).
string
Notes describing the task.
string
Title of the task.
string
Status of the task. Valid values: “needsAction” or “completed”. When setting to “completed”, the completion date will be auto-set to the current time if not explicitly provided via the completed field.
string
required
Task identifier.
string
Completion date of the task (RFC 3339 timestamp).
string
required
Task list identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_TASK_FULLTool to fully replace an existing Google Task using PUT method. Use when you need to update the entire task resource, not just specific fields. This method requires all required fields (id, title) and replaces the complete task, unlike PATCH which supports partial updates.

Input Parameters

string
required
Task identifier (REQUIRED). Must match the task_id parameter. This field is required by the Google Tasks API for PUT operations.
string
Due date for the task. NOTE: Google Tasks only stores the date portion (YYYY-MM-DD). Accepts RFC3339 format (e.g., ‘2025-09-28T00:00:00Z’) or date strings like ‘2025-09-28’.
string
ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task.
Collection of links attached to the task. This collection is read-only.
string
Additional details or description for the task. Supports plain text only. Maximum 8192 characters.
string
required
Title/name of the task (REQUIRED). This is the main text displayed for the task. Maximum 1024 characters.
boolean
Whether the task is hidden. This is read-only and set by the API when task list is cleared. Default: false
string
Parent task identifier for subtasks. This field is read-only. Use the ‘move’ method to change parent.
string ("needsAction" | "completed")
Current status of the task. Must be either ‘needsAction’ (task is pending) or ‘completed’ (task is done).
boolean
Whether the task has been deleted. Deleted tasks are marked but not immediately removed. Default: false
string
required
Identifier of the Google Task to be fully replaced within the specified task list. This must also be included in the ‘id’ field of the request body.
string
Position of the task among siblings. This field is read-only. Use the ‘move’ method to change position.
string
Date/time when the task was marked as completed. Only applicable when status=‘completed’. Unlike ‘due’, this field preserves the time component. Accepts RFC3339 format.
string
required
Identifier of the Google Task list that contains the task to be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_TASK_LISTUpdates the authenticated user’s specified task list.

Input Parameters

string
required
Title of the task list. Maximum length allowed: 1024 characters.
string
required
Task list identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_TEAM_DRIVETool to update a Team Drive’s metadata. Deprecated: Use the drives.update endpoint instead. Use when you need to modify Team Drive properties.

Input Parameters

string
The name of this Team Drive.
string
The ID of the theme from which the background image and color will be set. This is a write-only field; it can only be set on requests that don’t set colorRgb or backgroundImageFile.
string
The color of this Team Drive as an RGB hex string. It can only be set on a drive.teamdrives.update request that does not set themeId.
string
required
The ID of the Team Drive to update.
object
A set of restrictions that apply to this Team Drive or items inside this Team Drive.
object
An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field; it can only be set on drive.teamdrives.update requests that don’t set themeId.
boolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_VACATION_SETTINGSTool to update vacation responder settings for a Gmail user. Use when you need to configure out-of-office auto-replies.

Input Parameters

string
The user’s email address. The special value ‘me’ can be used to indicate the authenticated user.
string
An optional end time for sending auto-replies (epoch ms). When this is specified, Gmail will automatically reply only to messages that it receives before the end time. If both startTime and endTime are specified, startTime must precede endTime.
string
An optional start time for sending auto-replies (epoch ms). When this is specified, Gmail will automatically reply only to messages that it receives after the start time. If both startTime and endTime are specified, startTime must precede endTime.
boolean
Flag that controls whether Gmail automatically replies to messages.
string
Optional text to prepend to the subject line in vacation responses. In order to enable auto-replies, either the response subject or the response body must be nonempty.
string
Response body in HTML format. Gmail will sanitize the HTML before storing it. If both response_body_plain_text and response_body_html are specified, response_body_html will be used.
boolean
Flag that determines whether responses are sent to recipients who are outside of the user’s domain. This feature is only available for Google Workspace users.
boolean
Flag that determines whether responses are sent to recipients who are not in the user’s list of contacts.
string
Response body in plain text format. If both response_body_plain_text and response_body_html are specified, response_body_html will be used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPDATE_VALUES_BATCHTool to set values in one or more ranges of a spreadsheet. Use when you need to update multiple ranges in a single operation for better performance.

Input Parameters

array
required
The new values to apply to the spreadsheet. Each ValueRange specifies a range and the values to write to that range. Multiple ranges can be updated in a single request.
string
required
The ID of the spreadsheet to update. This ID can be found in the URL of the spreadsheet (e.g., https://docs.google.com/spreadsheets/d/&#123;spreadsheet_id&#125;/edit). Must be a valid Google Sheets spreadsheet ID.
string ("INPUT_VALUE_OPTION_UNSPECIFIED" | "RAW" | "USER_ENTERED")
required
How the input data should be interpreted. RAW: Values are stored exactly as entered, without parsing. USER_ENTERED: Values are parsed as if typed by a user (numbers stay numbers, strings prefixed with ’=’ become formulas, etc.). INPUT_VALUE_OPTION_UNSPECIFIED: Default input value option is not specified.
boolean
Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
Determines how values in the response should be rendered. Only used if includeValuesInResponse is true. FORMATTED_VALUE (default): Values are formatted as displayed in the UI. UNFORMATTED_VALUE: Values are unformatted. FORMULA: Formulas are not evaluated.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
Determines how dates, times, and durations in the response should be rendered. Only used if includeValuesInResponse is true. SERIAL_NUMBER (default): Dates are returned as numbers. FORMATTED_STRING: Dates are returned as formatted strings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPLOAD_CALL_CONVERSIONSUpload offline call conversions to Google Ads, or validate them without uploading using validate_only. Inspect partial_failure_error for row failures even when the request succeeds.

Input Parameters

array
required
Call conversions to upload. Google validates individual conversion fields.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validate without uploading conversions. Only errors, not results, are returned. Defaults to false at Google.
boolean
Required provider flag; Google recommends true. Successful conversions are processed and invalid rows return partial_failure_error. False makes the batch atomic.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPLOAD_CLICK_CONVERSIONSUpload offline click conversions with optional enhanced-conversion identifiers, consent, and cart data. Restricted to existing allowlisted upload integrations; new integrations should use the Data Manager API. This records conversions unless validate_only is true. Inspect partial_failure_error for row failures even on HTTP 200; validate-only does not return conversion results.

Input Parameters

integer
Optional batch job ID in [0, 2^31). If omitted, Google generates an ID in [2^31, 2^63-1].
array
required
Click conversions to upload.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validate without executing; only errors, not conversion results, are returned.
boolean
Google requires this option and recommends always true: valid conversions succeed while invalid rows return errors. False requests atomic processing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPLOAD_CONVERSION_ADJUSTMENTSUpload retractions, restatements, or enhancements of existing conversions. Set validate_only=true to check without changing conversions. Inspect partial_failure_error even when HTTP succeeds.

Input Parameters

integer
Optional batch job ID in [0, 2^31). If omitted Google generates an ID in [2^31, 2^63-1].
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
boolean
If true, validate without executing adjustments; no results are returned. Defaults to false at the provider.
boolean
Required provider option; should always be true. Valid rows succeed and invalid rows appear in partial_failure_error.
array
required
Conversion adjustments to upload.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPLOAD_DRIVE_FILEUpload a file of 5 MiB or less to Google Drive using multipart upload.

Input Parameters

object
required
File content to upload using multipart upload; maximum 5 MiB.
string
Drive filename. Defaults to the uploaded file’s name.
string
Drive partial-response field selector for the created File resource.
string
Media MIME type. Defaults to the uploaded file’s MIME type or application/octet-stream.
string
Description to store in the Drive file metadata.
string
ID of the Drive folder that should contain the uploaded file.
boolean
Whether the request supports both My Drive and shared drives.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPLOAD_FILEUpload a new file to Google Drive, optionally placing it in a specified folder. If no folder ID is provided, it is uploaded to the Drive root.

Input Parameters

object
required
File to upload to Google Drive (max 5MB). Use a clear filename and accurate MIME type, for example application/pdf; incorrect values can cause Drive to convert or misrender the file.
string
Optional ID of the target Google Drive folder; can be obtained using ‘Find Folder’ or similar actions. Invalid or missing IDs silently fall back to Drive root with no error — resolve the correct folder ID first using GOOGLEDRIVE_FIND_FILE.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPLOAD_FROM_URLTool to fetch a file from a provided URL server-side and upload it into Google Drive. Use when you need to reliably persist externally hosted files into Drive without client-side downloads or temporary storage.

Input Parameters

string
required
Name for the file in Google Drive, including extension (e.g., ‘report.pdf’, ‘image.png’).
string
Target MIME type for the file in Google Drive. If not specified, Drive auto-detects from content. Google Workspace MIME types (application/vnd.google-apps.*) trigger automatic conversion from compatible source formats: google-apps.document converts Word/ODT/HTML/RTF/TXT/PDF/images (OCR); google-apps.spreadsheet converts Excel/ODS/CSV/TSV; google-apps.presentation converts PowerPoint/ODP. Conversion requires the source content to be in a compatible format. Incompatible formats will cause upload errors.
string
required
HTTPS URL of the file to download and upload to Google Drive. Must be publicly accessible or include necessary authentication in source_headers.
boolean
Whether to verify SSL certificates when downloading from HTTPS URLs. Set to false to bypass SSL verification for URLs with certificate issues (expired certificates, hostname mismatches, self-signed certificates). Only disable for trusted sources.
object
Optional HTTP headers to include when downloading from source_url. Use for authentication tokens, signed URLs, or CDN-specific headers.
string
ID of the parent folder in Google Drive. If not specified, the file will be uploaded to the root of My Drive.
boolean
Whether the request supports both My Drives and shared drives. Defaults to true for broader compatibility.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPLOAD_MEDIAUpload an image or video to Google Photos from a file or public URL and create a media item. Uploading requires the photoslibrary.appendonly authorization scope, which is not included in the default connection scopes.

Input Parameters

string
Public URL of the media file to upload (must be directly accessible). The action will download the file from this URL and upload it to Google Photos. Alternative to ‘file_to_upload’. Supported formats: images (JPEG, PNG, GIF, HEIC, etc.) and videos (MP4, MOV, etc.).
string
File name for the uploaded media. Required when using ‘url’ parameter. Should include the file extension (e.g., ‘photo.jpg’, ‘video.mp4’).
string
Optional description for the media item
object
The media file to upload to Google Photos.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPLOAD_UPDATE_FILETool to update file content in Google Drive by uploading new binary content. Use when you need to replace the contents of an existing file with new file data.

Input Parameters

string
required
The ID of the file to update with new content.
string
Comma-separated list of parent folder IDs to add.
string
The type of upload request. ‘media’ for simple upload (content only), ‘multipart’ for metadata + content, ‘resumable’ for large files.
string
Language hint for OCR processing (ISO 639-1 code, e.g., ‘en’).
string
Comma-separated list of parent folder IDs to remove.
object
required
The file content to upload.
boolean
Whether the app supports both My Drives and shared drives. Defaults to true.
boolean
Whether to set the ‘keepForever’ field in the new head revision.
boolean
Whether to use the uploaded content as indexable text for search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPLOAD_USER_DATAAppend or remove already-hashed user data in a Google Ads Customer Match list. This endpoint performs real uploads: it has no validation-only or partial-failure mode. Supply consent as appropriate; per-user consent overrides list metadata. Uploads through this service are not visible in the UI’s Segment members section. Requires an existing Google-approved Customer Match upload integration; new integrations should use Data Manager audience ingestion instead.

Input Parameters

array
required
Required list of create/remove user data operations.
string
Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer_id.
object
Target Customer Match list and default consent settings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_UPSERT_ROWSUpserts rows in a Google Sheet by matching a key column: updates matching rows and appends new ones. It maps columns by header name, adds missing columns, and supports partial updates.

Input Parameters

array
required
2D array of data rows to upsert. IMPORTANT: If ‘headers’ is NOT provided, the FIRST row is treated as column headers and remaining rows as data - so you need at least 2 rows (1 header + 1 data). If ‘headers’ IS provided separately, then ALL rows in this array are treated as data rows. Each row should have the same number of values as headers. If a row has MORE values than headers: with strict_mode=true (default), an error is returned showing which rows are affected; with strict_mode=false, extra values are silently truncated. If a row has FEWER values than headers, an error is returned during execution. Cell values can be strings, numbers, booleans, or null. Example with headers provided: headers=[‘Email’,‘Status’], rows=[[‘john@ex.com’,‘Active’]] (1 data row). Example without headers: rows=[[‘Email’,‘Status’],[‘john@ex.com’,‘Active’]] (row 1 = headers, row 2 = data).
array
List of column names for the data. These will be matched against sheet headers. If a column doesn’t exist in the sheet, it will be added automatically. Order doesn’t need to match sheet order. Can be auto-derived from the first row in ‘rows’ if not provided. Example inputs: [‘Email’, ‘Phone’, ‘Status’] for contact updates, [‘Lead ID’, ‘Name’, ‘Score’] for CRM, [‘SKU’, ‘Stock’, ‘Price’] for inventory.
string
The column NAME (header text) to use as unique identifier for matching rows. Must be an actual header name from the sheet (e.g., ‘Email’, ‘Lead ID’, ‘SKU’), NOT a column letter (e.g., ‘A’, ‘B’, ‘C’). If you provide a column letter like ‘A’, it will be automatically converted to the header name at that column position. If neither ‘key_column’ nor ‘key_column_index’ is provided, defaults to the first column (index 0).
string
required
The name of the sheet/tab within the spreadsheet. Note: Google Sheets creates default sheets with localized names based on account language (e.g., ‘Sheet1’ for English, ‘工作表1’ for Chinese, ‘Hoja1’ for Spanish, ‘Feuille1’ for French, ‘Planilha1’ for Portuguese, ‘Лист1’ for Russian). If you specify a common default name and the sheet is not found, the action will automatically use the first sheet if only one exists.
boolean
Controls how rows with mismatched column counts are handled. When True (default), an error is returned if any row has more values than headers - the error message shows exactly which rows are affected and what values would need to be removed. When False, extra values are silently truncated to match the header count. Set to False only if you explicitly want automatic truncation of extra values.
string
Cell where the table starts (where headers are located). Defaults to ‘A1’. Use this if your table is offset (e.g., ‘C5’, ‘D10’).
string
required
The ID of the spreadsheet. Must be a non-empty string, typically a 44-character alphanumeric string found in the spreadsheet URL.
string
The 0-based column index to use as unique identifier for matching rows. Alternative to ‘key_column’ - will be converted to column name using headers. If neither ‘key_column’ nor ‘key_column_index’ is provided, defaults to 0 (first column). Example: 0 for first column, 1 for second column.
string
Internal field to track input normalization (e.g., row truncation). Not part of API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_VALIDATE_EVENTSValidate Measurement Protocol events for a web stream before sending them to production, checking event structure and parameters.

Input Parameters

array
required
Required. Array of events to validate. Each event must have a ‘name’ field and optional ‘params’ object.
Optional. The consent state for the user.
string
Optional. A unique identifier for a user.
string
required
Required. Unique client identifier. This uniquely identifies a user instance of a web client.
string
required
Required. The API secret from Google Analytics for the Measurement Protocol.
string
required
Required. The measurement ID for web streams. Format: G-XXXXXXXXXX where X is alphanumeric.
object
Optional. The user properties for the measurement.
string
Optional. A Unix timestamp (in microseconds) for the time to associate with the event.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_VALUES_GETReturns a range of values from a spreadsheet. Use when you need to read data from specific cells or ranges in a Google Sheet.

Input Parameters

string
required
The A1 notation or R1C1 notation of the range to retrieve values from. If the sheet name contains spaces or special characters, wrap the sheet name in single quotes (e.g., “‘My Sheet’!A1:B2”). Without single quotes, the API will return a 400 error for sheet names with spaces. Examples: ‘Sheet1!A1:B3’, “‘Sheet With Spaces’!A1:D5”, ‘A1:D5’ (no sheet name uses first visible sheet), ‘Sheet1!A:A’ (entire column), ‘SheetName’ (entire sheet).
integer
1-based row number to stop reading at (inclusive). Use with start_row for pagination to avoid large response errors. Example: start_row=501, end_row=1000 fetches rows 501-1000.
integer
1-based row number to start reading from (inclusive). Use with end_row for pagination to avoid large response errors. Example: start_row=1, end_row=500 fetches the first 500 rows.
string
required
The unique identifier of the Google Spreadsheet from which to retrieve values. This is the long alphanumeric string found in the spreadsheet URL between ‘/d/’ and ‘/edit’ (e.g., ‘1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms’). WARNING: Do NOT use the spreadsheet name or title (e.g., ‘My Sales Report’); you must use the actual ID from the URL.
string ("DIMENSION_UNSPECIFIED" | "ROWS" | "COLUMNS")
The major dimension for results.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How values should be rendered in the output. FORMATTED_VALUE: Values are calculated and formatted (default). UNFORMATTED_VALUE: Values are calculated but not formatted. FORMULA: Values are not calculated; the formula is returned instead.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How dates, times, and durations should be represented in the output. SERIAL_NUMBER: Dates are returned as serial numbers (default). FORMATTED_STRING: Dates returned as formatted strings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_VALUES_UPDATESets or overwrites values in a Google Spreadsheet range, adjusting the range to fit the supplied values and potentially expanding the sheet by default. Unmatched common default sheet names may resolve to the first sheet.

Input Parameters

string
required
The A1 notation of the range to update values in (e.g., ‘Sheet1!A1:C2’, ‘MySheet!C:C’, or ‘A1:D5’). Wrap sheet names containing spaces or special characters in single quotes; escape an apostrophe within a quoted sheet name by doubling it (e.g., ”‘[Draft] Fall”26’!A1:B2”). Must be actual cell references, not placeholder values. If the sheet name is omitted (e.g., ‘A1:B2’), the operation applies to the first visible sheet. IMPORTANT: The range must not exceed the sheet’s grid dimensions. By default, new sheets have 1000 rows and 26 columns (A-Z). If you need to write to columns beyond Z (e.g., AA, AB), first expand the sheet using GOOGLESHEETS_APPEND_DIMENSION or check the current dimensions using GOOGLESHEETS_GET_SPREADSHEET_INFO.
array
required
The data to write. This is an array of arrays, the outer array representing all the data and each inner array representing a major dimension. Each item in the inner array corresponds with one cell.
string
required
The unique identifier of the Google Spreadsheet to update. This ID can be found in the URL of the spreadsheet (e.g., https://docs.google.com/spreadsheets/d/&#123;spreadsheet_id&#125;/edit). Must be a non-empty string.
string ("ROWS" | "COLUMNS")
The major dimension of the values. ROWS (default) means each inner array is a row of values. COLUMNS means each inner array is a column of values. Defaults to ROWS if unspecified.
boolean
If True (default), automatically expands the sheet’s dimensions (adds columns/rows) when the target range exceeds the current grid limits. If False, the operation will fail with an error if the range exceeds grid limits.
string ("RAW" | "USER_ENTERED")
required
How the input data should be interpreted. RAW: Values are stored exactly as entered, without parsing (dates, formulas, etc. remain as strings). USER_ENTERED: Values are parsed as if typed by a user (numbers stay numbers, strings prefixed with ’=’ become formulas, etc.).
boolean
Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
Determines how values in the response should be rendered. Only used if includeValuesInResponse is true. FORMATTED_VALUE (default): Values are formatted as displayed in the UI. UNFORMATTED_VALUE: Values are unformatted (numbers, booleans, formulas). FORMULA: Formulas are not evaluated and remain as text.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
Determines how dates, times, and durations in the response should be rendered. Only used if includeValuesInResponse is true. SERIAL_NUMBER (default): Dates are returned as numbers. FORMATTED_STRING: Dates are returned as strings formatted per the cell’s locale.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_WATCH_CHANGESSubscribe to Google Drive changes for a user or shared drive and receive notifications at a webhook URL. Supply a start or continuation page token; notifications may cover multiple changes, so fetch changes since the last known token.

Input Parameters

string
required
A unique string that identifies this channel. UUIDs are recommended. Must be unique per active channel; reusing an ID can cause missed, delayed, or duplicate notifications.
string
required
The type of delivery mechanism for notifications.
string
An arbitrary string that will be delivered with each notification. Can be used for verification.
object
Optional parameters for the notification channel. Example: {“additional_properties”: {“ttl”: “3600”}} for a 1-hour time-to-live (actual support depends on Google API).
string
A comma-separated list of spaces to query within the corpora. Supported values are ‘drive’ and ‘appDataFolder’.
string
required
The URL where notifications are to be delivered. Must be a publicly reachable HTTPS URL with a valid SSL certificate; HTTP, localhost, and private network endpoints are rejected by the API.
string
The shared drive from which changes will be returned. If specified, change IDs will be specific to the shared drive.
integer
The maximum number of changes to return per page.
integer
Timestamp in milliseconds since the epoch for when the channel should expire. If not set, channel may not expire or have a default expiration. Channels are invalidated after expiry; re-establish the watch with a new channel before or after expiration to avoid missed changes.
string
The token for continuing a previous list request on the next page. This should be set to the value of ‘nextPageToken’ from the previous response or to the response from the getStartPageToken method. Persist this token per channel so change processing can resume correctly after restarts or interruptions.
string
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
boolean
Whether to include changes indicating that items have been removed from the list of changes (e.g., by deletion or loss of access).
boolean
Whether the requesting application supports both My Drives and shared drives. Recommended to set to true if driveId is used or if interactions with shared drives are expected.
boolean
Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files like those in the Application Data folder or shared files not added to My Drive.
boolean
Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes.
string
Specifies which additional view’s permissions to include in the response.
boolean
Whether both My Drive and shared drive items should be included in results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_WATCH_FILETool to subscribe to push notifications for changes to a specific file. Use when you need to monitor a file for modifications and receive real-time notifications at a webhook URL.

Input Parameters

string
required
A UUID or similar unique string that identifies this notification channel (max 64 characters).
string ("web_hook" | "webhook")
required
The type of delivery mechanism used for this channel.
string
An arbitrary string delivered to the target address with each notification for verification (max 256 characters).
string
required
The ID of the file to watch for changes.
object
Additional parameters controlling delivery channel behavior.
string
required
The HTTPS address where notifications are delivered for this channel. Must have a valid SSL certificate.
boolean
Whether payload data should be included in notifications.
integer
Date and time of notification channel expiration as Unix timestamp in milliseconds. Default: 3600 seconds, max: 86400 seconds for files.
string
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
boolean
Whether the user is acknowledging the risk of downloading known malware or other abusive files. Only applicable to file owner/organizer.
boolean
Whether the requesting application supports both My Drives and shared drives.
boolean
Deprecated. Use supportsAllDrives instead.
string
Specifies which additional view’s permissions to include in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_WHO_AM_IReturn the identity (email, name) of the connected Gmail account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLESUPER_WRITE_SPREADSHEET_VALUESReplace values in one range of a Google spreadsheet.

Input Parameters

string
required
The A1 notation range whose values to replace, such as ‘Sheet1!A1:B2’.
array
required
A matrix of string, number, boolean, or null cell values. Each inner list follows major_dimension.
string
required
The ID of the Google spreadsheet to update.
string ("ROWS" | "COLUMNS")
How the values matrix is oriented. Defaults to ROWS when omitted.
string ("RAW" | "USER_ENTERED")
required
Required interpretation mode. RAW stores values as supplied; USER_ENTERED parses them as if entered in Google Sheets.
boolean
Whether the response should include the values written in updatedData.
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How values in updatedData are rendered when updated values are included.
string ("SERIAL_NUMBER" | "FORMATTED_STRING")
How dates, times, and durations in updatedData are rendered when updated values are included.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: GOOGLESUPER_AGGREGATE_METRIC_CHANGED_TRIGGERType: pollTriggers when an aggregate metric (SUM/COUNT/AVG/MIN/MAX) changes in a Google Sheets spreadsheet. This trigger monitors an aggregate calculation on a target column (optionally filtered by a search column/value) and fires when the calculated result changes.

Configuration

boolean
Whether the search should be case-sensitive when filtering by search_column and search_value.
boolean
Whether the first row contains column headers. If True, column names can be used for search_column and target_column.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The mathematical operation to perform on the target column values. Supported operations: sum, average, count, min, max, percentage.
number
For percentage operation, the total value to calculate percentage against. If not provided, uses sum of all values in target column.
string
The column to search in for filtering rows. Can be a letter (e.g., ‘A’, ‘B’) or column name from header row (e.g., ‘Region’, ‘Department’). If not provided, all rows in the target column will be aggregated without filtering.
string
The exact value to search for in the search column. Case-sensitive by default. If not provided (or if search_column is not provided), all rows in the target column will be aggregated without filtering.
string
required
The name of the specific sheet within the spreadsheet to monitor. Matching is case-insensitive. If no exact match is found, partial matches will be attempted (e.g., ‘overview’ will match ‘Overview 2025’).
string
required
The unique identifier of the Google Sheets spreadsheet to monitor. This is the long alphanumeric string found in the spreadsheet URL between ‘/d/’ and ‘/edit’.
string
required
The column to aggregate data from. Can be a letter (e.g., ‘C’, ‘D’) or column name from header row (e.g., ‘Sales’, ‘Revenue’).

Payload

number
required
The current aggregate metric value
string
required
ISO timestamp when the change was detected
string
Type of event that occurred
integer
required
Number of rows that matched the search condition
string
required
The aggregation operation performed
number
required
The previous aggregate metric value
integer
required
Number of values that were processed in the aggregation
object
required
Details of the search/filter used to select rows prior to aggregation
string
required
The sheet name
string
required
The spreadsheet ID
Slug: GOOGLESUPER_ATTENDEE_RESPONSE_CHANGED_TRIGGERType: pollPolling trigger that fires when any attendee’s RSVP changes to accepted, declined, or tentative. Returns attendee info and current status.

Configuration

string
The unique identifier for the calendar
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
Whether to include deleted events in the results

Payload

string
Email of the attendee whose RSVP changed
string
Display name of the attendee
string
required
The calendar identifier
Link to the event in Google Calendar
string
required
The unique identifier of the event
string
Event title/summary
string
Previous RSVP status
string
required
Current RSVP status (accepted, declined, tentative)
Slug: GOOGLESUPER_CELL_RANGE_VALUES_CHANGED_TRIGGERType: pollTriggers when values in a specified A1 range change in Google Sheets. This trigger monitors a specific cell or range of cells and fires when any values change.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The A1 notation of the range to monitor for changes (can be a single cell or multi-cell range). If the sheet name contains spaces or special characters, wrap the sheet name in single quotes.
string
required
The unique identifier of the Google Spreadsheet to monitor. This is the long alphanumeric string found in the spreadsheet URL between ‘/d/’ and ‘/edit’.

Payload

array
required
The current values in the range
string
required
ISO timestamp when the change was detected
string
Type of event that occurred
array
required
The previous values in the range
string
required
The A1 notation of the monitored range
string
required
The spreadsheet ID
Slug: GOOGLESUPER_COMMENT_ADDED_TRIGGERType: pollTriggers when a new comment is added to Google Docs, Sheets, or Slides.

Configuration

string
If provided, monitor comments only for this specific file ID. If omitted, the trigger scans recent Docs/Sheets/Slides files for new comments.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of recent Docs/Sheets/Slides files to inspect in each poll when no file ID is specified. Values above 100 are clamped at runtime to protect Drive quota — comments.list is a per-file fanout.

Payload

string
required
The ID of the comment
string
The plain text content of the comment
object
Information about the commenter (displayName, permissionId, photoLink, me).
string
The time the comment was created (RFC 3339)
string
required
The ID of the file on which the comment was added
Slug: GOOGLESUPER_CONDITIONAL_FORMAT_RULE_CHANGED_TRIGGERType: pollTriggers when conditional formatting rules change in a Google Spreadsheet. Detects when rules are added, updated, or removed. Uses snapshot-based diffing to detect changes between polls.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Optional filter: monitor only the sheet with this exact numeric sheetId. If not provided, monitors all sheets. If both sheet_title and sheet_id are provided, sheet_id takes precedence.
string
Optional filter: monitor only the sheet with this exact title. If not provided, monitors all sheets.
string
required
The unique identifier of the Google Spreadsheet to monitor for conditional formatting rule changes

Payload

string
required
Type of change: ‘added’, ‘updated’, or ‘removed’
string
required
ISO timestamp when the change was detected
array
required
List of rules that changed
string
required
The spreadsheet ID
Slug: GOOGLESUPER_DATA_VALIDATION_RULE_CHANGED_TRIGGERType: pollTriggers when data validation rules change (added/updated/removed) in a Google Spreadsheet. Uses snapshot-based diffing to detect changes between polls.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
array
Optional list of A1 ranges to monitor. If omitted, the entire sheet(s) will be monitored.
integer
Optional sheet ID to filter by. If omitted, all sheets will be monitored.
string
Optional sheet title to filter by. If omitted, all sheets will be monitored.
string
required
The unique identifier of the Google Spreadsheet to monitor for data validation rule changes.

Payload

string
required
Type of change: ‘added’, ‘updated’, or ‘removed’
string
required
ISO timestamp when the change was detected
array
required
List of validation rules that changed
string
required
The spreadsheet ID
Slug: GOOGLESUPER_DEVELOPER_METADATA_CHANGED_TRIGGERType: pollTriggers when developer metadata entries change (new/updated/removed) in a Google Spreadsheet. Uses snapshot-based diffing to detect changes between polls.

Configuration

array
The data filters describing the criteria used to determine which DeveloperMetadata entries to monitor. If not specified, monitors all developer metadata.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The unique identifier of the Google Spreadsheet to monitor for developer metadata changes.

Payload

string
required
Type of change: ‘created’, ‘updated’, or ‘removed’
string
required
ISO timestamp when the change was detected
array
required
List of metadata items that changed
string
required
The spreadsheet ID
Slug: GOOGLESUPER_DOCUMENT_CREATED_TRIGGERType: pollTriggers when a new Google Doc is created. This trigger monitors Google Docs and fires when new documents are detected. Uses timestamp filtering to efficiently poll for new documents.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of documents to check in each poll (1-1000)
string
Optional search query to filter documents. Can search by name (name contains ‘report’), full text content (fullText contains ‘important’), or use complex queries with operators like ‘and’, ‘or’, ‘not’. Leave empty to monitor all documents.

Payload

object
required
The newly created Google document
string
Type of event that occurred
Slug: GOOGLESUPER_DOCUMENT_DELETED_TRIGGERType: pollTriggers when an existing Google Doc is deleted (moved to trash). This trigger monitors Google Docs and fires when documents are trashed.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of documents to check in each poll (1-1000)
string
Optional search query to filter documents. Leave empty to monitor all documents for deletion.

Payload

object
required
The deleted Google document
string
Type of event that occurred
Slug: GOOGLESUPER_DOCUMENT_PLACEHOLDER_FILLED_TRIGGERType: pollTriggers when a Google Doc’s plain text changes such that a configured placeholder token/pattern is no longer present (i.e., the document has been filled in).This trigger monitors a specific Google Doc and fires when a placeholder pattern that was previously present is no longer found in the document’s plain text.

Configuration

boolean
Whether the placeholder pattern matching should be case-sensitive.
string
required
The unique identifier for the Google Document to monitor. Accepts either a document ID (typically a 44-character alphanumeric string) or a full Google Docs URL.
boolean
Whether to include footer text when checking for placeholders.
boolean
Whether to include footnote text when checking for placeholders.
boolean
Whether to include header text when checking for placeholders.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The placeholder token/pattern to monitor (e.g., ‘{{NAME}}’, ‘[FILL_ME]’, ‘TODO’). Can be a literal string or a regex pattern if use_regex is enabled.
boolean
If true, treat placeholder_pattern as a regex pattern. If false, treat it as a literal string.

Payload

object
required
The document that was filled in
string
Type of event that occurred
string
required
The placeholder pattern that is no longer present
Slug: GOOGLESUPER_DOCUMENT_SEARCH_UPDATE_TRIGGERType: pollTriggers when a Google Doc matching a user-defined search query is newly created or updated since the last poll. This trigger uses timestamp filtering to efficiently monitor documents.

Configuration

boolean
Whether to include documents from shared drives you have access to. Defaults to True.
boolean
Whether to include documents in trash. Defaults to False.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of documents to check in each poll (1-100)
string
required
Search query to filter documents. Provide either: (1) Plain text to search in document content (e.g., ‘quarterly report’), which will search fullText, or (2) Drive API query syntax with operators like ‘name contains’, ‘fullText contains’, combined with ‘and’, ‘or’, ‘not’.
boolean
Whether to return only documents shared with the current user. Defaults to False.
boolean
Whether to return only starred documents. Defaults to False.

Payload

object
required
The document that was created or updated
string
required
Type of event that occurred: ‘document_created’ or ‘document_updated’
Slug: GOOGLESUPER_DOCUMENT_STRUCTURE_CHANGED_TRIGGERType: pollTriggers when a Google Doc’s structure changes (headers/footers added/removed, tables/images count changes). This trigger monitors a specific document for structural changes like:
  • Headers added or removed
  • Footers added or removed
  • Tables added or removed
  • Images (inline objects) added or removed
  • Positioned objects added or removed
  • Footnotes added or removed

Configuration

string
required
The unique identifier for the Google Docs document to monitor. You can provide either a document ID or a full Google Docs URL.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.

Payload

array
required
List of structural changes detected
object
required
Current structural snapshot of the document
string
required
ID of the document that changed
string
required
Title of the document
string
required
URL to view the document
object
Snapshot of document structural elements.
Slug: GOOGLESUPER_DOCUMENT_UPDATED_TRIGGERType: pollTriggers when an existing Google Doc is updated or modified. This trigger monitors Google Docs and fires when documents are updated.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of documents to check in each poll (1-1000)
string
Optional search query to filter documents. Leave empty to monitor all documents.

Payload

object
required
The updated Google document
string
Type of event that occurred
Slug: GOOGLESUPER_DOCUMENT_WORD_COUNT_THRESHOLD_TRIGGERType: pollTriggers when a Google Doc’s word/character count crosses a user-defined threshold. This trigger monitors a specific Google Doc and fires when its word or character count becomes greater than or equal to the configured threshold value.

Configuration

string
required
The unique identifier for the Google Document to monitor. Accepts either a document ID (typically a 44-character alphanumeric string) or a full Google Docs URL. When a URL is provided, the document ID will be automatically extracted.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
If True, use character count instead of word count for the threshold comparison.
integer
The word count threshold. Trigger fires when the document’s word count becomes greater than or equal to this value.

Payload

integer
required
The current character count of the document
integer
required
The current word count of the document
string
required
The unique identifier of the document
string
required
The title of the document
string
Type of event that occurred
integer
required
The previous character count of the document
integer
required
The previous word count of the document
integer
required
The configured threshold value
string
required
Whether the threshold is for ‘words’ or ‘characters’
Link to view the document in browser
Slug: GOOGLESUPER_EMAIL_SENT_TRIGGERType: pollTriggers when a Gmail message is sent by the authenticated user. It polls the ‘SENT’ label and emits metadata including sender, recipients, subject, timestamp, and thread ID.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
Optional additional Gmail search query to further filter sent messages. Uses Gmail search syntax (e.g., to:example@domain.com subject:report).
string
The user’s email address or ‘me’ for the authenticated user.

Payload

array
The list of attachments in the sent message
string
Bcc recipients
string
Cc recipients
string
Gmail message ID
string
The text of the sent message
string
Timestamp of the sent message in ISO format
object
Raw Gmail payload
string
Comma-separated list of all recipients (To, Cc, Bcc)
string
Sender email
string
Email subject
string
Gmail thread ID
string
To recipients
Slug: GOOGLESUPER_EVENT_CANCELED_DELETED_TRIGGERType: pollTriggers when a Google Calendar event is cancelled or deleted. Returns minimal data: event_id, summary (if available), and cancellation timestamp.

Configuration

string
The unique identifier for the calendar to monitor
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.

Payload

string
Cancellation timestamp (from event.updated)
string
required
The unique identifier of the event
string
Event title/summary (may be missing for cancelled events)
Slug: GOOGLESUPER_EVENT_STARTING_SOON_TRIGGERType: pollTriggers when a calendar event is within a configured number of minutes from starting. Returns event details, time remaining, attendees, and join links when available.

Configuration

string
The unique identifier for the calendar to monitor
integer
Look-ahead window (in minutes) for upcoming events to evaluate
boolean
Whether to consider all-day events (default False)
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Trigger when an event is within this many minutes from starting

Payload

array
List of attendees
string
required
The calendar identifier
integer
required
Countdown window used for this trigger
string
Email of the event creator
string
Event description
string
required
The unique identifier of the event
Google Meet link for the conference, if available
Link to the event in Google Calendar
string
Event location
number
Minutes remaining until event starts (>= 0)
string
Email of the event organizer
string
Event start time in ISO format
number
Event start time as UNIX epoch timestamp (UTC)
string
Event title/summary
Slug: GOOGLESUPER_FILE_CREATED_TRIGGERType: pollTriggers when a new file is created in Google Drive.

Configuration

string
If provided, monitor only files within this folder (by folder ID). Adds the filter 'folder_id' in parents to the query.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of newly-created files to emit in a single poll. Acts as an event cap, not an API page size — the trigger paginates Drive responses internally.
string
Optional Drive search query to filter files. Examples: name contains ‘report’, mimeType = ‘application/pdf’, or complex queries like name contains ‘project’ and mimeType != ‘application/vnd.google-apps.folder’. Leave empty to monitor all files.

Payload

object
Information about the file’s creator (derived as first owner if available)
string
Type of event that occurred
object
required
The newly created Google Drive file
Slug: GOOGLESUPER_FILE_DELETED_OR_TRASHED_TRIGGERType: pollTriggers when a file is moved to trash or permanently deleted in Drive.

Configuration

string
Optional shared drive ID to monitor. When unset, the trigger monitors My Drive plus shared drives surfaced by include_items_from_all_drives.
boolean
Include changes where the user lost access to the file (e.g. permission removal). When false, only true deletions and trash events surface.
boolean
Whether items from My Drive AND all visible shared drives should appear in results.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of changes per changes.list page (1-1000).
boolean
If true, restrict results to changes inside the My Drive hierarchy.
string
Comma-separated list of spaces to query. Supported values are ‘drive’ and ‘appDataFolder’.

Payload

string
required
Timestamp of the delete/trash event in RFC 3339 format
string
required
Type of deletion event. Either ‘trashed’ (soft-delete, recoverable from the user’s trash) or ‘removed’ (hard-delete or, when include_corpus_removals=true, access loss).
string
required
ID of the file that was deleted or trashed
string
Name of the file. May be absent when the file was permanently removed (the file resource is gone, only the change record remains).
Slug: GOOGLESUPER_FILE_SHARED_PERMISSIONS_ADDEDType: pollTriggers when new sharing permissions are granted to a file or folder.Uses Drive’s changes.list endpoint with inline permissions in the fields mask so each change carries the file’s current permission set provider-atomically. We diff that against seen_permission_keys to identify newly added grants. Drive page tokens are the primary cursor; if Drive rejects a stored token, the trigger raises PollingTriggerError without clearing state rather than silently re-baselining and dropping events.Limitation: truly ephemeral permissions (added and revoked between two polls without any other file modification in between) are not detected. Drive Activity API would catch those but requires an additional OAuth scope and a different payload contract.

Configuration

string
The shared drive ID to monitor. If omitted, monitors My Drive and any shared drives surfaced via include_items_from_all_drives.
string
If provided, only emit permission changes for this specific file or folder ID.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of changes to fetch per changes.list page (1-1000).
boolean
Whether to include both My Drive and shared drives when monitoring changes.

Payload

string
Type of event that occurred
array
List of newly detected permissions
Slug: GOOGLESUPER_FILE_UPDATED_TRIGGERType: pollTriggers when a file’s metadata or content changes in Google Drive.

Configuration

boolean
When true, fire only on content changes (new revision) and suppress metadata-only updates such as rename or move. Relies on headRevisionId, which Drive only exposes for binary files — Google-native docs (Docs/Sheets/Slides) do not carry headRevisionId and will not fire this trigger under content_only=true.
string
Optional shared drive ID to monitor. When unset, the trigger monitors My Drive plus shared drives surfaced by include_items_from_all_drives.
boolean
Whether items from My Drive AND all visible shared drives should appear in results.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of changes per changes.list page (1-1000).

Payload

string
required
The ID of the file that changed
object
Information about the last user who modified the file
string
The last time the file was modified (RFC 3339 date-time)
Slug: GOOGLESUPER_FILTERED_RANGE_VALUES_CHANGED_TRIGGERType: pollPolling trigger that monitors Google Sheets filtered ranges for value changes. Uses snapshot-based diffing to detect when values matching a data filter change. Emits the matched values when changes are detected.

Configuration

array
required
List of data filters specifying which ranges to monitor for changes. Each filter can specify either ‘a1Range’ (e.g., ‘Sheet1!A1:B10’) or ‘gridRange’.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string ("ROWS" | "COLUMNS")
The major dimension that results should use. ROWS returns [[1,2],[3,4]], COLUMNS returns [[1,3],[2,4]]
string
required
The unique identifier of the Google Spreadsheet to monitor
string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")
How values should be represented in the output

Payload

string ("created" | "updated" | "deleted")
required
Type of change detected
string
required
ISO timestamp when the change was detected
array
required
Current values in the range
array
Previous values in the range (None if new)
string
required
The A1 notation or identifier of the range that changed
string
required
The spreadsheet ID
Slug: GOOGLESUPER_FOLDER_CREATED_TRIGGERType: pollTriggers when a new folder is created in the root folder of Google Drive. This trigger monitors Google Drive and fires when new folders are detected in the root directory.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of folders to check in each poll (1-1000)

Payload

string
Type of event that occurred
object
required
The newly created Google Drive folder
Slug: GOOGLESUPER_GOOGLE_CALENDAR_EVENT_CHANGE_TRIGGERType: webhookSOON TO BE DEPRECATED - Use Calendar Event Sync (polling trigger) instead. Real-time webhook trigger for calendar event changes. Returns event metadata only. For full event data, use Calendar Event Sync (polling trigger).

Configuration

string
The unique identifier for the calendar
integer
The time-to-live in seconds for the notification channel

Payload

string
required
The unique identifier passed to identify this channel
string
required
The unique identifier of the resource
string
required
The state of the resource
string
required
The url for the resource
Slug: GOOGLESUPER_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGERType: pollPolling trigger that fires when a new calendar event is created. Returns event ID, summary, start/end times, and organizer info.

Configuration

string
The unique identifier for the calendar
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
Whether to include deleted events in the results

Payload

string
required
The calendar identifier
string
Event end time in ISO format
string
required
The unique identifier of the event
string
Email of the event organizer
string
Name of the event organizer
string
Event start time in ISO format
string
Event title/summary
Slug: GOOGLESUPER_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGERType: pollPolling trigger that returns full event data including details, attendees, and metadata. For real-time notifications with basic info, use Calendar Event Changes (webhook).

Configuration

string
The unique identifier for the calendar
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
Whether to include deleted events in the results

Payload

array
List of attendees
string
required
The calendar identifier
object
Conference data structure containing details about the meeting
string
When the event was created
string
Email of the event creator
string
Name of the event creator
string
Event description
string
Event end time in ISO format
string
required
The unique identifier of the event
string
required
Type of change: created, updated, or deleted
Google Meet link for the conference, if available
Link to the event in Google Calendar
string
Event location
string
Email of the event organizer
string
Name of the event organizer
string
ID of recurring event if applicable
string
Event start time in ISO format
string
Event status (confirmed, tentative, cancelled)
string
Event title/summary
string
When the event was last updated
string
Event visibility
Slug: GOOGLESUPER_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGERType: pollTriggers when an existing Google Calendar event is modified. Returns the event ID, change type, and the specific fields that changed with their previous and new values.

Configuration

string
The unique identifier for the calendar
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
Whether to include deleted (cancelled) events in the results
array
List of event fields to track for changes. start and end are compared as RFC3339 strings (preferring dateTime over date). Attendees are compared by email, displayName, responseStatus, and optional flag.

Payload

string
required
The calendar identifier
string
Type of change. Always ‘updated’ for this trigger
string
required
The unique identifier of the event
string
When the event was last updated (RFC3339)
object
required
Dictionary of changed fields with old and new values
Slug: GOOGLESUPER_GOOGLE_DRIVE_CHANGESType: pollTriggers when changes are detected in a Google Drive.

Configuration

string
Optional shared drive ID to monitor. When unset, the trigger monitors the user’s My Drive plus any shared drives surfaced by include_items_from_all_drives.
boolean
Whether items from My Drive AND all visible shared drives should appear in results. Required for shared-drive coverage.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
If true, restrict results to changes inside the My Drive hierarchy even when include_items_from_all_drives is true.
string
Comma-separated list of spaces to query. Supported values are ‘drive’ and ‘appDataFolder’.
Slug: GOOGLESUPER_KEYWORD_DETECTED_TRIGGERType: pollTriggers when a specific keyword or phrase first appears in a Google Doc. This trigger monitors a Google Doc and fires once when the specified keyword is detected. After the keyword is found, the trigger will not fire again until reset.

Configuration

boolean
Whether the keyword search should be case-sensitive. Set to False to ignore case when matching.
string
required
The unique identifier for the Google Document to monitor. Accepts either a document ID (typically a 44-character alphanumeric string) or a full Google Docs URL.
boolean
Whether to include footer text when searching for the keyword.
boolean
Whether to include footnote text when searching for the keyword.
boolean
Whether to include header text when searching for the keyword.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The keyword or phrase to detect in the document (case-sensitive). The trigger will fire when this text first appears anywhere in the document’s plain text.

Payload

string
required
The ID of the document
string
required
The title of the document
string
required
Web view link to the document in Google Docs
string
Type of event that occurred
string
required
The keyword that was detected
string
required
A short excerpt of the document text around the keyword (max 500 chars)
Slug: GOOGLESUPER_NEW_FILE_MATCHING_QUERY_TRIGGERType: pollTriggers when a new Google Drive file matches a provided query.This is the legacy query-centric trigger: it preserves Drive API query config such as corpora / driveId aliases and emits the historical file_matching_query event type. FileCreatedTrigger covers the broader “new file” case and emits file_created.

Configuration

string
Bodies of items to which the query applies. Supported: ‘user’, ‘domain’, ‘drive’, ‘allDrives’.
string
ID of the shared drive to search (use with corpora=‘drive’).
boolean
Include items from both My Drive and shared drives.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of newly-matching files to emit per poll. The trigger paginates Drive responses internally bounded by an internal page cap; this field caps emitted events, not API pages.
string
Drive query to filter files. Examples: name contains ‘report’, mimeType = ‘application/pdf’, (name contains ‘Draft’ and not trashed). The query is composed with a createdTime >= <watermark> boundary plus ID dedup so the trigger only fires for newly created files.
string
A comma-separated list of spaces to query within. Supported: ‘drive’, ‘appDataFolder’.
boolean
Whether the requesting application supports both My Drives and shared drives.

Payload

string
Type of event that occurred
object
required
The newly matched Drive file
Slug: GOOGLESUPER_NEW_MESSAGEType: pollTriggers when a new message is received in Gmail.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
Filter messages by a single label ID. Labels identify the status or category of messages. Supported labels include ‘INBOX’, ‘SPAM’, ‘TRASH’, ‘UNREAD’, ‘STARRED’, ‘IMPORTANT’, ‘CATEGORY_PERSONAL’, ‘CATEGORY_SOCIAL’, ‘CATEGORY_PROMOTIONS’, ‘CATEGORY_UPDATES’, and ‘CATEGORY_FORUMS’. For complex label filtering, use the ‘query’ parameter instead.
string
Advanced Gmail search using the same syntax as Gmail’s search box. Use ‘AND’ for messages that match all conditions, ‘OR’ for any condition. Search by sender (from:email@domain.com), labels (label:inbox), status (is:unread), attachments (has:attachment), dates (after:2023/1/1), and more. If specified, this takes precedence over labelIds.
string
The user’s email address or ‘me’ for the authenticated user.

Payload

array
The list of attachments in the message
string
The raw Gmail message ID
array
The Gmail label IDs applied to the message
string
The message ID of the message
string
The text of the message
string
The timestamp of the message
object
The payload of the message
object
The preview payload of the message
string
The sender of the message
string
The subject of the message
string
The thread ID of the message
string
The recipient of the message
Slug: GOOGLESUPER_NEW_ROWS_TRIGGERType: pollSimple polling trigger that monitors Google Sheets for new rows. Detects when new rows are added and returns the complete row data. Perfect for triggering any workflow based on new sheet entries.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
The name of the specific sheet within the spreadsheet to monitor
string
required
The unique identifier of the Google Spreadsheet to monitor
integer
The row number to start monitoring from (1-indexed, typically 2 to skip headers)

Payload

string
required
ISO timestamp when the row was detected
array
required
Complete row data as list of strings
integer
required
The row number in the sheet (1-indexed)
string
required
The sheet name
string
required
The spreadsheet ID
Slug: GOOGLESUPER_NEW_SHEET_ADDED_TRIGGERType: pollPolling trigger that detects when a new sheet is added to a Google Spreadsheet.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The unique identifier of the Google Spreadsheet to monitor

Payload

string
required
ISO timestamp when the new sheet was detected
string
required
The name of the new sheet added
string
required
The spreadsheet ID
Slug: GOOGLESUPER_NEW_SPREADSHEET_CREATED_TRIGGERType: pollTriggers when a new Google Spreadsheet is created. This trigger monitors Google Spreadsheets and fires when new spreadsheets are detected. Uses timestamp filtering to efficiently detect newly created spreadsheets.

Configuration

boolean
Whether to include spreadsheets from shared drives you have access to. Defaults to True.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of spreadsheets to check in each poll (1-1000)
string
Optional search query to filter spreadsheets. Can search by name (name contains ‘Budget’), full text content (fullText contains ‘sales’), or use complex queries with operators. Leave empty to monitor all spreadsheets.

Payload

string
Type of event that occurred
object
required
The newly created Google Spreadsheet
Slug: GOOGLESUPER_NEW_TASK_CREATED_TRIGGERType: pollTriggers when a new task is created in a Google Tasks list. Uses timestamp filtering (updatedMin) to efficiently detect new tasks.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of tasks to check in each poll (1-100)
string
Identifier of the task list to monitor. Use ‘@default’ for the primary task list or provide a specific task list ID from list_task_lists action.

Payload

string
Type of event that occurred
object
required
The newly created task
Slug: GOOGLESUPER_NEW_TASK_LIST_CREATED_TRIGGERType: pollTriggers when a new Google Tasks task list is created. This trigger monitors Google Tasks and fires when new task lists are detected.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of task lists to check in each poll (1-100)

Payload

string
Type of event that occurred
object
required
The newly created task list
Slug: GOOGLESUPER_PAGE_ADDED_TRIGGERType: pollTriggers when a new Google Doc is added/created. This trigger monitors Google Docs and fires when new documents are detected.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of documents to check in each poll (1-1000)
string
Optional search query to filter documents. Can search by name (name contains ‘report’), full text content (fullText contains ‘important’), or use complex queries with operators like ‘and’, ‘or’, ‘not’. Leave empty to monitor all documents.

Payload

object
required
The newly added Google document
string
Type of event that occurred
Slug: GOOGLESUPER_SLIDE_ADDED_TRIGGERType: pollFires when a new slide is added to a Google Slides presentation.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The ID of the presentation to monitor for new slides

Payload

string
Type of slide event
object
required
The slide object that was added
Slug: GOOGLESUPER_SPREADSHEET_METADATA_CHANGED_TRIGGERType: pollPolling trigger that detects when a Google Spreadsheet’s metadata changes. Uses snapshot-based diffing to detect any changes in spreadsheet properties, sheets, named ranges, developer metadata, data sources, etc.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The unique identifier of the Google Spreadsheet to monitor for metadata changes

Payload

array
required
List of metadata changes detected
object
required
Current metadata snapshot
string
required
ISO timestamp when the change was detected
string
required
The spreadsheet ID
string
URL to view the spreadsheet
Slug: GOOGLESUPER_SPREADSHEET_PROPERTIES_CHANGED_TRIGGERType: pollPolling trigger that detects when a Google Spreadsheet’s top-level properties change. Monitors properties such as title, locale, timeZone, and autoRecalc settings.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The unique identifier of the Google Spreadsheet to monitor for property changes

Payload

array
required
List of properties that changed
string
required
ISO timestamp when the change was detected
string
required
The spreadsheet ID
string
URL to view the spreadsheet
Slug: GOOGLESUPER_SPREADSHEET_ROW_CHANGED_TRIGGERType: pollTriggers when a looked-up spreadsheet row changes. This trigger monitors a specific row (located by searching for a query value within a user-specified range) and fires when the row’s values change, when the row appears, or when the row disappears.

Configuration

boolean
If True, the query string search is case-sensitive.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
If True, strips leading and trailing whitespace from cell values before matching. This helps match cells like ’ TOTAL ’ or ‘TOTAL ’ when searching for ‘TOTAL’.
string
required
Exact text value to find; matches the entire content of a cell in a row.
string
A1 notation range to search within. Supports cell ranges (e.g., ‘Sheet1!A1:D5’), column-only ranges (e.g., ‘Sheet1!A:Z’), and row-only ranges (e.g., ‘Sheet1!1:1’). Defaults to the first sheet if omitted. IMPORTANT: Sheet names with spaces must be single-quoted (e.g., “‘My Sheet’!A1:Z”). Bare sheet names without ranges (e.g., ‘Sheet1’) are not supported - always specify a range.
string
required
Identifier of the Google Spreadsheet to monitor.

Payload

string
required
Type of change: ‘created’ (row appeared), ‘updated’ (row values changed), or ‘deleted’ (row disappeared)
string
required
The current row data (empty dict if row is not found now)
string
required
ISO timestamp when the change was detected
string
Type of event that occurred
string
required
The previous row data (empty dict if row was not found before)
string
required
The query used to find the row
string
The A1 notation range that was searched
string
required
The spreadsheet ID
Slug: GOOGLESUPER_SPREADSHEET_SEARCH_MATCH_TRIGGERType: pollTriggers when a new spreadsheet appears that matches a saved search. This trigger uses snapshot-based diffing to detect when spreadsheets matching the search criteria are newly created or become visible to the user.

Configuration

string
Return spreadsheets created after this date. Use RFC 3339 format like ‘2024-01-01T00:00:00Z’.
boolean
Whether to include spreadsheets from shared drives you have access to. Defaults to True.
boolean
Whether to include spreadsheets in trash. Defaults to False.
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of spreadsheets to check in each poll (1-100)
string
Return spreadsheets modified after this date. Use RFC 3339 format like ‘2024-01-01T00:00:00Z’.
string
Order results by field. Common options: ‘modifiedTime desc’, ‘modifiedTime asc’, ‘name’, ‘createdTime desc’
string
Search query to filter spreadsheets. Behavior depends on the ‘search_type’ parameter. For advanced searches, use Google Drive query syntax with fields like ‘name contains’, ‘fullText contains’, or boolean filters like ‘sharedWithMe = true’. DO NOT use spreadsheet IDs as search terms. Leave empty to get all spreadsheets.
string ("name" | "content" | "both")
How to search: ‘name’ searches filenames only (prefix matching from the START of filenames), ‘content’ uses fullText search which searches file content, name, description, and metadata, ‘both’ explicitly searches both name OR content with an OR condition.
boolean
Whether to return only spreadsheets shared with the current user. Defaults to False.
boolean
Whether to return only starred spreadsheets. Defaults to False.

Payload

string
Type of event that occurred
object
required
The spreadsheet that matches the search criteria
Slug: GOOGLESUPER_TABLE_QUERY_RESULT_CHANGED_TRIGGERType: pollTriggers when the result set of a saved table query changes in Google Sheets. Detects rows added, removed, or updated in the query output. This trigger monitors the result of a SQL query against a Google Sheets table and fires when changes are detected.

Configuration

boolean
Whether to return formula text instead of calculated values for formula columns
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The unique identifier of the Google Spreadsheet to query. This is the long alphanumeric string found in the spreadsheet URL between ‘/d/’ and ‘/edit’.
string
required
SQL SELECT query to execute. The table name is the Google Sheets tab/sheet name (visible at the bottom of the spreadsheet). Supported: SELECT cols FROM table WHERE conditions ORDER BY col LIMIT n. Table names must be quoted with double quotes if they contain spaces or are numeric-only (e.g., SELECT * FROM “My Sheet” or SELECT * FROM “415”).

Payload

array
required
List of detected changes
string
required
ISO timestamp when the change was detected
string
Type of event that occurred
string
required
The spreadsheet ID
string
required
The SQL query that was executed
integer
required
Total number of rows after the change
integer
required
Total number of rows before the change
Slug: GOOGLESUPER_TABLE_SCHEMA_CHANGED_TRIGGERType: pollPolling trigger that detects when a table’s schema changes in Google Sheets. Monitors columns added/removed/renamed and inferred type/format changes. Uses snapshot-based diffing to compare schemas between polls.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Number of rows to sample for type inference
string
Sheet/tab name if table_name is ambiguous across multiple sheets
string
required
The unique identifier of the Google Spreadsheet to monitor
string
required
Table name from LIST_TABLES response OR the visible Google Sheets tab name. Use ‘auto’ to monitor the largest/most prominent table.

Payload

string
required
Human-readable summary of the changes
array
required
List of column changes detected
integer
required
Number of columns in current schema
string
required
ISO timestamp when the change was detected
integer
required
Number of columns in previous schema
string
required
Sheet name where table is located
string
required
The spreadsheet ID
string
required
Name of the table that changed
Slug: GOOGLESUPER_TASK_DETAILS_CHANGED_TRIGGERType: pollTriggers when a specific task’s details change. This trigger monitors a single Google Task and fires when any of its details (title, notes, status, due date, completion, position) are modified.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The ID of the specific task to monitor for changes
string
required
The ID of the task list containing the task to monitor

Payload

array
required
List of field names that changed
string
Type of event that occurred
object
The previous task snapshot (None on first poll)
object
required
The current task with all details
Slug: GOOGLESUPER_TASK_LIST_CHANGED_TRIGGERType: pollTriggers when a task list changes (title or content updates). This trigger monitors a specific Google Tasks list and fires when changes are detected.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The unique identifier of the task list to monitor for changes. Use ‘@default’ for the default task list.

Payload

array
List of fields that changed (e.g., ‘title’, ‘updated’)
string
Type of event that occurred
object
required
The task list with changed state
Slug: GOOGLESUPER_TASK_UPDATED_TRIGGERType: pollTriggers when an existing task is updated in a Google Tasks list. This trigger monitors a specific task list and fires when tasks are modified.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Maximum number of tasks to check in each poll (1-100)
boolean
Include completed tasks in the monitoring. Defaults to true.
boolean
Include deleted tasks in the monitoring. Defaults to false.
string
Identifier of the task list to monitor. Use ‘@default’ for the primary task list, or provide a specific task list ID from list_task_lists action.

Payload

string
Type of event that occurred
object
required
The updated task
Slug: GOOGLESUPER_WORKSHEET_NAMES_CHANGED_TRIGGERType: pollTriggers when the set of worksheet/tab names changes in a Google Spreadsheet. Detects when sheets are added, deleted, or renamed.

Configuration

number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
string
required
The unique identifier of the Google Spreadsheet to monitor

Payload

string
required
Type of change: ‘added’, ‘deleted’, or ‘renamed’
array
required
Current list of all worksheet names after the change
string
required
ISO timestamp when the change was detected
string
Previous name if worksheet was renamed (only for renamed events)
string
required
The spreadsheet ID
string
required
The name of the worksheet that was added, deleted, or involved in the change