この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Topics クラス

トピックの説明、トピックについて話しているユーザー数、関連トピック、トピックに投稿しているグループの情報など、トピックに関する情報にアクセスします。トピックの名前または説明の更新、トピックのマージ、レコードおよびフィード項目のトピックの追加または削除を行います。

名前空間

ConnectApi

Topics のメソッド

Topics のメソッドは次のとおりです。すべてのメソッドが静的です。

assignTopic(communityId, recordId, topicId)

レコードまたはフィード項目にトピックを割り当てます。

API バージョン

29.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.Topic assignTopic(String communityId, String recordId, String topicId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
recordId
型: String
レコードまたはフィード項目の ID。
topicId
型: String
トピックの ID。

戻り値

型: ConnectApi.​Topic

使用方法

レコードまたはフィード項目に既存のトピックを追加できるのは、「トピックを割り当てる」権限を持つユーザーのみです。ユーザーがオブジェクト種別のレコードにトピックを追加できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。

assignTopicByName(communityId, recordId, topicName)

レコードまたはフィード項目にトピックを割り当てます。

API バージョン

29.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.Topic assignTopicByName(String communityId, String recordId, String topicName)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
recordId
型: String
トピックが割り当てられるレコードまたはフィード項目の ID。
topicName
型: String
新規または既存のトピックの名前。

戻り値

型: ConnectApi.​Topic

使用方法

レコードまたはフィード項目に既存のトピックを追加できるのは、「トピックを割り当てる」権限を持つユーザーのみです。レコードまたはフィード項目に新規のトピックを追加できるのは、「トピックの作成」権限を持つユーザーのみです。ユーザーがオブジェクト種別のレコードにトピックを追加できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。

createTopic(communityId, name, description)

トピックを作成します。

API バージョン

36.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.Topic createTopic(String communityId, String name, String description)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
name
型: String
トピックの名前。
description
型: String
トピックの説明。

戻り値

型: ConnectApi.​Topic

使用方法

「トピックの作成」権限を持つユーザーのみがトピックを作成できます。

createTopicDataCategoryRules(communityId, dataCategoryGroup, dataCategory, topicNames)

データカテゴリごとに、トピックと記事の割り当てルールを作成します。

API バージョン

40.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage createTopicDataCategoryRules(String communityId, String dataCategoryGroup, String dataCategory, ConnectApi.TopicNamesInput topicNames)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
dataCategoryGroup
型: String
記事によって使用されるデータカテゴリグループ。
dataCategory
型: String
記事によって使用されるデータカテゴリ。
topicNames
型: ConnectApi.TopicNamesInput
ConnectApi.TopicNamesInput オブジェクト。データカテゴリの記事��割り当てるトピックの名前が含まれます。

戻り値

型: ConnectApi.TopicPage

deleteTopic(communityId, topicId)

トピックを削除します。

API バージョン

29.0

Chatter が必要かどうか

いいえ

署名

public static Void deleteTopic(String communityId, String topicId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
topicId
型: String
トピックの ID。

戻り値

型: Void

使用方法

「トピックの削除」または「すべてのデータの編集」権限を持つユーザーのみがトピックを削除できます。

トピックの削除は非同期です。削除の完了前にトピックを要求した場合、応答は成功し、バージョン 33.0 以降では ConnectApi.TopicisBeingDeleted プロパティが true になります。削除の完了後にトピックを要求した場合、応答は ConnectApi.NotFoundException になります。

getGroupsRecentlyTalkingAboutTopic(communityId, topicId)

トピックに最近投稿した 5 つのグループに関する情報を取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

はい

署名

public static ConnectApi.ChatterGroupSummaryPage getGroupsRecentlyTalkingAboutTopic(String communityId, String topicId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
topicId
型: String
トピックの ID。

使用方法

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getRecentlyTalkingAboutTopicsForGroup(communityId, groupId)

最近グループで使用されたトピックを 5 つまで取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

はい

署名

public static ConnectApi.TopicPage getRecentlyTalkingAboutTopicsForGroup(String communityId, String groupId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
groupId
型: String
グループの ID。

戻り値

型: ConnectApi.​TopicPage

使用方法

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getRecentlyTalkingAboutTopicsForUser(communityId, userId)

最近ユーザーによって使用されたトピックを 5 つまで取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

はい

署名

public static ConnectApi.TopicPage getRecentlyTalkingAboutTopicsForUser(String communityId, String userId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
userId
型: String
ユーザーの ID。

戻り値

型: ConnectApi.​TopicPage

使用方法

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getRelatedTopics(communityId, topicId)

トピックへの関連性が最も強いトピックを 5 つまで取得します。

同じフィード項目に 3 回以上割り当てられている 2 つのトピックが関連付けられます。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getRelatedTopics(String communityId, String topicId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
topicId
型: String
トピックの ID。

戻り値

型: ConnectApi.​TopicPage

使用方法

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getTopic(communityId, topicId)

トピックを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.Topic getTopic(String communityId, String topicId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
topicId
型: String
トピックの ID。

戻り値

型: ConnectApi.​Topic

getTopicDataCategoryRules(communityId, dataCategoryGroup, dataCategory)

データカテゴリごとに、トピックと記事の割り当てルールを取得します。

API バージョン

40.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopicDataCategoryRules(String communityId, String dataCategoryGroup, String dataCategory)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
dataCategoryGroup
型: String
記事によって使用されるデータカテゴリグループ。
dataCategory
型: String
記事によって使用されるデータカテゴリ。

戻り値

型: ConnectApi.TopicPage

getTopics(communityId, recordId)

レコードまたはフィード項目に割り当てられているトピックの最初のページを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopics(String communityId, String recordId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
recordId
型: String
レコードまたはフィード項目の ID。

戻り値

型: ConnectApi.​TopicPage

使用方法

ユーザーがオブジェクト種別のレコードにトピックを追加できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。

getTopics(communityId)

組織または Experience Cloud サイトのトピックの最初のページを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopics(String communityId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null

戻り値

型: ConnectApi.​TopicPage

getTopics(communityId, sortParam)

組織またはコミュニティの並べ替え済みトピックの最初のページを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopics(String communityId, ConnectApi.TopicSort sortParam)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
sortParam
型: ConnectApi.​TopicSort
値は次のとおりです。
  • popularDesc — トピックを人���順に並べ替えます。この値がデフォルトです。
  • alphaAsc — トピックをアルファベット順に並べ替えます。

戻り値

型: ConnectApi.​TopicPage

getTopics(communityId, pageParam, pageSize)

トピックのページを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopics(String communityId, Integer pageParam, Integer pageSize)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
pageParam
型: Integer
返すページの数。0 から開始します。null または 0 を渡すと、最初のページが返されます。
pageSize
型: Integer
ページあたりの項目数を指定します。有効な値は 1 ~ 100 です。null を渡すと、デフォルトサイズの 25 に設定されます。

戻り値

型: ConnectApi.​TopicPage

getTopics(communityId, pageParam, pageSize, sortParam)

並べ替え済みトピックのページを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopics(String communityId, Integer pageParam, Integer pageSize, ConnectApi.TopicSort sortParam)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
pageParam
型: Integer
返すページの数。0 から開始します。null または 0 を渡すと、最初のページが返されます。
pageSize
型: Integer
ページあたりの項目数を指定します。有効な値は 1 ~ 100 です。null を渡すと、デフォルトサイズの 25 に設定されます。
sortParam
型: ConnectApi.​TopicSort
値は次のとおりです。
  • popularDesc — トピックを人気順に並べ替えます。この値がデフォルトです。
  • alphaAsc — トピックをアルファベット順に並べ替えます。

戻り値

型: ConnectApi.​TopicPage

getTopics(communityId, q, sortParam)

検索条件に一致する並べ替え済みトピックを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopics(String communityId, String q, ConnectApi.TopicSort sortParam)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
q
型: String
検索する文字列を指定します。文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。
sortParam
型: ConnectApi.​TopicSort
値は次のとおりです。
  • popularDesc — トピックを人気順に並べ替えます。この値がデフォルトです。
  • alphaAsc — トピックをアルファベット順に並べ替えます。

戻り値

型: ConnectApi.​TopicPage

getTopics(communityId, q, pageParam, pageSize)

検索条件に一致するトピックのページを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopics(String communityId, String q, Integer pageParam, Integer pageSize)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
q
型: String
検索する文字列を指定します。文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。
pageParam
型: Integer
返すページの数。0 から開始します。null または 0 を渡すと、最初のページが返されます。
pageSize
型: Integer
ページあ���りの項目数を指定します。有効な値は 1 ~ 100 です。null を渡すと、デフォルトサイズの 25 に設定されます。

戻り値

型: ConnectApi.​TopicPage

getTopics(communityId, q, pageParam, pageSize, sortParam)

検索条件に一致する並べ替え済みトピックのページを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopics(String communityId, String q, Integer pageParam, Integer pageSize, ConnectApi.TopicSort sortParam)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
q
型: String
検索する文字列を指定します。文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。
pageParam
型: Integer
返すページの数。0 から開始します。null または 0 を渡すと、最初のページが返されます。
pageSize
型: Integer
ページあたりの項目数を指定します。有効な値は 1 ~ 100 です。null を渡すと、デフォルトサイズの 25 に設定されます。
sortParam
型: ConnectApi.​TopicSort
値は次のとおりです。
  • popularDesc — トピックを人気順に並べ替えます。この値がデフォルトです。
  • alphaAsc — トピックをアルファベット順に並べ替えます。

戻り値

型: ConnectApi.​TopicPage

getTopics(communityId, q, exactMatch)

名前が大文字と小文字を含め、完全一致するトピックを取得します。

API バージョン

33.0

ゲストユーザーが使用可能

33.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopics(String communityId, String q, Boolean exactMatch)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
q
型: String
検索する文字列を指定します。文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。
exactMatch
型: Boolean
大文字と小文字を含め、完全一致する名前でトピックを検索する場合は、true を指定します。

戻り値

型: ConnectApi.​TopicPage

getTopicsOrFallBackToRenamedTopics(communityId, q, exactMatch, fallBackToRenamedTopics)

完全一致がない場合に最近名前が変更されたトピックから一致するものを取得します。

API バージョン

35.0

ゲストユーザーが使用可能

35.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTopicsOrFallBackToRenamedTopics(String communityId, String q, Boolean exactMatch, Boolean fallBackToRenamedTopics)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
q
型: String
検索する文字列を指定します。文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。
exactMatch
型: Boolean
大文字と小文字を含め、完全一致する名前でトピックを検索する場合、または完全一致がない場合に最近名前が変更されたトピックから一致するものを検索する場合は、true を指定します。
fallBackToRenamedTopics
型: Boolean
true を指定します。完全一致がない場合は、最近名前が変更されたトピックから一致するものが返されます。一致する名前が変更されたトピックが複数ある場合は、最新のもののみが返されます。名前が変更されたトピックに一致するものがない場合は、空のコレクションが返されます。

戻り値

型: ConnectApi.​TopicPage

getTopicSuggestions(communityId, recordId, maxResults)

レコードまたはフィード項目の推奨トピックを指定した数まで取得します。

API バージョン

29.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicSuggestionPage getTopicSuggestions(String communityId, String recordId, Integer maxResults)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
recordId
型: String
レコードまたはフィード項目の ID。
maxResults
型: Integer
返されるトピックの提案の最大数。デフォルトは 5 です。値は 1 以上 25 以下で指定する必要があります。

使用方法

ユーザーがオブジェクト種別のレコードの推奨トピックを参照できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getTopicSuggestions(communityId, recordId)

レコードまたはフィード項目の推奨トピックを取得します。

API バージョン

29.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicSuggestionPage getTopicSuggestions(String communityId, String recordId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
recordId
型: String
レコードまたはフィード項目の ID。

使用方法

ユーザーがオブジェクト種別のレコードの推奨トピックを参照できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getTopicSuggestionsForText(communityId, text, maxResults)

テキスト文字列の推奨トピックを指定した数まで取得します。

API バージョン

29.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicSuggestionPage getTopicSuggestionsForText(String communityId, String text, Integer maxResults)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
text
型: String
テキスト文字列。
maxResults
型: Integer
返されるトピックの提案の最大数。デフォルトは 5 です。値は 1 以上 25 以下で指定する必要があります。

使用方法

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getTopicSuggestionsForText(communityId, text)

テキスト文字列の推奨トピックを取得します。

API バージョン

29.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicSuggestionPage getTopicSuggestionsForText(String communityId, String text)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
text
型: String
テキスト文字列。

使用方法

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getTrendingTopics(communityId)

組織または Experience Cloud サイトのトレンドトピックを取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTrendingTopics(String communityId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null

戻り値

型: ConnectApi.​TopicPage

使用方法

ユーザーが投稿やコメントの中で特定のトピックを追加したり、同じトピックの投稿にコメントしたりいいね! と言う頻度が短期間で高くなるほど、トレンドトピックになる可能性が高まります。たとえば、同僚が近々 Dreamforce の会議に出席することになっており、Chatter でそれについての議論を開始すると、「Dreamforce」がトレンドトピックとして表示されます。トレンドトピックは、人気度のみに基づくのではなく、通常は、会議やプロジェクトの期限など、活動の急な増加を伴う、頻繁には行われない 1 回限りの行動に関連するトピックが表示されます。

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getTrendingTopics(communityId, maxResults)

組織または Experience Cloud サイトのトレンドトピックを指定した数まで取得します。

API バージョン

29.0

ゲストユーザーが使用可能

32.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage getTrendingTopics(String communityId, Integer maxResults)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
maxResults
型: Integer
返されるトピックの提案の最大数。デフォルトは 5 です。値は 1 以上 25 以下で指定する必要があります。

戻り値

型: ConnectApi.​TopicPage

使用方法

ユーザーが投稿やコメントの中で特定のトピックを追加したり、同じトピックの投稿にコメントしたりいいね! と言う頻度が短期間で高くなるほど、トレンドトピックになる可能性が高まります。たとえば、同僚が近々 Dreamforce の会議に出席することになっており、Chatter でそれについての議論を開始すると、「Dreamforce」がトレンドトピックとして表示されます。トレンドトピックは、人気度のみに基づくのではなく、通常は、会議やプロジェクトの期限など、活動の急な増加を伴う、頻繁には行われない 1 回限りの行動に関連するトピックが表示されます。

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

mergeTopics(communityId, topicId, idsToMerge)

最大 5 個のセカンダリトピックをプライマリトピックにマージします。

API バージョン

33.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.Topic mergeTopics(String communityId, String topicId, List<String> idsToMerge)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
topicId
型: String
マージのプライマリトピックの ID。このトピックが管理トピックの場合は、トピック種別、トピック画像、および子トピックが保持されます。
idsToMerge
型: List<String>
プライマリトピックにマージする最大 5 個のセカンダリトピック ID のカンマ区切りリスト。セカンダリトピックのいずれかがナビゲーショントピックまたは主要トピックの場合、そのトピック種別、トピック画像、および子トピックを失います。フィード項目はプライマリトピックに再割り当てされます。トピックをコンテンツトピックとマージしても、コンテンツの関連付けは保持されます。被支持者が無効であるトピックをマージする場合、その支持はプライマリトピックに対応付けられません。

戻り値

型: ConnectApi.​Topic

使用方法

「トピックの削除」または「すべてのデータの編集」権限を持つユーザーのみがトピックをマージできます。

reassignTopicDataCategoryRules(communityId, dataCategoryGroup, dataCategory, topicNames)

既存のルールを削除して新しいルールを作成し、データカテゴリごとにトピックと記事の割り当てルールを再割り当てします。

API バージョン

40.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage reassignTopicDataCategoryRules(String communityId, String dataCategoryGroup, String dataCategory, ConnectApi.TopicNamesInput topicNames)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
dataCategoryGroup
型: String
記事によって使用されるデータカテゴリグループ。
dataCategory
型: String
記事によって使用されるデータカテゴリ。
topicNames
型: ConnectApi.TopicNamesInput
ConnectApi.TopicNamesInput オブジェクト。データカテゴリの記事に再割り当てするトピックの名前が含まれます。

戻り値

型: ConnectApi.TopicPage

reassignTopicsByName(communityId, recordId, topicNames)

レコードまたはフィード項目のすべてのトピックを再割り当てします。つまり、レコードまたはフィード項目のすべての割り当て済みトピックを削除して、トピックを追加します。必要に応じて、今後の推奨トピックを改善するために、レコードまたはフィード項目に割り当てる推奨トピックのリストを提供します。

API バージョン

35.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage reassignTopicsByName(String communityId, String recordId, ConnectApi.TopicNamesInput topicNames)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
recordId
型: String
トピックが割り当てられるレコードまたはフィード項目の ID。
topicNames
型: ConnectApi.TopicNamesInput
現在割り当てられているトピックと置き換えるトピックのリスト。必要に応じて、今後の推奨トピックを改善するために割り当てる推奨トピックのリスト。

戻り値

型: ConnectApi.​TopicPage

使用方法

レコードまたはフィード項目からトピックを削除したり、レコードまたはフィード項目に既存のトピックを追加したりできるのは、「トピックの割り当て」権限を持つユーザーのみです。レコードまたはフィード項目に新規のトピックを追加できるのは、「トピックの作成」権限を持つユーザーのみです。ユーザーがオブジェクト種別のレコードにトピックを追加できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。

unassignTopic(communityId, recordId, topicId)

レコードまたはフィード項目からトピックを削除します。

API バージョン

29.0

Chatter が必要かどうか

いいえ

署名

public static Void unassignTopic(String communityId, String recordId, String topicId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
recordId
型: String
レコードまたはフィード項目の ID。
topicId
型: String
トピックの ID。

戻り値

型: Void

使用方法

フィード項目またはレコードからトピックを削除できるのは、「トピックを割り当てる」権限を持つユーザーのみです。ユーザーがオブジェクト種別のレコードにトピックを追加できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。

updateTopic(communityId, topicId, topic)

トピックの説明または名前を更新したり、最大 5 個のセカンダリトピックをプライマリトピックにマージしたりします。

API バージョン

29.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.Topic updateTopic(String communityId, String topicId, ConnectApi.TopicInput topic)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
topicId
型: String
トピックの ID。
topic
型: ConnectApi.TopicInput
トピックの名前と説明、またはプライマリトピックにマージする最大 5 個のカンマ区切りのセカンダリトピック ID が含まれる ConnectApi.TopicInput オブジェクト。

戻り値

型: ConnectApi.​Topic

使用方法

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

updateTopicsForArticlesInDataCategory(communityId, dataCategoryGroup, dataCategory, articleTopicAssignmentJob)

データカテゴリの記事にトピックを割り当て、記事からトピックの割り当てを解除します。

API バージョン

40.0

Chatter が必要かどうか

いいえ

署名

public static ConnectApi.TopicPage updateTopicsForArticlesInDataCategory(String communityId, String dataCategoryGroup, String dataCategory, ConnectApi.ArticleTopicAssignmentJobInput articleTopicAssignmentJob)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
dataCategoryGroup
型: String
記事によって使用されるデータカテゴリグループ。
dataCategory
型: String
記事によって使用されるデータカテゴリ。
articleTopicAssignmentJob
型: ConnectApi.ArticleTopicAssignmentJobInput
どのトピックに操作を実行するかを示す ConnectApi.ArticleTopicAssignmentJobInput オブジェクト。

戻り値

型: ConnectApi.TopicPage

Topics テストメソッド

Topics のテストメソッドを次に示します。すべてのメソッドが静的です。

これらのメソッドを使用して ConnectApi コードをテストする方法の詳細は、「ConnectApi コードのテスト」を参照してください。

setTestGetGroupsRecentlyTalkingAboutTopic(communityId, topicId, result)

一致する ConnectApi.getGroupsRecentlyTalkingAboutTopic メソッドをテストコンテキストでコールするときに返される ConnectApi.ChatterGroupSummaryPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetGroupsRecentlyTalkingAboutTopic(String communityId, String topicId, ConnectApi.ChatterGroupSummaryPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
topicId
型: String
トピックの ID。
result
型: ConnectApi.​Chatter​Group​SummaryPage
テストデータを含むオブジェクト。

戻り値

型: Void

setTestGetRecentlyTalkingAboutTopicsForGroup(communityId, groupId, result)

一致する ConnectApi.getRecentlyTalkingAboutTopicsForGroup メソッドをテストコンテキストでコールするときに返される ConnectApi.​TopicPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetRecentlyTalkingAboutTopicsForGroup(String communityId, String groupId, ConnectApi.​TopicPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
groupId
型: String
グループの ID。
result
型: ConnectApi.​TopicPage
テストデータを含むオブジェクト。

戻り値

型: Void

setTestGetRecentlyTalkingAboutTopicsForUser(communityId, userId, result)

一致する ConnectApi.getRecentlyTalkingAboutTopicsForUser メソッドをテストコンテキストでコールするときに返される ConnectApi.​TopicPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetRecentlyTalkingAboutTopicsForUser(String communityId, String userId, ConnectApi.TopicPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
userId
型: String
ユーザーの ID。
result
型: ConnectApi.​TopicPage
テストトピックページを指定します。

戻り値

型: Void

setTestGetRelatedTopics(communityId, topicId, result)

一致する ConnectApi.getRelatedTopics メソッドをテストコンテキストでコールするときに返される ConnectApi.TopicPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetRelatedTopics(String communityId, String topicId, ConnectApi.TopicPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
topicId
型: String
トピックの ID。
result
型: ConnectApi.​TopicPage
テストデータを含むオブジェクト。

戻り値

型: Void

setTestGetTopicSuggestions(communityId, recordId, maxResults, result)

一致する ConnectApi.getTopicSuggestions メソッドをテストコンテキストでコールするときに返される ConnectApi.TopicSuggestionPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetTopicSuggestions(String communityId, String recordId, Integer maxResults, ConnectApi.TopicSuggestionPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
recordId
型: String
レコードまたはフィード項目の ID。
maxResults
型: Integer
返されるトピックの提案の最大数。デフォルトは 5 です。値は 1 以上 25 以下で指定する必要があります。
result
型: ConnectApi.​TopicSuggestionPage
テストトピックの提案ページを指定します。

戻り値

型: Void

setTestGetTopicSuggestions(communityId, recordId, result)

一致する ConnectApi.getTopicSuggestions メソッドをテストコンテキストでコールするときに返される ConnectApi.TopicSuggestionPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetTopicSuggestions(String communityId, String recordId, ConnectApi.​TopicSuggestionPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
recordId
型: String
レコードまたはフィード項目の ID。
result
型: ConnectApi.​TopicSuggestionPage
テストデータを含むオブジェクト。

戻り値

型: Void

setTestGetTopicSuggestionsForText(communityId, text, maxResults, result)

一致する ConnectApi.getTopicSuggestionsForText メソッドをテストコンテキストでコールするときに返される ConnectApi.TopicSuggestionPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetTopicSuggestionsForText(String communityId, String text, Integer maxResults, ConnectApi.TopicSuggestionPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
text
型: String
テキスト文字列。
maxResults
型: Integer
返されるトピックの提案の最大数。デフォルトは 5 です。値は 1 以上 25 以下で指定する必要があります。
result
型: ConnectApi.​TopicSuggestionPage
テストデータを含むオブジェクト。

戻り値

型: Void

setTestGetTopicSuggestionsForText(communityId, text, result)

一致する ConnectApi.getTopicSuggestionsForText メソッドをテストコンテキストでコールするときに返される ConnectApi.TopicSuggestionPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetTopicSuggestionsForText(String communityId, String text, ConnectApi.TopicSuggestionPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
text
型: String
テキスト文字列。
result
型: ConnectApi.​TopicSuggestionPage
テストデータを含むオブジェクト。

戻り値

型: Void

setTestGetTrendingTopics(communityId, result)

一致する ConnectApi.getTrendingTopics メソッドをテストコンテキストでコールするときに返される ConnectApi.TopicPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetTrendingTopics(String communityId, ConnectApi.TopicPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
result
型: ConnectApi.​TopicPage
テストデータを含むオブジェクト。

戻り値

型: Void

setTestGetTrendingTopics(communityId, maxResults, result)

一致する ConnectApi.getTrendingTopics メソッドをテストコンテキストでコールするときに返される ConnectApi.TopicPage オブジェクトを登録します。メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、例外が発生します。

API バージョン

29.0

署名

public static Void setTestGetTrendingTopics(String communityId, Integer maxResults, ConnectApi.TopicPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
maxResults
型: Integer
返されるトピックの提案の最大数。デフォルトは 5 です。値は 1 以上 25 以下で指定する必要があります。
result
型: ConnectApi.​TopicPage
テストデータを含むオブジェクト。

戻り値

型: Void