Action Link Group Definition Input

アクションリンク定義の情報はサードパーティの機密情報 (OAuth ベアラトークンヘッダーなど) である可能性があります。そのため、アクションリンク定義を作成した接続アプリケー��ョン経由で実行された要求のみが定義を参照、変更、または削除できます。さらに、要求を実行するユーザは、定義を作成したユーザか、「すべてのデータの参照」権限を持つユーザである必要があります。

ルート XML タグ

<actionLinkGroup>

JSON の例

次の例では、テンプレートを使用せずにアクションリンクグループ定義をインスタンス化しています。

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

次の例では、テンプレートからアクションリンクグループ定義をインスタンス化しています。

1{
2   "templateId":"07gD00000004C9r",
3   "templateBindings":[
4      {
5         "key":"Bindings.version",
6         "value":"v33.0"
7      }
8   ]
9}

プロパティ

名前	型	説明	必須か省略可能	使用可能なバージョン
actionLinks	Action Link Definition Input[]	グループ内の各アクションリンク。 アクションリンクグループ内では、アクションリンクは、Action Link Group Definition Input リクエストボディの actionLinks プロパティにリストされる順序で表示されます。フィード項目内では、アクションリンクグループは、Associated Actions Capability Input リクエストボディの actionLinkGroupIds プロパティに指定された順序で表示されます。	テンプレートを使用せずにアクションリンクグループをインスタンス化する場合は必須。 テンプレートからインスタンス化する場合は、値を指定しないでください。	33.0
category	String	関連付けられたフィード項目内でのアクションリンクの優先度および相対位置を示します。値は次のとおりです。 Primary — アクションリンクグループは、フィード要素の本文に表示されます。 Overflow — アクションリンクグループは、フィード要素のオーバーフローメニューに表示されます。 Primary グループには最大 3 個、Overflow グループには最大 4 個のアクションリンクを作成できます。	テンプレートを使用せずにアクションリンクグループをインスタンス化する場合は必須。 テンプレートからインスタンス化する場合は、値を指定しないでください。	33.0
executionsAllowed	String	アクションリンクを実行できる回数を定義します。値は次のとおりです。 Once — アクションリンクは、すべてのユーザで 1 回のみ実行できます。 OncePerUser — アクションリンクは、各ユーザで 1 回のみ実行できます。 Unlimited — アクションリンクは、各ユーザで無制限に実行できます。アクションリンクの actionType が Api または ApiAsync の場合、この値を使用できません。	テンプレートを使用せずにアクションリンクグループをインスタンス化する場合は必須。 テンプレートからインスタンス化する場合は、値を指定しないでください。	33.0
expirationDate	Date	このアクションリンクグループが関連付けられたフィード項目から削除され、実行できなくなる日時を表す ISO 8601 日付文字列 (例: 2011-02-25T18:24:31.000Z)。expirationDate は、作成日から 1 年以内の日時である必要があります。 アクションリンクグループ定義に OAuth トークンが含まれる場合、アクションリンクグループの有効期限を OAuth トークンの有効期限と同じ値に設定することをお勧めします。そうすれば、ユーザがアクションリンクを実行できず、OAuth エラーは発生しません。 テンプレートからインスタンス化するときに日付を設定する場合は、「アクションリンクグループの有効期限の設定」を参照してください。	テンプレートを使用せずにアクションリンクグループをインスタンス化する場合は必須。 テンプレートからインスタンス化する場合は省略可能。	33.0
templateBindings	Action Link Template Binding Input[]	アクションリンクテンプレートからバインド変数値またはカスタムユーザ別名に入力されるキー - 値のペアのコレクション。バインド変数を使用するアクションリンクテンプレートからこのアクションリンクグループをインスタンス化するには、すべての変数の値を指定する必要があります。「バインド変数の定義」を参照してください。	テンプレートを使用せずにインスタンス化する場合は、値を指定しないでください。 バインド変数を使用するテンプレートからこのアクションリンクグループをインスタンス化する場合は必須。	33.0
templateId	String	このアクションリンクグループのインスタンス化に使用されたアクションリンクグループテンプレートの ID。	テンプレートを使用せずにインスタンス化する場合は、値を指定しないでください。 テンプレートからこのアクションリンクグループをインスタンス化する場合は必須。	33.0