添付ファイル リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
次の派生型の添付ファイルの基本リソースとして機能する、ユーザー、メッセージ、タスク、またはグループ投稿の添付ファイルのいくつかの種類の基本型。
- ファイル (fileAttachment リソース)
- アイテム ( itemAttachment リソースによって表される連絡先、イベント、またはメッセージ)
- ファイルへのリンク (referenceAttachment リソース)
関連するコンテンツを、添付ファイルの形式でユーザー イベント、 メッセージ、 Outlook タスク、またはグループ 投稿 に追加できます。
注意
Outlook タスクは非推奨となり、2022 年 8 月 10 日にデータの返しを停止しました。 Outlook タスクでこの機能を使用する既存のアプリを更新します。
グループ予定表のイベントは添付ファイルをサポートしていません。
Outlook タスクでは、参照添付ファイルはサポートされていません。
注: ファイルをグループ投稿に添付する場合、またはアイテムをイベント、メッセージ、またはグループ投稿に添付する場合は、添付ファイルのサイズを 3 MB に制限します。
3 MB 未満のファイルを添付する場合は、 添付ファイルをユーザー イベント、 メッセージ、または グループ投稿に追加できます。
3 MB から 150 MB のファイルをイベントまたはメッセージに添付する場合は、 アップロード セッションを作成 し、ファイルの範囲を反復的にアップロードして添付できます。 例については、「 Outlook メッセージに大きなファイルを添付 する」を参照してください。
メソッド
次のメソッドは、派生型の添付ファイル (fileAttachment、itemAttachment、または referenceAttachment) のすべてに適用されます。
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| 添付ファイルを取得する | attachment | ユーザー イベント、メッセージ、Outlook タスク、または投稿に添付された添付ファイルのプロパティ、リレーションシップ、または生のコンテンツを読み取ります。 |
| ユーザー イベントに添付ファイルを追加する | attachment | ユーザー 予定表でファイル、アイテム、またはリンクの添付ファイルをイベントに追加します。 この操作では、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。 |
| メッセージに添付ファイルを追加する | attachment | ファイル、アイテム、またはリンクの添付ファイルをメッセージに追加します。 この操作では、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。 |
| 大きなファイルを添付するセッションを作成する | uploadSession | アプリがファイルの範囲を反復的にアップロードして、指定した メッセージ または イベントにファイルを添付できるようにするアップロード セッションを作成します。 ファイル サイズは 3 MB から 150 MB の間である必要があります。 |
| Outlook タスクに添付ファイルを追加する (非推奨) | attachment | Outlook タスクにファイルまたはアイテムの添付ファイルを追加します。 |
| 投稿に添付ファイルを追加する | attachment | ファイル、アイテム、またはリンクの添付ファイルをグループ投稿に追加します。 この操作では、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。 |
| ユーザー イベントの添付ファイルを一覧表示する | attachment コレクション | ユーザー予定表でイベントの添付ファイルの一覧を取得します。 |
| メッセージの添付ファイルを一覧表示する | attachment コレクション | メッセージの添付ファイルの一覧を取得します。 |
| Outlook タスクの添付ファイルを一覧表示する (非推奨) | attachment コレクション | Outlook タスクの添付ファイルの一覧を取得します。 |
| 投稿の添付ファイルを一覧表示する | attachment コレクション | 投稿の添付ファイルの一覧を取得します。 |
| 削除 | なし | イベント、メッセージ、Outlook タスク、または投稿の添付ファイルを削除します。 |
プロパティ
次に、添付ファイル リソースの基本プロパティを示します。 他のプロパティについては、特定の種類の添付ファイル (fileAttachment、itemAttachment、または referenceAttachment) を参照してください。
| プロパティ | 型 | 説明 |
|---|---|---|
| contentType | String | MIME タイプ。 |
| id | String | 読み取り専用。 |
| isInline | Boolean | 添付ファイルがインライン添付ファイルの場合は true、それ以外の場合は false。 |
| lastModifiedDateTime | DateTimeOffset | Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| name | String | 添付ファイルの表示名。 実際のファイル名である必要はありません。 |
| size | Int32 | 添付ファイルの長さ (バイト単位)。 |
リレーションシップ
なし
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"contentType": "string",
"id": "string (identifier)",
"isInline": true,
"lastModifiedDateTime": "String (timestamp)",
"name": "string",
"size": 1024
}