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

Feed Elements, Batch Post

最大 500 件のフィード要素を一括投稿します。

リソース

1/chatter/feed-elements/batch

1/connect/communities/communityId/chatter/feed-elements/batch

使用可能なバージョン

32.0

Chatter が必要かどうか

はい

HTTP メソッド

POST、HEAD

POST のリクエストボディ

Batch Collection Input

このバッチコレクションのリッチ入力は Feed Item Input です。

POST のレスポンスボディ

Batch Results

Batch Results レスポンスボディには、それぞれのリクエストボディに対応する Feed Item レスポンスボディが含まれます。Feed Item レスポンスボディは、リクエストボディと同じ順序で返されます。

この要求は、要求全体に影響を与えるエラー (解析エラーなど) が発生しない限り、HTTP 200 状況コードを返します。個々のリクエストボディでエラーが発生した場合、Batch Results Item の statusCode プロパティには、該当する HTTP 状況コードが含まれます。

フィード要素の一括投稿

この例では、/chatter/feed-elements/batch リソースを使用してフィード要素を一括投稿します。次の例では cURL を使用します。

1curl -H "X-PrettyPrint: 1" -F 'json={"inputs":[{"richInput":{"subjectId":"me","body":{"messageSegments":[{"type":"Text","text":"Post Number 1"}]},"feedElementType":"FeedItem"}},{"richInput":{"subjectId":"me","body":{"messageSegments":[{"type":"Text","text":"Post Number 2"}]},"feedElementType":"FeedItem"}}]};type=application/json' -X POST https://instance_name/services/data/v47.0/chatter/feed-elements/batch -H 'Authorization: OAuth 00DD00000007HoR!...' --insecure

次に、同じ例のリクエストボディのみを示します。

1{
2  "inputs": [
3    {
4      "richInput": {
5        "subjectId": "me",
6        "body": {
7          "messageSegments": [
8            {
9              "type": "Text",
10              "text": "Post Number 1"
11            }
12          ]
13        },
14        "feedElementType": "FeedItem"
15      }
16    },
17    {
18      "richInput": {
19        "subjectId": "me",
20        "body": {
21          "messageSegments": [
22            {
23              "type": "Text",
24              "text": "Post Number 2"
25            }
26          ]
27        },
28        "feedElementType": "FeedItem"
29      }
30    }
31  ]
32}

バイナリファイルを含むフィード要素の一括投稿 (バージョン 35.0 以前)

バージョン 36.0 以降では、フィード投稿の作成とバイナリファイルのアップロードを同じ要求で行うことはできません。最初にファイルを Salesforce にアップロードしてから、ファイル ID を使用して 1 つ以上のファイルをフィード投稿に添付します。

重要

次の例では、/chatter/feed-elements/batch リソースを使用してフィード要素を一括投稿し、2 つのバイナリファイルをアップロードして、バッチ内のフィード要素に添付します。リクエストボディにバイナリパートに関する情報を含めます。次の例では cURL を使用します。

1curl -H "X-PrettyPrint: 1" -F 'json={"inputs":[{"binaryPartNames":["bin1"], "richInput":{"subjectId":"me","body":{
2"messageSegments":[{"type":"Text","text":"Please accept this receipt"}]},"capabilities": {"content" : {"description": "Receipt for expenses", "title":"receipt.pdf"}},"feedElementType":"FeedItem"}},
3{"binaryPartNames":["bin2"],"richInput":{"subjectId":"me","body":{"messageSegments":[{"type":"Text","text":"Post Number 2"}]},
4"capabilities": {"content" : {"description": "Receipt for expenses", "title":"receipt2.pdf"}},"feedElementType":"FeedItem"}}]};type=application/json' 
5-F "bin1=@/Users/jsmith/Desktop/receipt.pdf;type=application/octet-stream" -F "bin2=@/Users/jsmith/Desktop/receipt2.pdf;type=application/octet-stream" 
6-X POST https://instance_name/services/data/v35.0/chatter/feed-elements/batch 
7-H 'Authorization: OAuth 00DD00000007HoR44QATPNzhzYEJBfU' --insecure

以下に、上記の例を、リクエストボディパートが確認できる形式に変えた例を示します。

1POST /services/data/v35.0/chatter/feed-elements/batch HTTP/1.1
2Authorization: OAuth 00DRR0000000N0g!...
3User-Agent: Jakarta Commons-HttpClient/3.0.1
4Host: instance_name
5Content-Length: 845
6Content-Type: multipart/form-data; boundary=a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq
7Accept: application/json
8
9--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq
10Content-Disposition: form-data; name="json"
11Content-Type: application/json; charset=UTF-8
12
13{
14  "inputs": [
15    {
16      "binaryPartNames": [
17        "bin1"
18      ],
19      "richInput": {
20        "subjectId": "me",
21        "body": {
22          "messageSegments": [
23            {
24              "type": "Text",
25              "text": "Please accept this receipt"
26            }
27          ]
28        },
29        "capabilities": {
30          "content": {
31            "description": "Receipt for expenses",
32            "title": "receipt.pdf"
33          }
34        },
35        "feedElementType": "FeedItem"
36      }
37    },
38    {
39      "binaryPartNames": [
40        "bin2"
41      ],
42      "richInput": {
43        "subjectId": "me",
44        "body": {
45          "messageSegments": [
46            {
47              "type": "Text",
48              "text": "Post Number 2"
49            }
50          ]
51        },
52        "capabilities": {
53          "content": {
54            "description": "Receipt for expenses",
55            "title": "receipt2.pdf"
56          }
57        },
58        "feedElementType": "FeedItem"
59      }
60    }
61  ]
62}
63
64--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq
65Content-Disposition: form-data; name="bin1"; filename="receipt.pdf"
66Content-Type: application/octet-stream; charset=ISO-8859-1
67
68...contents of receipt.pdf...
69
70
71--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq
72Content-Disposition: form-data; name="bin2"; filename="receipt2.pdf"
73Content-Type: application/octet-stream; charset=ISO-8859-1
74
75...contents of receipt2.pdf...
76
77--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq--

binaryPartNames プロパティ内のバイナリパート名は、バイナリリクエストパートの name プロパティ内のバイナリパート名と一致する必要があります。

メモ

Chatter REST API 開発者ガイド

Feed Elements, Batch Post

関連項目: