メッセージからリアクションを削除する

このガイドでは、Google Chat API の Reaction リソースの delete() メソッドを使用して、メッセージからリアクション（👍?、🚲?、🌞? など）を削除する方法について説明します。リアクションを削除しても、メッセージは削除されません。

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

前提条件

Node.js

• Google Chat へのアクセス権を持つビジネスまたはエンタープライズ向け Google Workspace アカウント。

• 環境を設定します。
  • Google Cloud プロジェクトを作成します。
  • OAuth 同意画面を構成する
  • Google Chat API を有効にして構成し、Chat アプリの名前、アイコン、説明を指定します。
  • Node.js の Cloud クライアント ライブラリをインストールします。
  • デスクトップ アプリケーションの OAuth クライアント ID 認証情報を作成します。このガイドのサンプルを実行するには、認証情報を client_secrets.json という名前の JSON ファイルとしてローカル ディレクトリに保存します。
  ガイダンスについては、こちらのクイックスタートで環境の設定手順を完了してください。
• ユーザー認証をサポートする 認可スコープを選択します。

このページのコードサンプルでは、Google Cloud クライアント ライブラリで gRPC API インターフェースを使用しています。また、REST API インターフェースを使用することもできます。gRPC インターフェースと REST インターフェースの詳細については、Google Chat API の概要をご覧ください。

リアクションを削除する

メッセージからリアクションを削除するには、リクエストで次のように渡します。

• chat.messages.reactions または chat.messages の認可スコープを指定します。
• 削除するリアクションのリソース名として name を指定して、DeleteReaction() メソッドを呼び出します。

次の例では、メッセージから 😀? のリアクションを削除します。

Node.js

chat/client-libraries/cloud/delete-reaction-user-cred.js

GitHub で表示

import {createClientWithUserCredentials} from './authentication-utils.js';

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

// This sample shows how to delete a 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, MESSAGE_NAME, and REACTION_NAME here
    name: 'spaces/SPACE_NAME/messages/MESSAGE_NAME/reactions/REACTION_NAME'
  };

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

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

main().catch(console.error);

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

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

成功すると、レスポンスの本文は空になります。これは、リアクションが削除されたことを示します。

関連トピック

• メッセージにリアクションを追加する。
• メッセージのリアクションを一覧表示する。