Managed Topics

コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) のみが、管理トピックの作成または並び替えを行うことができます。

リソース

1/connect/communities/communityId/managed-topics

使用可能なバージョン

32.0

Chatter が必要かどうか

いいえ

HTTP メソッド

GET、POST、PATCH、HEAD

GET の要求パラメータ

パラメータ名	型	説明	必須項目/省略可能	使用可能なバージョン
managedTopic​Type	String	管理トピックの種別。 Featured — コミュニティホームページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。 Navigational — コミュニティのナビゲーションメニューに表示されるトピック。 1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。	省略可能	32.0

GET のレスポンスボディ

Managed Topic Collection

POST のリクエストボディ

ルート XML タグ

<managedTopic>

JSON の例

1{
2"managedTopicType" :"Featured",
3"recordId" :"0TOD00000000cwk"
4}

プロパティ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
managedTopic​Type	String	管理トピックの種別。 Featured — コミュニティホームページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。 Navigational — コミュニティのナビゲーションメニューに表示されるトピック。 1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。 managedTopicType につき、最大 25 個の管理トピックを作成できます。	必須項目	32.0
name	String	管理トピックの名前。	新規トピックでは必須 name または recordId を指定する必要があります。両方を指定することはできません。	32.0
recordId	String	管理トピックになるレコードの ID。 バージョン 32.0 では、recordId はトピック ID である必要があります。	Name プロパティが使用されていない場合、既存のトピックに必要です。 name または recordId を指定する必要があります。両方を指定することはできません。	32.0

POST の要求パラメータ

パラメータ名	型	説明	必須項目/省略可能	使用可能なバージョン
managedTopic​Type	String	管理トピックの種別。 Featured — コミュニティホームページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。 Navigational — コミュニティのナビゲーションメニューに表示されるトピック。 1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。 managedTopicType につき、最大 25 個の管理トピックを作成できます。	必須項目	32.0
name	String	管理トピックの名前。	新規トピックでは必須 name または recordId を指定する必要があります。両方を指定することはできません。	32.0
recordId	String	管理トピックになるレコードの ID。 バージョン 32.0 では、recordId はトピック ID である必要があります。	Name プロパティが使用されていない場合は必須 name または recordId を指定する必要があります。両方を指定することはできません。	32.0

POST のレスポンスボディ

Managed Topic

PATCH のリクエストボディ

ルート XML タグ

<managedTopicPositionCollection>

JSON の例

1{
2"managedTopicPositions" : [
3  {
4    "managedTopicId" :"0mtD0000000001aIAA",
5    "position" :"0"
6  },
7  {
8    "managedTopicId" :"0mtD0000000002qIAA",
9    "position" :"2"
10  }
11  ]
12}

プロパティ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
managedTopic​Positions	Managed Topic Position Input[]	Managed Topic Position リクエストボディのコレクション。このコレクションには、Featured および Navigational 管理トピックを含めることができます。また、すべての管理トピックを含める必要はありません。 managedTopicPositions にすべての管理トピックを含めない場合、管理トピックは managedTopicPositions で指示された位置に従って並び替えられ、managedTopicPositions に含まれない管理トピックは次に空いている位置まで順序を下げられます。「管理トピックの並び替えの例」を参照してください。	必須項目	32.0

管理トピックの並び替えの例

次の管理トピックがあるとします。

管理トピック	位置
ManagedTopicA	0
ManagedTopicB	1
ManagedTopicC	2
ManagedTopicD	3
ManagedTopicE	4

Managed Topic Position Collection Input に次の情報を含めて管理トピックを並び替えます。

管理トピック	位置
ManagedTopicD	0
ManagedTopicE	2

結果は次のとおりです。

管理トピック	位置
ManagedTopicD	0
ManagedTopicA	1
ManagedTopicE	2
ManagedTopicB	3
ManagedTopicC	4

PATCH のレスポンスボディ

Managed Topic Collection