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

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

添付ファイルの形式で、関連するコンテンツをユーザーイベントメッセージOutlook タスク、またはグループ投稿に追加できます。You can add related content to a user event, message, Outlook task, or group post in the form of an attachment.

グループ予定表のイベントは添付ファイルをサポートしていません。Events in group calendars do not support attachments.

attachment は、次の派生型の添付ファイルの基本リソースです。attachment is the base resource for the following derived types of attachments:

: 4 MB 未満で追加できるファイルまたはアイテムの添付ファイルのサイズに制限があります。Note: There is a limit to the size of the file or item attachment you can add to under 4 MB.

ただし、3MB と150MB の間のファイルをメッセージに添付している場合は、アップロードセッションを作成して、ファイルを添付するためにファイルのアップロードの範囲を反復的に行うことができます。However, if you're attaching to a message a file that is between 3MB and 150MB, you can create an upload session and iteratively upload ranges of the file to attach it. 例については、「添付サイズの大きいファイルを Outlook メッセージに添付する」を参照してください。See attach large files to Outlook messages for an example.

メソッドMethods

次のメソッドは、派生型の添付ファイル (fileAttachmentitemAttachment、または referenceAttachment) のすべてに適用されます。The following methods apply to any of the derived types of attachments (fileAttachment, itemAttachment, or referenceAttachment).

メソッドMethod 戻り値の型Return Type 説明Description
添付ファイルを取得するGet attachment attachmentattachment 添付ファイルのプロパティ、リレーションシップ、または生の内容を読み取り、ユーザーイベント、メッセージ、Outlook タスク、または投稿に添付します。Read the properties, relationships, or raw contents of an attachment, attached to a user event, message, Outlook task, or post.
ユーザー イベントに添付ファイルを追加するAdd attachment to a user event attachmentattachment ユーザー 予定表でファイル、アイテム、またはリンクの添付ファイルをイベントに追加します。Add a file, item, or link attachment to an event in a user calendar.
メッセージに添付ファイルを追加するAdd attachment to a message attachmentattachment ファイル、アイテム、またはリンクの添付ファイルをメッセージに追加します。Add a file, item, or link attachment to a message. この操作によって、追加できる添付ファイルのサイズが 4 MB 未満に制限されます。This operation limits the size of the attachment you can add to under 4 MB.
大きなファイルを添付するセッションを作成するCreate session to attach large file uploadSessionuploadSession 指定したメッセージにファイルを添付するために、アプリでファイルの範囲を繰り返しアップロードできるようにするアップロードセッションを作成します。Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to the specified message. ファイルサイズは、3MB と150MB の間である必要があります。The file size must be between 3MB and 150MB.
Outlook タスクに添付ファイルを追加するAdd attachment to an Outlook task attachmentattachment Outlook タスクにファイル、アイテム、またはリンクの添付ファイルを追加します。Add a file, item, or link attachment to an Outlook task.
投稿に添付ファイルを追加するAdd attachment to a post attachmentattachment ファイル、アイテム、またはリンクの添付ファイルを投稿に追加します。Add a file, item, or link attachment to a post.
ユーザー イベントの添付ファイルを一覧表示するList attachments of a user event attachment コレクションattachment collection ユーザー予定表でイベントの添付ファイルの一覧を取得します。Get a list of attachments for an event in a user calendar.
メッセージの添付ファイルを一覧表示するList attachments of a message attachment コレクションattachment collection メッセージの添付ファイルの一覧を取得します。Get a list of attachments for a message.
Outlook タスクの添付ファイルを一覧表示するList attachments of an Outlook task attachment コレクションattachment collection Outlook タスクの添付ファイルの一覧を取得します。Get a list of attachments for an Outlook task.
投稿の添付ファイルを一覧表示するList attachments of a post attachment コレクションattachment collection 投稿の添付ファイルの一覧を取得します。Get a list of attachments for a post.
削除Delete NoneNone イベント、メッセージ、Outlook タスク、または投稿の添付ファイルを削除します。Delete an attachment on an event, message, Outlook task, or post.

プロパティProperties

次に、添付ファイル リソースの基本プロパティを示します。他のプロパティについては、特定の種類の添付ファイル (fileAttachmentitemAttachment、または referenceAttachment) を参照してください。The following are the base properties of any attachment resource. Refer to the specific type of attachment (fileAttachment, itemAttachment, or referenceAttachment) for additional properties.

プロパティProperty Type 説明Description
contentTypecontentType StringString MIME タイプ。The MIME type.
idid 文字列String 読み取り専用。Read-only.
isInlineisInline BooleanBoolean 添付ファイルがインライン添付ファイルの場合は true、それ以外の場合は falsetrue if the attachment is an inline attachment; otherwise, false.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
namename StringString 添付ファイルの表示名。実際のファイル名である必要はありません。The display name of the attachment. This does not need to be the actual file name.
sizesize Int32Int32 添付ファイルの長さ (バイト単位)。The length of the attachment in bytes.

リレーションシップRelationships

なしNone

JSON 表記JSON representation

以下は、リソースの JSON 表記ですHere is a JSON representation of the resource

{
  "contentType": "string",
  "id": "string (identifier)",
  "isInline": true,
  "lastModifiedDateTime": "String (timestamp)",
  "name": "string",
  "size": 1024
}