Googlesuper
Learn how to use Googlesuper with Composio
Overview
Enum
GOOGLESUPER
Description
Google Super App combines all Google services including Drive, Calendar, Gmail, Sheets, Analytics, Ads, and more, providing a unified platform for seamless integration and management of your digital life.
Authentication Details
OAUTH2
BEARER_TOKEN
API_KEY
Actions
GOOGLESUPER_ADD_ENRICHMENT
Adds an enrichment at a specified position in a defined album.
Action Parameters
Action Response
GOOGLESUPER_ADD_FILE_SHARING_PREFERENCE
Add file sharing preferences, including domain-level permissions requiring a domain field.
Action Parameters
Action Response
GOOGLESUPER_ADD_LABEL_TO_EMAIL
Modify a label to an email in gmail.
Action Parameters
Action Response
GOOGLESUPER_ADD_OR_REMOVE_TO_CUSTOMER_LIST
Addorremovetocustomerlist tool will add a contact to a customer list in google ads. note: it takes 6 to 12 hours for changes to be reflected in the customer list.
Action Parameters
Action Response
GOOGLESUPER_BATCH_ADD_MEDIA_ITEMS
Adds one or more media items to an album in google photos.
Action Parameters
Action Response
GOOGLESUPER_BATCH_CREATE_MEDIA_ITEMS
Unified action to upload media files and create them as items in google photos.
Action Parameters
Action Response
GOOGLESUPER_BATCH_GET
Perform a batch get on a specific spreadsheet. note: if ranges aren’t provided, data from the first sheet will be returned.
Action Parameters
Action Response
GOOGLESUPER_BATCH_GET_MEDIA_ITEMS
Returns the list of media items for the specified media item identifiers.
Action Parameters
Action Response
GOOGLESUPER_BATCH_UPDATE
Perform a batch update operation on a specified google sheets spreadsheet. note: if no first cell location is provided, the values will be appended to the first empty row of the sheet from the top.
Action Parameters
Action Response
GOOGLESUPER_CLEAR_TASKS
Clear all completed tasks from the specified task list in google tasks.
Action Parameters
Action Response
GOOGLESUPER_CLEAR_VALUES
Clear values from a specified range in a spreadsheet.
Action Parameters
Action Response
GOOGLESUPER_COPY_FILE
Copy a file
Action Parameters
Action Response
GOOGLESUPER_CREATE_ALBUM
Creates a new album in google photos.
Action Parameters
Action Response
GOOGLESUPER_CREATE_CUSTOMER_LIST
Createcustomerlist tool will create a customer list in google ads.
Action Parameters
Action Response
GOOGLESUPER_CREATE_DOCUMENT
Creates a new google docs document with an optional title and text.
Action Parameters
Action Response
GOOGLESUPER_CREATE_DOCUMENT_MARKDOWN
Creates a new google docs document with an optional title and text.
Action Parameters
Action Response
GOOGLESUPER_CREATE_EMAIL_DRAFT
Create a draft email using gmail’s api.
Action Parameters
Action Response
GOOGLESUPER_CREATE_EVENT
Create a new event in a google calendar.
Action Parameters
Action Response
GOOGLESUPER_CREATE_FILE_FROM_TEXT
Create a file from text. max 10mb in size.
Action Parameters
Action Response
GOOGLESUPER_CREATE_FOLDER
Create a new folder in google drive. if parent id is provided, it must be a valid google drive folder id. the folder will be created in the root directory if no parent id is specified.
Action Parameters
Action Response
GOOGLESUPER_CREATE_GOOGLE_SHEET1
Create a new google sheet.
Action Parameters
Action Response
GOOGLESUPER_CREATE_LABEL
Action to create a new label in gmail.
Action Parameters
Action Response
GOOGLESUPER_CREATE_MEET
Create a google meet space!
Action Parameters
Action Response
GOOGLESUPER_CREATE_SPREADSHEET_COLUMN
Create a new column in a specific spreadsheet.
Action Parameters
Action Response
GOOGLESUPER_CREATE_SPREADSHEET_ROW
Create a new row in a specific spreadsheet.
Action Parameters
Action Response
GOOGLESUPER_CREATE_TASK_LIST
Create a new task list in google tasks.
Action Parameters
Action Response
GOOGLESUPER_DELETE_DRAFT
Delete an email draft using gmail’s api.
Action Parameters
Action Response
GOOGLESUPER_DELETE_EVENT
Delete an event from a google calendar.
Action Parameters
Action Response
GOOGLESUPER_DELETE_FOLDER_OR_FILE
Delete folder or file
Action Parameters
Action Response
GOOGLESUPER_DELETE_MESSAGE
Delete an email message using gmail’s api. note: this action requires the integration to have the https://mail.google.com/ scope.
Action Parameters
Action Response
GOOGLESUPER_DELETE_TASK
Delete the specified task from the task list in google tasks.
Action Parameters
Action Response
GOOGLESUPER_DELETE_TASK_LIST
Delete a task list in google tasks.
Action Parameters
Action Response
GOOGLESUPER_DOWNLOAD_FILE
Download a file.
Action Parameters
Action Response
GOOGLESUPER_DUPLICATE_CALENDAR
Action to duplicate a google calendar based on the provided summary. the duplicated calendar can be used similarly to manage other goals.
Action Parameters
Action Response
GOOGLESUPER_EDIT_FILE
Edit a file. max 10mb in size.
Action Parameters
Action Response
GOOGLESUPER_FETCH_EMAILS
Action to fetch all emails from gmail.
Action Parameters
Action Response
GOOGLESUPER_FETCH_MESSAGE_BY_MESSAGE_ID
Fetch messages by message id from gmail.
Action Parameters
Action Response
GOOGLESUPER_FETCH_MESSAGE_BY_THREAD_ID
Fetch messages by thread id from gmail with pagination support. to use pagination, you can set the ‘pagetoken’ in the request to the value of the ‘nextpagetoken’ in the response of the previous action. the ‘nextpagetoken’ is returned in the response of this action (i.e ‘fetchmessagebythreadid’) if there are more results to be fetched. if not provided, the first page of results is returned.
Action Parameters
Action Response
GOOGLESUPER_FIND_EVENT
Find events in a google calendar based on a search query.
Action Parameters
Action Response
GOOGLESUPER_FIND_FILE
Find files present in google drive. can be used to search for files by name and content.
Action Parameters
Action Response
GOOGLESUPER_FIND_FOLDER
Find folder
Action Parameters
Action Response
GOOGLESUPER_FIND_FREE_SLOTS
Find free slots in a google calendar based on for a specific time period.
Action Parameters
Action Response
GOOGLESUPER_FIND_WORKSHEET_BY_TITLE
Find a worksheet by title in a specific spreadsheet.
Action Parameters
Action Response
GOOGLESUPER_FORMAT_CELL
Apply formatting to a specified range of cells in a google sheets spreadsheet. note: the current implementation incorrectly uses logic for updating cell values. this needs to be refactored.
Action Parameters
Action Response
GOOGLESUPER_GET_ALBUM
Returns the album based on the specified albumid.
Action Parameters
Action Response
GOOGLESUPER_GET_ATTACHMENT
Get an attachment from a mail.
Action Parameters
Action Response
GOOGLESUPER_GET_CALENDAR
Action to fetch a calendar based on the provided calendar id.
Action Parameters
Action Response
GOOGLESUPER_GET_CAMPAIGN_BY_ID
Getcampaignbyid tool will return details of a campaign in google ads.
Action Parameters
Action Response
GOOGLESUPER_GET_CAMPAIGN_BY_NAME
Getcampaignbyname tool will run a sql getcampaignbyname in google ads.
Action Parameters
Action Response
GOOGLESUPER_GET_CONFERENCE_RECORD_FOR_MEET
Get conference record by space name, meeting code, start time, end time
Action Parameters
Action Response
GOOGLESUPER_GET_CONTACTS
Action to get info of contacts saved in google for an authorized account. a custom integration with https://www.googleapis.com/auth/contacts.readonly scope is required to use this action.
Action Parameters
Action Response
GOOGLESUPER_GET_CURRENT_DATE_TIME
Action to get the current date and time of a specified timezone, given its utc offset value.
Action Parameters
Action Response
GOOGLESUPER_GET_CUSTOMER_LISTS
Getcustomerlists tool will list all customer lists in google ads.
Action Parameters
Action Response
GOOGLESUPER_GET_DIRECTION
Requires: valid google maps api key gets directions between locations using google maps directions api. this action provides detailed directions between two points, including: - turn-by-turn navigation steps - distance and duration for each step - alternative routes when available - support for waypoints - different travel modes examples: python # basic direction request request = getdirectionrequest( origin="disneyland", destination="universal studios hollywood" ) # complex route with waypoints and preferences request = getdirectionrequest( origin="los angeles airport", destination="santa monica pier", waypoints="venice beach,getty center", mode="driving", avoid="highways", units="metric" )
Action Parameters
Action Response
GOOGLESUPER_GET_DOCUMENT_BY_ID
Finds or creates a specific document.
Action Parameters
Action Response
GOOGLESUPER_GET_MEDIA_ITEM_DOWNLOAD
Downloads a media item from google photos and returns it as a file.
Action Parameters
Action Response
GOOGLESUPER_GET_MEET
Retrieve details of a google meet space.
Action Parameters
Action Response
GOOGLESUPER_GET_PEOPLE
Action to get contacts info of people.
Action Parameters
Action Response
GOOGLESUPER_GET_PROFILE
Get the profile of the authenticated user.
Action Parameters
Action Response
GOOGLESUPER_GET_RECORDINGS_BY_CONFERENCE_RECORD_ID
Retrieve recordings by conference record id.
Action Parameters
Action Response
GOOGLESUPER_GET_ROUTE
Computes routes between two points using google maps routes api. this action calculates routes between two locations, taking into account: - real-time traffic conditions (when routingpreference is traffic aware) - route preferences (avoiding tolls, highways, ferries) - alternative routes (when computealternativeroutes is true) - different travel modes (driving, walking, cycling, etc.) the response includes details like: - total distance in meters - estimated duration - encoded polyline for route visualization
Action Parameters
Action Response
GOOGLESUPER_GET_SHEET_NAMES
Get all the worksheet names in a spreadsheet. note: use this action to get valid sheet names before using any other action.
Action Parameters
Action Response
GOOGLESUPER_GET_SPREADSHEET_INFO
Retrieve information about an existing google sheet.
Action Parameters
Action Response
GOOGLESUPER_GET_TASK
Retrieve the specified task from the task list in google tasks.
Action Parameters
Action Response
GOOGLESUPER_GET_TASK_LIST
Get a task list in google tasks.
Action Parameters
Action Response
GOOGLESUPER_GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID
Retrieve transcripts by conference record id.
Action Parameters
Action Response
GOOGLESUPER_INSERT_TASK
Create a new task on the specified task list in google tasks.
Action Parameters
Action Response
GOOGLESUPER_LIST_ALBUMS
Lists all albums shown to a user in the albums tab of google photos.
Action Parameters
Action Response
GOOGLESUPER_LIST_CALENDARS
Action to list all google calendars from the user’s calendar list with pagination.
Action Parameters
Action Response
GOOGLESUPER_LIST_DRAFTS
List all email drafts using gmail’s api.
Action Parameters
Action Response
GOOGLESUPER_LIST_LABELS
List all labels in the user’s gmail account.
Action Parameters
Action Response
GOOGLESUPER_LIST_MEDIA_ITEMS
Lists all media items from a user’s google photos library.
Action Parameters
Action Response
GOOGLESUPER_LIST_TASKS
Retrieve all tasks in the specified task list from google tasks.
Action Parameters
Action Response
GOOGLESUPER_LIST_TASK_LISTS
List all task lists of an authenticated user in google tasks.
Action Parameters
Action Response
GOOGLESUPER_LIST_THREADS
Action to list threads in gmail. this action returns a list of threads and a page token to retrieve the next page of results. the next page token is returned in the response of this action (i.e ‘listthreads’) if there are more results to be fetched, which you can use in the ‘pagetoken’ field of the request to fetch the next page of results. if not available, the last page of results is returned.
Action Parameters
Action Response
GOOGLESUPER_LOOKUP_SPREADSHEET_ROW
Lookup a row in a specific spreadsheet by a column and value.
Action Parameters
Action Response
GOOGLESUPER_MODIFY_THREAD_LABELS
Action to modify labels of a thread in gmail.
Action Parameters
Action Response
GOOGLESUPER_MOVE_TO_TRASH
Move an email message to trash using gmail’s api.
Action Parameters
Action Response
GOOGLESUPER_NEARBY_SEARCH
Searches for places near a specified location using google maps places api.
Action Parameters
Action Response
GOOGLESUPER_PARSE_FILE
Parse a file. max 10mb in size. (DEPRECATED use DOWNLOAD_FILE)
Action Parameters
Action Response
GOOGLESUPER_PATCH_CALENDAR
Action to update a google calendar based on the provided calendar id and other required and optional parameters. note that ‘summary’ is a mandatory parameter. use googlecalendar list calendars action to get the list of calendars and their ids.
Action Parameters
Action Response
GOOGLESUPER_PATCH_EVENT
Patches an event in google calendar. this method supports patch semantics - only specified fields will be updated. note that each patch request consumes three quota units. array fields, if specified, will completely replace existing arrays.
Action Parameters
Action Response
GOOGLESUPER_PATCH_TASK
Update the specified task in the task list in google tasks.
Action Parameters
Action Response
GOOGLESUPER_PATCH_TASK_LIST
Update the authenticated user’s specified task list in google tasks.
Action Parameters
Action Response
GOOGLESUPER_QUICK_ADD
Create a new event in a google calendar based on a simple text string like ‘appointment at somewhere on june 3rd 10am-10:25am’ you can only give title and timeslot here. no recurring meetings and no attendee can be added here. this is not a preferred endpoint. only use this if no other endpoint is possible.
Action Parameters
Action Response
GOOGLESUPER_REMOVE_ATTENDEE
Remove an attendee from an existing event in a google calendar.
Action Parameters
Action Response
GOOGLESUPER_REMOVE_LABEL
Action to remove a label in gmail.
Action Parameters
Action Response
GOOGLESUPER_REPLY_TO_THREAD
Action to reply to an email thread in gmail.
Action Parameters
Action Response
GOOGLESUPER_SEARCH_MEDIA_ITEMS
Searches for media items in a user’s google photos library.
Action Parameters
Action Response
GOOGLESUPER_SEARCH_PEOPLE
Provides a list of contacts in the authenticated user’s grouped contacts that matches the search query. the query matches on a contact’s names, nicknames, emailaddresses, phonenumbers, and organizations fields that are from the contact source. a custom integration with https://www.googleapis.com/auth/contacts.readonly scope is required to use this action.
Action Parameters
Action Response
GOOGLESUPER_SEND_EMAIL
Send an email using gmail’s api.
Action Parameters
Action Response
GOOGLESUPER_SHEET_FROM_JSON
Create a new google sheet from a json object. this action takes a json structure and converts it into a google sheet where: - the first row contains the keys as headers - subsequent rows contain the corresponding values - all rows must have the same structure (keys) args: title (str): the title of the new google sheet sheet name (str): name of the worksheet within the spreadsheet sheet json (list[dict]): list of dictionaries with consistent keys
Action Parameters
Action Response
GOOGLESUPER_SYNC_EVENTS
Get events from last sync. the flow should be following 1. you use list or find events to get the list of events. you will get the nextsynctoken. 2. you use sync events to get the list of events that have changed since the last sync. you will get the nextsynctoken. 3. continue to use sync events. in case the synctoken expires, you will have to start syncing from the beginning.
Action Parameters
Action Response
GOOGLESUPER_TEXT_SEARCH
Searches for places using a text query in google maps places api.
Action Parameters
Action Response
GOOGLESUPER_UPDATE_ALBUM
Updates an album’s title or cover photo in google photos.
Action Parameters
Action Response
GOOGLESUPER_UPDATE_DOCUMENT_MARKDOWN
Updates an existing google docs document created using markdown with the new markdown text.
Action Parameters
Action Response
GOOGLESUPER_UPDATE_EVENT
Update an existing event in a google calendar.
Action Parameters
Action Response
GOOGLESUPER_UPDATE_EXISTING_DOCUMENT
Updates an existing google docs document with the provided edits.
Action Parameters
Action Response
GOOGLESUPER_UPDATE_MEDIA_ITEM
Updates a media item’s description in google photos.
Action Parameters
Action Response
GOOGLESUPER_UPLOAD_FILE
Upload a file to google drive. max file size is 5mb.
Action Parameters
Action Response
GOOGLESUPER_UPLOAD_MEDIA
Upload a media file to google photos. supports images (up to 200mb) and videos (up to 20gb).
Action Parameters
Action Response