List of Topics

組織のトピックに関する情報取得またはトピックの作成を行います。

リソース

1/connect/topics

1/connect/communities/communityId/topics

適用開始バージョン

29.0

バージョン 28.0 では、/chatter/topics を使用します。

Chatter が必要かどうか

いいえ

HTTP メソッド

GET、POST、または HEAD

POST は、バージョン 36.0 以降で使用できます。

GET の要求パラメータ

パラメータ名	値	説明	必須項目/省略可能	使用可能なバージョン
exactMatch	Boolean	大文字と小文字を含め、完全一致する名前でトピックを検索する場合は、true を指定し、q パラメータと一緒に使用します。完全一致がない場合に最近名前が変更されたトピックから一致するものを検索する場合は、true を指定し、q パラメータおよび true に設定された fallBackToRenamed​Topics パラメータと一緒に使用します。デフォルト値は false です。	省略可能	28.0
fallBackTo​RenamedTopics	Boolean	q パラメータおよび true に設定された exactMatch パラメータと一緒に使用します。完全一致がなく、fallBackToRenamed​Topics が true に設定されている場合は、最近名前が変更されたトピックから一致するものが返されます。一致する名前が変更されたトピックが複数ある場合は、最新のもののみが返されます。名前が変更されたトピックに一致するものがない場合は、空のコレクションが返されます。	省略可能	35.0
page	Integer	トピックのページを指定する 0 より大きい整数。デフォルト値は、0 です。	省略可能	28.0
pageSize	Integer	ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。デフォルト値は 25 です。	省略可能	28.0
q	String	結果を絞り込むクエリ文字列。文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。	省略可能	28.0
sort	String	次のいずれかの値になります。 popularDesc: トピックを人気順に並び替えます。この値がデフォルトです。 alphaAsc: トピックをアルファベット順に並び替えます。	省略可能	28.0

GET のレスポンスボディ

Topic Collection

GET の例

この例では、アルファベット順に並び替えられたトピックのリストを要求します。

1/connect/topics?sort=alphaAsc

POST のリクエストボディ

ルート XML タグ

<topic>

JSON の例

1{ 
2   "description" : "World Wide Web Consortium (W3C) is the main international standards organization for the Web."
3   "name" : "W3C"}

プロパティ

パラメータ名	型	説明	適用開始バージョン
description	String	トピックのテキストによる説明	36.0
name	String	トピックの名前	36.0

POST の要求パラメータ

パラメータ名	型	説明	適用開始バージョン
description	String	トピックのテキストによる説明	36.0
name	String	トピックの名前	36.0

POST のレスポンスボディ

Topic