使用 SchemaExtension 数据通过 Microsoft Graph API 发送消息

Question

我正在寻找一些帮助格式化 Microsoft Graph API 中的架构扩展数据。我已经能够使用此正文通过代码和图形资源管理器成功发送 Office 365 消息：{  "message": {    "subject": "Test Subject",    "body": {      "contentType": "Text",      "content": "Test Body "    },    "toRecipients": [      {        "emailAddress": {          "address": "[e-mail]"        }      }    ]  }}我创建了一个架构扩展并将其提升为“可用”状态。我可以查询扩展以验证它是否可用并获取此响应正文：{    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#schemaExtensions",    "value": [        {            "id": "extc5bnq6uk_TestExtension",            "description": "Test Extension",            "targetTypes": [                "Message"            ],            "status": "Available",            "owner": "mysecretclienttenantgoeshere",            "properties": [                {                    "name": "ValueOne",                    "type": "String"                },                {                    "name": "ValueTwo",                    "type": "String"                }            ]        }    ]}到目前为止，我还无法将扩展数据附加到新消息中。我试过像这样格式化我的请求正文：{  "message": {    "subject": "Test Subject",    "body": {      "contentType": "Text",      "content": "Test Body "    },    "toRecipients": [      {        "emailAddress": {          "address": "[e-mail]"        }      }    ],    "extc5bnq6uk_TestExtension": {      "ValueOne": "TestValue",      "ValueTwo": "TestValue"    }  }}像这样：{  "message": {    "subject": "Test Subject",    "body": {      "contentType": "Text",      "content": "Test Body "    },    "toRecipients": [      {        "emailAddress": {          "address": "[e-mail]"        }      }    ],    "extensions":[    {        "extc5bnq6uk_TestExtension" : {            "ValueOne" : "TestValue"            "ValueTwo" : "TestValue"        }    }    ]  }我在图表资源管理器中发布到这个 URL：https://graph.microsoft.com/v1.0/me/sendMail以及代码中的“messages”和“sendMail”端点。

Answer 1

我在文档的已知限制中找到了答案。某些资源类型，包括消息，必须分两个阶段完成，一个初始发布，然后一个后续补丁。

创建消息然后使用此 JSON 进行修补会返回有效响应。

{

    "extc5bnq6uk_TestExtension": {

        "ValueOne": "Test Value One",

        "ValueTwo": "Test Value Two"

    }

}

不幸的是，消息模式扩展的另一个限制是它们不能用于过滤消息，这正是我最终所追求的。

Outlook 实体类型（联系人、事件、消息或帖子）不支持对架构扩展属性进行过滤（使用 $filter 表达式）。

Answer 2

根据您发布的问题，您已成功创建了 schemaExtension。我认为您想发送带有此 schemaExtension 的电子邮件，但是当您发送带有此 schemaExtension 的电子邮件时，我们会在响应中收到 400 代码。

根据我的测试，我认为我们可以使用请求正文作为打击。

1.像这样创建一个schemaExtension：

{

   "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#schemaExtensions/$entity",

   "id":"{extensionId}",

   "description":"sample description",

   "targetTypes":[

       "Message"

    ],

   "status":"Available",

   "owner":"{owner id}",

   "properties":[

      {

          "name":"p1",

          "type":"String"

      },

      {

          "name":"p2",

          "type":"String"

      }

    ]

  }

创建消息

POST https://graph.microsoft.com/v1.0/me/messages

{

   "message":{

      "subject":"Meet for lunch?",

      "body":{

          "contentType":"Text",

          "content":"The new cafeteria is open."

       },

      "toRecipients":[

          {

              "emailAddress":{

                  "address":"{toRecipients email address}"

              }

          }

      ],

      "extensions":[

          {

              "@odata.type":"Microsoft.Graph.OpenTypeExtension",

              "extensionName":"{extensionName}",

              "p1":"Wingtip Toys",

              "p2":"10000"

          }

      ]

  },

  "saveToSentItems":"false"

}

当我们随请求发送此消息时，我们将获得 202 代码。{toRecipients email address} 将收到电子邮件。