Topic

「トピックを編集」または「すべてのデータの編集」権限を持つユーザは、トピックの名前および説明を編集できます。「トピックの削除」または「すべてのデータの編集」権限を持つユーザは、トピックをマージおよび削除できます。

リソース

1/connect/topics/topicId

1/connect/communities/communityId/topics/topicId

適用開始バージョン

29.0

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

Chatter が必要かどうか

いいえ

HTTP のメソッド

GET、PATCH、DELETE、および HEAD

PATCH のリクエストボディ

ルート XML タグ

<topic>

JSON の例

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

プロパティ

名前	型	説明	使用可能なバージョン
description	String	トピックのテキストによる説明	28.0
idsToMerge	String []	プライマリトピックにマージする最大 5 個のセカンダリトピック ID のリスト。 これらのセカンダリトピックのいずれかが管理トピックの場合、そのトピック種別、トピック画像、および子トピックを失います。フィード項目はプライマリトピックに再割り当てされます。	33.0
name	String	トピックの名前 トピック名の大文字、小文字、スペースのみを変更するには、このプロパティを使用します。	28.0

PATCH の要求パラメータ

パラメータ名	型	説明	適用開始バージョン
description	String	トピックのテキストによる説明	28.0
idsToMerge	String []	プライマリトピックにマージする最大 5 個のセカンダリトピック ID のリスト。 これらのセカンダリトピックのいずれかが管理トピックの場合、そのトピック種別、トピック画像、および子トピックを失います。フィード項目はプライマリトピックに再割り当てされます。	33.0
name	String	トピックの名前 トピック名の大文字、小文字、スペースのみを変更するには、このプロパティを使用します。	28.0

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

Topic

DELETE のレスポンスボディ

204: Successful Delete

トピックの削除は非同期です。削除の完了前にトピックを要求した場合、応答は 200: Successful になり、バージョン 33.0 以降では Topic 出力の isBeingDeleted プロパティが true になります。削除の完了後にトピックを要求した場合、応答は 404: Not found になります。

PATCH の例

この例では、要求パラメータを使用してトピックの説明を更新します。

1/connect/topics/0TOD000000006RxOAI?description=Edit+requests

この例では、JSON リクエストボディを使用して同じ要求を実行します。

1/connect/topics/0TOD000000006RxOAI
2
3{
4   "description" : "Edit requests"
5}