@swamp/gcp/chat
v2026.04.23.1
Google Cloud chat infrastructure models
Repository
https://github.com/systeminit/swamp-extensions
Labels
gcpgoogle-cloudchatcloudinfrastructure
Contents
Quality score
Verified by SwampHow well-documented and verifiable this extension is.
Grade A
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types1/1earned
- Has description1/1earned
- At least one platform tag (or universal)1/1earned
- Two or more platform tags (or universal)1/1earned
- License declared1/1earned
- Verified public repository2/2earned
Install
$ swamp extension pull @swamp/gcp/chatusers_sections_items.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| name | string | Instance name for this resource (used as the unique identifier in the factory pattern) |
| parent? | string | The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456) |
getGet a items
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the items |
syncSync items state from GCP
movemove
| Argument | Type | Description |
|---|---|---|
| targetSection? | any |
users_sections.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| displayName? | string | Optional. The section's display name. Only populated for sections of type `CUSTOM_SECTION`. Supports up to 80 characters. Required when creating a `CUSTOM_SECTION`. |
| name? | string | Identifier. Resource name of the section. For system sections, the section ID is a constant string: - DEFAULT_DIRECT_MESSAGES: `users/{user}/sections/default-direct-messages` - DEFAULT_SPACES: `users/{user}/sections/default-spaces` - DEFAULT_APPS: `users/{user}/sections/default-apps` Format: `users/{user}/sections/{section}` |
| type? | enum | Required. The type of the section. |
| parent? | string | The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456) |
createCreate a sections
getGet a sections
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the sections |
updateUpdate sections attributes
deleteDelete the sections
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the sections |
syncSync sections state from GCP
positionposition
| Argument | Type | Description |
|---|---|---|
| relativePosition? | any | |
| sortOrder? | any |
spaces.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| accessSettings? | object | Output only. Indicates the access state of the space. |
| customer? | string | Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource](https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. This field isn't populated for direct messages (DMs) or when the space is created by non-Google Workspace users. |
| displayName? | string | Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. |
| importMode? | boolean | Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). |
| membershipCount? | object | Output only. Count of human users that have directly joined the space, not counting users joined by having membership in a joined group. |
| name? | string | Identifier. Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`. |
| permissionSettings? | object | Optional. Whether space managers `ROLE_ASSISTANT_MANAGER`) have this permission. |
| predefinedPermissionSettings? | enum | Optional. Input only. Predefined space permission settings, input only when creating a space. If the field is not set, a collaboration space is created. After you create the space, settings are populated in the `PermissionSettings` field. Setting predefined permission settings supports: - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) with the `chat.app.spaces` or `chat.app.spaces.create` scopes. - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) |
| singleUserBotDm? | boolean | Optional. Whether the space is a DM between a Chat app and a single human. |
| spaceDetails? | object | Optional. A description of the space. For example, describe the space's discussion topic, functional purpose, or participants. Supports up to 150 characters. |
| spaceHistoryState? | enum | Optional. The message history state for messages and threads in this space. |
| requestId? | string | 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. |
createCreate a spaces
getGet a spaces
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the spaces |
updateUpdate spaces attributes
deleteDelete the spaces
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the spaces |
syncSync spaces state from GCP
complete_importcomplete import
find_direct_messagefind direct message
find_group_chatsfind group chats
searchsearch
setupsetup
| Argument | Type | Description |
|---|---|---|
| memberships? | any | |
| requestId? | any | |
| space? | any |
spaces_messages_reactions.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| emoji? | object | Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:` |
| name? | string | Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` |
| user? | object | Output only. The user's display name. |
| parent? | string | The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456) |
createCreate a reactions
getGet a reactions
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the reactions |
deleteDelete the reactions
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the reactions |
syncSync reactions state from GCP
spaces_spaceevents.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| name | string | Instance name for this resource (used as the unique identifier in the factory pattern) |
| parent? | string | The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456) |
getGet a spaceEvents
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the spaceEvents |
syncSync spaceEvents state from GCP
users_spaces_spacenotificationsetting.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| muteSetting? | enum | The space notification mute setting. |
| name? | string | Identifier. The resource name of the space notification setting. Format: `users/{user}/spaces/{space}/spaceNotificationSetting`. |
| notificationSetting? | enum | The notification setting. |
getGet a spaceNotificationSetting
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the spaceNotificationSetting |
updateUpdate spaceNotificationSetting attributes
syncSync spaceNotificationSetting state from GCP
spaces_messages_attachments.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| name | string | Instance name for this resource (used as the unique identifier in the factory pattern) |
getGet a attachments
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the attachments |
syncSync attachments state from GCP
spaces_messages.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| accessoryWidgets? | array | The alternative text that\'s used for accessibility. Set descriptive text that lets users know what the button does. For example, if a button opens a hyperlink, you might write: "Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat". |
| actionResponse? | object | The status code. |
| attachment? | array | Optional. Opaque token containing a reference to an uploaded attachment. Treated by clients as an opaque string and used to create or update Chat messages with attachments. |
| cardsV2? | array | The label that displays as the action menu item. |
| clientAssignedMessageId? | string | Optional. A custom ID for the message. You can use field to identify a message, or to get, delete, or update a message. To set a custom ID, specify the [`messageId`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id) field when you create the message. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). |
| deletionMetadata? | object | Indicates who deleted the message. |
| fallbackText? | string | Optional. A plain-text description of the message's cards, used when the actual cards can't be displayed—for example, mobile notifications. |
| matchedUrl? | object | Output only. The URL that was matched. |
| name? | string | Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). |
| privateMessageViewer? | object | Output only. The user's display name. |
| quotedMessageMetadata? | object | Output only. The resource name of the source space. Format: spaces/{space} |
| sender? | object | Output only. The user's display name. |
| slashCommand? | object | The ID of the slash command. |
| space? | object | Output only. Indicates the access state of the space. |
| text? | string | Optional. Plain-text body of the message. The first link to an image, video, or web page generates a [preview chip](https://developers.google.com/workspace/chat/preview-links). You can also [@mention a Google Chat user](https://developers.google.com/workspace/chat/format-messages#messages-@mention), or everyone in the space. To learn about creating text messages, see [Send a message](https://developers.google.com/workspace/chat/create-messages). |
| thread? | object | Identifier. Resource name of the thread. Example: `spaces/{space}/threads/{thread}` |
| messageId? | string | Optional. A custom ID for a message. Lets Chat apps get, update, or delete a message without needing to store the system-assigned ID in the message's resource name (represented in the message `name` field). The value for this field must meet the following requirements: * Begins with `client-`. For example, `client-custom-name` is a valid custom ID, but `custom-name` is not. * Contains up to 63 characters and only lowercase letters, numbers, and hyphens. * Is unique within a space. A Chat app can't use the same custom ID for different messages. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). |
| messageReplyOption? | string | Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. When [responding to user interactions](https://developers.google.com/workspace/chat/receive-respond-interactions), this field is ignored. For interactions within a thread, the reply is created in the same thread. Otherwise, the reply is created as a new thread. |
| requestId? | string | Optional. A unique request ID for this message. Specifying an existing request ID returns the message created with that ID instead of creating a new message. |
| parent? | string | The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456) |
createCreate a messages
getGet a messages
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the messages |
updateUpdate messages attributes
deleteDelete the messages
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the messages |
syncSync messages state from GCP
spaces_members.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| groupMember? | object | Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} |
| member? | object | Output only. The user's display name. |
| name? | string | Identifier. Resource name of the membership, assigned by the server. Format: `spaces/{space}/members/{member}` |
| role? | enum | Optional. User's role within a Chat space, which determines their permitted actions in the space. This field can only be used as input in `UpdateMembership`. |
| useAdminAccess? | string | 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](https://support.google.com/a/answer/13369245). Requires the `chat.admin.memberships` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes). Creating app memberships or creating memberships for users outside the administrator's Google Workspace organization isn't supported using admin access. |
| parent? | string | The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456) |
createCreate a members
getGet a members
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the members |
updateUpdate members attributes
deleteDelete the members
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the members |
syncSync members state from GCP
customemojis.tsv2026.04.23.1
Global Arguments
| Argument | Type | Description |
|---|---|---|
| name? | string | Identifier. The resource name of the custom emoji, assigned by the server. Format: `customEmojis/{customEmoji}` |
| payload? | object | Required. Input only. The image used for the custom emoji. The payload must be under 256 KB and the dimension of the image must be square and between 64 and 500 pixels. The restrictions are subject to change. |
createCreate a customEmojis
getGet a customEmojis
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the customEmojis |
deleteDelete the customEmojis
| Argument | Type | Description |
|---|---|---|
| identifier | string | The name of the customEmojis |
syncSync customEmojis state from GCP
2026.04.08.1101.2 KBApr 8, 2026
Google Cloud chat infrastructure models
Release Notes
- Updated: spaces
linux-x86_64linux-aarch64darwin-x86_64darwin-aarch64
gcpgoogle-cloudchatcloudinfrastructure
2026.04.04.1100.9 KBApr 4, 2026
Google Cloud chat infrastructure models
Release Notes
- Updated: spaces_messages, spaces_spaceevents
linux-x86_64linux-aarch64darwin-x86_64darwin-aarch64
gcpgoogle-cloudchatcloudinfrastructure