message: reply

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.

Responder al remitente de un mensaje con el formato JSON o MIME.

Cuando se usa el formato JSON:

  • Especifique un comentario o la propiedad body del message parámetro. Si se especifican ambos, se devolverá un error HTTP 400 Bad Request .
  • Si el mensaje original especifica un destinatario en la propiedad replyTo , según Internet Message Format (RFC 2822), enviar la respuesta a los destinatarios en replyTo y no al destinatario en la propiedad from .

Cuando se usa el formato 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 tarde.

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
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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 /me/messages/{id}/reply
POST /users/{id | userPrincipalName}/messages/{id}/reply
POST /me/mailFolders/{id}/messages/{id}/reply
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/reply

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
Se usa application/json para un objeto JSON y text/plain para contenido MIME
Prefer: outlook.timezone string Establece la zona horaria para el 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 las supportedTimeZones configuradas 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 tendrá ningún efecto. Opcional.

Cuerpo de la solicitud

Al usar el formato JSON, incluya un objeto JSON con los siguientes parámetros.

Parámetro Tipo Descripción
comment String Comentario que se va a incluir. Puede ser una cadena vacía.
mensaje message Cualquier propiedad grabable que se pueda actualizar en el mensaje de respuesta.

Al especificar el cuerpo en formato MIME, proporcione al contenido MIME los encabezados de mensaje de Internet aplicables, todos codificados en formato base64 en el cuerpo de la solicitud. Este método utiliza el remitente del mensaje original como destinatario.

Respuesta

Si se ejecuta correctamente, este método devuelve un 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 un 400 Bad Request código de respuesta y el siguiente mensaje de error: "Cadena codificada en base64 no válida para contenido MIME".

Ejemplos

Ejemplo 1: Responder a un mensaje en formato JSON

En el ejemplo siguiente se incluye un comentario y se agrega un destinatario al mensaje de respuesta.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAAqldOAAA=/reply
Content-Type: application/json

{
  "message":{
    "toRecipients":[
      {
        "emailAddress": {
          "address":"samanthab@contoso.com",
          "name":"Samantha Booth"
        }
      },
      {
        "emailAddress":{
          "address":"randiw@contoso.com",
          "name":"Randi Welch"
        }
      }
     ]
  },
  "comment": "Samantha, Randi, would you name the group please?"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 202 Accepted

Ejemplo 2: Responder a un mensaje en formato MIME

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/reply
Content-Type: text/plain

UmVjZWl2ZWQ6IGZyb20gY29udG9zby5jb20gKDEwLjE5NC4yNDEuMTk3KSBieSAKY29udG9zby5jb20gKDEwLjE5NC4yNDEuMTk3KSB3aXRoIE1pY3Jvc29mdCAKU01UUCBTZXJ2ZXIgKHZlcnNpb249VExTMV8yLCAKY2lwaGVyPVRMU19FQ0RIRV9SU0FfV0lUSF9BRVNfMjU2X0NCQ19TSEEzODRfUDI1NikgaW

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."
    }
}