site 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

site 资源提供 SharePoint 网站的元数据和关系。

方法

方法	REST 路径
获取根网站	GET /sites/root
获取网站	GET /sites/{site-id}
根据路径获取网站	GET /sites/{hostname}:/{site-path}
获取组的网站	GET /groups/{group-id}/sites/root
获取分析结果	GET /sites/{site-id}/analytics
按间隔获取活动	GET /sites/{site-id}/getActivitiesByInterval
列出页面	GET /sites/{site-id}/pages
列出根网站	GET /sites?filter=root ne null&select=siteCollection,webUrl
列出跨地理位置的网站	GET /site/getAllSites
搜索网站	GET /sites?search={query}
关注网站	POST /users/{user-id}/followedSites/add
取消关注网站	POST /users/{user-id}/followedSites/remove
关注网站列表	GET /me/followedSites
获取权限	GET /sites/{site-id}/permissions/{permission-id}
列出权限	GET /sites/{site-id}/permissions
创建权限	POST /sites/{site-id}/permissions
删除权限	DELETE /sites/{site-id}/permissions/{permission-id}
更新权限	PATCH /sites/{site-id}/permissions/{permission-id}
列表内容类型	GET /sites/{site-id}/contentTypes
创建 contentType	POST/sites/{site-id}/contentTypes
List columns	获取 /sites/{site-id}/columns
创建列	发布 /sites/{site-id}/columns
列举操作	GET /sites/{site-id}/operations
获取网站设置	GET /sites/{site-id}/settings
获取增量	GET /sites/delta

属性

属性	类型	说明
id	string	项的唯一标识符。 只读。
createdDateTime	DateTimeOffset	项的创建日期和时间。 此为只读属性。
说明	string	网站的描述性文本。
eTag	string	该项目的 ETag。 此为只读属性。
displayName	string	网站的完整标题。 只读。
lastModifiedDateTime	DateTimeOffset	上次修改项目的日期和时间。 此为只读属性。
name	string	项的名称/标题。
根	根	如果存在，请在网站集中提供根网站。 此为只读属性。
设置	siteSettings	此网站上的设置。 只读。
sharepointIds	sharepointIds	返回对 SharePoint REST 兼容性有用的标识符。 只读。
siteCollection	siteCollection	提供有关网站的网站集的详细信息。 仅在根站点上可用。 此为只读属性。
webUrl	string (url)	在浏览器中显示项的 URL。 此为只读属性。

id 属性

site 由一个唯一 ID 标识，此唯一 ID 由以下值组成：

• 网站集主机名称 (contoso.sharepoint.com)
• 网站集的唯一 ID (GUID)
• 网站的唯一 ID (GUID)

root 标识符经常用于引用给定目标的根网站，如下所示：

• /sites/root：租户根网站。
• /groups/{group-id}/sites/root：该组的团队网站。

关系

关系	类型	说明
分析	itemAnalytics	有关此网站上发生的视图活动的分析。
columns	columnDefinition 集合	可以在此网站下方的列表中重复使用的列定义集合。
contentTypes	contentType 集合	为此网站定义的内容类型集合。
驱动器	drive	此网站的默认驱动器（文档库）。
drives	drive 集合	网站下方的驱动器集合（文档库）。
externalColumns	columnDefinition 集合	从当前网站的父层次结构中的网站引用的网站中可用的列定义的集合。
items	baseItem 集合	用于处理此网站中包含的任何项目。 无法枚举此集合。
lists	列表 集合	此网站下方的列表集合。
operations	richLongRunningOperation 集合	站点长时间运行操作的集合。
pages	baseSitePage 集合	此网站上 baseSitePages 列表中的页面集合。
permissions	permission 集合	与网站关联的权限。 可为空。
recycleBin	recycleBin	此网站中 回收BinItem 资源的集合的容器。
sites	网站集	网站下方的子网站的集合。
termStore	microsoft.graph.termStore.store	此站点下的术语库。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

site 资源派生自 baseItem，并继承此资源的属性。

{
  "displayName": "string",
  "id": "string",
  "root": { "@odata.type": "microsoft.graph.root" },
  "settings": { "@odata.type": "microsoft.graph.sitesettings" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "siteCollection": {"@odata.type": "microsoft.graph.siteCollection"},

  /* relationships */
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
  "externalColumns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "drives": [ { "@odata.type": "microsoft.graph.drive" }],
  "items": [ { "@odata.type": "microsoft.graph.baseItem" }],
  "lists": [ { "@odata.type": "microsoft.graph.list" }],
  "permissions": [ { "@odata.type": "microsoft.graph.permission" }],
  "sites": [ { "@odata.type": "microsoft.graph.site"} ],
  "termStore": { "@odata.type": "microsoft.graph.termStore.store" },

  /* inherited from baseItem */
  "createdDateTime": "datetime",
  "description": "string",
  "eTag": "string",
  "lastModifiedDateTime": "datetime",
  "name": "string",
  "webUrl": "url"
}