Manage Google Chat spaces, the places where conversations happen, and their messages through the gws command-line tool. Create or update spaces, add members, send messages, and upload or download attachments.
Google Chat: Manage Chat spaces and messages.
Review the instructions the agent will receive before you install.
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws chat <resource> <method> [flags]
| Command | Description |
|---|---|
+send | Send a message to a space |
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 and Manage custom emoji permissions.delete — Deletes a custom emoji. By default, users can only delete custom emoji they created. Emoji managers assigned by the administrator can delete any custom emoji in the organization. See Learn about custom emojis in Google Chat. 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 and Manage custom emoji permissions.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 and Manage custom emoji permissions.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.completeImport — Completes the import process 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.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.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. With app authentication, 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.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.patch — Updates a space. For an example, see Update a space. 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.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. 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' resourcemessages — Operations on the 'messages' resourcespaceEvents — Operations on the 'spaceEvents' resourcesections — Operations on the 'sections' resourcespaces — Operations on the 'spaces' resourceBefore calling any API method, inspect it:
# Browse resources and methods
gws chat --help
# Inspect a method's required params, types, and defaults
gws schema chat.<resource>.<method>
Use gws schema output to build your --params and --json flags.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Retrieve Google Workspace audit logs, which record account activity, and usage reports through gws. Review activity in applications such as the Admin console and Google Drive, or inspect statistics for the organization, users, and entities.
Manage Google Calendar events and calendars, including creating, updating, and deleting events. View upcoming events across calendars, check availability, and manage the permissions that control who can access a calendar.
View upcoming Google Calendar events across all calendars in one agenda. Check today, tomorrow, this week, or a chosen number of days, with options to filter calendars and change the display time zone.
Create a Google Calendar event with a title and start and end times. You can also choose a calendar, add a location and description, invite attendees, and include a Google Meet link.
Send plain text messages to a specified Google Chat space using the gws command line tool. Use it for team updates and announcements, with guidance on finding space identifiers and confirming messages before sending.
Manage Google Classroom courses, class lists, coursework, and invitations through an agent. Use it to create or update classes, check course details, and handle teacher or student invitations with the gws command-line tool.