关注网站列表

命名空间:microsoft.graph

列出已登录用户关注 的网站

注意: 此 API 有 一个已知问题 ,可能会返回不正确的结果。

以下 国家云部署中提供了此 API。

全局服务 美国政府 L4 美国政府 L5 (DOD) 中国由世纪互联运营

权限

为此 API 选择标记为最低特权的权限或权限。 仅当应用需要时,才使用更高特权权限。 有关委派权限和应用程序权限的详细信息,请参阅 权限类型。 若要详细了解这些权限,请参阅 权限参考

权限类型 最低特权权限 更高的特权权限
委派(工作或学校帐户) Sites.Read.All Sites.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 不支持。 不支持。

HTTP 请求

GET /me/followedSites

注意:只能通过 OneDrive for Business 访问此方法。

可选的查询参数

此方法支持使用 OData 查询参数来帮助自定义响应。

请求标头

名称 说明
Authorization Bearer {code}。 必需。

请求正文

请勿提供此方法的请求正文。

响应

此方法返回用户关注 的网站 资源的集合。 如果未找到任何网站,则返回空集合。

示例

请求

GET https://graph.microsoft.com/v1.0/me/followedSites

响应

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
        {
            "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
            "displayName": "OneDrive Team Site",
            "webUrl": "https://contoso.sharepoint.com/teams/1drvteam",
            "sharepointIds": {
                "listItemId": "1",
                "siteId": "2C712604-1370-44E7-A1F5-426573FDA80A",
                "siteUrl": "https://contoso.sharepoint.com/teams/1drvteam",
                "webId": "2D2244C3-251A-49EA-93A8-39E1C3A060FE"
            },
            "siteCollection": {
                "hostname": "contoso.sharepoint.com"
            }
        },
        {
            "id": "contoso.sharepoint.com,1C712604-1370-44E7-A1F5-426573FDA80A,1D2244C3-251A-49EA-93A8-39E1C3A060FE",
            "displayName": "OneDrive Team Site1",
            "webUrl": "https://contoso.sharepoint.com/teams/2drvteam",
            "sharepointIds": {
                "listItemId": "1",
                "siteId": "1C712604-1370-44E7-A1F5-426573FDA80A",
                "siteUrl": "https://contoso.sharepoint.com/teams/2drvteam",
                "webId": "1D2244C3-251A-49EA-93A8-39E1C3A060FE"
            },
            "siteCollection": {
                "hostname": "contoso.sharepoint.com"
            }
        }
  ]
}