添付ファイル リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

ユーザー、メッセージ、タスク、またはグループの投稿に含まれる複数種類の添付ファイルの基本タイプで、以下の派生タイプの添付ファイルの基本リソースとして機能します。

ユーザー イベント、 メッセージ、 Outlook タスク、またはグループ 投稿 に関連するコンテンツを添付ファイルの形式で追加できます。

注意

Outlook タスクは非推奨となり、2022 年 8 月 10 日にデータの返品を停止しました。 Outlook タスクでこの機能を使用する既存のアプリを更新します。

グループ予定表のイベントは添付ファイルをサポートしていません。

Outlook タスクは参照添付ファイルをサポートしていません。

注: グループ投稿にファイルを添付する場合や、イベント、メッセージ、グループ投稿にアイテムを添付する場合は、添付ファイルのサイズを 3 MB に制限してください。

3 MB 未満のファイルを添付する場合は、 添付ファイルをユーザー イベント、 メッセージ、または グループ投稿に追加できます。

3 MB から 150 MB のファイルをイベントまたはメッセージに添付する場合は、 アップロード セッションを作成し 、添付するファイルの範囲を繰り返しアップロードできます。 例については、「 Outlook メッセージに大きいファイルを添付する 」を参照してください。

メソッド

次のメソッドは、派生型の添付ファイル (fileAttachment、itemAttachment、または referenceAttachment) のすべてに適用されます。

メソッド 戻り値の型 説明
Get attachment ユーザー イベント、メッセージ、Outlook タスク、または投稿に添付されている添付ファイルのプロパティ、リレーションシップ、または未加工のコンテンツを読み取ります。
Delete なし イベント、メッセージ、Outlook タスク、または投稿の添付ファイルを削除します。
ユーザー イベントに添付ファイルを追加する attachment ユーザー 予定表でファイル、アイテム、またはリンクの添付ファイルをイベントに追加します。 この操作により、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。
メッセージに添付ファイルを追加する attachment ファイル、アイテム、またはリンクの添付ファイルをメッセージに追加します。 この操作により、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。
大きなファイルを添付するセッションを作成する uploadSession アプリがファイルの範囲を繰り返しアップロードして、指定した メッセージ または イベントにファイルを添付できるアップロード セッションを作成します。 ファイル サイズは 3 MB から 150 MB の間である必要があります。
Outlook タスクに添付ファイルを追加する (非推奨) attachment ファイルまたはアイテムの添付ファイルを Outlook タスクに追加します。
投稿に添付ファイルを追加する attachment ファイル、アイテム、またはリンクの添付ファイルをグループ投稿に追加します。 この操作により、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。
ユーザー イベントの添付ファイルを一覧表示する attachment コレクション ユーザー予定表でイベントの添付ファイルの一覧を取得します。
メッセージの添付ファイルを一覧表示する attachment コレクション メッセージの添付ファイルの一覧を取得します。
Outlook タスクの添付ファイルを一覧表示 する (非推奨) attachment コレクション Outlook タスクの添付ファイルのリストを取得します。
投稿の添付ファイルを一覧表示する attachment コレクション 投稿の添付ファイルの一覧を取得します。

プロパティ

次に、添付ファイル リソースの基本プロパティを示します。 他のプロパティについては、特定の種類の添付ファイル (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
}