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

Group Announcements

指定されたグループに投稿されたお知らせに関する情報。グループへのお知らせの情報取得や投稿を行います。

お知らせは、情報を強調表示するために使用します。ユーザは、お知らせに対するディスカッション、いいね!、コメントの投稿ができます。フィード投稿を削除するとお知らせが削除されます。

お知らせに関する情報の取得、お知らせの更新、またはお知らせの削除を行うには、Announcements Resources を使用します。

リソース

1/chatter/groups/groupID/announcements

1/connect/communities/communityId/chatter/groups/groupID/announcements

適用開始バージョン

31.0

Chatter が必要かどうか

はい

HTTP メソッド

GET、POST、HEAD

GET の要求パラメータ

パラメータ名	型	説明	適用開始バージョン
`page`	Integer	項目のページを指定する整数。デフォルト値は 0 で、最初のページを返します。	31.0
`pageSize`	Integer	ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。	31.0

POST のリクエストボディ

ルート XML タグ

<announcement>

お知らせを作成する JSON の例

1{   "body":
2      {
3         "messageSegments": [
4         {
5            "text": "Please install the updates for all iOS devices.",
6            "type": "Text"
7          }
8          ]
9      },
10   "parentId": "0F9B0000000004S",
11   "expirationDate": "2016-02-22T00:00:00.000Z"
12}

既存のフィード項目を使用してお知らせを作成する JSON の例

1{
2   "feedItemId": "0D5D0000000DaZBKA0",
3   "expirationDate": "2016-02-22T00:00:00.000Z"
4}

プロパティ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
`body`	Message Body Input	お知らせのテキスト。	`feedItemId` が指定されていないときにお知らせを作成する場合は必須お知らせの更新では指定しないでください	31.0
`expirationDate`	Date	別のお知らせが最初に投稿されていない限り、この日付の午後 11 時 59 分まで Salesforce UI にお知らせが表示されます。Salesforce UI では、`expirationDate` の時間値は無視されます。ただし、時間値を使用して各自の UI で独自の表示ロジックを作成することはできます。	お知らせを作成する場合は必須お知らせを更新する場合は省略可能	31.0
`feedItemId`	String	お知らせの本文である `AdvancedTextPost` フィード項目の ID。	`body` が指定されていないときにお知らせを作成する場合は必須お知らせの更新では指定しないでください	36.0
`isArchived`	Boolean	お知らせがアーカイブされているかどうかを指定します。	省略可能	36.0
`parentId`	String	お知らせの親エンティティの ID。お知らせがグループに表示されるときのグループ ID です。	`feedItemId` が指定されていないときにお知らせを作成する場合は必須お知らせの更新では指定しないでください	36.0
`sendEmails`	Boolean	グループのメール設定に関係なく、お知らせがメールとしてすべてのグループメンバーに送信されるかどうかを指定します。組織で Chatter メールが有効になっていない場合、お知らせメールは送信されません。デフォルト値は `false` です。	お知らせを作成する場合は省略可能お知らせの更新では指定しないでください	36.0

POST の要求パラメータ

パラメータ名	型	説明	適用開始バージョン
`expirationDate`	Date	別のお知らせが最初に投稿されていない限り、この日付の午後 11 時 59 分まで Salesforce UI にお知らせが表示されます。Salesforce UI では、`expirationDate` の時間値は無視されます。ただし、時間値を使用して各自の UI で独自の表示ロジックを作成することはできます。	31.0

GET のレスポンスボディ

Announcement Page

POST のレスポンスボディ

Announcement

Chatter REST API 開発者ガイド

Group Announcements