Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Relatar uma mensagem como lixo eletrônico, phishing ou não lixo eletrônico, o que melhora a filtragem de email.
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Mail.ReadWrite | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Mail.ReadWrite | Indisponível. |
| Aplicativo | Mail.ReadWrite | Indisponível. |
Solicitação HTTP
POST /me/messages/{messageId}/reportMessage
POST /users/{userId}/messages/{messageId}/reportMessage
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON dos parâmetros.
A tabela a seguir lista os parâmetros que você pode usar com essa ação.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| IsMessageMoveRequested | Booliano | Indica se a mensagem deve ser movida para fora da pasta atual. Opcional. |
| ReportAction | reportAction | Indica o tipo de ação a ser relatada na mensagem que pode ser lixo eletrônico, não lixo eletrônico ou phishing. Os valores possíveis são: unknown, junk, notJunk, phish, unknownFutureValue. Obrigatório. |
Resposta
Se for bem-sucedida, essa ação retornará um código de 200 OK resposta e um objeto de mensagem no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/v1.0/me/messages/AAMkADhAAATs28OAAA=/reportMessage
Content-Type: application/json
{
"IsMessageMoveRequested": true,
"ReportAction": "junk"
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#message",
"@odata.type": "#microsoft.graph.message",
"@odata.etag": "W/\"FwAAABYAAAC4ofQHEIqCSbQPot83AFcbAAAW/0tB\"",
"id": "AAMkADhAAAW-VPeAAA=",
"createdDateTime": "2018-08-12T08:43:22Z",
"lastModifiedDateTime": "2018-08-15T19:47:54Z",
"changeKey": "FwAAABYAAAC4ofQHEIqCSbQPot83AFcbAAAW/0tB",
"categories": [],
"receivedDateTime": "2018-08-12T08:43:22Z",
"sentDateTime": "2018-08-12T08:43:20Z",
"hasAttachments": false,
"internetMessageId": "<00535324-5988-4b6a-b9af-d44cf2d0b691@MWHPR2201MB1022.namprd22.prod.outlook.com>",
"subject": "Undeliverable: Meet for lunch?",
"bodyPreview": "Delivery has failed to these recipients or groups:\r\n\r\nfannyd@contoso.com (fannyd@contoso.com)\r\nYour message couldn't be delivered. Despite repeated attempts to deliver your message, querying the Domain Name System (DNS) for the rec",
"importance": "normal",
"parentFolderId": "AAMkADhAAAAAAEKAAA=",
"conversationId": "AAQkADhJzfbkARFhe5kKhjihSA=",
"isDeliveryReceiptRequested": null,
"isReadReceiptRequested": false,
"isRead": false,
"isDraft": false,
"webLink": "https://outlook.office365.com/owa/?ItemID=AAMkADhAAAW%2FVPeAAA%3D&exvsurl=1&viewmodel=ReadMessageItem",
"inferenceClassification": "focused",
"body": {
"contentType": "html",
"content": "<html></html>"
},
"sender": {
"emailAddress": {
"name": "Microsoft Outlook",
"address": "MicrosoftExchange329e71ec88ae4615bbc36ab6ce41109e@contoso.com"
}
},
"from": {
"emailAddress": {
"name": "Microsoft Outlook",
"address": "MicrosoftExchange329e71ec88ae4615bbc36ab6ce41109e@contoso.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "fannyd@contoso.com",
"address": "fannyd@contoso.com"
}
},
{
"emailAddress": {
"name": "danas@contoso.com",
"address": "danas@contoso.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"flag": {
"flagStatus": "notFlagged"
}
}