message: recall
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.
Recuerdos un mensaje en la carpeta Elementos enviados del buzón de usuario especificado.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | Mail.ReadWrite | No disponible. |
| Delegado (cuenta personal de Microsoft) | Mail.ReadWrite | No disponible. |
| Aplicación | Mail.ReadWrite | No disponible. |
Solicitud HTTP
POST /me/mailFolders/sentitems/messages/{id}/recall
POST /users/{id | userPrincipalName}/mailFolders/sentitems/messages/{id}/recall
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 202 Accepted código de respuesta y una cadena que contiene información del servidor en el cuerpo de la respuesta.
Si el identificador no es válido, este método devuelve y 400 Bad request la información de error detallada en el cuerpo de la respuesta.
Ejemplo
En el siguiente ejemplo se muestra cómo llamar a esta API.
Solicitud
La siguiente solicitud recupera el mensaje especificado en la carpeta de elementos enviados del buzón de correo del usuario especificado.
Nota: El identificador aquí se abrevia para mejorar la legibilidad.
POST https://graph.microsoft.com/beta/me/mailFolders/sentitems/messages/AAMkADhAAATs28OAAA=/recall
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 202 Accepted
Content-Type: application/json
{
"Successfully submitted recall request to Hub server LV8PR00MB1800.NAMPRD00.PROD.OUTLOOK.COM, MessageId is CSRUBSZRRANU4.HEXMGAAG0OPH2@dm6pr00mb0830."
}