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

Action Link Group Definitions

アクションリンクグループ定義を作成します。

アクションリンクは現在、パイロットプログラムを通じて一部のお客様が使用できます。このパイロットプログラムに参加する方法については、salesforce.com にお問い合わせください。パイロットプログラムへの参加には、追加の契約条件が適用される場合があります。パイロットプログラムは変更される可能性があるため、このパイロットプログラムへの参加や、特定の期間にこの機能を有効化することは保証できません。このドキュメント、プレスリリース、または公式声明で参照されている未リリースのサービスまたは機能は、現在利用できず、提供が遅れたり中止されたりする可能性があります。サービスのご購入をご検討中のお客様は、現在利用可能な機能に基づいて購入をご決定ください。

メモ

アクションリンクは、API、Web ページ、またはファイルを指し示すフィード要素上のインジケータで、Salesforce Chatter フィード UI ではボタンで表されます。アクションリンクには、HTTP メソッドが含まれ、認証用ベアラートークンなどのヘッダー情報を含めることができます。アクションリンクを使用して Salesforce およびサードパーティシステムをフィードに統合します。

この画像は、2 つのアクションリンクを含む 1 つのアクションリンクグループがあるフィード要素を示しています。フィード項目のアクションリンク

すべてのアクションリンクはグループに属している必要があります。1 つのグループ内のアクションリンクは、相互排他的で、同じプロパティを共有します。各自のアクショングループでスタンドアロンアクションを定義します。アクションリンクグループ定義の情報は、サードパーティの機密情報である可能性があるため (OAuth ベアラートークンヘッダーなど)、アクションリンクグループ定義を作成した接続アプリケーション経由で実行された要求でのみ定義に関する情報を参照または変更できます。

リソース

1/connect/action-link-group-definitions

適用開始バージョン

31.0

Chatter が必要かどうか

いいえ

HTTP メソッド

POST

Action Link Group Definitions リソースは、POST のクエリパラメータをサポートしていません。次の Action Link Group Definition Input リクエストボディを使用する必要があります。

POST のリクエストボディ

ルート XML タグ

<actionLinkGroup>

JSON の例

1{
2  "actionLinks": [
3  {
4    "actionType": "Api",
5    "labelKey": "Like",
6    "groupDefault": "true",
7    "actionUrl": "https://test.com/this",
8    "method": "POST",
9    "requiresConfirmation": "false"
10  },
11  {
12    "actionType": "Api",
13    "labelKey": "Unlike",
14    "groupDefault": "false",
15    "actionUrl": "https://test.com/that",
16    "method": "POST",
17    "requiresConfirmation": "false"
18  }
19  ],
20  "executionsAllowed": "OncePerUser",
21  "expirationDate": "2014-07-07T23:59:11.168Z",
22  "category": "Primary"
23}

プロパティ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
`actionLinks`	Action Link Definition Input[]	グループ内の各アクションリンク。アクションリンクグループ内では、アクションリンクは、Action Link Group Definition Input リクエストボディの `actionLinks` プロパティにリストされる順序で表示されます。フィード項目内では、アクションリンクグループは、Associated Actions Capability Input リクエストボディの `actionLinkGroupIds` プロパティに指定された順序で表示されます。	必須項目	31.0
`category`	String	関連付けられたフィード項目内でのアクションリンクの優先度および相対位置を示します。値は次のとおりです。 `Primary` — アクションリンクは、フィード項目の補助本文に表示されます。 `Overflow` — アクションリンクは、フィード項目の右上隅にあるドロップダウンメニューに表示されます。 `Primary` グループには最大 3 個、`Overflow` グループには最大 4 個のアクションリンクを作成できます。	必須項目	31.0
`executionsAllowed`	String	アクションリンクを実行できる回数を定義します。値は次のとおりです。 `Once` — アクションリンクは、すべてのユーザで 1 回のみ実行できます。 `OncePerUser` — アクションリンクは、各ユーザで 1 回のみ実行できます。 `Unlimited` — アクションリンクは、各ユーザで無制限に実行できます。アクションリンクの `actionType` が `Api` または `ApiAsync` の場合、この値を使用できません。	必須項目	31.0
`expirationDate`	Date	このアクションリンクグループが関連付けられたフィード項目から削除され、実行できなくなる日時を表す ISO 8601 日付文字列 (例: 2011-02-25T18:24:31.000Z)。`expirationDate` は、作成日から 1 年以内の日時である必要があります。ユーザがクリックして OAuth エラーが発生するのを回避するには、OAuth トークンの有効期限に合わせて `expirationDate` を設定することをお勧めします。	必須項目	31.0

POST のレスポンスボディ

Action Link Group Definition

POST の例

アクションリンクグループをフィード項目に関連付けるには、まずアクションリンクグループ定義を作成します。

Salesforce への actionUrl は、相対リンクにすることができます。他のすべてのリンクは、https:// で始まる絶対リンクにする必要があります。

メモ

1POST /connect/action-link-group-definitions
2
3{
4    "actionLinks": [
5    {
6       "actionType" : "Api",
7       "actionUrl" : "https://www.example.com/api/v1/cofirm",
8       "groupDefault" : "true",
9       "headers" : [
10       {
11          "name" : "Authorization",
12          "value" : "OAuth 00DRR0000000N0g!ARoAQMZyQtsP1Gs27EZ8hl7vdpYXH5O5rv1
13                        VNprqTeD12xYnvygD3JgPnNR._nmE6thZakAbBVJUsjUInMUaKMlkNKaWXdHO"
14       },
15       {
16          "name" : "Content-Type",
17          "value" : "application/json"
18       },
19       {
20          "name" : "Accept",
21          "value" : "application/json"
22       },
23       {
24          "name" : "X-PrettyPrint",
25          "value" : "1"
26       } 
27       ],
28       "labelKey" : "Confirm",
29       "method" : "Post",
30       "requiresConfirmation" : "true"
31    },
32    {
33       "actionType" : "Api",
34       "actionUrl" : "https://www.example.com/api/v1/deny",
35       "groupDefault"  : "false",
36       "headers" : [
37       {
38          "name" : "Authorization",
39          "value" : "OAuth 00DRR0000000N0g!ARoAQMZyQtsP1Gs27EZ8hl7vdpYXH5O5rv1
40                        VNprqTeD12xYnvygD3JgPnNR._nmE6thZakAbBVJUsjUInMUaKMlkNKaWXdHO"
41       },
42       {
43          "name" : "Content-Type",
44          "value" : "application/json"
45       },
46       {
47          "name" : "Accept",
48          "value" : "application/json"
49       },
50       {
51          "name" : "X-PrettyPrint",
52          "value" : "1"
53       } 
54       ],
55       "labelKey": "Deny",
56       "method" : "Post",
57       "requiresConfirmation"  : "true"
58    },
59    {
60       "actionType": "Ui",
61       "actionUrl" : "https://www.example.com/reviewPage.html",
62       "groupDefault" : "false",
63       "labelKey" : "Review",
64       "method" : "Get",
65       "requiresConfirmation" : "false"
66    },
67    "executionsAllowed" : "OncePerUser",
68    "category" : "Primary",
69    "expirationDate" :  "2014-05-09T18:45:39.000Z"
70}

次に、アクションリンクグループをフィード項目に関連付けて、フィード項目を post 送信します。/connect/action-link-group-definitions 応答からアクションリンクグループ ID を取得し、POST 要求で /chatter/feed-elements に渡します。

1POST  /chatter/feed-elements
2
3{
4  "body": {
5    "messageSegments": [
6      {
7        "type": "Text",
8        "text": "Please confirm or deny this item. You can also click Review to provide more feedback."
9       }
10    ]
11    },
12  "subjectId": "me",
13  "feedElementType": "FeedItem",
14  "capabilities": {
15    "associatedActions": {
16      "actionLinkGroupIds": ["0AgRR0000004CTr0AM"]
17    }
18  }
19}

さまざまな種別のアクションリンクのさまざまなワークフローで status が設定されます。詳細は、/connect/action-links/actionLinkIdを参照してください。

この例では、他の機能は含まれていませんが、アクションリンクのあるフィード項目では、コンテンツ、アンケート、リンクなど、他の機能がサポートされます。

メモ

Chatter REST API 開発者ガイド

No Results

Action Link Group Definitions