inferenceClassificationOverride を作成するCreate inferenceClassificationOverride

SMTP アドレスで示される送信者のオーバーライドを作成します。この SMTP アドレスからの将来のメッセージは、オーバーライドで指定されたとおり一貫して分類されます。Create an override for a sender identified by an SMTP address. Future messages from that SMTP address will be consistently classified as specified in the override.

注意Note

  • 同じ SMTP アドレスを持つオーバーライドが既に存在する場合は**** 、そのオーバーライドの [フィールド名] フィールドと [名前] フィールドが、指定された値で更新されます。If an override already exists with the same SMTP address, then the classifyAs and name fields of that override are updated with the provided values.
  • メールボックスでサポートされているオーバーライドは、一意の送信者 SMTP アドレスに基づき、最大 1000 件までです。The maximum number of overrides supported for a mailbox is 1000, based on unique sender SMTP addresses.
  • POST 操作では、同時に作成できるオーバーライドは 1 件です。The POST operation supports creating only one override at a time.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Mail.ReadWriteMail.ReadWrite
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) Mail.ReadWriteMail.ReadWrite
アプリケーションApplication Mail.ReadWriteMail.ReadWrite

HTTP 要求HTTP request

POST /me/inferenceClassification/overrides
POST /users/{id}/inferenceClassification/overrides

要求ヘッダーRequest headers

名前Name Type 説明Description
AuthorizationAuthorization stringstring ベアラー {トークン}。必須。Bearer {token}. Required.
Content-TypeContent-Type stringstring エンティティ本文内のデータの性質です。必須。Nature of the data in the body of an entity. Required.

要求本文Request body

要求の本文に、inferenceClassificationOverride オブジェクトの JSON 表記を指定します。In the request body, supply a JSON representation of inferenceClassificationOverride object.

応答Response

成功した場合、このメソッドは 201 Created 応答コードと、応答本文で inferenceClassificationOverride オブジェクトを返します。If successful, this method returns 201 Created response code and an inferenceClassificationOverride object in the response body.

Example

要求Request

以下は、要求の例です。Here is an example of the request.

POST https://graph.microsoft.com/v1.0/me/inferenceClassification/overrides
Content-type: application/json

{
  "classifyAs": "focused",
  "senderEmailAddress": {
    "name": "Samantha Booth",
    "address": "samanthab@adatum.onmicrosoft.com"
  }
}
応答Response

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-type: application/json

{
  "classifyAs": "focused",
  "senderEmailAddress": {
    "name": "Samantha Booth",
    "address": "samanthab@adatum.onmicrosoft.com"
  },
  "id": "98f5bdef-576a-404d-a2ea-07a3cf11a9b9"
}