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

  • [アーティクル]

名前空間: microsoft.graph

重要

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

注意

Outlook タスクでこの機能を使用する既存のアプリは、Outlook タスクが非推奨になっているので、更新する必要があります。 詳細については、「 パブリック プレビューで API を実行するには 」を参照してください。

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

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

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

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

注: ファイルをグループ投稿に添付する場合、またはアイテムをイベント、メッセージ、またはグループ投稿に添付する場合は、添付ファイルのサイズを 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
}