Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Anular la configuración de una reacción a un único chatMessage o una respuesta de mensaje de chat en un canal o un chat.
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global | Administración pública de EE. UU. | Gobierno de EE. UU. L5 (DOD) | China operado por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
Permisos para el canal
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | ChannelMessage.Send |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | No admitida. |
Permisos para chat
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | Chat. Lectura y escritura y ChatMessage.Send |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | No admitida. |
Solicitud HTTP
Para anular la configuración de una reacción a un chatMessage en un canal:
POST /teams/{teamsId}/channels/{channelId}/messages/{chatMessageId}/unsetReaction
POST /teams/{teamId}/channels/{channelId}/messages/{messageId}/replies/{replyId}/unsetReaction
Para anular la configuración de una reacción a un chatMessage en un chat:
POST /chats/{chatId}/messages/{chatMessageId}/unsetReaction
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización. |
| Content-Type | application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| displayName | Cadena | El nombre para mostrar del emoji personalizado. Opcional. Cuando reactionType sea custom, especifique displayName, reactionId o ambos. |
| reactionId | Cadena | El identificador emitido por el servicio del emoji personalizado. Opcional. Cuando reactionType sea custom, especifique displayName, reactionId o ambos. |
| tipo de reacción | Cadena | El tipo de reacción. Obligatorio. Especifique un carácter Unicode para una reacción estándar o custom para una reacción de emoji personalizada. |
Si especifica displayName y reactionId, deben identificar el mismo emoji personalizado en el ámbito empresarial.
Respuesta
Si se ejecuta correctamente, esta acción devuelve un código de respuesta 204 No Content.
Esta acción también devuelve un 400 Bad Request código de respuesta si reactionType es custom y no se proporcionan displayName ni reactionId , o si los identificadores proporcionados se resuelven en diferentes emojis personalizados. La acción devuelve un 404 Not Found código de respuesta si el emoji personalizado no se puede resolver en el espacio empresarial.
Ejemplos
Ejemplo 1: Anular la configuración de una reacción a un mensaje de chat
En el siguiente ejemplo se muestra cómo anular la configuración de una reacción a un mensaje de chat.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/chats/19:8b1131f7c9e64f7b9b4b3f6d2f6f15a7@thread.v2/messages/1700000000000/unsetReaction
Content-Type: application/json
{
"reactionType": "💘"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content
Ejemplo 2: Anular la configuración de una reacción a un mensaje en un canal
En el ejemplo siguiente se muestra cómo anular la configuración de una reacción a un mensaje en un canal.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
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": "💘"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content
Ejemplo 3: Anular la configuración de una reacción a una respuesta de mensaje
En el ejemplo siguiente se muestra cómo anular la configuración de una reacción a una respuesta de mensaje.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
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": "💘"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content
Ejemplo 4: Desestablecer una reacción de emoji personalizada por nombre para mostrar e id. de reacción
En el siguiente ejemplo se muestra cómo anular la configuración de una reacción de emoji personalizada por nombre para mostrar e Id. de reacción.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
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"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content