This guide explains how to use the list() method on the Reaction resource of the Google Chat API to list reactions for a message—like 👍, 🚲, and 🌞.

The Reaction resource represents an emoji that people can use to react to a message, such as 👍, 🚲, and 🌞.

Prerequisites

Node.js

• A Business or Enterprise Google Workspace account with access to Google Chat.

• Set up your environment:
  • Create a Google Cloud project.
  • Configure the OAuth consent screen.
  • Enable and configure the Google Chat API with a name, icon, and description for your Chat app.
  • Install the Node.js Cloud Client Library.
  • Create OAuth client ID credentials for a desktop application. To run the sample in this guide, save the credentials as a JSON file named credentials.json to your local directory.
  For guidance, complete the steps for setting up your environment in this quickstart.
• Choose an authorization scope that supports user authentication.

To list the reactions for a message, pass the following in your request:

• Specify the chat.messages.reactions.readonly, chat.messages.reactions, chat.messages.readonly, or chat.messages authorization scope.
• Call the ListReactions() method, passing the parent as the resource name of the message.

The following example lists reactions for a specified message:

Node.js

To run this sample, replace the following:

• SPACE_NAME: the ID from the space's name. You can obtain the ID by calling the ListSpaces() method or from the space's URL.
• MESSAGE_NAME: the ID from the message's name. You can obtain the ID from the response body returned after creating a message asynchronously with the Chat API, or with the custom name assigned to the message at creation.

The Chat API returns a paginated list of reactions.

• Add a reaction to a message.
• Delete a reaction from a message.