Connect REST API Developer Guide (Connect REST API 開発者ガイド)
jアクションのリンク
アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを特定の Web ページに移動したり、ファイルダウンロードを開始したり、Salesforce または外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用して Salesforce およびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促��できます。
ワークフロー
次のフィード項目には、[承認] および [却下] という 2 つのアクションリンクを含む 1 つのアクションリンクグループがあります。![フィード項目の [承認] および [却下] アクションリンク](https://developer.salesforce.com/docs/resources/img/ja-jp/226.0?doc_id=images%2Factionlinks_approve.png&folder=chatterapi)
フィード要素を使用してアクションリンクを作成および投稿するワークフローは、次のとおりです。
- (省略可能) アクションリンクテンプレートを作成します。
- /connect/action-link-group-definitions に対して要求を実行して、アクションリンクグループを定義するか、テンプレートからアクションリンクグループをインスタンス化します。アクションリンクグループには、少なくとも 1 つのアクションリンクが含まれます。
- /chatter/feed-elements に対して要求を実行して、フィード要素を投稿し、アクションリンクを関連付けます。
Action Links リソース
アクションリンクを操作するには、次のリソースを使用します。
| リソース | HTTP メソッド | タスク |
|---|---|---|
| /connect/action-link-group-definitions | POST | アクションリンクグループ定義を作成します。アクションリンクをフィード要素に関連付けるには、まずアクションリンクグループ定義を作成します。次に、関連付けられたアクション機能を含むフィード要素を投稿します。 |
| /chatter/feed-elements | POST | 関連付けられたアクション機能を含むフィード要素を投稿します。1 つのフィード要素に、最大 10 個のアクションリンクグループを関連付けます。 |
| /connect/action-links/actionLinkId | GET、PATCH | アクションリンクの status の情報取得や更新を行います。アクションリンクの status と Action Link Definition Input の labelKey プロパティの組み合わせにより、UI に表示されるテキストが決まります。Api および ApiAsync アクションリンクの API 要求をトリガするには、status を PendingStatus に設定します。 |
| /connect/action-link-group-definitions/actionLinkGroupId | GET、DELETE | アクションリンクグループ定義の情報取得や削除を行います。アクションリンクグループ定義を削除すると、その定義へのすべての参照がフィード要素から削除されます。アクションリンクグループ定義の取得や削除を行うには、クライアントは定義を作成した接続アプリケーションと同じである必要があり、ユーザは定義を作成したか「すべてのデータの参照」権限を持っている必要があります。 |
| /connect/action-link-groups/actionLinkGroupId | GET | コンテキストユーザの状態を含む、アクションリンクグループに関する情報を取得します。 |
| /connect/action-links/actionLinkId/diagnostic-info | GET | アクションリンクが実行されたときに返された診断情報を取得します。診断情報は、アクションリンクにアクセスできるユーザに対してのみ提供されます。 |
| /chatter/feed-elements/feedElementId/capabilities/associated-actions | GET | フィード要素に関連付けられたすべてのプラットフォームアクションを取得します。アクションリンクは、プラットフォームアクションの種別の 1 つです。 |
|
Feed のリソース /chatter/feeds/feedType/userId/feed-elements /chatter/feeds/feedType/feed-elements |
GET | 指定されたフィード種別のフィード要素を取得します。フィード要素にアクションリンクが関連付けられている場合、関連付けられたアクション機能でアクションリンクデータが返されます。 |