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

名前空間: microsoft.graph

重要

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

注意事項

この機能を使用する既存のアプリは、Outlookが廃止されるので、Outlook更新する必要があります。 詳細についてはTo Doプレビューの API を参照してください。

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

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

Outlook タスクでは、参照添付ファイルはサポートされていません。

attachment は、次の派生型の添付ファイルの基本リソースです。

• ファイル (fileAttachment リソース)
• 項目 (itemAttachment リソースで表される連絡先、イベント、またはメッセージ)
• ファイルへのリンク (referenceAttachment リソース)

注: 4 MB 以下に追加できるファイルまたはアイテムの添付ファイルのサイズには制限があります。

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

メソッド

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

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