Gws Chat

Helper Commands

API Resources

customEmojis

• create — Creates a custom emoji. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see Learn about custom emojis in Google Chat (opens in a new tab) and Manage custom emoji permissions (opens in a new tab).
• delete — Deletes a custom emoji. By default, users can only delete custom emoji they created. Emoji managers (opens in a new tab) assigned by the administrator can delete any custom emoji in the organization. See Learn about custom emojis in Google Chat (opens in a new tab). Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization.
• get — Returns details about a custom emoji. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see Learn about custom emojis in Google Chat (opens in a new tab) and Manage custom emoji permissions (opens in a new tab).
• list — Lists custom emojis visible to the authenticated user. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see Learn about custom emojis in Google Chat (opens in a new tab) and Manage custom emoji permissions (opens in a new tab).

media

• download — Downloads media. Download is supported on the URI /v1/media/{+name}?alt=media.
• upload — Uploads an attachment. For an example, see Upload media as a file attachment (opens in a new tab).

spaces

• completeImport — Completes the import process (opens in a new tab) for the specified space and makes it visible to users.
• create — Creates a space. Can be used to create a named space, or a group chat in Import mode. For an example, see Create a space (opens in a new tab).
• delete — Deletes a named space. Always performs a cascading delete, which means that the space’s child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see Delete a space (opens in a new tab).
• findDirectMessage — Returns the existing direct message with the specified user. If no direct message space is found, returns a 404 NOT_FOUND error. For an example, see Find a direct message (opens in a new tab). With app authentication (opens in a new tab), returns the direct message space between the specified user and the calling Chat app.
• get — Returns details about a space. For an example, see Get details about a space (opens in a new tab).
• list — Lists spaces the caller is a member of. Group chats and DMs aren’t listed until the first message is sent. For an example, see List spaces (opens in a new tab).
• patch — Updates a space. For an example, see Update a space (opens in a new tab). If you’re updating the displayName field and receive the error message ALREADY_EXISTS, try a different display name.. An existing space within the Google Workspace organization might already use this display name.
• search — Returns a list of spaces in a Google Workspace organization based on an administrator’s search. In the request, set use_admin_access to true. For an example, see Search for and manage spaces (opens in a new tab).
• setup — Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn’t be specified as a membership in the request. For an example, see Set up a space with initial members (opens in a new tab). To specify the human members to add, add memberships with the appropriate membership.member.name. To add a human user, use users/{user}, where {user} can be the email address for the user.
• members — Operations on the ‘members’ resource
• messages — Operations on the ‘messages’ resource
• spaceEvents — Operations on the ‘spaceEvents’ resource

users

• sections — Operations on the ‘sections’ resource
• spaces — Operations on the ‘spaces’ resource

Discovering Commands

Before calling any API method, inspect it:

Use gws schema output to build your --params and --json flags.