フィードバック 編集

添付ファイルを追加

  • [アーティクル]

名前空間: microsoft.graph

添付ファイルをメッセージに追加する場合に、この API を使用します。

添付ファイルには、次の種類のいずれかを指定できます。

これらの添付ファイル リソースのすべての種類は、attachment リソースから派生します。

既存のメッセージの添付ファイルのコレクションに投稿してそのメッセージに添付ファイルを追加したり、作成してすぐ送信されるメッセージに添付ファイルを追加したりすることができます。

この操作では、追加できる添付ファイルのサイズを 3 MB 以下に制限します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) Mail.ReadWrite
委任 (個人用 Microsoft アカウント) Mail.ReadWrite
アプリケーション Mail.ReadWrite

HTTP 要求

ユーザーのメールボックス内のメッセージの添付ファイル。

POST /me/messages/{id}/attachments
POST /users/{id | userPrincipalName}/messages/{id}/attachments

ユーザーのメールボックスの最上位レベルの mailFolder に含まれているメッセージの添付ファイル。

POST /me/mailFolders/{id}/messages/{id}/attachments
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/attachments

ユーザーのメールボックスの mailFolder の子フォルダーに含まれているメッセージの添付ファイル。次の例は、入れ子のレベルの 1 つを示していますが、メッセージは子の子などに入れることができます。

POST /me/mailFolders/{id}/childFolders/{id}/.../messages/{id}/attachments/{id}
POST /users/{id | userPrincipalName}/mailFolders/{id}/childFolders/{id}/messages/{id}/attachments/{id}

要求ヘッダー

名前 種類 説明
Authorization string ベアラー {token}。必須。
Content-Type string エンティティ本文内のデータの性質です。必須。

要求本文

要求本文で、Attachment オブジェクトの JSON 表記を指定します。

応答

成功した場合、このメソッドは 201 Created 応答コードと、応答本文で Attachment オブジェクトを返します。

例 (添付ファイル)

要求

以下は、要求の例です。

POST https://graph.microsoft.com/v1.0/me/messages/AAMkpsDRVK/attachments
Content-type: application/json

{
  "@odata.type": "#microsoft.graph.fileAttachment",
  "name": "smile",
  "contentBytes": "R0lGODdhEAYEAA7"
}

要求本文で、Attachment オブジェクトの JSON 表記を指定します。

応答

以下は、応答の例です。

HTTP 201 Created
Content-type: application/json

{
    "id": "AAMkADNkN2R",
    "lastModifiedDateTime": "2017-01-26T08:48:28Z",
    "name": "smile",
    "contentType": "image/gif",
    "size": 1008,
    "isInline": false,
    "contentId": null,
    "contentLocation": null,
    "contentBytes": "R0lGODdhEAYEAA7"
}

例 (項目の添付ファイル)

要求

以下は、要求の例です。

POST https://graph.microsoft.com/v1.0/me/messages/AAMkpsDRVK/attachments
Content-type: application/json

{
  "@odata.type": "#microsoft.graph.itemAttachment",
  "name": "Holiday event", 
  "item": {
    "@odata.type": "microsoft.graph.event",
    "subject": "Discuss gifts for children",
    "body": {
      "contentType": "HTML",
      "content": "Let's look for funding!"
    },
    "start": {
      "dateTime": "2016-12-02T18:00:00",
      "timeZone": "Pacific Standard Time"
    },
    "end": {
      "dateTime": "2016-12-02T19:00:00",
      "timeZone": "Pacific Standard Time"
    }
  }
}
応答

以下に応答の例を示します。注: ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

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

{
  "id":"AAMkADNkNJp5JVnQIe9r0=",
  "lastModifiedDateTime":"2016-12-01T22:27:13Z",
  "name":"Holiday event",
  "contentType":null,
  "size":2473,
  "isInline":false
}