アクションリンクを定義し、フィード要素を使用して投稿する
ステップ 1: アクションリンクグループを定義する
ラジオボタンと同様に、アクションリンクはグループ内にネストする必要があります。グループ内のアクションリンクは、グループのプロパティを共有し、相互に排他的です (クリックできるのは、グループ内の 1 つのアクションリンクのみです)。1 つのアクションリンクを定義する場合でも、アクションリンクグループに含める必要があります。
アクションリンクはフィード項目のボタンと考えます。ボタンのように、アクションリンクには表示ラベル (labelKey) があります。アクションリンク定義には、URL (actionUrl) や HTTP メソッド (method) のほか、省略可能なリクエストボディ (requestBody) や HTTP ヘッダー (headers) など、他にもプロパティがあります。
ユーザがこのアクションリンクをクリックすると、Chatter REST API に対して HTTP POST 要求が実行され、フィード項目が Chatter に投稿されます。requestBody プロパティは、新しいフィード項目のテキストなど、actionUrl リソースのリクエストボディを保持します。この例では、新しいフィード項目にテキストしか含まれていませんが、添付ファイルやアンケートなどの他の機能やアクションリンクも含めることができます。
- リソース
- /connect/action-link-group-definitions
- HTTP メソッド
- POST
- リクエストボディ
-
Action Link Group Definition Input
このリクエストボディには、Action Link Definition Input リクエストボディのコレクションを保持する actionLinks プロパティがあります。この例では 1 つのアクションリンクがあります。
- リクエストボディの例
-
- cURL を使用した要求の例
-
cURL を使用して要求を実行するには、次のように入力し、Developer Edition インスタンス名および OAuth 情報を置き換えます。
- レスポンスボディ
- Action Link Group Definition
ステップ 2: アクションリンクグループをフィード項目に関連付けて投稿する
- リソース
- /chatter/feed-elements
- HTTP メソッド
- POST
- リクエストボディ
-
Feed Item Input
この Feed Item Input リクエストボディには body プロパティがあり、これは Message Body Input リクエストボディです。この例では、Message Body Input リクエストボディには messageSegments プロパティがあり、これに 1 つの Message Segment Input: Text リクエストボディがあります。
この Feed Item Input リクエストボディには capabilities プロパティもあり、これは Feed Element Capabilities Input リクエストボディです。この例では、Feed Element Capabilities Input リクエストボディには associatedActions プロパティがあり、これは Associated Actions Capability Input リクエストボディです。
- リクエストボディの例
-
ステップ 1 の Action Link Group Definition レスポンスの id からアクションリンクグループ ID を取得します。
- cURL を使用した要求の例
-
cURL を使用して要求を実行するには、次のように入力し、ステップ 1 で返された アクションリンクグループ ID、Developer Edition インスタンス名、および OAuth 情報を置き換えます。
- レスポンスボディ
- Feed Item