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

Announcements のリソース

指定した親のお知らせを取得したり、お知らせを作成したりします。また、お知らせに関する情報を取得したり、お知らせを更新または削除したりします。

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

次の画像は、グループのお知らせを示しています。お知らせを作成すると、お知らせのテキストを含むフィード項目も作成されます。

お知らせは、削除されるか、別のお知らせで置き換えられない限り、その表示期限の 11:59 p.m. まで Salesforce UI の指定の場所に表示されます。

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

リソース	説明
`/chatter/announcements`	指定した親のお知らせを取得したり、お知らせを作成したりします。
`/chatter/announcements/announcementId`	お知らせに関する情報を取得したり、お知らせを更新または削除したりします。

Announcements

指定した親のお知らせを取得したり、お知らせを作成したりします。

リソース

1/chatter/announcements

1/connect/communities/communityId/chatter/announcements

使用可能なバージョン

36.0

Chatter が必要かどうか

はい

HTTP のメソッド

GET、POST、HEAD

GET の要求パラメータ

パラメータ名	型	説明	必須か省略可能	使用可能なバージョン
`page`	Integer	返すページの数。0 から開始します。`null` または 0 を渡すと、最初のページが返されます。	省略可能	36.0
`pageSize`	Integer	1 ページあたりのお知らせの数を指定します。	省略可能	36.0
`parentId`	String	お知らせの親エンティティの ID。お知らせがグループに表示されるときのグループ ID です。	必須	36.0

GET のレスポンスボディ

Announcement Page

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`	String	ISO 8601 形式の日時。別のお知らせが最初に投稿されていない限り、この日付の午後 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 のレスポンスボディ

Announcement

Connect REST API 開発者ガイド

Announcements のリソース

Announcements