message: replyAll
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.
Responda a todos los destinatarios de un mensaje con formato JSON o MIME.
Cuando se usa el formato JSON:
- Especifique un comentario o la propiedad body del
message
parámetro . Al especificar ambos, se devolverá un error http 400 de solicitud incorrecta. - Si el mensaje original especifica un destinatario en la propiedad replyTo , por formato de mensaje de Internet (RFC 2822), envíe la respuesta a los destinatarios en replyTo y no al destinatario de la propiedad from .
Cuando se usa el formato MIME:
- Proporcione los encabezados de mensaje de Internet correspondientes y el contenido MIME, codificados en formato base64 en el cuerpo de la solicitud.
- Agregue datos adjuntos y propiedades S/MIME al contenido MIME.
Este método guarda el mensaje en la carpeta Elementos enviados.
Como alternativa, cree un borrador para responder a un mensaje y enviarlo más adelante.
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.Send | No disponible. |
Delegado (cuenta personal de Microsoft) | Mail.Send | No disponible. |
Aplicación | Mail.Send | No disponible. |
Solicitud HTTP
POST /users/me/messages/{id}/replyAll
POST /users/{id | userPrincipalName}/messages/{id}/replyAll
POST /me/mailFolders/{id}/messages/{id}/replyAll
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/replyAll
Encabezados de solicitud
Nombre | Tipo | Descripción |
---|---|---|
Authorization | string | {token} de portador. Obligatorio |
Content-Type | string | Naturaleza de los datos en el cuerpo de una entidad. Obligatorio Uso application/json para un objeto JSON y text/plain para contenido MIME |
Prefer: outlook.timezone | string | Establece la zona horaria del Sent campo del mensaje de respuesta en HTML que esta API crea en función del cuerpo de la solicitud. El valor puede ser cualquiera de los supportedTimeZones configurados para el usuario. Si no se especifica, ese Sent campo está en UTC.Use este encabezado solo si especifica el Content-Type: application/json encabezado para crear el mensaje de respuesta en HTML. Si usa el Content-Type: text/plain encabezado , este Prefer encabezado no tiene ningún efecto. Opcional. |
Cuerpo de la solicitud
Cuando use formato JSON, proporcione un objeto JSON con los parámetros siguientes.
Parámetro | Tipo | Descripción |
---|---|---|
comment | String | Comentario que se va a incluir. Puede ser una cadena vacía. |
mensaje | message | Cualquier propiedad que se pueda escribir para actualizar en el mensaje de respuesta. |
Al especificar el cuerpo en formato MIME, proporcione el contenido MIME con los encabezados de mensaje de Internet aplicables, todos codificados en formato base64 en el cuerpo de la solicitud. Este método carga el remitente y todos los destinatarios del mensaje original como destinatarios del nuevo mensaje.
Respuesta
Si se ejecuta correctamente, este método devuelve el código de respuesta 202 Accepted
. No devuelve nada en el cuerpo de la respuesta.
Si el cuerpo de la solicitud incluye contenido MIME con formato incorrecto, este método devuelve 400 Bad request
y el siguiente mensaje de error: "Cadena en base64 no válida para contenido MIME".
Ejemplos
Ejemplo 1: Respuesta a un mensaje en formato JSON
En el ejemplo siguiente se incluye un comentario y se agrega un archivo adjunto al mensaje reply-all.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaKAAA=/replyAll
Content-Type: application/json
{
"message":{
"attachments": [
{
"@odata.type": "#microsoft.graph.fileAttachment",
"name": "guidelines.txt",
"contentBytes": "bWFjIGFuZCBjaGVlc2UgdG9kYXk="
}
]
},
"comment": "Please take a look at the attached guidelines before you decide on the name."
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 202 Accepted
Ejemplo 2: Responder a un mensaje en formato MIME
Solicitud
POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaLAAA=/replyAll
Content-Type: text/plain
RnJvbTogQWxleCBXaWxiZXIgPEFsZXhXQGNvbnRvc28uY29tPgpUbzogTWVnYW4gQm93ZW4gPE1l
Z2FuQkBjb250b3NvLmNvbT4KU3ViamVjdDogSW50ZXJuYWwgUmVzdW1lIFN1Ym1pc3Npb246IFNh
bGVzIEFzc29jaWF0ZQpUaHJlYWQtVG9waWM...
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 202 Accepted
Si el cuerpo de la solicitud incluye contenido MIME con formato incorrecto, este método devuelve el siguiente mensaje.
HTTP/1.1 400 Bad Request
Content-type: application/json
{
"error": {
"code": "ErrorMimeContentInvalidBase64String",
"message": "Invalid base64 string for MIME content."
}
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte:Enviar y ver comentarios de