メッセージにリアクションを追加する

このガイドでは、Google Chat API の Reaction リソースの create() メソッドを使用して、メッセージにリアクション（👍、🚲、🌞 など）を追加する方法について説明します。

Reaction リソース は、ユーザーがメッセージにリアクションするために使用できる絵文字（👍、🚲、 🌞 など）を表します。

前提条件

Node.js

メッセージにリアクションを追加する

メッセージに対するリアクションを作成するには、リクエストで次の情報を渡します。

  • chat.messages.reactions.create、chat.messages.reactions、または chat.messages 認可スコープを指定します。
  • CreateReaction() メソッドを呼び出し、リアクションするメッセージのリソース名として parent を渡し、reaction を Reaction のインスタンスとして渡します。このインスタンスでは、unicode フィールドが Unicode 文字列で表される標準の絵文字です。

次の例では、😀 絵文字でメッセージにリアクションします。

Node.js

chat/client-libraries/cloud/create-reaction-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.messages.reactions.create',
];

// This sample shows how to create reaction to a message with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and MESSAGE_NAME here.
    parent: 'spaces/SPACE_NAME/messages/MESSAGE_NAME',
    reaction: {
      // A standard emoji represented by a unicode string.
      emoji: {unicode: '😀'},
    },
  };

  // Make the request
  const response = await chatClient.createReaction(request);

  // Handle the response
  console.log(response);
}

await main();

このサンプルを実行するには、次の値を置き換えます。

  • SPACE_NAME: スペースの nameからの ID。 ID は、 ListSpaces() メソッドを呼び出すか、スペースの URL から取得できます。
  • MESSAGE_NAME: メッセージの nameからの ID。 ID は、Chat API を使用してメッセージを非同期で作成した後に返されるレスポンス本文から取得できます。また、作成時にメッセージに割り当てられた カスタム名 から取得することもできます。

Chat API は、作成されたリアクションの詳細を示す Reaction のインスタンスを返します。