コミュニティ
コミュニティとは、従業員、顧客、パートナーをつなぐブランド空間です。ビジネスニーズに合わせてコミュニティをカスタマイズしながら作成することができ、その後もコミュニティ間をシームレスに移行できます。
特定のコミュニティでは、ほとんどの Chatter REST API リソースを要求できます。たとえば、特定のコミュニティ内で、Feeds、Files、Groups、Topics、Users リソースに対して要求を実行できます。コミュニティでリソースを使用できる場合、そのドキュメントには /connect/communities/communityId で始まるリソースが含まれます。
一部の Chatter REST API リソースは、コミュニティ内でのみ使用できます。これには、コンテンツのフラグ設定とモデレート、管理トピックの使用、ユーザの評価に関する情報の取得を行うためのリソースが含まれます。
コミュニティで使用できるリソースは、ログインなしでのアクセスを許可するかどうかに関係なく使用できます。ただし、コミュニティでログインなしでのアクセスが許可されている場合、ゲストユーザはどの Chatter REST API リソースにもアクセスできません。
次の表に、コミュニティ内でのみ使用できるリソースを示します。
| リソース | HTTP のメソッド | ToDo | |
|---|---|---|---|
| /connect/communities | GET | コンテキストユーザが使用できるすべてのコミュニティのリストを取得します。コミュニティを作成します。 | |
| /connect/communities/communityId | GET | コミュニティに関する情報を取得します。 | |
| /connect/communities/communityId/publish | コミュニティを公開します。 | ||
| /connect/communities/communityId/chatter/comments/commentId/moderation-flags | GET、POST、DELETE | コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーが 1 つのコメントにフラグを設定した回数を取得します。また、コメントにモデレーションのフラグを設定したり、コメントのすべてのフラグを削除したりします。 コンテキストユーザがコミュニティモデレータでない場合は、ユーザがコメントにフラグを設定したかどうかを返します。また、コメントにモデレーションのフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。 |
|
| /connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/moderation | GET、POST、DELETE | フィード要素のモデレーション機能に関する情報の取得、フィード要素へのモデレーションフラグの追加、またはフィード要素のすべてのモデレーションフラグの削除を行います。 | |
| /connect/communities/communityId/files/moderation | GET |
コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーがフラグを設定したファイルを取得します。 |
|
| /connect/communities/communityId/files/fileId/moderation-flags | GET、POST、DELETE | コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーが 1 つのファイルにフラグを設定した回数を取得します。また、ファイルにモデレーションのフラグを設定したり、ファイルのすべてのフラグを削除したりします。 コンテキストユーザがコミュニティモデレータでない場合は、ユーザがファイルにフラグを設定したかどうかを取得します。また、ファイルにモデレーションのフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。 |
|
| /connect/communities/communityId/chatter/feeds/moderation/feed-elements | GET | コンテキストユーザが「コミュニティフィードのモデレート」権限を持つコミュニティモデレータの場合、コミュニティメンバーによってフラグが設定された、コミュニティ内のすべてのフィード要素とコメントのリストを返します。デフォルトでは、結果ページごとに 25 件のフィード要素を返します。 | |
| /connect/communities/communityId/chatter/feeds/home/feed-elements | GET | コミュニティホームからのフィード要素とコメントを含むフィード。 | |
| /connect/communities/communityId/managed-topics | GET、POST、PATCH | コミュニティのすべての管理トピックを取得します。管理トピックの作成、管理トピック階層の作成、管理トピックの並び替えを行います。 | |
| /connect/communities/communityId/managed-topics/managedTopicId | GET、DELETE | コミュニティの管理トピックの情報取得または削除を行います。 | |
| /connect/communities/communityId/missions/users/userId | PATCH | ユーザの活動目的アクティビティ数を更新します。 | |
| /connect/communities/communityId/missions/users/userId/activities/export-job | GET | ユーザの活動目的アクティビティをエクスポートします。 | |
| /connect/communities/communityId/missions/users/userId/activities/purge-job | POST | ユーザの活動目的アクティビティを消去するジョブを開始します。 | |
| /connect/communities/communityId/question-and-answers/top-unanswered (パイロット) | GET | コミュニティのコンテキストユーザの上位の未回答の質問を取得します。 | |
| /connect/communities/communityId/topics/topicId/trending-articles | GET | コミュニティのトピックのトレンド記事を取得します。 | |
| /connect/communities/communityId/trending-articles | GET | コミュニティのトレンド記事を取得します。 | |
| /connect/communities/communityId/chatter/users/userId/audit-actions/counts | GET | コミュニティのユーザの監査統計を取得します。 | |
| /connect/communities/communityId/chatter/users/userId/reputation | GET | 指定されたコミュニティユーザの評価を返します。 |