ManagedTopics クラス

API バージョン

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopic createManagedTopic(String communityId, String recordId, ConnectApi.ManagedTopicType managedTopicType)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

recordId

型: String

トピックの ID。

managedTopicType

型: ConnectApi.ManagedTopicType

管理トピックの種別を指定します。

• Featured — コミュニティホームページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。
• Navigational — コミュニティのナビゲーションメニューに表示されるトピック。

1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。

管理トピックは、1 つの managedTopicType につき 25 個まで作成できます。

戻り値

型: ConnectApi.ManagedTopic

使用方法

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

API バージョン

35.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopic createManagedTopic(String communityId, String recordId, ConnectApi.ManagedTopicType managedTopicType, String parentId)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

recordId

型: String

トピックの ID。

managedTopicType

型: ConnectApi.ManagedTopicType

子管理トピックを作成する管理トピックの種別の Navigational を指定します。

1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。

管理トピックは、1 つの managedTopicType につき 25 個まで作成できます。

parentId

型: String

親管理トピックの ID。

最大 3 レベル (親、直接の子、その子) の管理トピックを作成でき、管理トピックにつき最大 10 個の子管理トピックを作成できます。

戻り値

型: ConnectApi.ManagedTopic

使用方法

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

API バージョン

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopic createManagedTopicByName(String communityId, String name, ConnectApi.ManagedTopicType managedTopicType)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

name

型: String

トピックの名前。

managedTopicType

型: ConnectApi.ManagedTopicType

管理トピックの種別を指定します。

• Featured — コミュニティホームページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。
• Navigational — コミュニティのナビゲーションメニューに表示されるトピック。

1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。

管理トピックは、1 つの managedTopicType につき 25 個まで作成できます。

戻り値

型: ConnectApi.ManagedTopic

使用方法

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

API バージョン

35.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopic createManagedTopicByName(String communityId, String name, ConnectApi.ManagedTopicType managedTopicType, String parentId)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

name

型: String

トピックの名前。

managedTopicType

型: ConnectApi.ManagedTopicType

子管理トピックを作成する管理トピックの種別の Navigational を指定します。

1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。

管理トピックは、1 つの managedTopicType につき 25 個まで作成できます。

parentId

型: String

親管理トピックの ID。

最大 3 レベル (親、直接の子、その子) の管理トピックを作成でき、管理トピックにつき最大 10 個の子管理トピックを作成できます。

戻り値

型: ConnectApi.ManagedTopic

使用方法

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

API バージョン

32.0

Chatter が必要かどうか

いいえ

署名

public static deleteManagedTopic(String communityId, String managedTopicId)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

managedTopicId

型: String

管理トピックの ID。

戻り値

型: Void

使用方法

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

API バージョン

32.0

ゲストユーザが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopic getManagedTopic(String communityId, String managedTopicId)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

managedTopicId

型: String

管理トピックの ID。

戻り値

型: ConnectApi.ManagedTopic

API バージョン

35.0

ゲストユーザが使用可能

35.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopic getManagedTopic(String communityId, String managedTopicId, Integer depth)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

managedTopicId

型: String

管理トピックの ID。

depth

型: Integer

整数 1 ～ 3 を指定します。1 を指定すると、ConnectApi.ManagedTopic 出力クラスの children プロパティが null になります。2 を指定すると、ConnectApi.ManagedTopic 出力クラスの children プロパティに、管理トピックの直接の子である管理トピック (存在する場合) が含まれます。3 を指定すると、直接の子である管理トピックとその子管理トピック (存在する場合) が取得されます。depth が指定されていない場合は、デフォルトの 1 に設定されます。

戻り値

型: ConnectApi.ManagedTopic

API バージョン

32.0

ゲストユーザが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopicCollection getManagedTopics(String communityId)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

戻り値

型: ConnectApi.ManagedTopicCollection

API バージョン

32.0

ゲストユーザが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopicCollection getManagedTopics(String communityId, ConnectApi.ManagedTopicType managedTopicType)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

managedTopicType

型: ConnectApi.ManagedTopicType

管理トピックの種別を指定します。

• Featured — コミュニティホームページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。
• Navigational — コミュニティのナビゲーションメニューに表示されるトピック。

1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。

戻り値

型: ConnectApi.ManagedTopicCollection

API バージョン

35.0

ゲストユーザが使用可能

35.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopicCollection getManagedTopics(String communityId, ConnectApi.ManagedTopicType managedTopicType, Integer depth)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

managedTopicType

型: ConnectApi.ManagedTopicType

管理トピックの種別を指定します。

• Featured — コミュニティホームページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。
• Navigational — コミュニティのナビゲーションメニューに表示されるトピック。

1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。

depth

型: Integer

整数 1 ～ 3 を指定します。1 を指定すると、ConnectApi.ManagedTopic 出力クラスの children プロパティが null になります。2 を指定すると、ConnectApi.ManagedTopic 出力クラスの children プロパティに、管理トピックの直接の子である管理トピック (存在する場合) が含まれます。3 を指定すると、直接の子である管理トピックとその子管理トピック (存在する場合) が取得されます。depth が指定されていない場合は、デフォルトの 1 に設定されます。

戻り値

型: ConnectApi.ManagedTopicCollection

API バージョン

35.0

ゲストユーザが使用可能

35.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopicCollection getManagedTopics(String communityId, ConnectApi.ManagedTopicType managedTopicType, String recordId, Integer depth)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

managedTopicType

型: ConnectApi.ManagedTopicType

管理トピックの種別を指定します。

• Featured — コミュニティホームページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。
• Navigational — コミュニティのナビゲーションメニューに表示されるトピック。

1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックを Featured トピックと Navigational トピックの両方にすることができます。

recordId

型: String

管理トピックに関連付けられたトピック の ID。

depth

型: Integer

整数 1 ～ 3 を指定します。1 を指定すると、ConnectApi.ManagedTopic 出力クラスの children プロパティが null になります。2 を指定すると、ConnectApi.ManagedTopic 出力クラスの children プロパティに、管理トピックの直接の子である管理トピック (存在する場合) が含まれます。3 を指定すると、直接の子である管理トピックとその子管理トピック (存在する場合) が取得されます。depth が指定されていない場合は、デフォルトの 1 に設定されます。

戻り値

型: ConnectApi.ManagedTopicCollection

API バージョン

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.ManagedTopicCollection reorderManagedTopics(String communityId, ConnectApi.ManagedTopicPositionCollectionInput managedTopicPositionCollection)

パラメータ

communityId

型: String

コミュニティの ID、internal、または null のいずれかを使用します。

managedTopicPositionCollection

型: ConnectApi.ManagedTopicPositionCollectionInput

管理トピックの相対位置のコレクション。このコレクションには、Featured および Navigational 管理トピックを含めることができます。すべての管理トピックを含める必要はありません。

戻り値

型: ConnectApi.ManagedTopicCollection

使用方法

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

親管理トピックまたは同じ親を持つ子管理トピックを並び替えできます。すべての管理トピックを ConnectApi.ManagedTopicPositionCollectionInput に含めない場合、管理トピックはまず ConnectApi.ManagedTopicPositionCollectionInput で指定されている位置に従って並び替えられ、その後で ConnectApi.ManagedTopicPositionCollectionInput に含まれていない管理トピックを次に使用可能な位置に下げて、並び替えられます。

例

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

ConnectApi.ManagedTopicPositionCollectionInput で次の情報を指定して、管理トピックを並び替えます。

結果は次のとおりです。