User Messages, General

コンテキストユーザのすべての非公開会話のすべてのメッセージを返します。すべてのメッセージを対象とした検索や、メッセージの投稿にも使用されます。「入力での POST、PATCH、または PUT の使用」を参照してください。「User Conversations, General」も参照してください。

リソース

userId は、コンテキストユーザの ID または別名 me である必要��あります。

メモ

適用開始バージョン

23.0

Chatter が必要かどうか

はい

HTTP メソッド

GET、HEAD、POST

POST のリクエストボディ

ルート XML タグ

<message>

プロパティ

名前	型	説明	使用可能なバージョン
body	String	メッセージ本文のテキスト	23.0
inReplyTo	String	このメッセージが含まれる会話を識別する既存のメッセージの ID。recipients または inReplyTo を指定します。両方ではなく、どちらか一方を指定します。	23.0
recipients	User Message Recipient List Input	目的のメッセージ受信者であるユーザ (最大 9 人) のリスト。ユーザ ID のカンマ区切りのリスト。recipients または inReplyTo を指定します。両方ではなく、どちらか一方を指定します。	23.0

XML 形式の例:

JSON 形式の例:

POST の要求パラメータ

パラメータ名	型	必須項目/省略可能	説明	使用可能なバージョン
inReplyTo	String	recipients または inReplyTo を指定します。両方を指定することはできません。	このメッセージが含まれる会話を識別する既存のメッセージの ID	23.0
recipients	String	recipients または inReplyTo を指定します。両方を指定することはできません。	目的のメッセージ受信者であるユーザ (最大 9 人) のリスト。ユーザ ID のカンマ区切りのリスト。	23.0
text	String	必須項目	メッセージのテキスト (最大 10,000 文字)	23.0

GET の要求パラメータ

パラメータ名	型	必須項目/省略可能	説明	使用可能なバージョン
page	String	省略可能	取得を開始する場所を示すページトークン。レスポンスボディの NextPageUrl プロパティからこのトークンを取得します。	23.0
pageSize	Integer	省略可能	ページあたりの項目数を指定しま��。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。	23.0
q	String	省略可能	検索する文字列を指定します。検索文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。このパラメータは省略可能です。 クエリパラメータが検索するのはメッセージテキスト本文のみで、ユーザ名、役職などは検索しません。 メモ	24.0

GET または HEAD のレスポンスボディ

Message Collection

POST のレスポンスボディ

Message

GET または HEAD のレスポンスボディの例