Newer Version Available
Topics Class
Namespace
Topics Methods
The following are methods for Topics. All methods are static.
assignTopic(communityId, recordId, topicId)
API Version
29.0
Requires Chatter
No
Signature
public static ConnectApi.Topic assignTopic(String communityId, String recordId, String topicId)
Parameters
Return Value
Type: ConnectApi.Topic
assignTopicByName(communityId, recordId, topicName)
API Version
29.0
Requires Chatter
No
Signature
public static ConnectApi.Topic assignTopicByName(String communityId, String recordId, String topicName)
Parameters
Return Value
Type: ConnectApi.Topic
createTopic(communityId, name, description)
API Version
36.0
Requires Chatter
No
Signature
public static ConnectApi.Topic createTopic(String communityId, String name, String description)
Parameters
Return Value
Type: ConnectApi.Topic
deleteTopic(communityId, topicId)
API Version
29.0
Requires Chatter
No
Signature
public static Void deleteTopic(String communityId, String topicId)
Parameters
Return Value
Type: Void
Usage
Topic deletion is asynchronous. If a topic is requested before the deletion completes, the response is 200: Successful and the isBeingDeleted property of ConnectApi.Topic is true in version 33.0 and later. If a topic is requested after the deletion completes, the response is 404: NOT_FOUND.
getGroupsRecentlyTalkingAboutTopic(communityId, topicId)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
Yes
Signature
public static ConnectApi.ChatterGroupSummaryPage getGroupsRecentlyTalkingAboutTopic(String communityId, String topicId)
Parameters
Return Value
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
getRecentlyTalkingAboutTopicsForGroup(communityId, groupId)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
Yes
Signature
public static ConnectApi.TopicPage getRecentlyTalkingAboutTopicsForGroup(String communityId, String groupId)
Parameters
Return Value
Type: ConnectApi.TopicPage
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
getRecentlyTalkingAboutTopicsForUser(communityId, userId)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
Yes
Signature
public static ConnectApi.TopicPage getRecentlyTalkingAboutTopicsForUser(String communityId, String userId)
Parameters
Return Value
Type: ConnectApi.TopicPage
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
getRelatedTopics(communityId, topicId)
API Version
Two topics that are assigned to the same feed item at least three times are related.
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getRelatedTopics(String communityId, String topicId)
Parameters
Return Value
Type: ConnectApi.TopicPage
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
getTopic(communityId, topicId)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.Topic getTopic(String communityId, String topicId)
Parameters
Return Value
Type: ConnectApi.Topic
getTopics(communityId, recordId)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopics(String communityId, String recordId)
Parameters
Return Value
Type: ConnectApi.TopicPage
getTopics(communityId)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopics(String communityId)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
Return Value
Type: ConnectApi.TopicPage
getTopics(communityId, sortParam)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopics(String communityId, ConnectApi.TopicSort sortParam)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- sortParam
- Type: ConnectApi.TopicSort
- Values are:
- popularDesc—Sorts topics by popularity with the most popular first. This value is the default.
- alphaAsc—Sorts topics alphabetically.
Return Value
Type: ConnectApi.TopicPage
getTopics(communityId, pageParam, pageSize)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopics(String communityId, Integer pageParam, Integer pageSize)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- pageParam
- Type: Integer
- Specifies the number of the page you want returned. Starts at 0. If you pass in null or 0, the first page is returned.
- pageSize
- Type: Integer
- Specifies the number of feed items per page. Valid values are from 1 through 100. If you pass in null, the default size is 25.
Return Value
Type: ConnectApi.TopicPage
getTopics(communityId, pageParam, pageSize, sortParam)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopics(String communityId, Integer pageParam, Integer pageSize, ConnectApi.TopicSort sortParam)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- pageParam
- Type: Integer
- Specifies the number of the page you want returned. Starts at 0. If you pass in null or 0, the first page is returned.
- pageSize
- Type: Integer
- Specifies the number of feed items per page. Valid values are from 1 through 100. If you pass in null, the default size is 25.
- sortParam
- Type: ConnectApi.TopicSort
- Values are:
- popularDesc—Sorts topics by popularity with the most popular first. This value is the default.
- alphaAsc—Sorts topics alphabetically.
Return Value
Type: ConnectApi.TopicPage
getTopics(communityId, q, sortParam)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopics(String communityId, String q, ConnectApi.TopicSort sortParam)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- q
- Type: String
- Specifies the string to search. The string must contain at least two characters, not including wildcards.
- sortParam
- Type: ConnectApi.TopicSort
- Values are:
- popularDesc—Sorts topics by popularity with the most popular first. This value is the default.
- alphaAsc—Sorts topics alphabetically.
Return Value
Type: ConnectApi.TopicPage
getTopics(communityId, q, pageParam, pageSize)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopics(String communityId, String q, Integer pageParam, Integer pageSize)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- q
- Type: String
- Specifies the string to search. The string must contain at least two characters, not including wildcards.
- pageParam
- Type: Integer
- Specifies the number of the page you want returned. Starts at 0. If you pass in null or 0, the first page is returned.
- pageSize
- Type: Integer
- Specifies the number of feed items per page. Valid values are from 1 through 100. If you pass in null, the default size is 25.
Return Value
Type: ConnectApi.TopicPage
getTopics(communityId, q, pageParam, pageSize, sortParam)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopics(String communityId, String q, Integer pageParam, Integer pageSize, ConnectApi.TopicSort sortParam)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- q
- Type: String
- Specifies the string to search. The string must contain at least two characters, not including wildcards.
- pageParam
- Type: Integer
- Specifies the number of the page you want returned. Starts at 0. If you pass in null or 0, the first page is returned.
- pageSize
- Type: Integer
- Specifies the number of feed items per page. Valid values are from 1 through 100. If you pass in null, the default size is 25.
- sortParam
- Type: ConnectApi.TopicSort
- Values are:
- popularDesc—Sorts topics by popularity with the most popular first. This value is the default.
- alphaAsc—Sorts topics alphabetically.
Return Value
Type: ConnectApi.TopicPage
getTopics(communityId, q, exactMatch)
API Version
33.0
Available to Guest Users
33.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopics(String communityId, String q, Boolean exactMatch)
Parameters
Return Value
Type: ConnectApi.TopicPage
getTopicsOrFallBackToRenamedTopics(communityId, q, exactMatch, fallBackToRenamedTopics)
API Version
35.0
Available to Guest Users
35.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTopicsOrFallBackToRenamedTopics(String communityId, String q, Boolean exactMatch, Boolean fallBackToRenamedTopics)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- q
- Type: String
- Specifies the string to search. The string must contain at least two characters, not including wildcards.
- exactMatch
- Type: Boolean
- Specify true to find a topic by its exact, case-insensitive name or to find the most recent renamed topic match if there isn’t an exact match.
- fallBackToRenamedTopics
- Type: Boolean
- Specify true and if there isn’t an exact match, the most recent renamed topic match is returned. If there are multiple renamed topic matches, only the most recent is returned. If there are no renamed topic matches, an empty collection is returned.
Return Value
Type: ConnectApi.TopicPage
getTopicSuggestions(communityId, recordId, maxResults)
API Version
29.0
Requires Chatter
No
Signature
public static ConnectApi.TopicSuggestionPage getTopicSuggestions(String communityId, String recordId, Integer maxResults)
Parameters
Return Value
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
getTopicSuggestions(communityId, recordId)
API Version
29.0
Requires Chatter
No
Signature
public static ConnectApi.TopicSuggestionPage getTopicSuggestions(String communityId, String recordId)
Parameters
Return Value
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
getTopicSuggestionsForText(communityId, text, maxResults)
API Version
29.0
Requires Chatter
No
Signature
public static ConnectApi.TopicSuggestionPage getTopicSuggestionsForText(String communityId, String text, Integer maxResults)
Parameters
Return Value
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
getTopicSuggestionsForText(communityId, text)
API Version
29.0
Requires Chatter
No
Signature
public static ConnectApi.TopicSuggestionPage getTopicSuggestionsForText(String communityId, String text)
Parameters
Return Value
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
getTrendingTopics(communityId)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTrendingTopics(String communityId)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
Return Value
Type: ConnectApi.TopicPage
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
getTrendingTopics(communityId, maxResults)
API Version
29.0
Available to Guest Users
32.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage getTrendingTopics(String communityId, Integer maxResults)
Parameters
Return Value
Type: ConnectApi.TopicPage
Usage
To test code that uses this method, use the matching set test method (prefix the method name with setTest). Use the set test method with the same parameters or the code throws an exception.
mergeTopics(communityId, topicId, idsToMerge)
API Version
33.0
Requires Chatter
No
Signature
public static ConnectApi.Topic mergeTopics(String communityId, String topicId, List<String> idsToMerge)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- topicId
- Type: String
- The ID for the primary topic for the merge. If this topic is a managed topic, it retains its topic type, topic images, and children topics.
- idsToMerge
- Type: List<String>
- A list of up to five comma-separated secondary topic IDs to merge with the primary topic. If any of these secondary topics are managed topics, they lose their topic type, topic images, and children topics. Their feed items are reassigned to the primary topic.
Return Value
Type: ConnectApi.Topic
Usage
reassignTopicsByName(communityId, recordId, topicNames)
API Version
35.0
Requires Chatter
No
Signature
public static ConnectApi.TopicPage reassignTopicsByName(String communityId, String recordId, ConnectApi.TopicNamesInput topicNames)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- recordId
- Type: String
- The ID of the record or feed item to which to assign the topic.
- topicNames
- Type: ConnectApi.TopicNamesInput
- A list of topics to replace the currently assigned topics. Optionally, a list of suggested topics to assign to improve future topic suggestions.
Return Value
Type: ConnectApi.TopicPage
unassignTopic(communityId, recordId, topicId)
API Version
29.0
Requires Chatter
No
Signature
public static Void unassignTopic(String communityId, String recordId, String topicId)
Parameters
Return Value
Type: Void
updateTopic(communityId, topicId, topic)
API Version
29.0
Requires Chatter
No
Signature
public static ConnectApi.Topic updateTopic(String communityId, String topicId, ConnectApi.TopicInput topic)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- topicId
- Type: String
- The ID for a topic.
- topic
- Type: ConnectApi.TopicInput
- A ConnectApi.TopicInput object containing the name and description of the topic or up to five comma-separated secondary topic IDs to merge with the primary topic.
Return Value
Type: ConnectApi.Topic
Usage
Topics Test Methods
The following are the test methods for Topics. All methods are static.
For information about using these methods to test your ConnectApi code, see Testing ConnectApi Code.
setTestGetGroupsRecentlyTalkingAboutTopic(communityId, topicId, result)
API Version
29.0
Signature
public static Void setTestGetGroupsRecentlyTalkingAboutTopic(String communityId, String topicId, ConnectApi.ChatterGroupSummaryPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- topicId
- Type: String
- The ID for a topic.
- result
- Type: ConnectApi.ChatterGroupSummaryPage
- The object containing test data.
Return Value
Type: Void
setTestGetRecentlyTalkingAboutTopicsForGroup(communityId, groupId, result)
API Version
29.0
Signature
public static Void setTestGetRecentlyTalkingAboutTopicsForGroup(String communityId, String groupId, ConnectApi.TopicPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- groupId
- Type: String
- The ID for a group.
- result
- Type: ConnectApi.TopicPage
- The object containing test data.
Return Value
Type: Void
setTestGetRecentlyTalkingAboutTopicsForUser(communityId, userId, result)
API Version
29.0
Signature
public static Void setTestGetRecentlyTalkingAboutTopicsForUser(String communityId, String userId, ConnectApi.TopicPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- userId
- Type: String
- The ID for a user.
- result
- Type: ConnectApi.TopicPage
- Specify the test topics page.
Return Value
Type: Void
setTestGetRelatedTopics(communityId, topicId, result)
API Version
29.0
Signature
public static Void setTestGetRelatedTopics(String communityId, String topicId, ConnectApi.TopicPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- topicId
- Type: String
- The ID for a topic.
- result
- Type: ConnectApi.TopicPage
- The object containing test data.
Return Value
Type: Void
setTestGetTopicSuggestions(communityId, recordId, maxResults, result)
API Version
29.0
Signature
public static Void setTestGetTopicSuggestions(String communityId, String recordId, Integer maxResults, ConnectApi.TopicSuggestionPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- recordId
- Type: String
- The ID for a record or feed item.
- maxResults
- Type: Integer
- Maximum number of topic suggestions that get returned. The default is 5. Value must be greater than 0 and less than or equal to 25.
- result
- Type: ConnectApi.TopicSuggestionPage
- Specify the test topic suggestions page.
Return Value
Type: Void
setTestGetTopicSuggestions(communityId, recordId, result)
API Version
29.0
Signature
public static Void setTestGetTopicSuggestions(String communityId, String recordId, ConnectApi.TopicSuggestionPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- recordId
- Type: String
- The ID for a record or feed item.
- result
- Type: ConnectApi.TopicSuggestionPage
- The object containing test data.
Return Value
Type: Void
setTestGetTopicSuggestionsForText(communityId, text, maxResults, result)
API Version
29.0
Signature
public static Void setTestGetTopicSuggestionsForText(String communityId, String text, Integer maxResults, ConnectApi.TopicSuggestionPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- text
- Type: String
- String of text.
- maxResults
- Type: Integer
- Maximum number of topic suggestions that get returned. The default is 5. Value must be greater than 0 and less than or equal to 25.
- result
- Type: ConnectApi.TopicSuggestionPage
- The object containing test data.
Return Value
Type: Void
setTestGetTopicSuggestionsForText(communityId, text, result)
API Version
29.0
Signature
public static Void setTestGetTopicSuggestionsForText(String communityId, String text, ConnectApi.TopicSuggestionPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- text
- Type: String
- String of text.
- result
- Type: ConnectApi.TopicSuggestionPage
- The object containing test data.
Return Value
Type: Void
setTestGetTrendingTopics(communityId, result)
API Version
29.0
Signature
public static Void setTestGetTrendingTopics(String communityId, ConnectApi.TopicPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- result
- Type: ConnectApi.TopicPage
- The object containing test data.
Return Value
Type: Void
setTestGetTrendingTopics(communityId, maxResults, result)
API Version
29.0
Signature
public static Void setTestGetTrendingTopics(String communityId, Integer maxResults, ConnectApi.TopicPage result)
Parameters
- communityId
- Type: String
- Use either the ID for a community, internal, or null.
- maxResults
- Type: Integer
- Maximum number of topic suggestions that get returned. The default is 5. Value must be greater than 0 and less than or equal to 25.
- result
- Type: ConnectApi.TopicPage
- The object containing test data.
Return Value
Type: Void