添付ファイル リソースの種類
名前空間: microsoft.graph
関連コンテンツを添付ファイルの形式でユーザー イベント、メッセージ、または投稿に追加できます。
グループ予定表のイベントは添付ファイルをサポートしていません。
attachment は、次の派生型の添付ファイルの基本リソースです。
- ファイル (fileAttachment リソース)
- 項目 (itemAttachment リソースで表される連絡先、イベント、またはメッセージ)
- ファイルへのリンク (referenceAttachment リソース)
注: ファイルをグループ投稿に添付する場合、またはアイテムをイベント、メッセージ、またはグループ投稿に添付する場合は、添付ファイルのサイズを 3 MB に制限します。
3 MB 未満のファイルを添付する場合は、 添付ファイルをユーザー イベント、 メッセージ、または グループ投稿に追加できます。
3 MB から 150 MB のファイルをイベントまたはメッセージに添付する場合は、 アップロード セッションを作成 し、ファイルの範囲を反復的にアップロードして添付できます。 例については、「 Outlook メッセージに大きなファイルを添付 する」を参照してください。
メソッド
次のメソッドは、派生型の添付ファイル (fileAttachment、itemAttachment、または referenceAttachment) のすべてに適用されます。
メソッド | 戻り値の型 | 説明 |
---|---|---|
添付ファイルを取得する | attachment | ユーザー イベント、メッセージ、または投稿に添付されている添付ファイルのプロパティ、リレーションシップ、または生コンテンツを読み取ります。 |
ユーザー イベントに添付ファイルを追加する | attachment | ユーザー 予定表でファイル、アイテム、またはリンクの添付ファイルをイベントに追加します。 この操作では、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。 |
メッセージに添付ファイルを追加する | attachment | ファイル、アイテム、またはリンクの添付ファイルをメッセージに追加します。 この操作では、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。 |
大きなファイルを添付するセッションを作成する | uploadSession | アプリがファイルの範囲を反復的にアップロードして、指定した メッセージ または イベントにファイルを添付できるようにするアップロード セッションを作成します。 ファイル サイズは 3 MB から 150 MB の間である必要があります。 |
投稿に添付ファイルを追加する | attachment | ファイル、アイテム、またはリンクの添付ファイルを投稿に追加します。 この操作では、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。 |
ユーザー イベントの添付ファイルを一覧表示する | attachment コレクション | ユーザー予定表でイベントの添付ファイルの一覧を取得します。 |
メッセージの添付ファイルを一覧表示する | attachment コレクション | メッセージの添付ファイルの一覧を取得します。 |
投稿の添付ファイルを一覧表示する | attachment コレクション | 投稿の添付ファイルの一覧を取得します。 |
削除 | None | イベント、メッセージ、または投稿の添付ファイルを削除します。 |
プロパティ
次に、添付ファイル リソースの基本プロパティを示します。 他のプロパティについては、特定の種類の添付ファイル (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
}