message: replyAll
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Responda a todos os destinatários de uma mensagem usando o formato JSON ou MIME.
Ao usar o formato JSON:
- Especifique um comentário ou a propriedade do corpo do
message
parâmetro. Especificar ambos retornará um erro HTTP 400 - Solicitação incorreta. - Se a mensagem original especificar um destinatário na propriedade replyTo , por Formato de Mensagem da Internet (RFC 2822), envie a resposta aos destinatários em replyTo e não o destinatário na propriedade from .
Ao utilizar o formato MIME:
- Fornecer os cabeçalhos de mensagem da Internet e o conteúdo MIME aplicáveis, todos codificados no formato base64 no corpo da solicitação.
- Adicionar quaisquer anexos e propriedades S/MIME ao conteúdo MIME.
Este método salva a mensagem na pasta Itens Enviados.
Como alternativa, crie um rascunho para responder a uma mensagem e envie-a posteriormente.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Mail.Send | Indisponível. |
Delegado (conta pessoal da Microsoft) | Mail.Send | Indisponível. |
Aplicativo | Mail.Send | Indisponível. |
Solicitação 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
Cabeçalhos de solicitação
Nome | Tipo | Descrição |
---|---|---|
Autorização | string | {token} de portador. Obrigatório |
Content-Type | string | Natureza dos dados no corpo de uma entidade. Obrigatório Usar application/json para um objeto JSON e text/plain para conteúdo MIME |
Prefira: outlook.timezone | string | Define o fuso horário para o Sent campo da mensagem de resposta em HTML que essa API cria com base no corpo da solicitação. O valor pode ser qualquer um dosTimeZones com suporte configurados para o usuário. Se não for especificado, esse Sent campo estará em UTC.Use esse cabeçalho somente se você estiver especificando o Content-Type: application/json cabeçalho para criar a mensagem de resposta em HTML. Se você usar o Content-Type: text/plain cabeçalho, esse Prefer cabeçalho não terá nenhum efeito. Opcional. |
Corpo da solicitação
Ao usar o formato JSON, forneça um objeto JSON com os seguintes parâmetros.
Parâmetro | Tipo | Descrição |
---|---|---|
comment | String | Um comentário a incluir. Não pode ficar vazio. |
mensagem | message | Quaisquer propriedades graváveis a serem atualizadas na mensagem de resposta. |
Ao especificar o corpo no formato MIME, forneça o conteúdo MIME com os cabeçalhos de mensagem da Internet aplicáveis, todos codificados no formato base64 no corpo da solicitação. Esse método carrega o remetente e todos os destinatários da mensagem original como destinatários da nova mensagem.
Resposta
Se bem sucedido, este método retorna um código de resposta 202 Accepted
. Ele não retorna nada no corpo da resposta.
Se o corpo da solicitação incluir conteúdo MIME malformado, este método retornará 400 Bad request
e a seguinte mensagem de erro: "Cadeia de caracteres base64 inválida para o conteúdo MIME".
Exemplos
Exemplo 1: Responder tudo a uma mensagem no formato JSON
O exemplo a seguir inclui um comentário e adiciona um anexo à mensagem de resposta a todos.
Solicitação
O exemplo a seguir mostra uma solicitação.
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."
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 202 Accepted
Exemplo 2: Responder tudo a uma mensagem no formato MIME
Solicitação
POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaLAAA=/replyAll
Content-Type: text/plain
RnJvbTogQWxleCBXaWxiZXIgPEFsZXhXQGNvbnRvc28uY29tPgpUbzogTWVnYW4gQm93ZW4gPE1l
Z2FuQkBjb250b3NvLmNvbT4KU3ViamVjdDogSW50ZXJuYWwgUmVzdW1lIFN1Ym1pc3Npb246IFNh
bGVzIEFzc29jaWF0ZQpUaHJlYWQtVG9waWM...
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 202 Accepted
Se o corpo da solicitação incluir conteúdo MIME malformado, este método retornará a seguinte mensagem de erro.
HTTP/1.1 400 Bad Request
Content-type: application/json
{
"error": {
"code": "ErrorMimeContentInvalidBase64String",
"message": "Invalid base64 string for MIME content."
}
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de