News Feed リソース

次のリソースを使用できます。

News Feed URL

コンテキストユーザーの全フィードのフィード要素への URL を返します。

リソース

1/chatter/feeds/news/userId

1/connect/communities/communityId/chatter/feeds/news/userId

userId は、コンテキストユーザーの ID または別名 me である必要があります。

メモ

適用開始バージョン

23.0

Chatter が必要かどうか

はい

HTTP のメソッド

GET または HEAD

要求パラメーター

パラメーター名	型	説明
sort	String	フィード内のフィード項目の順序。 CreatedDateAsc - 作成日の古い順に並べ替えられる。この並べ替え順は、DirectMessageModeration、Draft、Isolated、Moderation、PendingReview フィードでのみ使用できます。 CreatedDateDesc — 作成日の新しい順に並べ替えます。 LastModifiedDateDesc — 活動の新しい順に並べ替えられます。 MostViewed — 最も参照回数の多いコンテンツで並べ替えます。この並べ替え順は、ConnectApi.FeedFilter が UnansweredQuestions の場合に Home フィードでのみ使用できます。 Relevance — 最も関連性の高いコンテンツで並べ替えます。この並べ替え順は Company、Home、および Topics フィードで使用できます。 デフォルト値は、CreatedDateDesc です。

レスポンスボディ

Feed

レスポンスボディの例

1{ 
2   "feedElementPostUrl": "/services/data/v60.0/chatter/feed-elements",
3   "feedElementsUrl": "/services/data/v60.0/chatter/feeds/news/005xx000001Sv1mAAB/feed-elements"
4}

News Feed Is-Modified

指定した日時以降にニュースフィードが更新されたか変更されたかに関する情報を返します。

ニュースフィードに関するアンケート調査への Is-Modified リソースの使用

1. リソース /chatter/feeds/news/me/feed-elements か /chatter/feeds/news/me を使用して、ニュースフィードから最新要素を取得するか、フィードに関する情報を取得します。

   両方のリソースのレスポンスボディには isModifiedUrl プロパティが含まれます。このプロパティには Is-Modified リソースへの URL が含まれており、これには since 要求パラメーターが含まれていて、フィードの最終変更日が定義されています。ニュースフィードの要求の並べ替え順が変更されると、ニュースフィードは変更されます。

2. isModifiedUrl プロパティの URL に GET 要求を発行します。

   Feed Modified Info レスポンスには、次のプロパティが含まれます。

   • isModified — 前回のチェック以降、フィードが変更されたかどうかを示す boolean。このプロパティが true になる条件は、ニュースフィードに対する元の要求の並べ替え順によって決まります。たとえば、フィードが投稿によって並べ替えられており (CreatedDateDesc)、コメントが追加された場合、isModified は false になります。
   • nextPollUrl — Is-Modified リソースの URL を含む文字列。このプロパティに URL が含まれるのは、isModified が false の場合のみです。isModified が true の場合、nextPollUrl は null になります。
3. isModified プロパティが true である場合は、News Feed Elements リソースに対して GET 要求を発行し、ニュースフィードを更新します。
4. isModified プロパティが false である場合は、nextPollUrl プロパティの URL に対して GET 要求を発行します。この要求は Feed Modified Info レスポンスボディも返し、これには isModified プロパティ�� nextPollUrl プロパティが含まれます。

1 分間に 1 回を超えるアンケートはお勧めしません。

メモ

リソース

1/chatter/feeds/news/userId/is-modified

1/connect/communities/communityId/chatter/feeds/news/userId/is-modified

userId は、コンテキストユーザーの ID または別名 me である必要があります。

メモ

適用開始バージョン

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-elements

1/connect/communities/communityId/chatter/feeds/news/userId/feed-elements

userId は、コンテキストユーザーの ID または別名 me である必要があります。

メモ

適用開始バージョン

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 が生成した回答へのアクセス」権限を持つユーザーのみで有効です。 QuestionsWithCandidateAnswers​ReviewedPublished - レビュー済みまたは公開済みの回答候補がある質問のフィード要素。この値は、「Einstein が生成した回答へのアクセス」権限を持つユーザーのみで有効です。 Read — 経過日数が 30 日を超えたか、既読としてマークされたコンテキストユーザーのフィード要素。コンテキストユーザーがグループに参加している場合は既存のフィード要素を含みます。この値は、グループの Record フィードでのみ有効です。 SolvedQuestions — 質問で最良の回答があるフィード要素。 UnansweredQuestions — 質問で回答がないフィード要素。 UnansweredQuestionsWithCandidate​Answers - 回答はないものの回答候補が関連付けられている質問のフィード要素。この値は、「Einstein が生成した回答へのアクセス」権限を持つユーザーのみで有効です。 Unread — 過去 30 日間に作成された、既読としてマークされていないコンテキストユーザーのフィード要素。この値は、グループの Record フィードでのみ有効です。 UnsolvedQuestions — 質問で最良の回答がないフィード要素。	省略可能	32.0
page	String	生成されたトークン。フィード内のフィード要素のビューを示します。 ページトークンは、レスポンスボディの一部として、nextPageURL など、いずれかの URL パラメーターで返されます。 1"nextPageUrl": 2"/services/data/v60.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
recentComment​Count	Integer	フィード要素ごとに含めるコメントの最大数。デフォルト値は 3 です。最大値は、25 です。	省略可能	31.0
sort	String	フィード内のフィード項目の順序。 CreatedDateAsc - 作成日の古い順に並べ替えられる。この並べ替え順は、DirectMessageModeration、Draft、Isolated、Moderation、PendingReview フィードでのみ使用できます。 CreatedDateDesc — 作成日の新しい順に並べ替えます。 LastModifiedDateDesc — 活動の新しい順に並べ替えられます。 MostViewed — 最も参照回数の多いコンテンツで並べ替えます。この並べ替え順は、ConnectApi.FeedFilter が UnansweredQuestions の場合に Home フィードでのみ使用できます。 Relevance — 最も関連性の高いコンテンツで並べ替えます。この並べ替え順は Company、Home、および Topics フィードで使用できます。 デフォルト値は、CreatedDateDesc です。	省略可能	31.0
updatedSince	String	フィードの変更タイムスタンプと並べ替え順を定義する不透明トークン。 このトークンは作成しません。Feed Element Page レスポンスボディの updatesToken プロパティから、このトークンを取得します。 updatedSince パラメーターは、要求と同じ秒に作成されたフィード要素を返しません。	省略可能	31.0

GET のレスポンスボディ

Feed Element Page