NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Google Chat

google_chat

Google Chat API integration for messaging and collaboration in Google Workspace

ProductivityCommunicationWeb del proveedor
Acciones
36
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (36)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create Custom EmojiGOOGLE_CHAT_CREATE_CUSTOM_EMOJIAcción

Creates a custom emoji in Google Chat for use within an organization. Use this action when you need to add a custom emoji that can be used by members of your Google Workspace organization. The emoji will be available in Google Chat after creation. Note: Custom emojis are only available for Google Workspace accounts and require the administrator to enable custom emojis for the organization. This is a Developer Preview feature.

Parámetros de entrada

  • payloadobjectObligatorio

    The image payload for the custom emoji.

  • emoji_namestringObligatorio

    User-provided name for the emoji. Must be unique within the organization. Must start and end with colons (:), contain only lowercase letters, numbers, hyphens, and underscores. Example: ':party-emoji:'

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create MessageGOOGLE_CHAT_CREATE_MESSAGEAcción

Creates a message in a Google Chat space. With user authentication, only text messages are supported. Maximum message size is 32,000 bytes. Use this action when you need to send a message to a Google Chat space or channel. You can reply to existing threads by providing a thread_key, or start a new conversation. Messages can mention users using '@username' syntax. Note: With user auth, only plain text messages are supported. Card-based messages require bot authentication.

Parámetros de entrada

  • textstring

    Plain-text body of the message. With user authentication, this is the only supported field. Maximum message size is 32,000 bytes. You can mention users by using '@user' syntax.

  • parentstringObligatorio

    Resource name of the space to create the message in. Format: 'spaces/{space}'.

  • cards_v2object[]

    Rich card UI elements (bot authentication only). For user authentication, only text messages are supported.

  • thread_keystring

    Client-generated thread key to reply to an existing thread or start a new one. If the thread already exists, this message is added to it; otherwise, a new thread is created. This key is unique per Chat app.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create ReactionGOOGLE_CHAT_CREATE_REACTIONAcción

Creates an emoji reaction on a Google Chat message. Use this action when you need to add an emoji reaction (like 👍, ❤️, or 🎉) to an existing message in a Google Chat space. Either emoji_unicode or emoji_custom_id is required, but not both. This action is useful for acknowledging messages, voting on ideas, expressing emotions in response to messages, or building interactive message features in Google Chat bots.

Parámetros de entrada

  • parentstringObligatorio

    Resource name of the message to react to. Format: 'spaces/{space}/messages/{message}'.

  • emoji_unicodestring

    Unicode emoji to use for the reaction (e.g., '👍', '❤️', '🎉'). Either emoji_unicode or emoji_custom_id is required.

  • emoji_custom_idstring

    Resource name of a custom emoji to use for the reaction. Format: 'spaces/{space}/customEmojis/{custom_emoji}'. Either emoji_unicode or emoji_custom_id is required.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create sectionGOOGLE_CHAT_CREATE_SECTIONAcción

Creates a custom section in Google Chat for organizing conversations in the navigation panel. Use when you need to create a new custom section to organize spaces and direct messages in the user's Chat sidebar.

Parámetros de entrada

  • typestringObligatorioenum

    Required. The type of the section to create.

    SECTION_TYPE_UNSPECIFIEDCUSTOM_SECTIONDEFAULT_DIRECT_MESSAGESDEFAULT_SPACESDEFAULT_APPS
  • parentstringObligatorio

    Required. The user identifier. Use 'me' for the authenticated user or a specific user ID.

  • display_namestring

    Optional. The section's display name. Only populated for CUSTOM_SECTION type. Supports up to 80 characters. Required when creating a CUSTOM_SECTION.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create SpaceGOOGLE_CHAT_CREATE_SPACEAcción

Creates a named space or group chat in Google Chat. The calling user is automatically added as a member and space manager. Use this action when you need to create a new Google Chat space for team collaboration, project discussions, or group conversations. This action creates a named space that users can discover and join. Note: If you receive the error ALREADY_EXISTS when creating a space, try a different displayName. The displayName must be unique within the organization.

Parámetros de entrada

  • requestIdstring

    Optional. A unique identifier for this request. A random UUID is recommended. Specifying an existing request ID returns the space created with that ID instead of creating a new space. Specifying an existing request ID from the same Chat app with a different authenticated user returns an error.

  • spaceTypestringObligatorioenum

    The type of space to create. Use SPACE for a named space, GROUP_CHAT for a group conversation. DIRECT_MESSAGE is not supported for creation.

    SPACE_TYPE_UNSPECIFIEDSPACEGROUP_CHATDIRECT_MESSAGEROOM
  • descriptionstring

    A description of the space. Helps users understand the space's purpose. Supports up to 150 characters.

  • display_namestringObligatorio

    The display name of the space. Required when spaceType is SPACE. Supports up to 128 characters. An error ALREADY_EXISTS may occur if the name already exists.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Custom EmojiGOOGLE_CHAT_DELETE_CUSTOM_EMOJIAcción

Deletes a custom emoji from Google Chat. By default, users can only delete custom emojis they created. Emoji managers assigned by the administrator can delete any custom emoji in the organization. Use this action when you need to permanently remove a custom emoji that is no longer needed. This action is irreversible — once deleted, the custom emoji cannot be recovered.

Parámetros de entrada

  • namestringObligatorio

    Resource name of the custom emoji to delete. Format: customEmojis/{customEmoji}

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Member from SpaceGOOGLE_CHAT_DELETE_MEMBERAcción

Removes a user, Google Group, or app from a space. This action is irreversible — once removed, the member cannot be recovered and will need to be re-added to the space. Use when you need to remove a specific member from a Google Chat space. Note: Deleted members will lose access to the space immediately and will need to be re-invited if they need access again.

Parámetros de entrada

  • namestringObligatorio

    Resource name of the membership to delete. Format: spaces/{space}/members/{member}. You can get this value from the spaces.members.list response or from the spaces.get response.

  • use_admin_accessboolean

    When true, requests will be made using Google Workspace administrator privileges. The authenticated user must be a Google Workspace administrator. Optional.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete MessageGOOGLE_CHAT_DELETE_MESSAGEAcción

Deletes a message from a Google Chat space. Use this action when you need to remove a message that is no longer needed, was posted in error, or is outdated. App authentication can only delete messages created by the calling Chat app. User authentication with proper permissions can delete any message in a space they manage. This action is irreversible — once deleted, the message cannot be recovered.

Parámetros de entrada

  • namestringObligatorio

    Resource name of the message to delete. Format: spaces/{space}/messages/{message}. Custom IDs from clientAssignedMessageId field are supported.

  • forceboolean

    When true, deletes the message and all its threaded replies. When false, deletion fails if threaded replies exist. Only applies to user authentication. Defaults to false.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete ReactionGOOGLE_CHAT_DELETE_REACTIONAcción

Deletes a reaction to a message. Use when you need to remove a reaction that was previously added to a message. Users can only delete their own reactions. This action is irreversible — once the reaction is deleted, it cannot be recovered.

Parámetros de entrada

  • namestringObligatorio

    Required. The resource name of the reaction to delete. Format: spaces/{space}/messages/{message}/reactions/{reaction}

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete sectionGOOGLE_CHAT_DELETE_SECTIONAcción

Deletes a custom section from Google Chat by its ID. This action is irreversible — once a section is deleted, it cannot be recovered. If the section contains items (such as spaces), they are moved to Google Chat's default sections and are not deleted. Use when you need to remove a custom section that is no longer needed.

Parámetros de entrada

  • user_idstringObligatorio

    The user ID of the user who owns the section. Use 'me' for the authenticated user.

  • section_idstringObligatorio

    The unique ID of the section to delete. Section IDs can be obtained from list sections actions.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete spaceGOOGLE_CHAT_DELETE_SPACEAcción

Deletes a named space from Google Chat. Always performs a cascading delete, which means that the space's child resources like messages and memberships are also deleted. Use this action when you need to permanently remove a Google Chat space and all associated data. This action is irreversible — the space and all its messages and memberships cannot be recovered once deleted.

Parámetros de entrada

  • namestringObligatorio

    Resource name of the space to delete. Format: spaces/{space}. Example: spaces/AAQATWyCO-g

  • use_admin_accessboolean

    When true, the method runs using the calling user's Google Workspace administrator privileges. The requesting user must be a Google Workspace administrator. Requires the chat.admin.delete or chat.admin.delete.all OAuth scope.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Find Direct MessageGOOGLE_CHAT_FIND_DIRECT_MESSAGEAcción

Returns the existing direct message space with the specified user. Use this action when you need to find an existing DM space with a particular user, such as when checking if a DM already exists before creating one or when you need the space resource name for subsequent operations. If no direct message space exists with the specified user, this action returns a NOT_FOUND (404) error. Note: This only finds existing DM spaces - it does not create a new one. To create a new DM, use the create DM action instead.

Parámetros de entrada

  • namestringObligatorio

    Required. The resource name of the user to find a direct message with. Format: users/{user}. You can use 'me' as the alias for the authenticated user.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Find Group ChatsGOOGLE_CHAT_FIND_GROUP_CHATSAcción

Finds all group chat spaces that contain exactly the calling user and the specified users. This action uses the Google Chat Developer Preview API to search for GROUP_CHAT spaces whose human memberships contain exactly the calling user and the specified users. Use this action when you need to find existing group chats that include specific participants.

Parámetros de entrada

  • usersstring[]

    Resource names of all human users in the group chat. Max 49 users. Format: users/{user}

  • page_sizeinteger

    Maximum number of spaces to return. Values range from 1 to 30, inclusive.

  • page_tokenstring

    Page token for pagination. Use from a previous response's nextPageToken.

  • space_viewstring

    The view type to determine how much information is returned per space. One of: SPACE_VIEW_UNSPECIFIED, SPACE_VIEW_RESOURCE_NAME_ONLY, SPACE_VIEW_EXPANDED

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Chat Space MemberGOOGLE_CHAT_GET_MEMBERAcción

Returns details about a membership in a space. Use this action when you need to retrieve information about a specific member's relationship with a Google Chat space, including their role, state, and user details.

Parámetros de entrada

  • namestringObligatorio

    Resource name of the membership to retrieve. Format: `spaces/{space}/members/{member}`.

  • use_admin_accessboolean

    When true, requests the membership using Google Workspace administrator privileges. Requires the calling user to be a Google Workspace administrator with the chat.admin.memberships.readonly scope.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get MessageGOOGLE_CHAT_GET_MESSAGEAcción

Returns details about a specific message in a Google Chat space. Use this action when you need to retrieve the full content, sender information, thread details, and other metadata for a particular message. Requires user authentication with an appropriate Google Chat OAuth scope.

Parámetros de entrada

  • namestringObligatorio

    Required. The resource name of the message. Format: spaces/{space}/messages/{message}

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get SpaceGOOGLE_CHAT_GET_SPACEAcción

Returns details about a specific Google Chat space including configuration, membership count, and access settings. Use this action when you need to retrieve information about a specific space in Google Chat, such as getting the space's display name, description, membership count, threading state, or access settings. Note: Some response fields are only populated based on the OAuth scopes used. The accessSettings, predefinedPermissionSettings, and permissionSettings fields are only populated when using the chat.app.spaces scope. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.admin.spaces - https://www.googleapis.com/auth/chat.admin.spaces.readonly - https://www.googleapis.com/auth/chat.app.spaces - https://www.googleapis.com/auth/chat.bot - https://www.googleapis.com/auth/chat.spaces - https://www.googleapis.com/auth/chat.spaces.readonly

Parámetros de entrada

  • namestringObligatorio

    Required. Resource name of the space. Format: spaces/{space}.

  • use_admin_accessboolean

    When true, returns the space using Google Workspace administrator privileges. Requires the calling user to be a Google Workspace administrator with the chat.admin.memberships.readonly scope.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Space Notification SettingGOOGLE_CHAT_GET_SPACE_NOTIFICATION_SETTINGAcción

Gets the notification settings for a user in a specific space. Use when you need to retrieve the caller's space notification setting, including whether notifications are muted and what type of notifications are enabled. Requires user authentication with the `https://www.googleapis.com/auth/chat.users.spacesettings` OAuth scope.

Parámetros de entrada

  • userstringObligatorio

    Required. The user for which to retrieve notification settings. Use 'me' for the authenticated user, an email address like 'user@example.com', or a user ID like '123456789'.

  • spacestringObligatorio

    Required. The space ID for which to retrieve notification settings. Format: spaces/{space_id}

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get space read stateGOOGLE_CHAT_GET_SPACE_READ_STATEAcción

Returns details about a user's read state within a space. Use this action when you need to identify which messages in a space have been read or unread by the user.

Parámetros de entrada

  • namestringObligatorio

    Resource name of the space read state. Format: users/{user}/spaces/{space}/spaceReadState

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get thread read stateGOOGLE_CHAT_GET_THREAD_READ_STATEAcción

Returns details about a user's read state within a thread. Use this action when you need to identify which messages in a specific thread have been read or unread by the user.

Parámetros de entrada

  • namestringObligatorio

    Resource name of the thread read state. Format: users/{user}/spaces/{space}/threads/{thread}/threadReadState

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List custom emojisGOOGLE_CHAT_LIST_CUSTOM_EMOJISAcción

Lists custom emojis visible to the authenticated user in Google Chat. Use this action when you need to retrieve all custom emojis available in Google Chat for the authenticated user. This is useful for displaying available emojis, filtering by creator, or enumerating organization-specific custom emojis. Supports pagination via pageSize and pageToken parameters. By default, returns up to 25 emojis.

Parámetros de entrada

  • filterstring

    Query filter for custom emojis. Supports creator('users/me') or NOT creator('users/me') to filter by creator.

  • page_sizeinteger

    Maximum number of custom emojis to return. Default is 25, maximum is 200.

  • page_tokenstring

    Page token for pagination. Use the nextPageToken from a previous response to get the next page of results.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Space MembersGOOGLE_CHAT_LIST_MEMBERSAcción

Lists memberships in a space. Returns a list of all members including users, bots, and Google Groups. Use when you need to retrieve all members of a Google Chat space, such as to get a list of participants, check who has access, or find specific members by role or type. Supports pagination when there are many members in a space. Use the nextPageToken from a response to fetch subsequent pages.

Parámetros de entrada

  • parentstringObligatorio

    Resource name of the space to list memberships from. Format: spaces/{space}

  • pageSizeinteger

    Maximum number of memberships to return. The service may return fewer values. If unspecified, at most 25 memberships are returned. Must be between 1 and 1000.

  • pageTokenstring

    Token for pagination. Pass the nextPageToken from a previous call to retrieve the next page of results.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List MessagesGOOGLE_CHAT_LIST_MESSAGESAcción

Lists messages in a space that the authenticated user is a member of. Use this action when you need to retrieve messages from a Google Chat space, such as displaying message history, searching for specific messages, or monitoring space activity. Supports filtering and ordering of messages. Pagination is available via pageToken for retrieving large message sets. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.messages - https://www.googleapis.com/auth/chat.messages.readonly - https://www.googleapis.com/auth/chat.import

Parámetros de entrada

  • filterstring

    Optional. Query filter for messages. Supports filtering by sender, thread, and time.

  • parentstringObligatorio

    Required. The resource name of the space to list messages from. Format: spaces/{space}

  • orderBystring

    Optional. How the list of messages is ordered. Supports create_time asc or create_time desc.

  • page_sizeinteger

    Optional. Maximum number of messages to return. Defaults to 25, maximum is 1000.

  • page_tokenstring

    Optional. Token from previous list messages call to retrieve the next page.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List reactions on a messageGOOGLE_CHAT_LIST_REACTIONSAcción

Lists all reactions on a specific message in a Google Chat space. Use when you need to retrieve all emoji reactions (likes, thumbs up, hearts, etc.) that users have added to a message. This action is read-only and does not modify any data. The results can be filtered by emoji type or user using the filter parameter.

Parámetros de entrada

  • filterstring

    Query filter for reactions. For example, filter by emoji: 'emoji.emoji="\u00a1\u00a1"'

  • parentstringObligatorio

    Resource name of the message in format 'spaces/{space}/messages/{message}'

  • page_sizeinteger

    Maximum number of reactions to return. Must be between 1 and 200. If not specified, returns all reactions.

  • page_tokenstring

    Token for pagination. Use the nextPageToken from a previous response to get the next page of results.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Section ItemsGOOGLE_CHAT_LIST_SECTION_ITEMSAcción

Lists all items (such as spaces) within a specified section of a user's Google Chat. Use when you need to retrieve all items grouped under a section in Google Chat, or when implementing pagination to fetch all items across multiple pages. Sections can be system sections like 'default-spaces' or custom sections created by the user. Requires user authentication with the `https://www.googleapis.com/auth/chat.users.sections.readonly` (read-only) or `https://www.googleapis.com/auth/chat.users.sections` (full access) OAuth scope.

Parámetros de entrada

  • userstringObligatorio

    Required. The user who owns the section. Use 'me' for the authenticated user, or a user ID like '111477653670961777027'.

  • sectionstringObligatorio

    Required. The section ID. Common values include 'default-spaces', 'default-apps', 'default-direct-messages', or a custom section ID.

  • page_sizeinteger

    Maximum number of items to return. If unspecified, defaults to 25. Maximum is 100.

  • page_tokenstring

    Token for pagination. Use the nextPageToken from a previous response to retrieve the next page of results.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List SectionsGOOGLE_CHAT_LIST_SECTIONSAcción

Lists all sections available to the authenticated user in Google Chat. Use this action when you need to retrieve all sections for organizing conversations in the navigation panel. Sections include custom sections created by the user and system sections like default direct messages, default spaces, and default apps. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.users.sections - https://www.googleapis.com/auth/chat.users.sections.readonly

Parámetros de entrada

  • parentstringObligatorio

    Required. The user identifier. Use 'me' for the authenticated user or provide a specific user ID.

  • page_sizeinteger

    Optional. Maximum number of sections to return. Default value varies.

  • page_tokenstring

    Optional. Token for pagination. Use the nextPageToken value from a previous response to retrieve the next page.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Space EventsGOOGLE_CHAT_LIST_SPACE_EVENTSAcción

Lists events from a Google Chat space. Use when you need to retrieve historical events such as new messages, membership changes, or reactions from a specific Google Chat space. The filter parameter is required and must specify event type filters. Note: This action requires specifying event type filters in the filter parameter. Supported event types include message events (created, updated, deleted), membership events (created, updated, deleted), and reaction events.

Parámetros de entrada

  • filterstringObligatorio

    Required filter for space events. Use format: event_types:"EVENT_TYPE". For multiple types, separate with OR. Examples: 'event_types:"google.workspace.chat.message.v1.created"', 'event_types:"google.workspace.chat.membership.v1.created" OR event_types:"google.workspace.chat.membership.v1.deleted"'

  • parentstringObligatorio

    Resource name of the space to list events from. Format: spaces/{space}. You can get this value from the spaces.list response or from the space URL.

  • page_sizeinteger

    Maximum number of space events to return. Accepts values between 1 and 500. If not specified, defaults to 25.

  • page_tokenstring

    Token for pagination. Use the nextPageToken from a previous response to retrieve the next page of results.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List SpacesGOOGLE_CHAT_LIST_SPACESAcción

Lists spaces the authenticated user is a member of in Google Chat. Use this action when you need to retrieve all spaces that the user belongs to, such as displaying available spaces or finding a specific space. Note: Group chats and direct messages (DMs) are not listed until the first message is sent. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.spaces - https://www.googleapis.com/auth/chat.spaces.readonly - https://www.googleapis.com/auth/chat.bot

Parámetros de entrada

  • filterstring

    Optional. Query filter for space type. Format: spaceType = "VALUE" where VALUE can be SPACE, GROUP_CHAT, or DIRECT_MESSAGE. Use OR to separate multiple types. Cannot be SPACE_TYPE_UNSPECIFIED.

  • page_sizeinteger

    Optional. Maximum number of spaces to return. Defaults to 100, maximum is 1000. Values over 1000 are auto-adjusted to 1000.

  • page_tokenstring

    Optional. Token from previous list spaces call to retrieve the next page. Must match the original call's filter value.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Move Section ItemGOOGLE_CHAT_MOVE_SECTION_ITEMAcción

Moves a space from one section to another in Google Chat. Use when organizing spaces into different sections, such as moving a space from the default-spaces section to a custom user-created section. The action updates the section membership of the specified space item.

Parámetros de entrada

  • itemstringObligatorio

    The item ID. Format: items/{item}

  • userstringObligatorio

    The user ID. Format: users/{user}

  • sectionstringObligatorio

    The section ID. Format: sections/{section}

  • target_sectionstringObligatorio

    The target section to move the item to. Format: users/{user}/sections/{section}

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Position Section in SidebarGOOGLE_CHAT_POSITION_SECTIONAcción

Changes the sort order of a section in the Google Chat sidebar. Use when you need to reorder sections in the sidebar. Either sortOrder (absolute position) or relativePosition (START/END) must be provided to specify the new position.

Parámetros de entrada

  • userstringObligatorio

    The user ID or resource name. Format: users/{user}

  • sectionstringObligatorio

    The section ID or resource name. Format: sections/{section}

  • sort_orderinteger

    The absolute position of the section in the list. Must be greater than 0. If greater than the number of sections, the section appends to the end.

  • relative_positionstringenum

    Relative position options for section positioning.

    POSITION_UNSPECIFIEDSTARTEND

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Setup SpaceGOOGLE_CHAT_SET_UP_SPACEAcción

Creates a space and adds specified users and groups to it. Use this action when you need to create a space in Google Chat and automatically add initial members in a single operation. The calling user is automatically added to the created space. Supports creating named spaces (SPACE), group chats (GROUP_CHAT), and direct messages (DIRECT_MESSAGE). For named spaces, displayName is required. For group chats and DMs, at least one membership is typically required. Note: Google groups can only be added to named spaces. If a DM already exists between users, the existing DM is returned instead of creating a new one. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.spaces - https://www.googleapis.com/auth/chat.spaces.create

Parámetros de entrada

  • requestIdstring

    A unique identifier for this request. A random UUID is recommended. Specifying an existing request ID returns the space created with that ID instead of creating a new space.

  • spaceTypestringObligatorioenum

    Required. The type of space to create: SPACE for named spaces, GROUP_CHAT for group chats, or DIRECT_MESSAGE for 1:1 conversations.

    SPACE_TYPE_UNSPECIFIEDSPACEGROUP_CHATDIRECT_MESSAGE
  • displayNamestring

    The display name of the space. Required when spaceType is SPACE.

  • membershipsobject[]

    The Google Chat users or groups to invite. Up to 49 memberships allowed. Required for GROUP_CHAT and DIRECT_MESSAGE with humans. Must be empty when creating a DM with the calling app.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update MemberGOOGLE_CHAT_UPDATE_MEMBERAcción

Updates a membership in a Google Chat space, such as changing a member's role between member and manager. Use this action when you need to modify a user's role or permissions within a Google Chat space.

Parámetros de entrada

  • rolestringObligatorioenum

    Required. The new role for the member. Use ROLE_MEMBER for regular members, ROLE_MANAGER to make them a manager, or ROLE_ASSISTANT_MANAGER for assistant manager.

    MEMBERSHIP_ROLE_UNSPECIFIEDROLE_MEMBERROLE_MANAGERROLE_ASSISTANT_MANAGER
  • space_idstringObligatorio

    Required. Resource name of the space where the membership exists. Format: `spaces/{space}`

  • member_idstringObligatorio

    Required. Resource name of the member to update. Format: `spaces/{space}/members/{member}`

  • use_admin_accessboolean

    Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the manage chat and spaces conversations privilege.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update MessageGOOGLE_CHAT_UPDATE_MESSAGEAcción

Updates a message in a Google Chat space, modifying its text, cards, or other properties. Use this action when you need to edit an existing message's content or properties. Supports partial updates via the updateMask parameter. App authentication can only update messages created by the calling Chat app. User authentication with appropriate permissions can update any message in spaces they manage.

Parámetros de entrada

  • namestringObligatorio

    Required. Resource name of the message. Format: spaces/{space}/messages/{message}. Supports custom client-assigned IDs.

  • textstring

    Plain-text message body. Supports link previews and @mentions. Newlines can be represented with \n.

  • cardsV2object[]

    List of interactive cards (max 32KB total). Each card contains sections with widgets. Use this for rich interactive messages instead of deprecated 'cards'.

  • attachmentobject[]

    User-uploaded files to attach. Attachments are appended to existing attachments.

  • updateMaskstringObligatorio

    Required. Comma-separated list of field paths to update. Use '*' for full replacement. Supported fields: text, attachment, cards, cardsV2, accessoryWidgets, quotedMessageMetadata.

  • allowMissingboolean

    If true and the message specified by 'name' does not exist, creates a new message using the specified messageId (requires clientAssignedMessageId). Defaults to false.

  • fallbackTextstring

    Plain-text description of cards for fallback in notifications and when cards cannot be displayed.

  • quotedMessageMetadataobject

    Metadata for quoting a message. Includes name, lastUpdateTime, quoteType, and optionally forwardedMetadata.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update sectionGOOGLE_CHAT_UPDATE_SECTIONAcción

Updates a section's display name in Google Chat. This action uses patch semantics for partial updates. Use when you need to rename an existing custom section in Google Chat. Only sections of type 'CUSTOM_SECTION' can be updated. System sections (like 'default-direct-messages', 'default-spaces', 'default-apps') cannot have their display names modified. Requires user authentication with the 'https://www.googleapis.com/auth/chat.users.sections' scope.

Parámetros de entrada

  • userstring

    The user whose sections to update. Use 'me' to refer to the authenticated user. Format: 'users/{user}' or 'me' for the authenticated user.

  • sectionstringObligatorio

    The section ID to update. Format: 'users/{user}/sections/{section}'. For example: 'MTc3NTc5OTg0MTk4MzIwMTAxNA'.

  • update_maskstring

    The field mask specifying which fields to update. Currently supported: 'displayName'. Defaults to 'displayName' if not specified.

  • display_namestring

    The new display name for the section. Only sections of type 'CUSTOM_SECTION' can be updated. Supports up to 80 characters.

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update SpaceGOOGLE_CHAT_UPDATE_SPACEAcción

Updates a Google Chat space's configuration including display name, description, guidelines, history settings, access settings, and permission settings. Use this action when you need to modify the settings of an existing Google Chat space that you have admin or manager permissions for.

Parámetros de entrada

  • guidelinesstring

    Guidelines for the space. Max 5000 characters.

  • space_namestringObligatorio

    Required. Resource name of the space. Format: spaces/{space}

  • descriptionstring

    Description of the space. Max 150 characters.

  • update_maskstring

    Required. The field paths to update, comma-separated if multiple. Common values: displayName, description, guidelines, spaceHistoryState, predefinedPermissionSettings, permissionSettings

  • display_namestring

    New display name for the space. Max 128 characters.

  • space_history_statestringenum

    Defines the space history state for messages.

    HISTORY_OFFHISTORY_ON
  • predefined_permission_settingsstringenum

    Predefined permission settings for a space.

    COLLABORATION_SPACEANNOUNCEMENT_SPACE

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Space Notification SettingGOOGLE_CHAT_UPDATE_SPACE_NOTIFICATION_SETTINGAcción

Updates the notification settings for a user in a space. Use when you need to modify how a user receives notifications in a specific space, such as muting a noisy channel or changing the notification level to only important messages. Requires user authentication with the chat.users.spacesettings scope.

Parámetros de entrada

  • userstringObligatorio

    Identifier for the user. Use 'me' to refer to the authenticated user.

  • spacestringObligatorio

    Identifier of the space. Format: spaces/SPACE_ID.

  • updateMaskstringObligatorio

    Required. Comma-separated list of field paths to update. Supported: notification_setting, mute_setting.

  • muteSettingstringenum

    Mute setting options for space notifications.

    MUTE_SETTING_UNSPECIFIEDUNMUTEDMUTED
  • notificationSettingstringenum

    Notification setting options for space notifications.

    NOTIFICATION_SETTING_UNSPECIFIEDALLMAIN_CONVERSATIONSFOR_YOUOFF

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Space Read StateGOOGLE_CHAT_UPDATE_SPACE_READ_STATEAcción

Updates a user's read state within a space, used to mark messages as read or unread. Use this action when you need to programmatically mark a Google Chat space as read or update the user's read position in a space. Note: To mark a space as unread, set lastReadTime to a value earlier than the latest message timestamp. To mark as read, set it to any value later than the latest message.

Parámetros de entrada

  • userstringObligatorio

    Identifier for the user. Use 'me' to refer to the authenticated user.

  • spacestringObligatorio

    Identifier of the space. Format: spaces/SPACE_ID.

  • updateMaskstringObligatorio

    Required. Comma-separated list of field paths to update. Supported: lastReadTime.

  • lastReadTimestring

    The timestamp when the user's read state was last updated. When set to a time later than the latest message, the space appears as read. Format: RFC 3339 format (e.g., '2026-04-09T17:00:00.000Z').

Parámetros de salida

  • dataanyObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not