Trello/Action - api_programming @ ウィキ

Action - Trello Developers

Actions

Actions are generated whenever an action occurs in Trello.
例えば、カードを削除した場合、カードが削除されたという情報が

• カードがあったListに
• カードがあったBoardに
• カードを削除したUserに

アクションのオブジェクトIDとともに残る

Actions for Trello objects can be listed from nested action endpoints - e.g. the resource GET /1/boards/[board_id]/actions lists all of the actions for the given board.
Additionally, data regarding individual action objects can be retrieved and updated using the resources listed below.

You Can't List Actions
If you are looking to get the actions for a resource, you'll want to use that resource's {resourceId}/actions/ endpoint.

アクションの種類については、この下のページを参照のこと。

You can see some board actions in the activity feed in the board sidebar like below:

You can see some card actions in the activity feed like below:

Action Object

id	string	The ID of the action
data	object	Relevant information regarding the action
date	date	When the action occurred
idMemberCreator	string	The ID of the member who caused the action
type	string	The type of the action. See list of Action Types for options.

Actions Nested Resource

Action は Trello API に於いて、入れ子リソースとして含まれている。
この幾重にも入れ子になっているという特性は、アクションは他のリソースのcontext内に作られている、という事実によるものだ。
例えば、ある User が他の User をボードに加えたら、Trello は addMemberToBoard アクションを、そのボードに加える。

Therefore, it makes sense to be able to access all of the actions within the context of an object from which they were created.

Nested Actions with Query Params

Parameter	Valid Values	Default	Description
actions_entities boolean	true, false	false	Boolean to return actions' entities or not.
actions_display boolean	true, false	false	Boolean to return actions' display or not.
actions_format string	One of: count, list, or minimal	list	The format that actions should be returned in.
actions_since string	ISO Datetime or Mongo ID	none	The maximum date for when the actions were created. For more information on using since to page responses, visit the intro to Paging page.
actions_limit integer	数値（0～1000）	50	返すアクションの数
action_fields string	Comma-separated list of Action Object Fields.	all	A comma-separated list of Action Object Fields to be included in the returned action objects.
action_member boolean	true, false	true	Determines whether to return the member object for the action.
action_member_fields string	String	avatarHash,fullName,initials,username	The fields to be returned if the member object is being returned.
action_memberCreator boolean	Bool	true	Determines whether to return the memberCreator object for the action.
action_memberCreator_fields string	string	avatarHash,fullName,initials,username	The fields to be returned if the memberCreator object is being returned.

https://api.trello.com/1/boards/BdarzfKF/?fields=id&actions=addAttachmentToCard&&bold(){actions_limit=2}&action_fields=idMemberCreator&action_memberCreator_fields=fullName

{
  "id": "54a17d76d4a5072e3931736b",
  "actions": [
    {
      "id": "54a1b7c3a6ea7c2b1eaa5cdf",
      "idMemberCreator": "53baf533e697a982248cd73f",
      "memberCreator": {
        "id": "53baf533e697a982248cd73f",
        "fullName": "Lauren Moon"
      }
    },
    {
      "id": "54a1b73f030916211e718516",
      "idMemberCreator": "53baf533e697a982248cd73f",
      "memberCreator": {
        "id": "53baf533e697a982248cd73f",
        "fullName": "Lauren Moon"
      }
    }
  ]
}
 

Nested Actions via URL Params

/object/{id}/actions

entities	boolean	Default: false
display	boolean	Default: false
filter	string	Default: commentCard, updateCard:idList

fields string	Default: all, all or a comma-separated list of:data/date/idMemberCreator/type
limit integer	Default: 50 0 - 1000
format string	Default: list. One of: count, list, minimal
since date	ISO-Formatted Date (2017-12-07T15:07:08.977Z) or MongoID (5a6029d00000000000000000)
before date	ISO-Formatted Date (2017-12-07T15:07:08.977Z) or MongoID (5a6029d00000000000000000)
page integer	Default: 0
idModels string	Comma-separated list of model IDs
member boolean	Default: true

member_fields
string

Default: avatarHash,fullName,initials,username
all or a comma-separated list of:

avatarHash
bio
bioData
confirmed
fullName
idPremOrgsAdmin
initials
memberType
products
status
url
username
memberCreator
boolean

Default: true

memberCreator_fields
string

Default: avatarHash,fullName,initials,username
all or a comma-separated list of:

avatarHash
bio
bioData
confirmed
fullName
idPremOrgsAdmin
initials
memberType
products
status
url
username
SUGGEST EDITS

Action Types

Actions have many types.

Due to the number of actions that occur in Trello, nested action resources filter out specific action types.
For example, changing the name of a checklistItem will trigger a webhook on the board and will POST an action of type updateCheckItem with the old and new name of the checklistItem.
However, no nested actions resource will return action types of updateCheckItem: /cards/{id}/actions/, /boards/{id}/actions/. However you can get that specific action instance via GET /actions/{id}/.

All Action Types

Action Name
acceptEnterpriseJoinRequest
addAdminToBoard
addAdminToOrganization
addAttachmentToCard
addBoardsPinnedToMember
addChecklistToCard
addLabelToCard
addMemberToBoard
addMemberToCard
addMemberToOrganization
addOrganizationToEnterprise
addToEnterprisePluginWhitelist
addToOrganizationBoard
commentCard
convertToCardFromCheckItem
copyBoard
copyCard
copyChecklist
createLabel
copyCommentCard
createBoard
createBoardInvitation
createBoardPreference
createCard
createChecklist
createList
createOrganization
createOrganizationInvitation
deleteAttachmentFromCard
deleteBoardInvitation
deleteCard
deleteCheckItem
deleteLabel
deleteOrganizationInvitation
disableEnterprisePluginWhitelist
disablePlugin
disablePowerUp
emailCard
enableEnterprisePluginWhitelist
enablePlugin
enablePowerUp
makeAdminOfBoard
makeAdminOfOrganization
makeNormalMemberOfBoard
makeNormalMemberOfOrganization
makeObserverOfBoard
memberJoinedTrello
moveCardFromBoard
moveCardToBoard
moveListFromBoard
moveListToBoard
removeAdminFromBoard
removeAdminFromOrganization
removeBoardsPinnedFromMember
removeChecklistFromCard
removeFromEnterprisePluginWhitelist
removeFromOrganizationBoard
removeLabelFromCard
removeMemberFromBoard
removeMemberFromCard
removeMemberFromOrganization
removeOrganizationFromEnterprise
unconfirmedBoardInvitation
unconfirmedOrganizationInvitation
updateBoard
updateCard
updateCheckItem
updateCheckItemStateOnCard
updateChecklist
updateLabel
updateList
updateMember
updateOrganization
voteOnCard

Excluded Action Types

These actions will be sent to Webhooks but are not included in nested action resource responses (e.g. GET board/[board_id]/actions).

Action Name
addAdminToBoard (Deprecated in favor of makeAdminOfBoard)
addAdminToOrganization (Deprecated in favor of makeAdminOfOrganization)
addBoardsPinnedToMember
addLabelToCard
copyChecklist
createBoardInvitation
createBoardPreference
createCheckItem
createChecklist
createLabel
createOrganizationInvitation
deleteAttachmentFromCard (Excluded from /lists/{listId}/actions)
deleteCheckItem
deleteComment
deleteLabel
makeAdminOfOrganization
removeAdminFromBoard (Deprecated in favor of makeNormalMemberOfBoard)
removeAdminFromOrganization (Deprecated in favor of makeNormalMemberOfOrganization)
removeBoardsPinnedFromMember
removeLabelFromCard
removeMemberFromBoard
removeMemberFromOrganization
updateCheckItem
updateComment
updateLabel
voteOnCard