Feed订阅

BeTalk用户的时间流和会话以反馈形式呈现,呈现结果是活动流格式,遵循JSON规范。

1. 映射

动作映射 – 活动流和BeTalk之间

描述 活动流 BeTalk
表示这个角色已经创建的对象 创建 FEED_BOARD_CREATE,FEED_PAGES_CREATE,FEED_TODO_CREATE,FEED_TODO_CREATE_WITH_RESOURCE
表明已修改的对象 更新 FEED_BOARD_NAME_CHANGE,FEED_PAGES_UPDATE,FEED_RELATIONSHIP_CHANGE_ROLE,FEED_TODO_UPDATE
表明已发布的对象目标 发布 FEED_BOARD_COMMENT,FEED_PAGES_COMMENT,FEED_TODO_COMMENT,FEED_TODO_DUE_DATE
表明已上传的文件 上传 FEED_PAGES_CREATE,FEED_TODO_ATTACHMENT
表示已经添加了对象到目标 添加 FEED_PAGES_CREATE_WITH_ANNOTATION,FEED_RELATIONSHIP_ADD,FEED_TODO_ATTACHMENT
表示这个角色增加了注释页面 标签 FEED_PAGES_ANNOTATION
表示这个角色已经访问的对象 访问 FEED_PAGES_VIEW
表示这个角色已经删除的对象 删除 FEED_PAGES_DELETE
表示已经成为对象的成员 加入 FEED_RELATIONSHIP_JOIN
表示已经离开了对象 离开 FEED_RELATIONSHIP_LEAVE
表示已经从目标移除的对象 去掉 FEED_RELATIONSHIP_REMOVE
表示这个角色已经邀请对象 邀请 FEED_RELATIONSHIP_INVITE
表示这个角色已经忽略了对象 忽略 FEED_RELATIONSHIP_DECLINE
表示角色已经取消了对象 取消 FEED_RELATIONSHIP_CANCEL
表示这个角色已指派人或团队的待办事项 分配 FEED_TODO_ASSIGN
表明角色已完成待办事项 完成 FEED_TODO_COMPLETE
表明角色已重新开放待办事项 重开 FEED_TODO_REOPEN
表明待办事项截止 截止 FEED_TODO_DUE_DATE_ARRIVE

对象映射 -活动流和BeTalk之间

描述 活动流 BeTalk
表示对另一个对象的文本响应 评论 comment
表示一个区域、网页,并且通常由特定实体管理 Page
表示各种类型的对象的泛型集合 讨论组 binder
表示每个人 user
对象类型代表其成员对象可以加入或离开对象的组 group
代表任何形式的文档或文件 文件 resource
表示一个注释事件 注释 annotation
代表任何类型的对象的一般集合。目前,支持个人和群体类型 数据集 Object array
表示一个待办事项任务 待办事项 todo
表示一个到期日期事件 待办事项截至日期 duedate in todo
代表任何类型的事件 事件 event

2. 对象详细信息

“person”对象类型表示一个用户帐户。

属性 描述
objectType String
displayName String 用户全名
image Media link 用户连接头像图片
id String 用户唯一标识
published String 可选:创建的时间 “date-time”
updated String 可选:上传时间 “date-time”
url 不能使用
email String 用户email 地址
unique_id String 用户的unique_id如果用户在unique_id代替电子邮件创建

“group”对象类型代表其成员对象可以加入或离开对象的组。

属性 描述
objectType objectType
displayName String 组名
id String 组对象的唯一标识
published String 可选:组对象创建时间 “date-time”
updated String 可选:上传时间”date-time”
url 不能使用

集合

“Collection”对象类型表示任何类型的对象的泛型集合。

属性 描述
objectType String 集合
totalItems Integer 非负整数,指定的流中的活动的总数
items Array of Objects 包含的任何对象类型的对象列表的数组
url 不能使用

评论

在“comment”对象类型表示另一个对象的文本回复。

属性 描述
objectType String 评论
id String 评论唯一标识
published String 可选:评论创建时间”date-time”
updated String 可选:上传时间”date-time”
content String 表示为HTML片段的主体内容。文字内容是<p>和音频内容是<audio>
content_text String Body 内容标签
displayName 不能使用
inReplyTo 不能使用
author 使用活动流省略

讨论组

所述“binder”对象类型表示其它类型的对象的一般集合。

属性 描述
objectType String 讨论组
id String 讨论组唯一识别标识
published String 可选:讨论组创建时间”date-time”
updated String 可选:上传时间”date-time”
displayName String 讨论组名
image Media link 讨论组缩略图连接
url String 讨论组连接

文件

“File”对象类型代表的一些文件或其他文件,没有额外的机器可读的语义。

属性 描述
objectType String 文件
id String 文件唯一标识
published String 可选: 文件创建时间”date-time”
updated String 可选:文件上传时间”date-time”
displayName String 文件名
mimeType String 该文件描述对象的MIME类型
url 不能使用
author 使用活动流省略

“page”对象类型表示区域或是网页内容,并且通常由特定实体来管理。

属性 描述
objectType String
id String 页唯一标识
published String 可选:页创建时间”date-time”
updated String 可选:上传时间 “date-time”
type String 页类型
url String 页资源文件连接
displayName 不能使用
author 使用活动流省略

注释

在“annotation”对象代表一个更新事件的注释。

属性 描述
objectType String 注解
published String 可选:创建时间 “date-time”
updated String 可选:上传时间”date-time”

待办事项

“todo”对象表示一个更新事件的待办事项。

属性 描述
objectType String 待办事项
id String 待办事项唯一标识
displayName String 待办事项名
summary String 待办事项描述
published String 可选:创建时间 “date-time”
updated String 可选:上传时间 “date-time”
url 不能使用
image 不能使用

截止日期

“duedate”对象表示一个更新事件的截至日期。

属性 描述
objectType String 截至日期
id String 截至日期唯一标识
content String 截至日期 “date-time”
published String 可选:创建时间 “date-time”
updated String 可选:上传时间 “date-time”
url 不能使用

事件

“event”对象类型表示任何类型的事件。

属性 描述
objectType String 事件
displayName String 事件名
published String 可选:创建时间 “date-time”
updated String 可选:上传时间”date-time”
url 不能使用

3. 联系人

下面是一些示例:

发表讨论组评论:

{
    "object": {
        "id": "34",
        "content": "<p>Next</p>",
        "objectType": "comment",
        "updated": "2013-08-16T01:41:48Z",
        "published": "2013-08-16T01:41:48Z"
    },
    "target": {
        "id": "BRTaH8slmbPAY4odz0RbBIF",
        "displayName": "My Default Binder",
        "url": "https://www.betalk.com/BRTaH8slmbPAY4odz0RbBIF",
        "image": "https://www.betalk.com/board/BRTaH8slmbPAY4odz0RbBIF/25",
        "objectType": "binder",
        "updated": "2013-09-16T22:50:33Z",
        "published": "1970-01-01T00:00:00Z"
    },
    "actor": {
        "image": null,
        "id": "Utkj3YC5BxRHCCaq9widP67",
        "displayName": "Jona Smith",
        "objectType": "person",
        "updated": "2013-09-09T22:00:23Z",
        "published": "2013-05-22T21:21:36Z"
    },
    "generator": {
        "id": "BRTaH8slmbPAY4odz0RbBIF"
    },
    "published": "2013-08-16T01:41:48Z",
    "verb": "post"
}

 发表评论页:

{
    "object": {
        "id": "69",
        "content": "<p>Welsh</p>",
        "objectType": "comment",
        "updated": "2013-09-16T21:12:43Z",
        "published": "2013-09-16T21:12:43Z"
    },
    "target": {
        "id": "40",
        "type": "PAGE_TYPE_IMAGE",
        "url": "https://www.betalk.com/BRTaH8slmbPAY4odz0RbBIF/40",
        "objectType": "page",
        "updated": "1970-01-01T00:00:00Z",
        "published": "1970-01-01T00:00:00Z"
    },
    "actor": {
        "image": "",
        "id": "Utkj3YC5BxRHCCaq9widP67",
        "displayName": "Jona Smith",
        "objectType": "person",
        "updated": "2013-09-09T22:00:23Z",
        "published": "2013-05-22T21:21:36Z"
    },
    "generator": {
        "id": "BRTaH8slmbPAY4odz0RbBIF"
    },
    "published": "2013-09-16T21:12:43Z",
    "verb": "post"
}

创建页:

{
    "object": {
        "id": "40",
        "type": "PAGE_TYPE_IMAGE",
        "url": "https://www.betalk.com/BRTaH8slmbPAY4odz0RbBIF/40",
        "objectType": "page",
        "updated": "1970-01-01T00:00:00Z",
        "published": "1970-01-01T00:00:00Z"
    },
    "target": {
        "id": "BRTaH8slmbPAY4odz0RbBIF",
        "displayName": "My Default Binder",
        "url": "https://www.betalk.com/BRTaH8slmbPAY4odz0RbBIF",
        "image": "https://www.betalk.com/board/BRTaH8slmbPAY4odz0RbBIF/25",
        "objectType": "binder",
        "updated": "2013-09-16T22:50:33Z",
        "published": "1970-01-01T00:00:00Z"
    },
    "actor": {
        "image": "",
        "id": "Utkj3YC5BxRHCCaq9widP67",
        "displayName": "Jona Smith",
        "objectType": "person",
        "updated": "2013-09-09T22:00:23Z",
        "published": "2013-05-22T21:21:36Z"
    },
    "generator": {
        "id": "BRTaH8slmbPAY4odz0RbBIF"
    },
    "published": "2013-08-29T22:05:16Z",
    "verb": "create"
}

 上传文件:

{
    "object": {
        "id": "346",
        "displayName": "Betalk Integration Overview.pptx",
        "mimeType": "application/vnd.ms-powerpoint",
        "objectType": "file",
        "updated": "2013-09-16T22:46:50Z",
        "published": "2013-09-16T22:46:14Z"
    },
    "target": {
        "id": "BRTaH8slmbPAY4odz0RbBIF",
        "displayName": "My Default Binder",
        "url": "https://www.betalk.com/BRTaH8slmbPAY4odz0RbBIF",
        "image": "https://www.betalk.com/board/BRTaH8slmbPAY4odz0RbBIF/25",
        "objectType": "binder",
        "updated": "2013-09-16T22:50:33Z",
        "published": "1970-01-01T00:00:00Z"
    },
    "actor": {
        "image": "",
        "id": "Utkj3YC5BxRHCCaq9widP67",
        "displayName": "Jona Smith",
        "objectType": "person",
        "updated": "2013-09-09T22:00:23Z",
        "published": "2013-05-22T21:21:36Z"
    },
    "generator": {
        "id": "BRTaH8slmbPAY4odz0RbBIF"
    },
    "published": "2013-09-16T22:46:14Z",
    "verb": "upload"
}

注释事件:

{
    "object": {
        "objectType": "annotation",
        "updated": "2013-09-16T21:17:39Z",
        "published": "2013-09-16T21:17:39Z"
    },
    "target": {
        "id": "90",
        "type": "PAGE_TYPE_WHITEBOARD",
        "url": "https://www.betalk.com/BRTaH8slmbPAY4odz0RbBIF/90",
        "objectType": "page",
        "updated": "1970-01-01T00:00:00Z",
        "published": "1970-01-01T00:00:00Z"
    },
    "actor": {
        "image": "",
        "id": "Utkj3YC5BxRHCCaq9widP67",
        "displayName": "Jona Smitch",
        "objectType": "person",
        "updated": "2013-09-09T22:00:23Z",
        "published": "2013-05-22T21:21:36Z"
    },
    "generator": {
        "id": "BRTaH8slmbPAY4odz0RbBIF"
    },
    "published": "2013-09-16T21:17:39Z",
    "verb": "tag"
}