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

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to https://www.googleapis.com/auth/drive.file,https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/documents,https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/calendar.events,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/gmail.modify,https://www.googleapis.com/auth/userinfo.profile,https://www.googleapis.com/auth/contacts.readonly,https://www.googleapis.com/auth/spreadsheets,https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/analytics,https://www.googleapis.com/auth/tasks
token
stringRequired
api_key
stringRequired

Actions

Lookup a row in a specific spreadsheet by a column and value.

Action Parameters

spreadsheet_id
stringRequired
range
string
query
stringRequired
case_sensitive
boolean

Action Response

data
object
successful
boolean
error

Clear all completed tasks from the specified task list in google tasks.

Action Parameters

tasklist
stringRequired

Action Response

data
object
successful
boolean
error

Returns the list of media items for the specified media item identifiers.

Action Parameters

mediaItemIds
arrayRequired

Action Response

data
object
successful
boolean
error

Edit a file. max 10mb in size.

Action Parameters

file_id
stringRequired
mime_type
stringDefaults to text/plain
content
stringRequired

Action Response

data
object
successful
boolean
error

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

resource_name
stringDefaults to people/me
person_fields
stringDefaults to emailAddresses,names,birthdays,genders
page_token
string

Action Response

data
object
successful
boolean
error

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

calendar_id
stringRequired
description
string
location
string
summary
stringRequired
timezone
string

Action Response

data
object
successful
boolean
error

Find free slots in a google calendar based on for a specific time period.

Action Parameters

time_min
string
time_max
string
timezone
stringDefaults to UTC
group_expansion_max
integerDefaults to 100
calendar_expansion_max
integerDefaults to 50
items
arrayDefaults to ['primary']

Action Response

data
object
successful
boolean
error

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

folder_name
stringRequired
parent_id
string

Action Response

data
object
successful
boolean
error

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

user_id
stringDefaults to me
max_results
integerDefaults to 10
page_token
string
query
string

Action Response

data
object
successful
boolean
error

Get a task list in google tasks.

Action Parameters

tasklist_id
stringRequired

Action Response

data
object
successful
boolean
error

Perform a batch get on a specific spreadsheet. note: if ranges aren’t provided, data from the first sheet will be returned.

Action Parameters

spreadsheet_id
stringRequired
ranges
array

Action Response

data
object
successful
boolean
error

Add file sharing preferences, including domain-level permissions requiring a domain field.

Action Parameters

file_id
stringRequired
role
stringRequired
type
stringRequired
email_address
string
domain
string

Action Response

data
object
successful
boolean
error

Updates an existing google docs document created using markdown with the new markdown text.

Action Parameters

document_id
stringRequired
new_markdown_text
stringRequired

Action Response

document_id
string
data
object
successful
boolean
error

Create a draft email using gmail’s api.

Action Parameters

user_id
stringDefaults to me
recipient_email
stringRequired
cc
array
bcc
array
subject
stringRequired
body
stringRequired
is_html
boolean
attachment
object

Action Response

data
object
successful
boolean
error

Create a new event in a google calendar.

Action Parameters

description
string
eventType
stringDefaults to default
create_meeting_room
boolean
guestsCanSeeOtherGuests
boolean
guestsCanInviteOthers
boolean
location
string
summary
string
transparency
stringDefaults to opaque
visibility
stringDefaults to default
timezone
string
recurrence
array
guests_can_modify
boolean
attendees
array
send_updates
boolean
start_datetime
stringRequired
event_duration_hour
integer
event_duration_minutes
integerDefaults to 30
calendar_id
stringDefaults to primary

Action Response

data
object
successful
boolean
error

Retrieve the specified task from the task list in google tasks.

Action Parameters

tasklist_id
stringRequired
task_id
stringRequired

Action Response

data
object
successful
boolean
error

Create a file from text. max 10mb in size.

Action Parameters

file_name
stringRequired
text_content
stringRequired
parent_id
string
mime_type
stringDefaults to text/plain

Action Response

data
object
successful
boolean
error

Retrieve transcripts by conference record id.

Action Parameters

conferenceRecord_id
stringRequired

Action Response

data
object
successful
boolean
error

Create a new task list in google tasks.

Action Parameters

tasklist_title
stringRequired

Action Response

data
object
successful
boolean
error

Action to get the current date and time of a specified timezone, given its utc offset value.

Action Parameters

timezone
number

Action Response

data
object
successful
boolean
error

Parse a file. max 10mb in size. (DEPRECATED use DOWNLOAD_FILE)

Action Parameters

file_id
stringRequired
mime_type
string

Action Response

data
object
successful
boolean
error

Create a new google sheet.

Action Parameters

title
stringRequired

Action Response

data
object
successful
boolean
error

Retrieve a google meet conference record by name, meeting code, start time, and end time.

Action Parameters

space_name
string
meeting_code
string
start_time
string
end_time
string

Action Response

data
object
successful
boolean
error

Clear values from a specified range in a spreadsheet.

Action Parameters

spreadsheet_id
stringRequired
range
stringRequired

Action Response

data
object
successful
boolean
error

Retrieve recordings by conference record id.

Action Parameters

conferenceRecord_id
stringRequired

Action Response

data
object
successful
boolean
error

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

origin_address
stringRequired
destination_address
stringRequired
travelMode
stringDefaults to DRIVE
routingPreference
stringDefaults to TRAFFIC_AWARE
computeAlternativeRoutes
boolean
routeModifiers_avoidTolls
boolean
routeModifiers_avoidHighways
boolean
routeModifiers_avoidFerries
boolean
languageCode
stringDefaults to en-US
units
stringDefaults to IMPERIAL
fieldMask
stringDefaults to routes.distanceMeters,routes.duration,routes.polyline.encodedPolyline

Action Response

data
object
successful
boolean
error

Action to list all google calendars from the user’s calendar list with pagination.

Action Parameters

max_results
integerDefaults to 10
min_access_role
string
page_token
string
show_deleted
boolean
show_hidden
boolean
sync_token
string

Action Response

data
object
successful
boolean
error

Unified action to upload media files and create them as items in google photos.

Action Parameters

albumId
stringRequired
files
arrayRequired
albumPosition
object

Action Response

data
object
successful
boolean
error

Action to get contacts info of people.

Action Parameters

resource_name
stringDefaults to people/me
person_fields
stringDefaults to emailAddresses,names,birthdays,genders

Action Response

data
object
successful
boolean
error

Adds one or more media items to an album in google photos.

Action Parameters

albumId
stringRequired
mediaItemIds
arrayRequired

Action Response

data
object
successful
boolean
error

Action to modify labels of a thread in gmail.

Action Parameters

user_id
stringDefaults to me
thread_id
stringRequired
remove_label_ids
array
add_label_ids
array

Action Response

data
object
successful
boolean
error

Get the profile of the authenticated user.

Action Parameters

user_id
stringDefaults to me

Action Response

data
object
successful
boolean
error

Modify a label to an email in gmail.

Action Parameters

user_id
stringDefaults to me
message_id
stringRequired
add_label_ids
array
remove_label_ids
array

Action Response

data
object
successful
boolean
error

Update the authenticated user’s specified task list in google tasks.

Action Parameters

tasklist_id
stringRequired
updated_title
stringRequired

Action Response

data
object
successful
boolean
error

Delete the specified task from the task list in google tasks.

Action Parameters

tasklist_id
stringRequired
task_id
stringRequired

Action Response

data
object
successful
boolean
error

Creates a new album in google photos.

Action Parameters

title
stringRequired
id
string
productUrl
string
isWriteable
boolean
mediaItemsCount
string
coverPhotoBaseUrl
string
coverPhotoMediaItemId
string

Action Response

data
object
successful
boolean
error

Searches for media items in a user’s google photos library.

Action Parameters

albumId
string
pageSize
integerDefaults to 25
pageToken
string
filters
object
orderBy
string

Action Response

data
object
successful
boolean
error

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

spreadsheet_id
stringRequired
sheet_name
stringRequired
first_cell_location
string
values
arrayRequired
includeValuesInResponse
boolean
valueInputOption
stringDefaults to USER_ENTERED

Action Response

data
object
successful
boolean
error

Adds an enrichment at a specified position in a defined album.

Action Parameters

albumId
stringRequired
newEnrichmentItem
objectRequired
albumPosition
object

Action Response

data
object
successful
boolean
error

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

calendar_id
stringDefaults to primary
text
string
send_updates
stringDefaults to none

Action Response

data
object
successful
boolean
error

Action to create a new label in gmail.

Action Parameters

user_id
stringDefaults to me
label_name
stringRequired
label_list_visibility
stringDefaults to labelShow
message_list_visibility
stringDefaults to show

Action Response

data
object
successful
boolean
error

Action to fetch a calendar based on the provided calendar id.

Action Parameters

calendar_id
stringDefaults to primary

Action Response

data
object
successful
boolean
error

Upload a media file to google photos. supports images (up to 200mb) and videos (up to 20gb).

Action Parameters

file_to_upload
objectRequired
description
string

Action Response

data
object
successful
boolean
error

Lists all media items from a user’s google photos library.

Action Parameters

pageSize
integerDefaults to 25
pageToken
string

Action Response

data
object
successful
boolean
error

Update an existing event in a google calendar.

Action Parameters

description
string
eventType
stringDefaults to default
create_meeting_room
boolean
guestsCanSeeOtherGuests
boolean
guestsCanInviteOthers
boolean
location
string
summary
string
transparency
stringDefaults to opaque
visibility
stringDefaults to default
timezone
string
recurrence
array
guests_can_modify
boolean
attendees
array
send_updates
boolean
start_datetime
stringRequired
event_duration_hour
integer
event_duration_minutes
integerDefaults to 30
calendar_id
stringDefaults to primary
event_id
stringRequired

Action Response

data
object
successful
boolean
error

Find files present in google drive. can be used to search for files by name and content.

Action Parameters

folder_id
string
name_exact
string
name_contains
string
name_not_contains
string
full_text_contains
string
full_text_not_contains
string
modified_after
string
include_items_from_all_drives
boolean
supports_all_drives
boolean
starred
boolean
mime_type
string

Action Response

data
object
successful
boolean
error

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

user_id
stringDefaults to me
thread_id
stringRequired
page_token
string

Action Response

data
object
successful
boolean
error

List all labels in the user’s gmail account.

Action Parameters

user_id
stringDefaults to me

Action Response

data
object
successful
boolean
error

Updates an existing google docs document with the provided edits.

Action Parameters

document_id
stringRequired
editDocs
arrayRequired

Action Response

document_id
string
data
object
successful
boolean
error

Getcampaignbyid tool will return details of a campaign in google ads.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Action to remove a label in gmail.

Action Parameters

user_id
stringDefaults to me
label_id
stringRequired

Action Response

data
object
successful
boolean
error

Find folder

Action Parameters

name_exact
string
name_contains
string
name_not_contains
string
full_text_contains
string
full_text_not_contains
string
modified_after
string
starred
boolean

Action Response

data
object
successful
boolean
error

Createcustomerlist tool will create a customer list in google ads.

Action Parameters

name
stringRequired
description
string

Action Response

data
object
successful
boolean
error

Create a google meet space!

Action Parameters

access_type
string
entry_point_access
string

Action Response

data
object
successful
boolean
error

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

title
stringRequired
sheet_name
stringRequired
sheet_json
arrayRequired

Action Response

data
object
successful
boolean
error

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

query
stringRequired
person_fields
stringDefaults to emailAddresses,names,birthdays,genders

Action Response

data
object
successful
boolean
error

Upload a file to google drive. max file size is 5mb.

Action Parameters

file_to_upload
objectRequired
folder_to_upload_to
string

Action Response

data
object
successful
boolean
error

Fetch messages by message id from gmail.

Action Parameters

user_id
stringDefaults to me
message_id
stringRequired
format
stringDefaults to full

Action Response

data
object
successful
boolean
error

Delete folder or file

Action Parameters

file_id
stringRequired

Action Response

data
object
successful
boolean
error

Retrieve details of a google meet space.

Action Parameters

space_name
stringRequired

Action Response

data
object
successful
boolean
error

Action to duplicate a google calendar based on the provided summary. the duplicated calendar can be used similarly to manage other goals.

Action Parameters

summary
string

Action Response

data
object
successful
boolean
error

Delete an event from a google calendar.

Action Parameters

calendar_id
stringDefaults to primary
event_id
stringRequired

Action Response

data
object
successful
boolean
error

Action to reply to an email thread in gmail.

Action Parameters

user_id
stringDefaults to me
thread_id
stringRequired
message_body
stringRequired
recipient_email
stringRequired
cc
array
bcc
array
is_html
boolean

Action Response

data
object
successful
boolean
error

Action to fetch all emails from gmail.

Action Parameters

user_id
stringDefaults to me
max_results
integerDefaults to 1
page_token
string
query
string
label_ids
array
include_spam_trash
boolean
include_payload
booleanDefaults to True

Action Response

data
object
successful
boolean
error

List all task lists of an authenticated user in google tasks.

Action Parameters

maxResults
integerDefaults to 20
pageToken
string

Action Response

data
object
successful
boolean
error

Finds or creates a specific document.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Retrieve information about an existing google sheet.

Action Parameters

spreadsheet_id
stringRequired

Action Response

data
object
successful
boolean
error

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

origin
stringRequired
destination
stringRequired
waypoints
string
mode
stringDefaults to driving
avoid
string
language
stringDefaults to en
units
stringDefaults to imperial

Action Response

data
object
successful
boolean
error

Send an email using gmail’s api.

Action Parameters

user_id
stringDefaults to me
recipient_email
stringRequired
cc
array
bcc
array
subject
string
body
stringRequired
is_html
boolean
attachment
object

Action Response

data
object
successful
boolean
error

Create a new task on the specified task list in google tasks.

Action Parameters

id
string
etag
string
title
stringRequired
notes
string
status
stringRequired
due
string
completed
string
deleted
boolean
hidden
boolean
tasklist_id
stringRequired
task_parent
string
task_previous
string

Action Response

data
object
successful
boolean
error

Creates a new google docs document with an optional title and text.

Action Parameters

title
stringRequired
markdown_text
stringRequired

Action Response

data
object
successful
boolean
error

Get all the worksheet names in a spreadsheet. note: use this action to get valid sheet names before using any other action.

Action Parameters

spreadsheet_id
stringRequired

Action Response

data
object
successful
boolean
error

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

resource_name
stringRequired
emails
arrayRequired
operation
stringDefaults to create

Action Response

data
object
successful
boolean
error

Update the specified task in the task list in google tasks.

Action Parameters

id
string
etag
string
title
stringRequired
notes
string
status
stringRequired
due
string
completed
string
deleted
boolean
hidden
boolean
tasklist_id
stringRequired
task_id
stringRequired

Action Response

data
object
successful
boolean
error

Download a file.

Action Parameters

file_id
stringRequired
mime_type
string

Action Response

data
object
successful
boolean
error

Creates a new google docs document with an optional title and text.

Action Parameters

title
stringRequired
text
stringRequired

Action Response

data
object
successful
boolean
error

Retrieve all tasks in the specified task list from google tasks.

Action Parameters

tasklist_id
stringRequired
completedMax
string
completedMin
string
dueMax
string
dueMin
string
maxResults
integer
pageToken
string
showCompleted
boolean
showDeleted
boolean
showHidden
boolean
updatedMin
string

Action Response

data
object
successful
boolean
error

Getcustomerlists tool will list all customer lists in google ads.

Action Parameters

Action Response

data
object
successful
boolean
error

Delete a task list in google tasks.

Action Parameters

tasklist_id
string

Action Response

data
object
successful
boolean
error

Lists all albums shown to a user in the albums tab of google photos.

Action Parameters

pageSize
integerDefaults to 20
pageToken
string
excludeNonAppCreatedData
boolean

Action Response

data
object
successful
boolean
error

Copy a file

Action Parameters

file_id
stringRequired
new_title
string

Action Response

data
object
successful
boolean
error

Find events in a google calendar based on a search query.

Action Parameters

calendar_id
stringDefaults to primary
query
string
max_results
integerDefaults to 10
order_by
string
show_deleted
boolean
single_events
booleanDefaults to True
timeMax
string
timeMin
string
updated_min
string
event_types
arrayDefaults to ['default', 'outOfOffice', 'focusTime', 'workingLocation']
page_token
string

Action Response

data
object
successful
boolean
error

Downloads a media item from google photos and returns it as a file.

Action Parameters

mediaItemId
stringRequired

Action Response

data
object
successful
boolean
error

Get an attachment from a mail.

Action Parameters

user_id
stringDefaults to me
message_id
stringRequired
attachment_id
stringRequired
file_name
stringRequired

Action Response

data
object
successful
boolean
error

Remove an attendee from an existing event in a google calendar.

Action Parameters

calendar_id
stringDefaults to primary
event_id
stringRequired
attendee_email
stringRequired

Action Response

data
object
successful
boolean
error

Updates a media item’s description in google photos.

Action Parameters

mediaItemId
stringRequired
description
string

Action Response

data
object
successful
boolean
error

Returns the album based on the specified albumid.

Action Parameters

albumId
stringRequired

Action Response

data
object
successful
boolean
error