添付ファイルを追加
名前空間: microsoft.graph
添付ファイルをメッセージに追加する場合に、この API を使用します。
添付ファイルは、次の種類のいずれかにできます。
- ファイル (fileAttachment リソース)。
- 項目 (itemAttachment リソースで表される連絡先、イベント、メッセージ)。
- ファイルへのリンク (referenceAttachment リソース)。
これらの添付ファイル リソースのすべての種類は、attachment リソースから派生します。
既存のメッセージの添付ファイルのコレクションに投稿してそのメッセージに添付ファイルを追加したり、作成してすぐ送信されるメッセージに添付ファイルを追加したりすることができます。
この操作では、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この 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
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示