Develop with Google Chat

This page provides an overview of the Google Chat API and Google Chat apps.

Google Chat API overview

The Chat API consists of gRPC services or REST resources and methods that grant access to Chat, including spaces, space members, messages, message reactions, message attachments, space events, and user read states.

Concepts

The following section defines the services, resources, and methods for the Chat API:

Spaces

Spaces are places where people and apps can converse and share files. There are several types of spaces. Direct messages (DMs) are 1:1 conversations between two users or a user and a Chat app. Group chats are conversations between three or more users and Chat apps. Named spaces are persistent places where people send messages, share files, and collaborate.

Resource reference:

• RPC reference
• REST reference

For example usage, see:

• Create a space
• Set up a space
• Get a space
• List spaces
• Update a space
• Delete a space
• Find a direct message (DM)

Members

Members are users and Chat apps that have joined or are invited to a space.

Resource reference:

• RPC reference
• REST reference

For example usage, see:

• Create a membership
• Get a membership
• List memberships
• Update a membership
• Delete a membership

Messages

Messages include text and card communications posted in spaces. Messages can have files attached to them. People can react to messages by appending emoji to them.

Resource reference:

• RPC reference
• REST reference

For example usage, see:

• Create a message
• Get a message
• List messages
• Update a message
• Delete a message

Reactions

Reactions represent the emoji people use to react to a message, such as 👍, 🚲, and 🌞.

Resource reference:

• RPC reference
• REST reference

For example usage, see:

• Create a reaction
• List reactions
• Delete a reaction

Custom emoji

Custom emoji represent custom emoji created and shared within the organization in Google Chat. Custom emoji can be included in the content of a message or used to react to a message.

Resource reference:

• RPC reference
• REST reference

Media and attachments

Media represents a file uploaded to Google Chat, like images, videos, and documents.

Media resource reference (Unavailable in RPC):

• REST reference

Attachments are instances of media (files) attached to messages.

Resource reference:

• RPC reference
• REST reference

For example usage, see:

• Upload media as an attachment
• Download media as an attachment
• Get an attachment

Space events

Space events represent changes to a space or its child resources, including its members, messages, and reactions.

Resource reference:

• RPC reference
• REST reference

For example usage, see:

• Get space read state
• Update space read state
• Get thread read state

User read states

User read states are singleton resources that represent details about a specified user's last read message in a Google Chat space or a message thread.

Space read state resource reference:

• RPC reference
• REST reference

Thread read state resource reference:

• RPC reference
• REST reference

For example usage, see:

• Get space read state
• Update space read state
• Get thread read state

User space notification settings

User space notification settings are singleton resources that represent a specified user notification settings in a Google Chat space.

Resource reference:

• RPC reference
• REST reference

Authentication

Calling the Chat API requires authentication. Each Chat API method requires either user authentication (to perform actions or access data on behalf of a user) or app authentication (to perform actions or access data as a Chat app). Some methods support both user authentication and app authentication.

To learn more about authentication in Chat, see Authentication overview.

Client libraries

The recommended way for most developers to call the Google Chat API is with our officially supported Cloud Client Libraries for your preferred language, like Python, Java, or Node.js.

If you're coding with Google Apps Script, use the Advanced Chat service instead of installing a client library.

Build Chat apps

The Chat API lets you build Google Chat apps that bring your services and resources right into Google Chat. You can build Chat apps to do any of the following:

• Retrieve information based on structured or free text queries entered by the user.
• Generate incident reports or other artifacts, using information provided by the user.
• Enhance team collaboration, such as providing "team memory" or scheduling resources.

You can design your Chat app using several different architecture styles, including the following:

• Interactive apps: Respond to user interaction, such as @mentions or slash commands, and present information or guide users through a workflow with cards and dialogs.
• Command-line apps or webhooks: Send proactive messages, such as alarms or notifications, from another system into a space. Users can't directly interact with this type of app.
• Event-driven apps: Subscribe to and react to activity in a Chat space, such as a new member joining. In response to an event, the app can send a message or perform another action.

For details about designing your Chat app, see Choose a Google Chat app architecture.

Related topics

• Explore Google Chat app samples.
• Build interactive Google Chat apps.
• Choose a Google Chat app architecture.

Want to see the Google Chat API in action? The Google Workspace Developers channel offers videos about tips, tricks, and the latest features. Subscribe now