この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Record Feed Items

コンテキストユーザーがフォローしているレコードのフィード項目、または任意のレコードのフィード項目を取得します。フィード要素を post 送信してレコードフィードを検索します。
リソース
1/chatter/feeds/record/recordId/feed-items

recordId がユーザー ID の場合、コンテキストユーザーまたは別名 me と同じである必要があります。このリソースを使用してグループのフィード項目を取得するには、グループ ID を recordId として指定します。

メモ

使用可能なバージョン
23.0 ~ 31.0

バージョン 32.0 以降では、Record Feed Elements を使用します。

重要

Chatter が必要かどうか
はい
HTTP のメソッド
GET、POST
GET の要求パラメーター
パラメーター名 説明 必須か省略可能 使用可能なバージョン
density String フィードの密度。次のいずれかの値にします。
  • AllUpdates — ユーザーがフォローする人とレコード、およびユーザーがメンバーとなっているグループからのすべての更新が表示されます。カスタムのおすすめも表示されます。
  • FewerUpdates — ユーザーがフォローする人とレコード、およびユーザーがメンバーとなっているグループからのすべての更新が表示されます。カスタムのおすすめも表示されますが、レコードからのシステム生成された更新は非表示になります。

デフォルト値は、AllUpdates です。

省略可能 29.0 ~ 31.0
page String 生成されたトークン。フィード内のフィード項目のビューを示します。ページトークンは、レスポンスボディの一部として、nextPageURL など、いずれかの URL パラメーターで返されます。たとえば、次のようになります。
1"nextPageUrl": 
2"/services/data/v60.0/
3chatter/feeds/news/
4005D0000001GLowIAN
5/feed-items
6?page=2011-03-30T17:34:50Z,
70D5D0000000DSv4KAG"
省略可能 23.0 ~ 31.0
pageSize Integer ページあたりの項目数を指定します。有効な値は 1 ~ 100 です。サイズを指定しない場合、デフォルトは 25 です。 省略可能 23.0 ~ 31.0
q String このフィード内のフィード項目の本文とコメントに含まれる 1 つ以上の検索キーワード。

検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く 2 文字以上が含まれている必要があります。「ワイルドカード」を参照してください。

省略可能 28.0 ~ 31.0
recentComment​​Count Integer フィード項目ごとに含めるコメントの最大数。デフォルト値は 3 です。最大値は、25 です。 省略可能 29.0 ~ 31.0
showInternal​​Only Boolean 内部 (Experience Cloud サイト以外の) ユーザーからのフィード項目のみを表示するか (true)、否か (false) を指定します。デフォルト値は false です。 省略可能 30.0 ~ 31.0
sort String フィード内のフィード項目の順序。
  • CreatedDateAsc - 作成日の古い順に並べ替えられる。この並べ替え順は、DirectMessageModerationDraftIsolatedModerationPendingReview フィードでのみ使用できます。
  • CreatedDateDesc — 作成日の新しい順に並べ替えます。
  • LastModifiedDateDesc — 活動の新しい順に並べ替えられます。
  • MostViewed — 最も参照回数の多いコンテンツで並べ替えます。この並べ替え順は、ConnectApi.FeedFilterUnansweredQuestions の場合に Home フィードでのみ使用できます。
  • Relevance — 最も関連性の高いコンテンツで並べ替えます。この並べ替え順は、CompanyHome、および Topics フィードでのみ使用できます。
デフォルト値は、CreatedDateDesc です。
省略可能 23.0 ~ 31.0
updatedSince String フィードの変更タイムスタンプと並べ替え順を定義する不透明トークン。

このトークンは作成しません。Feed Item Page レスポンスボディの updatesToken プロパティから、このトークンを取得します。

省略可能 30.0 ~ 31.0
GET のレスポンスボディ
Feed Item Page
POST のリクエストボディ
ルート XML タグ
<feedItem>
JSON
次の例では、フィード項目にアンケートを添付します。
1{
2   "body":{
3      "messageSegments":[
4         {
5            "type":"Text",
6            "text":"When should we meet for release planning?"
7         }
8      ]
9   },
10   "capabilities":{
11      "poll":{
12         "choices":[
13            "Monday",
14            "Tuesday"
15         ]
16      }
17   },
18   "feedElementType":"FeedItem",
19   "subjectId":"me"
20}
プロパティ
名前 説明 必須か省略可能 使用可能なバージョン
attachment 種別によって異なる。 attachment パラメーターには、次のいずれか 1 つの値のみを指定できます。値は次のとおりです。

API バージョン 32.0 以降では、capabilities プロパティを使用します。

重要

省略可能
body Message Body Input メッセージ本文の説明。フィード項目とコメントの本文には、最大 10,000 文字まで含めることができます。この制限は変更可能なため、クライアントが FeedItem または FeedComment オブジェクトで describeSObjects() コールを実行することをお勧めします。最大許容文字数を判断するには、Body または CommentBody 項目の長さを見ます。本文には 25 文字まで使用できます。

フィード項目を共有するための originalFeedElementId を指定する場合、body プロパティを使用して最初のコメントをフィード項目に追加します。

フィード項目のこのプロパティを編集するには、/chatter/feed-elements​/feedElementId に対して PATCH 要求を実行します。フィード投稿の編集は、バージョン 34.0 以降でサポートされています。

フィード項目にコンテンツ機能またはリンク機能がある場合を除き必須 23.0
capabilities Feed Element Capabilities Input このフィード要素の動作を定義する機能。 省略可能 31.0
isBookmarked​ByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。

API バージョン 32.0 以降では、capabilities.bookmarks.​isBookmarkedByCurrentUser プロパティを使用します。

重要

省略可能 24.0 ~ 31.0
feedElementType String この入力が表すフィード要素の種別。

有効な値は FeedItem のみです。

フィード項目を作成する場合は必須 (POST)

フィード項目を更新する場合は省略可能 (PATCH)

31.0
originalFeed​ElementId String フィード要素を共有するには、18 文字の ID を指定します。

投稿の共有とファイルのアップロードを同じリクエストボディで行うことはできません。

メモ

API バージョン 39.0 以降では、capabilities.feedEntity​Share.feedEntityId プロパティを使用します。

重要

省略可能 31.0 ~ 38.0
originalFeedItemId String フィード項目を共有するには、18 文字の ID を指定します。

API バージョン 32.0 ~ 38.0 では、originalFeedElementId プロパティを使用します。API バージョン 39.0 以降では、capabilities.feedEntity​Share.feedEntityId プロパティを使用します。

重要

省略可能 24.0 ~ 31.0
subjectId String このフィード要素が投稿された親の ID。この値は、ユーザー、グループ、レコードの ID、またはコンテキストユーザーを示す文字列 me になります。

バージョン 45.0 以降では、このプロパティを新しい公開グループの ID に設定して、フィード要素を公開グループ間で移動できます。フィード要素を移動するときに他のプロパティを含めたり変更したりすることはできません。

必須 31.0
visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。
  • InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
  • AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。
  • 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
  • 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
フィード項目の親がユーザー、グループ、またはダイレクトメッセージの場合、フィード項目の visibilityAllUsers である必要があります。
省略可能 26.0
POST の要求パラメーター
次のいずれかのパラメーターセットを使用します。たとえば、リンクの post 送信とファイルの添付を同じ要求で行うことはできません。

既存のファイルを添付するためのパラメーター

パラメーター名 説明 必須か省略可能 使用可能なバージョン
attachmentType String 添付ファイルの種別。値 ExistingContent を含める必要があります。 必須 27.0 ~ 31.0
contentDocumentId String 既存のファイルの 18 文字の ID。 必須 23.0 ~ 31.0
isBookmarked​​ByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 26.0 ~ 31.0
text String フィード項目の���キスト。 省略可能 23.0 ~ 31.0
visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。
  • InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
  • AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。
  • 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
  • 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
フィード項目の親がユーザー、グループ、またはダイレクトメッセージの場合、フィード項目の visibilityAllUsers である必要があります。
省略可能 26.0 ~ 31.0

新規のファイルを添付するためのパラメーター

パラメーター名 説明 必須か省略可能 使用可能なバージョン
attachmentType String 添付ファイルの種別。値 NewFile を含める必要があります。 必須 27.0 ~ 31.0
desc String post 送信するファイルの説明。

このパラメーターは、バージョン 27.0 以降では使用しないでください。代わりに description を使用します。

注意

省略可能 23.0 ~ 26.0
description String post 送信するファイルの説明。 省略可能 27.0 ~ 31.0
fileName String post 送信するファイルのファイル名。

このパラメーターは、バージョン 24.0 以降では使用しないでください。代わりに title を使用します。

注意

必須 23.0 ~ 24.0
isBookmarked​​ByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 26.0 ~ 31.0
text String フィード項目のテキスト。 省略可能 23.0 ~ 31.0
title String アップロードまたは post 送信するファイルのファイル名。 必須 24.0 ~ 31.0
visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。
  • InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
  • AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。
  • 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
  • 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
フィード項目の親がユーザー、グループ、またはダイレクトメッセージの場合、フィード項目の visibilityAllUsers である必要があります。
省略可能 26.0 ~ 31.0
リンクを post 送信するためのパラメーター
パラメーター名 説明 必須か省略可能 使用可能なバージョン
attachmentType String 添付ファイルの種別。値 Link を含める必要があります。 必須 27.0 ~ 31.0
isBookmarked​​ByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 26.0 ~ 31.0
text String フィード項目のテキスト。 省略可能 23.0 ~ 31.0
url String リンクの URL。 必須 23.0 ~ 31.0
urlName String URL の名前。 省略可能 23.0 ~ 31.0
visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。
  • InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
  • AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。
  • 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
  • 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
フィード項目の親がユーザー、グループ、またはダイレクトメッセージの場合、フィード項目の visibilityAllUsers である必要があります。
省略可能 26.0 ~ 31.0
アンケートを post 送信するためのパラメーター
パラメーター名 説明 必須か省略可能 使用可能なバージョン
attachmentType String 添付ファイルの種別。値 Poll を含める必要があります。 必須 27.0 ~ 31.0
isBookmarked​​ByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 26.0 ~ 31.0
pollChoice1pollChoice10 String この選択肢を使用して、アンケートを含むフィード項目を作成します。アンケートには 2 個から 10 個のアンケート選択肢を指定します。 必須 26.0 ~ 31.0
text String フィード項目のテキスト。 必須 23.0 ~ 31.0
visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。
  • InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
  • AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。
  • 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
  • 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
フィード項目の親がユーザー、グループ、またはダイレクトメッセージの場合、フィード項目の visibilityAllUsers である必要があります。
省略可能 26.0 ~ 31.0
投稿を共有するためのパラメーター
パラメーター名 説明 必須か省略可能 使用可能なバージョン
isBookmarked​ByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 26.0 ~ 31.0
originalFeedItemId String 共有するフィード項目の 18 文字の ID。

投稿の共有は、ファイルのアップロードよりも優先されます。1 つの POST 内では、投稿の共有とファイルのアップロードの両方は行わないでください。

メモ

必須 24.0 ~ 31.0
text String 共有されるフィード項目に対するコメント。 省略可能 28.0 ~ 31.0
visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。
  • InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
  • AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。
  • 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
  • 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
フィード項目の親がユーザー、グループ、またはダイレクトメッセージの場合、フィード項目の visibilityAllUsers である必要があります。
省略可能 26.0 ~ 31.0
テキストのみを post 送信するためのパラメーター
パラメーター名 説明 必須か省略可能 使用可能なバージョン
isBookmarked​​ByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 26.0 ~ 31.0
text String フィード項目のテキスト。最大文字数は 1000 文字です。 必須 23.0 ~ 31.0
visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。
  • InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
  • AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。
  • 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
  • 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
フィード項目の親がユーザー、グループ、またはダイレクトメッセージの場合、フィード項目の visibilityAllUsers である必要があります。
省略可能 26.0 ~ 31.0
キャンバスアプリケーションを post 送信するためのパラメーター
パラメーター名 説明 必須か省略可能 使用可能なバージョン
attachmentType String 添付ファイルの種別。値 Canvas を含める必要があります。 必須 29.0 ~ 31.0
description String キャンバスアプリケーションの説明 省略可能 29.0 ~ 31.0
developerName String キャンバスアプリケーションの開発者名 (API 名) 必須 29.0 ~ 31.0
height String キャンバスアプリケーションの高さ (ピクセル単位)。デフォルトの高さは 200 ピクセルです。 省略可能 29.0 ~ 31.0
isBookmarked​​ByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 29.0 ~ 31.0
namespacePrefix String キャンバスアプリケーションが作成された Developer Edition 組織の名前空間プレフィックス。 省略可能 29.0 ~ 31.0
parameters String キャンバスアプリケーションに渡される JSON 形式のパラメーター。JSON は URL でエンコードされている必要があります。
1parameters={'isUpdated'='true';}"
省略可能 29.0 ~ 31.0
text String フィード項目のテキスト 省略可能 29.0 ~ 31.0
thumbnailUrl String キャンバスアプリケーションのサムネイル画像の URL。最大サイズは 120x120 ピクセルです。 省略可能 29.0 ~ 31.0
title String キャンバスアプリケーションへのリンクのタイトル 省略可能 29.0 ~ 31.0
visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。
  • InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
  • AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。
  • 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
  • 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
フィード項目の親がユーザー、グループ、またはダイレクトメッセージの場合、フィード項目の visibilityAllUsers である必要があります。
省略可能 29.0 ~ 31.0
POST のレスポンスボディ
Feed Item

Record Feed Items Flat

このリソースは、バージョン 26.0 で廃止されました。

フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。

リソース
1/chatter/feeds/record/userId/feed-items/flat

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

メモ

適用開始バージョン
25.0 ~ 26.0
Chatter が必要かどうか
はい
HTTP のメソッド
GET
GET の要求パラメーター
パラメーター名 説明
numFeedItems Integer 返されるフィード項目数を指定します。有効な値は 0 ~ 100 です。デフォルト値は 25 です。フィード項目にはコメントが含まれる場合があるため、25 個のフラットフィード項目を指定しても、実際に返される数がそれより多くなることがあります。たとえば、各フィード項目に 1 つのコメントがあり、recentCommentCount が 1 よりも大きい場合、50 個のフラットフィード項目が返されます。
page String 生成されたトークン。フィード内のフィード項目のビューを示します。ページトークンは、レスポンスボディの一部として、nextPageURL など、いずれかの URL パラメーターで返されます。
recentComment​Count Integer 返される最近のコメントの数を指定します。有効な値は 0 ~ 25 です。デフォルト値は 3 です。
sort String。次のいずれかになります。
  • CreatedDateDesc
  • LastModifiedDateDesc
返されたフィードを、作成日の昇順、または最終更新日の昇順で並べ替えます。デフォルトは LastModifiedDateDesc です。
GET のレスポンスボディ
Flat Feed