Record Feed Items
- リソース
-
1/chatter/feeds/record/recordId/feed-items - 使用可能なバージョン
- 23.0 ~ 31.0
- 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 recentCommentCount Integer フィード項目ごとに含めるコメントの最大数。デフォルト値は 3 です。最大値は、25 です。 省略可能 29.0 ~ 31.0 showInternalOnly Boolean 内部 (Experience Cloud サイト以外の) ユーザーからのフィード項目のみを表示するか (true)、否か (false) を指定します。デフォルト値は false です。 省略可能 30.0 ~ 31.0 sort String フィード内のフィード項目の順序。 - CreatedDateAsc - 作成日の古い順に並べ替えられる。この並べ替え順は、DirectMessageModeration、Draft、Isolated、Moderation、PendingReview フィードでのみ使用できます。
- CreatedDateDesc — 作成日の新しい順に並べ替えます。
- LastModifiedDateDesc — 活動の新しい順に並べ替えられます。
- MostViewed — 最も参照回数の多いコンテンツで並べ替えます。この並べ替え順は、ConnectApi.FeedFilter が UnansweredQuestions の場合に Home フィードでのみ使用できます。
- Relevance — 最も関連性の高いコンテンツで並べ替えます。この並べ替え順は、Company、Home、および Topics フィードでのみ使用できます。
省略可能 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 つの値のみを指定できます。値は次のとおりです。 - Attachment Input: Canvas App (v29.0 ~ 31.0)
- Attachment Input: Existing Content (v23.0 ~ 31.0)
- Attachment Input: Feed Poll (v26.0 ~ 31.0)
- Attachment Input: Link (v23.0 ~ 31.0)
- Attachment Input: New File Upload (v23.0 ~ 31.0)
省略可能 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 isBookmarkedByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 24.0 ~ 31.0 feedElementType String この入力が表すフィード要素の種別。 有効な値は FeedItem のみです。
フィード項目を作成する場合は必須 (POST) フィード項目を更新する場合は省略可能 (PATCH)
31.0 originalFeedElementId String フィード要素を共有するには、18 文字の ID を指定します。 省略可能 31.0 ~ 38.0 originalFeedItemId String フィード項目を共有するには、18 文字の ID を指定します。 省略可能 24.0 ~ 31.0 subjectId String このフィード要素が投稿された親の ID。この値は、ユーザー、グループ、レコードの ID、またはコンテキストユーザーを示す文字列 me になります。 バージョン 45.0 以降では、このプロパティを新しい公開グループの ID に設定して、フィード要素を公開グループ間で移動できます。フィード要素を移動するときに他のプロパティを含めたり変更したりすることはできません。
必須 31.0 visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。 - InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
- AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。- 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
- 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
省略可能 26.0
- POST の要求パラメーター
- 次のいずれかのパラメーターセットを使用します。たとえば、リンクの post 送信とファイルの添付を同じ要求で行うことはできません。
-
既存のファイルを添付するためのパラメーター
-
新規のファイルを添付するためのパラメーター
パラメーター名 型 説明 必須か省略可能 使用可能なバージョン attachmentType String 添付ファイルの種別。値 NewFile を含める必要があります。 必須 27.0 ~ 31.0 desc String post 送信するファイルの説明。 省略可能 23.0 ~ 26.0 description String post 送信するファイルの説明。 省略可能 27.0 ~ 31.0 fileName String post 送信するファイルのファイル名。 必須 23.0 ~ 24.0 isBookmarkedByCurrentUser 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 を使用して外部ユーザーに投稿の表示を許可します。
省略可能 26.0 ~ 31.0 -
リンクを post 送信するためのパラメーター
パラメーター名 型 説明 必須か省略可能 使用可能なバージョン attachmentType String 添付ファイルの種別。値 Link を含める必要があります。 必須 27.0 ~ 31.0 isBookmarkedByCurrentUser 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 を使用して外部ユーザーに投稿の表示を許可します。
省略可能 26.0 ~ 31.0 -
アンケートを post 送信するためのパラメーター
パラメーター名 型 説明 必須か省略可能 使用可能なバージョン attachmentType String 添付ファイルの種別。値 Poll を含める必要があります。 必須 27.0 ~ 31.0 isBookmarkedByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 26.0 ~ 31.0 pollChoice1 ~ pollChoice10 String この選択肢を使用して、アンケートを含むフィード項目を作成します。アンケートには 2 個から 10 個のアンケート選択肢を指定します。 必須 26.0 ~ 31.0 text String フィード項目のテキスト。 必須 23.0 ~ 31.0 visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。 - InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
- AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。- 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
- 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
省略可能 26.0 ~ 31.0 -
投稿を共有するためのパラメーター
パラメーター名 型 説明 必須か省略可能 使用可能なバージョン isBookmarkedByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 26.0 ~ 31.0 originalFeedItemId String 共有するフィード項目の 18 文字の ID。 必須 24.0 ~ 31.0 text String 共有されるフィード項目に対するコメント。 省略可能 28.0 ~ 31.0 visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。 - InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
- AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。- 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
- 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
省略可能 26.0 ~ 31.0 -
テキストのみを post 送信するためのパラメーター
パラメーター名 型 説明 必須か省略可能 使用可能なバージョン isBookmarkedByCurrentUser Boolean 新しいフィード項目をユーザーのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。 省略可能 26.0 ~ 31.0 text String フィード項目のテキスト。最大文字数は 1000 文字です。 必須 23.0 ~ 31.0 visibility String 投稿を表示できるユーザー。有効な値は、次のとおりです。 - InternalUsers — デジタルエクスペリエンスが有効な場合は、デフォルトの内部サイトのメンバーに対してのみフィード項目を表示します。
- AllUsers — デジタルエクスペリエンスが有効な場合は、サイトのすべてのメンバーに対してフィード項目を表示します。
デフォルト値は、次のとおりです。- 外部ユーザーの場合、デフォルト値は AllUsers です。外部ユーザーが投稿を表示するには、この値を使用する必要があります。
- 内部ユーザーの場合、デフォルト値は InternalUsers です。内部ユーザーは、この値を受け入れるか、値 AllUsers を使用して外部ユーザーに投稿の表示を許可します。
省略可能 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 isBookmarkedByCurrentUser 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 を使用して外部ユーザーに投稿の表示を許可します。
省略可能 29.0 ~ 31.0 - POST のレスポンスボディ
- Feed Item
Record Feed Items Flat
このリソースは、バージョン 26.0 で廃止されました。
フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。
- リソース
-
1/chatter/feeds/record/userId/feed-items/flat - 適用開始バージョン
- 25.0 ~ 26.0
- Chatter が必要かどうか
- はい
- HTTP のメソッド
- GET
- GET の要求パラメーター
-
パラメーター名 型 説明 numFeedItems Integer 返されるフィード項目数を指定します。有効な値は 0 ~ 100 です。デフォルト値は 25 です。フィード項目にはコメントが含まれる場合があるため、25 個のフラットフィード項目を指定しても、実際に返される数がそれより多くなることがあります。たとえば、各フィード項目に 1 つのコメントがあり、recentCommentCount が 1 よりも大きい場合、50 個のフラットフィード項目が返されます。 page String 生成されたトークン。フィード内のフィード項目のビューを示します。ページトークンは、レスポンスボディの一部として、nextPageURL など、いずれかの URL パラメーターで返されます。 recentCommentCount Integer 返される最近のコメントの数を指定します。有効な値は 0 ~ 25 です。デフォルト値は 3 です。 sort String。次のいずれかになります。 - CreatedDateDesc
- LastModifiedDateDesc
返されたフィードを、作成日の昇順、または最終更新日の昇順で並べ替えます。デフォルトは LastModifiedDateDesc です。 - GET のレスポンスボディ
- Flat Feed