名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
チャネルまたはチャット内の 1 つの chatMessage またはチャット メッセージの返信に対するリアクションの設定を解除します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
チャネルのアクセス許可
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | ChannelMessage.Send |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | サポートされていません。 |
チャットのアクセス許可
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | Chat.ReadWrite、ChatMessage.Send |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | サポートされていません。 |
HTTP 要求
チャネルの chatMessage に対するリアクションの設定を解除するには:
POST /teams/{teamsId}/channels/{channelId}/messages/{chatMessageId}/unsetReaction
POST /teams/{teamId}/channels/{channelId}/messages/{messageId}/replies/{replyId}/unsetReaction
チャットで chatMessage へのリアクションの設定を解除するには:
POST /chats/{chatId}/messages/{chatMessageId}/unsetReaction
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-Type | application/json. 必須です。 |
要求本文
リクエストの本文には、次のパラメーターを含む JSON オブジェクトを指定します。
| パラメーター | 型 | 説明 |
|---|---|---|
| displayName | 文字列 | カスタム絵文字の表示名。 省略可能。
reactionType が custom の場合は、displayName、reactionId、またはその両方を指定します。 |
| reactionId | 文字列 | サービス発行のカスタム絵文字識別子。 省略可能。
reactionType が custom の場合は、displayName、reactionId、またはその両方を指定します。 |
| reactionType | 文字列 | 反応の種類。 必須です。 標準のリアクションには Unicode 文字を指定し、カスタム絵文字リアクションには custom を指定します。 |
displayName と reactionId の両方を指定する場合は、同じテナントを対象とするカスタム絵文字を識別する必要があります。
応答
成功した場合、このアクションは 204 No Content 応答コードを返します。
reactionType がcustomで displayName も reactionId も指定されていない場合、または指定した識別子が別のカスタム絵文字に解決される場合も、このアクションは400 Bad Request応答コードを返します。 カスタム絵文字がテナント内で解決できない場合、アクションは 404 Not Found 応答コードを返します。
例
例 1:チャット メッセージへのリアクションの設定を解除する
次の例は、チャット メッセージに対するリアクションの設定を解除する方法を示しています。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/chats/19:8b1131f7c9e64f7b9b4b3f6d2f6f15a7@thread.v2/messages/1700000000000/unsetReaction
Content-Type: application/json
{
"reactionType": "💘"
}
応答
次の例は応答を示しています。
HTTP/1.1 204 No Content
例 2:チャネルのメッセージに対するリアクションの設定を解除する
次の例は、チャネル内のメッセージに対するリアクションの設定を解除する方法を示しています。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4a95f7d8db4c4e7fae1ec0b28d1d8a52@thread.tacv2/messages/1700000000000/unsetReaction
Content-Type: application/json
{
"reactionType": "💘"
}
応答
次の例は応答を示しています。
HTTP/1.1 204 No Content
例 3:メッセージ返信へのリアクションの設定を解除する
次の例は、返信メッセージに対するリアクションの設定を解除する方法を示しています。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4a95f7d8db4c4e7fae1ec0b28d1d8a52@thread.tacv2/messages/1700000000000/replies/1700000001000/unsetReaction
Content-Type: application/json
{
"reactionType": "💘"
}
応答
次の例は応答を示しています。
HTTP/1.1 204 No Content
例 4: 表示名とリアクション ID によるカスタム絵文字リアクションの設定を解除する
次の例は、表示名とリアクション ID によるカスタム絵文字リアクションの設定を解除する方法を示しています。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/chats/19:8b1131f7c9e64f7b9b4b3f6d2f6f15a7@thread.v2/messages/1700000000000/unsetReaction
Content-Type: application/json
{
"reactionType": "custom",
"displayName": "party-parrot",
"reactionId": "opaque-service-issued-id"
}
応答
次の例は応答を示しています。
HTTP/1.1 204 No Content