SharePoint 的好友动态订阅源 REST API 引用
查找 SharePoint REST 端点,以使用 SocialRestFeedManager 资源读取和写入到好友动态订阅源。 您可以使用 SharePoint 代表性状态传输 (REST) 服务来执行与 .NET 客户端对象模型和 JavaScript 对象模型相同的操作。 REST 服务会公开 SharePoint 对象、属性和方法对应的资源。 要使用 REST 服务,需构建 HTTP GET 和 POST 请求,并将其发送至表示您想要执行的任务的资源终结点。
大多数源任务的终结点 URI 以 SocialRestFeedManager 资源 ( social.feed
) 开头,后跟 my
资源或 post
资源:
- 资源
my
表示当前用户。 在终结点 URI 中内嵌使用时,它会将请求的上下文设置为当前用户。 例如,http://contoso.com/_api/social.feed/my/news
将获取当前用户的新闻源。 - 资源
post
表示特定的线程或帖子。 在终结点 URI 中内嵌使用时,它会将请求的上下文设置为指定主题或文章。 例如,http://contoso.com/_api/social.feed/post/lock
会锁定指定主题。
如果资源终结点接受某个参数,参数元数据将在 URI 或请求正文中指定。 默认情况下,REST 服务将返回 Atom 协议格式的响应,但您可以使用 HTTP Accept 标头请求 JSON 格式。 请参阅订阅源任务的示例 REST 请求查看完整请求的示例。
订阅源任务的资源终结点
终结点 | 说明 |
---|---|
My | 获取有关当前用户的信息。 |
My/Feed/Post | 在当前用户的订阅源中创建根文章。 |
My/Feed | 获取当前用户的活动订阅源。 |
My/News | 获取当前用户和好友的活动订阅源及用户关注的内容 |
My/TimelineFeed | 获取当前用户和好友的活动订阅源及用户关注的内容,按创建日期排序。 |
My/Likes | 获取当前用户喜欢的文章的订阅源。 |
My/MentionFeed | 获取当前用户提及的文章的订阅源。 |
My/MentionFeed/ClearUnreadMentionCount | 获取当前用户提到的文章的订阅源并清除未读的提及订阅源数量。 |
My/UnreadMentionCount | 获取当前用户未读的提及订阅源数量。 |
Actor | 获取有关指定用户和当前用户的信息。 |
Actor/Feed | 获取指定用户的活动订阅源。 |
Actor/Feed/Post | 在指定网站源中创建根文章。 |
文章 | 获取包含指定文章的完整主题。 |
Post/Reply | 发布对指定文章的回复。 |
Post/Delete | 删除指定文章。 |
Post/Like | 使当前用户成为指定文章的关注者。 |
Post/Unlike | 将当前用户从指定文章的关注者列表中移除。 |
Post/Likers | 获取喜欢指定文章的用户。 |
Post/Lock | 锁定指定主题。 |
Post/Unlock | 解锁指定主题。 |
注意
以下与源相关的 REST 资源使用与其他 SharePoint REST API 相同的模式来构造终结点 URI。>对于 CreateImageAttachment,向 For GetPreview 发送 POST 请求http://<siteCollection>/<site>/_api/SP.Social.SocialFeedManager/CreateImageAttachment
>,向 http://<siteCollection>/<site>/_api/SP.Social.SocialFeedManager/GetPreview
>SuppressThreadNotifications 发送 POST 请求,将 POST 请求发送到http://<siteCollection>/<site>/_api/SP.Social.SocialFeedManager/SuppressThreadNotifications
我的
获取有关当前用户的信息。
my 终结点将当前用户设置为 URI 中任何后续资源的上下文。 例如, http://contoso.com/_api/social.feed/my/news
可获取当前用户的新闻源。
终结点 URI 结构
GEThttp://<siteCollection>/<site>/_api/social.feed/my
请求参数
无。
响应
关于当前用户的信息。
您可以在 URI 中分别别调用 SocialRestActor 属性,例如, http://<siteCollection>/<site>/_api/social.feed/my/me
仅获取 Me 属性。
以下响应示例表示关于当前用户的信息。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/my",
"uri":"http://serverName/sites/dev/_api/social.feed/my",
"type":"SP.Social.SocialRestActor"
},
"FollowableItem":"domain\\username1",
"FollowableItemActor":null,
"Me":{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName/my/personal/username1/",
"Status":0,
"StatusText":"This is post 2",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}
}}
My/Feed/Post
在当前用户的订阅源中创建根文章。
您只能在当前用户的上下文中发布内容。 您无法在不同用户的订阅源中创建根文章,但您可以回复其他用户的文章。 请参阅 Post/Reply。
注意
不要将此 Post
资源与 Post
表示特定线程或帖子的资源混淆。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/my/feed/post
请求参数
_restCreationData_
类型: SP。Social.SocialRestPostCreationData
新文章的一个 null ID 和属性,如下例所示。
"restCreationData":{
"__metadata":{
"type":"SP.Social.SocialRestPostCreationData"
},
"ID":null,
"creationData":{
"__metadata":{
"type":"SP.Social.SocialPostCreationData"
},
"ContentText":"This post was published using REST.",
"UpdateStatusText":false
}
}
响应
类型: SP。Social.SocialRestThread
包含新的根文章的主题。
以下响应示例展示了包含新的根文章的主题。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"uri":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"type":"SP.Social.SocialRestThread"
},
"ID":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"SocialThread":{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T19:31:57.204511Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T19:31:57.204511Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Posted with REST."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":0
}
}}
My/Feed
获取当前用户的活动订阅源( Personal 源类型)。
终结点 URI 结构
GEThttp://<siteCollection>/<site>/_api/social.feed/my/feed
GEThttp://<siteCollection>/<site>/_api/social.feed/my/feed(MaxThreadCount=10,SortOrder=1,NewerThan=@v)?@v=datetime'2013-01-01T08:00'
请求参数
_feedOptions_
(可选)
类型: SP。Social.SocialFeedOptions
主题的最大数量、日期-时间范围和排序顺序。 您可以选择性地指定这些属性的任意组合,例如,您可以仅指定 MaxThreadCount 属性。
可使用 @ 别名传递特殊字符。 例如, <siteUri>/_api/social.feed/my/feed(OlderThan=@v)?@v=datetime'2013-01-01T08:00'
使用 @v 别名发送一个 : 字符。
响应
当前用户的个人订阅源。
以下响应示例表示当前用户的个人订阅源。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/my/feed",
"uri":"http://serverName/sites/dev/_api/social.feed/my/feed",
"type":"SP.Social.SocialRestFeed"
},
"SocialFeed":{
"__metadata":{"type":"SP.Social.SocialFeed"},
"Attributes":1,
"NewestProcessed":"2013-04-15T06:10:11Z",
"OldestProcessed":"2013-04-15T05:33:12Z",
"Threads":{
"results":[{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
},{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":"http://serverName:80/my/User Photos/Profile Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,
"Name":"User2 Name",
"PersonalSiteUri":"http://serverName/my/personal/username2",
"Status":6,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{
"results":[{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":1,
"CreatedTime":"2013-04-15T06:10:11.3480926Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.59c0273c6c7b41e784b496c9aaa909a8.17.24.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-15T06:10:11.3480926Z",
"Overlays":{"results":[]},
"PostType":1,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"This is a reply to post 1."
}]
},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-15T05:58:24Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-15T06:10:11Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"This is post 1."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":1
},{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.82e71ca2381b4657935546e57f1992d5.23.23.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.82e71ca2381b4657935546e57f1992d5.23.23.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-15T06:07:05Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.82e71ca2381b4657935546e57f1992d5.23.23.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0},
"ModifiedTime":"2013-04-15T06:07:05Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,"Uri":null},
"Text":"This is post 2."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":0
},{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
},{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":"http://serverName:80/my/User Photos/Profile Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,
"Name":"User2 Name",
"PersonalSiteUri":"http://serverName/my/personal/username2",
"Status":6,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"
}]
},
"Attributes":0,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.cecc0de3d7d04520bb87a181b24c105a.16.16.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"PostReference":{
"__metadata":{"type":"SP.Social.SocialPostReference"},
"Digest":null,
"Post":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":1,
"CreatedTime":"2013-04-15T05:05:13Z",
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":true,
"Indexes":{"results":[]},
"TotalCount":1
},
"ModifiedTime":"2013-04-15T05:05:13Z",
"Overlays":{
"results":[{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[0]},
"Index":1,
"Length":18,
"LinkUri":null,
"OverlayType":1
}]
},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"@User1 Name presented at the conference."},
"ThreadId":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"ThreadOwnerIndex":1
},
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":14,
"AuthorIndex":0,
"CreatedTime":"2013-04-15T05:33:12Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.cecc0de3d7d04520bb87a181b24c105a.16.16.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":null,
"ModifiedTime":"2013-04-15T05:33:12Z",
"Overlays":{
"results":[{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[0]},
"Index":0,
"Length":18,
"LinkUri":null,
"OverlayType":1
},{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[1]},
"Index":35,
"Length":10,
"LinkUri":null,
"OverlayType":1
}]
},
"PostType":0,
"PreferredImageUri":"http://serverName:80/_layouts/15/Images/Like.11x11x32.png",
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,"Uri":null
},
"Text":"User1 Name liked a post by User2 Name."
},
"Status":0,
"ThreadType":1,
"TotalReplyCount":0
}]
},
"UnreadMentionCount":1
}
}}
My/News
获取当前用户和好友的活动订阅源及用户关注的内容,按最后修改日期排序( News 订阅源类型)。
终结点 URI 结构
GEThttp://<siteCollection>/<site>/_api/social.feed/my/news
GEThttp://<siteCollection>/<site>/_api/social.feed/my/news(MaxThreadCount=10,NewerThan=@v)?@v=datetime'2013-01-01T08:00'
请求参数
_feedOptions_
(可选)
类型: SP。Social.SocialFeedOptions
主题的最大数量、日期-时间范围和排序顺序。 您可以选择性地指定这些属性的任意组合,例如,您可以仅指定 MaxThreadCount 属性。
可使用 @ 别名传递特殊字符。 例如, <siteUri>/_api/social.feed/my/News(OlderThan=@v)?@v=datetime'2013-01-01T08:00'
使用 @v 别名发送一个 : 字符。
响应
当前用户的新闻源。
以下响应示例表示当前用户的新闻源。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/my/news",
"uri":"http://serverName/sites/dev/_api/social.feed/my/news",
"type":"SP.Social.SocialRestFeed"
},
"SocialFeed":{
"__metadata":{"type":"SP.Social.SocialFeed"},
"Attributes":1,
"NewestProcessed":"2013-04-15T06:10:11.4730902Z",
"OldestProcessed":"2013-04-12T20:51:51Z",
"Threads":{
"results":[{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":"http://serverName:80/my/_layouts/15/MySite.aspx?MySiteRedirect=FollowedDocuments",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
},{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":"http://serverName:80/my/User Photos/Profile Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,
"Name":"User2 Name",
"PersonalSiteUri":"http://serverName/my/personal/username2",
"Status":0,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{
"results":[{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":1,
"CreatedTime":"2013-04-15T06:10:11.3480926Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.59c0273c6c7b41e784b496c9aaa909a8.17.24.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-15T06:10:11.3480926Z",
"Overlays":{"results":[]},
"PostType":1,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"This is a reply to post 1."
}]
},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-15T05:58:24Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0},
"ModifiedTime":"2013-04-15T06:10:11.4730902Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"This is post 1."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":1
},{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":"http://serverName:80/my/_layouts/15/MySite.aspx?MySiteRedirect=FollowedDocuments",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.82e71ca2381b4657935546e57f1992d5.23.23.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.82e71ca2381b4657935546e57f1992d5.23.23.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-15T06:07:05.4804434Z","Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.82e71ca2381b4657935546e57f1992d5.23.23.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-15T06:07:05.4804434Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"This is post 2."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":0
}]
},
"UnreadMentionCount":1
}
}}
My/TimelineFeed
获取当前用户和好友的活动订阅源及用户关注的内容,按创建日期排序( Timeline 订阅源类型)。
终结点 URI 结构
GEThttp://<siteCollection>/<site>/_api/social.feed/my/timelinefeed
GEThttp://<siteCollection>/<site>/_api/social.feed/my/timelinefeed(MaxThreadCount=10,NewerThan=@v)?@v=datetime'2013-01-01T08:00'
请求参数
_feedOptions_
(可选)
类型: SP。Social.SocialFeedOptions
主题的最大数量、日期-时间范围和排序顺序。 您可以选择性地指定这些属性的任意组合,例如,您可以仅指定 MaxThreadCount 属性。
可使用 @ 别名传递特殊字符。 例如, <siteUri>/_api/social.feed/my/timelinefeed(OlderThan=@v)?@v=datetime'2013-01-01T08:00'
使用 @v 别名发送一个 : 字符。
响应
当前用户的时间线订阅源。
以下响应示例表示当前用户的时间线订阅源,按创建日期排序。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/my/timelinefeed",
"uri":"http://serverName/sites/dev/_api/social.feed/my/timelinefeed",
"type":"SP.Social.SocialRestFeed"
},
"SocialFeed":{
"__metadata":{"type":"SP.Social.SocialFeed"},
"Attributes":1,
"NewestProcessed":"2013-04-15T06:07:05.4804434Z",
"OldestProcessed":"2013-04-12T20:51:51Z",
"Threads":{
"results":[{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":"http://serverName:80/my/_layouts/15/MySite.aspx?MySiteRedirect=FollowedDocuments",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"This is post 2.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.82e71ca2381b4657935546e57f1992d5.23.23.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.82e71ca2381b4657935546e57f1992d5.23.23.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-15T06:07:05.4804434Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.82e71ca2381b4657935546e57f1992d5.23.23.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-15T06:07:05.4804434Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"This is post 2."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":0
},{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":"http://serverName:80/my/_layouts/15/MySite.aspx?MySiteRedirect=FollowedDocuments",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"This is post 2.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-15T05:58:24Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-15T06:04:49Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"This is post 1."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":0
}]
},
"UnreadMentionCount":1
}
}}
My/Likes
获取当前用户赞的微博帖子的源(由 LikeReference 线程类型表示)。 请参阅 SharePoint 社交源中的引用线程和摘要线程。
终结点 URI 结构
GEThttp://<siteCollection>/<site>/_api/social.feed/my/likes
GEThttp://<siteCollection>/<site>/_api/social.feed/my/likes(MaxThreadCount=10,SortOrder=1,NewerThan=@v)?@v=datetime'2013-01-01T08:00'
请求参数
_feedOptions_
(可选)
类型: SP。Social.SocialFeedOptions
主题的最大数量、日期-时间范围和排序顺序。 您可以选择性地指定这些属性的任意组合,例如,您可以仅指定 MaxThreadCount 属性。
您可以选择在查询字符串中指定检索选项。 可使用 @ 别名传递特殊字符。 例如, <siteUri>/_api/social.feed/my/likes(OlderThan=@v)?@v=datetime'2013-01-01T08:00'
使用 @v 别名发送一个 : 字符。
响应
包含当前用户喜欢的文章的订阅源。
以下响应示例表示对当前用户喜欢的文章的引用。 主题为 LikeReference 主题类型(值 = 1),其 PostReference 属性会引用实际文章。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/my/likes",
"uri":"http://serverName/sites/dev/_api/social.feed/my/likes",
"type":"SP.Social.SocialRestFeed"
},
"SocialFeed":{
"__metadata":{"type":"SP.Social.SocialFeed"}.
"Attributes":1,
"NewestProcessed":"2013-04-15T05:33:12Z",
"OldestProcessed":"2013-04-15T05:33:12Z",
"Threads":{
"results":[{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"This is post 2",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
},{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":"http://serverName:80/my/User Photos/Profile Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,
"Name":"User2 Name",
"PersonalSiteUri":"http://serverName/my/personal/username2",
"Status":6,
"StatusText":"@User1 Name presented at the conference.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"}]
},
"Attributes":0,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.cecc0de3d7d04520bb87a181b24c105a.16.16.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"PostReference":{
"__metadata":{"type":"SP.Social.SocialPostReference"},
"Digest":null,
"Post":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":1,
"CreatedTime":"2013-04-15T05:05:13Z",
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":true,
"Indexes":{"results":[]},
"TotalCount":1
},
"ModifiedTime":"2013-04-15T05:05:13Z",
"Overlays":{
"results":[{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[0]},
"Index":1,
"Length":18,
"LinkUri":null,
"OverlayType":1
}]
},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"@User1 Name presented at the conference."
},
"ThreadId":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"ThreadOwnerIndex":1
},
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":14,
"AuthorIndex":0,
"CreatedTime":"2013-04-15T05:33:12Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.cecc0de3d7d04520bb87a181b24c105a.16.16.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":null,
"ModifiedTime":"2013-04-15T05:33:12Z",
"Overlays":{
"results":[{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[0]},
"Index":0,
"Length":18,
"LinkUri":null,
"OverlayType":1
},{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[1]},
"Index":35,
"Length":10,
"LinkUri":null,
"OverlayType":1
}]
},
"PostType":0,
"PreferredImageUri":"http://serverName:80/_layouts/15/Images/Like.11x11x32.png",
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"User1 Name liked a post by User2 Name."
},
"Status":0,
"ThreadType":1,
"TotalReplyCount":0
}]
},
"UnreadMentionCount":1
}
}}
My/MentionFeed
获取提及当前用户的微博帖子的源(由 MentionReference 线程类型表示)。 请参阅 SharePoint 社交源中的引用线程和摘要线程。
终结点 URI 结构
GEThttp://<siteCollection>/<site>/_api/social.feed/my/mentionfeed
GEThttp://<siteCollection>/<site>/_api/social.feed/my/mentionfeed(MaxThreadCount=10,SortOrder=1,NewerThan=@v)?@v=datetime'2013-01-01T08:00'
请求参数
_feedOptions_
(可选)
类型: SP。Social.SocialFeedOptions
主题的最大数量、日期-时间范围和排序顺序。 您可以选择性地指定这些属性的任意组合,例如,您可以仅指定 MaxThreadCount 属性。
可使用 @ 别名传递特殊字符。 例如, <siteUri>/_api/social.feed/my/likes(OlderThan=@v)?@v=datetime'2013-01-01T08:00'
使用 @v 别名发送一个 : 字符。
响应
包含提及当前用户的文章的订阅源。
以下响应示例表示提及当前用户的主题。 主题为 MentionReference 主题类型(值 = 3),其 PostReference 属性会引用实际文章。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/my/mentionfeed",
"uri":"http://serverName/sites/dev/_api/social.feed/my/mentionfeed",
"type":"SP.Social.SocialRestFeed"
},
"SocialFeed":{
"__metadata":{"type":"SP.Social.SocialFeed"},
"Attributes":1,
"NewestProcessed":"2013-04-15T05:05:19Z",
"OldestProcessed":"2013-04-15T05:05:19Z",
"Threads":{
"results":[{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"This is post 2",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
},{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":"http://serverName:80/my/User Photos/Profile Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,
"Name":"User2 Name",
"PersonalSiteUri":"http://serverName/my/personal/username2",
"Status":6,
"StatusText":"@User1 Name presented at the conference.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"
}]
},
"Attributes":0,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.ec5198399300401fb44f0f5c9d8dea80.15.15.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"PostReference":{
"__metadata":{"type":"SP.Social.SocialPostReference"},
"Digest":null,
"Post":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":1,
"CreatedTime":"2013-04-15T05:05:12.0102795Z",
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-15T05:05:12.0102795Z",
"Overlays":{
"results":[{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[0]},
"Index":1,
"Length":18,
"LinkUri":null,
"OverlayType":1
}]
},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"@User1 Name presented at the conference."
},
"ThreadId":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"ThreadOwnerIndex":1
},
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":14,
"AuthorIndex":1,
"CreatedTime":"2013-04-15T05:05:19Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.ec5198399300401fb44f0f5c9d8dea80.15.15.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":null,
"ModifiedTime":"2013-04-15T05:05:19Z",
"Overlays":{
"results":[{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[1]},
"Index":13,
"Length":10,
"LinkUri":null,
"OverlayType":1
}]
},
"PostType":0,
"PreferredImageUri":"http://serverName:80/_layouts/15/Images/mention.11x11x32.png",
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Mentioned by User2 Name."},
"Status":0,
"ThreadType":3,
"TotalReplyCount":0
}]
},
"UnreadMentionCount":1
}
}}
My/MentionFeed/ClearUnreadMentionCount
获取提及当前用户的微博帖子的源(由 MentionReference 线程类型表示),并将用户未读的提及内容源计数设置为 0。 请参阅 SharePoint 社交源中的引用线程和摘要线程。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/my/mentionfeed/clearunreadmentioncount
请求参数
_feedOptions_
类型: SP。Social.SocialFeedOptions
此参数必须作为请求正文的 data 属性中的空字符串发送,如以下示例中所示。
"feedOptions": {
"__metadata": {
"type": "SP.Social.SocialFeedOptions"
},
}
响应
当前用户提及的订阅源。
以下响应示例表示当前用户提及的订阅源。 主题为 MentionReference 主题类型(值 = 3),其 PostReference 属性会引用实际文章。 检索订阅源之后,未读的提及订阅源数量将清除。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/my/mentionfeed",
"uri":"http://serverName/sites/dev/_api/social.feed/my/mentionfeed",
"type":"SP.Social.SocialRestFeed"
},
"SocialFeed":{
"__metadata":{"type":"SP.Social.SocialFeed"},
"Attributes":1,
"NewestProcessed":"2013-04-15T05:05:19Z",
"OldestProcessed":"2013-04-15T05:05:19Z",
"Threads":{
"results":[{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"Posted with REST.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
},{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":"http://serverName:80/my/User Photos/Profile Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,
"Name":"User2 Name",
"PersonalSiteUri":"http://serverName/my/personal/username2",
"Status":6,
"StatusText":"This is post 1 from the specified user.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"
}]
},
"Attributes":0,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.ec5198399300401fb44f0f5c9d8dea80.15.15.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"PostReference":{
"__metadata":{"type":"SP.Social.SocialPostReference"},
"Digest":null,
"Post":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":1,
"CreatedTime":"2013-04-15T05:05:12.0102795Z",
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-15T05:05:12.0102795Z",
"Overlays":{
"results":[{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[0]},
"Index":1,
"Length":18,
"LinkUri":null,
"OverlayType":1
}]
},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"@User1 Name presented at the conference."},
"ThreadId":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.ca83f758aab04065bc303398f2701eb9.10.10.S-1-5-21-124525095-708259637-1543119021-628175",
"ThreadOwnerIndex":1
},
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":14,
"AuthorIndex":1,
"CreatedTime":"2013-04-15T05:05:19Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.ec5198399300401fb44f0f5c9d8dea80.15.15.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":null,
"ModifiedTime":"2013-04-15T05:05:19Z",
"Overlays":{
"results":[{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[1]},
"Index":13,
"Length":10,
"LinkUri":null,
"OverlayType":1
}]
},
"PostType":0,
"PreferredImageUri":"http://serverName:80/_layouts/15/Images/mention.11x11x32.png",
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Mentioned by User2 Name."
},
"Status":0,
"ThreadType":3,
"TotalReplyCount":0
}]
},
"UnreadMentionCount":1
}
}}
My/UnreadMentionCount
获取当前用户未读的提及订阅源数量。
终结点 URI 结构
GEThttp://<siteCollection>/<site>/_api/social.feed/my/unreadmentioncount
请求参数
无。
响应
类型: Int32
当前用户提及的未读订阅源数量。
以下响应示例表示未读的提及订阅源数量为 1。
{"d":{"UnreadMentionCount":1}}
Actor
获取有关指定用户和当前用户的信息。
注意
终结点 actor
将指定的用户或站点源设置为 URI 中任何后续资源的上下文。 例如,http://contoso.com/_api/social.feed/actor(item='domain\\user')/feed
获取指定用户的个人源,http://contoso.com/_api/social.feed/actor(item=@v)/feed?@v='http://<server>/<teamSite>/newsfeed.aspx'
获取指定团队网站的网站源。
终结点 URI 结构
GEThttp://<siteCollection>/<site>/_api/social.feed/actor(item='domain\\user')
GEThttp://<siteCollection>/<site>/_api/social.feed/actor(item=@v)?@v='i:0"%23".f|membership|user@domain.com'
请求参数
_item_
类型: String
指定用户的帐户名称。
在查询字符串中发送 项 参数。 可使用 @ 别名传递特殊字符。 例如, <siteUri>/_api/social.feed/actor(item=@v)?@v='i:0"%23".f|membership|user@domain.com'
使用 @v 别名和 “%23” 编码发送 # 字符。
响应
关于指定用户和当前用户的信息。
您可以在 URI 中分别调用 SocialRestActor 属性,例如, http://<siteCollection>/<site>/_api/social.feed/actor(item='domain\\user')/followableitem
仅获取指定用户的 FollowableItem 属性。
以下响应示例表示关于指定用户和当前用户的信息。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/actor(Item=@ai)/?@ai='domain\\username2'",
"uri":"http://serverName/sites/dev/_api/social.feed/actor(Item=@ai)/?@ai='domain%5cusername2'",
"type":"SP.Social.SocialRestActor"
},
"FollowableItem":"domain\\username2",
"FollowableItemActor":{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":"http://serverName:80/my/User Photos/Profile Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,
"Name":"User2 Name",
"PersonalSiteUri":"http://serverName/my/personal/username2",
"Status":0,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"
},
"Me":{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName/my/personal/username1/",
"Status":0,
"StatusText":"This is post 2",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}
}}
Actor/Feed
获取指定用户的活动订阅源( Personal 订阅源类型)或者获取指定网站源。
终结点 URI 结构
GEThttp://<siteCollection>/<site>/_api/social.feed/actor(item='domain\\user')/feed
GEThttp://<siteCollection>/<site>/_api/social.feed/actor(item=@v)/feed?@v='i:0"%23".f|membership|user@domain.com'
GEThttp://<siteCollection>/<site>/_api/social.feed/actor(item='domain\\user')/feed(MaxThreadCount=10,SortOrder=1,NewerThan=@v)?@v=datetime'2013-01-01T08:00'
GEThttp://<siteCollection>/<site>/_api/social.feed/actor(item=@v)/feed?@v='http://<teamSiteUri>/newsfeed.aspx'
请求参数
_feedOptions_
(可选)
类型: SP。Social.SocialFeedOptions
主题的最大数量、日期-时间范围和排序顺序。 您可以选择性地指定这些属性的任意组合,例如,您可以仅指定 MaxThreadCount 属性。
可使用 @ 别名传递特殊字符。 例如, <siteUri>/_api/social.feed/actor(item=@v)/feed(NewerThan=@x)?@v='i:0"%23".f|membership|user@domain.com'&@x=datetime'2013-01-01T08:00'
使用 @v 别名和 "%23" 编码发送 # 字符,使用 @x 别名发送 : 字符。
响应
指定用户的个人订阅源或指定 URI 的网站源。
以下响应示例表示指定用户的个人订阅源。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/actor(Item=@ai)/feed/?@ai='domain\\username2'",
"uri":"http://serverName/sites/dev/_api/social.feed/actor(Item=@ai)/feed/?@ai='domain%5cusername2'",
"type":"SP.Social.SocialRestFeed"
},
"SocialFeed":{
"__metadata":{"type":"SP.Social.SocialFeed"},
"Attributes":1,
"NewestProcessed":"2013-04-16T22:40:55Z",
"OldestProcessed":"2013-04-16T22:40:07Z",
"Threads":{
"results":[{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":"http://serverName:80/my/User%20Photos/Profile%20Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,
"Name":"User2 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username2",
"Status":0,
"StatusText":"This is post 1 from the specified user.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"
},{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName/my/personal/username1/",
"Status":0,
"StatusText":"",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":0,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.4cb7a5d36cb14d62b0fb68ef98f9765e.15.15.S-1-5-21-124525095-708259637-1543119021-628175",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":{
"__metadata":{"type":"SP.Social.SocialPostReference"},
"Digest":null,
"Post":null,
"ThreadId":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.c554cbf1934b4c82bb1d43ebf961de92.17.17.S-1-5-21-2127521184-1604012920-1887927527-66602",
"ThreadOwnerIndex":1
},
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":14,
"AuthorIndex":0,
"CreatedTime":"2013-04-16T22:40:55Z",
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.4cb7a5d36cb14d62b0fb68ef98f9765e.15.15.S-1-5-21-124525095-708259637-1543119021-628175",
"LikerInfo":null,
"ModifiedTime":"2013-04-16T22:40:55Z",
"Overlays":{
"results":[{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[0]},
"Index":0,
"Length":10,
"LinkUri":null,
"OverlayType":1
},{
"__metadata":{"type":"SP.Social.SocialDataOverlay"},
"ActorIndexes":{"results":[1]},
"Index":32,
"Length":18,
"LinkUri":null,
"OverlayType":1
}]
},
"PostType":0,
"PreferredImageUri":"http://serverName:80/_layouts/15/Images/RepliedTo.11x11x32.png",
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"User2 Name replied to a post by User1 Name."
},
"Status":0,
"ThreadType":2,
"TotalReplyCount":0
},{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":"http://serverName:80/my/User%20Photos/Profile%20Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,
"Name":"User2 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username2",
"Status":0,
"StatusText":"This is post 1 from the specified user.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"
}]
},
"Attributes":6,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.b83675d28e264e69823205ad4e76df9f.14.14.S-1-5-21-124525095-708259637-1543119021-628175",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.b83675d28e264e69823205ad4e76df9f.14.14.S-1-5-21-124525095-708259637-1543119021-628175",
"PostReference":null,
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-16T22:40:07Z",
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b.b83675d28e264e69823205ad4e76df9f.14.14.S-1-5-21-124525095-708259637-1543119021-628175",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-16T22:40:07Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"This is post 1 from the specified user."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":0
}]
},
"UnreadMentionCount":0
}
}}
Actor/Feed/Post
在指定网站源中创建根文章。
您只能在当前用户的上下文中发布内容。 您无法在不同用户的订阅源中创建根文章,但您可以回复其他用户的文章。 请参阅 Post/Reply。
注意
不要将此 Post
资源与 Post
表示特定线程或帖子的资源混淆。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/actor(item=@v)/feed/post?@v='http://<siteCollection>/<teamSite>/newsfeed.aspx'
请求参数
_restCreationData_
类型: SP。Social.SocialRestPostCreationData
新文章的一个 null ID 和属性,如下例所示。
"restCreationData":{
"__metadata":{
"type":"SP.Social.SocialRestPostCreationData"
},
"ID":null,
"creationData":{
"__metadata":{
"type":"SP.Social.SocialPostCreationData"
},
"ContentText":"This post was published using REST.",
"UpdateStatusText":false
}
}
响应
类型: SP。Social.SocialRestThread
包含新的根文章的主题。
以下响应示例展示了包含新的根文章的主题。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='8.c4bb19b167a448a3be9b597522152420.c305b669c2b649e9b820e7feabe3c095.c4bb19b167a448a3be9b597522152420.0c37852b34d0418e91c62ac25af4be5b.866d920d78d949a394f26073b767cb19.3.3.1'",
"uri":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='8.c4bb19b167a448a3be9b597522152420.c305b669c2b649e9b820e7feabe3c095.c4bb19b167a448a3be9b597522152420.0c37852b34d0418e91c62ac25af4be5b.866d920d78d949a394f26073b767cb19.3.3.1'",
"type":"SP.Social.SocialRestThread"
},
"ID":"8.c4bb19b167a448a3be9b597522152420.c305b669c2b649e9b820e7feabe3c095.c4bb19b167a448a3be9b597522152420.0c37852b34d0418e91c62ac25af4be5b.866d920d78d949a394f26073b767cb19.3.3.1",
"SocialThread":{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":null,
"ActorType":2,
"CanFollow":true,
"ContentUri":"http://serverName:80/sites/teamSite",
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"8.c4bb19b167a448a3be9b597522152420.c305b669c2b649e9b820e7feabe3c095.c4bb19b167a448a3be9b597522152420.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":true,
"LibraryUri":null,
"Name":"Team Site",
"PersonalSiteUri":null,
"Status":0,
"StatusText":null,
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/sites/teamSite"
},{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"Posted with REST.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":6,
"Id":"8.c4bb19b167a448a3be9b597522152420.c305b669c2b649e9b820e7feabe3c095.c4bb19b167a448a3be9b597522152420.0c37852b34d0418e91c62ac25af4be5b.866d920d78d949a394f26073b767cb19.3.3.1",
"OwnerIndex":0,
"Permalink":"http://serverName/sites/teamSite/newsfeed.aspx?ThreadID=8.c4bb19b167a448a3be9b597522152420.c305b669c2b649e9b820e7feabe3c095.c4bb19b167a448a3be9b597522152420.0c37852b34d0418e91c62ac25af4be5b.866d920d78d949a394f26073b767cb19.3.3.1",
"PostReference":null,
"Replies":{"results":[]},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":1,
"CreatedTime":"2013-04-18T22:44:11.8485085Z",
"Id":"8.c4bb19b167a448a3be9b597522152420.c305b669c2b649e9b820e7feabe3c095.c4bb19b167a448a3be9b597522152420.0c37852b34d0418e91c62ac25af4be5b.866d920d78d949a394f26073b767cb19.3.3.1",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-18T22:44:11.8485085Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Posted with REST."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":0
}
}}
文章
获取包含指定微博文章的完整主题。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/post
请求参数
ID
类型: String
文章的唯一标识符,如下例中所示。
"ID":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.644240140e0b43379883ebcb859deaab.27.32.S-1-5-21-2127521184-1604012920-1887927527-66602"
响应
类型: SP。Social.SocialRestThread
包含指定文章的完整主题。
以下响应示例表示包含指定文章的完整主题。 与仅包含两个最近的回复的摘要主题不同,完整主题包含所有回复。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.62bff48184bd433b8f7b04f6ea76268b.27.27.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"uri":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.62bff48184bd433b8f7b04f6ea76268b.27.27.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"type":"SP.Social.SocialRestThread"
},
"ID":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.62bff48184bd433b8f7b04f6ea76268b.27.27.S-1-5-21-2127521184-1604012920-1887927527-66602",
"SocialThread":{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"Posted with REST.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
},{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username2",
"ActorType":0,
"CanFollow":true,
"ContentUri":null,
"EmailAddress":"username2@somecompany.com",
"FollowedContentUri":null,
"Id":"1.ed418efb7f984ee49ce276c9c5441938.de1675d4929d431894c18908ac53516a.65da910de21f4e40abb318ba33520931.0c37852b34d0418e91c62ac25af4be5b","ImageUri":"http://serverName:80/my/User Photos/Profile Pictures/username2_MThumb.jpg",
"IsFollowed":true,
"LibraryUri":null,"Name":"User2 Name","PersonalSiteUri":"http://serverName/my/personal/username2","Status":6,"StatusText":"This is post 1 from the specified user.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":"SOME TITLE",
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername2"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.62bff48184bd433b8f7b04f6ea76268b.27.27.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.62bff48184bd433b8f7b04f6ea76268b.27.27.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{
"results":[{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":1,
"CreatedTime":"2013-04-23T23:02:40Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.644240140e0b43379883ebcb859deaab.27.32.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-23T23:02:40Z",
"Overlays":{"results":[]},
"PostType":1,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"This is a reply."
}]
},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T19:45:45Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.62bff48184bd433b8f7b04f6ea76268b.27.27.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[1]},
"TotalCount":1
},
"ModifiedTime":"2013-04-23T23:02:41Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Posted with REST."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":1
}
}}
Post/Reply
发布对指定文章的回复。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/post/reply
请求参数
_restCreationData_
类型: SP。Social.SocialRestPostCreationData
要回复的文章的 ID 以及回复的属性,如下例中所示。
"restCreationData":{
"__metadata":{
"type": "SP.Social.SocialRestPostCreationData"
},
"ID":"1.4975bef1e1bc42608c1dfae9f320c751.35c9fd7b79904800aaa5f74684bf0f75.623664921f034e8d814c000267d3e5e4.0c37852b34d0418e91c62ac25af4be5b.230d3c5272fc499f88ac0b74b2f4512f.119.119.S-1-5-21-124525095-708259637-1543119021-565461",
"creationData":{
"__metadata":{
"type":"SP.Social.SocialPostCreationData"
},
"ContentText":"Posted with REST.",
"UpdateStatusText":false
}
}
响应
类型: SP。Social.SocialRestThread
包含指定文章的已修改主题的一个摘要。
以下响应示例表示包含指定文章和回复的主题。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"uri":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"type":"SP.Social.SocialRestThread"
},
"ID":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"SocialThread":{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{
"type":"SP.Social.SocialActor"
},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"Posted with REST.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"}
]},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{
"results":[{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T20:52:51.0650454Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.ce3ac812293c4903b5c406efe01b9432.26.29.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T20:52:51.0650454Z",
"Overlays":{"results":[]},
"PostType":1,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Replied with REST."
}]
},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T19:33:17Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T20:52:51.6900774Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Posted with REST."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":1
}
}}
Post/Delete
删除指定的微博文章。 如果文章是根文章,将删除整个主题。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/post/delete
请求参数
ID
类型: String
要删除的文章的 ID,如下例中所示。
'ID':'1.94fdcc5fc39b4a2c99ae4570caf02321.d0a03fb1761a404a9a8e7f9f5ec58e17.5a1067e8af65410b9e2ba6a74a4b718a.0c37852b34d0418e91c62ac25af4be5b.9dbfb5598e2248d7b57eee57abf2e7c1.31.31.S-1-5-21-124525095-708259637-1543119021-565461'
响应
无。
{"d":{"Delete":null}}
Post/Like
使当前用户成为指定微博文章的关注者。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/post/like
请求参数
ID
类型: String
要喜欢的文章的 ID,如下例中所示。
"ID":"1.94fdcc5fc39b4a2c99ae4570caf02321.d0a03fb1761a404a9a8e7f9f5ec58e17.5a1067e8af65410b9e2ba6a74a4b718a.0c37852b34d0418e91c62ac25af4be5b.9dbfb5598e2248d7b57eee57abf2e7c1.31.31.S-1-5-21-124525095-708259637-1543119021-565461"
响应
类型: SP。Social.SocialRestThread
包含指定文章的摘要主题。
以下响应示例表示包含喜欢的文章的主题。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"uri":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"type":"SP.Social.SocialRestThread"
},
"ID":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"SocialThread":{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"Posted with REST.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{
"results":[{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T20:52:51.0650454Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.ce3ac812293c4903b5c406efe01b9432.26.29.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T20:52:51.0650454Z",
"Overlays":{"results":[]},
"PostType":1,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Replied with REST."
}]
},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T19:33:17Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":true,
"Indexes":{"results":[]},
"TotalCount":1
},
"ModifiedTime":"2013-04-17T20:52:51Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Posted with REST."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":1
}
}}
Post/Unlike
将当前用户从指定微博文章的关注者列表中移除。 如果当前用户不是文章的关注者,该请求将忽略。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/post/unlike
请求参数
ID
类型: String
要喜欢的文章的 ID,如下例中所示。
"ID":"1.94fdcc5fc39b4a2c99ae4570caf02321.d0a03fb1761a404a9a8e7f9f5ec58e17.5a1067e8af65410b9e2ba6a74a4b718a.0c37852b34d0418e91c62ac25af4be5b.9dbfb5598e2248d7b57eee57abf2e7c1.31.31.S-1-5-21-124525095-708259637-1543119021-565461"
响应
类型: SP。Social.SocialRestThread
包含指定文章的已修改主题的一个摘要。
以下响应示例表示包含用户不再喜欢的文章的主题。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"uri":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"type":"SP.Social.SocialRestThread"
},
"ID":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"SocialThread":{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"Posted with REST.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{
"results":[{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T20:52:51.0650454Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.ce3ac812293c4903b5c406efe01b9432.26.29.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T20:52:51.0650454Z",
"Overlays":{"results":[]},
"PostType":1,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Replied with REST."
}]
},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T19:33:17Z","Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T20:52:51Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Posted with REST."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":1
}
}}
Post/Likers
获取喜欢指定微博文章的用户。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/post/likers
请求参数
ID
类型: String
要获取其关注者的文章的 ID,如下例中所示。
"ID":"1.94fdcc5fc39b4a2c99ae4570caf02321.d0a03fb1761a404a9a8e7f9f5ec58e17.5a1067e8af65410b9e2ba6a74a4b718a.0c37852b34d0418e91c62ac25af4be5b.9dbfb5598e2248d7b57eee57abf2e7c1.31.31.S-1-5-21-124525095-708259637-1543119021-565461"
响应
Likers
类型: SP。Social.SocialActor[]
喜欢指定文章的用户。
以下响应示例表示喜欢指定文章的用户。
{"d":{
"Likers":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName/my/personal/username1/",
"Status":0,
"StatusText":"Posted with REST.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
}
}}
Post/Lock
锁定指定主题。 如果主题已锁定,则不会将回复文章添加到主题中,直至其解锁。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/post/lock
请求参数
ID
类型: String
要锁定的主题的 ID,如下例中所示。
"ID":"1.94fdcc5fc39b4a2c99ae4570caf02321.d0a03fb1761a404a9a8e7f9f5ec58e17.5a1067e8af65410b9e2ba6a74a4b718a.0c37852b34d0418e91c62ac25af4be5b.9dbfb5598e2248d7b57eee57abf2e7c1.31.31.S-1-5-21-124525095-708259637-1543119021-565461"
响应
类型: SP。Social.SocialRestThread
已锁定主题的摘要。
以下响应示例表示锁定主题。 主题的 Attributes 属性包含 SP.Social.SocialThreadAttributes 枚举的按位值,该值将指示主题是否已锁定。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'
uri":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"type":"SP.Social.SocialRestThread"
},
"ID":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"SocialThread":{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"Posted with REST.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}]
},
"Attributes":12,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{
"results":[{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":22,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T20:52:51.0650454Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.ce3ac812293c4903b5c406efe01b9432.26.29.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T20:52:51.0650454Z",
"Overlays":{"results":[]},
"PostType":1,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Replied with REST."
}]
},
"RootPost":{
"__metadata":{
"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":22,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T19:33:17Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T20:52:51Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Posted with REST."
},
"Status":0,
"ThreadType":0,
"TotalReplyCount":1
}
}}
Post/Unlock
解锁指定主题。
终结点 URI 结构
发布http://<siteCollection>/<site>/_api/social.feed/post/unlock
请求参数
ID
类型: String
要解锁的主题的 ID,如下例中所示。
"ID":"1.94fdcc5fc39b4a2c99ae4570caf02321.d0a03fb1761a404a9a8e7f9f5ec58e17.5a1067e8af65410b9e2ba6a74a4b718a.0c37852b34d0418e91c62ac25af4be5b.9dbfb5598e2248d7b57eee57abf2e7c1.31.31.S-1-5-21-124525095-708259637-1543119021-565461"
响应
类型: SP。Social.SocialRestThread
已解锁主题的摘要。
以下响应示例表示解锁主题。 主题的 Attributes 属性包含 SP.Social.SocialThreadAttributes 枚举的按位值,该值将指示主题是否已锁定。
{"d":{
"__metadata":{
"id":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"uri":"http://serverName/sites/dev/_api/social.feed/post(ID=@ai)/?@ai='1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602'",
"type":"SP.Social.SocialRestThread"
},
"ID":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"SocialThread":{
"__metadata":{"type":"SP.Social.SocialThread"},
"Actors":{
"results":[{
"__metadata":{"type":"SP.Social.SocialActor"},
"AccountName":"domain\\username1",
"ActorType":0,
"CanFollow":false,
"ContentUri":null,
"EmailAddress":null,
"FollowedContentUri":null,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b",
"ImageUri":null,
"IsFollowed":false,
"LibraryUri":null,
"Name":"User1 Name",
"PersonalSiteUri":"http://serverName:80/my/personal/username1/",
"Status":0,
"StatusText":"Posted with REST.",
"TagGuid":"00000000-0000-0000-0000-000000000000",
"Title":null,
"Uri":"http://serverName:80/my/Person.aspx?accountname=domain%5Cusername1"
}
]},
"Attributes":6,
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"OwnerIndex":0,
"Permalink":"http://serverName:80/my/ThreadView.aspx?ThreadID=1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"PostReference":null,
"Replies":{
"results":[{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T20:52:51.0650454Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.ce3ac812293c4903b5c406efe01b9432.26.29.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T20:52:51.0650454Z",
"Overlays":{"results":[]},
"PostType":1,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Replied with REST."
}]
},
"RootPost":{
"__metadata":{"type":"SP.Social.SocialPost"},
"Attachment":null,
"Attributes":23,
"AuthorIndex":0,
"CreatedTime":"2013-04-17T19:33:17Z",
"Id":"1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602",
"LikerInfo":{
"__metadata":{"type":"SP.Social.SocialPostActorInfo"},
"IncludesCurrentUser":false,
"Indexes":{"results":[]},
"TotalCount":0
},
"ModifiedTime":"2013-04-17T20:52:51Z",
"Overlays":{"results":[]},
"PostType":0,
"PreferredImageUri":null,
"Source":{
"__metadata":{"type":"SP.Social.SocialLink"},
"Text":null,
"Uri":null
},
"Text":"Posted with REST."
},
"Status":5,
"ThreadType":0,
"TotalReplyCount":1
}
}}
订阅源任务的示例 REST 请求
GET 订阅源任务请求指定 URI 中的参数或请求的 url 属性中的参数。 POST 请求指定请求正文中的 data 属性的参数,格式为 XML 或 JavaScript 对象表示法 (JSON)。 您可以提出任何语言的 HTTP 请求,包括 JavaScript 和 C#。 下列示例请求显示如何使用 JavaScript 提出请求,如何传递 JSON 格式的实体信息。
示例:如何在请求正文中指定 ID 参数(在 data 属性中)。
注意
主题和文章 Id 属性的值太长,无法在 URL 中发送,因此您要在请求正文中发送它们。 结果,即使在逻辑上为 GET 请求的只读操作也必须作为 POST 请求发送。 例如,若要获取某个主题,您必须发送 POST 请求并将主题 Id 作为一个实体在请求正文中传递。
var endpoint = siteUrl + '/_api/social.feed/post';
var postId = '1.655c70c348374d48839daabc24a360f0.82baa3bdfa2f481a8185802eb9c6c6cd.5d227a6fa3894f0c9dde26876b71d619.0c37852b34d0418e91c62ac25af4be5b.4316bdaa94bf4984be5dfea1ba96954e.26.26.S-1-5-21-2127521184-1604012920-1887927527-66602';
$.ajax({
url: endpoint,
type: 'POST',
data: JSON.stringify({
'ID': postId
}),
headers: {
"accept": "application/json;odata=verbose",
"content-type": "application/json;odata=verbose",
"X-RequestDigest": $("#__REQUESTDIGEST").val()
},
success: function(data) {
var stringData = JSON.stringify(data);
alert(stringData);
// Converts the response data into an object that you can work with.
var jsonObject = JSON.parse(stringData);
},
error: function(xhr, ajaxOptions, thrownError) {
alert("Error: " + xhr.status + " " + thrownError + "\\nResponseText: " + xhr.responseText);
}
});
示例:如何发布根帖子,并在 data 属性中指定 restCreationData 参数。
var endpoint = <site url> + '/_api/social.feed/my/feed/post';
var postContent = 'Posted with REST.';
$.ajax({
url: endpoint,
type: 'POST',
data: JSON.stringify({
'restCreationData': {
'__metadata': {
'type': 'SP.Social.SocialRestPostCreationData'
},
'ID': null,
'creationData': {
'__metadata': {
'type': 'SP.Social.SocialPostCreationData'
},
'ContentText': postContent
}
}
}),
headers: {
"accept": "application/json;odata=verbose",
"content-type": "application/json;odata=verbose",
"X-RequestDigest": $("#__REQUESTDIGEST").val()
},
success: function(data) {
var stringData = JSON.stringify(data);
alert(stringData);
// Converts the response data into an object that you can work with.
var jsonObject = JSON.parse(stringData);
},
error: function(xhr, ajaxOptions, thrownError) {
alert("Error: " + xhr.status + " " + thrownError + "\\nResponseText: " + xhr.responseText);
}
});
要发布对指定主题的回复,请将 POST 请求发送至 Reply 资源 ( <site url>/_api/social.feed/Post/Reply
) 并传递包含目标文章 ID 的 restCreationData 信息。
{ "restCreationData": {
"__metadata": { "type": "SP.Social.SocialRestPostCreationData" },
"ID":"1.4975bef1e1bc42608c1dfae9f320c751.35c9fd7b79904800aaa5f74684bf0f75.623664921f034e8d814c000267d3e5e4.0c37852b34d0418e91c62ac25af4be5b.230d3c5272fc499f88ac0b74b2f4512f.119.119.S-1-5-21-124525095-708259637-1543119021-565461",
"creationData":{
"__metadata":{ "type":"SP.Social.SocialPostCreationData" },
"ContentText":"This is a reply to the specified post.",
"UpdateStatusText":false
}
} }
用于订阅源相关 REST 请求和响应的资源
下列 REST 资源用作客户端请求中的参数,或在服务器响应中返回。
SP.Social.SocialFeedOptions
表示检索订阅源时可以指定的选项。
客户端 GET 订阅源请求可以将 SocialFeedOptions 属性指定为参数。 这些属性在查询字符串中指定。
选项 | 类型 | 说明 |
---|---|---|
MaxThreadCount | Int32 | 要检索的最大主题数。 默认数量为 20。 |
NewerThan | 字符串 | 要检索的时间跨度的"newer than"边界,作为 DateTime 对象的字符串表示形式。 默认情况下未指定边界。 |
OlderThan | 字符串 | 要检索的时间跨度的"older than"边界,作为 DateTime 对象的字符串表示形式。 默认情况下未指定边界。 |
SortOrder | Int32 | 线程在源中的排序顺序。 默认是按修改日期排序,但时间线源除外,它是按创建日期排序。 0 按帖子修改时间由近及远的顺序对线程进行排序。 1 根据根帖子的创建时间,按创建时间对线程进行排序。 |
SP.Social.SocialRestActor
表示用户、文档、站点或标签。
服务器在响应中返回 SocialRestActor 资源,以响应客户端对主角信息的请求。
SocialRestActor 具有以下属性。
属性 | 类型 | 说明 |
---|---|---|
FollowableItem | 字符串 | 指定主角的唯一标识符。 返回用户的帐户名称或文档、站点或标签的 URI。 |
FollowableItemActor | SP.Social.SocialActor | 指定的用户。 如果用户是当前用户,或者资源不是用户类型的主角,返回 null。 |
Me | SP.Social.SocialActor | 当前用户。 |
SP.Social.SocialRestFeed
表示好友动态订阅源。
服务器在响应中返回 SocialRestFeed 资源,以响应客户端对订阅源内容的请求。
SocialRestFeed 包含封装的 SP.Social.SocialFeed 对象,它具有以下属性。
属性 | 类型 | 说明 |
---|---|---|
Attributes | SP.Social.SocialFeedAttributes | 适用于订阅源的按位属性集。 |
NewestProcessed | DateTime | 检索的最新文章的日期和时间。 |
OldestProcessed | DateTime | 检索的最旧文章的日期和时间。 |
线程 | SP.Social.SocialThread[] | 组成订阅源的主题。 |
UnreadMentionCount | Int32 | 当前用户提及的未读订阅源数量。 |
SP.Social.SocialRestPostCreationData
表示新文章的内容及相关信息。
客户端将 SocialRestPostCreationData 属性指定为请求中用于发布根文章或回复的参数。 这些属性在请求正文的 data 属性中指定。
SocialRestPostCreationData 包含 ID 属性和包装的 SP.Social.SocialPostCreationData 对象。 ID 为必需, SocialPostCreationData 属性为可选。
属性 | 类型 | 说明 |
---|---|---|
ID(必需) | null 或 String | 帖子的目标。 可以取下列值之一: null:将根帖子发布到当前用户的源 要回复的帖子的 ID 要发布到的网站源 URL(例如: http://<teamSiteURL>/newsfeed.aspx ) |
以下属性属于 SocialPostCreationData 对象。
属性 | 类型 | 说明 |
---|---|---|
Attachment | SP.Social.SocialAttachment | 文章的图像、视频或文档附件。 |
ContentItems | SP.Social.SocialDataItem[] | 用于替换文章内容文本中的相应令牌的项目 |
ContentText | String | 文章的纯文本,可能包含位置插入令牌(例如,“今天是 {0} 的生日!”)。 |
SecurityUris | String[] | 用于定义文章访问权限的 SharePoint 对象的 URI 字符串表示形式。 |
Source | SP.Social.SocialLink | 文章来源。 |
UpdateStatusText | Boolean | 控制文章的纯文本内容是否应该替换当前用户的状态文本的值。 |
SP.Social.SocialRestThread
表示包含根文章和回复集的主题。
服务器在响应中返回 SocialRestThread 资源,以响应创建文章或获取完整主题的客户端请求。
SocialRestThread 包含 ID 属性和封装的 SP.Social.SocialThread 对象。
属性 | 类型 | 说明 |
---|---|---|
ID | 字符串 | 主题的唯一标识符。 |
以下属性属于 SocialThread 对象。
属性 | 类型 | 说明 |
---|---|---|
Actors | SP.Social.SocialActor[] | 合并的参与主角阵列。 |
属性 | Int32 | 表示主题属性集的按位值。 请参阅 SP.Social.SocialThreadAttributes。 |
Id | 字符串 | 主题的唯一标识符。 |
OwnerIndex | Int32 | 主题的主角中主题所有者的索引。 |
Permalink | 字符串 | 直接浏览到主题的稳定 URI(如果可用)的字符串表示形式。 |
PostReference | SP.Social.SocialPostReference | 引用的文章。 |
回复 | SP.Social.SocialPost[] | 对主题的回复。 |
RootPost | SP.Social.SocialPost | 主题的根文章。 |
状态 | Int32 | 用于识别在主题检索过程中发生的可恢复错误的代码。 请参阅 SP.Social.SocialStatusCode。 |
ThreadType | SP.Social.SocialThreadType | 主题类型。 |
TotalReplyCount | Int32 | 主题回复总数。 |
另请参阅
- 使用 SharePoint 中的社交功能开始进行开发
- 如何:了解通过使用 SharePoint 中的 REST 服务读取和写入好友动态订阅源
- 使用 SharePoint 中的社交源
- 关注好友及 SharePoint 的内容 REST API 引用
- 要查看 SharePoint REST 服务使用的 SP.Social OData 架构中的成员,请浏览到
http://<siteUri>/_api/$metadata
。