如何从标题中获取可用的电子邮件参考 ID 以在 Microsoft Graph 查询中使用？

Question

I am trying to use the references message ID in email headers of a forwarded email in Office 365 to then find the original email that has that message ID.

The references ID in the forwarded email's headers would show something like what's shown below. Note I'm obtaining these headers from Microsoft Graph by adding &$select=internetMessageHeaders to my query using sender/subject to find the forwarded email.

{
  "name": "References",
  "value": "<CAOLK2SAEzvs=-6Rs5cTbgORNivQVK2AvMJDJT8o+ghx-XhCn7w@mail.gmail.com>"
}

However, if I take this and use it in a query like https://graph.microsoft.com/v1.0/me/messages?$filter=internetMessageId eq '<CAOLK2SAEzvs=-6Rs5cTbgORNivQVK2AvMJDJT8o+ghx-XhCn7w@mail.gmail.com>'

I do not receive any results.

If I hunt down the original email in Microsoft Graph using sender and subject, I see the following for the internetMessageId field for the original email:

{
  "name": "Message-ID",
  "value": "<CAOLK2SC6s9Me05kYRqeuEHKK8DrQbXx34ScT0AzGOFFLMdRapg@mail.gmail.com>"
}

Does anyone have any ideas on what Office 365 or Microsoft Graph is doing to change CAOLK2SAEzvs=-6Rs5cTbgORNivQVK2AvMJDJT8o+ghx-XhCn7w into CAOLK2SC6s9Me05kYRqeuEHKK8DrQbXx34ScT0AzGOFFLMdRapg ? It looks like some sort of encoding, but I haven't been able to reproduce it.

Ultimately I would like to be able to transform what I'm getting in the references ID header such that I can turn around and use that ID to find the original email using Microsoft Graph.

Answer 1

The id is a hashed value that, among other things, includes the path/folder that the message resides in. So if you, for example, move a message (say from Inbox to Archive) then you should expect the id to change.

For tracking a message, regardless of its location, you should use the internetMessageId ( $select=internetMessageId ) property instead.

Answer 2

I discovered the issue. In my test message-ID I have the characters = and +

These characters must be URL encoded to %3D and %2B before being used in the $filter query. When they are URL encoded, I am able to find the original email using MS Graph.

Answer 3

In Microsoft Graph v1.0 and beta, you can obtain "immutable ids" by sending an additional HTTP header in your API requests:

Prefer: IdType="ImmutableId"

I've put immutable in italics as this is the term Microsoft uses. Be aware of the following caveats, the ID will change if:

• The user moves the item to an archive mailbox;
• The user exports the item (to a PST, as an MSG file, etc.) and re-imports it into their mailbox;
• The user creates a draft which they later send;

You can also convert existing ids to immutable ones by the following request:

POST https://graph.microsoft.com/beta/me/translateExchangeIds
{ 
  "inputIds" : 
  [ 
    "AQMkAGM2…" 
  ], 
  "targetIdType" : "restImmutableEntryId", 
  "sourceIdType" : "restId" 
}

Which will give you the response:

HTTP 200 OK

{ 
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.convertIdResult)", 
  "value": [ 
    { 
      "targetId": "AAkALgAA...", 
      "sourceId": "AQMkAGM2..."
    } 
  ] 
}