Connect REST API 開発者ガイド
jNews Feed リソース
次のリソースを使用できます。
| リソース | 説明 |
|---|---|
| /chatter/feeds/news/me | コンテキストユーザの全フィードのフィード要素への URL を返します。 |
| /chatter/feeds/news/me/is-modified | 指定した日時以降にニュースフィードが更新されたか変更されたかに関する情報を返します。 |
| /chatter/feeds/news/me/feed-elements | コンテキストユーザが所有するグループかメンバーであるグループすべてからの全フィード要素と、コンテキストユーザがフォローしている全ファイル、レコード、およびユーザからの全フィード要素。このリソースは、フィード要素に関する情報を取得し、フィード要素を投稿するために使用します。 |
News Feed URL
コンテキストユーザの全フィードのフィード要素への URL を返します。
- リソース
-
1/chatter/feeds/news/userId1/connect/communities/communityId/chatter/feeds/news/userId - 適用開始バージョン
- 23.0
- Chatter が必要かどうか
- はい
- HTTP メソッド
- GET または HEAD
- 要求パラメータ
-
- レスポンスボディ
- Feed
- レスポンスボディの例
-
1{ 2 "feedElementPostUrl": "/services/data/v52.0/chatter/feed-elements", 3 "feedElementsUrl": "/services/data/v52.0/chatter/feeds/news/005xx000001Sv1mAAB/feed-elements" 4}
News Feed Is-Modified
- ニュースフィードに関するアンケート調査への Is-Modified リソースの使用
-
- リソース /chatter/feeds/news/me/feed-elements か /chatter/feeds/news/me を使用して、ニュースフィードから最新要素を取得するか、フィードに関する情報を取得します。
両方のリソースのレスポンスボディには isModifiedUrl プロパティが含まれます。このプロパティには Is-Modified リソースへの URL が含まれており、これには since 要求パラメータが含まれていて、フィードの最終変更日が定義されています。ニュースフィードの要求の並び替え順が変更されると、ニュースフィードは変更されます。
-
isModifiedUrl プロパティの URL に GET 要求を発行します。 Feed Modified Info レスポンスには、次のプロパティが含まれます。
- isModified — 前回のチェック以降、フィードが変更されたかどうかを示す boolean。このプロパティが true になる条件は、ニュースフィードに対する元の要求の並び替え順によって決まります。たとえば、フィードが投稿によって並び替えられており (CreatedDateDesc)、コメントが追加された場合、isModified は false になります。
- nextPollUrl — Is-Modified リソースの URL を含む文字列。このプロパティに URL が含まれるのは、isModified が false の場合のみです。isModified が true の場合、nextPollUrl は null になります。
- isModified プロパティが true である場合は、News Feed Elements リソースに対して GET 要求を発行し、ニュースフィードを更新します。
- isModified プロパティが false である場合は、nextPollUrl プロパティの URL に対して GET 要求を発行します。この要求は Feed Modified Info レスポンスボディも返し、これには isModified プロパティと nextPollUrl プロパティが含まれます。
- リソース /chatter/feeds/news/me/feed-elements か /chatter/feeds/news/me を使用して、ニュースフィードから最新要素を取得するか、フィードに関する情報を取得します。
- リソース
-
1/chatter/feeds/news/userId/is-modified1/connect/communities/communityId/chatter/feeds/news/userId/is-modified - 適用開始バージョン
- 26.0
- Chatter が必要かどうか
- はい
- HTTP メソッド
- GET または HEAD
- 要求パラメータ
-
パラメータ名 型 説明 必須か省略可能 適用開始バージョン since String フィードの変更タイムスタンプと並び替え順に関する情報を含む不透明トークン。 このトークンは作成しません。Feed Item Page または Feed Modified Info レスポンスボディの isModifiedToken プロパティから、このトークンを取得します。
必須 23.0 - レスポンスボディ
- Feed Modified Info
News Feed Elements
コンテキストユーザが所有するグループかメンバーであるグループすべてからの全フィード要素と、コンテキストユーザがフォローしている全ファイル、レコード、およびユーザからの全フィード要素。このリソースは、フィード要素に関する情報を取得し、フィード要素を投稿するために使用します。
フィード要素の投稿についての詳細は、「Feed Elements, Post and Search」を参照してください。
- リソース
-
1/chatter/feeds/news/userId/feed-elements1/connect/communities/communityId/chatter/feeds/news/userId/feed-elements - 適用開始バージョン
- 31.0
- Chatter が必要かどうか
- はい
- HTTP メソッド
- GET、HEAD
- GET の要求パラメータ
-
パラメータ名 型 説明 必須か省略可能 使用可能なバージョン density String フィードの密度。次のいずれかの値にします。 - AllUpdates — ユーザがフォローする人とレコード、およびユーザがメンバーとなっているグループからのすべての更新が表示されます。カスタムのおすすめも表示されます。
- FewerUpdates — ユーザがフォローする人とレコード、およびユーザがメンバーとなっているグループからのすべての更新が表示されます。カスタムのおすすめも表示されますが、レコードからのシステム生成された更新は非表示になります。
デフォルト値は、AllUpdates です。
省略可能 31.0 elementsPerBundle Integer バンドルに含める最大フィード要素数。値は 0 ～ 10 の整数である必要があります。デフォルト値は 3 です。 省略可能 31.0 filter String フィードの検索条件値。 - AllQuestions — 質問であるフィード要素。
- AuthoredBy — ユーザプロファイル所有者が作成したフィード要素。この値は、UserProfile フィードでのみ有効です。
- CommunityScoped — Experience Cloud サイトを範囲とするフィード要素。現在、これらのフィード要素には、User または Group 親レコードがあります。ただし、今後、他の親レコードタイプがサイトを範囲とする可能性があります。すべてのサイトで常に表示されるフィード要素は除外されます。この値は、UserProfile フィードでのみ有効です。
- QuestionsWithCandidateAnswers — 回答候補が関連付けられている質問のフィード要素。この値は、「Einstein が生成した回答へのアクセス」権限を持つユーザのみで有効です。
- QuestionsWithCandidateAnswersReviewedPublished — レビュー済みまたは公開済みの回答候補がある質問のフィード要素。この値は、「Einstein が生成した回答へのアクセス」権限を持つユーザのみで有効です。
- Read — 経過日数が 30 日を超えたか、既読としてマークされたコンテキストユーザのフィード要素。コンテキストユーザがグループに参加している場合は既存のフィード要素を含みます。この値は、グループの Record フィードでのみ有効です。
- SolvedQuestions — 質問で最良の回答があるフィード要素。
- UnansweredQuestions — 質問で回答がないフィード要素。
- UnansweredQuestionsWithCandidateAnswers — 回答はないものの回答候補が関連付けられている質問のフィード要素。この値は、「Einstein が生成した回答へのアクセス」権限を持つユーザのみで有効です。
- Unread — 過去 30 日間に作成された、既読としてマークされていないコンテキストユーザのフィード要素。この値は、グループの Record フィードでのみ有効です。
- UnsolvedQuestions — 質問で最良の回答がないフィード要素。
省略可能 32.0 page String 生成されたトークン。フィード内のフィード要素のビューを示します。 ページトークンは、レスポンスボディの一部として、nextPageURL など、いずれかの URL パラメータで返されます。1"nextPageUrl": 2"/services/data/v52.0/ 3chatter/feeds/news/ 4005D0000001GLowIAN 5/feed-elements 6?page=2011-03-30T17:34:50Z, 70D5D0000000DSv4KAG"省略可能 31.0 pageSize Integer ページあたりの要素数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。 省略可能 31.0 q String このフィード内のフィード要素の本文とコメントに含まれる 1 つ以上の検索キーワード。 検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く 2 文字以上が含まれている必要があります。「ワイルドカード」を参照してください。
省略可能 31.0 recentCommentCount Integer フィード要素ごとに含めるコメントの最大数。デフォルト値は 3 です。最大値は、25 です。 省略可能 31.0 sort String フィード内のフィード項目の順序。 - CreatedDateAsc — 作成日の古い順に並び替えられる。この並び替え順は、DirectMessageModeration、Draft、Moderation、PendingReview フィードでのみ使用できます。
- CreatedDateDesc — 作成日の新しい順に並び替えます。
- LastModifiedDateDesc — 活動の新しい順に並び替えられます。
- MostViewed — 最も参照回数の多いコンテンツで並び替えます。この並び替え順は、ConnectApi.FeedFilter が UnansweredQuestions の場合に Home フィードでのみ使用できます。
- Relevance — 最も関連性の高いコンテンツで並び替えます。この並び替え順は Company、Home、および Topics フィードで使用できます。
省略可能 31.0 updatedSince String フィードの変更タイムスタンプと並び替え順を定義する不透明トークン。 このトークンは作成しません。Feed Element Page レスポンスボディの updatesToken プロパティから、このトークンを取得します。
updatedSince パラメータは、要求と同じ秒に作成されたフィード要素を返しません。
省略可能 31.0 - GET のレスポンスボディ
- Feed Element Page