Chatter REST API 開発者ガイド
jコミュニティの使用
コミュニティは、従業員、お客様、およびパートナーが接続するブランド空間です。ビジネスニーズに合わせてコミュニティをカスタマイズしながら作成することができ、その後もコミュニティ間をシームレスに移行できます。
特定のコミュニティでは、ほとんどの 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/chatter/comments/commentId/moderation-flags | GET、POST、DELETE |
コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーが 1 つのコメントにフラグを設定した回数を返します。また、モデレーションのためにコメントにフラグを設定したり、コメントのすべてのフラグを削除したりします。 コンテキストユーザがコミュニティモデレータでない場合は、ユーザがコメントにフラグを設定したかどうかを返します。また、モデレーションのためにコメントにフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。 |
| /connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/moderation | GET、POST、DELETE | フィード要素のモデレーション機能に関する情報の取得、フィード要素へのモデレーションフラグの追加、またはフィード要素のすべてのモデレーションフラグの削除を行います。 |
| /connect/communities/communityId/chatter/files/moderation | GET |
コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーによってフラグが設定されたファイルを返します。 |
| /connect/communities/communityId/chatter/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/chatter/users/userId/reputation | GET | 指定されたコミュニティユーザの評価を返します。 |