post リソース タイプ
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
conversationThread エンティティ内の個々の投稿 アイテムを表 します。
投稿を明示的に作成できなくても、次のいずれかの方法で投稿を作成できます。
このリソースでは、拡張機能を使用してカスタム プロパティに独自のデータを追加することができます。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List posts | post | 指定したスレッドの投稿を取得します。 |
| Get post | post | 指定したスレッド内の投稿のプロパティと関係を取得します。 |
| Reply | なし | グループ会話の投稿に返信して、指定されたスレッドに新しい投稿を追加します。 |
| Forward | なし | 受信者に投稿を転送します。 |
| Attachments | ||
| 添付ファイルを一覧表示する | attachment コレクション | 投稿のすべての添付ファイルを取得します。 |
| 添付ファイルを追加する | attachment | 投稿に添付ファイルを追加します。 |
| オープン拡張機能 | ||
| オープン拡張機能を作成する | openTypeExtension | オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。 |
| オープン拡張機能を取得する | openTypeExtension コレクション | 拡張機能の名前で識別されるオープン拡張機能を取得します。 |
| スキーマ拡張機能 | ||
| スキーマ拡張機能の値を追加する | スキーマ拡張機能の定義を作成し、それを使用してカスタマイズされた種類のデータをリソースに追加します。 | |
| 拡張プロパティ | ||
| 単一値の拡張プロパティを作成する | post | 新規または既存の投稿に、ひとつまたは複数の単一値の拡張プロパティを作成します。 |
| Get post with single-value extended property | post | $expand または $filter を使用して、単一値の拡張プロパティを含む投稿を取得します。 |
| 複数値の拡張プロパティを作成する | post | 新規または既存の投稿に、ひとつまたは複数の複数値の拡張プロパティを作成します。 |
| Get post with multi-value extended property | post | $expand を使用して、複数値の拡張プロパティを含む投稿を取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| body | itemBody | 投稿の内容です。これが既定のプロパティです。このプロパティを null にすることができます。 |
| categories | String コレクション | 投稿に関連付けられたカテゴリ。 各カテゴリは、ユーザー に 対して定義されている 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 コレクション | 投稿のfileAttachment、itemAttachment、および referenceAttachment 添付ファイルのコレクション。 読み取り専用です。 Null 許容型。 $expand をサポートします。 |
| extensions | Extension コレクション | 投稿に対して定義されているオープン拡張機能のコレクション。 読み取り専用です。 Null 許容型。 $expand をサポートします。 |
| inReplyTo | Post | この投稿が conversationThreadで返信している以前の投稿。 読み取り専用です。 $expand をサポートしています。 |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty コレクション | その投稿用に定義された、複数値拡張プロパティのコレクションです。読み取り専用。Null 許容型。 |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty コレクション | その投稿用に定義された、単一値拡張プロパティのコレクションです。読み取り専用。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"}
}
関連項目
フィードバック
フィードバックの送信と表示