post リソース タイプ
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
conversationThread エンティティ内の個々の投稿アイテムを表します。
投稿を明示的に作成できなくても、次のいずれかの方法で投稿を作成できます。
このリソースでは、拡張機能を使用してカスタム プロパティに独自のデータを追加することができます。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List posts | post | 指定したスレッドの投稿を取得します。 |
| Get post | post | 指定したスレッド内の投稿のプロパティと関係を取得します。 |
| 返信を一覧表示する | なし | グループ会話の投稿に返信して、指定されたスレッドに新しい投稿を追加します。 |
| 投稿を転送する | なし | 受信者に投稿を転送します。 |
| 添付ファイル | ||
| 添付ファイルを一覧表示する | attachment コレクション | 投稿のすべての添付ファイルを取得します。 |
| 添付ファイルを追加する | attachment | 投稿に添付ファイルを追加します。 |
| オープン拡張機能 | ||
| Create open extension | openTypeExtension | オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。 |
| Get open extension | openTypeExtension コレクション | 拡張機能の名前で識別されるオープン拡張機能を取得します。 |
| 拡張プロパティ | ||
| 単一値のプロパティを作成する | post | 新規または既存の投稿に、ひとつまたは複数の単一値の拡張プロパティを作成します。 |
| 単一値のプロパティを取得する | post |
$expand または $filter を使用して、単一値の拡張プロパティを含む投稿を取得します。 |
| 複数値プロパティを作成する | post | 新規または既存の投稿に、ひとつまたは複数の複数値の拡張プロパティを作成します。 |
| 複数値プロパティを取得する | post |
$expand を使用して、複数値の拡張プロパティを含む投稿を取得します。 |
プロパティ
| プロパティ | 種類 | 説明 |
|---|---|---|
| body | itemBody | 投稿の内容です。 これが既定のプロパティです。 このプロパティを null にすることができます。 |
| categories | String collection | 投稿に関連付けられたカテゴリ。 各カテゴリは、ユーザーに対して定義されている outlookCategory の displayName プロパティに対応します。 |
| changeKey | String | 投稿のバージョンを識別します。 投稿を変更するたびに ChangeKey も変更されます。 これにより、Exchange は正しいバージョンのオブジェクトに変更を適用できます。 |
| conversationId | String | 会話の固有 ID です。 読み取り専用。 |
| conversationThreadId | String | 会話スレッドの固有 ID です。 読み取り専用。 |
| createdDateTime | DateTimeOffset | 投稿の作成時刻を示します。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| from | recipient | 代理人アクセスのシナリオで使用されます。 他のユーザーの代わりにメッセージを投稿したユーザーを示します。 これが既定のプロパティです。 |
| hasAttachments | Boolean | 投稿の添付ファイルが 1 つ以上あるかどうかを示します。 これが既定のプロパティです。 |
| id | String | 読み取り専用です。 |
| importance | importance | グループ投稿の重要性: low、 normal、 high。 |
| lastModifiedDateTime | DateTimeOffset | 投稿が最後に修正された日時を指定します。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| newParticipants | recipient collection | この投稿の一部としてスレッドに追加された会話の参加者です。 |
| receivedDateTime | DateTimeOffset | 投稿の受信時刻を示します。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| sender | recipient | 送信者のアドレスが含まれます。 送信者が指定されていない場合、送信者の値は認証済みユーザーのアドレスと見なされます。 これが既定のプロパティです。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| attachments | Attachment コレクション | post の fileAttachment、 itemAttachment、 および referenceAttachment 添付ファイルのコレクション。 読み取り専用。 Null 許容型です。
$expand をサポートします。 |
| extensions | Extension コレクション | 投稿に対して定義されているオープン拡張機能のコレクション。 読み取り専用。 Null 許容型です。
$expand をサポートします。 |
| inReplyTo | 投稿 | この投稿が conversationThread で返信している以前の投稿。 読み取り専用です。
$expand をサポートします。 |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty collection | その投稿用に定義された、複数値拡張プロパティのコレクションです。 読み取り専用。 Null 許容型。 |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | その投稿用に定義された、単一値拡張プロパティのコレクションです。 読み取り専用。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"body": {"@odata.type": "microsoft.graph.itemBody"},
"categories": ["string"],
"changeKey": "string",
"conversationId": "string",
"conversationThreadId": "string",
"createdDateTime": "String (timestamp)",
"from": {"@odata.type": "microsoft.graph.recipient"},
"hasAttachments": true,
"id": "string (identifier)",
"importance": "string",
"lastModifiedDateTime": "String (timestamp)",
"newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
"receivedDateTime": "String (timestamp)",
"sender": {"@odata.type": "microsoft.graph.recipient"}
}